From 53de49bf80e1ffffd681f78581271a03dfc6b2dc Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Sun, 22 Dec 2013 11:53:56 -0200
Subject: Doc update

---
 index.mdwn | 51 +++++++++++++++++++++++++++++++++------------------
 1 file changed, 33 insertions(+), 18 deletions(-)

diff --git a/index.mdwn b/index.mdwn
index 2c5388b..caef784 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -125,16 +125,21 @@ Note for Debian users: you'll need the "expect" package to run firma.
 
 Firma installation is quite simple:
 
-1. Create a folder to store lists; by default firma use `/var/lib/firma/lists`
-   but you can use anything, just edit firma and change `FIRMA_LIST_PATH`
-   variable.
+### List folder
 
-2. Copy firma script to whatever you like, e.g. `/usr/local/bin` and check that
-   it has no write permission
+Create a folder to store lists; by default firma use `/var/lib/firma/lists` but
+you can use anything, just edit firma and change `FIRMA_LIST_PATH` variable.
 
-3. Create a list-wide config file (default is `/var/lib/firma/firma.conf`) with
-   the common definitions for all lists. You might just copy the sample
-   firma.conf.dist and edit according to your needs.
+### Script installation
+
+Copy firma script to whatever you like, e.g. `/usr/local/bin` and check that it
+has no write permission
+
+### Global config
+
+Create a system-wide config file (default is `/var/lib/firma/firma.conf`) with
+the common definitions for all lists. You might just copy the sample
+firma.conf.dist and edit according to your needs.
 
 All config variables can be overwritten at each list's own config file;
 firma.conf should be chmoded as `600`, chowned `nobody.nobody` or whatever user
@@ -145,7 +150,9 @@ For a list of all config parameters, type
 
        firma --help config
 
-4. Then create your lists with the command
+### List creation
+
+Then create your lists with the command
 
        firma -c your-list
 
@@ -185,12 +192,14 @@ After that you can add some optional parameters on this list config file:
                           this doesn't affect the way email administration works,
                           when signature is mandatory
 
-     For a list of all config parameters, type
+For a list of all config parameters, type
 
        firma --help config
 
-6. Create an alias to the list at your MTA; on sendmail or postfix,
-   add this to your aliases file:
+### MTA configuration
+
+Create an alias to the list at your MTA; on sendmail or postfix, add this to
+your aliases file:
 
        your-list: "| /usr/local/bin/firma -p your-list"
        your-list-request: "| /usr/local/bin/firma -e your-list"
@@ -202,8 +211,10 @@ and then run the command
 alternatively, you can use a virtual mailbox table if you want
 to easily host a lot of encrypted mailing lists.
 
-7. Admin tasks are performed through aliases like your-list-request@yourmachine
-   or via command-line:
+### List administration
+
+Admin tasks are performed through aliases like your-list-request@yourmachine
+or via command-line:
 
        firma -a your-list
 
@@ -225,15 +236,19 @@ following commands:
           uses the given address for message delivery instead
           of the primary address of a subscribed key
 
-8. To subscribe and unsubscribe manually the users and the list admins on, use
-   a command line like
+### Subscription management
+
+To subscribe and unsubscribe manually the users and the list admins on, use
+a command line like
 
        gpg --homedir [path-to-your-list-keyring] --import < file
 
      and be sure that after this command the list keyring is owned by nobody.nobody.
 
-9. Send encrypted AND signed messages to `your-list@yourmachine` and look
-   what happens :)
+### Testing the installation
+
+Send encrypted AND signed messages to `your-list@yourmachine` and look
+what happens :)
 
 Tips
 ----
-- 
cgit v1.2.3