BOOST_THREAD_USE_DLL and BOOST_THREAD_USE_LIB are crucial and need to be documented

[Jim Bell <jim@…>]

Boost.Thread's documentation makes no reference to macros BOOST_THREAD_USE_DLL or BOOST_THREAD_USE_LIB, but they're crucial to correct building and linking on some platforms.

[Jim Bell <jim@…>]

...and they should have a line in thread's doc's table of contents.

[anonymous]

In general boost is terrible for this sort of thing. The only way to learn about this kind of stuff is to get some some sort of cryptic error message when you try to compile your app, and then search for the compiler error in google.

[Jim Bell <jim@…>]

And (for the sake of the search engines) needing it and not supplying it gives you errors like such:

undefined reference to `_imp___ZN5boost11this_thread18interruptible_waitEPvNS_6detail7timeoutE'
In function `~thread_group':
undefined reference to `_imp___ZN5boost6threadD1Ev'
undefined reference to `_imp___ZN5boost6thread4joinEv'
In function `thread<void (*)()>':
undefined reference to `_imp___ZN5boost6thread12start_threadEv'
In function `~auto_ptr':
undefined reference to `_imp___ZN5boost6threadD1Ev'
collect2: ld returned 1 exit status

[viboes]

I see that in addition Boost.Thread doesn't follows completely Automatic library selection.

It would be great to adopt the already documented way to build and use a library, document it and make the necessary adaptations on the code and bjam files.

What about this text.

Using and building the library

Boost.Thread is configured following the conventions used to build libraries with separate source code. Boost.Thread will import/export the code only if the user has specifically asked for it, by defining either BOOST_ALL_DYN_LINK if they want all boost libraries to be dynamically linked, or BOOST_THREAD_DYN_LINK if they want just this one to be dynamically liked.

The source code compiled when building the library defines a macros BOOST_THREAD_SOURCE that is used to import or export it. The user must not define this macro in any case.

[viboes]

Committed in trunk revision #75905.

[viboes]

Committed in trunk at revision [76543].

[viboes]

Committed in release branch at [78543]