Major documentation overhaul.

Thanks to vmalloc for working on the initial preparation of Sphinx docs
and doctests. These have been extended to include a few more edge cases,
and full text descriptions. Now, every method and property on URLObject
is documented. Yay.