GNUPG-1-9-BRANCH gnupg/doc (6 files)
cvs user wk
cvs at cvs.gnupg.org
Wed Dec 22 18:19:07 CET 2004
Date: Wednesday, December 22, 2004 @ 18:24:13
Author: wk
Path: /cvs/gnupg/gnupg/doc
Tag: GNUPG-1-9-BRANCH
Modified: ChangeLog assuan.texi contrib.texi glossary.texi gnupg.texi
tools.texi
* gnupg.texi: Reordered.
* contrib.texi: Updated.
---------------+
ChangeLog | 5 +++++
assuan.texi | 18 +++++++++++-------
contrib.texi | 54 ++++++++++++++++++------------------------------------
glossary.texi | 6 ++++++
gnupg.texi | 17 ++++++-----------
tools.texi | 22 ++++++++++++----------
6 files changed, 58 insertions(+), 64 deletions(-)
Index: gnupg/doc/ChangeLog
diff -u gnupg/doc/ChangeLog:1.39.2.21 gnupg/doc/ChangeLog:1.39.2.22
--- gnupg/doc/ChangeLog:1.39.2.21 Tue Dec 21 21:47:04 2004
+++ gnupg/doc/ChangeLog Wed Dec 22 18:24:13 2004
@@ -1,3 +1,8 @@
+2004-12-22 Werner Koch <wk at g10code.com>
+
+ * gnupg.texi: Reordered.
+ * contrib.texi: Updated.
+
2004-12-21 Werner Koch <wk at g10code.com>
* tools.texi (gpg-preset-passphrase): New section.
Index: gnupg/doc/assuan.texi
diff -u gnupg/doc/assuan.texi:1.1.2.2 gnupg/doc/assuan.texi:1.1.2.3
--- gnupg/doc/assuan.texi:1.1.2.2 Wed Feb 4 20:13:14 2004
+++ gnupg/doc/assuan.texi Wed Dec 22 18:24:13 2004
@@ -3,14 +3,15 @@
@c For copying conditions, see the file gnupg.texi.
@node Assuan
- at chapter Description of the Assuan protocol.
+ at appendix Description of the Assuan protocol.
+ at cindex Assuan, IPC
The architecture of the modular GnuPG system is based on a couple of
highly specialized modules which make up a network of client server
communication. A common framework for intermodule communication is
therefore needed and should be implemented in a library.
-Goals:
+ at appendixsubsec Goals
@itemize @bullet
@item Common framework for module communication
@@ -22,7 +23,7 @@
@end itemize
-Design criteria:
+ at appendixsubsec Design criteria
@itemize @bullet
@item Client Server with back channel
@@ -36,8 +37,10 @@
@item Subliminal channels are not an issue
@end itemize
-Implementation:
+ at appendixsubsec Implementation
+
+ at noindent
The implementation is line based with a maximum line size of 1000
octects. The default IPC mechanism are Unix Domain Sockets.
@@ -57,7 +60,7 @@
All textual messages are assumed to be in UTF-8 unless otherwise noted.
-Server responses:
+ at appendixsubsec Server responses
@table @code
@item OK [<arbitary debugging information>]
@@ -98,7 +101,7 @@
length limit is to allow for easier multiplexing of multiple channels).
-Client requests:
+ at appendixsubsec Client requests
The server waits for client requests after he sent an Okay or Error.
The client should not issue a request in other cases with the
@@ -171,7 +174,8 @@
@end table
-Error Codes:
+
+ at appendixsubsec Error Codes
Here we keep a list of error codes used in any Assuan based
protocol. The format is the string @code{ERR}, white space, the error
Index: gnupg/doc/contrib.texi
diff -u gnupg/doc/contrib.texi:1.1.2.3 gnupg/doc/contrib.texi:1.1.2.4
--- gnupg/doc/contrib.texi:1.1.2.3 Thu Sep 30 01:05:37 2004
+++ gnupg/doc/contrib.texi Wed Dec 22 18:24:13 2004
@@ -10,42 +10,7 @@
them the project would not have been nearly as successful as it has
been. Any omissions in this list are accidental. Feel free to contact
the maintainer if you have been left out or some of your contributions
-are not listed. Please keep this list in alphabetical order.
-
- at itemize @bullet
-
- at item
-Bernhard Herzog did extensive testing and tracked down a lot of bugs.
-
- at item
-Bernhard Reiter made sure that we met the specifications and the
-deadlines. He did extensive testing and came up with a lot of suggestions.
-
- at item
-Jan-Oliver Wagner made sure that we met the specifications and the
-deadlines. He did extensive testing and came up with a lot of suggestions.
-
- at item
-Karl-Heinz Zimmer had to struggle with all the bugs and misconceptions
-while working on Kmail integration.
-
- at item
-Marcus Brinkman cleaned up the Assuan code and fixed bugs all over the place.
-
- at item
-Steffen Hansen had a hard time to write the dirmngr due to
-underspecified interfaces.
-
- at item
-Thomas Koester did extensive testing and tracked down a lot of bugs.
-
- at item
-Werner Koch designed the system and wrote most of the original code.
-
- at end itemize
-
-We'd also like to thank these folks who have contributed a lot of time
-and energy working on GnuPG over the years:
+are not listed.
David Shaw, Matthew Skala, Michael Roth, Niklas Hernaeus, Nils
Ellmenreich, Rémi Guyomarch, Stefan Bellon, Timo Schulz and Werner
@@ -60,6 +25,23 @@
and maintains the GNU Privacy Handbook. David Scribner is the current
FAQ editor. Lorenzo Cappelletti maintains the web site.
+The new modularized architecture of gnupg 1.9 as well as the X.509/CMS
+part has been developed as part of the Ägypten project. Direct
+contributors to this project are: Bernhard Herzog, who did extensive
+testing and tracked down a lot of bugs. Bernhard Reiter, who made sure
+that we met the specifications and the deadlines. He did extensive
+testing and came up with a lot of suggestions. Jan-Oliver Wagner made
+sure that we met the specifications and the deadlines. He also did
+extensive testing and came up with a lot of suggestions. Karl-Heinz
+Zimmer and Marc Mutz had to struggle with all the bugs and
+misconceptions while working on KDE integration. Marcus Brinkman
+extended GPGME, cleaned up the Assuan code and fixed bugs all over the
+place. Moritz Schulte took over Libgcrypt maintenance and developed it
+into a stable an useful library. Steffen Hansen had a hard time to
+write the dirmngr due to underspecified interfaces. Thomas Koester did
+extensive testing and tracked down a lot of bugs. Werner Koch designed
+the system and wrote most of the code.
+
The following people helped greatly by suggesting improvements,
testing, fixing bugs, providing resources and doing other important
tasks: Adam Mitchell, Albert Chin, Alec Habig, Allan Clark, Anand
Index: gnupg/doc/glossary.texi
diff -u gnupg/doc/glossary.texi:1.1.2.1 gnupg/doc/glossary.texi:1.1.2.2
--- gnupg/doc/glossary.texi:1.1.2.1 Tue Jun 29 09:16:40 2004
+++ gnupg/doc/glossary.texi Wed Dec 22 18:24:13 2004
@@ -16,6 +16,12 @@
The @emph{Certificate Revocation List} is a list containing
certificates revoked by the issuer.
+ at item Keygrip
+ This term is used by GnuPG to describe a 20 byte hash value used
+to identify a certain key without referencing to a concrete protocol.
+It is used internally to access a private key. Usually it is shown and
+entered as a 40 character hexadecimal formatted string.
+
@item OCSP
The @emph{Online Certificate Status Protocol} is used as an
alternative to a @acronym{CRL}. It is described in @code{RFC 2560}.
Index: gnupg/doc/gnupg.texi
diff -u gnupg/doc/gnupg.texi:1.1.2.7 gnupg/doc/gnupg.texi:1.1.2.8
--- gnupg/doc/gnupg.texi:1.1.2.7 Tue Dec 21 20:05:15 2004
+++ gnupg/doc/gnupg.texi Wed Dec 22 18:24:13 2004
@@ -107,7 +107,7 @@
@top Introduction
@cindex introduction
-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.
@menu
@@ -116,21 +116,15 @@
* Invoking GPG-AGENT:: How to launch the secret key daemon.
* Invoking SCDAEMON:: How to handle Smartcards.
-Developer information
+* Helper Tools:: Description of small helper tools
-* Assuan:: Description of the Assuan protocol.
* System Notes:: Notes pertaining to certain OSes.
-
-Miscellaneous
-
-* Helper Tools:: Description of small helper tools
* 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.
-Indices
-
* Glossary:: Short descrition of used terms.
* Option Index:: Index to command line options.
* Index:: Index of concepts and symbol names.
@@ -141,12 +135,13 @@
@include gpg-agent.texi
@include scdaemon.texi
- at include assuan.texi
+ at include tools.texi
+
@include sysnotes.texi
- at include tools.texi
@include debugging.texi
+ at include assuan.texi
@include gpl.texi
@include contrib.texi
Index: gnupg/doc/tools.texi
diff -u gnupg/doc/tools.texi:1.1.2.6 gnupg/doc/tools.texi:1.1.2.7
--- gnupg/doc/tools.texi:1.1.2.6 Tue Dec 21 21:47:04 2004
+++ gnupg/doc/tools.texi Wed Dec 22 18:24:13 2004
@@ -601,10 +601,10 @@
@section Put a passphrase into the cache.
The @command{gpg-preset-passphrase} is a utility to seed the internal
-cache of a running @command{gpg-agent} with passphrases. This is mainly
-useful for unatteneded machines, where a pinentry may not be used and
-the passphrases for the to be used keys should be given at machine
-startup.
+cache of a running @command{gpg-agent} with passphrases. It is mainly
+useful for unattended machines, where the usual @command{pinentry} tool
+may not be used and the passphrases for the to be used keys are given at
+machine startup.
Passphrases set with this utility don't expire unless the
@option{--forget} option is used to explicitly clear them from the cache
@@ -630,28 +630,29 @@
@var{keygrip} is a 40 character string of hexadecimal characters
identifying the key for which the passphrase should be set or cleared.
-This @emph{keygrip} is listed along with the key when running the
-command: @code{gpgsm --dump-secret-keys}. One of the following commands
+This keygrip is listed along with the key when running the command:
+ at code{gpgsm --dump-secret-keys}. One of the following command options
must be given:
@table @gnupgtabopt
@item --preset
Preset a passphrase. This is what you usually will
-use. @command{gpg-preset-passphrase} will then read the passphrase form
+use. @command{gpg-preset-passphrase} will then read the passphrase from
@code{stdin}.
@item --forget
-Clear the passphrase for the given keygrip from the cache.
+Flush the passphrase for the given keygrip from the cache.
@end table
-The following options may be used:
+ at noindent
+The following additional options may be used:
@table @gnupgtabopt
@item -v
@itemx --verbose
@opindex verbose
-Outputs additional information while running.
+Output additional information while running.
@item -P @var{string}
@itemx --passphrase @var{string}
@@ -663,3 +664,4 @@
+
More information about the Gnupg-commits
mailing list