Javadoc for the io/ package

This is quite critical to document all this part...