boost/more
1
0
Fork 0
mirror of https://github.com/boostorg/more.git synced 2024-12-28 23:50:09 +08:00
Code Issues Packages Projects Releases Wiki Activity

Edit auto_link section for clarity

Browse Source 
[SVN r20945]
This commit is contained in:
Beman Dawes 2003-11-25 13:06:27 +00:00
parent 3ea785bfbf
commit 5f458b296d
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
separate_compilation.html
View File

@ -31,8 +31,8 @@
<dd>
<dl class="index">
<dt><A href="#abi">Preventing Compiler ABI Clashes</A> <dt><A href="#dlls">Supporting
Windows Dll's</A> <dt><A href="#auto-link">Enabling Automatic Library Selection
and Linking</A> </dt>
Windows Dll's</A> <dt><a href="#auto-link">
Automatic Library Selection and Linking with auto_link.hpp</a> </dt>
</dl>
<dt><A href="#build_changes">Changes Affecting the Build System</A>
<dd>
@ -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).</P>
<h3><A name="auto-link"></A>Enabling Automatic Library Selection and Linking</h3>
<h3><A name="auto-link"></A>Automatic Library Selection and Linking with
<a href="../boost/config/auto_link.hpp">auto_link.hpp</a></h3>
<p>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.</p>
<p>This feature can be enabled for Boost libraries by including the header
<boostconfigauto_link.hpp>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:</p>
<p>Automatic library selection and linking can be enabled for a Boost library by including the header
&lt;boost/config/auto_link.hpp&gt;, after first defining BOOST_LIB_NAME and, if
applicable, BOOST_DYN_LINK.</p>
<pre>//
// Automatically link to the correct build variant where possible.
//
@ -312,6 +312,9 @@ libboost_regex-vc71-sgd-1_31.lib
#endif // auto-linking disabled
</pre>
<P></P>
<p>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:</p>
<P>If for any reason you need to debug this feature, the header
&lt;boost/config/auto_link.hpp&gt; will output some helpful diagnostic messages
if you first define BOOST_LIB_DIAGNOSTIC.</P>
@ -436,11 +439,9 @@ run
</PRE>
<HR>
<p><A name="copyright"></A>Revised
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->
21 Nov 2003
<!--webbot bot="Timestamp" endspan i-checksum="39359" --></p>
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->25 November, 2003<!--webbot bot="Timestamp" endspan i-checksum="39363" --></p>
<p><i>© Copyright John Maddock&nbsp;1998-
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan --> 2003<!--webbot bot="Timestamp" endspan i-checksum="39359" --></i></p>
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%Y" startspan -->2003<!--webbot bot="Timestamp" endspan i-checksum="746" --></i></p>
<P><I>Use, modification and distribution are subject to the Boost Software License,
Version 1.0. (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A>
or copy at <A href="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>).</I></P>