doc/html/boost_tr1/config.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   5 <title>Configuration</title>
   6 <link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css">
   7 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   8 <link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
   9 <link rel="up" href="../boost_tr1.html" title="Chapter&#160;39.&#160;Boost.TR1">
  10 <link rel="prev" href="usage.html" title="Usage">
  11 <link rel="next" href="subject_list.html" title="TR1 By Subject">
  12 </head>
  13 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  14 <table cellpadding="2" width="100%"><tr>
  15 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
  16 <td align="center"><a href="../../../index.html">Home</a></td>
  17 <td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  19 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  20 <td align="center"><a href="../../../more/index.htm">More</a></td>
  21 </tr></table>
  22 <hr>
  23 <div class="spirit-nav">
  24 <a accesskey="p" href="usage.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../boost_tr1.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="subject_list.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
  25 </div>
  26 <div class="section">
  27 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  28 <a name="boost_tr1.config"></a><a class="link" href="config.html" title="Configuration">Configuration</a>
  29 </h2></div></div></div>
  30 <p>
  31       Configuring Boost.TR1 is no different to configuring any other part of Boost;
  32       in the majority of cases you shouldn't actually need to do anything at all.
  33       However, because Boost.TR1 will inject Boost components into namespace std::tr1
  34       it is more than usually sensitive to an incorrect configuration.
  35     </p>
  36 <p>
  37       The intention is that <a href="../../../libs/config/index.html" target="_top">Boost.Config</a>
  38       will automatically define the configuration macros used by this library, so
  39       that if your standard library is set up to support TR1 (note that few are at
  40       present) then this will be detected and Boost.TR1 will use your standard library
  41       versions of these components rather than the Boost ones.
  42     </p>
  43 <p>
  44       If you would prefer to use the Boost versions of the TR1 conponents rather
  45       than your standard library, then either: include the Boost headers directly
  46     </p>
  47 <pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">regex</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  48
  49 <span class="identifier">boost</span><span class="special">::</span><span class="identifier">regex</span> <span class="identifier">e</span><span class="special">(</span><span class="string">"myregex"</span><span class="special">);</span> <span class="comment">//etc</span>
  50 </pre>
  51 <p>
  52       Or else don't enable TR1 in your standard library: since TR1 is not part of
  53       the current standard, there should be some option to disable it in your compiler
  54       or standard library.
  55     </p>
  56 <p>
  57       The configuration macros used by each TR1 component are documented in each
  58       library section (and all together in the <a href="../../../libs/config/index.html" target="_top">Boost.Config</a>
  59       documentation), but defining BOOST_HAS_TR1 will turn on native TR1 support
  60       for everything (if your standard library has it), which can act as a convenient
  61       shortcut.
  62     </p>
  63 <div class="sidebar">
  64 <div class="titlepage"><div><div><p class="title"><b></b></p></div></div></div>
  65 <p>
  66       <span class="bold"><strong>Note for gcc users</strong></span><br> <br> Boost.TR1
  67       does not currently enable gcc's native TR1 implementation as this is currently
  68       in an early stage of development. However, you may choose to do so by defining
  69       BOOST_HAS_GCC_TR1.
  70     </p>
  71 </div>
  72 </div>
  73 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  74 <td align="left"></td>
  75 <td align="right"><div class="copyright-footer">Copyright &#169; 2005 John Maddock<p>
  76         Distributed under the Boost Software License, Version 1.0. (See accompanying
  77         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
  78       </p>
  79 </div></td>
  80 </tr></table>
  81 <hr>
  82 <div class="spirit-nav">
  83 <a accesskey="p" href="usage.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../boost_tr1.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="subject_list.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
  84 </div>
  85 </body>
  86 </html>