From 45df00109414cd77cd0bce0ffdf8d8667fd048ae Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Wed, 30 Nov 2011 05:54:23 +0000 Subject: [PATCH] Another cleanup pass.. And a first pass at documentation. git-svn-id: http://svn.boost.org/svn/boost/sandbox/predef@75741 b8fc166d-592f-0410-95f2-cb63ce0dd405 --- boost/predef/compiler/borland.h | 9 +- boost/predef/compiler/comeau.h | 9 +- boost/predef/compiler/compaq.h | 9 +- boost/predef/compiler/cygwin.h | 8 +- boost/predef/compiler/diab.h | 9 +- boost/predef/compiler/digitalmars.h | 9 +- boost/predef/compiler/dignus.h | 9 +- boost/predef/compiler/edg.h | 9 +- boost/predef/compiler/ekopath.h | 9 +- boost/predef/compiler/gcc.h | 11 +- boost/predef/compiler/gcc_xml.h | 8 +- boost/predef/compiler/greenhills.h | 9 +- boost/predef/compiler/hp_acc.h | 9 +- boost/predef/compiler/iar.h | 9 +- boost/predef/compiler/ibm.h | 9 +- boost/predef/compiler/intel.h | 9 +- boost/predef/compiler/kai.h | 9 +- boost/predef/compiler/llvm.h | 8 +- boost/predef/compiler/metaware.h | 8 +- boost/predef/compiler/metrowerks.h | 35 +- boost/predef/compiler/microtec.h | 8 +- boost/predef/compiler/mingw.h | 9 +- boost/predef/compiler/mpw.h | 9 +- boost/predef/compiler/palm.h | 9 +- boost/predef/compiler/pgi.h | 8 +- boost/predef/compiler/sgi_mipspro.h | 9 +- boost/predef/compiler/sunpro.h | 9 +- boost/predef/compiler/tendra.h | 8 +- boost/predef/compiler/visualc.h | 9 +- boost/predef/compiler/watcom.h | 9 +- boost/predef/language/objc.h | 4 +- boost/predef/language/stdc.h | 4 +- boost/predef/language/stdcpp.h | 21 +- boost/predef/library/c/gnu.h | 9 +- boost/predef/library/c/uc.h | 9 +- boost/predef/library/c/vms.h | 9 +- boost/predef/library/c/zos.h | 19 +- boost/predef/library/std.h | 5 +- boost/predef/library/std/cxx.h | 31 + boost/predef/library/std/dinkumware.h | 9 +- boost/predef/library/std/libcomo.h | 11 +- boost/predef/library/std/modena.h | 10 +- boost/predef/library/std/msl.h | 9 +- boost/predef/library/std/roguewave.h | 9 +- boost/predef/library/std/sgi.h | 9 +- boost/predef/library/std/stdcpp3.h | 13 +- boost/predef/library/std/stlport.h | 9 +- boost/predef/library/std/vacpp.h | 8 +- boost/predef/os/aix.h | 7 + boost/predef/os/amigaos.h | 10 +- boost/predef/os/beos.h | 8 +- boost/predef/os/bsd.h | 27 +- boost/predef/version_number.h | 10 +- libs/predef/doc/build.jam | 4 +- libs/predef/doc/html/boostbook.css | 646 +++++++++++++ libs/predef/doc/html/docutils.css | 275 ++++++ libs/predef/doc/html/images/alert.png | Bin 0 -> 603 bytes libs/predef/doc/html/images/blank.png | Bin 0 -> 374 bytes libs/predef/doc/html/images/callouts/1.png | Bin 0 -> 391 bytes libs/predef/doc/html/images/callouts/10.png | Bin 0 -> 485 bytes libs/predef/doc/html/images/callouts/11.png | Bin 0 -> 410 bytes libs/predef/doc/html/images/callouts/12.png | Bin 0 -> 488 bytes libs/predef/doc/html/images/callouts/13.png | Bin 0 -> 509 bytes libs/predef/doc/html/images/callouts/14.png | Bin 0 -> 499 bytes libs/predef/doc/html/images/callouts/15.png | Bin 0 -> 507 bytes libs/predef/doc/html/images/callouts/2.png | Bin 0 -> 446 bytes libs/predef/doc/html/images/callouts/3.png | Bin 0 -> 431 bytes libs/predef/doc/html/images/callouts/4.png | Bin 0 -> 441 bytes libs/predef/doc/html/images/callouts/5.png | Bin 0 -> 423 bytes libs/predef/doc/html/images/callouts/6.png | Bin 0 -> 431 bytes libs/predef/doc/html/images/callouts/7.png | Bin 0 -> 397 bytes libs/predef/doc/html/images/callouts/8.png | Bin 0 -> 434 bytes libs/predef/doc/html/images/callouts/9.png | Bin 0 -> 420 bytes libs/predef/doc/html/images/caution.png | Bin 0 -> 1250 bytes libs/predef/doc/html/images/draft.png | Bin 0 -> 17454 bytes libs/predef/doc/html/images/home.png | Bin 0 -> 358 bytes libs/predef/doc/html/images/important.png | Bin 0 -> 722 bytes libs/predef/doc/html/images/next.png | Bin 0 -> 336 bytes libs/predef/doc/html/images/next_disabled.png | Bin 0 -> 1110 bytes libs/predef/doc/html/images/note.png | Bin 0 -> 490 bytes libs/predef/doc/html/images/prev.png | Bin 0 -> 334 bytes libs/predef/doc/html/images/prev_disabled.png | Bin 0 -> 1109 bytes libs/predef/doc/html/images/smiley.png | Bin 0 -> 867 bytes libs/predef/doc/html/images/tip.png | Bin 0 -> 449 bytes libs/predef/doc/html/images/toc-blank.png | Bin 0 -> 318 bytes libs/predef/doc/html/images/toc-minus.png | Bin 0 -> 259 bytes libs/predef/doc/html/images/toc-plus.png | Bin 0 -> 264 bytes libs/predef/doc/html/images/up.png | Bin 0 -> 370 bytes libs/predef/doc/html/images/up_disabled.png | Bin 0 -> 1115 bytes libs/predef/doc/html/images/warning.png | Bin 0 -> 1241 bytes libs/predef/doc/html/index.html | 70 ++ libs/predef/doc/html/minimal.css | 22 + .../doc/html/predef/adding_new_predefs.html | 224 +++++ libs/predef/doc/html/predef/introduction.html | 199 ++++ libs/predef/doc/html/predef/reference.html | 875 ++++++++++++++++++ .../doc/html/predef/using_the_predefs.html | 218 +++++ libs/predef/doc/html/reference.css | 11 + libs/predef/doc/predef.qbk | 234 ++++- libs/predef/test/build.jam | 14 +- 99 files changed, 3214 insertions(+), 129 deletions(-) create mode 100644 boost/predef/library/std/cxx.h create mode 100644 libs/predef/doc/html/boostbook.css create mode 100644 libs/predef/doc/html/docutils.css create mode 100644 libs/predef/doc/html/images/alert.png create mode 100644 libs/predef/doc/html/images/blank.png create mode 100644 libs/predef/doc/html/images/callouts/1.png create mode 100644 libs/predef/doc/html/images/callouts/10.png create mode 100644 libs/predef/doc/html/images/callouts/11.png create mode 100644 libs/predef/doc/html/images/callouts/12.png create mode 100644 libs/predef/doc/html/images/callouts/13.png create mode 100644 libs/predef/doc/html/images/callouts/14.png create mode 100644 libs/predef/doc/html/images/callouts/15.png create mode 100644 libs/predef/doc/html/images/callouts/2.png create mode 100644 libs/predef/doc/html/images/callouts/3.png create mode 100644 libs/predef/doc/html/images/callouts/4.png create mode 100644 libs/predef/doc/html/images/callouts/5.png create mode 100644 libs/predef/doc/html/images/callouts/6.png create mode 100644 libs/predef/doc/html/images/callouts/7.png create mode 100644 libs/predef/doc/html/images/callouts/8.png create mode 100644 libs/predef/doc/html/images/callouts/9.png create mode 100644 libs/predef/doc/html/images/caution.png create mode 100644 libs/predef/doc/html/images/draft.png create mode 100644 libs/predef/doc/html/images/home.png create mode 100644 libs/predef/doc/html/images/important.png create mode 100644 libs/predef/doc/html/images/next.png create mode 100644 libs/predef/doc/html/images/next_disabled.png create mode 100644 libs/predef/doc/html/images/note.png create mode 100644 libs/predef/doc/html/images/prev.png create mode 100644 libs/predef/doc/html/images/prev_disabled.png create mode 100644 libs/predef/doc/html/images/smiley.png create mode 100644 libs/predef/doc/html/images/tip.png create mode 100644 libs/predef/doc/html/images/toc-blank.png create mode 100644 libs/predef/doc/html/images/toc-minus.png create mode 100644 libs/predef/doc/html/images/toc-plus.png create mode 100644 libs/predef/doc/html/images/up.png create mode 100644 libs/predef/doc/html/images/up_disabled.png create mode 100644 libs/predef/doc/html/images/warning.png create mode 100644 libs/predef/doc/html/index.html create mode 100644 libs/predef/doc/html/minimal.css create mode 100644 libs/predef/doc/html/predef/adding_new_predefs.html create mode 100644 libs/predef/doc/html/predef/introduction.html create mode 100644 libs/predef/doc/html/predef/reference.html create mode 100644 libs/predef/doc/html/predef/using_the_predefs.html create mode 100644 libs/predef/doc/html/reference.css diff --git a/boost/predef/compiler/borland.h b/boost/predef/compiler/borland.h index ff2b044..87283c6 100644 --- a/boost/predef/compiler/borland.h +++ b/boost/predef/compiler/borland.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_BORLAND`] + +[@http://en.wikipedia.org/wiki/XXX Borland] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_BORLAND BOOST_VERSION_NUMBER(0,0,0) #if defined(__BORLANDC__) diff --git a/boost/predef/compiler/comeau.h b/boost/predef/compiler/comeau.h index 97fd9be..361bca2 100644 --- a/boost/predef/compiler/comeau.h +++ b/boost/predef/compiler/comeau.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -13,6 +13,13 @@ http://www.boost.org/LICENSE_1_0.txt) #define BOOST_CXX_COMO BOOST_VERSION_NUMBER(0,0,0) +/*` +[heading `BOOST_CXX_COMO`] + +[@http://en.wikipedia.org/wiki/XXX Comeau] compiler. +Version number available as major, minor, and patch. + */ + #if defined(__COMO__) #undef BOOST_CXX_COMO #define BOOST_CXX_COMO BOOST_PREDEF_MAKE_F_F_FF(__COMO_VERSION__) diff --git a/boost/predef/compiler/compaq.h b/boost/predef/compiler/compaq.h index fc98d1f..14192f0 100644 --- a/boost/predef/compiler/compaq.h +++ b/boost/predef/compiler/compaq.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_DEC`] + +[@http://en.wikipedia.org/wiki/XXX Compaq DEC] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_DEC BOOST_VERSION_NUMBER(0,0,0) #if defined(__DECC) diff --git a/boost/predef/compiler/cygwin.h b/boost/predef/compiler/cygwin.h index efc320a..766d3cd 100644 --- a/boost/predef/compiler/cygwin.h +++ b/boost/predef/compiler/cygwin.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_CYGWIN`] + +[@http://en.wikipedia.org/wiki/XXX Cygwin] compiler. + */ + #define BOOST_CXX_CYGWIN BOOST_VERSION_NUMBER(0,0,0) #if defined(__CYGWIN__) diff --git a/boost/predef/compiler/diab.h b/boost/predef/compiler/diab.h index 1460348..90188cb 100644 --- a/boost/predef/compiler/diab.h +++ b/boost/predef/compiler/diab.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_DIAB`] + +[@http://en.wikipedia.org/wiki/XXX Diab] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_DIAB BOOST_VERSION_NUMBER(0,0,0) #if defined(__DCC__) diff --git a/boost/predef/compiler/digitalmars.h b/boost/predef/compiler/digitalmars.h index 01aa476..e918e1e 100644 --- a/boost/predef/compiler/digitalmars.h +++ b/boost/predef/compiler/digitalmars.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_DMC`] + +[@http://en.wikipedia.org/wiki/XXX Digital Mars] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_DMC BOOST_VERSION_NUMBER(0,0,0) #if defined(__DMC__) diff --git a/boost/predef/compiler/dignus.h b/boost/predef/compiler/dignus.h index fb3e9c2..a061fea 100644 --- a/boost/predef/compiler/dignus.h +++ b/boost/predef/compiler/dignus.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_SYSC`] + +[@http://en.wikipedia.org/wiki/XXX Dignus SysC] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_SYSC BOOST_VERSION_NUMBER(0,0,0) #if defined(__SYSC__) diff --git a/boost/predef/compiler/edg.h b/boost/predef/compiler/edg.h index 5400193..d302218 100644 --- a/boost/predef/compiler/edg.h +++ b/boost/predef/compiler/edg.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_EDG`] + +[@http://en.wikipedia.org/wiki/XXX EDG] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_EDG BOOST_VERSION_NUMBER(0,0,0) #if defined(__EDG__) diff --git a/boost/predef/compiler/ekopath.h b/boost/predef/compiler/ekopath.h index cb41746..e1cc5e5 100644 --- a/boost/predef/compiler/ekopath.h +++ b/boost/predef/compiler/ekopath.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_PATH`] + +[@http://en.wikipedia.org/wiki/XXX Ekopath] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_PATH BOOST_VERSION_NUMBER(0,0,0) #if defined(__PATHCC__) diff --git a/boost/predef/compiler/gcc.h b/boost/predef/compiler/gcc.h index 72eae70..af5cd9a 100644 --- a/boost/predef/compiler/gcc.h +++ b/boost/predef/compiler/gcc.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_GNUC`] + +[@http://en.wikipedia.org/wiki/XXX Gnu C/C++] compiler. +Version number available as major, minor, and patch (if available). + */ + #define BOOST_CXX_GNUC BOOST_VERSION_NUMBER(0,0,0) #if defined(__GNUC__) @@ -25,6 +32,6 @@ http://www.boost.org/LICENSE_1_0.txt) #endif #include -BOOST_PREDEF_DECLARE_TEST(BOOST_CXX_GNUC,"GNUC") +BOOST_PREDEF_DECLARE_TEST(BOOST_CXX_GNUC,"Gnu C/C++") #endif diff --git a/boost/predef/compiler/gcc_xml.h b/boost/predef/compiler/gcc_xml.h index 111f55c..2666fb2 100644 --- a/boost/predef/compiler/gcc_xml.h +++ b/boost/predef/compiler/gcc_xml.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_GCCXML`] + +[@http://en.wikipedia.org/wiki/XXX GCC XML] compiler. + */ + #define BOOST_CXX_GCCXML BOOST_VERSION_NUMBER(0,0,0) #if defined(__GCCXML__) diff --git a/boost/predef/compiler/greenhills.h b/boost/predef/compiler/greenhills.h index f95d6e5..a2cdd73 100644 --- a/boost/predef/compiler/greenhills.h +++ b/boost/predef/compiler/greenhills.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_GHS`] + +[@http://en.wikipedia.org/wiki/XXX Green Hills] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_GHS BOOST_VERSION_NUMBER(0,0,0) #if defined(__ghs) diff --git a/boost/predef/compiler/hp_acc.h b/boost/predef/compiler/hp_acc.h index c79ff0a..8538774 100644 --- a/boost/predef/compiler/hp_acc.h +++ b/boost/predef/compiler/hp_acc.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_HPACC`] + +[@http://en.wikipedia.org/wiki/XXX HP ACC] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_HPACC BOOST_VERSION_NUMBER(0,0,0) #if defined(__HP_aCC) diff --git a/boost/predef/compiler/iar.h b/boost/predef/compiler/iar.h index 9efca6d..8f9e384 100644 --- a/boost/predef/compiler/iar.h +++ b/boost/predef/compiler/iar.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_IAR`] + +[@http://en.wikipedia.org/wiki/XXX IAR] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_IAR BOOST_VERSION_NUMBER(0,0,0) #if defined(__IAR_SYSTEMS_ICC__) diff --git a/boost/predef/compiler/ibm.h b/boost/predef/compiler/ibm.h index f6d1bc8..8af9c3d 100644 --- a/boost/predef/compiler/ibm.h +++ b/boost/predef/compiler/ibm.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_IBM`] + +[@http://en.wikipedia.org/wiki/XXX Iternational Business Mchines] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_IBM BOOST_VERSION_NUMBER(0,0,0) #if defined(__IBMCPP__) || defined(__xlC__) diff --git a/boost/predef/compiler/intel.h b/boost/predef/compiler/intel.h index 42ed517..3a5da7c 100644 --- a/boost/predef/compiler/intel.h +++ b/boost/predef/compiler/intel.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_INTEL`] + +[@http://en.wikipedia.org/wiki/XXX Intel] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_INTEL BOOST_VERSION_NUMBER(0,0,0) #if defined(__INTEL_COMPILER) || defined(__ICL) || defined(__ICC) || \ diff --git a/boost/predef/compiler/kai.h b/boost/predef/compiler/kai.h index 55b079b..d26afb4 100644 --- a/boost/predef/compiler/kai.h +++ b/boost/predef/compiler/kai.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_KCC`] + +[@http://en.wikipedia.org/wiki/XXX Kai] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_KCC BOOST_VERSION_NUMBER(0,0,0) #if defined(__KCC) diff --git a/boost/predef/compiler/llvm.h b/boost/predef/compiler/llvm.h index 89b14b8..e5c31e6 100644 --- a/boost/predef/compiler/llvm.h +++ b/boost/predef/compiler/llvm.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_LLVM`] + +[@http://en.wikipedia.org/wiki/XXX LLVM] compiler. + */ + #define BOOST_CXX_LLVM BOOST_VERSION_NUMBER(0,0,0) #if defined(__llvm__) diff --git a/boost/predef/compiler/metaware.h b/boost/predef/compiler/metaware.h index 6ea0eae..3bffd3c 100644 --- a/boost/predef/compiler/metaware.h +++ b/boost/predef/compiler/metaware.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_HIGHC`] + +[@http://en.wikipedia.org/wiki/XXX Metaware HighC] compiler. + */ + #define BOOST_CXX_HIGHC BOOST_VERSION_NUMBER(0,0,0) #if defined(__HIGHC__) diff --git a/boost/predef/compiler/metrowerks.h b/boost/predef/compiler/metrowerks.h index 922ca6f..fe20b41 100644 --- a/boost/predef/compiler/metrowerks.h +++ b/boost/predef/compiler/metrowerks.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,30 +11,23 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_MWERKS`] + +[@http://en.wikipedia.org/wiki/XXX Metrowerks] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(0,0,0) #if defined(__MWERKS__) #undef BOOST_CXX_MWERKS - #if __MWERKS__ == 0x3000 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(8,0,0) - #elif __MWERKS__ == 0x3001 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(8,1,0) - #elif __MWERKS__ == 0x3002 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(8,2,0) - #elif __MWERKS__ == 0x3003 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(8,3,0) - #elif __MWERKS__ == 0x3200 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,0,0) - #elif __MWERKS__ == 0x3201 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,1,0) - #elif __MWERKS__ == 0x3202 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,2,0) - #elif __MWERKS__ == 0x3204 // note the "skip": 04->9.3 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,3,0) - #elif __MWERKS__ == 0x3205 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,4,0) - #elif __MWERKS__ == 0x3206 - #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,5,0) + #if (__MWERKS__ >= 0x3000) && (__MWERKS__ < 0x3200) + #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(8,(__MWERKS__)%100,0) + #elif (__MWERKS__ >= 0x3200) && (__MWERKS__ <= 0x3202) + #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,(__MWERKS__)%100,0) + #elif (__MWERKS__ >= 0x3204) && (__MWERKS__ < 0x3300) // note the "skip": 04->9.3 + #define BOOST_CXX_MWERKS BOOST_VERSION_NUMBER(9,(__MWERKS__)%100-1,0) #else #define BOOST_CXX_MWERKS BOOST_PREDEF_MAKE_F_F_FF(__MWERKS__) #endif diff --git a/boost/predef/compiler/microtec.h b/boost/predef/compiler/microtec.h index 8cebec4..68447ee 100644 --- a/boost/predef/compiler/microtec.h +++ b/boost/predef/compiler/microtec.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_MRI`] + +[@http://en.wikipedia.org/wiki/XXX Microtec] compiler. + */ + #define BOOST_CXX_MRI BOOST_VERSION_NUMBER(0,0,0) #if defined(_MRI) diff --git a/boost/predef/compiler/mingw.h b/boost/predef/compiler/mingw.h index bb1e561..1d65613 100644 --- a/boost/predef/compiler/mingw.h +++ b/boost/predef/compiler/mingw.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_MINGW`] + +[@http://en.wikipedia.org/wiki/XXX MinGW] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_MINGW BOOST_VERSION_NUMBER(0,0,0) #if defined(__MINGW32__) diff --git a/boost/predef/compiler/mpw.h b/boost/predef/compiler/mpw.h index e788c3a..4413fa2 100644 --- a/boost/predef/compiler/mpw.h +++ b/boost/predef/compiler/mpw.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_MPW`] + +[@http://en.wikipedia.org/wiki/XXX MPW] compiler. +Version number available as major, and minor. + */ + #define BOOST_CXX_MPW BOOST_VERSION_NUMBER(0,0,0) #if defined(__MRC__) diff --git a/boost/predef/compiler/palm.h b/boost/predef/compiler/palm.h index f057a46..08a459c 100644 --- a/boost/predef/compiler/palm.h +++ b/boost/predef/compiler/palm.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_PALM`] + +[@http://en.wikipedia.org/wiki/XXX Palm] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_PALM BOOST_VERSION_NUMBER(0,0,0) #if defined(_PACC_VER) diff --git a/boost/predef/compiler/pgi.h b/boost/predef/compiler/pgi.h index 1ff991b..00286f2 100644 --- a/boost/predef/compiler/pgi.h +++ b/boost/predef/compiler/pgi.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_PGI`] + +[@http://en.wikipedia.org/wiki/XXX PGI] compiler. + */ + #define BOOST_CXX_PGI BOOST_VERSION_NUMBER(0,0,0) #if defined(__PGI) diff --git a/boost/predef/compiler/sgi_mipspro.h b/boost/predef/compiler/sgi_mipspro.h index b400809..888c031 100644 --- a/boost/predef/compiler/sgi_mipspro.h +++ b/boost/predef/compiler/sgi_mipspro.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_SGI`] + +[@http://en.wikipedia.org/wiki/XXX SGI Mips-pro] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_SGI BOOST_VERSION_NUMBER(0,0,0) #if defined(__sgi) diff --git a/boost/predef/compiler/sunpro.h b/boost/predef/compiler/sunpro.h index e476a93..04a9cd6 100644 --- a/boost/predef/compiler/sunpro.h +++ b/boost/predef/compiler/sunpro.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_SUNPRO`] + +[@http://en.wikipedia.org/wiki/XXX Sun Pro] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_SUNPRO BOOST_VERSION_NUMBER(0,0,0) #if defined(__SUNPRO_CC) diff --git a/boost/predef/compiler/tendra.h b/boost/predef/compiler/tendra.h index acb4946..3deb43d 100644 --- a/boost/predef/compiler/tendra.h +++ b/boost/predef/compiler/tendra.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_TENDRA`] + +[@http://en.wikipedia.org/wiki/XXX Tendra] compiler. + */ + #define BOOST_CXX_TENDRA BOOST_VERSION_NUMBER(0,0,0) #if defined(__TenDRA__) diff --git a/boost/predef/compiler/visualc.h b/boost/predef/compiler/visualc.h index 210c369..3f9683e 100644 --- a/boost/predef/compiler/visualc.h +++ b/boost/predef/compiler/visualc.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_MSVC`] + +[@http://en.wikipedia.org/wiki/XXX Microsoft Visual C/C++] compiler. +Version number available as major, minor, and patch. + */ + #define BOOST_CXX_MSVC BOOST_VERSION_NUMBER(0,0,0) #if defined(_MSC_VER) diff --git a/boost/predef/compiler/watcom.h b/boost/predef/compiler/watcom.h index f5f7cd9..b94b321 100644 --- a/boost/predef/compiler/watcom.h +++ b/boost/predef/compiler/watcom.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_CXX_WATCOM`] + +[@http://en.wikipedia.org/wiki/XXX Watcom] compiler. +Version number available as major, and minor. + */ + #define BOOST_CXX_WATCOM BOOST_VERSION_NUMBER(0,0,0) #if defined(__WATCOMC__) diff --git a/boost/predef/language/objc.h b/boost/predef/language/objc.h index 5879fce..b31f9be 100644 --- a/boost/predef/language/objc.h +++ b/boost/predef/language/objc.h @@ -14,7 +14,7 @@ http://www.boost.org/LICENSE_1_0.txt) /*` [heading `BOOST_LANGUAGE_OBJC`] -Objective C language. +[@http://en.wikipedia.org/wiki/Objective-C Objective-C] language. */ #define BOOST_LANGUAGE_OBJC BOOST_VERSION_NUMBER(0,0,0) @@ -25,6 +25,6 @@ Objective C language. #endif #include -BOOST_PREDEF_DECLARE_TEST(BOOST_LANGUAGE_OBJC,"Objective C") +BOOST_PREDEF_DECLARE_TEST(BOOST_LANGUAGE_OBJC,"Objective-C") #endif diff --git a/boost/predef/language/stdc.h b/boost/predef/language/stdc.h index 6370886..d376dba 100644 --- a/boost/predef/language/stdc.h +++ b/boost/predef/language/stdc.h @@ -14,8 +14,8 @@ http://www.boost.org/LICENSE_1_0.txt) /*` [heading `BOOST_LANGUAGE_STDC`] -Standard C language. If available, the year of the standard -is detected as 0.0.YYYY. +[@http://en.wikipedia.org/wiki/C_(programming_language) Standard C] language. +If available, the year of the standard is detected as 0.0.YYYY. */ #define BOOST_LANGUAGE_STDC BOOST_VERSION_NUMBER(0,0,0) diff --git a/boost/predef/language/stdcpp.h b/boost/predef/language/stdcpp.h index e7ef26f..d2a32cd 100644 --- a/boost/predef/language/stdcpp.h +++ b/boost/predef/language/stdcpp.h @@ -14,8 +14,19 @@ http://www.boost.org/LICENSE_1_0.txt) /*` [heading `BOOST_LANGUAGE_STDCPP`] -Standard C++ language. If available, the year of the standard -is detected as 0.0.YYYY. +[@http://en.wikipedia.org/wiki/C%2B%2B Standard C++] language. +If available, the year of the standard is detected as 0.0.YYYY. +Because of the way the C++ standardization process works the +defined version year will not be the commonly known year standard. +Specifically the defined versions will be: + +[table Detected Version Number vs. C++ Standard Year + [[Detected Version Number] [Standard Year] [C++ Standard]] + [[0.0.1997] [1998] [ISO/IEC 14882:1998]] + [[0.0.?] [2003] [ISO/IEC 14882:2003]] + [[0.0.?] [2007] [ISO/IEC TR 19768:2007]] + [[0.0.2011] [2011] [ISO/IEC 14882:2011]] +] */ #define BOOST_LANGUAGE_STDCPP BOOST_VERSION_NUMBER(0,0,0) @@ -35,8 +46,8 @@ BOOST_PREDEF_DECLARE_TEST(BOOST_LANGUAGE_STDCPP,"Standard C++") /*` [heading `BOOST_LANGUAGE_STDCPPCLI`] -Standard C++/CLI language. If available, the year of the standard -is detected as 0.0.YYYY. +[@http://en.wikipedia.org/wiki/C%2B%2B/CLI Standard C++/CLI] language. +If available, the year of the standard is detected as 0.0.YYYY. */ #define BOOST_LANGUAGE_STDCPPCLI BOOST_VERSION_NUMBER(0,0,0) @@ -56,7 +67,7 @@ BOOST_PREDEF_DECLARE_TEST(BOOST_LANGUAGE_STDCPPCLI,"Standard C++/CLI") /*` [heading `BOOST_LANGUAGE_STDECPP`] -Standard Embedded C++ language. +[@http://en.wikipedia.org/wiki/Embedded_C%2B%2B Standard Embedded C++] language. */ #define BOOST_LANGUAGE_STDECPP BOOST_VERSION_NUMBER(0,0,0) diff --git a/boost/predef/library/c/gnu.h b/boost/predef/library/c/gnu.h index cf32012..fcf7a93 100644 --- a/boost/predef/library/c/gnu.h +++ b/boost/predef/library/c/gnu.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -17,6 +17,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #endif +/*` +[heading `BOOST_LIBC_GNU`] + +[@http://en.wikipedia.org/wiki/Glibc GNU glibc] Standard C library. +Version number available as major, and minor. + */ + #define BOOST_LIBC_GNU BOOST_VERSION_NUMBER(0,0,0) #if defined(__GLIBC__) || defined(__GNU_LIBRARY__) diff --git a/boost/predef/library/c/uc.h b/boost/predef/library/c/uc.h index 05e268f..037039c 100644 --- a/boost/predef/library/c/uc.h +++ b/boost/predef/library/c/uc.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBC_UC`] + +[@http://en.wikipedia.org/wiki/Uclibc uClibc] Standard C library. +Version number available as major, minor, and patch. + */ + #define BOOST_LIBC_UC BOOST_VERSION_NUMBER(0,0,0) #if defined(__UCLIBC__) diff --git a/boost/predef/library/c/vms.h b/boost/predef/library/c/vms.h index 5c3fc56..b6b60b3 100644 --- a/boost/predef/library/c/vms.h +++ b/boost/predef/library/c/vms.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBC_VMS`] + +VMS libc Standard C library. +Version number available as major, minor, and patch. + */ + #define BOOST_LIBC_VMS BOOST_VERSION_NUMBER(0,0,0) #if defined(__CRTL_VER) diff --git a/boost/predef/library/c/zos.h b/boost/predef/library/c/zos.h index e1f9351..bb8bcd3 100644 --- a/boost/predef/library/c/zos.h +++ b/boost/predef/library/c/zos.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,14 +11,27 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBC_ZOS`] + +z/OS libc Standard C library. +Version number available as major, minor, and patch. + */ + #define BOOST_LIBC_ZOS BOOST_VERSION_NUMBER(0,0,0) #if defined(__LIBREL__) #undef BOOST_LIBC_ZOS - #define BOOST_LIBC_ZOS BOOST_PREDEF_MAKE_F_FF_FFFF(__LIBREL__) + #if defined(__LIBREL__) + #define BOOST_LIBC_ZOS BOOST_PREDEF_MAKE_F_FF_FFFF(__LIBREL__) + #elif defined(__TARGET_LIB__) + #define BOOST_LIBC_ZOS BOOST_PREDEF_MAKE_F_FF_FFFF(__TARGET_LIB__) + #else + #define BOOST_LIBC_ZOS BOOST_VERSION_NUMBER(0,0,1) + #endif #endif #include -BOOST_PREDEF_DECLARE_TEST(BOOST_LIBC_ZOS,"zOS") +BOOST_PREDEF_DECLARE_TEST(BOOST_LIBC_ZOS,"z/OS") #endif diff --git a/boost/predef/library/std.h b/boost/predef/library/std.h index d5f0187..d9b947f 100644 --- a/boost/predef/library/std.h +++ b/boost/predef/library/std.h @@ -1,7 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 -Copyright John Maddock 2001-2003 -Copyright Jens Maurer 2001-2002 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -32,6 +30,7 @@ can end up detecting that first rather than STLport: /* The rest in alpha order, except for Dinkumware. */ +#include #include #include #include diff --git a/boost/predef/library/std/cxx.h b/boost/predef/library/std/cxx.h new file mode 100644 index 0000000..0c2a970 --- /dev/null +++ b/boost/predef/library/std/cxx.h @@ -0,0 +1,31 @@ +/* +Copyright Redshift Software Inc 2011 +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) +*/ + +#ifndef BOOST_PREDEF_LIBRARY_STD_CXX_H +#define BOOST_PREDEF_LIBRARY_STD_CXX_H + +#include +#include + +/*` +[heading `BOOST_LIBSTD_CXX`] + +[@http://libcxx.llvm.org/ libc++] C++ Standard Library. +If available version number as major, minor, and patch. + */ + +#define BOOST_LIBSTD_CXX BOOST_VERSION_NUMBER(0,0,0) + +#if defined(_LIBCPP_VERSION) + #undef BOOST_LIBSTD_CXX + #define BOOST_LIBSTD_CXX BOOST_PREDEF_MAKE_NN_NN(__CPPLIB_VER) +#endif + +#include +BOOST_PREDEF_DECLARE_TEST(BOOST_LIBSTD_CXX,"libc++") + +#endif diff --git a/boost/predef/library/std/dinkumware.h b/boost/predef/library/std/dinkumware.h index c7b9081..2ad24ef 100644 --- a/boost/predef/library/std/dinkumware.h +++ b/boost/predef/library/std/dinkumware.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_DINKUMWARE`] + +[@http://en.wikipedia.org/wiki/Dinkumware Dinkumware] Standard C++ Library. +If available version number as major, minor, and patch. + */ + #define BOOST_LIBSTD_DINKUMWARE BOOST_VERSION_NUMBER(0,0,0) #if (defined(_YVALS) && !defined(__IBMCPP__)) || defined(_CPPLIB_VER) diff --git a/boost/predef/library/std/libcomo.h b/boost/predef/library/std/libcomo.h index 7de99f3..693856e 100644 --- a/boost/predef/library/std/libcomo.h +++ b/boost/predef/library/std/libcomo.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_COMO`] + +[@http://www.comeaucomputing.com/libcomo/ Comeau Computing] Standard C++ Library. +Version number available as major. + */ + #define BOOST_LIBSTD_COMO BOOST_VERSION_NUMBER(0,0,0) #if defined(__LIBCOMO__) @@ -19,6 +26,6 @@ http://www.boost.org/LICENSE_1_0.txt) #endif #include -BOOST_PREDEF_DECLARE_TEST(BOOST_LIBSTD_COMO,"Como") +BOOST_PREDEF_DECLARE_TEST(BOOST_LIBSTD_COMO,"Comeau Computing") #endif diff --git a/boost/predef/library/std/modena.h b/boost/predef/library/std/modena.h index 2439cff..660137d 100644 --- a/boost/predef/library/std/modena.h +++ b/boost/predef/library/std/modena.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_MSIPL`] + +[@http://modena.us/ Modena Software Lib++] Standard C++ Library. + */ + #define BOOST_LIBSTD_MSIPL BOOST_VERSION_NUMBER(0,0,0) #if defined(MSIPL_COMPILE_H) || defined(__MSIPL_COMPILE_H) @@ -19,6 +25,6 @@ http://www.boost.org/LICENSE_1_0.txt) #endif #include -BOOST_PREDEF_DECLARE_TEST(BOOST_LIBSTD_MSIPL,"Modena MSIPL") +BOOST_PREDEF_DECLARE_TEST(BOOST_LIBSTD_MSIPL,"Modena Software Lib++") #endif diff --git a/boost/predef/library/std/msl.h b/boost/predef/library/std/msl.h index d78b0b5..b3d259c 100644 --- a/boost/predef/library/std/msl.h +++ b/boost/predef/library/std/msl.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_MSL`] + +[@http://www.freescale.com/ Metrowerks] Standard C++ Library. +Version number available as major, minor, and patch. + */ + #define BOOST_LIBSTD_MSL BOOST_VERSION_NUMBER(0,0,0) #if defined(__MSL_CPP__) || defined(__MSL__) diff --git a/boost/predef/library/std/roguewave.h b/boost/predef/library/std/roguewave.h index 22be74a..ca31bac 100644 --- a/boost/predef/library/std/roguewave.h +++ b/boost/predef/library/std/roguewave.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_RW`] + +[@http://en.wikipedia.org/wiki/XXX Roguewave Standard C++] library. +If available version number as major, minor, and patch. + */ + #define BOOST_LIBSTD_RW BOOST_VERSION_NUMBER(0,0,0) #if defined(__STD_RWCOMPILER_H__) || defined(_RWSTD_VER) diff --git a/boost/predef/library/std/sgi.h b/boost/predef/library/std/sgi.h index b5b58a0..da8c5d3 100644 --- a/boost/predef/library/std/sgi.h +++ b/boost/predef/library/std/sgi.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_SGI`] + +[@http://en.wikipedia.org/wiki/XXX SGI Standard C++] library. +If available version number as major, minor, and patch. + */ + #define BOOST_LIBSTD_SGI BOOST_VERSION_NUMBER(0,0,0) #if defined(__STL_CONFIG_H) diff --git a/boost/predef/library/std/stdcpp3.h b/boost/predef/library/std/stdcpp3.h index 00ada66..d33811c 100644 --- a/boost/predef/library/std/stdcpp3.h +++ b/boost/predef/library/std/stdcpp3.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,16 +11,21 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_GNU`] + +[@http://gcc.gnu.org/libstdc++/ GNU libstdc++] Standard C++ library. +Version number available as year (from 1970), month, and day. + */ + #define BOOST_LIBSTD_GNU BOOST_VERSION_NUMBER(0,0,0) #if defined(__GLIBCPP__) || defined(__GLIBCXX__) #undef BOOST_LIBSTD_GNU #if defined(__GLIBCXX__) #define BOOST_LIBSTD_GNU BOOST_PREDEF_MAKE_YYYY_MM_DD(__GLIBCXX__) - #elif - #define BOOST_LIBSTD_GNU BOOST_PREDEF_MAKE_YYYY_MM_DD(__GLIBCPP__) #else - #define BOOST_LIBSTD_GNU BOOST_VERSION_NUMBER(0,0,1) + #define BOOST_LIBSTD_GNU BOOST_PREDEF_MAKE_YYYY_MM_DD(__GLIBCPP__) #endif #endif diff --git a/boost/predef/library/std/stlport.h b/boost/predef/library/std/stlport.h index 89aa0b1..517de43 100644 --- a/boost/predef/library/std/stlport.h +++ b/boost/predef/library/std/stlport.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_STLPORT`] + +[@http://en.wikipedia.org/wiki/XXX STLport Standard C++] library. +Version number available as major, minor, and patch. + */ + #define BOOST_LIBSTD_STLPORT BOOST_VERSION_NUMBER(0,0,0) #if defined(__SGI_STL_PORT) || defined(_STLPORT_VERSION) diff --git a/boost/predef/library/std/vacpp.h b/boost/predef/library/std/vacpp.h index f5fd75a..a243b7e 100644 --- a/boost/predef/library/std/vacpp.h +++ b/boost/predef/library/std/vacpp.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_LIBSTD_IBM`] + +[@http://en.wikipedia.org/wiki/XXX IBM VACPP Standard C++] library. + */ + #define BOOST_LIBSTD_IBM BOOST_VERSION_NUMBER(0,0,0) #if defined(__IBMCPP__) diff --git a/boost/predef/os/aix.h b/boost/predef/os/aix.h index f94d6ed..ba53c46 100644 --- a/boost/predef/os/aix.h +++ b/boost/predef/os/aix.h @@ -11,6 +11,13 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_OS_`] + +[@http://en.wikipedia.org/wiki/XXX AIX] operating system. +Version number available as major, minor, and patch. + */ + #define BOOST_OS_AIX BOOST_VERSION_NUMBER(0,0,0) #if defined(_AIX) || defined(__TOS_AIX__) diff --git a/boost/predef/os/amigaos.h b/boost/predef/os/amigaos.h index 356fbb2..a19d119 100644 --- a/boost/predef/os/amigaos.h +++ b/boost/predef/os/amigaos.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_OS_AMIGAOS`] + +[@http://en.wikipedia.org/wiki/XXX AmigaOS] operating system. + */ + #define BOOST_OS_AMIGAOS BOOST_VERSION_NUMBER(0,0,0) #if defined(AMIGA) || defined(__amigaos__) @@ -19,6 +25,6 @@ http://www.boost.org/LICENSE_1_0.txt) #endif #include -BOOST_PREDEF_DECLARE_TEST(BOOST_OS_AMIGAOS,"Amiga OS") +BOOST_PREDEF_DECLARE_TEST(BOOST_OS_AMIGAOS,"AmigaOS") #endif diff --git a/boost/predef/os/beos.h b/boost/predef/os/beos.h index fd17f8a..d041cf3 100644 --- a/boost/predef/os/beos.h +++ b/boost/predef/os/beos.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,12 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_OS_BEOS`] + +[@http://en.wikipedia.org/wiki/XXX Be] operating system. + */ + #define BOOST_OS_BEOS BOOST_VERSION_NUMBER(0,0,0) #if defined(__BEOS__) diff --git a/boost/predef/os/bsd.h b/boost/predef/os/bsd.h index aedefda..e06bca2 100644 --- a/boost/predef/os/bsd.h +++ b/boost/predef/os/bsd.h @@ -1,5 +1,5 @@ /* -Copyright Redshift Software, Inc. 2008-2010 +Copyright Redshift Software, Inc. 2008-2011 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) @@ -11,6 +11,25 @@ http://www.boost.org/LICENSE_1_0.txt) #include #include +/*` +[heading `BOOST_OS_BSD`] + +[@http://en.wikipedia.org/wiki/XXX BSD] operating system. + +BSD has various branch operating systems possible and each detected +individually. This detects the following variations and sets a specific +version number macro to match: + +* `BOOST_OS_DRAGONFLY_BSD` [@http://en.wikipedia.org/wiki/XXX Dragonfly BSD] +* `BOOST_OS_FREE_BSD` [@http://en.wikipedia.org/wiki/XXX Free BSD] +* `BOOST_OS_BSDI_BSD` [@http://en.wikipedia.org/wiki/XXX BSDI] +* `BOOST_OS_NET_BSD` [@http://en.wikipedia.org/wiki/XXX Net BSD] +* `BOOST_OS_OPEN_BSD` [@http://en.wikipedia.org/wiki/XXX Open BSD] + +[note The general `BOOST_OS_BSD` is set in all cases to indicate some form +of BSD. If the above variants is detected the corresponding macro is also set.] + */ + #define BOOST_OS_BSD BOOST_VERSION_NUMBER(0,0,0) #define BOOST_OS_DRAGONFLY_BSD BOOST_VERSION_NUMBER(0,0,0) #define BOOST_OS_FREE_BSD BOOST_VERSION_NUMBER(0,0,0) @@ -49,10 +68,10 @@ http://www.boost.org/LICENSE_1_0.txt) #if defined(__FreeBSD_version) #if __FreeBSD_version < 500000 #define BOOST_OS_FREE_BSD \ - BOOST_PREDEF_VRP_N_N_N_000(__FreeBSD_version) + BOOST_PREDEF_MAKE_N_N_N_000(__FreeBSD_version) #else #define BOOST_OS_FREE_BSD \ - BOOST_PREDEF_VRP_N_NN_000(__FreeBSD_version) + BOOST_PREDEF_MAKE_N_NN_000(__FreeBSD_version) #endif #else #define BOOST_OS_FREE_BSD BOOST_VERSION_NUMBER(0,0,1) @@ -67,7 +86,7 @@ http://www.boost.org/LICENSE_1_0.txt) #define BOOST_OS_NET_BSD BOOST_VERSION_NUMBER(1,0,0) #elif defined(__NetBSD_Version) #define BOOST_OS_NET_BSD \ - BOOST_PREDEF_VRP_NN_NN_00_NN_00(__NetBSD_Version) + BOOST_PREDEF_MAKE_NN_NN_00_NN_00(__NetBSD_Version) #else #define BOOST_OS_NET_BSD BOOST_VERSION_NUMBER(0,0,1) #endif diff --git a/boost/predef/version_number.h b/boost/predef/version_number.h index cac089f..ef4506c 100644 --- a/boost/predef/version_number.h +++ b/boost/predef/version_number.h @@ -10,7 +10,7 @@ http://www.boost.org/LICENSE_1_0.txt) #define BOOST_PREDEF_VERSION_NUMBER_H /*` -[heading BOOST_VERSION_NUMBER] +[heading `BOOST_VERSION_NUMBER`] `` BOOST_VERSION_NUMBER(major,minor,patch) @@ -18,12 +18,12 @@ BOOST_VERSION_NUMBER(major,minor,patch) Defines standard version numbers, with these properties: -* Decimal base whole numbers in the range [0,major*10000000]. +* Decimal base whole numbers in the range \[0,1000000000). The number range is designed to allow for a (2,2,5) triplet. Which fits within a 32 bit value. -* The `major` number can be in the [0,99] range. -* The `minor` number can be in the [0,99] range. -* The `patch` number can be in the [0,99999] range. +* The `major` number can be in the \[0,99\] range. +* The `minor` number can be in the \[0,99\] range. +* The `patch` number can be in the \[0,99999\] range. * Values can be specified in any base. As the defined value is an constant expression. * Value can be directly used in both preprocessor and compiler diff --git a/libs/predef/doc/build.jam b/libs/predef/doc/build.jam index 2833e60..a8ec20a 100644 --- a/libs/predef/doc/build.jam +++ b/libs/predef/doc/build.jam @@ -13,6 +13,8 @@ if ! $(BOOST_ROOT) xml predef : predef.qbk + : + $(BOOST_PREDEF_ROOT)/boost/predef.h ; explicit predef ; @@ -21,7 +23,7 @@ boostbook standalone predef : boost.root=../../.. - generate.section.toc.level=3 + #generate.section.toc.level=3 chunk.section.depth=1 chunk.first.sections=1 diff --git a/libs/predef/doc/html/boostbook.css b/libs/predef/doc/html/boostbook.css new file mode 100644 index 0000000..f106e46 --- /dev/null +++ b/libs/predef/doc/html/boostbook.css @@ -0,0 +1,646 @@ +/*============================================================================= + Copyright (c) 2004 Joel de Guzman + http://spirit.sourceforge.net/ + + Distributed under the Boost Software License, Version 1.0. (See accompany- + ing file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) +=============================================================================*/ + +/*============================================================================= + Body defaults +=============================================================================*/ + + body + { + margin: 1em; + font-family: sans-serif; + } + +/*============================================================================= + Paragraphs +=============================================================================*/ + + p + { + text-align: left; + font-size: 10pt; + line-height: 1.15; + } + +/*============================================================================= + Program listings +=============================================================================*/ + + /* Code on paragraphs */ + p tt.computeroutput + { + font-size: 9pt; + } + + pre.synopsis + { + font-size: 9pt; + margin: 1pc 4% 0pc 4%; + padding: 0.5pc 0.5pc 0.5pc 0.5pc; + } + + .programlisting, + .screen + { + font-size: 9pt; + display: block; + margin: 1pc 4% 0pc 4%; + padding: 0.5pc 0.5pc 0.5pc 0.5pc; + } + + /* Program listings in tables don't get borders */ + td .programlisting, + td .screen + { + margin: 0pc 0pc 0pc 0pc; + padding: 0pc 0pc 0pc 0pc; + } + +/*============================================================================= + Headings +=============================================================================*/ + + h1, h2, h3, h4, h5, h6 + { + text-align: left; + margin: 1em 0em 0.5em 0em; + font-weight: bold; + } + + h1 { font-size: 140%; } + h2 { font-weight: bold; font-size: 140%; } + h3 { font-weight: bold; font-size: 130%; } + h4 { font-weight: bold; font-size: 120%; } + h5 { font-weight: normal; font-style: italic; font-size: 110%; } + h6 { font-weight: normal; font-style: italic; font-size: 100%; } + + /* Top page titles */ + title, + h1.title, + h2.title + h3.title, + h4.title, + h5.title, + h6.title, + .refentrytitle + { + font-weight: bold; + margin-bottom: 1pc; + } + + h1.title { font-size: 140% } + h2.title { font-size: 140% } + h3.title { font-size: 130% } + h4.title { font-size: 120% } + h5.title { font-size: 110% } + h6.title { font-size: 100% } + + .section h1 + { + margin: 0em 0em 0.5em 0em; + font-size: 140%; + } + + .section h2 { font-size: 140% } + .section h3 { font-size: 130% } + .section h4 { font-size: 120% } + .section h5 { font-size: 110% } + .section h6 { font-size: 100% } + + /* Code on titles */ + h1 tt.computeroutput { font-size: 140% } + h2 tt.computeroutput { font-size: 140% } + h3 tt.computeroutput { font-size: 130% } + h4 tt.computeroutput { font-size: 130% } + h5 tt.computeroutput { font-size: 130% } + h6 tt.computeroutput { font-size: 130% } + + +/*============================================================================= + Author +=============================================================================*/ + + h3.author + { + font-size: 100% + } + +/*============================================================================= + Lists +=============================================================================*/ + + li + { + font-size: 10pt; + line-height: 1.3; + } + + /* Unordered lists */ + ul + { + text-align: left; + } + + /* Ordered lists */ + ol + { + text-align: left; + } + +/*============================================================================= + Links +=============================================================================*/ + + a + { + text-decoration: none; /* no underline */ + } + + a:hover + { + text-decoration: underline; + } + +/*============================================================================= + Spirit style navigation +=============================================================================*/ + + .spirit-nav + { + text-align: right; + } + + .spirit-nav a + { + color: white; + padding-left: 0.5em; + } + + .spirit-nav img + { + border-width: 0px; + } + +/*============================================================================= + Copyright footer +=============================================================================*/ + .copyright-footer + { + text-align: right; + font-size: 70%; + } + + .copyright-footer p + { + text-align: right; + font-size: 80%; + } + +/*============================================================================= + Table of contents +=============================================================================*/ + + .toc + { + margin: 1pc 4% 0pc 4%; + padding: 0.1pc 1pc 0.1pc 1pc; + font-size: 80%; + line-height: 1.15; + } + + .boost-toc + { + float: right; + padding: 0.5pc; + } + + /* Code on toc */ + .toc .computeroutput { font-size: 120% } + + /* No margin on nested menus */ + + .toc dl dl { margin: 0; } + +/*============================================================================= + Tables +=============================================================================*/ + + .table-title, + div.table p.title + { + margin-left: 4%; + padding-right: 0.5em; + padding-left: 0.5em; + } + + .informaltable table, + .table table + { + width: 92%; + margin-left: 4%; + margin-right: 4%; + } + + div.informaltable table, + div.table table + { + padding: 4px; + } + + /* Table Cells */ + div.informaltable table tr td, + div.table table tr td + { + padding: 0.5em; + text-align: left; + font-size: 9pt; + } + + div.informaltable table tr th, + div.table table tr th + { + padding: 0.5em 0.5em 0.5em 0.5em; + border: 1pt solid white; + font-size: 80%; + } + + table.simplelist + { + width: auto !important; + margin: 0em !important; + padding: 0em !important; + border: none !important; + } + table.simplelist td + { + margin: 0em !important; + padding: 0em !important; + text-align: left !important; + font-size: 9pt !important; + border: none !important; + } + +/*============================================================================= + Blurbs +=============================================================================*/ + + div.note, + div.tip, + div.important, + div.caution, + div.warning, + p.blurb + { + font-size: 9pt; /* A little bit smaller than the main text */ + line-height: 1.2; + display: block; + margin: 1pc 4% 0pc 4%; + padding: 0.5pc 0.5pc 0.5pc 0.5pc; + } + + p.blurb img + { + padding: 1pt; + } + +/*============================================================================= + Variable Lists +=============================================================================*/ + + div.variablelist + { + margin: 1em 0; + } + + /* Make the terms in definition lists bold */ + div.variablelist dl dt, + span.term + { + font-weight: bold; + font-size: 10pt; + } + + div.variablelist table tbody tr td + { + text-align: left; + vertical-align: top; + padding: 0em 2em 0em 0em; + font-size: 10pt; + margin: 0em 0em 0.5em 0em; + line-height: 1; + } + + div.variablelist dl dt + { + margin-bottom: 0.2em; + } + + div.variablelist dl dd + { + margin: 0em 0em 0.5em 2em; + font-size: 10pt; + } + + div.variablelist table tbody tr td p, + div.variablelist dl dd p + { + margin: 0em 0em 0.5em 0em; + line-height: 1; + } + +/*============================================================================= + Misc +=============================================================================*/ + + /* Title of books and articles in bibliographies */ + span.title + { + font-style: italic; + } + + span.underline + { + text-decoration: underline; + } + + span.strikethrough + { + text-decoration: line-through; + } + + /* Copyright, Legal Notice */ + div div.legalnotice p + { + text-align: left + } + +/*============================================================================= + Colors +=============================================================================*/ + + @media screen + { + body { + background-color: #FFFFFF; + color: #000000; + } + + /* Syntax Highlighting */ + .keyword { color: #0000AA; } + .identifier { color: #000000; } + .special { color: #707070; } + .preprocessor { color: #402080; } + .char { color: teal; } + .comment { color: #800000; } + .string { color: teal; } + .number { color: teal; } + .white_bkd { background-color: #FFFFFF; } + .dk_grey_bkd { background-color: #999999; } + + /* Links */ + a, a .keyword, a .identifier, a .special, a .preprocessor + a .char, a .comment, a .string, a .number + { + color: #005a9c; + } + + a:visited, a:visited .keyword, a:visited .identifier, + a:visited .special, a:visited .preprocessor a:visited .char, + a:visited .comment, a:visited .string, a:visited .number + { + color: #9c5a9c; + } + + h1 a, h2 a, h3 a, h4 a, h5 a, h6 a, + h1 a:hover, h2 a:hover, h3 a:hover, h4 a:hover, h5 a:hover, h6 a:hover, + h1 a:visited, h2 a:visited, h3 a:visited, h4 a:visited, h5 a:visited, h6 a:visited + { + text-decoration: none; /* no underline */ + color: #000000; + } + + /* Copyright, Legal Notice */ + .copyright + { + color: #666666; + font-size: small; + } + + div div.legalnotice p + { + color: #666666; + } + + /* Program listing */ + pre.synopsis + { + border: 1px solid #DCDCDC; + } + + .programlisting, + .screen + { + border: 1px solid #DCDCDC; + } + + td .programlisting, + td .screen + { + border: 0px solid #DCDCDC; + } + + /* Blurbs */ + div.note, + div.tip, + div.important, + div.caution, + div.warning, + p.blurb + { + border: 1px solid #DCDCDC; + } + + /* Table of contents */ + .toc + { + border: 1px solid #DCDCDC; + } + + /* Tables */ + div.informaltable table tr td, + div.table table tr td + { + border: 1px solid #DCDCDC; + } + + div.informaltable table tr th, + div.table table tr th + { + background-color: #F0F0F0; + border: 1px solid #DCDCDC; + } + + .copyright-footer + { + color: #8F8F8F; + } + + /* Misc */ + span.highlight + { + color: #00A000; + } + } + + @media print + { + /* Links */ + a + { + color: black; + } + + a:visited + { + color: black; + } + + .spirit-nav + { + display: none; + } + + /* Program listing */ + pre.synopsis + { + border: 1px solid gray; + } + + .programlisting, + .screen + { + border: 1px solid gray; + } + + td .programlisting, + td .screen + { + border: 0px solid #DCDCDC; + } + + /* Table of contents */ + .toc + { + border: 1px solid gray; + } + + .informaltable table, + .table table + { + border: 1px solid gray; + border-collapse: collapse; + } + + /* Tables */ + div.informaltable table tr td, + div.table table tr td + { + border: 1px solid gray; + } + + div.informaltable table tr th, + div.table table tr th + { + border: 1px solid gray; + } + + table.simplelist tr td + { + border: none !important; + } + + /* Misc */ + span.highlight + { + font-weight: bold; + } + } + +/*============================================================================= + Images +=============================================================================*/ + + span.inlinemediaobject img + { + vertical-align: middle; + } + +/*============================================================================== + Super and Subscript: style so that line spacing isn't effected, see + http://www.adobe.com/cfusion/communityengine/index.cfm?event=showdetails&productId=1&postId=5341 +==============================================================================*/ + +sup, +sub { + height: 0; + line-height: 1; + vertical-align: baseline; + position: relative; + +} + +/* For internet explorer: */ + +* html sup, +* html sub { + vertical-align: bottom; +} + +sup { + bottom: 1ex; +} + +sub { + top: .5ex; +} + +/*============================================================================== + Indexes: pretty much the same as the TOC. +==============================================================================*/ + + .index + { + font-size: 80%; + padding-top: 0px; + padding-bottom: 0px; + margin-top: 0px; + margin-bottom: 0px; + margin-left: 0px; + } + + .index ul + { + padding-left: 3em; + } + + .index p + { + padding: 2px; + margin: 2px; + } + + .index-entry-level-0 + { + font-weight: bold; + } + + .index em + { + font-weight: bold; + } + diff --git a/libs/predef/doc/html/docutils.css b/libs/predef/doc/html/docutils.css new file mode 100644 index 0000000..4aa2e21 --- /dev/null +++ b/libs/predef/doc/html/docutils.css @@ -0,0 +1,275 @@ +/* +:Author: David Goodger +:Contact: goodger@python.org +:Date: $Date: 2007-04-16 23:44:59 -0500 (Mon, 16 Apr 2007) $ +:Revision: $Revision: 37457 $ +:Copyright: This stylesheet has been placed in the public domain. + +Default cascading style sheet for the HTML output of Docutils. + +See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to +customize this style sheet. +*/ + +/* used to remove borders from tables and images */ +.borderless, table.borderless td, table.borderless th { + border: 0 } + +table.borderless td, table.borderless th { + /* Override padding for "table.docutils td" with "! important". + The right padding separates the table cells. */ + padding: 0 0.5em 0 0 ! important } + +.first { + /* Override more specific margin styles with "! important". */ + margin-top: 0 ! important } + +.last, .with-subtitle { + margin-bottom: 0 ! important } + +.hidden { + display: none } + +a.toc-backref { + text-decoration: none ; + color: black } + +blockquote.epigraph { + margin: 2em 5em ; } + +dl.docutils dd { + margin-bottom: 0.5em } + +/* Uncomment (and remove this text!) to get bold-faced definition list terms +dl.docutils dt { + font-weight: bold } +*/ + +div.abstract { + margin: 2em 5em } + +div.abstract p.topic-title { + font-weight: bold ; + text-align: center } + +div.admonition, div.attention, div.caution, div.danger, div.error, +div.hint, div.important, div.note, div.tip, div.warning { + margin: 2em ; + border: medium outset ; + padding: 1em } + +div.admonition p.admonition-title, div.hint p.admonition-title, +div.important p.admonition-title, div.note p.admonition-title, +div.tip p.admonition-title { + font-weight: bold ; + font-family: sans-serif } + +div.attention p.admonition-title, div.caution p.admonition-title, +div.danger p.admonition-title, div.error p.admonition-title, +div.warning p.admonition-title { + color: red ; + font-weight: bold ; + font-family: sans-serif } + +/* Uncomment (and remove this text!) to get reduced vertical space in + compound paragraphs. +div.compound .compound-first, div.compound .compound-middle { + margin-bottom: 0.5em } + +div.compound .compound-last, div.compound .compound-middle { + margin-top: 0.5em } +*/ + +div.dedication { + margin: 2em 5em ; + text-align: center ; + font-style: italic } + +div.dedication p.topic-title { + font-weight: bold ; + font-style: normal } + +div.figure { + margin-left: 2em ; + margin-right: 2em } + +div.footer, div.header { + clear: both; + font-size: smaller } + +div.line-block { + display: block ; + margin-top: 1em ; + margin-bottom: 1em } + +div.line-block div.line-block { + margin-top: 0 ; + margin-bottom: 0 ; + margin-left: 1.5em } + +div.sidebar { + margin-left: 1em ; + border: medium outset ; + padding: 1em ; + background-color: #ffffee ; + width: 40% ; + float: right ; + clear: right } + +div.sidebar p.rubric { + font-family: sans-serif ; + font-size: medium } + +div.system-messages { + margin: 5em } + +div.system-messages h1 { + color: red } + +div.system-message { + border: medium outset ; + padding: 1em } + +div.system-message p.system-message-title { + color: red ; + font-weight: bold } + +div.topic { + margin: 2em } + +h1.section-subtitle, h2.section-subtitle, h3.section-subtitle, +h4.section-subtitle, h5.section-subtitle, h6.section-subtitle { + margin-top: 0.4em } + +h1.title { + text-align: center } + +h2.subtitle { + text-align: center } + +hr.docutils { + width: 75% } + +img.align-left { + clear: left } + +img.align-right { + clear: right } + +ol.simple, ul.simple { + margin-bottom: 1em } + +ol.arabic { + list-style: decimal } + +ol.loweralpha { + list-style: lower-alpha } + +ol.upperalpha { + list-style: upper-alpha } + +ol.lowerroman { + list-style: lower-roman } + +ol.upperroman { + list-style: upper-roman } + +p.attribution { + text-align: right ; + margin-left: 50% } + +p.caption { + font-style: italic } + +p.credits { + font-style: italic ; + font-size: smaller } + +p.label { + white-space: nowrap } + +p.rubric { + font-weight: bold ; + font-size: larger ; + color: maroon ; + text-align: center } + +p.sidebar-title { + font-family: sans-serif ; + font-weight: bold ; + font-size: larger } + +p.sidebar-subtitle { + font-family: sans-serif ; + font-weight: bold } + +p.topic-title { + font-weight: bold } + +pre.address { + margin-bottom: 0 ; + margin-top: 0 ; + font-family: serif ; + font-size: 100% } + +pre.literal-block, pre.doctest-block { + margin-left: 2em ; + margin-right: 2em } + +span.classifier { + font-family: sans-serif ; + font-style: oblique } + +span.classifier-delimiter { + font-family: sans-serif ; + font-weight: bold } + +span.interpreted { + font-family: sans-serif } + +span.option { + white-space: nowrap } + +span.pre { + white-space: pre } + +span.problematic { + color: red } + +span.section-subtitle { + /* font-size relative to parent (h1..h6 element) */ + font-size: 80% } + +table.citation { + border-left: solid 1px gray; + margin-left: 1px } + +table.docinfo { + margin: 2em 4em } + +table.docutils { + margin-top: 0.5em ; + margin-bottom: 0.5em } + +table.footnote { + border-left: solid 1px black; + margin-left: 1px } + +table.docutils td, table.docutils th, +table.docinfo td, table.docinfo th { + padding-left: 0.5em ; + padding-right: 0.5em ; + vertical-align: top } + +table.docutils th.field-name, table.docinfo th.docinfo-name { + font-weight: bold ; + text-align: left ; + white-space: nowrap ; + padding-left: 0 } + +h1 tt.docutils, h2 tt.docutils, h3 tt.docutils, +h4 tt.docutils, h5 tt.docutils, h6 tt.docutils { + font-size: 100% } + +ul.auto-toc { + list-style-type: none } diff --git a/libs/predef/doc/html/images/alert.png b/libs/predef/doc/html/images/alert.png new file mode 100644 index 0000000000000000000000000000000000000000..b4645bc7e7cd81f2818bf22aa898e95f89f7b154 GIT binary patch literal 603 zcmeAS@N?(olHy`uVBq!ia0y~yV31^BU=ZVAW?*1oN<7}ez`(#Bl2vQw%VQUVy#($c(b7<_!Z&&*`7 zwYIFTuIA!kP?6(!`t<3^g$y0J3{Q73WQH(YSjJ#(AQj-}VXe>LZ_gkv$q?hiVP&Xj ztS4or%^)MjpsB?1|Nnp9pi5p13=F0vL4Lvi$p8#BTQ7jZgtNdSvY3H^>jMZgI;}C8 z!N9FSxfgB=H7N+NC77H_+N#nawR{=RqTMBX)(LXL|IjinhDSdCyWWZ3S$0kBOZbahGm>{cU3L4X z*xaKNrl+L*2&>`tT{GF}sK6TCoSy58@94C>csZ@3se0z)OD!J`ePg?KNk!eRu!nuZ zwIuy5g5`UyU*2!`JMiPV^UIVvmW1t{f1*^~1#9h_jDIZO*R6JmbN8&QBXd?)zY=(& z`HG+Mis#k2-hNM1nwI_8efYU@yAuCZhY42|Be;Juo!svFUA16}A_D^hgQu&X%Q~lo FCIA+53ZVc1 literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/blank.png b/libs/predef/doc/html/images/blank.png new file mode 100644 index 0000000000000000000000000000000000000000..764bf4f0c3bb4a09960b04b6fa9c9024bca703bc GIT binary patch literal 374 zcmeAS@N?(olHy`uVBq!ia0y~yU}ykg4kiW$2A`O3a~K#HSkfJR9T^xl_H+M9WMyDr z)b(_645^s&_M)R8g96V1g9H1Y`?|@Qa8+HmHda4(nQ?zM!!?FAj1kNm*b;aTNHv%; cj9>w=gf!;AOne?`3=9kmp00i_>zopr0BeEaktF{gKeVcsDJ z0oVU;*6~a;Smx2ZrsEQ?ZxM&ygvBnFE?nmtg94rky>!~x8m)3j$<^(USQPg)>&zq; zMi;kRX=V2=&tIr>`d!)XyUpL@9=UmHetuZ+!_#HmOU>-J$pS3-bN!ardIyAF-G1#? z>&)f7E`k#|4sWoP;JM|(l6I_WZ`%~1y>agujE%b%?TB9+mb}(fsxyPFgQGMy*=%;A z(aZyu>`GQPiY$*T-1gu1pAwY3_N%b5cB#xoiRPn8jf*q{Trb|_a%sui&dtzin6_r? zu}%d~p(mAmOGTO#c2u;xJ(}Y^?ex>t7XL(?7U+1p1hOa|ab;w%c)sCoo@_(^WX<=s zr#89B91nl^w~jx#=XQ?S<*?OXYm`>JmO9g8;`^U+STt2<{M7jt yFTo&UT%Db3I{*CoWB+`guig6oxB?on>HF_suX>mE-_|+p)}_VbyG%XWRxDs!Bbdb`rSkCf z_opQpQ)e&z9?Q3;X^2drllMU70&71c8CwuJm{abIp zeHPuYNTZJ3@x#oHxOW1*hRe1@t$mhYkYRMp!NudU$f{L`HtEbcpPpkT-Q%WwW82?% zC04fVjt$l>J1E5m&cv;Mo-ym249h`b!OT;yI|^kU z7g#)~+Iz@=rzNo?Z+rL2lqSFB&0ni{FPmfwyfr;gD5K)Z38R1FYejhuGSfQP|hTIvQJ?m5M8zE|_KJ2Ny0Fm1o>%kU%6J0MhalaBNL z`|XP~Ht29?&a!*3EqAew_mM&!z3HdD7hn7l!t9~x=u!|XzH8m#&o*bC7c(?GuT1E< zIxY74U)KBI?en(Zj`8vg@_IC9@{~!dRw-$!in=2h%i uo%h^T#Pz@K#3`Fjeg5EaktF{gFX#;)5A z0&V{%irr-ME}D3(<3UjG?A^;f=DTxNc8JvRJ?~omN$9208L_ft0gE{24F|>2&Q_(X zyZRk}S@Y!IJLwtuX$cuSW9kad-E9>}+B4ar@B8JKU&IA}ZdvzvdHazWz|5Z1g ze)`Eh`){a=Ty&?>q6`CxFY1#$=XWS5S;+8pJeF8|am8VmFNNE0pWSjTLp3m4UCF?B z)v7}^cJ1H)wSBfZUSXp*CCGT~*L1 z!O^woK;8cKATG~IcM5iAPD}l8PyF`VZ_(}ou7b0cInG+vv8ev~-ZX{}_a4{SRWsNx zp57$DG;5jTyyy8w3^D7&C6fPqtf+bOwJP3cC`GVy&NA$7e!FZ3*ZX_(gMKMn{jgqg*t>n5-mVwdc+LxmI|e9UlrZu5 zQ({_ROHtjRNV$1z%lk=bT+YJ`-QVnLY|jT_oBf)`qRPnx(gN%Xx|4tEMdaVwoi3 z8lgAcLau*<4)^ratatOor+TqI{wNVS?clathJwW!uZ)j$%&5q+Ew{P&-MZ_q|3(_ifRH$!b{%@XfPPgvO) wR!x~yId8sr_tEzopr0G&e8k^lez literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/callouts/13.png b/libs/predef/doc/html/images/callouts/13.png new file mode 100644 index 0000000000000000000000000000000000000000..5b41e02a670f020ae62b7854482c4ba1980d73cf GIT binary patch literal 509 zcmeAS@N?(olHy`uVBq!ia0y~yU=UznVBqFpV_;w?d&FzWz`%IK)5S5QVovKN`}4B` zMA$w&XL9s;aOlF(1%)YvneO4jm-o(&U;MKD#e?Mq8+>b)^R3G((>5$`ILflv=tsMT zqri^uWh?XJrteF)Ir(#L@uYSZ#}5m2PWL-;h`yh)YSr?%_21hCg6ylJ<~^TZ68k@M z*0PUs0U}2m4Zrz%{ru!$;?!{|$E-JRd$xd+!qOu@YuZ+=+K?-K{IOu7#Gy?(C029K zJuHwgKK8+3O1mEi<8zsP?~|?OE?SqZ;@R}Hh*OcJN#Q`=cIVYsi%fl`jgRf~&@_Gf zwzE(sdH3B%ReKL@(z)}#{LAm!8Ou74CNVNBn8MT`ef;AL!#4E;rLlAT)H7zW#a>U8 zU^AP|o3>d}=J>$`0|rHwDM43C-@g0)`~9hChd_}fnOvtgEzsbyc%HHSwnVR+$0Qaf z4hDzV>nAp?Vf*l#Q@}~VH~7Z3-c_p%=AWOKD!ECAd8tU(q6Mq8jughk>rJ2Tw)o@M zm#pV3mrVI!!@p|Pp+XrSHQ@j+Lm56tj!LO-Hu>!LzuT|B{(4Tap5^mRI^HKOr#o>( zhECmcH*b>$SLC#%J&RUEtqrq3WKa^{tg=+3a-Mjg$X|1pImHv7|6G6l?EhE#0)GDv Vq@B#jVqjok@O1TaS?83{1OO3{4iFg+V~@k_l_W_wBcH zWmp*BaqNHHW9Xsz@VDKv%bG0$2|bO5Z6>~kGkrGPetRKrdu;6W&)@+-S^-5e@qWpx=%~ppu-*HbtcU?B((KtQse2TO*ZEl8Jswt zRO&J4%x73CvPq};vBd=w-op^F6<=oH98=hD0fB5^~^0#Ht9-5wBo~e$L z1lS(@e{k6MP=#(Q)65P&Df1-{87Bltt+Mf&((ZAvc!Ef@>!Js&9H9b5iNOkrjBYL6 zJ*_!sB>iV?h@ACiit<@=<+J)R*K4P%cxw9w^X5-kmdSp5TRo@ZmA&eVHGWMv{dC`S zuce2g9b}I0mp%UT(3$h)E?kO6N0T-NtiR6f#9?6EcU;-Tw>eSb#{2IdZ1@=hR$sjr zzyA8Z#}+%3XYST(VGvBTnww-G;h@R7RHW^&qTY1wDM1E2%vZCnP73-ad;I5-GeP_8 zE`G0F6Q(`qeEN%Bd`m@QuDc4b82Acr%ROx3%dny5{(I}bX7&S{bY%G0Jv1kte!3xU z{l(W`FJx^snCW9M|9s%ekN~~u3#V){n|<~=yTas?3Ovp)cJVPNC~di&>!GEaktF{gFH!7eFB zfwuoy?SYP89?67Uc^u>7$ueKD;_TuU8yCKP?%y^nk6}6Q`Xb ztf|`>GH3mp6jYb?>^RdSfr%@^R!^go|6uIuQi$NDW>upBo%&=x}fma9VINW5Ly|Qkmm3JvHr(Hb1rr&)I%k zqW}1XsO0Up4@Uid#O=~jwU>`!u0>yZkk=jF7J(OKyBQi3I1HqEAMAR!+FC^5{Aa5( zf1b8B8nUgv%H`5>GKER;h_=JWcU60(815ha{H$oF%dBM*eC_{b&TZl;l$m|{>8A+2 z>GpSd7ik$I?GB%onzMHA^lP*F zk0)=tnX|7g@rLFCKI7=6AyTdvVl+z`(%Z>FVdQ I&MBb@0M`i8D*ylh literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/callouts/3.png b/libs/predef/doc/html/images/callouts/3.png new file mode 100644 index 0000000000000000000000000000000000000000..3ff0a93931515bb97a045dfa61a8530d87e458fd GIT binary patch literal 431 zcmeAS@N?(olHy`uVBq!ia0y~yU=UznVBqFpV_;w?d&FzWz`$7M>EaktF{gFH*{(+p zB5wOOu6l7m)8 z=-oKUH}V^&iJyB|uo8LF()AHB5)-MfO`N3nt zvX}OXM~sd8*9*0GtV!A!kzpdmy4F;zn{|?kqeR<^5G@5I1_ong&q>Sg=9!B)JHv7pU)=hauMINB3;oaL&ye>}mU!H{id4Bxig=9%^>^=*s?64R8I`k2o? pd-p8Ef~{sjr?y8+Fx+F*x_2OD_kw447#J8BJYD@<);T3K0RY@Tw*mkF literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/callouts/4.png b/libs/predef/doc/html/images/callouts/4.png new file mode 100644 index 0000000000000000000000000000000000000000..6aa29fc0b48c17aa6ce5540e1af5c00510c33ff7 GIT binary patch literal 441 zcmeAS@N?(olHy`uVBq!ia0y~yU=UznVBqFpV_;w?d&FzWz`)qx>EaktF{gFH#x5mC zfwup%GG$o)=ergqP)_hu?Cbmc-FuV6=PTSkE z?z;W`K`XyJWKnY38^_LI-}iXo6rn{K^Ugm{NGsVLTQQIQc;ScrMIF~}*~{?xZ|}UC z)%voeOU2Vbu7Bb(%{5!g=daxAHc3V5z+>?E76HlSc>&q{{ zJgU5>EY^K=``x_dYqp*_vnNK+lE-=9auZ+6u0=XLho7HKd(8afJ98Qv1B>H_g?h*I z^7xt(_!*jJt_^x6<$Ce%iJd)$VVYl~OqdVEFZF#=7-s1t%fP_E;OXk;vd$@?2>|9n B#bp2h literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/callouts/5.png b/libs/predef/doc/html/images/callouts/5.png new file mode 100644 index 0000000000000000000000000000000000000000..36e785867ad9b06bb5da296fee61b67cd8159ded GIT binary patch literal 423 zcmeAS@N?(olHy`uVBq!ia0y~yU=UznVBqFpV_;w?d&FzWz`&U2>EaktF{gFn*{nkj zBCY4o9LZ47@QCRUnZAf+N!}-g*k62kUh<2$=N}3cU-wJsu7~Tf`D?j51GwEfg_G2_ zuV#t97&qf=>*tSit#h_USr*FJFU!>WaGpbPU+ne2DLtw;&jomW^|@TLId}ILd4;Y; z`kGI<1$&J<4oW?f4p9*ch$x|rP+;KqSwET0Ksa~vKtM(>J91HOJ>EhB>xN^tsw+8di7uv`rMqUeL zJtlGLsS$%o&3$<<&56<(YY$o;PcU%UfB(F1o@3V5sOFBi;${Vo2fOrSjvstkva9-x zil;zZBGUt9^BXy4GknxI4hvj-p!#HTV6S6ePsEk3N^VkheYYwwc>v z!48gj&!5^CXy3`&YF5dr$YOKedHr?gg#ir$OfFx%f9Fdu@F;mr4Z2vhci-*k?73P? f@97_A_`n?SY~RWh)zCHu1_lOCS3j3^P6EaktF{gFH{#8D;%7vjax1W#KXIAnv(J`n z&5VyM+63~m6_r{NIT!+`rAn_gmE-I&+!3QUA?T1q^ClfZ7RG!2%96cqg2wgyaq?lS zMX$X!U8LbO@45W6mvfv$L-`J@Z+FmS&DLGD$|-VMfY)E~efQs=*mUM;<-bcWOZM5Z zTz)B%D3P@Lt`d*4kJ{wr1(Q_jEaktF{gLJ{wyX( zf%f{%yMM5|1Qs>DxO#n#YtRpleGYL4%{eMNMC?4cR!{jhN$+gat*(bhBwQW8eR)?F zba$a+^0L_vzt^7O@l~6=`|-z${Iyee1O}bTzyIC7L&Goql*H!=r=P}oFAaJ)O@ZgI z{@Sm`#{5B@N=kt`V%+OqiyeDxcc)!#?*L7k5+eADVIg?*L>hpfK3x*)1hCVBt; z;|%wV8@Gym{wcFIjN7SWb%BU0N0Y+6yzR|3cK@fSPF7(wKKyx4{o#4fYt#Iv1TDJ# z*2#-AZQqV>`4S8w#?i?>7PHU(+hgr1l-*Nl-OBiY{af+c^=0Sh`7EaktF{kyy#=ct) z0&EZJryZ5xyvdOv(510`p{HDvlxC~E$|>iVgULHQ3PYvrom?h2P4(>+k=FEToVfLb z-1}ul4-dV}J2m&O{aGGazV^u2>+);2+U^P78~6Tv*4AI1E_e2NCZAD1|9M}poAQ6# z2UUCjU5lzOJ!f0qp`v6c!}s@T(aY_*-6p<)(^RJf%{ZH;pv2Hn%$FKjXEE0=dabFI zOUbTczTJ2ED(5xNoT$P%L(+vssY!q-Q6kB1zW$Oa(QCh^Kc6#2_JRrTx8JslG@1mM zBBvdU`kln8=_3m^%&og1Cq^RrH#tzmz{IfafeFfcH9y85}Sb4q9e0BP^KrT_o{ literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/callouts/9.png b/libs/predef/doc/html/images/callouts/9.png new file mode 100644 index 0000000000000000000000000000000000000000..abe636072b61306fbcd6157b95dfdf7e86a77e5d GIT binary patch literal 420 zcmeAS@N?(olHy`uVBq!ia0y~yU=UznVBqFpV_;w?d&FzWz`&U8>EaktF{gEcf7T%f znb!OIl8YM`EC?0g)MK6LySsR*bBW@-#a{$sD|jaA?Rq5|BVw*<(2>_Fw2;L_Ls+eT z*=m-pP5G8*zMrjje*N{AqvqEc&v$lO8~PeQnNu$u7&XUG^XcT&$oGAZue{@YWbseb zX;0Q#doE68rNi6aM(w}9J~guKY8ESl1YdhX&(saqqyj~D?!KF+)#9L-_*{J2Y1Ks< zObjyp?mceG5^anO3Q8tYyaIvx98EzeZXaKe_`Z|7b6wRX+{3FhZAn{V<2dEM9+du_kptYsE+ z{WKfa2W_~S^T2{nZ8E1=H*3uG*3`)V4^%t_SRAV?Wb9U5edYbrW%=bs0jAGCWzMDv z&-uLjLxRB%P3bLBx;@8}pH%jFEoHiFvT*CZ6}7y~440#x2c4?eefQp-XqD5OV!VD< d@-ZKf|NC_Jf+y*vd<+Z>44$rjF6*2UngH>Mv>N~b literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/caution.png b/libs/predef/doc/html/images/caution.png new file mode 100644 index 0000000000000000000000000000000000000000..5b7809ca4a9c8d778087522e5ce04b6e90099595 GIT binary patch literal 1250 zcmeAS@N?(olHy`uVBq!ia0y~yV2}V|4rT@hhU+WOo?>8NW(e>Jab;j&;NV~o5MYpy zU{F+KFf?Rva$<;zVn|MA$j)XcE@r5%W@u?)XlW_#>0#*UDemd%nKFf8%9P?MQ>y38 zVVEwkZjIWyHF@jSt$X(}?A@Du?i|Cp zbLXyIW4Lzh+_h`h?%iX!chB(NJdh*`E$$X&!4}4&+z{J`|sZwzJC|^ z{$1kxcf;@BzyJTw@c+NS|Nj#IN5NBISn~R-X--a%afBxQ|J!3zMjr_SU zk_iHr)f*lf{$5^Qz}I)@3FlWvw(w~u=1P@VsTP+$RNGvxbHL-(%M6nc6`{zlU zjGQJeveps+!&Jb&mD)L@hA} z1_tL6*NBqf{Irtt#G+IN2MuLS&)mfHRNut(%;anZ6Fnn63k6F{eFF=914D)6qRirw zN{8Ia;*!i{z0_j8l+uFyyb`_S{M?DV6n8K%Fld2|%S_KpEGaEYWk@zRFt#waFg8d` zG)YZPF-fe)lBATd3a!N{b-$VA&f+n^|#(~yCI Ofx*+&&t;ucLK6T%G-N*j literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/draft.png b/libs/predef/doc/html/images/draft.png new file mode 100644 index 0000000000000000000000000000000000000000..0084708c9b8287c51efa6b40b8d492854191455e GIT binary patch literal 17454 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 YsPxZ;53A2HFfcH9y85}Sb4q9e0Fi|iga7~l literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/home.png b/libs/predef/doc/html/images/home.png new file mode 100644 index 0000000000000000000000000000000000000000..5584aacb097a80e66a5320312b6e4eb017af1a06 GIT binary patch literal 358 zcmeAS@N?(olHy`uVBq!ia0y~yU=Rjj7G?$phK4%r{|pQa%*9TgAsieWw;%dHU|?WS z3GfMV6&Dfg?(A@OuseF>a6(*+nzF*onKLh6zO-%YmOy{sw6wJU|Nk%gvq74Hfq|za z$S?Rm0x$^OKX;CSfq}EYBeIx*fm;ZK886+f`@_J%pjzS@Q4*Y=R#Ki=l*-_nm|T>f zo0^iDsNj}alvU8YOY t9}F9JU6`43jMG5vNQA&8NcoN_f;wr$vARr(hAt9lu zscC6x>EvV>6{VS+EaBwj6ciMco$ZvI98_E!l$@NLot<4>UER|o(bHqOcQ41TYc{y!?kM?_wFg)yJvXsp5^oB z9Pi&Vyniq7|3Ab3{~Z7S3p{_W`TV)z`}cpO z$(;G%_wGG* z?AW<;=dNA5cJJQ3=g*(NfB*jb_wWDz|6hCQ@I3|w2F4_BcNgdM3%p4T42R|DNig) zWpL0?*7VFxOi%SqOwUZtRxr^s(z8&owA44S&^IttNG{4OE~#|Ltt>9dOx8;+)=McZ z$j>X$OU}=oxJz*d0|SE=*tpE}yu^~yqEv=t literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/next.png b/libs/predef/doc/html/images/next.png new file mode 100644 index 0000000000000000000000000000000000000000..59800b4e87f60c0e3383ede2b384b9be0f5ffe8d GIT binary patch literal 336 zcmeAS@N?(olHy`uVBq!ia0y~yU=Rjj7G?$phK4%r{|pQa%*9TgAsieWw;%dHU|?WS z3GfMV6&Dfg?(8r&Hr}>%OQ656nzF)*4nJa0`Jj)#l9-t%+}PK^d+g590~2^trx_V+aGYt)W#Kgko@Q{~>i6>w}LxPb)_bi1gN;4a>^d{wcn;SkfJR9T^xl_SO6joXo($ zppfhlZ{Pm>`SaViZ};!tyLt1*|NsBbojZ3P6EBL3=9l=JzX3_ zD&{0TNo#1Z_o+&KnDHU@)Rs;LG+GiER_Ffe$!`njxgN@xNAPfH=1 literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/note.png b/libs/predef/doc/html/images/note.png new file mode 100644 index 0000000000000000000000000000000000000000..d0c3c645ab9af6318035b026dd86944b9ddc9114 GIT binary patch literal 490 zcmeAS@N?(olHy`uVBq!ia0y~yV2}V|4h9AWhNCh`Dhvz^OiAAEE({E-dXuv&t)U99M06BF~bt=lC3t1z!y3OU-_; z>3=1k>J3(3i_72APIz-IDqpqc+E%+vGv;(%KfZ!%@4A+C&xmZ75-RagX8L}A{%x+r zX<~gz))PX{awr=ezabJ<%O$qq%HpE?3}IarYhrI#g}e)4`)(-lYr?KO{@fm?UzpsD z&F7x?_G;CcbIZ>^o0GCAMe@{JfwtZgS9s0dn=t$|`IrrC3yU6#%a-U6G$wZz0 z>m`@($9HNPdGJ4#pEvb;3eT@>Ck6%v=MvY5lHmNblJdl&R0anPWlhiA#Pn3(#PrPM zYy}fNBRvZROG|wN3w;Aah2)~l;*v^-+{)sT%w)aPV!f2og8aM^z2yAdiMtecFfcG^ zfsM;d&r2*RElOoDPD(L1F;6y4H8Hg?FgGwTOER!DNJ%kHHBU4$OExhPxjgw70|Nse jNLN5&dMbmFNrjP#wt==mQ8cF^C=xwg{an^LB{Ts5w*0vf literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/prev.png b/libs/predef/doc/html/images/prev.png new file mode 100644 index 0000000000000000000000000000000000000000..d88a40f923e3c554125f01cd366707c60cfcad04 GIT binary patch literal 334 zcmeAS@N?(olHy`uVBq!ia0y~yU=Rjj7G?$phK4%r{|pQa%*9TgAsieWw;%dHU|?WS z3GfMV6&DdqOG`60Hr}>%%ZlYo1O0u~loc*tzSP~>;p||S5Et|R|Noh1c$yg)73T~N2spa`a*~JRJ5eh~I1}5!gYtAz;Fo=OPI2WZRmSpDVDTHL^rZN~B=o=X8 z8<-ql-^0nkz!2u?;uumfC;0|1OPoRyGxLNShYX~Tl_Wf9G1_imu)%RA9}mw<0X2^e zQioc&m}WXSvRw^OFi2qFa&lm1W^U?K=~^Ook|m{hVvche^Q6-g?(V)Vn8U=toEqFE UkjD9gfq{X+)78&qol`;+00?PtqyPW_ literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/prev_disabled.png b/libs/predef/doc/html/images/prev_disabled.png new file mode 100644 index 0000000000000000000000000000000000000000..ab3c17e02d156e7494dbab2f9cd66af46af2358c GIT binary patch literal 1109 zcmeAS@N?(olHy`uVBq!ia0y~yU=Rjj4rT@h2G_o0{}>n;SkfJR9T^xl_SO6joXo($ zppfhlO-<`D(~2b}=LHv2RC7dZWAVCrDh<7Ss(U_A1L-MNQRp<#x>RYL|A z0d8w%7gb?npBLs13>ys`SR)0#F|i0-(0!9|ZvFp)$&5@KPtr;p8yJ{=^Qv)(GIJ<+ zNI0-0Zew5(Fj?c!G-tyG77m3Osc(4d6PFVdQ&MBb@ E0L^J1b^rhX literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/smiley.png b/libs/predef/doc/html/images/smiley.png new file mode 100644 index 0000000000000000000000000000000000000000..30a77f71ce16872d046a1a5d6fd698a2f65a3f62 GIT binary patch literal 867 zcmeAS@N?(olHy`uVBq!ia0y~yU=U|uV36QoW?*1YTQtp`fq{X!*vT`5gM;JtL;nX1 z42*&SJ|V8+B7&<|tz5IBw4@*~EXexT*H!m!O?Pp!sH>^CckiyDuKJ|Dl+(w%CQay1 zOYu8%=FGd73zHKgmoF}|u{3I~kKDVXVbQ_`9c`_Fz7{iQrl~4QMTGi1fByW=jcKLD z*?C#s*_rWAAIx@f)c16=+qAB-t1T`u&hzVsWjnTSn>lml<@5cSX&!B@jUfSci{|F_ z_w^KKXB!)+#6)_3`t<4gwQEt~&MzL%J+!ao-_JD<@64PzGws6Z-hv$8-Me=7btN{` zl~t96rKP3$c$&I9TcsogXQl?mL%y{W;-5&-92C)*?h!W?b)Wnj^{5*w_%-mE4Lj!$7BYguC zr{Y6*7#J8-K`Mgt(@M${i&7bU6O)Vbb5m0?6BXPti&D$;i?WLqd?OT$3=B-#%hsG{ zU|`huba4!+n3FrHHoVC|#v<-Y&ynX`2+ z)ci{*-@n^>-frGI_MA-9eHCQCFMs-NiTvCzJ8a&6h<9#D<(d3(^{E}JLTitR9GSK2 z$*O4*8tU!OHS*&Yg~mSMD)7~hd93j+u`cf5MM<4*zJ;yfFKhYEn9bv3Xeg3g;K-G= z;q?Q<5Qk-d*rznCncd{p+umG~t-YZ3L%_f9;YyrSd?k7nE}0j~xg-T!p1r_pXw_8J z^q9XtRP=q)pSk7_!?YePxacL!`8E4~v$oZii_iB4y^t?YSBana!LlH(Q{_whcc+EB z6^^opPM-68`QEg&=hc<^;brIeKBf1+k=uTZ@Aa)4^R8_EExPXM@|~g)-OB%bBP#i` ie0$=QHXfdLO8@!p%oni+1)dBH3=E#GelF{r5}E*N2(Kal literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/tip.png b/libs/predef/doc/html/images/tip.png new file mode 100644 index 0000000000000000000000000000000000000000..5c4aab3bb3543191c360387c4af9a3cbaa051345 GIT binary patch literal 449 zcmeAS@N?(olHy`uVBq!ia0y~yV31^BV36QoU|?X-y2mNSz`($iDJ87yAgr${wU6ATeb^ycE^w7cIp z?_W?xU6%d(bb~@Shbi-aG=ETBbm~(ogOmrW&bwBIxdt+K+A3yD;V_t}R>0LF5GN)x zed{W(mq$!1ciVpPy1}W+9bm)Xrgda~bSbG?a3DdjluYV+O9SdLnMpASqX+9EZY3c7C@7#N&OTq83NAIrA4U>si~GJ7Ut&0mS)MRMrP)TsYwQg=9VeOrfC+2Nk)mu rLdL(;85kJ&K)M1F(^DCYOe>5`v<1B4~iR4S3j3^P6tl1hi%%HopDWWCg4y_C{| z{JavqiARt`YJFJnVhX)qGzOMplv!L->5yAl zT#}irms+fsQd*FoSE84kpF44v;tmD|1}(60ndy0nC8b5F42emG<`xDZ$;L?r7Ky3J=GDKJX@I;2(iM=Hp2}coT4AYeplx7Y_5oxZgQu&X%Q~lo FCIGT9P(J_w literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/up.png b/libs/predef/doc/html/images/up.png new file mode 100644 index 0000000000000000000000000000000000000000..17d9c3ec491ae1ba22188ce85985623c92ffa9be GIT binary patch literal 370 zcmeAS@N?(olHy`uVBq!ia0y~yU=Rjj7G?$phK4%r{|pQa%*9TgAsieWw;%dHU|?X- z3h)VW6&DdqOG|Thu-mqE%ZlYoyE{8BU%nLR@2jS)FmvY2qel)W#Kk;%^zi@x|I?Un z*fKCM@RbDl1^-6|46X<6oM2#J;4JWnEM{Qf76M_$OLy!3FfcHvmbgZg1m~xflqVLY zGWaGY7v<-srer26xMdclmgg5`7c2NiC>R+Sn6#IzInThrAO_OlT$Gwvl9`{U5R#dj z%3x@qZ(yu%U~+tY4<`cyLy@P8V@SoEspmFwHW&!FJyeg_(XezvV9WvAI|r@_>dZZG zPW6aiOT!J--9O?NG0%AP;}ge|4lDQN4=-}8`?JGwx}?mMnO)OdyQdu$nQCjPRV}jm z$u!Qa8E-cQ-r3Nz>Y(YPTd#BPEH+&8GWqfD!}4*53%dA!%#3$cIv;a~fq{X+)78&q Iol`;+0POUaApigX literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/up_disabled.png b/libs/predef/doc/html/images/up_disabled.png new file mode 100644 index 0000000000000000000000000000000000000000..e22bc8712192df3a8faa3264b0ec71ff3aaaa96c GIT binary patch literal 1115 zcmeAS@N?(olHy`uVBq!ia0y~yU=Rjj4rT@h2G_o0{}>n;SkfJR9T^xl_SO6joXo($ zppfhl|Nrwy-~uYR zhzc&Dg3GAj3M#mY3a+7o>!{!cD!7RXZlQwPsNfDNxQhzzp@RFU-~lRlhzcH|g2$-f z2`YGs3Z9{Y=cwQXDtL(sUZH~5sNfAMc#8_&p@R3Q-~%f7hzdTTg3qYn3o7`E3cjI& z@2KDhD)@;CexZWjsNfGO_=^hup@RP~@T}IQi-CcGuO!GX7$yd$8C(zCIl;idaKO{W zF{ENn(v#GNhX4QTi=1XMFdktN{`IZ@p>>FWLcsvS9SfKMdlAq$6s7@ONV`8frfZ~QMdG-hBC2vApc;y96* zmcYQFpvLCIAmDK02m=$xYzYU3L}6wQg@_sdlHD~JI1CtW_~{utEVY`?z`(%Z>FVdQ I&MBb@06Fw0-2eap literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/images/warning.png b/libs/predef/doc/html/images/warning.png new file mode 100644 index 0000000000000000000000000000000000000000..1c33db8f34a8b42b373179b46a2d8d8a10e061a9 GIT binary patch literal 1241 zcmeAS@N?(olHy`uVBq!ia0y~yV2}V|4rT@hhU+WOo?>8NW(e>JaphoO5CF?5GB9W| zFc>m0I59AIF)#!%FhnshWHT@nGcZ&$Ftji*^e`|?VPKe2T|Fl#Xiikroa*YO3=B&x zEth(EEp2I8I%UezrAyZ`FswB+TsvjTRtAQxnwndCdbZA)vvujxty{P5WnkF5cJ1D+ zTaPg?91{>YCLwX`*s*gA4Ce#{&Phm|)6~4iz;I1d^V+p*_ZS%N-Mjakf#JEL;`8Uv z-!m}0=iqq%{{43bhVS3M|7T$MKMF=efJz}yVEuRs0|NtNlDE4HLkFv@2Ll7c3r`ov zkcwNmlWOyu3izvS7ejxP>R-!INP5f(XN|IS^C^Iyp?`SUk1vQO?s(K&l| zi|Nkt0@~*ymDp65*E-HED6u(s{Mfrxmah{JrgAMTIq)Du?nC5nnYTRgThA|azEdIl zD^uvV>~q(b?>`Fd;xnAbe7so1I$-&keKN}|vNNOCvX<~g{)wp7{&hR__v^cBU*Gq* zV3YS!cBPWsl#eNWc|~nAXWMOB8tQWBuXo=4>}cytyX_5F^Az{bVJ>7~U~n#RjVKAu zPb(=;EJ|f?&`{R&%uP&B^-WCAOwLv?(KFJsP_VSrH?Yt*FjPn`$}BFabjYnNF3C*R zOD)z*DJ{s)E742N&z-nSaR&nfgBIAh%=Em(lG377hGY|?B=Z!b6jL*k#Ka_13kwTN zLrZf@a|7cv1EVApQ-8txlNlHo_&~Y>64O%|j7%zwOtcNO4T_>U4H+017(8A5T-G@y GGywozG)2h( literal 0 HcmV?d00001 diff --git a/libs/predef/doc/html/index.html b/libs/predef/doc/html/index.html new file mode 100644 index 0000000..b87e7f7 --- /dev/null +++ b/libs/predef/doc/html/index.html @@ -0,0 +1,70 @@ + + + +Predef 1.0 + + + + + + +
+
+
Next
+
+
+
+

