| 1 | <!ENTITY apt-author.team " |
| 2 | <author> |
| 3 | <othername>APT team</othername> |
| 4 | <contrib></contrib> |
| 5 | </author> |
| 6 | "> |
| 7 | |
| 8 | <!ENTITY apt-qapage " |
| 9 | <para> |
| 10 | <ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink> |
| 11 | </para> |
| 12 | "> |
| 13 | |
| 14 | <!-- Boiler plate Bug reporting section --> |
| 15 | <!ENTITY manbugs " |
| 16 | <refsect1><title>Bugs</title> |
| 17 | <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>. |
| 18 | If you wish to report a bug in APT, please see |
| 19 | <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the |
| 20 | &reportbug; command. |
| 21 | </para> |
| 22 | </refsect1> |
| 23 | "> |
| 24 | |
| 25 | <!-- Boiler plate Author section --> |
| 26 | <!ENTITY manauthor " |
| 27 | <refsect1><title>Author</title> |
| 28 | <para>APT was written by the APT team <email>apt@packages.debian.org</email>. |
| 29 | </para> |
| 30 | </refsect1> |
| 31 | "> |
| 32 | |
| 33 | <!-- Should be used within the option section of the text to |
| 34 | put in the blurb about -h, -v, -c and -o --> |
| 35 | <!ENTITY apt-commonoptions " |
| 36 | <varlistentry><term><option>-h</option></term> |
| 37 | <term><option>--help</option></term> |
| 38 | <listitem><para>Show a short usage summary. |
| 39 | </para> |
| 40 | </listitem> |
| 41 | </varlistentry> |
| 42 | |
| 43 | <varlistentry> |
| 44 | <term><option>-v</option></term> |
| 45 | <term><option>--version</option></term> |
| 46 | <listitem><para>Show the program version. |
| 47 | </para> |
| 48 | </listitem> |
| 49 | </varlistentry> |
| 50 | |
| 51 | <varlistentry> |
| 52 | <term><option>-c</option></term> |
| 53 | <term><option>--config-file</option></term> |
| 54 | <listitem><para>Configuration File; Specify a configuration file to use. |
| 55 | The program will read the default configuration file and then this |
| 56 | configuration file. If configuration settings need to be set before the |
| 57 | default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar> |
| 58 | environment variable. See &apt-conf; for syntax information. |
| 59 | </para> |
| 60 | </listitem> |
| 61 | </varlistentry> |
| 62 | |
| 63 | <varlistentry> |
| 64 | <term><option>-o</option></term> |
| 65 | <term><option>--option</option></term> |
| 66 | <listitem><para>Set a Configuration Option; This will set an arbitrary |
| 67 | configuration option. The syntax is <option>-o Foo::Bar=bar</option>. |
| 68 | <option>-o</option> and <option>--option</option> can be used multiple |
| 69 | times to set different options. |
| 70 | </para> |
| 71 | </listitem> |
| 72 | </varlistentry> |
| 73 | "> |
| 74 | |
| 75 | <!-- Should be used within the option section of the text to |
| 76 | put in the blurb about -h, -v, -c and -o --> |
| 77 | <!ENTITY apt-cmdblurb " |
| 78 | <para>All command line options may be set using the configuration file, the |
| 79 | descriptions indicate the configuration option to set. For boolean |
| 80 | options you can override the config file by using something like |
| 81 | <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option> |
| 82 | or several other variations. |
| 83 | </para> |
| 84 | "> |
| 85 | |
| 86 | <!ENTITY file-aptconf " |
| 87 | <varlistentry><term><filename>/etc/apt/apt.conf</filename></term> |
| 88 | <listitem><para>APT configuration file. |
| 89 | Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem> |
| 90 | </varlistentry> |
| 91 | |
| 92 | <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term> |
| 93 | <listitem><para>APT configuration file fragments. |
| 94 | Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem> |
| 95 | </varlistentry> |
| 96 | "> |
| 97 | |
| 98 | <!ENTITY file-cachearchives " |
| 99 | <varlistentry><term><filename>&cachedir;/archives/</filename></term> |
| 100 | <listitem><para>Storage area for retrieved package files. |
| 101 | Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem> |
| 102 | </varlistentry> |
| 103 | |
| 104 | <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term> |
| 105 | <listitem><para>Storage area for package files in transit. |
| 106 | Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem> |
| 107 | </varlistentry> |
| 108 | "> |
| 109 | |
| 110 | <!ENTITY file-preferences " |
| 111 | <varlistentry><term><filename>/etc/apt/preferences</filename></term> |
| 112 | <listitem><para>Version preferences file. |
| 113 | This is where you would specify "pinning", |
| 114 | i.e. a preference to get certain packages |
| 115 | from a separate source |
| 116 | or from a different version of a distribution. |
| 117 | Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem> |
| 118 | </varlistentry> |
| 119 | |
| 120 | <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term> |
| 121 | <listitem><para>File fragments for the version preferences. |
| 122 | Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem> |
| 123 | </varlistentry> |
| 124 | "> |
| 125 | |
| 126 | <!ENTITY file-sourceslist " |
| 127 | <varlistentry><term><filename>/etc/apt/sources.list</filename></term> |
| 128 | <listitem><para>Locations to fetch packages from. |
| 129 | Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem> |
| 130 | </varlistentry> |
| 131 | |
| 132 | <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term> |
| 133 | <listitem><para>File fragments for locations to fetch packages from. |
| 134 | Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem> |
| 135 | </varlistentry> |
| 136 | "> |
| 137 | |
| 138 | <!ENTITY file-statelists " |
| 139 | <varlistentry><term><filename>&statedir;/lists/</filename></term> |
| 140 | <listitem><para>Storage area for state information for each package resource specified in |
| 141 | &sources-list; |
| 142 | Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem> |
| 143 | </varlistentry> |
| 144 | |
| 145 | <varlistentry><term><filename>&statedir;/lists/partial/</filename></term> |
| 146 | <listitem><para>Storage area for state information in transit. |
| 147 | Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem> |
| 148 | </varlistentry> |
| 149 | "> |
| 150 | |
| 151 | <!ENTITY file-trustedgpg " |
| 152 | <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term> |
| 153 | <listitem><para>Keyring of local trusted keys, new keys will be added here. |
| 154 | Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem> |
| 155 | </varlistentry> |
| 156 | |
| 157 | <varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term> |
| 158 | <listitem><para>File fragments for the trusted keys, additional keyrings can |
| 159 | be stored here (by other packages or the administrator). |
| 160 | Configuration Item <literal>Dir::Etc::TrustedParts</literal>.</para></listitem> |
| 161 | </varlistentry> |
| 162 | "> |
| 163 | |
| 164 | <!ENTITY file-extended_states " |
| 165 | <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term> |
| 166 | <listitem><para>Status list of auto-installed packages. |
| 167 | Configuration Item: <literal>Dir::State::extended_states</literal>. |
| 168 | </para></listitem> |
| 169 | </varlistentry> |
| 170 | "> |
| 171 | |
| 172 | <!-- TRANSLATOR: This is the section header for the following paragraphs - comparable |
| 173 | to the other headers like NAME and DESCRIPTION and should therefore be uppercase. --> |
| 174 | <!ENTITY translation-title "TRANSLATION"> |
| 175 | |
| 176 | <!-- TRANSLATOR: This is a placeholder. You should write here who has contributed |
| 177 | to the translation in the past, who is responsible now and maybe further information |
| 178 | specially related to your translation. --> |
| 179 | <!ENTITY translation-holder " |
| 180 | The english translation was done by John Doe <email>john@doe.org</email> in 2009, |
| 181 | 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the |
| 182 | Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>. |
| 183 | "> |
| 184 | |
| 185 | <!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings |
| 186 | in a shipped manpage newer/modified paragraphs will maybe appear in english in |
| 187 | the generated manpage. This sentence is therefore here to tell the reader that this |
| 188 | is not a mistake by the translator - obviously the target is that at least for stable |
| 189 | releases this sentence is not needed. :) --> |
| 190 | <!ENTITY translation-english " |
| 191 | Note that this translated document may contain untranslated parts. |
| 192 | This is done on purpose, to avoid losing content when the |
| 193 | translation is lagging behind the original content. |
| 194 | "> |
| 195 | |
| 196 | <!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::pkgProblemResolver=1 --> |
| 197 | <!ENTITY synopsis-config-string "config_string"> |
| 198 | |
| 199 | <!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> |
| 200 | <!ENTITY synopsis-config-file "config_file"> |
| 201 | |
| 202 | <!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -t=squeeze apt/experimental --> |
| 203 | <!ENTITY synopsis-target-release "target_release"> |
| 204 | |
| 205 | <!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> |
| 206 | <!ENTITY synopsis-architecture "architecture"> |
| 207 | |
| 208 | <!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome --> |
| 209 | <!ENTITY synopsis-pkg "pkg"> |
| 210 | |
| 211 | <!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> |
| 212 | <!ENTITY synopsis-pkg-ver-number "pkg_version_number"> |
| 213 | |
| 214 | <!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache pkgnames apt --> |
| 215 | <!ENTITY synopsis-prefix "prefix"> |
| 216 | |
| 217 | <!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search awesome --> |
| 218 | <!ENTITY synopsis-regex "regex"> |
| 219 | |
| 220 | <!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -d=/media/cdrom --> |
| 221 | <!ENTITY synopsis-cdrom-mount "cdrom_mount_point"> |
| 222 | |
| 223 | <!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. apt-extracttemplates -t=/tmp --> |
| 224 | <!ENTITY synopsis-tmp-directory "temporary_directory"> |
| 225 | |
| 226 | <!-- TRANSLATOR: used as in apt-extracttemplates filename --> |
| 227 | <!ENTITY synopsis-filename "filename"> |
| 228 | |
| 229 | <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> |
| 230 | <!ENTITY synopsis-path "path"> |
| 231 | |
| 232 | <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> |
| 233 | <!ENTITY synopsis-override "override-file"> |
| 234 | |
| 235 | <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> |
| 236 | <!ENTITY synopsis-pathprefix "pathprefix"> |
| 237 | |
| 238 | <!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive generate section --> |
| 239 | <!ENTITY synopsis-section "section"> |
| 240 | |
| 241 | <!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export 473041FA --> |
| 242 | <!ENTITY synopsis-keyid "keyid"> |
| 243 | |