diff --git a/doc/config.qbk b/doc/config.qbk index 0bd3d321..0b02ee80 100644 --- a/doc/config.qbk +++ b/doc/config.qbk @@ -29,7 +29,7 @@ Distributed under the Boost Software License, Version 1.0. [/ Other web resources ] [def __STL_PORT__ [@http://stlport.sourceforge.net STLport]] -[def __BOOST_TRACKER__ [@http://sourceforge.net/tracker/?group_id=7586 Tracker]] +[def __BOOST_TRACKER__ [@https://svn.boost.org/trac/boost/newticket Trac]] [def __CORE_LANGUAGE_DR337__ [@http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#337 Core Language DR337]] [def __PRINCIPLES_AND_PATTERNS_ARTICLE__ [@http://www.objectmentor.com/resources/articles/Principles_and_Patterns.pdf following article]] diff --git a/doc/guidelines.qbk b/doc/guidelines.qbk index d1d78fa6..83f6418e 100644 --- a/doc/guidelines.qbk +++ b/doc/guidelines.qbk @@ -112,8 +112,8 @@ filename limit though. You will also need to provide a function prototype "`int test()`" that is declared in a namespace with the same name as the macro, but in all lower case, and which returns zero on success: - namespace boost_no_foo { + namespace boost_no_foo { int test() { // test code goes here: @@ -126,14 +126,18 @@ but in all lower case, and which returns zero on success: Once the test code is in place in libs/config/test, updating the configuration test system proceeds as: -* cd into `libs/config/tools` and run `bjam` : this generates the `.cpp` +* cd into `libs/config/tools` and run `bjam`. This generates the `.cpp` file test cases from the `.ipp` file, updates the -libs/config/test/all/Jamfile.v2, `config_test.cpp` and `config_info.cpp`. -* cd into `libs/config/test/all` and run `bjam `['MACRONAME` compiler-list`] : where +libs/config/test/all/Jamfile.v2, `config_test.cpp` and `config_info.cpp`.[br][br] + +* cd into `libs/config/test/all` and run `bjam `['MACRONAME` compiler-list`], where ['MACRONAME] is the name of the new macro, and ['`compiler-list`] is a space separated list of -compilers to test with. You should see the tests pass with those compilers -that don't have the defect, and fail with those that do. -* cd into `libs/config/test` and run `bjam config_info config_test `['`compiler-list`] : +compilers to test with.[br][br] +The xxx_pass_test and the xxx_fail_test [*should both report `**passed**`].[br][br] +If ['MACRONAME] is not defined when it should be defined, xxx_pass_test will not report `**passed**`. +If ['MACRONAME] is defined when it should not be defined, xxx_fail_test will not report `**passed**`.[br][br] + +* cd into `libs/config/test` and run `bjam config_info config_test `['`compiler-list`]. `config_info` should build and run cleanly for all the compilers in ['`compiler-list`] while `config_test` should fail for those that have the defect, and pass for those that do not. diff --git a/doc/html/boost_config/acknowledgements.html b/doc/html/boost_config/acknowledgements.html index 568cc3a1..347924f4 100644 --- a/doc/html/boost_config/acknowledgements.html +++ b/doc/html/boost_config/acknowledgements.html @@ -1,6 +1,6 @@ - + Acknowledgements @@ -47,7 +47,7 @@ - + + + +
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

+

Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

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)

diff --git a/doc/html/boost_config/boost_macro_reference.html b/doc/html/boost_config/boost_macro_reference.html index e781a035..5c737bc1 100644 --- a/doc/html/boost_config/boost_macro_reference.html +++ b/doc/html/boost_config/boost_macro_reference.html @@ -1,6 +1,6 @@ - + Boost Macro Reference @@ -2849,6 +2849,53 @@
+

+ BOOST_WORKAROUND +

+ 		+

+ This macro is used where a compiler specific workaround is required + that is not otherwise described by one of the other Boost.Config + macros. To use the macro you must first +

+
#include <boost/detail/workaround.hpp>
+
+

+ usage is then: +

+
#if BOOST_WORKAROUND(MACRONAME, CONDITION)
+   // workaround code goes here...
+#else
+   // Standard conforming code goes here...
+#endif
+
+

+ where MACRONAME is + a macro that usually describes the version number to be tested against, + and CONDITION is + a comparison operator followed by a value. For example BOOST_WORKAROUND(BOOST_INTEL, + <= 1010) would evaluate to 1 for Intel C++ 10.1 and earlier. +

+

+ The macro can also be used with BOOST_TESTED_AT + if all current compiler versions exhibit the issue, but the issue + is expected to be fixed at some later point. +

+

+ For example BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x590)) would normally evaluate to 1 for all values of __BORLANDC__ + unless the macro BOOST_DETECT_OUTDATED_WORKAROUNDS + is defined, in which case evaluates to (__BORLANDC__ <= + 0x590). +

