Misc cleanup and doc additions

These are some simple cleanups and doc additions I had lying around mainly from working on the Python 3 port. In particular there is a clarification about the microsecond timestamps, which was also mentioned in #11.