forked from boostorg/config
Fixed typos.
[SVN r27518]
This commit is contained in:
31
config.htm
31
config.htm
@@ -30,7 +30,7 @@
|
|||||||
<a href="#Acknowledgements">Acknowledgements</a></pre>
|
<a href="#Acknowledgements">Acknowledgements</a></pre>
|
||||||
<h2><a name="configuring"></a>Configuring Boost for Your Platform</h2>
|
<h2><a name="configuring"></a>Configuring Boost for Your Platform</h2>
|
||||||
<h4><a name="default_config"></a>Using the default boost configuration</h4>
|
<h4><a name="default_config"></a>Using the default boost configuration</h4>
|
||||||
<p>Boost is comes already configured for most common compilers and platforms; you
|
<p>Boost comes already configured for most common compilers and platforms; you
|
||||||
should be able to use boost "as is". Since the compiler is configured
|
should be able to use boost "as is". Since the compiler is configured
|
||||||
separately from the standard library, the default configuration should work
|
separately from the standard library, the default configuration should work
|
||||||
even if you replace the compiler's standard library with a third-party standard
|
even if you replace the compiler's standard library with a third-party standard
|
||||||
@@ -71,10 +71,10 @@
|
|||||||
running the boost configure script. From a shell command prompt you will need
|
running the boost configure script. From a shell command prompt you will need
|
||||||
to cd into <boost-root>/libs/config/ and type:</p>
|
to cd into <boost-root>/libs/config/ and type:</p>
|
||||||
<pre>sh ./configure</pre>
|
<pre>sh ./configure</pre>
|
||||||
<p>you will see a list of the items being checked as the script works it way
|
<p>you will see a list of the items being checked as the script works its way
|
||||||
through the regression tests. Note that the configure script only really
|
through the regression tests. Note that the configure script only really
|
||||||
auto-detects your compiler if it's called g++, c++ or CC. If you are using some
|
auto-detects your compiler if it's called g++, c++ or CC. If you are using some
|
||||||
other compiler then you will need to set one or more of the following
|
other compiler you will need to set one or more of the following
|
||||||
environment variables:</p>
|
environment variables:</p>
|
||||||
<table border="1" cellpadding="7" cellspacing="1" width="624">
|
<table border="1" cellpadding="7" cellspacing="1" width="624">
|
||||||
<tr>
|
<tr>
|
||||||
@@ -103,11 +103,10 @@
|
|||||||
<p>For example to run the configure script with HP aCC, you might use something
|
<p>For example to run the configure script with HP aCC, you might use something
|
||||||
like:</p>
|
like:</p>
|
||||||
<pre>export CXX="aCC"
|
<pre>export CXX="aCC"
|
||||||
export CXXFLAGS="-Aa
|
export CXXFLAGS="-Aa -DAportable -D__HPACC_THREAD_SAFE_RB_TREE -DRWSTD_MULTI_THREAD -DRW_MULTI_THREAD -D_REENTRANT -D_THREAD_SAFE"
|
||||||
-DAportable -D__HPACC_THREAD_SAFE_RB_TREE -DRWSTD_MULTI_THREAD -DRW_MULTI_THREAD -D_REENTRANT -D_THREAD_SAFE" export LDFLAGS="-DAportable"
|
export LDFLAGS="-DAportable"
|
||||||
export LIBS=
|
export LIBS="-lpthread"
|
||||||
"-lpthread" sh
|
sh ./configure</pre>
|
||||||
./configure</pre>
|
|
||||||
<p>However you run the configure script, when it finishes you will find a new
|
<p>However you run the configure script, when it finishes you will find a new
|
||||||
header - user.hpp - located in the <boost-root/libs/config/> directory. <b><i>Note
|
header - user.hpp - located in the <boost-root/libs/config/> directory. <b><i>Note
|
||||||
that configure does not install this header into your boost include path by
|
that configure does not install this header into your boost include path by
|
||||||
@@ -123,11 +122,11 @@ export LIBS=
|
|||||||
committing a configure-modified user.hpp to the cvs repository (something you
|
committing a configure-modified user.hpp to the cvs repository (something you
|
||||||
will not be thanked for!).</p>
|
will not be thanked for!).</p>
|
||||||
<p>Option 2: give the header a more memorable name, and place it somewhere
|
<p>Option 2: give the header a more memorable name, and place it somewhere
|
||||||
convenient, then define the macro BOOST_USER_CONFIG to point to it. For example
|
convenient; then, define the macro BOOST_USER_CONFIG to point to it. For example
|
||||||
create a new sub-directory <boost-root>/boost/config/user/, and copy the
|
create a new sub-directory <boost-root>/boost/config/user/, and copy the
|
||||||
header there; for example as "multithread-gcc-config.hpp". Then when compiling
|
header there; for example as "multithread-gcc-config.hpp". Then, when compiling
|
||||||
add the command line option:
|
add the command line option:
|
||||||
-DBOOST_USER_CONFIG="boost/config/user/multithread-gcc-config.hpp", and boost
|
-DBOOST_USER_CONFIG="<boost/config/user/multithread-gcc-config.hpp>", and boost
|
||||||
will use the new configuration header. This option allows you to generate more
|
will use the new configuration header. This option allows you to generate more
|
||||||
than one configuration header, and to keep them separate from the boost source
|
than one configuration header, and to keep them separate from the boost source
|
||||||
- so that updates to the source do not interfere with your configuration.</p>
|
- so that updates to the source do not interfere with your configuration.</p>
|
||||||
@@ -1137,7 +1136,7 @@ void g() { return f(); }</pre>
|
|||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
<h4><a name="info_macros"></a>Boost Informational Macros</h4>
|
<h4><a name="info_macros"></a>Boost Informational Macros</h4>
|
||||||
<p>The following macros describe boost features; these are the generally speaking
|
<p>The following macros describe boost features; these are, generally speaking
|
||||||
the only boost macros that should be tested in user code.</p>
|
the only boost macros that should be tested in user code.</p>
|
||||||
<table border="1" cellpadding="7" cellspacing="1" width="100%">
|
<table border="1" cellpadding="7" cellspacing="1" width="100%">
|
||||||
<tr>
|
<tr>
|
||||||
@@ -1371,7 +1370,7 @@ namespace boost{
|
|||||||
<h4><a name="defect_guidelines"></a>Adding New Defect Macros</h4>
|
<h4><a name="defect_guidelines"></a>Adding New Defect Macros</h4>
|
||||||
<p>When you need to add a new defect macro - either to fix a problem with an
|
<p>When you need to add a new defect macro - either to fix a problem with an
|
||||||
existing library, or when adding a new library - distil the issue down to a
|
existing library, or when adding a new library - distil the issue down to a
|
||||||
simple test case, often at this point other (possibly better) workarounds may
|
simple test case; often, at this point other (possibly better) workarounds may
|
||||||
become apparent. Secondly always post the test case code to the boost mailing
|
become apparent. Secondly always post the test case code to the boost mailing
|
||||||
list and invite comments; remember that C++ is complex and that sometimes what
|
list and invite comments; remember that C++ is complex and that sometimes what
|
||||||
may appear a defect, may in fact turn out to be a problem with the authors
|
may appear a defect, may in fact turn out to be a problem with the authors
|
||||||
@@ -1463,7 +1462,7 @@ int test()
|
|||||||
<p>Consider a situation in which you are concurrently developing on multiple
|
<p>Consider a situation in which you are concurrently developing on multiple
|
||||||
platforms. Then consider adding a new platform or changing the platform
|
platforms. Then consider adding a new platform or changing the platform
|
||||||
definitions of an existing platform. What happens? Everything, and this does
|
definitions of an existing platform. What happens? Everything, and this does
|
||||||
literally mean everything, recompiles.. Isn't it quite absurd that adding a new
|
literally mean everything, recompiles. Isn't it quite absurd that adding a new
|
||||||
platform, which has absolutely nothing to do with previously existing
|
platform, which has absolutely nothing to do with previously existing
|
||||||
platforms, means that all code on all existing platforms needs to be
|
platforms, means that all code on all existing platforms needs to be
|
||||||
recompiled?</p>
|
recompiled?</p>
|
||||||
@@ -1494,8 +1493,8 @@ int test()
|
|||||||
<p>The approach taken by boost's configuration headers is to separate
|
<p>The approach taken by boost's configuration headers is to separate
|
||||||
configuration into three orthogonal parts: the compiler, the standard library
|
configuration into three orthogonal parts: the compiler, the standard library
|
||||||
and the platform. Each compiler/standard library/platform gets its own
|
and the platform. Each compiler/standard library/platform gets its own
|
||||||
mini-configuration header, so that change to one compiler's configuration (for
|
mini-configuration header, so that changes to one compiler's configuration (for
|
||||||
example) does not effect other compilers. In addition there are measures that
|
example) does not affect other compilers. In addition there are measures that
|
||||||
can be taken both to omit the compiler/standard library/platform detection code
|
can be taken both to omit the compiler/standard library/platform detection code
|
||||||
(so that adding support to a new platform does not break dependencies), or to
|
(so that adding support to a new platform does not break dependencies), or to
|
||||||
freeze the configuration completely; providing almost complete protection
|
freeze the configuration completely; providing almost complete protection
|
||||||
|
8
configure
vendored
8
configure
vendored
@@ -1257,7 +1257,7 @@ Be patient - this could take some time...
|
|||||||
|
|
||||||
Note that this test script only gives an approximate
|
Note that this test script only gives an approximate
|
||||||
configuration - you will need to test the results carefully
|
configuration - you will need to test the results carefully
|
||||||
using the boost regresion test suite before using the results.
|
using the boost regression test suite before using the results.
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
if test $enable_test = 'yes'; then
|
if test $enable_test = 'yes'; then
|
||||||
@@ -1265,8 +1265,8 @@ if test $enable_test = 'yes'; then
|
|||||||
cat << EOF
|
cat << EOF
|
||||||
|
|
||||||
This script reports only the difference between the detected
|
This script reports only the difference between the detected
|
||||||
configuration, and the existing boost configuration. It's
|
configuration, and the existing boost configuration. Its
|
||||||
primary aim is to quicky report how well boost is configured
|
primary aim is to quickly report how well boost is configured
|
||||||
for one compiler.
|
for one compiler.
|
||||||
|
|
||||||
***
|
***
|
||||||
@@ -3271,7 +3271,7 @@ EEEOF
|
|||||||
cat << EEEOF
|
cat << EEEOF
|
||||||
|
|
||||||
Adjustments to boost configuration have been written to
|
Adjustments to boost configuration have been written to
|
||||||
user.hpp, copy this to boost/config/user.hpp to use "as is",
|
user.hpp. Copy this to boost/config/user.hpp to use "as is",
|
||||||
or define BOOST_SITE_CONFIG to point to its location.
|
or define BOOST_SITE_CONFIG to point to its location.
|
||||||
|
|
||||||
TREAT THIS FILE WITH CARE.
|
TREAT THIS FILE WITH CARE.
|
||||||
|
@@ -1,5 +1,5 @@
|
|||||||
#
|
#
|
||||||
# the following variable contain our macro diffs:
|
# the following variables contain our macro definitions:
|
||||||
#
|
#
|
||||||
required_defs=""
|
required_defs=""
|
||||||
required_undefs=""
|
required_undefs=""
|
||||||
@@ -25,7 +25,7 @@ Be patient - this could take some time...
|
|||||||
|
|
||||||
Note that this test script only gives an approximate
|
Note that this test script only gives an approximate
|
||||||
configuration - you will need to test the results carefully
|
configuration - you will need to test the results carefully
|
||||||
using the boost regresion test suite before using the results.
|
using the boost regression test suite before using the results.
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
if test $enable_test = 'yes'; then
|
if test $enable_test = 'yes'; then
|
||||||
@@ -33,8 +33,8 @@ if test $enable_test = 'yes'; then
|
|||||||
cat << EOF
|
cat << EOF
|
||||||
|
|
||||||
This script reports only the difference between the detected
|
This script reports only the difference between the detected
|
||||||
configuration, and the existing boost configuration. It's
|
configuration, and the existing boost configuration. Its
|
||||||
primary aim is to quicky report how well boost is configured
|
primary aim is to quickly report how well boost is configured
|
||||||
for one compiler.
|
for one compiler.
|
||||||
|
|
||||||
***
|
***
|
||||||
@@ -401,7 +401,7 @@ EEEOF
|
|||||||
cat << EEEOF
|
cat << EEEOF
|
||||||
|
|
||||||
Adjustments to boost configuration have been written to
|
Adjustments to boost configuration have been written to
|
||||||
user.hpp, copy this to boost/config/user.hpp to use "as is",
|
user.hpp. Copy this to boost/config/user.hpp to use "as is",
|
||||||
or define BOOST_SITE_CONFIG to point to its location.
|
or define BOOST_SITE_CONFIG to point to its location.
|
||||||
|
|
||||||
TREAT THIS FILE WITH CARE.
|
TREAT THIS FILE WITH CARE.
|
||||||
|
Reference in New Issue
Block a user