[boost] I/O library formal review

From: Beman Dawes (bdawes_at_[hidden])
Date: 2003-03-11 15:12:08

Comments, based on reading the docs (without much background in 
understanding the ins and outs of stream buffers):

* Needs a libs/io/test/Jamfile, using the subinclude approach from the main 
status/Jamfile.

* The Stream-buffer-wrapping Streams Rationale section (there is no 
Introduction section) doesn't really answer some very important questions 
like "Why are these facilities provided?", "What are their uses?", "What do 
they do better than the Standard Library's current classes?"

* The Rationale for Array-Based Streams concludes "it may have real-life 
applications." It would be a bit more satisfying if there was at least one 
example of a real-life application.

* newl needs a bit more rationale. How is cout << newl different from cout 
<< '\n'? How is it better?

It is hard to form an opinion about the library without better rationale.

--Beman