id,summary,reporter,owner,description,type,status,milestone,component,version,severity,resolution,keywords,cc
9222,iostreams documentation hard to read,harris.pc@…,Jonathan Turkanis,"Hi,

You guys have put a lot of work into iostreams documentation,
but,
where it falls down is when someone unfamiliar with the library (ie, me) wants to quickly figure out how to do something.

For example, I wanted to create an input stream from an existing array.

I found this page:
http://www.boost.org/doc/libs/1_54_0/libs/iostreams/doc/classes/array.html

But frustratingly, there was no example on how to use.
Google was of limited use, eventually I found this page,
http://www.boost.org/doc/libs/1_53_0/libs/iostreams/doc/guide/generic_streams.html#examples

Which was exactly what I wanted to know,
but there really should be an example on the array's page, or at least a link to the relevant documentation that talks about how to use it.

Was very frustrating.

cheers,
Paul

",Feature Requests,new,To Be Determined,iostreams,Boost 1.54.0,Problem,,,