+Predef 1.0

+

+Rene Rivera +

+
+
+
+

+ 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) +

+
+
+
+
+ +
+ + + + + +
[Warning]Warning

+ This is a proposed Boost Libnrary and is not part of the Boost C++ Libraries. +

+
+ + + +

Last revised: November 30, 2011 at 05:42:16 GMT

+
+
Next
+ + diff --git a/libs/predef/doc/html/minimal.css b/libs/predef/doc/html/minimal.css new file mode 100644 index 0000000..401b73e --- /dev/null +++ b/libs/predef/doc/html/minimal.css @@ -0,0 +1,22 @@ +/* + + © Copyright Beman Dawes, 2007 + + Distributed under the Boost Software License, Version 1.0. + See www.boost.org/LICENSE_1_0.txt + +*/ + +/******************************************************************************* + Body +*******************************************************************************/ + +body { font-family: sans-serif; margin: 1em; } + +/******************************************************************************* + Table +*******************************************************************************/ + +table { margin: 0.5em; } + +/*** end ***/ \ No newline at end of file diff --git a/libs/predef/doc/html/predef/adding_new_predefs.html b/libs/predef/doc/html/predef/adding_new_predefs.html new file mode 100644 index 0000000..cefa8d4 --- /dev/null +++ b/libs/predef/doc/html/predef/adding_new_predefs.html @@ -0,0 +1,224 @@ + + + +Adding new predefs + + + + + + + + +
+
+
+PrevUpHomeNext +
+
+ +

