From 35482c5ee5614fb394274f667efd7f12babba0b4 Mon Sep 17 00:00:00 2001 From: David Shaw Date: Thu, 12 Feb 2004 20:46:18 +0000 Subject: [PATCH] * gnupg.7: Clarify that 'gpgv' doesn't encrypt, and that's not a bug. * samplekeys.asc: Update 99242560. * gpg.sgml: Clarify -u/--local-user and --default-key. Note what happens if you run 'gpg' without any commands. Document --multifile. Document list-option show-unusable-subkeys. --- doc/ChangeLog | 11 ++++ doc/gnupg.7 | 13 +++-- doc/gpg.sgml | 53 +++++++++++------ doc/samplekeys.asc | 140 ++++++++++++++++++++++++--------------------- 4 files changed, 128 insertions(+), 89 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 51ad5da3b..78b2b2589 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,14 @@ +2004-02-12 David Shaw + + * gnupg.7: Clarify that 'gpgv' doesn't encrypt, and that's not a + bug. + + * samplekeys.asc: Update 99242560. + + * gpg.sgml: Clarify -u/--local-user and --default-key. Note what + happens if you run 'gpg' without any commands. Document + --multifile. Document list-option show-unusable-subkeys. + 2004-01-30 David Shaw * DETAILS: Details for --list-config. diff --git a/doc/gnupg.7 b/doc/gnupg.7 index d11a4c94a..a3dd29066 100644 --- a/doc/gnupg.7 +++ b/doc/gnupg.7 @@ -3,12 +3,13 @@ GnuPG \- The GNU Privacy Guard suite of programs .SH DESCRIPTION GnuPG is a set of programs for public key encryption and digital -signatures. The program most users want to use is -the OpenPGP command line tool, named \fBgpg\fP. \fBgpgv\fP -is a stripped down version of \fBgpg\fP to verify signatures -against a trusted keyring. There is also a tool called -\fBgpgsplit\fP to split OpenPGP messages or keyrings into their packets. +signatures. The program most users will want to use is the OpenPGP +command line tool, named \fBgpg\fP. \fBgpgv\fP is a stripped down +version of \fBgpg\fP with no encryption functionality, used only to +verify signatures against a trusted keyring. There is also a tool +called \fBgpgsplit\fP to split OpenPGP messages or keyrings into their +component packets. This is mainly useful for seeing how OpenPGP +messages are put together. .SH "SEE ALSO" .BR gpg (1), .BR gpgv (1), - diff --git a/doc/gpg.sgml b/doc/gpg.sgml index ed5deaf07..58c893df6 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -87,6 +87,14 @@ special option "--". COMMANDS + + + + @@ -182,29 +190,33 @@ For security reasons a detached signature cannot read the signed material from stdin without denoting it in the above way. + +--multifile + +This modifies certain other commands to accept multiple files for +processing on the command line or read from stdin with each filename +on a separate line. This allows for many files to be processed at +once. --multifile may currently be used along with --verify, +--encrypt, and --decrypt. Note that `--multifile --verify' may not be +used with detached signatures. + + --verify-files -This is a special version of the --verify command which does not work with -detached signatures. The command expects the files to be verified either -on the command line or reads the filenames from stdin; each name must be on -separate line. The command is intended for quick checking of many files. +Identical to `--multifile --verify'. --encrypt-files -This is a special version of the --encrypt command. The command expects -the files to be encrypted either on the command line or reads the filenames -from stdin; each name must be on separate line. The command is intended -for a quick encryption of multiple files. +Identical to `--multifile --encrypt'. --decrypt-files -The same as --encrypt-files with the difference that files will be -decrypted. The syntax of the filenames is the same. +Identical to `--multifile --decrypt'.