|
|
@@ -3,7 +3,7 @@
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
|
<head>
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
-<meta name="generator" content="Docutils 0.13.1: http://docutils.sourceforge.net/" />
|
|
|
+<meta name="generator" content="Docutils 0.12: http://docutils.sourceforge.net/" />
|
|
|
<title>Boost Getting Started on Windows</title>
|
|
|
<link rel="stylesheet" href="../../rst.css" type="text/css" />
|
|
|
</head>
|
|
|
@@ -14,7 +14,7 @@
|
|
|
<!-- Copyright David Abrahams 2006. Distributed under 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) -->
|
|
|
-<div class="admonition admonition-a-note-to-cygwin-and-mingw-users">
|
|
|
+<div class="admonition-a-note-to-cygwin-and-mingw-users admonition">
|
|
|
<p class="first admonition-title">A note to <a class="reference external" href="http://www.cygwin.com">Cygwin</a> and <a class="reference external" href="http://mingw.org">MinGW</a> users</p>
|
|
|
<p class="last">If you plan to use your tools from the Windows command prompt,
|
|
|
you're in the right place. If you plan to build from the <a class="reference external" href="http://www.cygwin.com">Cygwin</a>
|
|
|
@@ -103,7 +103,7 @@ the Python library's <tt class="docutils literal">def.hpp</tt> header in</p>
|
|
|
</li>
|
|
|
<li><p class="first">Some libraries have an “aggregate header” in <tt class="docutils literal">boost</tt><tt class="docutils literal">\</tt> that
|
|
|
<tt class="docutils literal">#include</tt>s all of the library's other headers. For
|
|
|
-example, <a class="reference external" href="../../libs/python/doc/building.html">Boost.Python</a>'s aggregate header is</p>
|
|
|
+example, <a class="reference external" href="../../libs/python/doc/html/building.html">Boost.Python</a>'s aggregate header is</p>
|
|
|
<pre class="literal-block">
|
|
|
<tt class="docutils literal">boost</tt><tt class="docutils literal">\</tt><tt class="docutils literal">python.hpp</tt>.
|
|
|
</pre>
|
|
|
@@ -154,7 +154,7 @@ contains a subset of the Boost documentation. Start with
|
|
|
<h1><a class="toc-backref" href="#id30">3 Header-Only Libraries</a></h1>
|
|
|
<p>The first thing many people want to know is, “how do I build
|
|
|
Boost?” The good news is that often, there's nothing to build.</p>
|
|
|
-<div class="admonition admonition-nothing-to-build">
|
|
|
+<div class="admonition-nothing-to-build admonition">
|
|
|
<p class="first admonition-title">Nothing to Build?</p>
|
|
|
<p class="last">Most Boost libraries are <strong>header-only</strong>: they consist <em>entirely
|
|
|
of header files</em> containing templates and inline functions, and
|
|
|
@@ -173,7 +173,7 @@ treatment when linking.</p>
|
|
|
<li><a class="reference external" href="../../libs/log/index.html">Boost.Log</a> (see <a class="reference external" href="../../libs/log/doc/html/log/installation/config.html">build documentation</a>)</li>
|
|
|
<li><a class="reference external" href="../../libs/mpi/index.html">Boost.MPI</a></li>
|
|
|
<li><a class="reference external" href="../../libs/program_options/index.html">Boost.ProgramOptions</a></li>
|
|
|
-<li><a class="reference external" href="../../libs/python/doc/building.html">Boost.Python</a> (see the <a class="reference external" href="../../libs/python/doc/building.html">Boost.Python build documentation</a>
|
|
|
+<li><a class="reference external" href="../../libs/python/doc/html/building.html">Boost.Python</a> (see the <a class="reference external" href="../../libs/python/doc/html/building.html">Boost.Python build documentation</a>
|
|
|
before building and installing it)</li>
|
|
|
<li><a class="reference external" href="../../libs/regex/index.html">Boost.Regex</a></li>
|
|
|
<li><a class="reference external" href="../../libs/serialization/index.html">Boost.Serialization</a></li>
|
|
|
@@ -228,7 +228,7 @@ int main()
|
|
|
}
|
|
|
</pre>
|
|
|
<p>Copy the text of this program into a file called <tt class="docutils literal">example.cpp</tt>.</p>
|
|
|
-<div class="admonition note" id="command-line-tool">
|
|
|
+<div class="note" id="command-line-tool">
|
|
|
<span id="command-prompt"></span><p class="first admonition-title">Note</p>
|
|
|
<p class="last">To build the examples in this guide, you can use an
|
|
|
Integrated Development Environment (IDE) like Visual Studio, or
|
|
|
@@ -387,7 +387,7 @@ the directory where you want Boost.Build to be installed</li>
|
|
|
<p>First, find the toolset corresponding to your compiler in the
|
|
|
following table (an up-to-date list is always available <a class="reference external" href="http://www.boost.org/build/doc/html/bbv2/reference/tools.html">in the
|
|
|
Boost.Build documentation</a>).</p>
|
|
|
-<div class="admonition note">
|
|
|
+<div class="note">
|
|
|
<p class="first admonition-title">Note</p>
|
|
|
<p class="last">If you previously chose a toolset for the purposes of
|
|
|
<a class="reference external" href="../../doc/html/bbv2/installation.html">building b2</a>, you should assume it won't work and instead
|
|
|
@@ -506,7 +506,7 @@ list</a>.</p>
|
|
|
library binaries in the <tt class="docutils literal">stage</tt><tt class="docutils literal">\</tt><tt class="docutils literal">lib</tt><tt class="docutils literal">\</tt> subdirectory of
|
|
|
the Boost tree. To use a different directory pass the
|
|
|
<tt class="docutils literal"><span class="pre">--stagedir=</span></tt><em>directory</em> option to <tt class="docutils literal">b2</tt>.</p>
|
|
|
-<div class="admonition note">
|
|
|
+<div class="note">
|
|
|
<p class="first admonition-title">Note</p>
|
|
|
<p class="last"><tt class="docutils literal">b2</tt> is case-sensitive; it is important that all the
|
|
|
parts shown in <strong>bold</strong> type above be entirely lower-case.</p>
|
|
|
@@ -524,7 +524,7 @@ be interested in:</p>
|
|
|
<li>choosing a specific build variant by adding <tt class="docutils literal">release</tt> or
|
|
|
<tt class="docutils literal">debug</tt> to the command line.</li>
|
|
|
</ul>
|
|
|
-<div class="admonition note">
|
|
|
+<div class="note">
|
|
|
<p class="first admonition-title">Note</p>
|
|
|
<p class="last">Boost.Build can produce a great deal of output, which can
|
|
|
make it easy to miss problems. If you want to make sure
|
|
|
@@ -607,7 +607,7 @@ build settings.</li>
|
|
|
whose compile configuration is compatible with the rest of your
|
|
|
project.</li>
|
|
|
</ol>
|
|
|
-<div class="admonition admonition-auto-linking">
|
|
|
+<div class="admonition-auto-linking admonition">
|
|
|
<p class="first admonition-title">Auto-Linking</p>
|
|
|
<p>Most Windows compilers and linkers have so-called “auto-linking
|
|
|
support,” which eliminates the second challenge. Special code in
|
|
|
@@ -646,7 +646,7 @@ cl /EHsc /I <em>path\to\</em><tt class="docutils literal">boost_1_64_0</tt> exam
|
|
|
</div>
|
|
|
<div class="section" id="library-naming">
|
|
|
<h2><a class="toc-backref" href="#id47">6.3 Library Naming</a></h2>
|
|
|
-<div class="admonition note">
|
|
|
+<div class="note">
|
|
|
<p class="first admonition-title">Note</p>
|
|
|
<p>If, like Visual C++, your compiler supports auto-linking,
|
|
|
you can probably <a class="reference internal" href="#test-your-program"><em>skip to the next step</em></a>.</p>
|
|
|
@@ -706,7 +706,7 @@ libraries.</td>
|
|
|
<td>runtime-debugging=on</td>
|
|
|
</tr>
|
|
|
<tr><td><tt class="docutils literal">y</tt></td>
|
|
|
-<td>using a special <a class="reference external" href="../../libs/python/doc/building.html#python-debugging-builds">debug build of Python</a>.</td>
|
|
|
+<td>using a special <a class="reference external" href="../../libs/python/doc/html/building/python_debugging_builds.html">debug build of Python</a>.</td>
|
|
|
<td>python-debugging=on</td>
|
|
|
</tr>
|
|
|
<tr><td><tt class="docutils literal">d</tt></td>
|
|
|
@@ -785,7 +785,7 @@ mailing list</a>.</p>
|
|
|
<li><a class="reference external" href="http://www.boost.org/more/mailing_lists.htm#jamboost">Boost.Build mailing list</a></li>
|
|
|
<li><a class="reference external" href="../../libs/index.html">Index of all Boost library documentation</a></li>
|
|
|
</ul>
|
|
|
-<div class="admonition admonition-onward">
|
|
|
+<div class="admonition-onward admonition">
|
|
|
<p class="first admonition-title">Onward</p>
|
|
|
<blockquote class="epigraph last">
|
|
|
<p>Good luck, and have fun!</p>
|
Daniel James