+ We know that a library like this one will be an eternal work-in-progress. And + as such we expect, and look forward to, others contributing corrections and + additions to the predefs. With that in mind we need to keep a consistent way + of defining the new predefs. Hence all current, and future, predefs follow + the same structure and requirements. +

+

+ + Requirements + of the header +

+

+ All predefs need to follow a set of requirements: +

+
    +
  • + The headers must use the Boost Software License. +
  • +
  • + The predef must, by default, be defined as BOOST_VERSION_NUMBER(0,0,0). +
  • +
  • + The predef must be redefined to a non-zero value once detected. +
  • +
  • + The predef must, by default, be defined to BOOST_VERSION_NUMBER(0,0,1) when the predef is detected. +
  • +
  • + If possible, the predef will be defined as the version number detected. +
  • +
  • + The predef must declare itself, after being defined, for the testing system. +
  • +
+

+ And there are some extra guidelines that predef headers should follow: +

+
    +
  • + The detection should avoid including extra headers that might otherwise + not be included by default. +
  • +
  • + If the detection must include a header, prefer guarding it within the detection + if possible. +
  • +
  • + If the detection must include a headers unconditionally, and has a choice + 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. +
  • +
+

+ + Structure + of the header +

+

+ For general consistency it's suggested that new predef headers follow the structure + below, as current predef headers do. First we have the copyright and license + statement, followed by the include guard: +

