Make ready for distribution.

Add installation instructions to README, make README the long_description and
make cli snippets more clear.