Fixed/improved documentation.

Let's make this library actually useful and sensible for the public. :)

More to follow soon.  Please don't merge yet. ;)