[PATCH] In the manpage, mention at the --sign options how to select the signing key

Christian Jaeger christian at jaeger.mine.nu
Tue May 13 02:53:26 CEST 2008


I've got several private keys. Although I'm a long time (but not
frequent) gpg user now, I still find a few things in the user
interface a bit confusing; today I've searched the man page in vain
trying to find out how to specify which private key to use for
signing. Someone helped me point it out on the IRC channel; I didn't
find it at first since I was searching the manpage for strings like
sign.*key and similar. So I propose to add this to the place where I
was expecting to find it, at the sign options themselves.

This patch is against current svn://cvs.gnupg.org/gnupg/trunk gnupg,
that seems to be gnupg2, but I'm actually using gnupg version 1
(version 1.4.6 from Debian testing), but both of the man pages need
the same fix, so I suggest to apply the patch to both versions.


(ps. this is from git-format-patch out of a git-svn clone of the svn
repository; I'm hoping you're not having problems applying it using
the svn tools (or patch)?)

 doc/gpg.texi |    7 +++++--
 1 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/gpg.texi b/doc/gpg.texi
index a122691..a4dbd9c 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -178,7 +178,9 @@ Make a signature. This command may be combined with @option{--encrypt}
 (for a signed and encrypted message), @option{--symmetric} (for a signed
 and symmetrically encrypted message), or @option{--encrypt} and
 @option{--symmetric} together (for a signed message that may be
-decrypted via a secret key or a passphrase).
+decrypted via a secret key or a passphrase). For changing the private
+key to be used for signing, see the --local-user and --default-key
 @item --clearsign
 @opindex clearsign
@@ -186,7 +188,8 @@ Make a clear text signature. The content in a clear text signature is
 readable without any special software. OpenPGP software is only
 needed to verify the signature. Clear text signatures may modify
 end-of-line whitespace for platform independence and are not intended
-to be reversible.
+to be reversible. For changing the private key to be used for signing,
+see the --local-user and --default-key options.
 @item --detach-sign
 @itemx -b

More information about the Gnupg-devel mailing list