Rewrite long description, with correct dependencies.

Port over the nibabel machinery for filling the README.rst file from the
long description.

Note this in the release notes.