Stability and reliability update.

In summary:

• Documentation corrections.
• Behaves more consistently and reliably.
• Plays nicely with file-like objects (e.g. io module).
• A few fixes, code tweaks, and added comments for clarity.
• Passes all tests with flying rainbows!