+

+

+
/*
+Copyright Jane Doe YYYY
+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)
+*/
+
+#ifndef BOOST_PREDEF_category_tag_H
+#define BOOST_PREDEF_category_tag_H
+
+

+

+

+ Depending on how you are defining the predef you will at minimum have to include + the version_number.h header. But you might also want to include + the make.h header for the version number decomposing + utility macros: +

+

+

+
#include <boost/predef/version_number.h>
+#include <boost/predef/make.h>
+
+

+

+

+ The Predef library uses Quickbook for documentation and for the individual + predefs to appear in the reference section we add in-code documentation followed + by the zero-value default definition of the predef macro. We strongly recommend + this particular placement of the documentation and default definition because + some development environments automatically interpret this and provide in-line + help for the macro. In particular this works for the popular Eclipse IDE: +

+

+

+
/*`
+[heading `BOOST_category_tag`]
+
+Documentation about what is detected.
+*/
+
+#define BOOST_category_tag BOOST_VERSION_NUMBER(0,0,0)
+
+

+

+

+ Next is the detection and definition of the particular predef. The structure + for this is to do a single overall check (condition_a) + and place the further version detection inside this. The first action inside + 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 for + defining the version. But at minimum it must "#define + BOOST_category_tag BOOST_VERSION_NUMBER(0,0,1)" as the fallback to minimally indicate + that the predef was detected: +

