More documentation for IO

fixes #630 
woops, didn't see your comment