boostorg/predef
1
0
Fork 1
mirror of https://github.com/boostorg/predef.git synced 2025-07-30 19:57:14 +02:00
Code Issues Packages Projects Releases Wiki Activity

[tree] Fix some documentation typos. Add explanation of date to vnum decomposition.

Browse Source 
git-svn-id: http://svn.boost.org/svn/boost/sandbox/predef@76967 b8fc166d-592f-0410-95f2-cb63ce0dd405
This commit is contained in:
Rene Rivera
2012-02-11 01:47:43 +00:00
parent 8565fbb7cf
commit 4f4e109ab5
7 changed files with 46 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
boost/predef/make.h
View File

@ -74,7 +74,13 @@ and "`0`" indicates an ignored decimal digit. Macros are:
#define BOOST_PREDEF_MAKE_NN_NN_0_NNNN(V) BOOST_VERSION_NUMBER(((V)/10000000)%100,((V)/100000)%100,(V)%10000) #define BOOST_PREDEF_MAKE_NN_NN_0_NNNN(V) BOOST_VERSION_NUMBER(((V)/10000000)%100,((V)/100000)%100,(V)%10000)
/*` `BOOST_PREDEF_MAKE_NN_NN_00_NN_00(V)` */ /*` `BOOST_PREDEF_MAKE_NN_NN_00_NN_00(V)` */
#define BOOST_PREDEF_MAKE_NN_NN_00_NN_00(V) BOOST_VERSION_NUMBER(((V)/100000000)%100,((V)/1000000)%100,((V)/100)%100) #define BOOST_PREDEF_MAKE_NN_NN_00_NN_00(V) BOOST_VERSION_NUMBER(((V)/100000000)%100,((V)/1000000)%100,((V)/100)%100)
/*` `BOOST_PREDEF_MAKE_YYYY_MM_DD(V)` */ /*`
`BOOST_PREDEF_MAKE_YYYY_MM_DD(V)`
The date decomposition returns a date in the form
`BOOST_VERSION_NUMBER(YYYY-1970,MM,DD)`. I.e. a date relative to the 1970
Epoch date.
*/
#define BOOST_PREDEF_MAKE_YYYY_MM_DD(V) BOOST_VERSION_NUMBER(((V)/10000)%10000-1970,((V)/100)%100,(V)%100) #define BOOST_PREDEF_MAKE_YYYY_MM_DD(V) BOOST_VERSION_NUMBER(((V)/10000)%10000-1970,((V)/100)%100,(V)%100)
#endif #endif

2
libs/predef/doc/html/index.html
View File

@ -59,7 +59,7 @@
</table></div> </table></div>
</div> </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"><p><small>Last revised: December 15, 2011 at 03:47:03 GMT</small></p></td> <td align="left"><p><small>Last revised: February 10, 2012 at 14:55:42 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td> <td align="right"><div class="copyright-footer"></div></td>
</tr></table> </tr></table>
<hr> <hr>

12
libs/predef/doc/html/predef/adding_new_predefs.html
View File

