[Boost-bugs] [Boost C++ Libraries] #9625: Please rewrite boost::thread::~thread() reference section

Subject: [Boost-bugs] [Boost C++ Libraries] #9625: Please rewrite boost::thread::~thread() reference section
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2014-02-02 00:23:04

#9625: Please rewrite boost::thread::~thread() reference section
------------------------------+---------------------------
 Reporter:  mark@…            |      Owner:  matias
     Type:  Bugs              |     Status:  new
Milestone:  To Be Determined  |  Component:  Documentation
  Version:  Boost 1.54.0      |   Severity:  Problem
 Keywords:                    |
------------------------------+---------------------------
 Re:
 http://www.boost.org/doc/libs/1_55_0/doc/html/thread/thread_management.html#thread.thread_management.thread.destructor


 The section is completely unreadable and possibly inaccurate. For example,
 the hard-to-read section regarding
 BOOST_THREAD_PROVIDES_THREAD_DESTRUCTOR_CALLS_TERMINATE_IF_JOINABLE and
 the statement  "Thus the programmer must ensure that the destructor is
 never executed while the thread is still joinable" are at odds.

 Thread management is one of the most difficult things to do in
 programming: this VERY unclear reference section only adds to those woes.
 The information on when and how to destroy a thread is EXTREMELY
 important. Please bring the documentation up to grade.

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/9625>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.