Refs #25, refs #39, refs #40, refs #42 - Big refactoring in documentation and demo: narrative documentation uses examples from demo project.
Updated description and keywords for PyPI.
Renamed README to README.rst. Improved setup.py readability.