+

+ Note: the ultimate source of documentation + for this macro is in boost/detail/workaround.hpp. +

+

BOOST_DEDUCED_TYPENAME @@ -3160,7 +3207,7 @@

- Describes the boost version number in XXYYZZ format such that: (BOOST_VERSION + Describes the boost version number in XYYYZZ format such that: (BOOST_VERSION % 100) is the sub-minor version, ((BOOST_VERSION / 100) % 1000) is the minor version, and (BOOST_VERSION / @@ -3534,7 +3581,7 @@ -
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

+

Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

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)

diff --git a/doc/html/boost_config/guidelines_for_boost_authors.html b/doc/html/boost_config/guidelines_for_boost_authors.html index 3468a3eb..d3acebf8 100644 --- a/doc/html/boost_config/guidelines_for_boost_authors.html +++ b/doc/html/boost_config/guidelines_for_boost_authors.html @@ -1,6 +1,6 @@ - + Guidelines for Boost Authors @@ -220,7 +220,6 @@ on success: 

namespace boost_no_foo {
-
 int test()
 {
     // test code goes here:
@@ -236,24 +235,27 @@
       

 
    
 
  • 
-          cd into libs/config/tools and run bjam
-          : this generates the .cpp
+          cd into libs/config/tools and run bjam.
+          This generates the .cpp
           file test cases from the .ipp file, updates the libs/config/test/all/Jamfile.v2,
-          config_test.cpp and config_info.cpp.
-        
    • 
+          config_test.cpp and config_info.cpp.

    
+
 
  • 
           cd into libs/config/test/all and run bjam
-          MACRONAME compiler-list
-          : where MACRONAME is the name of the new macro, and
+          MACRONAME compiler-list,
+          where MACRONAME is the name of the new macro, and
           compiler-list is a space separated
-          list of compilers to test with. You should see the tests pass with those
-          compilers that don't have the defect, and fail with those that do.
-        
    • 
+          list of compilers to test with.

     The xxx_pass_test and the
+          xxx_fail_test should both report **passed**.

     If MACRONAME is not defined when it should
+          be defined, xxx_pass_test will not report **passed**.
+          If MACRONAME is defined when it should not be defined,
+          xxx_fail_test will not report **passed**.

    
+
 
  • 
           cd into libs/config/test and run bjam
           config_info config_test
-          compiler-list
-          : config_info should build
+          compiler-list.
+          config_info should build
           and run cleanly for all the compilers in compiler-list
           while config_test should
           fail for those that have the defect, and pass for those that do not.
@@ -358,7 +360,7 @@
 

 
-

 
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

+
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

         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)
       

diff --git a/doc/html/boost_config/rationale.html b/doc/html/boost_config/rationale.html
index 5429ea82..59a53ec9 100644
--- a/doc/html/boost_config/rationale.html
+++ b/doc/html/boost_config/rationale.html
@@ -1,6 +1,6 @@
 
 
-
+
 Rationale
 
 
@@ -121,7 +121,7 @@
 

 
-

 
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

+
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

         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)
       

diff --git a/doc/html/index.html b/doc/html/index.html
index a6326646..21dda5c7 100644
--- a/doc/html/index.html
+++ b/doc/html/index.html
@@ -1,6 +1,6 @@
 
 
-
+
 Boost.Config
 
 
@@ -26,9 +26,9 @@
 

 Vesa Karvonen, John Maddock Beman Dawes
 

-
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

+
Copyright © 2001 -2007 Beman Dawes, Vesa Karvonen, John Maddock

 

-

+

         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)
       

