diff --git a/doc/ChangeLog b/doc/ChangeLog index 0073e19d5..f85ea41a3 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,17 @@ +2002-04-19 David Shaw + + * gpg.sgml: Add "%t" flag for photo IDs, a note about primary + having different meanings for photo and regular IDs, rename + --default-check-level to --default-cert-check-level, add + --auto-check-trustdb, and --pgp6. + + * DETAILS: Add EXPSIG, EXPKEYSIG, and KEYEXPIRED. Add notes to + SIGEXPIRED (deprecated), and VALIDSIG (added expiration date). + Add "Preferences" command to unattended key generation + instructions. Also fixed a few typos. + + * samplekeys.asc: new + 2002-01-31 Marcus Brinkmann * DETAILS: Fix a spelling error, correct IMPORTED_RES to IMPORT_RES, diff --git a/doc/DETAILS b/doc/DETAILS index e7e8f04f1..1e9183625 100644 --- a/doc/DETAILS +++ b/doc/DETAILS @@ -101,6 +101,16 @@ more arguments in future versions. The username is the primary one encoded in UTF-8 and %XX escaped. + EXPSIG + The signature with the keyid is good, but the signature is + expired. The username is the primary one encoded in UTF-8 and + %XX escaped. + + EXPKEYSIG + The signature with the keyid is good, but the signature was + made by an expired key. The username is the primary one + encoded in UTF-8 and %XX escaped. + BADSIG The signature with the keyid has not been verified okay. The username is the primary one encoded in UTF-8 and %XX @@ -115,11 +125,14 @@ more arguments in future versions. this signature. sig_class is a 2 byte hex-value. VALIDSIG + + The signature with the keyid is good. This is the same as GOODSIG but has the fingerprint as the argument. Both status lines are emitted for a good signature. sig-timestamp is the signature creation time in seconds after - the epoch. + the epoch. expire-timestamp is the signature expiration time + in seconds after the epoch (zero means "does not expire"). SIG_ID This is emitted only for signatures of class 0 or 1 which @@ -156,7 +169,11 @@ more arguments in future versions. to indicate how trustworthy the signature is. No arguments yet. SIGEXPIRED - The signature key has expired. No arguments yet. + This is deprecated in favor of KEYEXPIRED. + + KEYEXPIRED + The key has expired. expire-timestamp is the expiration time + in seconds after the epoch. KEYREVOKED The used key has been revoked by its owner. No arguments yet. @@ -275,7 +292,6 @@ more arguments in future versions. 'P' = primary 'S' = subkey - SESSION_KEY : The session key used to decrypt the message. This message will only be emmited when the special option --show-session-key @@ -308,7 +324,7 @@ more arguments in future versions. Issued when no recipients are usable. ALREADY_SIGNED - Warning: This is eperimental and might be removed at any time. + Warning: This is experimental and might be removed at any time. Key generation @@ -363,7 +379,7 @@ The format of this file is as follows: may be placed anywhere. o Key generation takes place when either the end of the parameter file is reached, the next "Key-Type" parameter is encountered or at the - controlstatement "%commit" + control statement "%commit" o Control statements: %echo Print . @@ -417,6 +433,10 @@ The format of this file is as follows: may either be entered in ISO date format (2000-08-15) or as number of days, weeks, month or years. Without a letter days are assumed. + Preferences: + Set the cipher, hash, and compression preference values for + this key. This expects the same type of string as "setpref" + in the --edit menu. Here is an example: $ cat >foo < The default viewer is "xloadimage -fork -quiet -title 'KeyID 0x%k' stdin" @@ -372,9 +372,13 @@ Change the passphrase of the secret key. primary - Flag the current user id as the primary one, removes the primary user - id flag from all other user ids and sets the timestamp of all - affected self-signatures one second ahead. +Flag the current user id as the primary one, removes the primary user +id flag from all other user ids and sets the timestamp of all affected +self-signatures one second ahead. Note that setting a photo user ID +as primary makes it primary over other photo user IDs, and setting a +regular user ID as primary makes it primary over other regular user +IDs. + uid &ParmN; @@ -470,7 +474,7 @@ This is a shortcut version of the subcommand "nrsign" from --edit. ---default-check-level &ParmN; +--default-cert-check-level &ParmN; The default to use for the check level when signing a key. @@ -633,7 +637,7 @@ value can be changed at any time later. Do trust DB maintenance without user interaction. Form time to time the trust database must be updated so that expired keys and resulting -changes in the Web-of_trust can be tracked. GnuPG tries to figure +changes in the Web-of-Trust can be tracked. GnuPG tries to figure when this is required and then does it implicitly; this command can be used to force such a check. The processing is identically to that of --update-trustdb but it skips keys with a not yet defined "ownertrust". @@ -1391,12 +1395,17 @@ interaction, this performance penalty does not matter in most settings. ---no-auto-check-trustdb +--auto-check-trustdb If GnuPG feels that its information about the Web-of-Trust has to be updated, it automatically runs the --check-trustdb command -internally. As this is a time consuming process, this option allow to -disable the automatic invocation. +internally. This may be a time consuming process. + + + +--no-auto-check-trustdb + +Resets the --auto-check-trustdb option. @@ -1496,6 +1505,27 @@ This option implies `--rfc1991 --no-openpgp --disable-mdc Resets the --pgp2 option. + +--pgp6 + +Set up all options to be as PGP 6 compliant as possible. This +restricts you to the ciphers IDEA (if the IDEA plugin is installed), +3DES, and CAST5, the hashes MD5, SHA1 and RIPEMD160, and the +compression algorithms none and ZIP. This also disables making +signatures with signing subkeys as PGP 6 does not understand +signatures made by signing subkeys. + +This option implies `--disable-mdc --no-comment --escape-from +--force-v3-sigs --no-ask-sig-expire --digest-algo MD5 --compress-algo +1' + + + +--no-pgp6 + +Resets the --pgp6 option. + + --openpgp diff --git a/doc/samplekeys.asc b/doc/samplekeys.asc new file mode 100644 index 000000000..efbd89d1e --- /dev/null +++ b/doc/samplekeys.asc @@ -0,0 +1,116 @@ +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: GnuPG v1.0.6e-cvs (GNU/Linux) + +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 +=E5jL +-----END PGP PUBLIC KEY BLOCK-----