[Boost-commit] svn:boost r48640 - trunk/libs/utility

Subject: [Boost-commit] svn:boost r48640 - trunk/libs/utility
From: rivorus_at_[hidden]
Date: 2008-09-06 17:49:50

Author: matt_calabrese
Date: 2008-09-06 17:49:49 EDT (Sat, 06 Sep 2008)
New Revision: 48640
URL: http://svn.boost.org/trac/boost/changeset/48640

Log:
Changed wording for BOOST_BINARY docs.
Text files modified: 
   trunk/libs/utility/utility.htm |    25 ++++++++++++++++---------               
   1 files changed, 16 insertions(+), 9 deletions(-)

Modified: trunk/libs/utility/utility.htm
==============================================================================
--- trunk/libs/utility/utility.htm	(original)
+++ trunk/libs/utility/utility.htm	2008-09-06 17:49:49 EDT (Sat, 06 Sep 2008)
@@ -187,10 +187,10 @@
                 <p>See separate documentation.</p>
                 <h2><a name="BOOST_BINARY">Macro BOOST_BINARY</a></h2>
 
-		<p>The macro <code>BOOST_BINARY</code> allows for the
+		<p>The macro <code>BOOST_BINARY</code> is used for the
                 representation of binary literals. It takes as an argument
                 a binary number arranged as an arbitrary amount of 1s and 0s in
-                groupings of length 1 to 8 inclusive, with groups separated
+                groupings of length 1 to 8, with groups separated
                 by spaces. The type of the literal yielded is determined by
                 the same rules as those of hex and octal
                 literals (<i>2.13.1p1</i>). By implementation, this macro
@@ -201,17 +201,19 @@
                 <p>In order to directly support binary literals with suffixes,
                 additional macros of the form BOOST_BINARY_XXX are also
                 provided, where XXX is a standard integer suffix in all capital
-                letters. LL and ULL are also provided for representing long long
-                and unsigned long long types in compilers which provide them as
-		an extension.</p>
+                letters. In addition, LL and ULL suffixes may be for representing
+                long long and unsigned long long types in compilers which provide
+                them as an extension.</p>
 
 
-                <p>The BOOST_BINARY family of macros reside in the header
+                <p>The BOOST_BINARY family of macros resides in the header
                 <a
                 href="../../boost/utility/binary.hpp">&lt;boost/utility/binary.hpp&gt;</a>
                 which is automatically included by
                 <a
-                href="../../boost/utility.hpp">&lt;boost/utility.hpp&gt;</a>.
+                href="../../boost/utility.hpp">&lt;boost/utility.hpp&gt;</a> and
+                <a
+                href="../../boost/binary.hpp">&lt;boost/binary.hpp&gt;</a>..
 
                 <p>Contributed by Matt Calabrese.</p><p>
                 </p><h3>Example</h3>
@@ -227,11 +229,16 @@
 
   unsigned long value2 = BOOST_BINARY_UL( 100 001 ); // unsigned long
 
+  long long value3 = BOOST_BINARY_LL( 11 000 ); // long long if supported
+
+  assert(    BOOST_BINARY( 10010 )
+          &  BOOST_BINARY( 11000 )
+          == BOOST_BINARY( 10000 )
+        );
+
   foo( BOOST_BINARY( 1010 ) ); // calls the first foo
 
   foo( BOOST_BINARY_LU( 1010 ) ); // calls the second foo
-
-  long long value4 = BOOST_BINARY_LL( 11 000 ); // long long if supported
 }
 </pre></blockquote>
                 <hr>