@@ -131,7 +131,7 @@
       

 

         Boost library users can request support for additional compilers or platforms
-        by visiting our Tracker
+        by visiting our Trac
         and submitting a support request.
       

 

@@ -960,7 +960,7 @@
 

 

 
-
+
Last revised: August 06, 2009 at 09:16:56 GMT
Last revised: March 02, 2010 at 17:08:14 GMT

 

 

 

diff --git a/doc/macro_reference.qbk b/doc/macro_reference.qbk
index 11493abf..3a96512e 100644
--- a/doc/macro_reference.qbk
+++ b/doc/macro_reference.qbk
@@ -633,6 +633,34 @@ workarounds for compiler/standard library defects.
 [table
 [[Macro           ][Description            ]]
 
+[[`BOOST_WORKAROUND`][
+This macro is used where a compiler specific workaround is required that is not otherwise
+described by one of the other Boost.Config macros.  To use the macro you must first
+``
+#include 
+``
+usage is then:
+``
+#if BOOST_WORKAROUND(MACRONAME, CONDITION)
+   // workaround code goes here...
+#else
+   // Standard conforming code goes here...
+#endif
+``
+where `MACRONAME` is a macro that usually describes the version number to be tested against, and `CONDITION`
+is a comparison operator followed by a value.  For example `BOOST_WORKAROUND(BOOST_INTEL, <= 1010)` would 
+evaluate to `1` for Intel C++ 10.1 and earlier.  
+
+The macro can also be used with `BOOST_TESTED_AT` if all
+current compiler versions exhibit the issue, but the issue is expected to be fixed at some later point.  
+
+For example
+`BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x590))` would normally evaluate to `1` for all values
+of `__BORLANDC__` /unless/ the macro `BOOST_DETECT_OUTDATED_WORKAROUNDS` is defined, in which case evaluates to
+`(__BORLANDC__ <= 0x590)`.
+
+[*Note]: the ultimate source of documentation for this macro is in [@../../../../boost/detail/workaround.hpp boost/detail/workaround.hpp].
+]]
 [[`BOOST_DEDUCED_TYPENAME`][
 Some compilers don't support the use of typename for dependent types in deduced
 contexts. This macro expands to nothing on those compilers, and typename
@@ -778,7 +806,7 @@ the only boost macros that should be tested in user code.
 [[Macro            ][Header         ][Description               ]]
 
 [[`BOOST_VERSION`][``][
-Describes the boost version number in XXYYZZ format such that:
+Describes the boost version number in XYYYZZ format such that:
 `(BOOST_VERSION % 100)` is the sub-minor version, `((BOOST_VERSION / 100) % 1000)`
 is the minor version, and `(BOOST_VERSION / 100000)` is the major version.
 ]]
diff --git a/test/boost_no_integral_int64_t.ipp b/test/boost_no_integral_int64_t.ipp
index 3984808d..eb11640a 100644
--- a/test/boost_no_integral_int64_t.ipp
+++ b/test/boost_no_integral_int64_t.ipp
@@ -43,9 +43,7 @@ __extension__
 
 int test()
 {
-   llt m;
-   (void)m;
-   return 0;
+   return llt::value != (1uLL << 50);
 }
 
 }