Strengthened admonishment and rebuilt docs.

[SVN r40656]
2007-11-01 18:26:07 +00:00
parent 2c9e75db4e
commit 39c3bcc227
6 changed files with 64 additions and 43 deletions
@@ -23,7 +23,8 @@
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_config.acknowledgements"></a><a href="acknowledgements.html" title="Acknowledgements">Acknowledgements</a></h2></div></div></div>
+<a name="boost_config.acknowledgements"></a><a href="acknowledgements.html" title="Acknowledgements">Acknowledgements</a>
+</h2></div></div></div>
 <p>
      Beman Dawes provided the original <code class="computeroutput"><span class="identifier">config</span><span class="special">.</span><span class="identifier">hpp</span></code> and
      part of this document.
@@ -24,7 +24,8 @@
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_config.boost_macro_reference"></a><a href="boost_macro_reference.html" title="Boost Macro Reference">Boost Macro Reference</a></h2></div></div></div>
+<a name="boost_config.boost_macro_reference"></a><a href="boost_macro_reference.html" title="Boost Macro Reference">Boost Macro Reference</a>
+</h2></div></div></div>
 <div class="toc"><dl>
 <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_defects">Macros
      that describe defects</a></span></dt>
@@ -44,7 +45,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.boost_macro_reference.macros_that_describe_defects"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_defects" title="Macros that describe defects">Macros
-      that describe defects</a></h3></div></div></div>
+      that describe defects</a>
+</h3></div></div></div>
 <p>
        The following macros all describe features that are required by the C++ standard,
        if one of the following macros is defined, then it represents a defect in
@@ -1152,7 +1154,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.boost_macro_reference.macros_that_describe_optional_features"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_optional_features" title="Macros that describe optional features">Macros
-      that describe optional features</a></h3></div></div></div>
+      that describe optional features</a>
+</h3></div></div></div>
 <p>
        The following macros describe features that are not required by the C++ standard.
        The macro is only defined if the feature is present.
@@ -2059,7 +2062,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.boost_macro_reference.macros_that_describe_c__0x_features"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_that_describe_c__0x_features" title="Macros that describe C++0x features">Macros
-      that describe C++0x features</a></h3></div></div></div>
+      that describe C++0x features</a>
+</h3></div></div></div>
 <p>
        The following macros describe features that are likely to be included in
        the upcoming ISO C++ standard, C++0x.
@@ -2163,7 +2167,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.boost_macro_reference.boost_helper_macros"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_helper_macros" title="Boost Helper Macros">Boost
-      Helper Macros</a></h3></div></div></div>
+      Helper Macros</a>
+</h3></div></div></div>
 <p>
        The following macros are either simple helpers, or macros that provide workarounds
        for compiler/standard library defects.
@@ -2459,7 +2464,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.boost_macro_reference.boost_informational_macros"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.boost_informational_macros" title="Boost Informational Macros">Boost
-      Informational Macros</a></h3></div></div></div>
+      Informational Macros</a>
+</h3></div></div></div>
 <p>
        The following macros describe boost features; these are, generally speaking
        the only boost macros that should be tested in user code.
@@ -2697,7 +2703,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code" title="Macros for libraries with separate source code">Macros
-      for libraries with separate source code</a></h3></div></div></div>
+      for libraries with separate source code</a>
+</h3></div></div></div>
 <div class="toc"><dl>
 <dt><span class="section"><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.abi_fixing">ABI
        Fixing</a></span></dt>
@@ -2713,7 +2720,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h4 class="title">
 <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.abi_fixing"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.abi_fixing" title="ABI Fixing">ABI
-        Fixing</a></h4></div></div></div>
+        Fixing</a>
+</h4></div></div></div>
 <p>
          When linking against a pre-compiled library it vital that the ABI used
          by the compiler when building the library <span class="emphasis"><em>matches exactly</em></span>
