allow 0-9 in words as well

dicepwgen.pod

@@ -12,6 +12,8 @@ dicepwgen - A diceware password generator
                               /usr/share/dict/american-english)
     -l --minlen <count>       Minimum word len (default: 5)
     -m --maxlen <count>       Maximum word len (default: 10)
+    -n --dontjump             Use all words in the dict file, e.g.
+                              if it is an original diceware list
     -d --debug                Enable debug output
     -v --version              Print program version
     -h -? --help              Print this help screen
@@ -31,13 +33,33 @@ minimum and maximum word length.
 You can tell dicepwgen to use another dictionary file with
 the option B<-f>.
 
+If you're using a precomputed diceware list, use the parameter
+B<-n>, in which case dicepwgen will use all entries in the file.
+
 The program only uses words which contain 7bit ASCII letters
-(a-zA-Z), which are easier for password usage anyway.
+(a-zA-Z0-9), which are easier for password usage anyway.
 
 =head1 FILES
 
 B</usr/share/dict/american-english>: default dictionary file.
 
+You can use almost any dictionary file you want. Dicepwgen expects
+the file to be in the following format: one word per line.
+
+You can also use precomputed diceware word lists by adding the
+option B<-n> to the commandline. If the file already contains
+numbers, you have to remove them before using. Say, the file
+looks like this:
+
+ 11126   abase
+ 11131   abash
+ 11132   abate
+ 11133   abbas
+
+Prepare the file with this shell oneliner:
+
+ grep "^[0-9]" dicewarelist.txt | awk '{print $2}' >> newlist.txt
+
 =head1 SEE ALSO
 
 L<http://world.std.com/~reinhold/diceware.html>
@@ -50,6 +72,21 @@ In order to report a bug, unexpected behavior, feature requests
 or to submit a patch, please open an issue on github:
 L<https://github.com/TLINDEN/diceware/issues>.
 
+Current known issues:
+
+=over
+
+=item *
+
+The program does not count the lines in a dictionary file before
+using it. If the file contains a low number of entries (e.g. because
+it is a precomputed diceware word list and B<-n> has not been
+specified), it seems to "hang". In fact it runs very long because it
+jumps over a random number of entries and restarts from the beginning
+again and again til the required number of words has been collected (7776).
+
+=back
+
 =head1 LICENSE
 
 This software is licensed under the GNU GENERAL PUBLIC LICENSE version 3.