gnupg/doc (ChangeLog gpg.sgml)

[cvs user dshaw]

    Date: Monday, June 20, 2005 @ 20:04:39
  Author: dshaw
    Path: /cvs/gnupg/gnupg/doc

Modified: ChangeLog gpg.sgml

* gpg.sgml: Document --edit-key/clean, import-clean, and export-clean.


-----------+
 ChangeLog |    5 ++++
 gpg.sgml  |   62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+)


Index: gnupg/doc/ChangeLog
diff -u gnupg/doc/ChangeLog:1.102 gnupg/doc/ChangeLog:1.103
--- gnupg/doc/ChangeLog:1.102	Mon Jun 20 19:03:27 2005
+++ gnupg/doc/ChangeLog	Mon Jun 20 20:04:39 2005
@@ -1,3 +1,8 @@
+2005-06-20  David Shaw  <dshaw at jabberwocky.com>
+
+	* gpg.sgml: Document --edit-key/clean, import-clean, and
+	export-clean.
+
 2005-06-20  Werner Koch  <wk at g10code.com>
 
 	* gpg.sgml: Document smartcard related options.
Index: gnupg/doc/gpg.sgml
diff -u gnupg/doc/gpg.sgml:1.85 gnupg/doc/gpg.sgml:1.86
--- gnupg/doc/gpg.sgml:1.85	Mon Jun 20 19:03:27 2005
+++ gnupg/doc/gpg.sgml	Mon Jun 20 20:04:39 2005
@@ -543,6 +543,36 @@
     <term>toggle</term>
     <listitem><para>
 Toggle between public and secret key listing.</para></listitem></varlistentry>
+
+<varlistentry>
+<term>clean</term>
+<listitem><para>
+Cleans keys by removing unusable pieces.  This command can be used to
+keep keys neat and clean, and it has no effect aside from that.
+
+<variablelist>
+
+<varlistentry>
+<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.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term>uids</term>
+<listitem><para>
+Compact (by removing all signatures except the selfsig) any user ID
+that is no longer usable (e.g. revoked, or expired).
+</para></listitem></varlistentry>
+
+</variablelist>
+
+If invoked with no arguments, both `sigs' and `uids' are cleaned.
+</para></listitem></varlistentry>
+
     <varlistentry>
     <term>save</term>
     <listitem><para>
@@ -1377,6 +1407,22 @@
 any new keys to be imported.  Defaults to no.
 </para></listitem></varlistentry>
 
+<varlistentry>
+<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.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term>import-clean-uids</term>
+<listitem><para>
+After import, compact (remove all signatures from) any user IDs from
+the new key that are not usable.  This is the same as running the
+--edit-key command "clean uids" after import.  Defaults to no.
+</para></listitem></varlistentry>
+
 </variablelist>
 </para></listitem></varlistentry>
 
@@ -1418,6 +1464,22 @@
 out any signatures that are not self-signatures.  Defaults to no.
 </para></listitem></varlistentry>
 
+<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.
+</para></listitem></varlistentry>
+
+<varlistentry>
+<term>export-clean-uids</term>
+<listitem><para>
+Compact (remove all signatures from) user IDs on the key being
+exported if the user IDs are not usable.  This is the same as running
+the --edit-key command "clean uids" before export.  Defaults to no.
+</para></listitem></varlistentry>
+
 </variablelist>
 </para></listitem></varlistentry>