+

+

+
#if (condition_a)
+    #undef BOOST_category_tag
+    #if (condition_b)
+        #define BOOST_category_tag BOOST_VERSION_NUMBER(major,minor,patch)
+    #else
+        #define BOOST_category_tag BOOST_VERSION_NUMBER(0,0,1)
+    #endif
+#endif
+
+

+

+

+ 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 + predef to the test system. This declaration is empty for regular use. And during + the test programs theexpand out specially to create informational output: +

+

+

+
#include <boost/predef/detail/test.h>
+BOOST_PREDEF_DECLARE_TEST(BOOST_category_tag,"Name")
+
+

+

+

+ And, of course, we last need to close out the include guard: +

+

+

+
#endif
+
+

+

+

+ + Using utility + pattern macros +

+

+ By including: +

+

+

+
#include <boost/predef/make.h>
+
+

+

+

+ One will get a set utlity macros to decompose common version macros as defined + by compilers. For example the EDG compiler uses a simple 3-digit version macro + (M,N,P). It can be decomesed and defined as: +

+

+

+
#define BOOST_CXX_EDG BOOST_PREDEF_MAKE_N_N_N(__EDG_VERSION__)
+
+

+

+

+ The decomposition macros are split into three types: decimal decomposition, + hexadecimal decomposition, and date decomposition. They follow the format of + using "N" for decimal, "F" for hexadecimal, and "Y", + "M", "D" for dates. +

