Add Sphinx doc configuration and Makefile and enhanced docstrings

This change mainly adds code examples to many methods, heavily borrowed from current tests.
Triggered by https://github.com/scrapy/w3lib/issues/15

For reviewers: you may want to run `make html` in `w3lib/docs` to see what you get