@ -13,7 +13,7 @@
<div class="spirit-nav"> <div class="spirit-nav">
<a accesskey="p" href="using_the_predefs.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="reference.html"><img src="../images/next.png" alt="Next"></a> <a accesskey="p" href="using_the_predefs.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="reference.html"><img src="../images/next.png" alt="Next"></a>
</div> </div>
<div class="section"> <div class="section predef_adding_new_predefs">
<div class="titlepage"><div><div><h2 class="title" style="clear: both"> <div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="predef.adding_new_predefs"></a><a class="link" href="adding_new_predefs.html" title="Adding new predefs">Adding new predefs</a> <a name="predef.adding_new_predefs"></a><a class="link" href="adding_new_predefs.html" title="Adding new predefs">Adding new predefs</a>
</h2></div></div></div> </h2></div></div></div>
@ -65,7 +65,7 @@
if possible. if possible.
</li> </li>
<li class="listitem"> <li class="listitem">
If the detection must include a headers unconditionally, and has a choice If the detection must include headers unconditionally, and has a choice
of headers to include, prefer the ones with the least impact. I.e. include of headers to include, prefer the ones with the least impact. I.e. include
the one with the minimal set of definitions and other dependencies. the one with the minimal set of definitions and other dependencies.
</li> </li>
@ -118,8 +118,8 @@ Documentation about what is detected.
<p> <p>
Next is the detection and definition of the particular predef. The structure Next is the detection and definition of the particular predef. The structure
for this is to do a single overall check (<code class="computeroutput"><span class="identifier">condition_a</span></code>) for this is to do a single overall check (<code class="computeroutput"><span class="identifier">condition_a</span></code>)
and place the further version detection inside this. The first action inside and place further version detection inside this. The first action inside the
the overall check is to "<code class="computeroutput"><span class="preprocessor">#undef</span> overall check is to "<code class="computeroutput"><span class="preprocessor">#undef</span>
<span class="identifier">BOOST_category_tag</span></code>" which undefines <span class="identifier">BOOST_category_tag</span></code>" which undefines
the zero-value default. The rest is up to the you how to do the checks for the zero-value default. The rest is up to the you how to do the checks for
defining the version. But at minimum it must "<code class="computeroutput"><span class="preprocessor">#define</span> defining the version. But at minimum it must "<code class="computeroutput"><span class="preprocessor">#define</span>
@ -139,7 +139,7 @@ Documentation about what is detected.
The testing of the predef macros is automated to generate checks for all the The testing of the predef macros is automated to generate checks for all the
defined predefs, whether detected or not. To do this we need to declare the defined predefs, whether detected or not. To do this we need to declare the
predef to the test system. This declaration is empty for regular use. And during predef to the test system. This declaration is empty for regular use. And during
the test programs theexpand out specially to create informational output: the test programs they expand out specially to create informational output:
</p> </p>
<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">predef</span><span class="special">/</span><span class="identifier">detail</span><span class="special">/</span><span class="identifier">test</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span> <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">predef</span><span class="special">/</span><span class="identifier">detail</span><span class="special">/</span><span class="identifier">test</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span>
<span class="identifier">BOOST_PREDEF_DECLARE_TEST</span><span class="special">(</span><span class="identifier">BOOST_category_tag</span><span class="special">,</span><span class="string">"Name"</span><span class="special">)</span> <span class="identifier">BOOST_PREDEF_DECLARE_TEST</span><span class="special">(</span><span class="identifier">BOOST_category_tag</span><span class="special">,</span><span class="string">"Name"</span><span class="special">)</span>
@ -160,7 +160,7 @@ Documentation about what is detected.
<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">predef</span><span class="special">/</span><span class="identifier">make</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span> <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">predef</span><span class="special">/</span><span class="identifier">make</span><span class="special">.</span><span class="identifier">h</span><span class="special">&gt;</span>
</pre> </pre>
<p> <p>
One will get a set utlity macros to decompose common version macros as defined One will get a set of utlity macros to decompose common version macros as defined
by compilers. For example the EDG compiler uses a simple 3-digit version macro by compilers. For example the EDG compiler uses a simple 3-digit version macro
(M,N,P). It can be decomesed and defined as: (M,N,P). It can be decomesed and defined as:
</p> </p>

16
libs/predef/doc/html/predef/introduction.html
View File

@ -13,7 +13,7 @@
<div class="spirit-nav"> <div class="spirit-nav">
<a accesskey="p" href="../index.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="using_the_predefs.html"><img src="../images/next.png" alt="Next"></a> <a accesskey="p" href="../index.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="using_the_predefs.html"><img src="../images/next.png" alt="Next"></a>
</div> </div>
<div class="section"> <div class="section predef_introduction">
<div class="titlepage"><div><div><h2 class="title" style="clear: both"> <div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="predef.introduction"></a><a class="link" href="introduction.html" title="Introduction">Introduction</a> <a name="predef.introduction"></a><a class="link" href="introduction.html" title="Introduction">Introduction</a>
</h2></div></div></div> </h2></div></div></div>
@ -40,13 +40,12 @@
the version number of boost itself). the version number of boost itself).
</li> </li>
<li class="listitem"> <li class="listitem">
A compiler identification macro, suitable for use in #if/#elif directives, A compiler identification macro, suitable for use in <code class="computeroutput"><span class="preprocessor">#if</span></code>/<code class="computeroutput"><span class="preprocessor">#elif</span></code> directives, for each of the supported
for each of the supported compilers. All macros would be defined, regardless compilers. All macros would be defined, regardless of the compiler. The
of the compiler. The one macro corresponding to the compiler being used one macro corresponding to the compiler being used would be defined, in
would be defined, in terms of BOOST_VERSION_NUMBER, to carry the exact terms of BOOST_VERSION_NUMBER, to carry the exact compiler version. All
compiler version. All other macros would expand to an expression evaluating other macros would expand to an expression evaluating to false (for instance,
to false (for instance, the token 0) to indicate that the corresponding the token 0) to indicate that the corresponding compiler is not present.
compiler is not present.
</li> </li>
<li class="listitem"> <li class="listitem">
"Null values" could be set, for all macros, in boost/config/select_compiler.hpp; "Null values" could be set, for all macros, in boost/config/select_compiler.hpp;
@ -54,7 +53,6 @@
#undef and re-#defined in the corresponding boost/compiler/(cc).hpp; however #undef and re-#defined in the corresponding boost/compiler/(cc).hpp; however
in the context of the Boost.Config infrastructure using a "prefix" in the context of the Boost.Config infrastructure using a "prefix"
header (to be introduced) or boost/config/suffix.hpp is a better solution. header (to be introduced) or boost/config/suffix.hpp is a better solution.
This point is further clarified later.
</li> </li>
</ul></div> </ul></div>
<h4> <h4>