+
+ + + +
+
+
+PrevUpHomeNext +
+ + diff --git a/libs/predef/doc/html/predef/introduction.html b/libs/predef/doc/html/predef/introduction.html new file mode 100644 index 0000000..df0df4a --- /dev/null +++ b/libs/predef/doc/html/predef/introduction.html @@ -0,0 +1,199 @@ + + + +Introduction + + + + + + + + +
+
+
+PrevUpHomeNext +
+
+ +

+ This library defines a set of compiler, architecture, operating system, and + library version numbers from the information it can gather of C++ predefined + macros or those defined in generally available headers. The idea for this library + grew out of a proposal to extend the Boost Config library to provide more, + and consistent, information than the feature definitions it supports. What + follows is an edited version of that brief proposal. +

+

+ + Proposal +

+

+ The idea is to define a set of macros to identify compilers and consistently + represent their version. This includes: +

+
    +
  • + A unique BOOST_VERSION_NUMBER(major,minor,patch) macro to specify version + numbers (unfortunately, the name BOOST_VERSION is already taken to designate + the version number of boost itself). +
  • +
  • + A compiler identification macro, suitable for use in #if/#elif directives, + 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 be defined, in terms of BOOST_VERSION_NUMBER, to carry the exact + compiler version. All other macros would expand to an expression evaluating + to false (for instance, the token 0) to indicate that the corresponding + compiler is not present. +
  • +
  • + "Null values" could be set, for all macros, in boost/config/select_compiler.hpp; + then, for each compiler 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 infrastructure using a "prefix" + header (to be introduced) or boost/config/suffix.hpp is a better solution. + This point is further clarified later. +
  • +
