Cosmetic and documentation improvements for abc::file_{i,o}stream

Make the name of a few methods shorter, and document some methods in
abc::file_istream and abc::file_ostream.