Introduce speaking options

1 files changed, 76 insertions, 34 deletions

diff --git a/docs/metagen.1 b/docs/metagen.1
index c80d5db..db9f76b 100644
--- a/docs/metagen.1
+++ b/docs/metagen.1
@@ -15,40 +15,82 @@ separate them. See EXAMPLES.
 
 .SH OPTIONS
 .\" metagen [OPTIONS]
-  -H  herd
-      Name of herd.
-
-  -e  email-address
-      Package maintainer's email address
-
-  -n  maintainer-name
-      Package maintainer's name (used with -e option)
-
-  -m 
-      Uses ECHANGELOG_USER variable. Can be used instead of -e and -n
-
-  -d  description
-      Description of maintainership (used with -e option)
-
-  -l  long-description
-      Long description of package.
-
-  -o  output-file
-      Write to <output-file> instead of ./metadata.xml
-
-  -f
-      Force overwrite of existing metadata
-
-  -v 
-      Write to stdout as well as disk (default)
-
-  -q
-      Don't write to stdout
-
-  -Q
-      Don't write file to disk 
-
-  -h, --help  show this help message and exit
+.B --herd
+|
+.B
+-H
+herd
+    Name of herd.
+
+.B --email
+|
+.B
+-e
+email-address
+    Package maintainer's email address
+
+.B --name
+|
+.B
+-n
+maintainer-name
+    Package maintainer's name (used with -e option)
+
+.B --echangelog
+|
+.B
+-m
+    Uses ECHANGELOG_USER variable. Can be used instead of -e and -n
+
+.B --desc
+|
+.B
+-d
+description
+    Description of maintainership (used with -e option)
+
+.B --long
+|
+.B
+-l
+long-description
+    Long description of package.
+
+.B --output
+|
+.B
+-o
+output-file
+    Write to <output-file> instead of ./metadata.xml
+
+.B --force
+|
+.B
+-f
+    Force overwrite of existing metadata
+
+.B --verbose
+|
+.B
+-v
+    Write to stdout as well as disk (default)
+
+.B --quiet
+|
+.B
+-q
+    Don't write to stdout
+
+.B -Q
+    Don't write file to disk
+
+.B --help
+|
+.B -h
+    show usage help and exit
+
+.B --version
+    show version and exit
 
 .SH EXAMPLES
 .B metagen -H python