gpg: New option --known-notation.
[gnupg.git] / doc / gnupg.texi
1 \input texinfo                      @c -*-texinfo-*-
2 @c %**start of header
3 @setfilename gnupg.info
4 @include defs.inc
5 @settitle Using the GNU Privacy Guard
6
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
17
18
19
20 @c Create a separate index for command line options.
21 @defcodeindex op
22 @c Create an index vor environment variables and files.
23 @defcodeindex ef
24
25 @c Merge the function index into the concept index.
26 @syncodeindex fn cp
27 @c Merge the variable index into the concept index.
28 @syncodeindex vr cp
29 @c Merge the keystroke index into the concept index.
30 @syncodeindex ky cp
31 @c Merge the program index into the concept index.
32 @syncodeindex pg cp
33 @c Merge the data type index into the concept index.
34 @syncodeindex tp cp
35 @c %**end of header
36 @copying
37 This is the @cite{The GNU Privacy Guard Manual} (version
38 @value{VERSION}, @value{UPDATED-MONTH}).
39
40 @iftex
41 Published by The GnuPG Project@*
42 @url{https://gnupg.org}@*
43 (or @url{http://ic6au7wa3f6naxjq.onion})
44 @end iftex
45
46 @copyright{} 2002, 2004, 2005, 2006, 2007, 2010 Free Software Foundation, Inc.@*
47 @copyright{} 2013, 2014, 2015 Werner Koch.@*
48 @copyright{} 2015, 2016, 2017 g10 Code GmbH.
49
50 @quotation
51 Permission is granted to copy, distribute and/or modify this document
52 under the terms of the GNU General Public License as published by the
53 Free Software Foundation; either version 3 of the License, or (at your
54 option) any later version. The text of the license can be found in the
55 section entitled ``Copying''.
56 @end quotation
57 @end copying
58
59
60 @dircategory GNU Utilities
61 @direntry
62 * gpg2: (gnupg).           OpenPGP encryption and signing tool.
63 * gpgsm: (gnupg).          S/MIME encryption and signing tool.
64 * gpg-agent: (gnupg).      The secret key daemon.
65 * dirmngr: (gnupg).        X.509 CRL and OCSP server.
66 * dirmngr-client: (gnupg). X.509 CRL and OCSP client.
67 @end direntry
68
69
70 @c
71 @c Printing stuff taken from gcc.
72 @c
73 @macro gnupgtabopt{body}
74 @code{\body\}
75 @end macro
76 @macro gnupgoptlist{body}
77 @smallexample
78 \body\
79 @end smallexample
80 @end macro
81 @c Makeinfo handles the above macro OK, TeX needs manual line breaks;
82 @c they get lost at some point in handling the macro.  But if @macro is
83 @c used here rather than @alias, it produces double line breaks.
84 @iftex
85 @alias gol = *
86 @end iftex
87 @ifnottex
88 @macro gol
89 @end macro
90 @end ifnottex
91
92
93 @c
94 @c Titlepage
95 @c
96 @setchapternewpage odd
97 @titlepage
98 @title Using the GNU Privacy Guard
99 @subtitle Version @value{VERSION}
100 @subtitle @value{UPDATED-MONTH}
101
102 @sp 3
103
104 @image{gnupg-logo,,,The GnuPG Logo}
105
106 @sp 3
107
108 @author The GnuPG Project (@url{https://gnupg.org})
109
110 @page
111 @vskip 0pt plus 1filll
112 @insertcopying
113 @end titlepage
114
115 @ifnothtml
116 @summarycontents
117 @contents
118 @page
119 @end ifnothtml
120
121 @ifhtml
122 @center @image{gnupg-logo-tr,6cm,,The GnuPG Logo}
123 @end ifhtml
124
125 @ifnottex
126 @node Top
127 @top
128 @insertcopying
129
130 This manual documents how to use the GNU Privacy Guard system as well as
131 the administration and the architecture.
132 @end ifnottex
133
134 @menu
135 * Installation::        A short installation guide.
136
137 * Invoking GPG-AGENT::  How to launch the secret key daemon.
138 * Invoking DIRMNGR::    How to launch the CRL and OCSP daemon.
139 * Invoking GPG::        Using the OpenPGP protocol.
140 * Invoking GPGSM::      Using the S/MIME protocol.
141 * Invoking SCDAEMON::   How to handle Smartcards.
142 * Specify a User ID::   How to Specify a User Id.
143 * Trust Values::        How GnuPG displays trust values.
144
145 * Helper Tools::        Description of small helper tools
146 * Web Key Service::     Tools for the Web Key Service
147
148 * Howtos::              How to do certain things.
149 * System Notes::        Notes pertaining to certain OSes.
150 * Debugging::           How to solve problems
151
152 * Copying::             GNU General Public License says
153                         how you can copy and share GnuPG
154 * Contributors::        People who have contributed to GnuPG.
155
156 * Glossary::            Short description of terms used.
157 * Option Index::        Index to command line options.
158 * Environment Index::   Index to environment variables and files.
159 * Index::               Index of concepts and symbol names.
160 @end menu
161
162
163 @ifhtml
164 @page
165 @summarycontents
166 @contents
167 @end ifhtml
168
169
170 @include instguide.texi
171
172 @include gpg-agent.texi
173 @include dirmngr.texi
174 @include gpg.texi
175 @include gpgsm.texi
176 @include scdaemon.texi
177
178 @node Specify a User ID
179 @chapter How to Specify a User Id
180 @anchor{how-to-specify-a-user-id}
181 @include specify-user-id.texi
182
183 @node Trust Values
184 @chapter Trust Values
185 @anchor{trust-values}
186 @cindex trust values
187 @include trust-values.texi
188
189 @include tools.texi
190 @include wks.texi
191
192 @include howtos.texi
193
194 @include sysnotes.texi
195
196 @include debugging.texi
197
198 @include gpl.texi
199
200 @include contrib.texi
201
202 @c ---------------------------------------------------------------------
203 @c Indexes
204 @c ---------------------------------------------------------------------
205
206 @include glossary.texi
207
208 @node Option Index
209 @unnumbered Option Index
210
211 @printindex op
212
213 @node Environment Index
214 @unnumbered Environment Variable and File Index
215
216 @printindex ef
217
218 @node Index
219 @unnumbered Index
220
221 @printindex cp
222
223 @c ---------------------------------------------------------------------
224 @c Epilogue
225 @c ---------------------------------------------------------------------
226
227 @c @node History
228 @c @unnumbered History
229 @c
230 @c Here are the notices from the old dirmngr manual:
231 @c
232 @c @itemize
233 @c @item Using DirMngr, 2002, Steffen Hansen, Klar"alvdalens Datakonsult AB.
234 @c @item Using DirMngr, 2004, 2005, 2006, 2008 Werner Koch, g10 Code GmbH.
235 @c @end itemize
236 @c
237
238
239 @bye
240
241