more documentation for end users (and more FIXMEs), including README.admin in the...

[monkeysphere.git] / doc / README

diff --git a/doc/README b/doc/README
index 7aa2850656263883b35508156b025f8d2d9366d6..5e6de8e62dbe11487429fb949bf3c2c0bc3bb111 100644 (file)
--- a/doc/README
+++ b/doc/README
@@ -29,6 +29,25 @@ Using monkeysphere-ssh-proxycommand(1)
 FIXME: make a suggestion about how to integrate this in daily use.
 
 
+Setting up an OpenPGP authentication key
+----------------------------------------
+
+First things first: you'll need to create a new subkey for your
+current key, if you don't already have one.  If your OpenPGP key is
+keyid $GPGID, you can set up such a subkey relatively easily with:
+
+$ monkeysphere gen-subkey $GPGID
+
+Using your OpenPGP authentication key for SSH
+---------------------------------------------
+
+FIXME: Sending the key to the ssh-agent?
+
+FIXME: using the key with a single session?
+
+NOTE: the current version of openpgp2ssh does *not* deal well with
+encrypted keys (as of 2008-07-26)
+
 Miscellaneous
 -------------