+

+ + Current + Library +

+

+ The current Predef library is now, both an independent library, and expanded + in scope. It includes detection and definition of architectures, compilers, + languages, libraries, and operating systems. The key benefits are: +

+
    +
  • + Version numbers that are always defined so that one doesn't have to guard + with #ifdef. +
  • +
  • + All possible definitions are included with the single #include + <boost/predef.h> + so that it's friendly to precompiled header usage. +
  • +
  • + Predefs can be directly used in both preprocessor and compiler expressions + for comparison to other similarly defined values. +
  • +
  • + The headers are usable from multiple languages, that support the C preprocessor. + In particular C++, C, Objective C, and Objective C++. +
  • +
+

+ + Design + choices +

+

+ An important design choice concerns how to represent compiler versions by means + of a single integer number suitable for use in preprocessing directives. Let's + do some calculation. The "basic" signed type for preprocessing constant-expressions + is long in C90 (and C++, as of 2006) and intmax_t in C99. The type long shall + at least be able to represent the number +2 147 483 647. + This means the most significant digit can only be 0, 1 or 2; and if we want + all decimal digits to be able to vary between 0 and 9, the largest range we + can consider is [0, 999 999 999]. Distributing evenly, this + means 3 decimal digits for each version number part. +

+

+ So we can: +

+
    +
  1. + use an uneven distribution or +
  2. +
  3. + use more bits (a larger type) or +
  4. +
  5. + use 3/3/3 and have the particular compiler/platform/stdlib deal with setting + the numbers within the 3-digit range. +
  6. +
+

+ It appears relatively safe to go for the first option and set it at 2/2/5. + That covers CodeWarrior and others, which are up to and past 10 for the major + number. Some compilers use the build number in lieu of the patch one; five + digits (which is already reached by VC++ 8) seems a reasonable limit even in + this case. +

+
+ + + + + +
[Note]Note

+ A 2/2/6 scheme would allow for bigger patch/build numbers at the cost, for + instance, of limiting the major version number to 20 (or, with further constraints, + to 21). +

+

+ It might reassure the reader that this decision is actually encoded in one + place in the code; the definition of BOOST_VERSION_NUMBER. +

+

+ + Future + work +

+

+ Even though the basics of this library are done, there is much work that can + be done: +

+
    +
  • + Right now we limit the detection of libraries to known built-in predefined + macros, and to guaranteed to exist system and library headers. It might + be interesting to add something like auto-configuration predefs. This way + we can add definitions for user specific libraries and features. +
  • +
  • + Along with the above, it might be good to add some user control as to which + headers are included with the top-level header. +
  • +
  • + Additionally, even if there is no auto-configure style option.. It would + be good to add optionally included headers so that user can get consistent + version number definitions for libraries they use. +
  • +
  • + Having a consistent set of version number definitions opens the door to + improving the user level syntax of libraries that do checks against version + numbers. Specifically Boost Config's BOOST_WORKAROUND + macro would benefit from a more readable syntax. As would the BOOST_TESTED_AT detail macro. +
  • +
  • + And obviously there's lots of work to do in reformulating the existing + Boost libraries to use the Predef library once it's accepted. +
  • +
  • + And there's the continuing work of adding definitions for present and future + compilers, platforms, architectures, languages, and libraries. +
  • +
+
+ + + +
+
+
+PrevUpHomeNext +
+ + diff --git a/libs/predef/doc/html/predef/reference.html b/libs/predef/doc/html/predef/reference.html new file mode 100644 index 0000000..b238c41 --- /dev/null +++ b/libs/predef/doc/html/predef/reference.html @@ -0,0 +1,875 @@ + + + +Reference + + + + + + + +
+
+
+PrevUpHome +
+
+ + +
+ +
+ + BOOST_ARCHITECTURE_ALPHA +
+

+ DEC Alpha architecture: + If available versions [4-6] are specifically detected. +

+
+ + BOOST_ARCHITECTURE_AMD64 +
+

+ American Micro Devices AMD + 64 architecture. +

+
+ + BOOST_ARCHITECTURE_ARM +
+

+ ARM architecture. +

+
+ + BOOST_ARCHITECTURE_CONVEX +
+

+ Convex Computer + architecture. +

+
+ + BOOST_ARCHITECTURE_IA64 +
+

+ Intel IA-64 architecture. +

+
+ + BOOST_ARCHITECTURE_M68K +
+

+ Motorola 68k architecture. +

+
+ + BOOST_ARCHITECTURE_MIPS +
+

+ MIPS + architecture. +

+
+ + BOOST_ARCHITECTURE_PARISK +
+

+ HP/PA RISC + architecture. +

+
+ + BOOST_ARCHITECTURE_PPC +
+

+ PowerPC architecture. +

+
+ + BOOST_ARCHITECTURE_PYRAMID +
+

+ Pyramid 9810 architecture. +

+
+ + BOOST_ARCHITECTURE_RS6000 +
+

+ RS/6000 architecture. +

+
+ + BOOST_ARCHITECTURE_SPARC +
+

+ SPARC architecture. +

+
+ + BOOST_ARCHITECTURE_SH +
+

+ SuperH architecture: + If available versions [1-5] are specifically detected. +

+
+ + BOOST_ARCHITECTURE_SYS370 +
+

+ System/370 architecture. +

+
+ + BOOST_ARCHITECTURE_SYS390 +
+

+ System/390 architecture. +

+
+ + BOOST_ARCHITECTURE_X86 +
+

+ Intel x86 architecture: + If available versions [3-6] are specifically detected. +

+
+ + BOOST_ARCHITECTURE_Z +
+

+ z/Architecture + architecture. +

+
+
+ +
+ + BOOST_CXX_BORLAND +
+

+ Borland compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_COMO +
+

+ Comeau compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_DEC +
+

+ Compaq DEC compiler. + Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_CYGWIN +
+

+ Cygwin compiler. +

+
+ + BOOST_CXX_DIAB +
+

+ Diab compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_DMC +
+

+ Digital Mars compiler. + Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_SYSC +
+

+ Dignus SysC compiler. + Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_EDG +
+

+ EDG compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_PATH +
+

+ Ekopath compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_GNUC +
+

+ Gnu C/C++ compiler. + Version number available as major, minor, and patch (if available). +

+
+ + BOOST_CXX_GCCXML +
+

+ GCC XML compiler. +

+
+ + BOOST_CXX_GHS +
+

+ Green Hills compiler. + Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_HPACC +
+

+ HP ACC compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_IAR +
+

+ IAR compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_IBM +
+

+ Iternational Business Mchines + compiler. Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_INTEL +
+

+ Intel compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_KCC +
+

+ Kai compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_LLVM +
+

+ LLVM compiler. +

+
+ + BOOST_CXX_HIGHC +
+

+ Metaware HighC compiler. +

+
+ + BOOST_CXX_MWERKS +
+

+ Metrowerks compiler. + Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_MRI +
+

+ Microtec compiler. +

+
+ + BOOST_CXX_MINGW +
+

+ MinGW compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_MPW +
+

+ MPW compiler. Version + number available as major, and minor. +

+
+ + BOOST_CXX_PALM +
+

+ Palm compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_PGI +
+

+ PGI compiler. +

+
+ + BOOST_CXX_SGI +
+

+ SGI Mips-pro compiler. + Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_SUNPRO +
+

+ Sun Pro compiler. Version + number available as major, minor, and patch. +

+
+ + BOOST_CXX_TENDRA +
+

+ Tendra compiler. +

+
+ + BOOST_CXX_MSVC +
+

+ Microsoft Visual C/C++ + compiler. Version number available as major, minor, and patch. +

+
+ + BOOST_CXX_WATCOM +
+

+ Watcom compiler. Version + number available as major, and minor. +

+
+
+ +
+ + BOOST_LANGUAGE_OBJC +
+

+ Objective-C + language. +

+
+ + BOOST_LANGUAGE_STDC +
+

+ Standard + C language. If available, the year of the standard is detected as + 0.0.YYYY. +

+
+ + BOOST_LANGUAGE_STDCPP +
+

+ Standard C++ language. + If available, the year of the standard is detected as 0.0.YYYY. Because of + the way the C++ standardization process works the defined version year will + not be the commonly known year standard. Specifically the defined versions + will be: +

+
+

Table 1. Detected Version Number vs. C++ Standard Year

+
+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

+ Detected Version Number +

+
+

+ Standard Year +

+
+

+ C++ Standard +

+
+

+ 0.0.1997 +

+
+

+ 1998 +

+
+

+ ISO/IEC 14882:1998 +

+
+

+ 0.0.? +

+
+

+ 2003 +

+
+

+ ISO/IEC 14882:2003 +

+
+

+ 0.0.? +

+
+

+ 2007 +

+
+

+ ISO/IEC TR 19768:2007 +

+
+

+ 0.0.2011 +

+
+

+ 2011 +

+
+

+ ISO/IEC 14882:2011 +

+
+
+
+ + BOOST_LANGUAGE_STDCPPCLI +
+

+ Standard C++/CLI + language. If available, the year of the standard is detected as 0.0.YYYY. +

+
+ + BOOST_LANGUAGE_STDECPP +
+

+ Standard Embedded + C++ language. +

+
+
+ +
+ + BOOST_LIBC_GNU +
+

+ GNU glibc Standard + C library. Version number available as major, and minor. +

+
+ + BOOST_LIBC_UC +
+

+ uClibc Standard + C library. Version number available as major, minor, and patch. +

+
+ + BOOST_LIBC_VMS +
+

+ VMS libc Standard C library. Version number available as major, minor, and + patch. +

+
+ + BOOST_LIBC_ZOS +
+

+ z/OS libc Standard C library. Version number available as major, minor, and + patch. +

+
+ + BOOST_LIBSTD_CXX +
+

+ libc++ C++ Standard Library. + If available version number as major, minor, and patch. +

+
+ + BOOST_LIBSTD_DINKUMWARE +
+

+ Dinkumware Standard + C++ Library. If available version number as major, minor, and patch. +

+
+ + BOOST_LIBSTD_COMO +
+

+ Comeau Computing + Standard C++ Library. Version number available as major. +

+
+ + BOOST_LIBSTD_MSIPL +
+

+ Modena Software Lib++ Standard C++ + Library. +

+
+ + BOOST_LIBSTD_MSL +
+

+ Metrowerks Standard C++ Library. + Version number available as major, minor, and patch. +

+
+ + BOOST_LIBSTD_RW +
+

+ Roguewave Standard C++ + library. If available version number as major, minor, and patch. +

+
+ + BOOST_LIBSTD_SGI +
+

+ SGI Standard C++ library. + If available version number as major, minor, and patch. +

+
+ + BOOST_LIBSTD_GNU +
+

+ GNU libstdc++ Standard + C++ library. Version number available as year (from 1970), month, and day. +

+
+ + BOOST_LIBSTD_STLPORT +
+

+ STLport Standard C++ + library. Version number available as major, minor, and patch. +

+
+ + BOOST_LIBSTD_IBM +
+

+ IBM VACPP Standard C++ + library. +

+
+
+ +
+ + BOOST_OS_ +
+

+ AIX operating system. + Version number available as major, minor, and patch. +

+
+ + BOOST_OS_AMIGAOS +
+

+ AmigaOS operating system. +

+
+ + BOOST_OS_BEOS +
+

+ Be operating system. +

+
+ + BOOST_OS_BSD +
+

+ BSD operating system. +

+

+ BSD has various branch operating systems possible and each detected individually. + This detects the following variations and sets a specific version number + macro to match: +

+
+
+ + + + + +
[Note]Note

+ The general BOOST_OS_BSD + is set in all cases to indicate some form of BSD. If the above variants + is detected the corresponding macro is also set. +

+
+
+ +
+ + BOOST_VERSION_NUMBER +
+

+

+
BOOST_VERSION_NUMBER(major,minor,patch)
+
+

+

+

+ Defines standard version numbers, with these properties: +

+
    +
  • + Decimal base whole numbers in the range [0,1000000000). The number range + is designed to allow for a (2,2,5) triplet. Which fits within a 32 bit + value. +
  • +
  • + The major number can + be in the [0,99] range. +
  • +
  • + The minor number can + be in the [0,99] range. +
  • +
  • + The patch number can + be in the [0,99999] range. +
  • +
  • + Values can be specified in any base. As the defined value is an constant + expression. +
  • +
  • + Value can be directly used in both preprocessor and compiler expressions + for comparison to other similarly defined values. +
  • +
  • + The implementation enforces the individual ranges for the major, minor, + and patch numbers. And values over the ranges are truncated (modulo). +
  • +
+
+ + BOOST_PREDEF_MAKE_F.. + macros +
+

+ These set of macros decompose common vendor version number macros which are + composed of hexadecimal digits. The naming convention indicates what the + format of the vendor version number. Where "F" + indicates a hexadecimal digit, "_" + separates the major/minor/patch parts of the version number, and "0" indicates an ignored hexadecimal digit. + Macros are: +

+

+ BOOST_PREDER_MAKE_F_F_F(V) +

+

+ BOOST_PREDEF_MAKE_FF_F_F(V) +

+

+ BOOST_PREDEF_MAKE_F_F_FF(V) +

+

+ BOOST_PREDEF_MAKE_FF_FF(V) +

+

+ BOOST_PREDEF_MAKE_F_FF_FFFF(V) +

+

+ BOOST_PREDEF_MAKE_FF_FF_F(V) +

+

+ BOOST_PREDEF_MAKE_F_FF_FF_000(V) +

+
+ + BOOST_PREDEF_MAKE_N.. + macros +
+

+ These set of macros decompose common vendor version number macros which are + composed of decimal digits. The naming convention indicates what the format + of the vendor version number. Where "N" + indicates a decimal digit, "_" + separates the major/minor/patch parts of the version number, and "0" indicates an ignored decimal digit. + Macros are: +

