diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 14 | ||||
| -rw-r--r-- | doc/HACKING | 59 | ||||
| -rw-r--r-- | doc/Makefile.am | 39 | ||||
| -rw-r--r-- | doc/gpg.sgml | 10 |
4 files changed, 77 insertions, 45 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index b50c01fe7..558423932 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,17 @@ +2001-04-17 Werner Koch <[email protected]> + + * Makefile.am (%.texi): Add rules to create .texi from .sgml. + However we can't automate this because automake does not like + .texi files as BUILT_SOURCES. + (%.dvi,%.ps): Removed these rules, because they are not needed + and get in the way of automake's dvi target + + * HACKING: Changed CVS description. + +2001-04-06 Werner Koch <[email protected]> + + * gpg.sgml: Small typo fixes by Florian Weimer. + 2001-03-27 Werner Koch <[email protected]> * gpg.sgml: Add --no-sig-cache and --no-sig-create-check. diff --git a/doc/HACKING b/doc/HACKING index 70bfe65dd..811179e53 100644 --- a/doc/HACKING +++ b/doc/HACKING @@ -10,12 +10,13 @@ CVS Access ========== Anonymous read-only CVS access is available: - cvs -z6 -d :pserver:[email protected]:/home/koch/cvs login + cvs -z3 -d :pserver:[email protected]:/cvs/gnupg login -use the password "anonymous". To check out the the complete +use the password "anoncvs". To check out the the complete archive use: - cvs -z6 -d :pserver:[email protected]:/home/koch/cvs checkout gnupg + cvs -z3 -d :pserver:[email protected]:/cvs/gnupg \ + checkout -R STABLE-BRANCH-1-0 gnupg This service is provided to help you in hunting bugs and not to deliver stable snapshots; it may happen that it even does not compile, so please @@ -117,46 +118,48 @@ Detailed Roadmap g10/g10.c Main module with option parsing and all the stuff you have to do on startup. Also has the exout handler and some helper functions. -g10/sign.c +g10/sign.c Create signature and optionally encrypt g10/parse-packet.c g10/build-packet.c g10/free-packet.c Parsing and creating of OpenPGP message packets. -g10/getkey.c -g10/pkclist.c -g10/skclist.c -g10/ringedit.c +g10/getkey.c Key selection code +g10/pkclist.c Build a list of public keys +g10/skclist.c Build a list of secret keys +g10/ringedit.c Keyring I/O g10/keydb.h g10/keyid.c Helper functions to get the keyid, fingerprint etc. -g10/trustdb.c +g10/trustdb.c g10/trustdb.h g10/tdbdump.c - -g10/compress.c -g10/filter.h -g10/delkey.c -g10/kbnode.c -g10/main.h -g10/mainproc.c -g10/armor.c -g10/mdfilter.c -g10/textfilter.c -g10/cipher.c -g10/misc.c -g10/options.h -g10/openfile.c -g10/tdbio.c + Management of the trustdb.gpg + +g10/compress.c Filter to handle compression +g10/filter.h Declarations for all filter functions +g10/delkey.c Delete a key +g10/kbnode.c Helper for the KBNODE linked list +g10/main.h Prototypes and some constants +g10/mainproc.c Message processing +g10/armor.c Ascii armor filter +g10/mdfilter.c Filter to calculate hashs +g10/textfilter.c Filter to handle CR/LF and trailing white space +g10/cipher.c En-/Decryption filter +g10/misc.c Utlity functions +g10/options.h Structure with all the command line options + and related constants +g10/openfile.c Create/Open Files +g10/tdbio.c I/O handling for the trustdb.gpg g10/tdbio.h -g10/hkp.h +g10/hkp.h Keyserver access g10/hkp.c -g10/packet.h -g10/passphrase.c -g10/pubkey-enc.c +g10/packet.h Defintion of OpenPGP structures. +g10/passphrase.c Passphrase handling code +g10/pubkey-enc.c g10/seckey-cert.c g10/seskey.c g10/import.c diff --git a/doc/Makefile.am b/doc/Makefile.am index cd92d0e0c..e7ceb48f1 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -18,18 +18,43 @@ ## Process this file with automake to create Makefile.in +AUTOMAKE_OPTIONS = no-texinfo.tex + EXTRA_DIST = DETAILS gpg.sgml gpg.1 gpgv.sgml gpgv.1 faq.raw FAQ faq.html \ HACKING OpenPGP README.W32 man_MANS = gpg.1 gpgv.1 +info_TEXINFOS = gpg.texi gpgv.texi + +# Need this to avoid building of dvis with automake 1.4 +DVIS = + pkgdata_DATA = FAQ faq.html -BUILT_SOURCES = FAQ faq.html +BUILT_SOURCES = FAQ faq.html +# we can't add gpg.texi gpgv.texi here because automake does not like them to +# be built files. -CLEANFILES = faq.raw.xref +CLEANFILES = faq.raw.xref gpg.xml gpgv.xml +%.texi : %.xml +if HAVE_DOCBOOK_TO_TEXI + docbook2texi $< | sed 's,--,---,' >$@ +else + : Warning: missing docbook to texinfo tools, cannot make $@ + touch $@ +endif + +%.xml : %.sgml +if HAVE_DOCBOOK_TO_TEXI + sgml2xml -x lower $< >$@ +else + : Warning: missing docbook to texinfo tools, cannot make $@ + touch $@ +endif + %.1 : %.sgml if HAVE_DOCBOOK_TO_MAN @@ -47,16 +72,6 @@ FAQ : faq.raw faq.html : faq.raw $(FAQPROG) -h -f $< $@ 2>&1 || $(FAQPROG) -h -f $< $@ -%.dvi: %.sgml - db2dvi $< - -%.ps: %.dvi - dvips -o $@ $< - -%/%.html: %.sgml - -db2html $< - - dist-hook: @if test `wc -c < gpg.1` -lt 200; then \ echo 'ERROR: dummy man page'; false; fi diff --git a/doc/gpg.sgml b/doc/gpg.sgml index abadb1382..150b35ba4 100644 --- a/doc/gpg.sgml +++ b/doc/gpg.sgml @@ -1108,9 +1108,9 @@ will still get disabled. <varlistentry> <term>--no-sig-cache</term> <listitem><para> -Does not not cache the verification status of key signatures. -Caching gives a much better performance in key listings, however if -you suspect that your public keyring is not saved against write +Do not cache the verification status of key signatures. +Caching gives a much better performance in key listings. However, if +you suspect that your public keyring is not save against write modifications, you can use this option to disable the caching. It probably does not make sense to disable it because all kind of damage can be done if someone else has write access to your public keyring. @@ -1122,9 +1122,9 @@ can be done if someone else has write access to your public keyring. GnuPG normally verifies each signature right after creation to protect against bugs and hardware malfunctions which could leak out bits from the secret key. This extra verification needs some time (about 115% -fro DSA keys), and so this option can be used to disable it. +for DSA keys), and so this option can be used to disable it. However, due to the fact that the signature creation needs manual -interaction, this performance penalty does not matter in most setting. +interaction, this performance penalty does not matter in most settings. </para></listitem></varlistentry> <varlistentry> |