Made arg_parse more readable.
[gnupg.git] / doc / gnupg.texi
index 58c995b..6f3f0b7 100644 (file)
@@ -1,34 +1,19 @@
 \input texinfo                      @c -*-texinfo-*-
 @c %**start of header
 @setfilename gnupg.info
-
 @include version.texi
+@settitle Using the GNU Privacy Guard
 
-@macro copyrightnotice
-Copyright @copyright{} 2002 Free Software Foundation, Inc.
+@c A couple of macros with no effect on texinfo
+@c but used by the yat2m processor. 
+@macro manpage {a}
 @end macro
-@macro permissionnotice
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``GNU General Public License'', the Front-Cover
-texts being (a) (see below), and with the Back-Cover Texts being (b)
-(see below).  A copy of the license is included in the section entitled
-``GNU Free Documentation License''.
-
-(a) The FSF's Front-Cover Text is:
-
-     A GNU Manual
-
-(b) The FSF's Back-Cover Text is:
-
-     You have freedom to copy and modify this GNU Manual, like GNU
-     software.  Copies published by the Free Software Foundation raise
-     funds for GNU development.
+@macro mansect {a}
+@end macro
+@macro manpause 
+@end macro
+@macro mancont
 @end macro
-
-
-@settitle Using the GNU Privacy Guard
 
 @c Create a separate index for command line options.
 @defcodeindex op
@@ -38,8 +23,39 @@ texts being (a) (see below), and with the Back-Cover Texts being (b)
 @syncodeindex ky cp
 @syncodeindex pg cp
 @syncodeindex tp cp
+@c %**end of header
+@copying
+This is the @cite{The GNU Privacy Guard Manual} (version
+@value{VERSION}, @value{UPDATED-MONTH}).
+
+@iftex
+Published by the Free Software Foundation@*
+51 Franklin St, Fifth Floor@*
+Boston, MA 02110-1301 USA
+@end iftex
 
-@c printing stuff taken from gcc.
+Copyright @copyright{} 2002, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
+
+@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 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
+@end copying
+
+
+@dircategory GNU Utilities
+@direntry
+* gpg2: (gnupg).           OpenPGP encryption and signing tool.
+* gpgsm: (gnupg).          S/MIME encryption and signing tool.
+@end direntry
+
+
+@c
+@c Printing stuff taken from gcc.
+@c
 @macro gnupgtabopt{body}
 @code{\body\}
 @end macro
@@ -60,94 +76,101 @@ texts being (a) (see below), and with the Back-Cover Texts being (b)
 @end ifnottex
 
 
-@c Change the font used for @def... commands, since the default
-@c proportional one used is bad for names starting __.
-@tex
-\global\setfont\defbf\ttbshape{10}{\magstep1}
-@end tex
-
-@c %**end of header
-
-@ifnottex
-@dircategory GNU Utilities
-@direntry
-* gpg: (gnupg).            OpenPGP encryption and signing tool.
-* gpgsm: (gnupg).          S/MIME encryption and signing tool.
-@end direntry
-This file documents the use and the internals of the GNU Privacy Guard.
-
-This is Edition @value{EDITION}, last updated @value{UPDATED}, of
-@cite{The `GNU Privacy Guard' Manual}, for Version @value{VERSION}.
-@sp 1
-Published by the Free Software Foundation@*
-59 Temple Place - Suite 330@*
-Boston, MA 02111-1307 USA
-@sp 1
-@copyrightnotice{}
-@sp 1
-@permissionnotice{}
-@end ifnottex
-
+@c
+@c Titlepage
+@c
 @setchapternewpage odd
-
 @titlepage
 @title Using the GNU Privacy Guard
 @subtitle Version @value{VERSION}
-@subtitle @value{UPDATED}
-@author Werner Koch @code{(wk@@gnupg.org)}
+@subtitle @value{UPDATED-MONTH}
+
+@sp 3
+
+@image{gnupg-logo,16cm,,The GnuPG Logo}
+
+@sp 3
+
+@author Werner Koch (@email{wk@@gnupg.org})
 
 @page
 @vskip 0pt plus 1filll
-@copyrightnotice{}
-@sp 2
-@permissionnotice{}
+@insertcopying
 @end titlepage
+
+@ifnothtml
 @summarycontents
 @contents
 @page
+@end ifnothtml
 
+@ifhtml
+@center @image{gnupg-logo,6cm,,The GnuPG Logo}
+@end ifhtml
 
+@ifnottex
 @node Top
-@top Introduction
-@cindex introduction
+@top 
+@insertcopying
 
-This manual documents how to use the GNU Privay Guard system as well as
+This manual documents how to use the GNU Privacy Guard system as well as
 the administration and the architecture.
+@end ifnottex
 
-@c * Gpg::             Using the OpenPGP protocol.
 @menu
-* Invoking GPGSM::      Using the S/MIME protocol.
+* Installation::        A short installation guide.
+
 * Invoking GPG-AGENT::  How to launch the secret key daemon.
+* Invoking GPG::        Using the OpenPGP protocol.
+* Invoking GPGSM::      Using the S/MIME protocol.
 * Invoking SCDAEMON::   How to handle Smartcards.
+* Specify a User ID::   How to Specify a User Id.
 
-Developer information
-
-* Assuan::              Description of the Assuan protocol.
-
-Miscellaneous
+* Helper Tools::        Description of small helper tools
 
+* Howtos::              How to do certain things.
+* System Notes::        Notes pertaining to certain OSes.
 * Debugging::           How to solve problems
+
 * Copying::             GNU General Public License says
                         how you can copy and share GnuPG
-* GNU Free Documentation License:: How you can copy and share this manual.
 * Contributors::        People who have contributed to GnuPG.
 
-Indices
-
+* Glossary::            Short description of terms used.
 * Option Index::        Index to command line options.
 * Index::              Index of concepts and symbol names.
 @end menu
 
-@include gpgsm.texi
+
+@ifhtml
+@page
+@summarycontents
+@contents
+@end ifhtml
+
+
+@include instguide.texi
+
 @include gpg-agent.texi
+@include gpg.texi
+@include gpgsm.texi
 @include scdaemon.texi
 
-@include assuan.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
+
+
+@include tools.texi
+
+@include howtos.texi
+
+@include sysnotes.texi
 
 @include debugging.texi
 
 @include gpl.texi
-@include fdl.texi
 
 @include contrib.texi
 
@@ -155,6 +178,8 @@ Indices
 @c Indexes
 @c ---------------------------------------------------------------------
 
+@include glossary.texi
+
 @node Option Index
 @unnumbered Option Index