18
libs/predef/doc/html/predef/reference.html
View File

@ -12,7 +12,7 @@
<div class="spirit-nav"> <div class="spirit-nav">
<a accesskey="p" href="adding_new_predefs.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a> <a accesskey="p" href="adding_new_predefs.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a>
</div> </div>
<div class="section"> <div class="section predef_reference">
<div class="titlepage"><div><div><h2 class="title" style="clear: both"> <div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="predef.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a> <a name="predef.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a>
</h2></div></div></div> </h2></div></div></div>
@ -26,7 +26,7 @@
<dt><span class="section"><a href="reference.html#predef.reference.version_definition_macros">Version definition <dt><span class="section"><a href="reference.html#predef.reference.version_definition_macros">Version definition
macros</a></span></dt> macros</a></span></dt>
</dl></div> </dl></div>
<div class="section"> <div class="section predef_reference_boost_architecture_architecture_">
<div class="titlepage"><div><div><h3 class="title"> <div class="titlepage"><div><div><h3 class="title">
<a name="predef.reference.boost_architecture_architecture_"></a><a class="link" href="reference.html#predef.reference.boost_architecture_architecture_" title="BOOST_ARCHITECTURE_ architecture macros"><code class="computeroutput"><span class="identifier">BOOST_ARCHITECTURE_</span></code> architecture macros</a> <a name="predef.reference.boost_architecture_architecture_"></a><a class="link" href="reference.html#predef.reference.boost_architecture_architecture_" title="BOOST_ARCHITECTURE_ architecture macros"><code class="computeroutput"><span class="identifier">BOOST_ARCHITECTURE_</span></code> architecture macros</a>
</h3></div></div></div> </h3></div></div></div>
@ -158,7 +158,7 @@
architecture. architecture.
</p> </p>
</div> </div>
<div class="section"> <div class="section predef_reference_boost_cxx_compiler_macros">
<div class="titlepage"><div><div><h3 class="title"> <div class="titlepage"><div><div><h3 class="title">
<a name="predef.reference.boost_cxx_compiler_macros"></a><a class="link" href="reference.html#predef.reference.boost_cxx_compiler_macros" title="BOOST_CXX_ compiler macros"><code class="computeroutput"><span class="identifier">BOOST_CXX_</span></code> compiler macros</a> <a name="predef.reference.boost_cxx_compiler_macros"></a><a class="link" href="reference.html#predef.reference.boost_cxx_compiler_macros" title="BOOST_CXX_ compiler macros"><code class="computeroutput"><span class="identifier">BOOST_CXX_</span></code> compiler macros</a>
</h3></div></div></div> </h3></div></div></div>
@ -403,7 +403,7 @@
Version number available as major, and minor. Version number available as major, and minor.
</p> </p>
</div> </div>
<div class="section"> <div class="section predef_reference_boost_language_language_standard">
<div class="titlepage"><div><div><h3 class="title"> <div class="titlepage"><div><div><h3 class="title">
<a name="predef.reference.boost_language_language_standard"></a><a class="link" href="reference.html#predef.reference.boost_language_language_standard" title="BOOST_LANGUAGE_ language standards macros"><code class="computeroutput"><span class="identifier">BOOST_LANGUAGE_</span></code> language standards macros</a> <a name="predef.reference.boost_language_language_standard"></a><a class="link" href="reference.html#predef.reference.boost_language_language_standard" title="BOOST_LANGUAGE_ language standards macros"><code class="computeroutput"><span class="identifier">BOOST_LANGUAGE_</span></code> language standards macros</a>
</h3></div></div></div> </h3></div></div></div>
@ -549,7 +549,7 @@
C++</a> language. C++</a> language.
</p> </p>
</div> </div>
<div class="section"> <div class="section predef_reference_boost_libc_and_boost_libstd_libr">
<div class="titlepage"><div><div><h3 class="title"> <div class="titlepage"><div><div><h3 class="title">
<a name="predef.reference.boost_libc_and_boost_libstd_libr"></a><a class="link" href="reference.html#predef.reference.boost_libc_and_boost_libstd_libr" title="BOOST_LIBC_ and BOOST_LIBSTD_ library macros"><code class="computeroutput"><span class="identifier">BOOST_LIBC_</span></code> and <code class="computeroutput"><span class="identifier">BOOST_LIBSTD_</span></code> <a name="predef.reference.boost_libc_and_boost_libstd_libr"></a><a class="link" href="reference.html#predef.reference.boost_libc_and_boost_libstd_libr" title="BOOST_LIBC_ and BOOST_LIBSTD_ library macros"><code class="computeroutput"><span class="identifier">BOOST_LIBC_</span></code> and <code class="computeroutput"><span class="identifier">BOOST_LIBSTD_</span></code>
library macros</a> library macros</a>
@ -667,7 +667,7 @@
C++</a> library. C++</a> library.
</p> </p>
</div> </div>
<div class="section"> <div class="section predef_reference_boost_os_operating_system_macros">
<div class="titlepage"><div><div><h3 class="title"> <div class="titlepage"><div><div><h3 class="title">
<a name="predef.reference.boost_os_operating_system_macros"></a><a class="link" href="reference.html#predef.reference.boost_os_operating_system_macros" title="BOOST_OS_ operating system macros"><code class="computeroutput"><span class="identifier">BOOST_OS_</span></code> operating system macros</a> <a name="predef.reference.boost_os_operating_system_macros"></a><a class="link" href="reference.html#predef.reference.boost_os_operating_system_macros" title="BOOST_OS_ operating system macros"><code class="computeroutput"><span class="identifier">BOOST_OS_</span></code> operating system macros</a>
</h3></div></div></div> </h3></div></div></div>
@ -830,7 +830,7 @@
Windows</a> operating system. Windows</a> operating system.
</p> </p>
</div> </div>
<div class="section"> <div class="section predef_reference_version_definition_macros">
<div class="titlepage"><div><div><h3 class="title"> <div class="titlepage"><div><div><h3 class="title">
<a name="predef.reference.version_definition_macros"></a><a class="link" href="reference.html#predef.reference.version_definition_macros" title="Version definition macros">Version definition <a name="predef.reference.version_definition_macros"></a><a class="link" href="reference.html#predef.reference.version_definition_macros" title="Version definition macros">Version definition
macros</a> macros</a>
@ -964,6 +964,10 @@
<p> <p>
<code class="computeroutput"><span class="identifier">BOOST_PREDEF_MAKE_YYYY_MM_DD</span><span class="special">(</span><span class="identifier">V</span><span class="special">)</span></code> <code class="computeroutput"><span class="identifier">BOOST_PREDEF_MAKE_YYYY_MM_DD</span><span class="special">(</span><span class="identifier">V</span><span class="special">)</span></code>
</p> </p>
<p>
The date decomposition returns a date in the form <code class="computeroutput"><span class="identifier">BOOST_VERSION_NUMBER</span><span class="special">(</span><span class="identifier">YYYY</span><span class="special">-</span><span class="number">1970</span><span class="special">,</span><span class="identifier">MM</span><span class="special">,</span><span class="identifier">DD</span><span class="special">)</span></code>.
I.e. a date relative to the 1970 Epoch date.
</p>
</div> </div>
</div> </div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

