X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/09774285ae6b8743aadb1fbee45c7eeda7bc505a..dd47e21814291e965be6da73331f28dc695ce489:/doc/apt.ent diff --git a/doc/apt.ent b/doc/apt.ent index 56a08a087..6a3837b95 100644 --- a/doc/apt.ent +++ b/doc/apt.ent @@ -1,159 +1,243 @@ - - - - -&docdir;/examples/configure-index"> -/etc/apt.conf"> - - - - - - - + + APT team + + "> - - - + + QA Page + "> - - - + +Bugs + APT bug page. + If you wish to report a bug in APT, please see + /usr/share/doc/debian/bug-reporting.txt or the + &reportbug; command. + + "> - - - + +Author + APT was written by the APT team apt@packages.debian.org. + + "> - - - + + + + Show a short usage summary. + + + + + + + + Show the program version. + + + + + + + + Configuration File; Specify a configuration file to use. + The program will read the default configuration file and then this + configuration file. If configuration settings need to be set before the + default configuration files are parsed specify a file with the APT_CONFIG + environment variable. See &apt-conf; for syntax information. + + + + + + + + Set a Configuration Option; This will set an arbitrary + configuration option. The syntax is . + and can be used multiple + times to set different options. + + + "> - - - + +All command line options may be set using the configuration file, the + descriptions indicate the configuration option to set. For boolean + options you can override the config file by using something like + ,, + or several other variations. + "> - - - +/etc/apt/apt.conf + APT configuration file. + Configuration Item: Dir::Etc::Main. + + + /etc/apt/apt.conf.d/ + APT configuration file fragments. + Configuration Item: Dir::Etc::Parts. + +"> + +&cachedir;/archives/ + Storage area for retrieved package files. + Configuration Item: Dir::Cache::Archives. + + + &cachedir;/archives/partial/ + Storage area for package files in transit. + Configuration Item: Dir::Cache::Archives (partial will be implicitly appended) + "> - - - -"> +/etc/apt/preferences + Version preferences file. + This is where you would specify "pinning", + i.e. a preference to get certain packages + from a separate source + or from a different version of a distribution. + Configuration Item: Dir::Etc::Preferences. + - - - + /etc/apt/preferences.d/ + File fragments for the version preferences. + Configuration Item: Dir::Etc::PreferencesParts. + "> - - - -"> +/etc/apt/sources.list + Locations to fetch packages from. + Configuration Item: Dir::Etc::SourceList. + - - - + /etc/apt/sources.list.d/ + File fragments for locations to fetch packages from. + Configuration Item: Dir::Etc::SourceParts. + "> - - - +&statedir;/lists/ + Storage area for state information for each package resource specified in + &sources-list; + Configuration Item: Dir::State::Lists. + + + &statedir;/lists/partial/ + Storage area for state information in transit. + Configuration Item: Dir::State::Lists (partial will be implicitly appended) + "> - - - -
apt@packages.debian.org
- Jason Gunthorpe - 1998-2000 Jason Gunthorpe - 20 September 2000 - -"> - -Bugs</> - <para> - See the <ulink url='http://bugs.debian.org/apt'>APT bug page</>. - If you wish to report a bug in APT, please see - <filename>/usr/share/doc/debian/bug-reporting.txt</> or the &bug; command. - </RefSect1> +<!ENTITY file-trustedgpg " + <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term> + <listitem><para>Keyring of local trusted keys, new keys will be added here. + Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem> + </varlistentry> + + <varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term> + <listitem><para>File fragments for the trusted keys, additional keyrings can + be stored here (by other packages or the administrator). + Configuration Item <literal>Dir::Etc::TrustedParts</literal>.</para></listitem> + </varlistentry> "> -<!-- Boiler plate Author section --> -<!ENTITY manauthor " - <RefSect1><Title>Author</> - <para> - APT was written by the APT team <email>apt@packages.debian.org</>. - </RefSect1> +<!ENTITY file-extended_states " + <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term> + <listitem><para>Status list of auto-installed packages. + Configuration Item: <literal>Dir::State::extended_states</literal>. + </para></listitem> + </varlistentry> "> -<!-- Should be used within the option section of the text to - put in the blurb about -h, -v, -c and -o --> -<!ENTITY apt-commonoptions " - <VarListEntry><term><option/-h/</><term><option/--help/</> - <ListItem><Para> - Show a short usage summary. - </VarListEntry> - - <VarListEntry><term><option/-v/</><term><option/--version/</> - <ListItem><Para> - Show the program verison. - </VarListEntry> - - <VarListEntry><term><option/-c/</><term><option/--config-file/</> - <ListItem><Para> - Configuration File; Specify a configuration file to use. - The program will read the default configuration file and then this - configuration file. See &apt-conf; for syntax information. - </VarListEntry> - - <VarListEntry><term><option/-o/</><term><option/--option/</> - <ListItem><Para> - Set a Configuration Option; This will set an arbitary configuration - option. The syntax is <option>-o Foo::Bar=bar</>. - </VarListEntry> +<!-- TRANSLATOR: This is the section header for the following paragraphs - comparable + to the other headers like NAME and DESCRIPTION and should therefore be uppercase. --> +<!ENTITY translation-title "TRANSLATION"> + +<!-- TRANSLATOR: This is a placeholder. You should write here who has contributed + to the translation in the past, who is responsible now and maybe further information + specially related to your translation. --> +<!ENTITY translation-holder " + The english translation was done by John Doe <email>john@doe.org</email> in 2009, + 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the + Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>. "> -<!-- Should be used within the option section of the text to - put in the blurb about -h, -v, -c and -o --> -<!ENTITY apt-cmdblurb " - <para> - All command line options may be set using the configuration file, the - descriptions indicate the configuration option to set. For boolean - options you can override the config file by using something like - <option/-f-/,<option/--no-f/, <option/-f=no/ or several other variations. - </para> +<!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings + in a shipped manpage newer/modified paragraphs will maybe appear in english in + the generated manpage. This sentence is therefore here to tell the reader that this + is not a mistake by the translator - obviously the target is that at least for stable + releases this sentence is not needed. :) --> +<!ENTITY translation-english " + Note that this translated document may contain untranslated parts. + This is done on purpose, to avoid losing content when the + translation is lagging behind the original content. "> + +<!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::pkgProblemResolver=1 --> +<!ENTITY synopsis-config-string "config_string"> + +<!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> +<!ENTITY synopsis-config-file "config_file"> + +<!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -t=squeeze apt/experimental --> +<!ENTITY synopsis-target-release "target_release"> + +<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> +<!ENTITY synopsis-architecture "architecture"> + +<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome --> +<!ENTITY synopsis-pkg "pkg"> + +<!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> +<!ENTITY synopsis-pkg-ver-number "pkg_version_number"> + +<!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache pkgnames apt --> +<!ENTITY synopsis-prefix "prefix"> + +<!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search awesome --> +<!ENTITY synopsis-regex "regex"> + +<!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -d=/media/cdrom --> +<!ENTITY synopsis-cdrom-mount "cdrom_mount_point"> + +<!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. apt-extracttemplates -t=/tmp --> +<!ENTITY synopsis-tmp-directory "temporary_directory"> + +<!-- TRANSLATOR: used as in apt-extracttemplates filename --> +<!ENTITY synopsis-filename "filename"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> +<!ENTITY synopsis-path "path"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> +<!ENTITY synopsis-override "override-file"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> +<!ENTITY synopsis-pathprefix "pathprefix"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive generate section --> +<!ENTITY synopsis-section "section"> + +<!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export 473041FA --> +<!ENTITY synopsis-keyid "keyid"> +