Tell about using real dice with more than 6 faces.

The manpage test failed when tests were run in a long path. The help
output then led to an extra line break which made comaparisons quite
cumbersome.

This one ruined the 0.9.2 release.

Use version generated by docutils from manpage template in `docs/`.

The wordlist length must be a power of the number of dice sides used to
result in fair choices. This is not being relatively prime.

Tell about problems with wordlist lengths and dice side numbers.

Put this list into list of all contained wordlists and provide a link to
the source.

Mark it properly as github username.

Also fix entropy computation.

Begin with some very plain usage samples.

Avoid to write down a certain path, as that could block reproducible
builds.

in man page.

We will have another release soon. So, let's care for details better to
soon than too late.

The documenting comment (starting with ``#: ``) is neccessary for vars
and constants only. All these comments are used by `Sphinx` to generate
documentation.

Put consts at top of file and functions below. The code is better
readable this way.

Kudos to @drebs for another fine patch.

Looks like we need the '.py' filename extension to call `rst2man` in
regular installs.

Use function to get wordlists dir. Fixes #38

The path to wordlist files is hardcoded in the generated sphinx
documentation and because it may differ depending on how the package is
installed this creates different problems:

  - the path hardcoded in the online api documentation may differ from
    the one in each installation, leading to incorrect information
    provided to the user of the api.

  - packaging diceware documentation to specific operating systems may
    generate unreproducible packages.

This commit replaces the variable WORDLISTS_DIR by a function called
get_wordlists_dir() that delays the construction of the path instead of
doing it during module loading.

We showed an outdated list of available wordlists before.