Merge pull request #297 from jcrobak/sphinx-improvements

sphinx documentation improvements
Another bug with relative paths and move()

Added a test and also made some existing tests a bit harder
Warn when wildcards is used in paths
Merge pull request #300 from spotify/alander/warn-on-wildcards

Warn when wildcards is used in paths
Merge pull request #298 from erikbern/file-move

Another bug with relative paths and move()
Convert README.md to README.rst

Break the content out into a number of smaller files. This makes
it easier to adopt to sphinx docs.
Include content from README in index.rst

remove the old temporary api file.