improved io docs
Merge pull request #464 from ndawe/master

[MRG] improved io docs