Docs updated

[SVN r13170]

doc/reference/tuple.htm

@@ -23,7 +23,24 @@
 <hr>
 
 <h1>#include &lt;<a href="../../../../boost/preprocessor/tuple.hpp">boost/preprocessor/tuple.hpp</a>&gt;</h1>
- <p>Includes all tuple headers.</p> 
+ <p>Includes all tuple headers.</p>
+
+<p>A tuple is a fixed size collection of elements.</p>
+
+<p>In the preprocessor library, tuples are represented like macro parameter
+lists. Thus an element of a tuple can be any sequence of tokens that
+constitutes a single macro parameter.</p>
+
+<p>Examples of tuples:</p>
+
+<pre>
+  (const, volatile)    // 2-tuple
+  (*, /, %)            // 3-tuple
+  (1, "2", '3', (4,5)) // 4-tuple
+</pre>
+
+<p>Tuples can be used for representing structured data.</p>
+
 <hr>
 
 <a href="stringize.htm">Prev</a> <a href="tuple_eat.htm">Next</a> <a href="index.htm#Macros">Macros</a> <a href="index.htm#Headers">Headers</a>

doc/reference/tuple_elem.htm

@@ -37,16 +37,6 @@
 
 <p>expands to <code>B</code>.</p>
 
-<p>Tuples can be used for representing structured data.</p>
-
-<p>Examples of tuples:</p>
-
-<pre>
-  2-tuple: (A, B)
-  3-tuple: (1, 2, 3)
-  4-tuple: (A B C, D, EF, 34)
-</pre>
-
 <h3>See</h3>
 <ul>
   <li><a href="limits.htm#BOOST_PP_LIMIT_TUPLE">BOOST_PP_LIMIT_TUPLE</a></li>

include/boost/preprocessor/tuple.hpp

@@ -13,9 +13,27 @@
  * See http://www.boost.org for most recent version.
  */
 
-/** <p>Includes all tuple headers.</p> */
+/** <p>Includes all tuple headers.</p>
+
+<p>A tuple is a fixed size collection of elements.</p>
+
+<p>In the preprocessor library, tuples are represented like macro parameter
+lists. Thus an element of a tuple can be any sequence of tokens that
+constitutes a single macro parameter.</p>
+
+<p>Examples of tuples:</p>
+
+<pre>
+  (const, volatile)    // 2-tuple
+  (*, /, %)            // 3-tuple
+  (1, "2", '3', (4,5)) // 4-tuple
+</pre>
+
+<p>Tuples can be used for representing structured data.</p>
+*/
 
 #include <boost/preprocessor/tuple/eat.hpp>
 #include <boost/preprocessor/tuple/elem.hpp>
+#include <boost/preprocessor/tuple/reverse.hpp>
 #include <boost/preprocessor/tuple/to_list.hpp>
 #endif

include/boost/preprocessor/tuple/elem.hpp

@@ -23,16 +23,6 @@
 
 <p>expands to <code>B</code>.</p>
 
-<p>Tuples can be used for representing structured data.</p>
-
-<p>Examples of tuples:</p>
-
-<pre>
-  2-tuple: (A, B)
-  3-tuple: (1, 2, 3)
-  4-tuple: (A B C, D, EF, 34)
-</pre>
-
 <h3>See</h3>
 <ul>
   <li>BOOST_PP_LIMIT_TUPLE</li>