10
libs/predef/doc/html/predef/using_the_predefs.html
View File

@ -13,7 +13,7 @@
<div class="spirit-nav"> <div class="spirit-nav">
<a accesskey="p" href="introduction.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="adding_new_predefs.html"><img src="../images/next.png" alt="Next"></a> <a accesskey="p" href="introduction.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="adding_new_predefs.html"><img src="../images/next.png" alt="Next"></a>
</div> </div>
<div class="section"> <div class="section predef_using_the_predefs">
<div class="titlepage"><div><div><h2 class="title" style="clear: both"> <div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="predef.using_the_predefs"></a><a class="link" href="using_the_predefs.html" title="Using the predefs">Using the predefs</a> <a name="predef.using_the_predefs"></a><a class="link" href="using_the_predefs.html" title="Using the predefs">Using the predefs</a>
</h2></div></div></div> </h2></div></div></div>
@ -27,8 +27,8 @@
This defines <span class="bold"><strong>all</strong></span> the version macros known This defines <span class="bold"><strong>all</strong></span> the version macros known
to the library. For each macro it will be defined to either a <span class="emphasis"><em>zero</em></span> to the library. For each macro it will be defined to either a <span class="emphasis"><em>zero</em></span>
valued expression for when the particular item is not detected, and to a <span class="emphasis"><em>positive</em></span> valued expression for when the particular item is not detected, and to a <span class="emphasis"><em>positive</em></span>
value if it is detected. The predef macros fall onto the five categories each value if it is detected. The predef macros fall onto five categories each with
with macros of a particular prefix: macros of a particular prefix:
</p> </p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc"> <div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"> <li class="listitem">
@ -83,7 +83,7 @@
</pre> </pre>
<p> <p>
As you might notice above the <code class="computeroutput"><span class="keyword">else</span></code> As you might notice above the <code class="computeroutput"><span class="keyword">else</span></code>
clause also covers the case where we the particular compiler is not detected. clause also covers the case where the particular compiler is not detected.
But one can make the test specifically test for the detection. All predef definitions But one can make the test specifically test for the detection. All predef definitions
are defined as a zero (0) expression when not detected. Hence one could use are defined as a zero (0) expression when not detected. Hence one could use
the detection with a natural single condition. For example: the detection with a natural single condition. For example:
@ -153,7 +153,7 @@
The ranges for each are "enforced" by the use of a modulo ("%"), The ranges for each are "enforced" by the use of a modulo ("%"),
i.e. truncation, as opposed to a clamp. And hence this means that the limits i.e. truncation, as opposed to a clamp. And hence this means that the limits
are enforced only enough to keep from having out-of-range problems. But not are enforced only enough to keep from having out-of-range problems. But not
enough to prevent other kinds of problems. Like exceeding the range and geting enough to prevent other kinds of problems. Like exceeding the range and getting
false detections, or non-detections. It is up to the individual predefs to false detections, or non-detections. It is up to the individual predefs to
ensure correct usage beyond the range guarantee. ensure correct usage beyond the range guarantee.
</p> </p>

