[git] GnuPG - branch, master, updated. gnupg-2.1.14-86-gd25db3c

by Werner Koch cvs at cvs.gnupg.org
Thu Aug 18 12:45:23 CEST 2016


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "The GNU Privacy Guard".

The branch, master has been updated
       via  d25db3c903e3b54ab04e87650ee5bfdb4844f310 (commit)
      from  d83ba4897bf217d1045c58d1b99e52bd31c58812 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit d25db3c903e3b54ab04e87650ee5bfdb4844f310
Author: Werner Koch <wk at gnupg.org>
Date:   Thu Aug 18 12:41:55 2016 +0200

    doc: Add comments on how to parse --list-colons output.
    
    --
    
    GnuPG-bug-id: 2437

diff --git a/doc/DETAILS b/doc/DETAILS
index 794026b..dc8ba1f 100644
--- a/doc/DETAILS
+++ b/doc/DETAILS
@@ -31,11 +31,18 @@ sub:r:1536:20:5CE086B5B5A18FF4:899817788:1025961788:::::esc:
 fpr:::::::::AB059359A3B81F410FCFF97F5CE086B5B5A18FF4:
 #+end_example
 
+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
+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
+aware of.
+
 The double =--with-fingerprint= prints the fingerprint for the subkeys
 too.  Old versions of gpg used a slightly different format and required
 the use of the option =--fixed-list-mode= to conform to the format
 described here.
 
+
 ** Description of the fields
 *** Field 1 - Type of record
 
@@ -337,8 +344,8 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB:
 
   Every line is prefixed with "[GNUPG:] ", followed by a keyword with
   the type of the status line and some arguments depending on the type
-  (maybe none); an application should always be prepared to see more
-  arguments in future versions.
+  (maybe none); an application should always be prepared to see new
+  keyworkds or more arguments in future versions.
 
 ** General status codes
 *** NEWSIG [<signers_uid>]
diff --git a/doc/gpg.texi b/doc/gpg.texi
index b9a3ddc..52a50f5 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -348,9 +348,10 @@ if the keyid format has been set to "none".
 
 @item --list-packets
 @opindex list-packets
-List only the sequence of packets. This is mainly useful for
+List only the sequence of packets.  This command is only useful for
 debugging.  When used with option @option{--verbose} the actual MPI
-values are dumped and not only their lengths.
+values are dumped and not only their lengths.  Note that the output of
+this command may change with new releases.
 
 
 @item --card-edit

-----------------------------------------------------------------------

Summary of changes:
 doc/DETAILS  | 11 +++++++++--
 doc/gpg.texi |  5 +++--
 2 files changed, 12 insertions(+), 4 deletions(-)


hooks/post-receive
-- 
The GNU Privacy Guard
http://git.gnupg.org




More information about the Gnupg-commits mailing list