8 files changed, 274 insertions, 92 deletions
diff --git a/doc/po/apt-doc.pot b/doc/po/apt-doc.pot
index 4fabffeb0..f1ca5714f 100644
--- a/doc/po/apt-doc.pot
+++ b/doc/po/apt-doc.pot
@@ -5,9 +5,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: apt-doc 1.7.0\n"
+"Project-Id-Version: apt-doc 1.8.0~alpha1\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-30 22:10+0100\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\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"
@@ -7276,9 +7276,9 @@ msgid ""
 "&apt-transport-http;), which, as indicated by the appended S, is wrapped in "
 "an encrypted layer known as Transport Layer Security (TLS) to provide "
 "end-to-end encryption.  A sufficiently capable attacker can still observe "
-"the communication partners and deeper analysis of the encrypted communication "
-"might still reveal important details.  An overview over available "
-"alternative transport methods is given in &sources-list;."
+"the communication partners and deeper analysis of the encrypted "
+"communication might still reveal important details.  An overview over "
+"available alternative transport methods is given in &sources-list;."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><para>
diff --git a/doc/po/es.po b/doc/po/es.po
index 137b2f717..e8fd5f60f 100644
--- a/doc/po/es.po
+++ b/doc/po/es.po
@@ -38,7 +38,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2014-07-04 01:31+0200\n"
 "Last-Translator: Omar Campagne <ocampagne@gmail.com>\n"
 "Language-Team: Debian l10n Spanish <debian-l10n-spanish@lists.debian.org>\n"
@@ -1254,6 +1254,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -1326,6 +1333,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "<literal>check</literal> is a diagnostic tool; it updates the package cache "
 "and checks for broken dependencies."
 msgstr ""
@@ -7918,17 +7932,23 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
 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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
diff --git a/doc/po/fr.po b/doc/po/fr.po
index 9992785bd..b71a6692d 100644
--- a/doc/po/fr.po
+++ b/doc/po/fr.po
@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.6\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2018-03-16 00:54+0100\n"
 "Last-Translator: Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>\n"
 "Language-Team: French <debian-l10n-french@lists.debian.org>\n"
@@ -1221,6 +1221,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -1294,6 +1301,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "<literal>check</literal> is a diagnostic tool; it updates the package cache "
 "and checks for broken dependencies."
 msgstr ""
@@ -8013,18 +8027,38 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
-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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+#, fuzzy
+#| 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 file) or one or more fingerprints of keys either in the "
+#| "<filename>trusted.gpg</filename> keyring or in the keyrings in the "
+#| "<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+#| "fingerprint</command>). If the option is set, only the key(s) in this "
+#| "keyring or only the keys with these fingerprints are used for the &apt-"
+#| "secure; verification of this repository. Defaults to the value of the "
+#| "option with the same name if set in the previously acquired "
+#| "<filename>Release</filename> file.  Otherwise all keys in the trusted "
+#| "keyrings are considered valid signers for this repository."
+msgid ""
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 "<option>Signed-By</option> (<option>signed-by</option>) est soit un chemin "
 "absolu vers un fichier de trousseau de clés (qui doit être accessible en "
diff --git a/doc/po/it.po b/doc/po/it.po
index 5d537f1e2..4932bf2e8 100644
--- a/doc/po/it.po
+++ b/doc/po/it.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2017-03-27 19:05+0200\n"
 "Last-Translator: Beatrice Torracca <beatricet@libero.it>\n"
 "Language-Team: Italian <debian-l10n-italian@lists.debian.org>\n"
@@ -1266,6 +1266,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -1340,6 +1347,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "<literal>check</literal> is a diagnostic tool; it updates the package cache "
 "and checks for broken dependencies."
 msgstr ""
@@ -8027,18 +8041,38 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
-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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+#, fuzzy
+#| 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 file) or one or more fingerprints of keys either in the "
+#| "<filename>trusted.gpg</filename> keyring or in the keyrings in the "
+#| "<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+#| "fingerprint</command>). If the option is set, only the key(s) in this "
+#| "keyring or only the keys with these fingerprints are used for the &apt-"
+#| "secure; verification of this repository. Defaults to the value of the "
+#| "option with the same name if set in the previously acquired "
+#| "<filename>Release</filename> file.  Otherwise all keys in the trusted "
+#| "keyrings are considered valid signers for this repository."
+msgid ""
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 "<option>Signed-By</option> (<option>signed-by</option>) è un percorso "
 "assoluto ad un file di portachiavi (deve essere accessibile e leggibile "
diff --git a/doc/po/ja.po b/doc/po/ja.po
index d3d903e33..dbcdbd852 100644
--- a/doc/po/ja.po
+++ b/doc/po/ja.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.4\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2017-01-06 04:50+0900\n"
 "Last-Translator: Takuma Yamada <tyamada@takumayamada.com>\n"
 "Language-Team: Japanese <debian-japanese@lists.debian.org>\n"
@@ -1240,6 +1240,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -1309,6 +1316,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "<literal>check</literal> is a diagnostic tool; it updates the package cache "
 "and checks for broken dependencies."
 msgstr ""
