diff options
Diffstat (limited to 'doc/po/apt-doc.pot')
| -rw-r--r-- | doc/po/apt-doc.pot | 478 |
1 files changed, 333 insertions, 145 deletions
diff --git a/doc/po/apt-doc.pot b/doc/po/apt-doc.pot index 30e24eebd..c308771f2 100644 --- a/doc/po/apt-doc.pot +++ b/doc/po/apt-doc.pot @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: apt-doc 1.1~exp14\n" "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n" -"POT-Creation-Date: 2015-10-20 19:29+0200\n" +"POT-Creation-Date: 2015-10-22 16:34+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -526,170 +526,180 @@ msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt.8.xml:1 msgid "" -"<command>apt</command> (Advanced Package Tool) is the command-line tool for " -"handling packages. It provides a commandline interface for the package " -"management of the system. See also &apt-get; and &apt-cache; for more " -"low-level command options." +"<command>apt</command> provides a high-level commandline interface for the " +"package management system. It is intended as an end user interface and " +"enables some options better suited for interactive usage by default compared " +"to more specialized APT tools like &apt-get; and &apt-cache;." msgstr "" -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#. type: Content of: <refentry><refsect1><para> #: apt.8.xml:1 msgid "" -"<literal>list</literal> is used to display a list of packages. It supports " -"shell pattern for matching package names and the following options: " -"<option>--installed</option>, <option>--upgradable</option>, " -"<option>--upgradeable</option>, <option>--all-versions</option> are " -"supported." +"Much like <command>apt</command> itself, its manpage is intended as an end " +"user interface and as such only mentions the most used commands and options " +"partly to not duplicate information in multiple places and partly to avoid " +"overwelming readers with a cornucopia of options and details." msgstr "" -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> -#: apt.8.xml:1 -msgid "" -"<literal>search</literal> searches for the given term(s) and display " -"matching packages." +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> +#: apt.8.xml:1 apt.8.xml:1 apt.8.xml:1 apt.8.xml:1 apt.8.xml:1 +msgid "(&apt-get;)" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"<literal>show</literal> shows the package information for the given " -"package(s)." +"<option>update</option> is used to download package information from all " +"configured sources. Other commands operate on this data to e.g. perform " +"package upgrades or search in and display details about all packages " +"available for installation." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"<literal>install</literal> is followed by one or more package names desired " -"for installation or upgrading." +"<option>upgrade</option> is used to install available upgrades of all " +"packages currently installed on the system from the sources configured via " +"&sources-list;. New packages will be installed if required to statisfy " +"dependencies, but existing packages will never be removed. If an upgrade for " +"a package requires the remove of an installed package the upgrade for this " +"package isn't performed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> -#: apt.8.xml:1 apt-get.8.xml:1 -msgid "" -"A specific version of a package can be selected for installation by " -"following the package name with an equals and the version of the package to " -"select. This will cause that version to be located and selected for " -"install. Alternatively a specific distribution can be selected by following " -"the package name with a slash and the version of the distribution or the " -"Archive name (stable, testing, unstable)." -msgstr "" - -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> -#: apt.8.xml:1 apt-get.8.xml:1 +#: apt.8.xml:1 msgid "" -"<literal>remove</literal> is identical to <literal>install</literal> except " -"that packages are removed instead of installed. Note that removing a package " -"leaves its configuration files on the system. If a plus sign is appended to " -"the package name (with no intervening space), the identified package will be " -"installed instead of removed." -msgstr "" - -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> -#: apt.8.xml:1 apt-get.8.xml:1 apt-get.8.xml:1 -msgid "(and the" +"<literal>full-upgrade</literal> performs the function of upgrade but will " +"remove currently installed packages if this is needed to upgrade the system " +"as a whole." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> -#: apt.8.xml:1 apt-get.8.xml:1 apt-get.8.xml:1 -msgid "alias since 1.1)" +#: apt.8.xml:1 apt.8.xml:1 +msgid "," msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> -#: apt.8.xml:1 apt-get.8.xml:1 +#: apt.8.xml:1 msgid "" -"<literal>autoremove</literal> is used to remove packages that were " -"automatically installed to satisfy dependencies for other packages and are " -"now no longer needed." +"Performs the requested action on one or more packages specified via ®ex;, " +"&glob; or exact match. The requested action can be overidden for specific " +"packages by append a plus (+) to the package name to install this package or " +"a minus (-) to remove it." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"<literal>edit-sources</literal> lets you edit your sources.list file and " -"provides basic sanity checks." +"A specific version of a package can be selected for installation by " +"following the package name with an equals (=) and the version of the package " +"to select. Alternatively the version from a specific release can be selected " +"by following the package name with a forward slash (/) and codename " +"(&stable-codename;, &testing-codename;, sid …) or suite name (stable, " +"testing, unstable). This will also select versions from this release for " +"dependencies of this package if needed to satisfy the request." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"<literal>update</literal> is used to resynchronize the package index files " -"from their sources." +"Removing a package removes all packaged data, but leaves usually small " +"(modified) user configuration files behind, in case the remove was an " +"accident. Just issuing an installtion request for the accidently removed " +"package will restore it funcation as before in that case. On the other hand " +"you can get right of these leftovers via calling <command>purge</command> " +"even on already removed packages. Note that this does not effect any data " +"or configuration stored in your home directory." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"<literal>upgrade</literal> is used to install the newest versions of all " -"packages currently installed on the system from the sources enumerated in " -"<filename>/etc/apt/sources.list</filename>. New packages will be installed, " -"but existing packages will never be removed." +"<literal>autoremove</literal> is used to remove packages that were " +"automatically installed to satisfy dependencies for other packages and are " +"now no longer needed as dependencies changed or the package(s) needing them " +"were removed in the meantime." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"<literal>full-upgrade</literal> performs the function of upgrade but may " -"also remove installed packages if that is required in order to resolve a " -"package conflict." +"Try to ensure that the list does not include applications you have grown to " +"like even through they there once installed just as a dependency of another " +"package. You can mark such a package as manually installed by using " +"&apt-mark;. Packages which you have installed explicitly via " +"<command>install</command> are never proposed for automatic removal as well." msgstr "" -#. type: Content of: <refentry><refsect1><title> -#: apt.8.xml:1 apt-get.8.xml:1 apt-cache.8.xml:1 apt-mark.8.xml:1 -#: apt-config.8.xml:1 apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 -#: apt-ftparchive.1.xml:1 -msgid "options" +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> +#: apt.8.xml:1 apt.8.xml:1 +msgid "(&apt-cache;)" msgstr "" -#. type: Content of: <refentry><refsect1><title> +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 -msgid "Script usage" +msgid "" +"<option>search</option> can be used to search for the given ®ex; term(s) " +"in the list of the available packages and display matches. This can e.g. be " +"useful if you are looking for packages having a specific feature. If you " +"are looking for a package including a specific file try &apt-file;." msgstr "" -#. type: Content of: <refentry><refsect1><para> +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"The &apt; commandline is designed as a end-user tool and it may change the " -"output between versions. While it tries to not break backward compatibility " -"there is no guarantee for it either. All features of &apt; are available in " -"&apt-cache; and &apt-get; via APT options. Please prefer using these " -"commands in your scripts." +"Show information about the given package(s) including its dependencies, " +"installation and download size, sources the package is available from, the " +"description of the packages content and many more. It can e.g. be helpful to " +"look at this information before allowing &apt; to remove a package or while " +"searching for new packages to install." msgstr "" -#. type: Content of: <refentry><refsect1><title> -#: apt.8.xml:1 -msgid "Differences to &apt-get;" +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> +#: apt.8.xml:1 apt.8.xml:1 +msgid "(work-in-progress)" msgstr "" -#. type: Content of: <refentry><refsect1><para> +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 msgid "" -"The <command>apt</command> command is meant to be pleasant for end users and " -"does not need to be backward compatible like &apt-get;. Therefore some " -"options are different:" +"<option>list</option> is somewhat similar to <command>dpkg-query " +"--list</command> in that it can display a list of packages satisfying " +"certain criteria. It supports &glob; patterns for matching package names as " +"well as options to list installed (<option>--installed</option>), " +"upgradeable (<option>--upgradeable</option>) or all available " +"(<option>--all-versions</option>) versions." msgstr "" -#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt.8.xml:1 -msgid "The option <literal>DPkg::Progress-Fancy</literal> is enabled." +msgid "" +"<literal>edit-sources</literal> lets you edit your &sources-list; files in " +"your preferred texteditor while also providing basic sanity checks." msgstr "" -#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> +#. type: Content of: <refentry><refsect1><title> #: apt.8.xml:1 -msgid "The option <literal>APT::Color</literal> is enabled." +msgid "Script usage and Differences to other APT tools" msgstr "" -#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> +#. type: Content of: <refentry><refsect1><para> #: apt.8.xml:1 msgid "" -"A new <literal>list</literal> command is available similar to <literal>dpkg " -"--list</literal>." +"The &apt; commandline is designed as a end-user tool and it may change " +"behaviour between versions. While it tries to not break backward " +"compatibility there is no guarantee for it either if it seems benefitial for " +"interactive use." msgstr "" -#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> +#. type: Content of: <refentry><refsect1><para> #: apt.8.xml:1 msgid "" -"The option <literal>upgrade</literal> has <literal>--with-new-pkgs</literal> " -"enabled by default." +"All features of &apt; are available in dedicated APT tools like &apt-get; " +"and &apt-cache; as well. &apt; just changes the default value of some " +"options (see &apt-conf; and specifically the Binary scope). So prefer using " +"these commands (potentially with some additional options enabled) in your " +"scripts as they keep backward compatibility as much as possible." msgstr "" #. type: Content of: <refentry><refsect1><title> @@ -820,6 +830,17 @@ msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:1 msgid "" +"A specific version of a package can be selected for installation by " +"following the package name with an equals and the version of the package to " +"select. This will cause that version to be located and selected for " +"install. Alternatively a specific distribution can be selected by following " +"the package name with a slash and the version of the distribution or the " +"Archive name (stable, testing, unstable)." +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: apt-get.8.xml:1 +msgid "" "Both of the version selection mechanisms can downgrade packages and must be " "used with care." msgstr "" @@ -858,6 +879,16 @@ msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:1 msgid "" +"<literal>remove</literal> is identical to <literal>install</literal> except " +"that packages are removed instead of installed. Note that removing a package " +"leaves its configuration files on the system. If a plus sign is appended to " +"the package name (with no intervening space), the identified package will be " +"installed instead of removed." +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: apt-get.8.xml:1 +msgid "" "<literal>purge</literal> is identical to <literal>remove</literal> except " "that packages are removed and purged (any configuration files are deleted " "too)." @@ -946,6 +977,16 @@ msgid "" "<filename>&cachedir;/archives/partial/</filename>." msgstr "" +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> +#: apt-get.8.xml:1 apt-get.8.xml:1 +msgid "(and the" +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> +#: apt-get.8.xml:1 apt-get.8.xml:1 +msgid "alias since 1.1)" +msgstr "" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:1 msgid "" @@ -961,6 +1002,14 @@ msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:1 msgid "" +"<literal>autoremove</literal> is used to remove packages that were " +"automatically installed to satisfy dependencies for other packages and are " +"now no longer needed." +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: apt-get.8.xml:1 +msgid "" "<literal>changelog</literal> tries to download the changelog of a package " "and displays it through <command>sensible-pager</command>. By default it " "displays the changelog for the version that is installed. However, you can " @@ -982,6 +1031,12 @@ msgid "" "<literal><filename>doc/acquire-additional-files.txt</filename></literal>." msgstr "" +#. type: Content of: <refentry><refsect1><title> +#: apt-get.8.xml:1 apt-cache.8.xml:1 apt-config.8.xml:1 +#: apt-extracttemplates.1.xml:1 apt-sortpkgs.1.xml:1 apt-ftparchive.1.xml:1 +msgid "options" +msgstr "" + #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-get.8.xml:1 msgid "" @@ -1843,6 +1898,14 @@ msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-key.8.xml:1 +msgid "" +"It is critical that keys added manually via <command>apt-key</command> are " +"verified to belong to the owner of the repositories they claim to be for " +"otherwise the &apt-secure; infrastructure is completely undermined." +msgstr "" + +#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#: apt-key.8.xml:1 msgid "Remove a key from the list of trusted keys." msgstr "" @@ -1869,8 +1932,11 @@ msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-key.8.xml:1 msgid "" -"Pass advanced options to gpg. With adv --recv-key you can download the " -"public key." +"Pass advanced options to gpg. With <command>adv --recv-key</command> you can " +"e.g. download key from keyservers directly into the the trusted set of " +"keys. Note that there are <emphasis>no</emphasis> checks performed, so it is " +"easy to completely undermine the &apt-secure; infrastructure if used without " +"care." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> @@ -1894,7 +1960,7 @@ msgid "" msgstr "" #. type: Content of: <refentry><refsect1><title> -#: apt-key.8.xml:1 apt-cdrom.8.xml:1 +#: apt-key.8.xml:1 apt-mark.8.xml:1 apt-mark.8.xml:1 apt-cdrom.8.xml:1 msgid "Options" msgstr "" @@ -1953,14 +2019,23 @@ msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: apt-mark.8.xml:1 -msgid "mark/unmark a package as being automatically-installed" +msgid "show, set and unset various settings for a package" msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-mark.8.xml:1 msgid "" -"<command>apt-mark</command> will change whether a package has been marked as " -"being automatically installed." +"<command>apt-mark</command> can be used as a unified frontend to set various " +"settings for a package like marking a package as being " +"automatically/manually installed or changing <command>dpkg</command> " +"selections such as hold, install, deinstall and purge which are respected " +"e.g. by <command>apt-get dselect-upgrade</command> or " +"<command>aptitude</command>." +msgstr "" + +#. type: Content of: <refentry><refsect1><title> +#: apt-mark.8.xml:1 +msgid "Automatically and manually installed packages" msgstr "" #. type: Content of: <refentry><refsect1><para> @@ -1968,9 +2043,11 @@ msgstr "" msgid "" "When you request that a package is installed, and as a result other packages " "are installed to satisfy its dependencies, the dependencies are marked as " -"being automatically installed. Once these automatically installed packages " -"are no longer depended on by any manually installed packages, they will be " -"removed by e.g. <command>apt-get</command> or <command>aptitude</command>." +"being automatically installed, while package you installed explicitely is " +"marked as manually installed. Once a automatically installed package is no " +"longer depended on by any manually installed package it is considered no " +"longer needed and e.g. <command>apt-get</command> or " +"<command>aptitude</command> will at least suggest removing them." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> @@ -1992,35 +2069,46 @@ msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-mark.8.xml:1 msgid "" -"<literal>hold</literal> is used to mark a package as held back, which will " -"prevent the package from being automatically installed, upgraded or " -"removed. The command is only a wrapper around <command>dpkg " -"--set-selections</command> and the state is therefore maintained by &dpkg; " -"and not affected by the <option>--file</option> option." +"<literal>showauto</literal> is used to print a list of automatically " +"installed packages with each package on a new line. All automatically " +"installed packages will be listed if no package is given. If packages are " +"given only those which are automatically installed will be shown." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-mark.8.xml:1 msgid "" -"<literal>unhold</literal> is used to cancel a previously set hold on a " -"package to allow all actions again." +"<literal>showmanual</literal> can be used in the same way as " +"<literal>showauto</literal> except that it will print a list of manually " +"installed packages instead." +msgstr "" + +#. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para> +#: apt-mark.8.xml:1 +msgid "" +"Read/Write package stats from the filename given with the parameter " +"&synopsis-param-filename; instead of from the default location, which is " +"<filename>extended_status</filename> in the directory defined by the " +"Configuration Item: <literal>Dir::State</literal>." +msgstr "" + +#. type: Content of: <refentry><refsect1><title> +#: apt-mark.8.xml:1 +msgid "Prevent changes for a package" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-mark.8.xml:1 msgid "" -"<literal>showauto</literal> is used to print a list of automatically " -"installed packages with each package on a new line. All automatically " -"installed packages will be listed if no package is given. If packages are " -"given only those which are automatically installed will be shown." +"<literal>hold</literal> is used to mark a package as held back, which will " +"prevent the package from being automatically installed, upgraded or removed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: apt-mark.8.xml:1 msgid "" -"<literal>showmanual</literal> can be used in the same way as " -"<literal>showauto</literal> except that it will print a list of manually " -"installed packages instead." +"<literal>unhold</literal> is used to cancel a previously set hold on a " +"package to allow all actions again." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> @@ -2030,13 +2118,22 @@ msgid "" "the same way as for the other show commands." msgstr "" -#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> +#. type: Content of: <refentry><refsect1><title> +#: apt-mark.8.xml:1 +msgid "Shedule packages for install, remove and purge" +msgstr "" + +#. type: Content of: <refentry><refsect1><para> #: apt-mark.8.xml:1 msgid "" -"Read/Write package stats from the filename given with the parameter " -"&synopsis-param-filename; instead of from the default location, which is " -"<filename>extended_status</filename> in the directory defined by the " -"Configuration Item: <literal>Dir::State</literal>." +"Some frontends like <command>apt-get dselect-upgrade</command> can be used " +"to apply previously sheduled changes to the install state of packages. Such " +"changes can be sheduled with the <option>install</option>, " +"<option>remove</option> (also known as <option>deinstall</option>) and " +"<option>purge</option> commands. Packages with a specific selection can be " +"displayed with <option>showinstall</option>, <option>showremove</option> and " +"<option>showpurge</option> respectively. More information about these so " +"called dpkg selections can be found in &dpkg;." msgstr "" #. type: Content of: <refentry><refsect1><para> @@ -2054,38 +2151,49 @@ msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-secure.8.xml:1 msgid "" -"Starting with version 0.6, <command>apt</command> contains code that does " -"signature checking of the Release file for all archives. This ensures that " -"packages in the archive can't be modified by people who have no access to " -"the Release file signing key." +"Starting with version 0.6, <command>APT</command> contains code that does " +"signature checking of the Release file for all repositories. This ensures " +"that data like packages in the archive can't be modified by people who have " +"no access to the Release file signing key." msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-secure.8.xml:1 msgid "" -"If a package comes from a archive without a signature, or with a signature " -"that apt does not have a key for, that package is considered untrusted, and " -"installing it will result in a big warning. <command>apt-get</command> will " -"currently only warn for unsigned archives; future releases might force all " -"sources to be verified before downloading packages from them." +"If an archive doesn't have a signed Release file or no Release file at all " +"current APT versions will raise a warning in <command>update</command> " +"operations and frontends like <command>apt-get</command> will require " +"explicit confirmation if an installation request includes a package from " +"such an unauthenticated archive." msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-secure.8.xml:1 msgid "" -"The package frontends &apt-get;, &aptitude; and &synaptic; support this new " -"authentication feature." +"In the future APT will refuse to work with unauthenticated repositories by " +"default until support for them is removed entirely. Users have the option to " +"opt-in to this behavior already by setting the configuration option " +"<option>Acquire::AllowInsecureRepositories</option> to " +"<literal>false</literal>." +msgstr "" + +#. type: Content of: <refentry><refsect1><para> +#: apt-secure.8.xml:1 +msgid "" +"Note: All APT-based package management frontends like &apt-get;, &aptitude; " +"and &synaptic; support this authentication feature, so this manpage uses " +"<literal>APT</literal> to refer to them all for simplicity only." msgstr "" #. type: Content of: <refentry><refsect1><title> #: apt-secure.8.xml:1 -msgid "Trusted archives" +msgid "Trusted repositories" msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-secure.8.xml:1 msgid "" -"The chain of trust from an apt archive to the end user is made up of several " +"The chain of trust from an APT archive to the end user is made up of several " "steps. <command>apt-secure</command> is the last step in this chain; " "trusting an archive does not mean that you trust its packages not to contain " "malicious code, but means that you trust the archive maintainer. It's the " @@ -2105,12 +2213,13 @@ msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-secure.8.xml:1 msgid "" -"The chain of trust in Debian starts when a maintainer uploads a new package " -"or a new version of a package to the Debian archive. In order to become " -"effective, this upload needs to be signed by a key contained in the Debian " -"Maintainers keyring (available in the debian-keyring package). Maintainers' " -"keys are signed by other maintainers following pre-established procedures to " -"ensure the identity of the key holder." +"The chain of trust in Debian e.g. starts when a maintainer uploads a new " +"package or a new version of a package to the Debian archive. In order to " +"become effective, this upload needs to be signed by a key contained in one " +"of the Debian package maintainers keyrings (available in the debian-keyring " +"package). Maintainers' keys are signed by other maintainers following " +"pre-established procedures to ensure the identity of the key holder. Similar " +"procedures exist in all Debian-based distributions." msgstr "" #. type: Content of: <refentry><refsect1><para> @@ -2163,10 +2272,10 @@ msgstr "" #. type: Content of: <refentry><refsect1><para> #: apt-secure.8.xml:1 msgid "" -"However, it does not defend against a compromise of the Debian master server " -"itself (which signs the packages) or against a compromise of the key used to " -"sign the Release files. In any case, this mechanism can complement a " -"per-package signature." +"However, it does not defend against a compromise of the master server itself " +"(which signs the packages) or against a compromise of the key used to sign " +"the Release files. In any case, this mechanism can complement a per-package " +"signature." msgstr "" #. type: Content of: <refentry><refsect1><title> @@ -2178,9 +2287,18 @@ msgstr "" #: apt-secure.8.xml:1 msgid "" "<command>apt-key</command> is the program that manages the list of keys used " -"by apt. It can be used to add or remove keys, although an installation of " -"this release will automatically contain the default Debian archive signing " -"keys used in the Debian package repositories." +"by APT to trust repositories. It can be used to add or remove keys as well " +"as list the trusted keys. Limiting which key(s) are able to sign which " +"archive is possible via the <option>Signed-By</option> in &sources-list;." +msgstr "" + +#. type: Content of: <refentry><refsect1><para> +#: apt-secure.8.xml:1 +msgid "" +"Note that a default installation already contains all keys to securily " +"acquire packages from the default repositories, so fiddling with " +"<command>apt-key</command> is only needed if third-party repositories are " +"added." msgstr "" #. type: Content of: <refentry><refsect1><para> @@ -2227,7 +2345,20 @@ msgstr "" msgid "" "<emphasis>Publish the key fingerprint</emphasis>, that way your users will " "know what key they need to import in order to authenticate the files in the " -"archive." +"archive. It is best to ship your key in its own keyring package like " +"&keyring-distro; does with &keyring-package; to be able to distribute " +"updates and key transitions automatically later." +msgstr "" + +#. type: Content of: <refentry><refsect1><itemizedlist><listitem><para> +#: apt-secure.8.xml:1 +msgid "" +"<emphasis>Provide instructions on how to add your archive and " +"key</emphasis>. If your users can't acquire your key securily the chain of " +"trust described above is broken. How you can help users add your key " +"depends on your archive and target audience ranging from having your keyring " +"package included in another archive users already have configured (like the " +"default repositories of their distribution) to leverage the web of trust." msgstr "" #. type: Content of: <refentry><refsect1><para> @@ -2249,7 +2380,7 @@ msgstr "" #: apt-secure.8.xml:1 msgid "" "For more background information you might want to review the <ulink " -"url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian " +"url=\"https://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian " "Security Infrastructure</ulink> chapter of the Securing Debian Manual " "(available also in the harden-doc package) and the <ulink " "url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong " @@ -2536,6 +2667,13 @@ msgstr "" #. type: Content of: <refentry><refsect1><orderedlist><listitem><para> #: apt.conf.5.xml:1 msgid "" +"all options set in the binary specific configuration subtree are moved into " +"the root of the tree." +msgstr "" + +#. type: Content of: <refentry><refsect1><orderedlist><listitem><para> +#: apt.conf.5.xml:1 +msgid "" "the command line options are applied to override the configuration " "directives or to load even more configuration files." msgstr "" @@ -3372,6 +3510,40 @@ msgstr "" #. type: Content of: <refentry><refsect1><title> #: apt.conf.5.xml:1 +msgid "Binary specific configuration" +msgstr "" + +#. type: Content of: <refentry><refsect1><para> +#: apt.conf.5.xml:1 +msgid "" +"Especially with the introduction of the <command>apt</command> binary it can " +"be useful to set certain options only for a specific binary as even options " +"which look like they would effect only a certain binary like " +"<option>APT::Get::Show-Versions</option> effect <command>apt-get</command> " +"as well as <command>apt</command>." +msgstr "" + +#. type: Content of: <refentry><refsect1><para> +#: apt.conf.5.xml:1 +msgid "" +"Setting an option for a specific binary only can be achieved by setting the " +"option inside the " +"<option>Binary::<replaceable>specific-binary</replaceable></option> " +"scope. Setting the option <option>APT::Get::Show-Versions</option> for the " +"<command>apt</command> only can e.g. by done by setting " +"<option>Binary::apt::APT::Get::Show-Versions</option> instead." +msgstr "" + +#. type: Content of: <refentry><refsect1><para> +#: apt.conf.5.xml:1 +msgid "" +"Note that as seen in the DESCRIPTION section further above you can't set " +"binary-specific options on the commandline itself nor in configuration files " +"loaded via the commandline." +msgstr "" + +#. type: Content of: <refentry><refsect1><title> +#: apt.conf.5.xml:1 msgid "Directories" msgstr "" @@ -5371,6 +5543,22 @@ msgstr "" #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> #: sources.list.5.xml:1 msgid "" +"<option>Trusted</option> (<option>trusted</option>) is a tri-state value " +"which defaults to APT deciding if a source is considered trusted or if " +"warnings should be raised before e.g. packages are installed from this " +"source. This option can be used to override this decision either with the " +"value <literal>yes</literal>, which lets APT consider this source always as " +"a trusted source even if it has no or fails authentication checks by " +"disabling parts of &apt-secure; and should therefore only be used in a local " +"and trusted context (if at all) as otherwise security is breached. The " +"opposite can be achieved with the value no, which causes the source to be " +"handled as untrusted even if the authentication checks passed successfully. " +"The default value can't be set explicitly." +msgstr "" + +#. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para> +#: sources.list.5.xml:1 +msgid "" "<option>Signed-By</option> (<option>signed-by</option>) is either an " "absolute path to a keyring file (has to be accessible and readable for the " "<literal>_apt</literal> user, so ensure everyone has read-permissions on the " |