* gpg.sgml: Clarify --mangle-dos-filenames, document list-option

show-unusable-uids, remove --no-comment (which is now --no-sk-comments),
add --no-comments (to remove --comment), remove --default-comment, and
document --sig-keyserver-url.

doc/ChangeLog

@@ -1,3 +1,10 @@
+2003-09-30  David Shaw  <dshaw@jabberwocky.com>
+
+	* gpg.sgml: Clarify --mangle-dos-filenames, document list-option
+	show-unusable-uids, remove --no-comment (which is now
+	--no-sk-comments), add --no-comments (to remove --comment), remove
+	--default-comment, and document --sig-keyserver-url.
+
 2003-09-01  David Shaw  <dshaw@jabberwocky.com>
 
 	* DETAILS: Note fingerprint of signing key in sig records.

doc/gpg.sgml

@@ -785,16 +785,15 @@ Create ASCII armored output.
 Write output to &ParmFile;.
 </para></listitem></varlistentry>
 
+
 <varlistentry>
 <term>--mangle-dos-filenames</term>
 <term>--no-mangle-dos-filenames</term>
 <listitem><para>
-The Windows version of GnuPG replaces the extension of an output
+Older version of Windows cannot handle filenames with more than one
-filename to avoid problems with filenames containing more than one
+dot.  --mangle-dos-filenames causes GnuPG to replace (rather than add
-dot.  This is not necessary for newer Windows versions and so
+to) the extension of an output filename to avoid this problem.  This
---no-mangle-dos-filenames can be used to switch this feature off and
+option is off by default and has no effect on non-Windows platforms.
-have GnuPG append the new extension.  This option has no effect on
-non-Windows platforms.
 </para></listitem></varlistentry>
 
 
@@ -1271,6 +1270,12 @@ Display all 64 bits (16 digits) of key IDs during key listings, rather
 than the more common 32 bit (8 digit) IDs.  Defaults to no.
 </para></listitem></varlistentry>
 
+<varlistentry>
+<term>show-unusable-uids</term>
+<listitem><para>
+Show revoked and expired user IDs in key listings.  Defaults to no.
+</para></listitem></varlistentry>
+
 <varlistentry>
 <term>show-keyring</term>
 <listitem><para>
@@ -1567,29 +1572,14 @@ option.
 </para></listitem></varlistentry>
 
 
-<varlistentry>
-<term>--no-comment</term>
-<listitem><para>
-See --no-sk-comments.  This option is deprecated and may be removed
-soon.
-</para></listitem></varlistentry>
-
-
 <varlistentry>
 <term>--comment &ParmString;</term>
+<term>--no-comments</term>
 <listitem><para>
-Use &ParmString; as the comment string in clear text signatures.  The
+Use &ParmString; as a comment string in clear text signatures and
-default behavior is not to use a comment string.
+ASCII armored messages or keys (see --armor).  The default behavior is
-</para></listitem></varlistentry>
+not to use a comment string.  --comment may be repeated multiple times
-
+to get multiple comment strings.  --no-comments removes all comments.
-
-<varlistentry>
-<term>--default-comment</term>
-<listitem><para>
-Force to write the standard comment string in clear
-text signatures.  Use this to overwrite a --comment
-from a config file.  This option is now obsolete because there is no
-default comment string anymore.
 </para></listitem></varlistentry>
 
 
@@ -1650,9 +1640,9 @@ and/or `--verify-options [no-]show-notation' instead.
 <term>--cert-policy-url &ParmString;</term>
 <term>--set-policy-url &ParmString;</term>
 <listitem><para>
-Use &ParmString; as Policy URL for signatures (rfc2440:5.2.3.19).  If
+Use &ParmString; as a Policy URL for signatures (rfc2440:5.2.3.19).
-you prefix it with an exclamation mark, the policy URL packet will be
+If you prefix it with an exclamation mark, the policy URL packet will
-flagged as critical.  --sig-policy-url sets a a policy url for data
+be flagged as critical.  --sig-policy-url sets a a policy url for data
 signatures.  --cert-policy-url sets a policy url for key signatures
 (certifications).  --set-policy-url sets both.
 </para><para>
@@ -1669,6 +1659,17 @@ are deprecated.  Use `--list-options [no-]show-policy-url' and/or
 `--verify-options [no-]show-policy-url' instead.
 </para></listitem></varlistentry>
 
+
+<varlistentry>
+<term>--sig-keyserver-url &ParmString;</term>
+<listitem><para>
+Use &ParmString; as a preferred keyserver URL for data signatures.  If
+you prefix it with an exclamation mark, the keyserver URL packet will
+be flagged as critical.  </para><para>
+The same %-expandos used for notation data are available here as well.
+</para></listitem></varlistentry>
+
+
 <varlistentry>
 <term>--set-filename &ParmString;</term>
 <listitem><para>