@@ -7695,18 +7709,38 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
-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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+#, fuzzy
+#| 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 file) or one or more fingerprints of keys either in the "
+#| "<filename>trusted.gpg</filename> keyring or in the keyrings in the "
+#| "<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+#| "fingerprint</command>). If the option is set, only the key(s) in this "
+#| "keyring or only the keys with these fingerprints are used for the &apt-"
+#| "secure; verification of this repository. Defaults to the value of the "
+#| "option with the same name if set in the previously acquired "
+#| "<filename>Release</filename> file.  Otherwise all keys in the trusted "
+#| "keyrings are considered valid signers for this repository."
+msgid ""
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 "<option>Signed-By</option> (<option>signed-by</option>) は、(<literal>_apt</"
 "literal> ユーザがアクセス可能かつ読み取り可能な必要があり、つまりすべてのユー"
diff --git a/doc/po/pl.po b/doc/po/pl.po
index ff41c0259..5bda5957c 100644
--- a/doc/po/pl.po
+++ b/doc/po/pl.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2014-07-04 02:13+0200\n"
 "Last-Translator: Robert Luberda <robert@debian.org>\n"
 "Language-Team: Polish <manpages-pl-list@lists.sourceforge.net>\n"
@@ -1233,6 +1233,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -1302,6 +1309,13 @@ msgstr ""
 "tak, żeby spełnić zależności wymagane do zbudowania danego pakietu "
 "źródłowego."
 
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
 #
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
@@ -7363,17 +7377,23 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
 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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
diff --git a/doc/po/pt.po b/doc/po/pt.po
index 2f350a3c9..fd0dd3059 100644
--- a/doc/po/pt.po
+++ b/doc/po/pt.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.7\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2014-08-29 00:34+0100\n"
 "Last-Translator: Américo Monteiro <a_monteiro@gmx.com>\n"
 "Language-Team: Portuguese <traduz@debianpt.org>\n"
@@ -1246,6 +1246,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -1317,6 +1324,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "<literal>check</literal> is a diagnostic tool; it updates the package cache "
 "and checks for broken dependencies."
 msgstr ""
@@ -7844,17 +7858,23 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
 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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
diff --git a/doc/po/pt_BR.po b/doc/po/pt_BR.po
index f84c4fe0f..6efd0e391 100644
--- a/doc/po/pt_BR.po
+++ b/doc/po/pt_BR.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2018-10-07 07:56+0200\n"
+"POT-Creation-Date: 2018-11-12 11:52+0100\n"
 "PO-Revision-Date: 2004-09-20 17:02+0000\n"
 "Last-Translator: André Luís Lopes <andrelop@debian.org>\n"
 "Language-Team: <debian-l10n-portuguese@lists.debian.org>\n"
@@ -896,6 +896,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary and source package names.  See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "Source packages are tracked separately from binary packages via <literal>deb-"
 "src</literal> lines in the &sources-list; file. This means that you will "
 "need to add such a line for each repository you want to get sources from; "
@@ -944,6 +951,13 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt-get.8.xml
 msgid ""
+"The arguments are interpreted as binary or source package names. See the "
+"<option>--only-source</option> option if you want to change that."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-get.8.xml
+msgid ""
 "<literal>check</literal> is a diagnostic tool; it updates the package cache "
 "and checks for broken dependencies."
 msgstr ""
@@ -5900,17 +5914,23 @@ msgstr ""
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
 #: sources.list.5.xml
 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 "
-"file) or one or more fingerprints of keys either in the <filename>trusted."
-"gpg</filename> keyring or in the keyrings in the <filename>trusted.gpg.d/</"
-"filename> directory (see <command>apt-key fingerprint</command>). If the "
-"option is set, only the key(s) in this keyring or only the keys with these "
-"fingerprints are used for the &apt-secure; verification of this repository. "
-"Defaults to the value of the option with the same name if set in the "
-"previously acquired <filename>Release</filename> file.  Otherwise all keys "
-"in the trusted keyrings are considered valid signers for this repository."
+"<option>Signed-By</option> (<option>signed-by</option>)  is an option to "
+"require a repository to pass &apt-secure; verification with a certain set of "
+"keys rather than all trusted keys apt has configured.  It is specified as a "
+"list of absolute paths to keyring files (have to be accessible and readable "
+"for the <literal>_apt</literal> system user, so ensure everyone has read-"
+"permissions on the file) and fingerprints of keys to select from these "
+"keyrings. If no keyring files are specified the default is the "
+"<filename>trusted.gpg</filename> keyring and all keyrings in the "
+"<filename>trusted.gpg.d/</filename> directory (see <command>apt-key "
+"fingerprint</command>). If no fingerprint is specified all keys in the "
+"keyrings are selected. A fingerprint will accept also all signatures by a "
+"subkey of this key, if this isn't desired an exclamation mark (<literal>!</"
+"literal>) can be appended to the fingerprint to disable this behaviour.  The "
+"option defaults to the value of the option with the same name if set in the "
+"previously acquired <filename>Release</filename> file of this repository "
+"(only fingerprints can be specified there through).  Otherwise all keys in "
+"the trusted keyrings are considered valid signers for this repository."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>