@@ -2772,7 +2780,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h4 class="title">
 <a name="boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.automatic_library_selection"></a><a href="boost_macro_reference.html#boost_config.boost_macro_reference.macros_for_libraries_with_separate_source_code.automatic_library_selection" title="Automatic library selection">Automatic
-        library selection</a></h4></div></div></div>
+        library selection</a>
+</h4></div></div></div>
 <p>
          It is essential that users link to a build of a library which was built
          against the same runtime library that their application will be built against
@@ -25,7 +25,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="boost_config.guidelines_for_boost_authors"></a><a href="guidelines_for_boost_authors.html" title="Guidelines for Boost Authors">Guidelines for
-    Boost Authors</a></h2></div></div></div>
+    Boost Authors</a>
+</h2></div></div></div>
 <div class="toc"><dl>
 <dt><span class="section"><a href="guidelines_for_boost_authors.html#boost_config.guidelines_for_boost_authors.adding_new_defect_macros">Adding
      New Defect Macros</a></span></dt>
@@ -103,7 +104,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.guidelines_for_boost_authors.adding_new_defect_macros"></a><a href="guidelines_for_boost_authors.html#boost_config.guidelines_for_boost_authors.adding_new_defect_macros" title="Adding New Defect Macros">Adding
-      New Defect Macros</a></h3></div></div></div>
+      New Defect Macros</a>
+</h3></div></div></div>
 <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
@@ -204,7 +206,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.guidelines_for_boost_authors.adding_new_feature_test_macros"></a><a href="guidelines_for_boost_authors.html#boost_config.guidelines_for_boost_authors.adding_new_feature_test_macros" title="Adding New Feature Test Macros">Adding
-      New Feature Test Macros</a></h3></div></div></div>
+      New Feature Test Macros</a>
+</h3></div></div></div>
 <p>
        When you need to add a macro that describes a feature that the standard does
        not require, follow the convention for adding a new defect macro (above),
@@ -227,7 +230,8 @@
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
 <a name="boost_config.guidelines_for_boost_authors.modifying_the_boost_configuration_headers"></a><a href="guidelines_for_boost_authors.html#boost_config.guidelines_for_boost_authors.modifying_the_boost_configuration_headers" title="Modifying the Boost Configuration Headers">Modifying
-      the Boost Configuration Headers</a></h3></div></div></div>
+      the Boost Configuration Headers</a>
+</h3></div></div></div>
 <p>
        The aim of boost's configuration setup is that the configuration headers
        should be relatively stable - a boost user should not have to recompile their
@@ -24,7 +24,8 @@
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="boost_config.rationale"></a><a href="rationale.html" title="Rationale">Rationale</a></h2></div></div></div>
+<a name="boost_config.rationale"></a><a href="rationale.html" title="Rationale">Rationale</a>
+</h2></div></div></div>
 <div class="toc"><dl>
 <dt><span class="section"><a href="rationale.html#boost_config.rationale.the_problem">The problem</a></span></dt>
 <dt><span class="section"><a href="rationale.html#boost_config.rationale.the_solution">The solution</a></span></dt>
@@ -40,7 +41,8 @@
    </p>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="boost_config.rationale.the_problem"></a><a href="rationale.html#boost_config.rationale.the_problem" title="The problem">The problem</a></h3></div></div></div>
+<a name="boost_config.rationale.the_problem"></a><a href="rationale.html#boost_config.rationale.the_problem" title="The problem">The problem</a>
+</h3></div></div></div>
 <p>
        Consider a situation in which you are concurrently developing on multiple
        platforms. Then consider adding a new platform or changing the platform definitions
@@ -102,7 +104,8 @@
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="boost_config.rationale.the_solution"></a><a href="rationale.html#boost_config.rationale.the_solution" title="The solution">The solution</a></h3></div></div></div>
+<a name="boost_config.rationale.the_solution"></a><a href="rationale.html#boost_config.rationale.the_solution" title="The solution">The solution</a>
+</h3></div></div></div>
 <p>
        The approach taken by boost's configuration headers is to separate configuration
        into three orthogonal parts: the compiler, the standard library and the platform.