security-and-privacy/gnupg
security-and-privacy/gnupg
1
0
Fork 0
mirror of git://git.gnupg.org/gnupg.git synced 2024-12-31 11:41:32 +01:00
Code Activity

doc: Clarify forward-compatible expectations

Browse Source 
--
Encourage better parsers/interpreters of with-colons
and status-fd output.

Signed-off-by: Daniel Kahn Gillmor <dkg@fifthhorseman.net>
This commit is contained in:
Daniel Kahn Gillmor 2016-09-17 11:34:35 -04:00 committed by Werner Koch
parent 7305d27f36
commit 55675fa5a0
No known key found for this signature in database
GPG Key ID: E3FDFF218E45B72B
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/DETAILS
View File

@ -36,7 +36,9 @@ Note that new version of GnuPG or the use of certain options may add
new fields to the output. Parsers should not assume a limit on the new fields to the output. Parsers should not assume a limit on the
number of fields per line. Some fields are not yet used or only used number of fields per line. Some fields are not yet used or only used
with certain record types; parsers should ignore fields they are not with certain record types; parsers should ignore fields they are not
aware of. aware of. New versions of GnuPG or the use of certain options may add
new types of records as well. Parsers should ignore any record whose
type they do not recognize for forward-compatibility.
The double =--with-fingerprint= prints the fingerprint for the subkeys The double =--with-fingerprint= prints the fingerprint for the subkeys
too. Old versions of gpg used a slightly different format and required too. Old versions of gpg used a slightly different format and required
@ -358,8 +360,10 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB:
Every line is prefixed with "[GNUPG:] ", followed by a keyword with Every line is prefixed with "[GNUPG:] ", followed by a keyword with
the type of the status line and some arguments depending on the type the type of the status line and some arguments depending on the type
(maybe none); an application should always be prepared to see new (maybe none); an application should always be willing to ignore
keyworkds or more arguments in future versions. unknown keywords that may be emitted by future versions of GnuPG.
Also, new versions of GnuPG may add arguments to existing keywords.
Any additional arguments should be ignored for forward-compatibility.
** General status codes ** General status codes
*** NEWSIG [<signers_uid>] *** NEWSIG [<signers_uid>]