Add usage instructions to README

diff --git a/README b/README
index a024a2abe721313366113a7dc1a4403673d8fd91..446dbec3a86bfc17263c96bcbc6b6238f2e9fffc 100644 (file)
--- a/README
+++ b/README
@@ -14,12 +14,34 @@ To install this module type the following:
    make test
    make install
 
    make test
    make install
 

+USAGE
+
+Typical usage of EdwardNG is as follows:
+
+1. Create a new GPG homedir
+   $ mkdir /srv/edwardng
+2. Create a suitable gpg.conf
+   $ cat > /srv/edwardng/gpg.conf <<END
+   no-greeting
+   keyserver hkp://keys.gnupg.net
+   auto-key-locate keyserver
+   keyserver-options auto-key-retrieve
+   END
+3. Generate a new key
+   $ gpg --homedir /srv/edwardng --gen-key
+4. Add an entry to /etc/aliases
+   $ echo 'edwardng: |/path/to/edwardng --keydir=/srv/edwardng --key=KEYID --from=edwardng@hostname.tld' >> /etc/aliases
+   For multiple language support, add multiple entries to /etc/aliases of the form:
+   $ echo 'edwardng-lang: |/path/to/edwardng --keydir=/srv/edwardng --key=KEYID --from=edwardng@hostname.tld --tmpl=lang' >>/etc/aliases
+

 DEPENDENCIES
 
 This module requires these other modules and libraries:
 
  * Email::Sender
  * File::Slurp
 DEPENDENCIES
 
 This module requires these other modules and libraries:
 
  * Email::Sender
  * File::Slurp

+ * File::Share
+ * File::ShareDir::Install

  * MIME-Tools
  * Mail::GnuPG
  * PerlX::Maybe
  * MIME-Tools
  * Mail::GnuPG
  * PerlX::Maybe