[git] GnuPG - branch, STABLE-BRANCH-2-2, updated. gnupg-2.2.4-33-gc4d8efb

[by Werner Koch]

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, STABLE-BRANCH-2-2 has been updated
       via  c4d8efb8942fe1d5644c5b2cb8bc73a06ac500df (commit)
      from  685a5e1558b2252ac895637fb857f6f7bb85ea7b (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 c4d8efb8942fe1d5644c5b2cb8bc73a06ac500df
Author: Werner Koch <wk at gnupg.org>
Date:   Wed Feb 21 10:17:20 2018 +0100

    doc: Add extra hint on unattended use of gpg.
    
    --

diff --git a/doc/gpg.texi b/doc/gpg.texi
index 927d77d..ddebc69 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -3781,6 +3781,19 @@ If you are going to verify detached signatures, make sure that the
 program knows about it; either give both filenames on the command line
 or use @samp{-} to specify STDIN.
 
+For scripted or other unattended use of @command{gpg} make sure to use
+the machine-parseable interface and not the default interface which is
+intended for direct use by humans.  The machine-parseable interface
+provides a stable and well documented API independent of the locale or
+future changes of @command{gpg}.  To enable this interface use the
+options @option{--with-colons} and @option{--status-fd}.  For certain
+operations the option @option{--command-fd} may come handy too.  See
+this man page and the file @file{DETAILS} for the specification of the
+interface.  Note that the GnuPG ``info'' pages as well as the PDF
+version of the GnuPG manual features a chapter on unattended use of
+GnuPG.  As an alternative the library @command{GPGME} can be used as a
+high-level abstraction on top of that interface.
+
 @mansect interoperability
 @chapheading INTEROPERABILITY WITH OTHER OPENPGP PROGRAMS
 

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

Summary of changes:
 doc/gpg.texi | 13 +++++++++++++
 1 file changed, 13 insertions(+)


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