Python 3 and docstring fixes

As per #64 and #67, travis is erroring on some builds because:

1. `htmllib` is `HTMLParser` in python3
2. there were documentation errors