<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 1st September 2003), see www.w3.org">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<link rel="stylesheet" type="text/css" href="../../../boost.css">
<title>Boost.Build - msvc-stlport toolset</title>
</head>
<body link="#0000FF" vlink="#800080">
<table border="0" cellpadding="7" cellspacing="0" width="100%" summary=
"header">
<tbody>
<tr>
<td valign="top" width="300">
<h3><a href="http://www.boost.org/"><img height="86" width="277"
alt="C++ Boost" src="../../../c++boost.gif" border="0"></a></h3>
</td>
<td valign="top">
<h1 align="center">Boost.Build</h1>
<h2 align="center">msvc-stlport toolset</h2>
</td>
</tr>
</tbody>
</table>
<hr>
<h2>Introduction</h2>
<p>Boost.Build's <a href=
"http://msdn.microsoft.com/visualc/">msvc-stlport</a> toolset supports the
Microsoft <a href="http://msdn.microsoft.com/visualc/">Visual C++</a>
command-line tools, using the <a href="http://www.stlport.org">STLport</a>
standard library implementation on Microsoft Windows. It is designed to
allow you to build and test with multiple installed versions of STLPort, so
that objects build in each configuration will be built into separate
directories.</p>
<h2><a name="configuration">Configuration Variables</a></h2>The
<code>msvc</code> toolset responds to the following variables, which can be
set in the environment or configured on the jam command-line using
<code>-s<i>VARIABLE_NAME</i>=</code><i>value</i>. It is an extension of the
<a href="msvc-tools.html">msvc toolset</a> and therefore responds to all of
the MSVC <a href="msvc-tools.html#configuration">configuration
variables</a> in addition to those listed below.
<p>In the table below, <i>version</i> corresponds to an STLPort version
number, e.g. "<code>4.5.3</code>".</p>
<table border="1" summary="settings">
<tr>
<th>Variable Name</th>
<th>Semantics</th>
<th>Default</th>
<th>Notes</th>
</tr>
<tr>
<td><code>STLPORT_PATH</code></td>
<td>A directory containing at least one subdirectory of the form
<code>/STLPort-</code><i>version</i> where an STLPort installation can
be found.</td>
<td><i>empty</i></td>
<td>Allows easy configuration for an installation where several STLPort
versions are installed under a single directory.</td>
</tr>
<tr>
<td><code>STLPORT_</code><i>version</i><code>_PATH</code></td>
<td>The directory where the specific STLPort <i>version</i>
installation can be found, in case there is no central location
appropriate for <code>STLPORT_PATH</code>, above, or a particular
version's installation is not located in the usual place.</td>
<td><i>empty</i></td>
<td>Allows configuration of a specific STLPort installation.</td>
</tr>
<tr>
<td><code>STLPORT_VERSION</code></td>
<td>The version of STLPort in use by default.</td>
<td><code>4.5.3</code></td>
<td>Other values can be selected in parallel setting the <a href=
"build_system.htm#initiating">build property</a>
<stlport-version> to values from the list of
<code>$(STLPORT_VERSIONS)</code></td>
</tr>
<tr>
<td><code>STLPORT_VERSIONS</code></td>
<td>A space-separated list of alternate versions of STLport available
on this machine.</td>
<td><code>4.5 4.0</code></td>
</tr>
</table>
<h2><a name="features">Toolset-Specific Features</a></h2>The following
<code>msvc-stlport</code>-specific <a href=
"build_system.htm#features">features</a> can be used in target build
requirements or in the <a href=
"build_system.htm#initiating"><code>BUILD</code></a> variable:
<table border="1" summary="features">
<tr>
<th>Feature</th>
<th>Values</th>
<th>Default</th>
<th>Semantics</th>
</tr>
<tr>
<td><code>stlport-iostream</code></td>
<td><code>off on</code></td>
<td><code>off</code></td>
<td>Controls whether STLPort's own iostreams are in use. Though this
setting is <code>off</code> by default to save users from having to
build STLPort, we strongly recommend <code>on</code> instead.</td>
</tr>
<tr>
<td><code>stlport-version</code></td>
<td><code>$(STLPORT_VERSION) $(STLPORT_VERSIONS)</code> (see
above)</td>
<td><code>$(STLPORT_VERSION)</code></td>
<td>Selects a version of STLPort for each target</td>
</tr>
<tr>
<td><code>stlport-cstd-namespace</code></td>
<td><code>std global</code></td>
<td><code>std</code></td>
<td>Controls whether or not names from the "C" library headers such as
<cstdlib> are imported into <code>namespace std</code>.</td>
</tr>
</table>
<hr>
<p>Revised
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->
14 May, 2002 <!--webbot bot="Timestamp" endspan i-checksum="39359" --></p>
<p>Copyright © Dave Abrahams 2002.</p>
<p><small>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">www.boost.org/LICENSE_1_0.txt</a>)</small></p>
</body>
</html>
