[Boost-commit] svn:boost r75905 - trunk/libs/thread/doc

Subject: [Boost-commit] svn:boost r75905 - trunk/libs/thread/doc
From: vicente.botet_at_[hidden]
Date: 2011-12-11 13:16:08

Author: viboes
Date: 2011-12-11 13:16:07 EST (Sun, 11 Dec 2011)
New Revision: 75905
URL: http://svn.boost.org/trac/boost/changeset/75905

Log:
Thread: #4921 BOOST_THREAD_USE_DLL and BOOST_THREAD_USE_LIB are crucial and need to be documented
Text files modified: 
   trunk/libs/thread/doc/overview.qbk |    12 ++++++++++++                            
   1 files changed, 12 insertions(+), 0 deletions(-)

Modified: trunk/libs/thread/doc/overview.qbk
==============================================================================
--- trunk/libs/thread/doc/overview.qbk	(original)
+++ trunk/libs/thread/doc/overview.qbk	2011-12-11 13:16:07 EST (Sun, 11 Dec 2011)
@@ -28,3 +28,15 @@
 which includes all the other headers in turn.
 
 [endsect]
+
+
+[section:build 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 definition of these macros determines whether BOOST_THREAD_USE_DLL is defined. If  BOOST_THREAD_USE_DLL is not defined, the library will define BOOST_THREAD_USE_DLL or BOOST_THREAD_USE_LIB depending on whether the platform. On non windows platforms BOOST_THREAD_USE_LIB is defined if is not defined. In windows platforms, BOOST_THREAD_USE_LIB is defined if BOOST_THREAD_USE_DLL and the compiler supports auto-tss cleanup with Boost.Threads (for the time been Msvc and Intel)
+
+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. 
+
+[endsect]
+