X-Git-Url: https://git.sthu.org/?a=blobdiff_plain;f=caff%2FREADME;h=e0333f71bd95c5a026eb35c7b8c820f6b30c7c76;hb=5aa8ef28a85d448e9f866a6dad021047a908c941;hp=ef02f8dfbe42782d076298b4cf41271f2fb3865f;hpb=d37ec57f181e5b84b8a45c43788d43f963ddbbd8;p=pgp-tools.git

diff --git a/caff/README b/caff/README
index ef02f8d..e0333f7 100644
--- a/caff/README
+++ b/caff/README
@@ -1,13 +1,26 @@
 caff  --  CA - fire and forget
+==============================
 
 caff is a script that helps you in keysigning.  It takes a list of
 keyids on the command line, fetches them from a keyserver and calls
 GnuPG so that you can sign it.  It then mails each key to all its
 email addresses - only including the one UID that we send to in each
-mail.
+mail, pruned from all but self sigs and sigs done by you.  The mailed
+key is encrypted with itself as a means to verify that key belongs to
+the recipient.
 
+Since we do not upload the new signatures, or import them into our
+main keyring, the signature only gets public if:
+ - the email address is valid, and
+ - the person reading the email can decrypt the mail (if it was sent
+   encrypted).
+Therefore we achieve the same level of security as common Challenge
+Response systems like CABot, without all the extra hassle of those
+systems.
+
+FEATURES
+--------
 
-Features:
  * Easy to setup.
  * Attaches only the very UID that we send to in the mail.
  * Prunes the key from all signatures that are not self sigs and
@@ -17,26 +30,16 @@ Features:
  * Creates proper PGP MIME messages.
  * Uses separate GNUPGHOME for all its operations.
 
-Caveats:
- * Requires a gpg patch for now, until 2 bugs are fixed:
-     http://bugs.debian.org/252917    gnupg: --with-colons and --edit delsigs
-     http://bugs.debian.org/254072    gpg should flush stdout before prompting in --edit
-
-Discussion:
-
-Since we do not upload the new signatures, or import them into our
-main keyring, the signature only gets public if:
- - the email address is valid
- - the person reading the email can decrypt the mail (if it was sent
-   encrypted).
-
-Therefore we achieve the same level of security as common Challenge
-Repsonse systems like CABot, without all the extra hassle of those
-systems.
+DEPENDENCIES
+------------
 
+ gnupg (>= 1.3.92), perl, libgnupg-interface-perl,
+ libtext-template-perl, libmime-perl, libmailtools-perl (>= 1.62)
 
+INSTALLATION
+------------
 
-Dependencies: gnupg (>= 1.2), perl, libgnupg-interface-perl, libmime-perl, libmailtools-perl (>= 1.62), mailx
+After creating a ~/.caffrc from the template, caff almost works out of the box.
 
 -- 
 Peter