Update IO docs and clarify bin* functions
Merge pull request #1702 from ericmj/io-docs

Update IO docs and clarify bin* functions