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.

Apparently `pypip.io` is not longer active. It looks like `shields.io`
offers even much more badges.

`sphinx` can generate not only HTML docs but also man pages. Let's see
how far we can go to replace the more or less manually crafted man page
we provide currently.

In fact Arnold G. Reinhold copyrighted each of the pages of the
`diceware.com` website. The idea as such was not copyrighted (and might
be uncopyrightable).

Mr. Reinhold, however, still owns a "diceware" trademark.

And remove unneccessary whitespace.

We should be able to generate a more accurate man page for `diceware`.
with `docutils` and `rst2man` we can create a nice looking man page with
proper styles set.

Yet, we onlyy provide first parts of the man page template.

Make Sphinx stop complaining and fix indents.