Fixing compilation warnings on clang 3.3
Rewriting documentation about buffered reader and writer, adding const_iterator method.