+

+ BOOST_PREDEF_MAKE_N_N_N(V) +

+

+ BOOST_PREDEF_MAKE_NN_NN_NN(V) +

+

+ BOOST_PREDEF_MAKE_NN_NN(V) +

+

+ BOOST_PREDEF_MAKE_N_N_NN(V) +

+

+ BOOST_PREDEF_MAKE_N_NN_NN(V) +

+

+ BOOST_PREDEF_MAKE_N_N_N_000(V) +

+

+ BOOST_PREDEF_MAKE_N_NN_000(V) +

+

+ BOOST_PREDEF_MAKE_NN_NN_00_NN_00(V) +

+

+ BOOST_PREDEF_MAKE_NN_00(V) +

+

+ BOOST_PREDEF_MAKE_YYYY_MM_DD(V) +

+
+
+ + + +
+
+
+PrevUpHome +
+ + diff --git a/libs/predef/doc/html/predef/using_the_predefs.html b/libs/predef/doc/html/predef/using_the_predefs.html new file mode 100644 index 0000000..8318d70 --- /dev/null +++ b/libs/predef/doc/html/predef/using_the_predefs.html @@ -0,0 +1,218 @@ + + + +Using the predefs + + + + + + + + +
+
+
+PrevUpHomeNext +
+
+ +

+ To use the automatically defined predefs one needs to only include the single + top-level header: +

+

+

+
#include <boost/predef.h>
+
+

+

+

+ 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 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 macros of a particular prefix: +

+
    +
  • + BOOST_ARCHITECTURE_for + system/CPU architecture one is compiling for. +
  • +
  • + BOOST_CXX_ for the compiler + one is using. +
  • +
  • + BOOST_LANGUAGE_ for language + standards one is compiling against. +
  • +
  • + BOOST_LIBC_ and BOOST_LIBSTD_ for the C and C++ standard + library in use. +
  • +
  • + BOOST_OS_ for the operating + system we are compiling to. +
  • +
+
+ + + + + +
[Note]Note

+ The detected definitions are for the configuration one is targeting during + the compile. In particular in a cross-compile this means the target system, + and not the host system. +

+

+ One uses the individual definitions to compare against specific versions by + comparing against the BOOST_VERSION_NUMBER + macro. For example, to make a choice based on the version of the GCC C++ compiler + one would: +

+

+

+
#include <boost/predef.h>
+#include <iostream>
+
+int main()
+{
+  if (BOOST_CXX_GNUC >= BOOST_VERSION_NUMBER(4,0,0))
+    std::cout << "GCC compiler is at least version 4.0.0" << std::endl;
+  else
+    std::cout << "GCC compiler is at older than version 4.0.0, or not a GCC compiler" << std::endl;
+  return 0;
+}
+
+

+

+

+ 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 specifically test for the detection. All predef definitions + are defined as a zero (0) expression when not detected. Hence one could use + the detection with a natural single condition. For example: +

+

+

+
#include <boost/predef.h>
+#include <iostream>
+
+int main()
+{
+  if (BOOST_CXX_GNUC)
+    std::cout << "This is GNU GCC!" << std::endl;
+  else
+    std::cout << "Not GNU GCC." << std::endl;
+  return 0;
+}
+
+

+

+

+ And since the predef's are preprocessor definitions the same is possible from + the preprocessor: +

+

+

+
#include <boost/predef.h>
+#include <iostream>
+
+#if BOOST_CXX_GNUC
+  #if BOOST_CXX_GNUC >= BOOST_VERSION_NUMBER(4,0,0)
+    const char * the_compiler = "GNU GCC, of at least version 4."
+  #else
+    const char * the_compiler = "GNU GCC, less than version 4."
+  #endif
+#else
+  const char * the_compiler = "Not GNU GCC."
+#endif
+
+int main()
+{
+  std::cout << the_compiler << std::endl;
+  return 0;
+}
+
+

+

+

+ + Using the + BOOST_VERSION_NUMBER macro +

+

+ All the predefs are defined to be a use of the BOOST_VERSION_NUMBER + macro. The macro takes individual major, minor, and patch value expressions: +

+

+

+
#define BOOST_VERSION_NUMBER( major, minor, patch ) ...
+
+

+

+

+ The arguments are: +

+
    +
  1. + Major version number, as a constant value expression in the range [0,99]. +
  2. +
  3. + Minor version number, as a constant value expression in the range [0,99]. +
  4. +
  5. + Patch-level version number, as a constant value expression in the range + [0,99999]. +
  6. +
+

+ 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 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, or non-detections. It is up to the individual predefs to + ensure correct usage beyond the range guarantee. +

+

+ The values for the arguments can be any preprocessor valid constant value expression. + Only constant value arithmetic is used in the definition of the BOOST_VERSION_NUMBER macro and in any of + the other predef macros. This means that any allowed base is possible, i.e. + binary, octal, decimal, and hexadecimal. For example: +

+

+

+
#define MY_APPLICATION_VERSION_NUMBER BOOST_VERSION_NUMBER(2,0xA,015)
+
+

+

+

+ Is equivalent to: +

+

+

+
#define MY_APPLICATION_VERSION_NUMBER BOOST_VERSION_NUMBER(2,10,13)
+
+

+

+
+ + + +
+
+
+PrevUpHomeNext +
+ + diff --git a/libs/predef/doc/html/reference.css b/libs/predef/doc/html/reference.css new file mode 100644 index 0000000..6826962 --- /dev/null +++ b/libs/predef/doc/html/reference.css @@ -0,0 +1,11 @@ +/*============================================================================ + Copyright 2003-2004 Douglas Gregor + Distributed under the Boost Software License, Version 1.0. (See accompany- + ing file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) +============================================================================*/ + +PRE.synopsis { + background-color: #e0ffff; + border: thin solid blue; + padding: 1em +} \ No newline at end of file diff --git a/libs/predef/doc/predef.qbk b/libs/predef/doc/predef.qbk index 99f6964..7ad3a34 100644 --- a/libs/predef/doc/predef.qbk +++ b/libs/predef/doc/predef.qbk @@ -9,9 +9,12 @@ (See accompanying file LICENSE_1_0.txt or copy at [@http://www.boost.org/LICENSE_1_0.txt]) ] - [source-mode teletype] + [source-mode c++] ] +[warning This is a *proposed* Boost Libnrary and *is not* part of the +Boost C++ Libraries.] + [section Introduction] This library defines a set of compiler, architecture, operating system, @@ -49,7 +52,7 @@ consistently represent their version. This includes: The current Predef library is now, both an independent library, and expanded in scope. It includes detection and definition of architectures, compilers, -libraries, and operating systems. The key benefits are: +languages, libraries, and operating systems. The key benefits are: * Version numbers that are always defined so that one doesn't have to guard with `#ifdef`. @@ -89,7 +92,7 @@ for instance, of limiting the major version number to 20 (or, with further constraints, to 21).] It might reassure the reader that this decision is actually encoded in one place -in the code; the definition of BOOST_VERSION_NUMBER. +in the code; the definition of `BOOST_VERSION_NUMBER`. [heading Future work] @@ -112,7 +115,7 @@ done: * And obviously there's lots of work to do in reformulating the existing Boost libraries to use the Predef library once it's accepted. * And there's the continuing work of adding definitions for present and - future compilers, platforms, architectures, and libraries. + future compilers, platforms, architectures, languages, and libraries. [endsect] [/Introduction] @@ -128,11 +131,12 @@ single top-level header: 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 the particular item is not detected, and to a /positive/ value if it -is detected. The predef macros fall onto the four categories each with +is detected. The predef macros fall onto the five categories each with macros of a particular prefix: * `BOOST_ARCHITECTURE_`for system/CPU architecture one is compiling for. * `BOOST_CXX_` for the compiler one is using. +* `BOOST_LANGUAGE_` for language standards one is compiling against. * `BOOST_LIBC_` and `BOOST_LIBSTD_` for the C and C++ standard library in use. * `BOOST_OS_` for the operating system we are compiling to. @@ -141,41 +145,149 @@ macros of a particular prefix: during the compile. In particular in a cross-compile this means the target system, and not the host system.] +One uses the individual definitions to compare against specific versions +by comparing against the `BOOST_VERSION_NUMBER` macro. For example, to make +a choice based on the version of the GCC C++ compiler one would: + `` #include #include - #if (APPLICATION_VERSION >= BOOST_VERSION_NUMBER(1,0,0)) - bool application_is_at_least_version_1 = true; - #else - bool application_is_at_least_version_1 = false; - #endif - int main() { - if (application_is_at_least_version_1) - std::cout << "Application is at least version 1.0.0" << std::endl; - if (APPLICATION_VERSION >= BOOST_VERSION_NUMBER(2,0,0)) - std::cout << "Application is at least version 2.0.0" << std::endl; + if (BOOST_CXX_GNUC >= BOOST_VERSION_NUMBER(4,0,0)) + std::cout << "GCC compiler is at least version 4.0.0" << std::endl; + else + std::cout << "GCC compiler is at older than version 4.0.0, or not a GCC compiler" << std::endl; return 0; } `` -[heading Using existing version predefs] +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 +specifically test for the detection. All predef definitions are defined +as a zero (0) expression when not detected. Hence one could use the +detection with a natural single condition. For example: + +`` + #include + #include + + int main() + { + if (BOOST_CXX_GNUC) + std::cout << "This is GNU GCC!" << std::endl; + else + std::cout << "Not GNU GCC." << std::endl; + return 0; + } +`` + +And since the predef's are preprocessor definitions the same is possible +from the preprocessor: + +`` + #include + #include + + #if BOOST_CXX_GNUC + #if BOOST_CXX_GNUC >= BOOST_VERSION_NUMBER(4,0,0) + const char * the_compiler = "GNU GCC, of at least version 4." + #else + const char * the_compiler = "GNU GCC, less than version 4." + #endif + #else + const char * the_compiler = "Not GNU GCC." + #endif + + int main() + { + std::cout << the_compiler << std::endl; + return 0; + } +`` [heading Using the `BOOST_VERSION_NUMBER` macro] +All the predefs are defined to be a use of the `BOOST_VERSION_NUMBER` macro. +The macro takes individual major, minor, and patch value expressions: + +`` + #define BOOST_VERSION_NUMBER( major, minor, patch ) ... +`` + +The arguments are: + +# Major version number, as a constant value expression in the range [0,99]. +# Minor version number, as a constant value expression in the range [0,99]. +# Patch-level version number, as a constant value expression in the + range [0,99999]. + +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 +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, +or non-detections. It is up to the individual predefs to ensure correct +usage beyond the range guarantee. + +The values for the arguments can be any preprocessor valid constant value expression. +Only constant value arithmetic is used in the definition of the `BOOST_VERSION_NUMBER` +macro and in any of the other predef macros. This means that any allowed base is +possible, i.e. binary, octal, decimal, and hexadecimal. For example: + +`` + #define MY_APPLICATION_VERSION_NUMBER BOOST_VERSION_NUMBER(2,0xA,015) +`` + +Is equivalent to: + +`` + #define MY_APPLICATION_VERSION_NUMBER BOOST_VERSION_NUMBER(2,10,13) +`` + [endsect] [section Adding new predefs] +We know that a library like this one will be an eternal work-in-progress. And +as such we expect, and look forward to, others contributing corrections and +additions to the predefs. With that in mind we need to keep a consistent way +of defining the new predefs. Hence all current, and future, predefs follow +the same structure and requirements. + [heading Requirements of the header] +All predefs need to follow a set of requirements: + +* The headers must use the Boost Software License. +* The predef must, by default, be defined as `BOOST_VERSION_NUMBER(0,0,0)`. +* The predef must be redefined to a non-zero value once detected. +* The predef must, by default, be defined to `BOOST_VERSION_NUMBER(0,0,1)` + when the predef is detected. +* If possible, the predef will be defined as the version number detected. +* The predef must declare itself, after being defined, for the testing + system. + +And there are some extra guidelines that predef headers should follow: + +* The detection should avoid including extra headers that might otherwise + not be included by default. +* If the detection must include a header, prefer guarding it within the + detection if possible. +* If the detection must include a headers unconditionally, and has a choice + 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. + [heading Structure of the header] +For general consistency it's suggested that new predef headers follow the +structure below, as current predef headers do. First we have the copyright +and license statement, followed by the include guard: + `` /* -Copyright Jane Doe 20xx +Copyright Jane Doe YYYY 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) @@ -183,49 +295,117 @@ http://www.boost.org/LICENSE_1_0.txt) #ifndef BOOST_PREDEF_category_tag_H #define BOOST_PREDEF_category_tag_H +`` +Depending on how you are defining the predef you will at minimum have +to include the `version_number.h` header. But you might also want to +include the `make.h` header for the version number decomposing utility +macros: + +`` #include #include +`` + +The Predef library uses Quickbook for documentation and for the +individual predefs to appear in the reference section we add in-code +documentation followed by the zero-value default definition of the +predef macro. We strongly recommend this particular placement of the +documentation and default definition because some development +environments automatically interpret this and provide in-line help +for the macro. In particular this works for the popular Eclipse IDE: + +`` +/*` +[heading `BOOST_category_tag`] + +Documentation about what is detected. +*/ #define BOOST_category_tag BOOST_VERSION_NUMBER(0,0,0) +`` -#if defined(condition) +Next is the detection and definition of the particular predef. The +structure for this is to do a single overall check (`condition_a`) and +place the further version detection inside this. The first action inside +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 +for defining the version. But at minimum it must +"`#define BOOST_category_tag BOOST_VERSION_NUMBER(0,0,1)`" as the fallback +to minimally indicate that the predef was detected: + +`` +#if (condition_a) #undef BOOST_category_tag - #if defined(condition) - #define BOOST_category_tag BOOST_VERSION_NUMBER(1,0,0) - #elif defined(__alpha_ev5__) - #define BOOST_category_tag BOOST_VERSION_NUMBER(2,0,0) + #if (condition_b) + #define BOOST_category_tag BOOST_VERSION_NUMBER(major,minor,patch) #else #define BOOST_category_tag BOOST_VERSION_NUMBER(0,0,1) #endif #endif +`` +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 predef to the test system. This declaration is empty for +regular use. And during the test programs theexpand out specially +to create informational output: + +`` #include -BOOST_PREDEF_DECLARE_TEST(BOOST_categiry_tag,"Name") +BOOST_PREDEF_DECLARE_TEST(BOOST_category_tag,"Name") +`` +And, of course, we last need to close out the include guard: + +`` #endif `` [heading Using utility pattern macros] +By including: + +`` +#include +`` + +One will get a set utlity macros to decompose common version +macros as defined by compilers. For example the EDG compiler +uses a simple 3-digit version macro (M,N,P). It can be decomesed +and defined as: + +`` +#define BOOST_CXX_EDG BOOST_PREDEF_MAKE_N_N_N(__EDG_VERSION__) +`` + +The decomposition macros are split into three types: decimal +decomposition, hexadecimal decomposition, and date decomposition. +They follow the format of using "N" for decimal, "F" for hexadecimal, +and "Y", "M", "D" for dates. + [endsect] [section Reference] [section `BOOST_ARCHITECTURE_` architecture macros] -[/import ../../../boost/predef/architecture/.*\.h] +[include ../../../boost/predef/architecture/*.h] [endsect] [section `BOOST_CXX_` compiler macros] -[/import ../../../boost/predef/compiler/.*\.h] +[include ../../../boost/predef/compiler/*.h] +[endsect] + +[section `BOOST_LANGUAGE_` language standards macros] +[include ../../../boost/predef/language/*.h] [endsect] [section `BOOST_LIBC_` and `BOOST_LIBSTD_` library macros] -[/import ../../../boost/predef/library/.*/.*\.h] +[include ../../../boost/predef/library/*/*.h] [endsect] [section `BOOST_OS_` operating system macros] -[/import ../../../boost/predef/os/.*\.h] +[include ../../../boost/predef/os/*.h] [endsect] [section Version definition macros] diff --git a/libs/predef/test/build.jam b/libs/predef/test/build.jam index 2d8276a..6dcbd1d 100644 --- a/libs/predef/test/build.jam +++ b/libs/predef/test/build.jam @@ -11,9 +11,11 @@ project test using testing ; -run info_as_cpp.cpp ; -run info_as_c.c ; -run info_as_objcpp.mm ; -run info_as_objc.m ; -run version.cpp ; -run make.cpp ; +test-suite config : + [ run info_as_cpp.cpp : : : always_show_run_output ] + [ run info_as_c.c : : : always_show_run_output ] + [ run info_as_objcpp.mm : : : always_show_run_output ] + [ run info_as_objc.m : : : always_show_run_output ] + [ run version.cpp ] + [ run make.cpp ] + ;