From 4f061d37101002aea41e6503967aa8bd474c7df3 Mon Sep 17 00:00:00 2001 From: David Shaw Date: Fri, 18 Jun 2004 19:58:20 +0000 Subject: [PATCH] * DETAILS: Document PLAINTEXT and PLAINTEXT_LENGTH. * gpg.sgml: Clarify include-revoked a bit to note that keyservers might not be accurate. --- doc/ChangeLog | 7 +++++++ doc/DETAILS | 14 ++++++++++++++ doc/gpg.sgml | 9 ++++++--- 3 files changed, 27 insertions(+), 3 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index afdfb31c2..51cdef5a2 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2004-06-18 David Shaw + + * DETAILS: Document PLAINTEXT and PLAINTEXT_LENGTH. + + * gpg.sgml: Clarify include-revoked a bit to note that keyservers + might not be accurate. + 2004-06-01 David Shaw * gpg.sgml: Note that --charset is --display-charset. Some diff --git a/doc/DETAILS b/doc/DETAILS index 81da915d4..990b5eadc 100644 --- a/doc/DETAILS +++ b/doc/DETAILS @@ -445,6 +445,20 @@ more arguments in future versions. 0x02 = this attribute packet is revoked 0x04 = this attribute packet is expired + PLAINTEXT + This indicates the format of the plaintext that is about to be + written. The format is a 1 byte hex code that shows the + format of the plaintext: 62 ('b') is binary data, 74 ('t') is + text data with no character set specified, and 75 ('u') is + text data encoded in the UTF-8 character set. The timestamp + is in seconds since the epoch. + + PLAINTEXT_LENGTH + This indicates the length of the plaintext that is about to be + written. Note that if the plaintext packet has partial length + encoding it is not possible to know the length ahead of time. + In that case, this status tag does not appear. + Format of the "--attribute-fd" output ===================================== diff --git a/doc/gpg.sgml b/doc/gpg.sgml index a534b1a09..d6cf02c59 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -1106,9 +1106,12 @@ keyserver types, some common options are: include-revoked When searching for a key with --search-keys, include keys that are -marked on the keyserver as revoked. Note that this option is always -set when using the NAI HKP keyserver, as this keyserver does not -differentiate between revoked and unrevoked keys. +marked on the keyserver as revoked. Note that not all keyservers +differentiate between revoked and unrevoked keys, and for such +keyservers this option is meaningless. Note also that most keyservers +do not have cryptographic verification of key revocations, and so +turning this option off may result in skipping keys that are +incorrectly marked as revoked. Defaults to on.