19
libs/predef/doc/predef.qbk
View File

@ -33,7 +33,7 @@ consistently represent their version. This includes:
* A unique BOOST_VERSION_NUMBER(major,minor,patch) macro to specify version * A unique BOOST_VERSION_NUMBER(major,minor,patch) macro to specify version
numbers (unfortunately, the name BOOST_VERSION is already taken to designate numbers (unfortunately, the name BOOST_VERSION is already taken to designate
the version number of boost itself). the version number of boost itself).
* A compiler identification macro, suitable for use in #if/#elif directives, * A compiler identification macro, suitable for use in `#if`/`#elif` directives,
for each of the supported compilers. All macros would be defined, regardless for each of the supported compilers. All macros would be defined, regardless
of the compiler. The one macro corresponding to the compiler being used would of the compiler. The one macro corresponding to the compiler being used would
be defined, in terms of BOOST_VERSION_NUMBER, to carry the exact compiler be defined, in terms of BOOST_VERSION_NUMBER, to carry the exact compiler
@ -45,8 +45,7 @@ consistently represent their version. This includes:
identification macro would be #undef and re-#defined in the corresponding identification macro would be #undef and re-#defined in the corresponding
boost/compiler/(cc).hpp; however in the context of the Boost.Config boost/compiler/(cc).hpp; however in the context of the Boost.Config
infrastructure using a "prefix" header (to be introduced) or infrastructure using a "prefix" header (to be introduced) or
boost/config/suffix.hpp is a better solution. This point is further boost/config/suffix.hpp is a better solution.
clarified later.
[heading Current Library] [heading Current Library]
@ -131,7 +130,7 @@ single top-level header:
This defines [*all] the version macros known to the library. For each This defines [*all] the version macros known to the library. For each
macro it will be defined to either a /zero/ valued expression for when macro it will be defined to either a /zero/ valued expression for when
the particular item is not detected, and to a /positive/ value if it the particular item is not detected, and to a /positive/ value if it
is detected. The predef macros fall onto the five categories each with is detected. The predef macros fall onto five categories each with
macros of a particular prefix: macros of a particular prefix:
* `BOOST_ARCHITECTURE_`for system/CPU architecture one is compiling for. * `BOOST_ARCHITECTURE_`for system/CPU architecture one is compiling for.
@ -164,7 +163,7 @@ a choice based on the version of the GCC C++ compiler one would:
`` ``
As you might notice above the `else` clause also covers the case where As you might notice above the `else` clause also covers the case where
we the particular compiler is not detected. But one can make the test the particular compiler is not detected. But one can make the test
specifically test for the detection. All predef definitions are defined specifically test for the detection. All predef definitions are defined
as a zero (0) expression when not detected. Hence one could use the as a zero (0) expression when not detected. Hence one could use the
detection with a natural single condition. For example: detection with a natural single condition. For example:
@ -226,7 +225,7 @@ The arguments are:
The ranges for each are "enforced" by the use of a modulo ("%"), i.e. truncation, The ranges for each are "enforced" by the use of a modulo ("%"), i.e. truncation,
as opposed to a clamp. And hence this means that the limits are enforced only as opposed to a clamp. And hence this means that the limits are enforced only
enough to keep from having out-of-range problems. But not enough to prevent enough to keep from having out-of-range problems. But not enough to prevent
other kinds of problems. Like exceeding the range and geting false detections, other kinds of problems. Like exceeding the range and getting false detections,
or non-detections. It is up to the individual predefs to ensure correct or non-detections. It is up to the individual predefs to ensure correct
usage beyond the range guarantee. usage beyond the range guarantee.
@ -274,7 +273,7 @@ And there are some extra guidelines that predef headers should follow:
not be included by default. not be included by default.
* If the detection must include a header, prefer guarding it within the * If the detection must include a header, prefer guarding it within the
detection if possible. detection if possible.
* If the detection must include a headers unconditionally, and has a choice * If the detection must include headers unconditionally, and has a choice
of headers to include, prefer the ones with the least impact. I.e. of headers to include, prefer the ones with the least impact. I.e.
include the one with the minimal set of definitions and other include the one with the minimal set of definitions and other
dependencies. dependencies.
@ -327,7 +326,7 @@ Documentation about what is detected.
Next is the detection and definition of the particular predef. The Next is the detection and definition of the particular predef. The
structure for this is to do a single overall check (`condition_a`) and structure for this is to do a single overall check (`condition_a`) and
place the further version detection inside this. The first action inside place further version detection inside this. The first action inside
the overall check is to "`#undef BOOST_category_tag`" which undefines the overall check is to "`#undef BOOST_category_tag`" which undefines
the zero-value default. The rest is up to the you how to do the checks the zero-value default. The rest is up to the you how to do the checks
for defining the version. But at minimum it must for defining the version. But at minimum it must
@ -348,7 +347,7 @@ to minimally indicate that the predef was detected:
The testing of the predef macros is automated to generate checks for all The testing of the predef macros is automated to generate checks for all
the defined predefs, whether detected or not. To do this we need to the defined predefs, whether detected or not. To do this we need to
declare the predef to the test system. This declaration is empty for declare the predef to the test system. This declaration is empty for
regular use. And during the test programs theexpand out specially regular use. And during the test programs they expand out specially
to create informational output: to create informational output:
`` ``
@ -370,7 +369,7 @@ By including:
#include <boost/predef/make.h> #include <boost/predef/make.h>
`` ``
One will get a set utlity macros to decompose common version One will get a set of utlity macros to decompose common version
macros as defined by compilers. For example the EDG compiler macros as defined by compilers. For example the EDG compiler
uses a simple 3-digit version macro (M,N,P). It can be decomesed uses a simple 3-digit version macro (M,N,P). It can be decomesed
and defined as: and defined as: