Opened 9 years ago

Closed 9 years ago

#9625 closed Bugs (fixed)

Please rewrite boost::thread::~thread() reference section

Reported by: mark@… Owned by: viboes
Milestone: Boost 1.56.0 Component: thread
Version: Boost 1.54.0 Severity: Problem
Keywords: Cc:

Description

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.

Change History (3)

comment:1 by viboes, 9 years ago

Component: Documentation → thread
Owner: changed from Matias Capeletto to viboes
Status: new → assigned

comment:2 by viboes, 9 years ago

Milestone: To Be Determined → Boost 1.56.0

Committed in develop

​https://github.com/boostorg/thread/commit/c6593d87b0846f96067c4e59126b9fc01034f94c

Note: See TracTickets for help on using tickets.