Re: [Boost-bugs] [Boost C++ Libraries] #4921: BOOST_THREAD_USE_DLL and BOOST_THREAD_USE_LIB are crucial and need to be documented

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #4921: BOOST_THREAD_USE_DLL and BOOST_THREAD_USE_LIB are crucial and need to be documented
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2011-12-04 22:17:39

#4921: BOOST_THREAD_USE_DLL and BOOST_THREAD_USE_LIB are crucial and need to be
documented
-----------------------------------------+----------------------------------
  Reporter:  Jim Bell <jim@…>            |       Owner:  viboes                                           
      Type:  Bugs                        |      Status:  assigned                                         
 Milestone:  To Be Determined            |   Component:  thread                                           
   Version:  Boost Development Trunk     |    Severity:  Problem                                          
Resolution:                              |    Keywords:  BOOST_THREAD_USE_DLL BOOST_THREAD_USE_LIB linking
-----------------------------------------+----------------------------------
Changes (by viboes):

 * cc: viboes (added)
  * owner:  anthonyw => viboes
  * status:  new => assigned
  * milestone:  Boost 1.47.0 => To Be Determined

Comment:

 I see that in addition Boost.Thread doesn't follows completly
 [http://www.boost.org/doc/libs/1_48_0/libs/config/doc/html/boost_config/boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.automatic_library_selection

 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
 [http://www.boost.org/doc/libs/1_48_0/libs/config/doc/html/boost_config/boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code

 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 mus not
 define this macros in any case.

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