gpg: Also detect a plaintext packet before an encrypted packet.
[gnupg.git] / doc / gnupg.texi
index 4c30980..3364148 100644 (file)
@@ -1,33 +1,56 @@
 \input texinfo                      @c -*-texinfo-*-
 @c %**start of header
 @setfilename gnupg.info
-@include version.texi
+@include defs.inc
 @settitle Using the GNU Privacy Guard
+
+@c A couple of macros with no effect on texinfo
+@c but used by the yat2m processor.
+@macro manpage {a}
+@end macro
+@macro mansect {a}
+@end macro
+@macro manpause
+@end macro
+@macro mancont
+@end macro
+
+
+
 @c Create a separate index for command line options.
 @defcodeindex op
-@c Merge the standard indexes into a single one.
+@c Create an index vor environment variables and files.
+@defcodeindex ef
+
+@c Merge the function index into the concept index.
 @syncodeindex fn cp
+@c Merge the variable index into the concept index.
 @syncodeindex vr cp
+@c Merge the keystroke index into the concept index.
 @syncodeindex ky cp
+@c Merge the program index into the concept index.
 @syncodeindex pg cp
+@c Merge the data type index into the concept index.
 @syncodeindex tp cp
 @c %**end of header
 @copying
-This is the @cite{The GNU Privacy Guard Manual}
-(version @value{VERSION}, @value{UPDATED}).
+This is the @cite{The GNU Privacy Guard Manual} (version
+@value{VERSION}, @value{UPDATED-MONTH}).
 
 @iftex
-Published by the Free Software Foundation@*
-59 Temple Place - Suite 330@*
-Boston, MA 02111-1307 USA
+Published by The GnuPG Project@*
+@url{https://gnupg.org}@*
+(or @url{http://ic6au7wa3f6naxjq.onion})
 @end iftex
 
-Copyright @copyright{} 2002, 2004, 2005 Free Software Foundation, Inc.
+@copyright{} 2002, 2004, 2005, 2006, 2007, 2010 Free Software Foundation, Inc.@*
+@copyright{} 2013, 2014, 2015 Werner Koch.@*
+@copyright{} 2015, 2016, 2017 g10 Code GmbH.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU General Public License as published by the
-Free Software Foundation; either version 2 of the License, or (at your
+Free Software Foundation; either version 3 of the License, or (at your
 option) any later version. The text of the license can be found in the
 section entitled ``Copying''.
 @end quotation
@@ -36,8 +59,11 @@ section entitled ``Copying''.
 
 @dircategory GNU Utilities
 @direntry
-* gpg: (gnupg).            OpenPGP encryption and signing tool.
+* gpg2: (gnupg).           OpenPGP encryption and signing tool.
 * gpgsm: (gnupg).          S/MIME encryption and signing tool.
+* gpg-agent: (gnupg).      The secret key daemon.
+* dirmngr: (gnupg).        X.509 CRL and OCSP server.
+* dirmngr-client: (gnupg). X.509 CRL and OCSP client.
 @end direntry
 
 
@@ -71,29 +97,34 @@ section entitled ``Copying''.
 @titlepage
 @title Using the GNU Privacy Guard
 @subtitle Version @value{VERSION}
-@subtitle @value{UPDATED}
+@subtitle @value{UPDATED-MONTH}
 
-@sp 6
+@sp 3
 
-@image{gnupg-badge-openpgp,8cm,,The GnuPG Logo}
+@image{gnupg-logo,,,The GnuPG Logo}
 
-@sp 6
+@sp 3
 
-@author Werner Koch (@email{wk@@gnupg.org})
+@author The GnuPG Project (@url{https://gnupg.org})
 
 @page
 @vskip 0pt plus 1filll
 @insertcopying
 @end titlepage
 
-
+@ifnothtml
 @summarycontents
 @contents
 @page
+@end ifnothtml
+
+@ifhtml
+@center @image{gnupg-logo-tr,6cm,,The GnuPG Logo}
+@end ifhtml
 
 @ifnottex
 @node Top
-@top The GNU Privacy Guard
+@top
 @insertcopying
 
 This manual documents how to use the GNU Privacy Guard system as well as
@@ -101,37 +132,69 @@ the administration and the architecture.
 @end ifnottex
 
 @menu
+* Installation::        A short installation guide.
+
+* Invoking GPG-AGENT::  How to launch the secret key daemon.
+* Invoking DIRMNGR::    How to launch the CRL and OCSP daemon.
 * Invoking GPG::        Using the OpenPGP protocol.
 * Invoking GPGSM::      Using the S/MIME protocol.
-* Invoking GPG-AGENT::  How to launch the secret key daemon.
 * Invoking SCDAEMON::   How to handle Smartcards.
+* Specify a User ID::   How to Specify a User Id.
+* Trust Values::        How GnuPG displays trust values.
 
 * Helper Tools::        Description of small helper tools
+* Web Key Service::     Tools for the Web Key Service
 
+* Howtos::              How to do certain things.
 * System Notes::        Notes pertaining to certain OSes.
 * Debugging::           How to solve problems
-* Assuan::              Description of the Assuan protocol.
+
 * Copying::             GNU General Public License says
                         how you can copy and share GnuPG
 * Contributors::        People who have contributed to GnuPG.
 
-* Glossary::            Short descrition of used terms.
+* Glossary::            Short description of terms used.
 * Option Index::        Index to command line options.
+* Environment Index::   Index to environment variables and files.
 * Index::              Index of concepts and symbol names.
 @end menu
 
+
+@ifhtml
+@page
+@summarycontents
+@contents
+@end ifhtml
+
+
+@include instguide.texi
+
+@include gpg-agent.texi
+@include dirmngr.texi
 @include gpg.texi
 @include gpgsm.texi
-@include gpg-agent.texi
 @include scdaemon.texi
 
+@node Specify a User ID
+@chapter How to Specify a User Id
+@anchor{how-to-specify-a-user-id}
+@include specify-user-id.texi
+
+@node Trust Values
+@chapter Trust Values
+@anchor{trust-values}
+@cindex trust values
+@include trust-values.texi
+
 @include tools.texi
+@include wks.texi
+
+@include howtos.texi
 
 @include sysnotes.texi
 
 @include debugging.texi
 
-@include assuan.texi
 @include gpl.texi
 
 @include contrib.texi
@@ -147,6 +210,11 @@ the administration and the architecture.
 
 @printindex op
 
+@node Environment Index
+@unnumbered Environment Variable and File Index
+
+@printindex ef
+
 @node Index
 @unnumbered Index
 
@@ -156,6 +224,18 @@ the administration and the architecture.
 @c Epilogue
 @c ---------------------------------------------------------------------
 
+@c @node History
+@c @unnumbered History
+@c
+@c Here are the notices from the old dirmngr manual:
+@c
+@c @itemize
+@c @item Using DirMngr, 2002, Steffen Hansen, Klar"alvdalens Datakonsult AB.
+@c @item Using DirMngr, 2004, 2005, 2006, 2008 Werner Koch, g10 Code GmbH.
+@c @end itemize
+@c
+
+
 @bye