[drakma-devel] Drakma documentation overhaul

[Hans Hübner]

Hi,

while fixing some bugs in Drakma recently, I was notified that the
documentation and the docstrings were not matching well anymore.  I
have decided to overhaul the documentation, and in the process of
that, I also made some source changes.

There will be more changes soon, so you may experience instabilities
when you're using the master branch from github.

Comments regarding the documentation would be very welcome, I have put
a version up for review at http://netzhansa.com/drakma.html

Thanks,
Hans