Fixed EOF detection for encrypted packets.
[gnupg.git] / doc / gnupg.texi
blob6f3f0b74e245b8e121dcc01fe999e503ffd5e120
1 \input texinfo                      @c -*-texinfo-*-
2 @c %**start of header
3 @setfilename gnupg.info
4 @include version.texi
5 @settitle Using the GNU Privacy Guard
7 @c A couple of macros with no effect on texinfo
8 @c but used by the yat2m processor. 
9 @macro manpage {a}
10 @end macro
11 @macro mansect {a}
12 @end macro
13 @macro manpause 
14 @end macro
15 @macro mancont
16 @end macro
18 @c Create a separate index for command line options.
19 @defcodeindex op
20 @c Merge the standard indexes into a single one.
21 @syncodeindex fn cp
22 @syncodeindex vr cp
23 @syncodeindex ky cp
24 @syncodeindex pg cp
25 @syncodeindex tp cp
26 @c %**end of header
27 @copying
28 This is the @cite{The GNU Privacy Guard Manual} (version
29 @value{VERSION}, @value{UPDATED-MONTH}).
31 @iftex
32 Published by the Free Software Foundation@*
33 51 Franklin St, Fifth Floor@*
34 Boston, MA 02110-1301 USA
35 @end iftex
37 Copyright @copyright{} 2002, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
39 @quotation
40 Permission is granted to copy, distribute and/or modify this document
41 under the terms of the GNU General Public License as published by the
42 Free Software Foundation; either version 3 of the License, or (at your
43 option) any later version. The text of the license can be found in the
44 section entitled ``Copying''.
45 @end quotation
46 @end copying
49 @dircategory GNU Utilities
50 @direntry
51 * gpg2: (gnupg).           OpenPGP encryption and signing tool.
52 * gpgsm: (gnupg).          S/MIME encryption and signing tool.
53 @end direntry
57 @c Printing stuff taken from gcc.
59 @macro gnupgtabopt{body}
60 @code{\body\}
61 @end macro
62 @macro gnupgoptlist{body}
63 @smallexample
64 \body\
65 @end smallexample
66 @end macro
67 @c Makeinfo handles the above macro OK, TeX needs manual line breaks;
68 @c they get lost at some point in handling the macro.  But if @macro is
69 @c used here rather than @alias, it produces double line breaks.
70 @iftex
71 @alias gol = *
72 @end iftex
73 @ifnottex
74 @macro gol
75 @end macro
76 @end ifnottex
80 @c Titlepage
82 @setchapternewpage odd
83 @titlepage
84 @title Using the GNU Privacy Guard
85 @subtitle Version @value{VERSION}
86 @subtitle @value{UPDATED-MONTH}
88 @sp 3
90 @image{gnupg-logo,16cm,,The GnuPG Logo}
92 @sp 3
94 @author Werner Koch (@email{wk@@gnupg.org})
96 @page
97 @vskip 0pt plus 1filll
98 @insertcopying
99 @end titlepage
101 @ifnothtml
102 @summarycontents
103 @contents
104 @page
105 @end ifnothtml
107 @ifhtml
108 @center @image{gnupg-logo,6cm,,The GnuPG Logo}
109 @end ifhtml
111 @ifnottex
112 @node Top
113 @top 
114 @insertcopying
116 This manual documents how to use the GNU Privacy Guard system as well as
117 the administration and the architecture.
118 @end ifnottex
120 @menu
121 * Installation::        A short installation guide.
123 * Invoking GPG-AGENT::  How to launch the secret key daemon.
124 * Invoking GPG::        Using the OpenPGP protocol.
125 * Invoking GPGSM::      Using the S/MIME protocol.
126 * Invoking SCDAEMON::   How to handle Smartcards.
127 * Specify a User ID::   How to Specify a User Id.
129 * Helper Tools::        Description of small helper tools
131 * Howtos::              How to do certain things.
132 * System Notes::        Notes pertaining to certain OSes.
133 * Debugging::           How to solve problems
135 * Copying::             GNU General Public License says
136                         how you can copy and share GnuPG
137 * Contributors::        People who have contributed to GnuPG.
139 * Glossary::            Short description of terms used.
140 * Option Index::        Index to command line options.
141 * Index::               Index of concepts and symbol names.
142 @end menu
145 @ifhtml
146 @page
147 @summarycontents
148 @contents
149 @end ifhtml
152 @include instguide.texi
154 @include gpg-agent.texi
155 @include gpg.texi
156 @include gpgsm.texi
157 @include scdaemon.texi
159 @node Specify a User ID
160 @chapter How to Specify a User Id
161 @anchor{how-to-specify-a-user-id}
162 @include specify-user-id.texi
165 @include tools.texi
167 @include howtos.texi
169 @include sysnotes.texi
171 @include debugging.texi
173 @include gpl.texi
175 @include contrib.texi
177 @c ---------------------------------------------------------------------
178 @c Indexes
179 @c ---------------------------------------------------------------------
181 @include glossary.texi
183 @node Option Index
184 @unnumbered Option Index
186 @printindex op
188 @node Index
189 @unnumbered Index
191 @printindex cp
193 @c ---------------------------------------------------------------------
194 @c Epilogue
195 @c ---------------------------------------------------------------------
197 @bye