[svn] GnuPG - r3921 - trunk/doc

[svn author dshaw]

Author: dshaw
Date: 2005-11-02 17:53:40 +0100 (Wed, 02 Nov 2005)
New Revision: 3921

Modified:
   trunk/doc/ChangeLog
   trunk/doc/gpg.sgml
Log:
* gpg.sgml: Clarify what is and isn't included in a "clean sigs".


Modified: trunk/doc/ChangeLog
===================================================================
--- trunk/doc/ChangeLog	2005-11-02 16:47:02 UTC (rev 3920)
+++ trunk/doc/ChangeLog	2005-11-02 16:53:40 UTC (rev 3921)
@@ -1,3 +1,7 @@
+2005-11-02  David Shaw  <dshaw at jabberwocky.com>
+
+	* gpg.sgml: Clarify what is and isn't included in a "clean sigs".
+
 2005-10-27  David Shaw  <dshaw at jabberwocky.com>
 
 	* gpg.sgml: Document backsign, --require-backsigs, and

Modified: trunk/doc/gpg.sgml
===================================================================
--- trunk/doc/gpg.sgml	2005-11-02 16:47:02 UTC (rev 3920)
+++ trunk/doc/gpg.sgml	2005-11-02 16:53:40 UTC (rev 3921)
@@ -548,9 +548,9 @@
 <term>sigs</term>
 <listitem><para>
 Remove any signatures that are not usable by the trust calculations.
-For example, this removes any signature that does not validate.  It
-also removes any signature that is superceded by a later signature, or
-signatures that were revoked.
+Specifically, this removes any signature that does not validate, any
+signature that is superceded by a later signature, revoked signatures,
+and signatures issued by keys that are not present on the keyring.
 </para></listitem></varlistentry>
 
 <varlistentry>
@@ -567,7 +567,7 @@
 
 <varlistentry>
 <term>backsign</term>
-<listitem></para>
+<listitem><para>
 Add back signatures to signing subkeys that may not currently have
 back signatures.  Back signatures protect against a subtle attack
 against signing subkeys.  See --require-backsigs.
@@ -1402,8 +1402,9 @@
 <term>import-clean-sigs</term>
 <listitem><para>
 After import, remove any signatures from the new key that are not
-usable.  This is the same as running the --edit-key command "clean
-sigs" after import.  Defaults to no.
+usable.  This includes signatures that were issued by keys that are
+not present on the keyring.  This option is the same as running the
+--edit-key command "clean sigs" after import.  Defaults to no.
 </para></listitem></varlistentry>
 
 <varlistentry>
@@ -1464,9 +1465,10 @@
 <varlistentry>
 <term>export-clean-sigs</term>
 <listitem><para>
-Do not export any signatures that are not usable.  This is the same as
-running the --edit-key command "clean sigs" before export.  Defaults
-to no.
+Do not export any signatures that are not usable.  This includes
+signatures that were issued by keys that are not present on the
+keyring.  This option is the same as running the --edit-key command
+"clean sigs" before export.  Defaults to no.
 </para></listitem></varlistentry>
 
 <varlistentry>