diff --git a/separate_compilation.html b/separate_compilation.html index 990e6a7..1f63c3f 100644 --- a/separate_compilation.html +++ b/separate_compilation.html @@ -31,8 +31,8 @@
Preventing Compiler ABI Clashes
Supporting - Windows Dll's
Enabling Automatic Library Selection - and Linking
+ Windows Dll's
+ Automatic Library Selection and Linking with auto_link.hpp
Changes Affecting the Build System
@@ -253,7 +253,8 @@ BOOST_WHATEVER_DECL whatever get_whatever() size is often significantly smaller this way as well: i.e. you pay for what you use and no more), but this is a subjective call, and some libraries may even only be available in dynamic versions (Boost.threads for example).

-

Enabling Automatic Library Selection and Linking

+

Automatic Library Selection and Linking with + auto_link.hpp

Many Windows compilers ship with multiple runtime libraries - for example Microsoft Visual Studio .NET comes with 6 versions of the C and C++ runtime. It is essential that the Boost library that the user links to is built against the @@ -286,10 +287,9 @@ libboost_regex-vc71-sgd-1_31.lib the name of the right library build variant gets embedded in the object file, and as long as that library is in the linker search path, it will get pulled in by the linker without any user intervention.

-

This feature can be enabled for Boost libraries by including the header - after defining BOOST_LIB_NAME and BOOST_DYN_LINK as - required, as usual the feature can also be disabled by the user, if they define - either BOOST_ALL_NO_LIB or BOOST_WHATEVER_NO_LIB:

+

Automatic library selection and linking can be enabled for a Boost library by including the header + <boost/config/auto_link.hpp>, after first defining BOOST_LIB_NAME and, if + applicable, BOOST_DYN_LINK.

//
 // Automatically link to the correct build variant where possible.
 //
@@ -312,6 +312,9 @@ libboost_regex-vc71-sgd-1_31.lib
 #endif  // auto-linking disabled
 

+

The library's user documentation should note that the feature can be disabled + by defining + either BOOST_ALL_NO_LIB or BOOST_WHATEVER_NO_LIB:

If for any reason you need to debug this feature, the header <boost/config/auto_link.hpp> will output some helpful diagnostic messages if you first define BOOST_LIB_DIAGNOSTIC.

@@ -436,11 +439,9 @@ run

Revised - - 21 Nov 2003 -

+ 25 November, 2003

© Copyright John Maddock 1998- - 2003

+ 2003

Use, modification and distribution are subject to the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt).