* debugging.texi: New.
[gnupg.git] / doc / gnupg.texi
1 \input texinfo                      @c -*-texinfo-*-
2 @c %**start of header
3 @setfilename gnupg.info
4
5 @include version.texi
6
7 @macro copyrightnotice
8 Copyright @copyright{} 2002 Free Software Foundation, Inc.
9 @end macro
10 @macro permissionnotice
11 Permission is granted to copy, distribute and/or modify this document
12 under the terms of the GNU Free Documentation License, Version 1.1 or
13 any later version published by the Free Software Foundation; with the
14 Invariant Sections being ``GNU General Public License'', the Front-Cover
15 texts being (a) (see below), and with the Back-Cover Texts being (b)
16 (see below).  A copy of the license is included in the section entitled
17 ``GNU Free Documentation License''.
18
19 (a) The FSF's Front-Cover Text is:
20
21      A GNU Manual
22
23 (b) The FSF's Back-Cover Text is:
24
25      You have freedom to copy and modify this GNU Manual, like GNU
26      software.  Copies published by the Free Software Foundation raise
27      funds for GNU development.
28 @end macro
29
30
31 @settitle Using the GNU Privacy Guard
32
33 @c Create a separate index for command line options.
34 @defcodeindex op
35 @c Merge the standard indexes into a single one.
36 @syncodeindex fn cp
37 @syncodeindex vr cp
38 @syncodeindex ky cp
39 @syncodeindex pg cp
40 @syncodeindex tp cp
41
42 @c printing stuff taken from gcc.
43 @macro gnupgtabopt{body}
44 @code{\body\}
45 @end macro
46 @macro gnupgoptlist{body}
47 @smallexample
48 \body\
49 @end smallexample
50 @end macro
51 @c Makeinfo handles the above macro OK, TeX needs manual line breaks;
52 @c they get lost at some point in handling the macro.  But if @macro is
53 @c used here rather than @alias, it produces double line breaks.
54 @iftex
55 @alias gol = *
56 @end iftex
57 @ifnottex
58 @macro gol
59 @end macro
60 @end ifnottex
61
62
63 @c Change the font used for @def... commands, since the default
64 @c proportional one used is bad for names starting __.
65 @tex
66 \global\setfont\defbf\ttbshape{10}{\magstep1}
67 @end tex
68
69 @c %**end of header
70
71 @ifnottex
72 @dircategory GNU Utilities
73 @direntry
74 * gpg: (gnupg).            OpenPGP encryption and signing tool.
75 * gpgsm: (gnupg).          S/MIME encryption and signing tool.
76 @end direntry
77 This file documents the use and the internals of the GNU Privacy Guard.
78
79 This is Edition @value{EDITION}, last updated @value{UPDATED}, of
80 @cite{The `GNU Privacy Guard' Manual}, for Version @value{VERSION}.
81 @sp 1
82 Published by the Free Software Foundation@*
83 59 Temple Place - Suite 330@*
84 Boston, MA 02111-1307 USA
85 @sp 1
86 @copyrightnotice{}
87 @sp 1
88 @permissionnotice{}
89 @end ifnottex
90
91 @setchapternewpage odd
92
93 @titlepage
94 @title Using the GNU Privacy Guard
95 @subtitle Version @value{VERSION}
96 @subtitle @value{UPDATED}
97 @author Werner Koch @code{(wk@@gnupg.org)}
98
99 @page
100 @vskip 0pt plus 1filll
101 @copyrightnotice{}
102 @sp 2
103 @permissionnotice{}
104 @end titlepage
105 @summarycontents
106 @contents
107 @page
108
109
110 @node Top
111 @top Introduction
112 @cindex introduction
113
114 This manual documents how to use the GNU Privay Guard system as well as
115 the administration and the architecture.
116
117 @c * Gpg::             Using the OpenPGP protocol.
118 @menu
119 * Invoking GPGSM::      Using the S/MIME protocol.
120 * Invoking GPG-AGENT::  How to launch the secret key daemon.
121 * Invoking SCDAEMON::   How to handle Smartcards.
122
123 Developer information
124
125 * Assuan::              Description of the Assuan protocol.
126
127 Miscellaneous
128
129 * Debugging::           How to solve problems
130 * Copying::             GNU General Public License says
131                         how you can copy and share GnuPG
132 * GNU Free Documentation License:: How you can copy and share this manual.
133 * Contributors::        People who have contributed to GnuPG.
134
135 Indices
136
137 * Option Index::        Index to command line options.
138 * Index::               Index of concepts and symbol names.
139 @end menu
140
141 @include gpgsm.texi
142 @include gpg-agent.texi
143 @include scdaemon.texi
144
145 @include assuan.texi
146
147 @include debugging.texi
148
149 @include gpl.texi
150 @include fdl.texi
151
152 @include contrib.texi
153
154 @c ---------------------------------------------------------------------
155 @c Indexes
156 @c ---------------------------------------------------------------------
157
158 @node Option Index
159 @unnumbered Option Index
160
161 @printindex op
162
163 @node Index
164 @unnumbered Index
165
166 @printindex cp
167
168 @c ---------------------------------------------------------------------
169 @c Epilogue
170 @c ---------------------------------------------------------------------
171
172 @bye
173
174