Re: [boost] Boost.Threads draft library submission

From: Beman Dawes (bdawes_at_[hidden])
Date: 2001-03-15 11:57:04

Bill Kempf wrote:

 >... I've uploaded a _DRAFT_ library submission for
 >Boost.Threads.

Great!  Here are some initial reactions:

*  The headers should go in a boost/threads sub-directory.  We should do 
this will all boost libraries with more than one or two headers, 
particularly ones like Boost.Threads which will probably grow in terms of 
number of headers.  Relatively easy to do now, messy to do later.

*  Your documentation deserves compliments.  It is easy to read, with 
reasonably sized paragraphs and sections, and short, clear, easy to 
understand sentences.  I hope as it inevitably expands, you will do so by 
adding additional sections and pages, and keeping the current to-the-point 
style.

*  Several other folks (Jeremy Siek and Dietmar Kuehl come to mind) have 
written papers regarding Boost threading issues.  Should these be included 
in the docs package?  (I haven't looked at them in awhile, so don't know if 
they still apply.)

*  You might want to consider starting a FAQ fairly soon.  While some of 
the questions coming up can be addressed by improving the core docs, some 
are more FAQ-like and should be treated as such.

*  Skim reading your interfaces, it is really nice that you have held the 
number of functions down to a reasonable number. That will make inspection, 
testing, documentation, understanding, and a lot of other things easier.

Finally, thanks for all the effort you've put into Boost.Threads!

--Beman