Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r65840 - sandbox/variadic_macro_data/libs/variadic_macro_data/doc
From: eldiener_at_[hidden]
Date: 2010-10-08 14:16:33


Author: eldiener
Date: 2010-10-08 14:16:05 EDT (Fri, 08 Oct 2010)
New Revision: 65840
URL: http://svn.boost.org/trac/boost/changeset/65840

Log:
Updated docs and changed doc order
Text files modified:
   sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VMDComparison.qbk | 28 ++++++++++++++++++----------
   sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VariadicMacroData.qbk | 2 +-
   2 files changed, 19 insertions(+), 11 deletions(-)

Modified: sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VMDComparison.qbk
==============================================================================
--- sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VMDComparison.qbk (original)
+++ sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VMDComparison.qbk 2010-10-08 14:16:05 EDT (Fri, 08 Oct 2010)
@@ -12,17 +12,25 @@
   list of data mimics the way macro arguments are usually passed.
 # The length of the variadic data does not have to be passed.
   In Boost PP the length does not have to be passed for the
- sequences and lists, but it is passed as part of an arrays, and
- must be separately passed for tuples. Functionality in this library,
- however, alleviates this last requirement for tuples.
+ sequences and lists, but it is specified as part of an array, and
+ must be separately passed, or known in advance, for tuples.
+ Functionality in this library, however, alleviates this last
+ requirement for tuples.
   
-On the other hand there is one major consideration for using
-Boost PP data types for passing variadic data to macros. This
-is the fact that Boost PP data types can be passed multiple
-times in any macro whereas variadic macros can only pass its
-variadic macro data a single time as the final set of arguments
-to a macro. Nonetheless I feel that the more natural syntax of
+On the other hand there are major considerations for using
+Boost PP data types for passing variadic data to macros:
+
+# Boost PP data types can be passed multiple times in any macro
+ whereas variadic macros can only pass its variadic macro data
+ a single time as the final set of arguments to a macro.
+# Boost PP data types are single macro arguments, which fits
+ in well with Boost PP functionality.
+# Boost PP data types have a rich set of functionality for
+ manipulating the data in the data type.
+
+Nonetheless I feel that the more natural syntax of
 variadic macro data still provides enough importance for using
-this library's facilities for variadic macros.
+this library's facilities for variadic macros from the end-user's
+point of view.
 
 [endsect]

Modified: sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VariadicMacroData.qbk
==============================================================================
--- sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VariadicMacroData.qbk (original)
+++ sandbox/variadic_macro_data/libs/variadic_macro_data/doc/VariadicMacroData.qbk 2010-10-08 14:16:05 EDT (Fri, 08 Oct 2010)
@@ -16,8 +16,8 @@
 [include VMDNaming.qbk]
 [include VMDDetail.qbk]
 [include VMDReference.qbk]
-[include VMDDesign.qbk]
 [include VMDComparison.qbk]
+[include VMDDesign.qbk]
 [include VMDCompilers.qbk]
 [include VMDLimitations.qbk]
 [include VMDAcknowledgements.qbk]


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk