Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r86267 - in trunk: boost/xpressive libs/xpressive/doc
From: eric_at_[hidden]
Date: 2013-10-12 15:24:17


Author: eric_niebler
Date: 2013-10-12 15:24:17 EDT (Sat, 12 Oct 2013)
New Revision: 86267
URL: http://svn.boost.org/trac/boost/changeset/86267

Log:
docs for stuff in regex_actions.hpp, refs #7662

Text files modified:
   trunk/boost/xpressive/regex_actions.hpp | 858 +++++++++++++++++++++++++++++++++------
   trunk/libs/xpressive/doc/Jamfile.v2 | 4
   2 files changed, 717 insertions(+), 145 deletions(-)

Modified: trunk/boost/xpressive/regex_actions.hpp
==============================================================================
--- trunk/boost/xpressive/regex_actions.hpp Sat Oct 12 13:46:00 2013 (r86266)
+++ trunk/boost/xpressive/regex_actions.hpp 2013-10-12 15:24:17 EDT (Sat, 12 Oct 2013) (r86267)
@@ -28,6 +28,7 @@
 #include <boost/type_traits/is_same.hpp>
 #include <boost/type_traits/is_const.hpp>
 #include <boost/type_traits/is_integral.hpp>
+#include <boost/type_traits/decay.hpp>
 #include <boost/type_traits/remove_cv.hpp>
 #include <boost/type_traits/remove_reference.hpp>
 #include <boost/range/iterator_range.hpp>
@@ -51,14 +52,6 @@
 # include <boost/xpressive/detail/core/matcher/action_matcher.hpp>
 #endif
 
-/// INTERNAL ONLY
-///
-#define UNREF(x) typename remove_reference<x>::type
-
-/// INTERNAL ONLY
-///
-#define UNCVREF(x) typename remove_cv<typename remove_reference<x>::type>::type
-
 #if BOOST_MSVC
 #pragma warning(push)
 #pragma warning(disable : 4510) // default constructor could not be generated
@@ -79,7 +72,7 @@
 
             reference cast(void *pv) const
             {
- return *static_cast<UNREF(T) *>(pv);
+ return *static_cast<typename remove_reference<T>::type *>(pv);
             }
         };
 
@@ -159,6 +152,7 @@
 
     namespace op
     {
+ /// \brief \c at is a PolymorphicFunctionObject for indexing into a sequence
         struct at
         {
             BOOST_PROTO_CALLABLE()
@@ -166,27 +160,35 @@
             struct result {};
 
             template<typename This, typename Cont, typename Idx>
- struct result<This(Cont, Idx)>
- : result<This(Cont const &, Idx)>
+ struct result<This(Cont &, Idx)>
             {
+ typedef typename Cont::reference type;
             };
 
             template<typename This, typename Cont, typename Idx>
- struct result<This(Cont &, Idx)>
- : mpl::if_c<
- is_const<Cont>::value
- , typename Cont::const_reference
- , typename Cont::reference
- >
+ struct result<This(Cont const &, Idx)>
             {
+ typedef typename Cont::const_reference type;
             };
 
+ template<typename This, typename Cont, typename Idx>
+ struct result<This(Cont, Idx)>
+ {
+ typedef typename Cont::const_reference type;
+ };
+
+ /// \pre \c Cont is a model of RandomAccessSequence
+ /// \param c The RandomAccessSequence to index into
+ /// \param idx The index
+ /// \return <tt>c[idx]</tt>
             template<typename Cont, typename Idx>
             typename Cont::reference operator()(Cont &c, Idx idx BOOST_PROTO_DISABLE_IF_IS_CONST(Cont)) const
             {
                 return c[idx];
             }
 
+ /// \overload
+ ///
             template<typename Cont, typename Idx>
             typename Cont::const_reference operator()(Cont const &c, Idx idx) const
             {
@@ -194,11 +196,16 @@
             }
         };
 
+ /// \brief \c push is a PolymorphicFunctionObject for pushing an element into a container.
         struct push
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \param seq The sequence into which the value should be pushed.
+ /// \param val The value to push into the sequence.
+ /// \brief Equivalent to <tt>seq.push(val)</tt>.
+ /// \return \c void
             template<typename Sequence, typename Value>
             void operator()(Sequence &seq, Value const &val) const
             {
@@ -206,11 +213,16 @@
             }
         };
 
+ /// \brief \c push_back is a PolymorphicFunctionObject for pushing an element into the back of a container.
         struct push_back
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \param seq The sequence into which the value should be pushed.
+ /// \param val The value to push into the sequence.
+ /// \brief Equivalent to <tt>seq.push_back(val)</tt>.
+ /// \return \c void
             template<typename Sequence, typename Value>
             void operator()(Sequence &seq, Value const &val) const
             {
@@ -218,11 +230,16 @@
             }
         };
 
+ /// \brief \c push_front is a PolymorphicFunctionObject for pushing an element into the front of a container.
         struct push_front
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \param seq The sequence into which the value should be pushed.
+ /// \param val The value to push into the sequence.
+ /// \brief Equivalent to <tt>seq.push_front(val)</tt>.
+ /// \return \c void
             template<typename Sequence, typename Value>
             void operator()(Sequence &seq, Value const &val) const
             {
@@ -230,11 +247,15 @@
             }
         };
 
+ /// \brief \c pop is a PolymorphicFunctionObject for popping an element from a container.
         struct pop
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \param seq The sequence from which to pop.
+ /// \brief Equivalent to <tt>seq.pop()</tt>.
+ /// \return \c void
             template<typename Sequence>
             void operator()(Sequence &seq) const
             {
@@ -242,11 +263,15 @@
             }
         };
 
+ /// \brief \c pop_back is a PolymorphicFunctionObject for popping an element from the back of a container.
         struct pop_back
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \param seq The sequence from which to pop.
+ /// \brief Equivalent to <tt>seq.pop_back()</tt>.
+ /// \return \c void
             template<typename Sequence>
             void operator()(Sequence &seq) const
             {
@@ -254,11 +279,15 @@
             }
         };
 
+ /// \brief \c pop_front is a PolymorphicFunctionObject for popping an element from the front of a container.
         struct pop_front
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \param seq The sequence from which to pop.
+ /// \brief Equivalent to <tt>seq.pop_front()</tt>.
+ /// \return \c void
             template<typename Sequence>
             void operator()(Sequence &seq) const
             {
@@ -266,6 +295,7 @@
             }
         };
 
+ /// \brief \c front is a PolymorphicFunctionObject for fetching the front element of a container.
         struct front
         {
             BOOST_PROTO_CALLABLE()
@@ -275,7 +305,7 @@
             template<typename This, typename Sequence>
             struct result<This(Sequence)>
             {
- typedef UNREF(Sequence) sequence_type;
+ typedef typename remove_reference<Sequence>::type sequence_type;
                 typedef
                     typename mpl::if_c<
                         is_const<sequence_type>::value
@@ -285,6 +315,8 @@
                 type;
             };
 
+ /// \param seq The sequence from which to fetch the front.
+ /// \return <tt>seq.front()</tt>
             template<typename Sequence>
             typename result<front(Sequence &)>::type operator()(Sequence &seq) const
             {
@@ -292,6 +324,7 @@
             }
         };
 
+ /// \brief \c back is a PolymorphicFunctionObject for fetching the back element of a container.
         struct back
         {
             BOOST_PROTO_CALLABLE()
@@ -301,7 +334,7 @@
             template<typename This, typename Sequence>
             struct result<This(Sequence)>
             {
- typedef UNREF(Sequence) sequence_type;
+ typedef typename remove_reference<Sequence>::type sequence_type;
                 typedef
                     typename mpl::if_c<
                         is_const<sequence_type>::value
@@ -311,6 +344,8 @@
                 type;
             };
 
+ /// \param seq The sequence from which to fetch the back.
+ /// \return <tt>seq.back()</tt>
             template<typename Sequence>
             typename result<back(Sequence &)>::type operator()(Sequence &seq) const
             {
@@ -318,6 +353,7 @@
             }
         };
 
+ /// \brief \c top is a PolymorphicFunctionObject for fetching the top element of a stack.
         struct top
         {
             BOOST_PROTO_CALLABLE()
@@ -327,7 +363,7 @@
             template<typename This, typename Sequence>
             struct result<This(Sequence)>
             {
- typedef UNREF(Sequence) sequence_type;
+ typedef typename remove_reference<Sequence>::type sequence_type;
                 typedef
                     typename mpl::if_c<
                         is_const<sequence_type>::value
@@ -337,6 +373,8 @@
                 type;
             };
 
+ /// \param seq The sequence from which to fetch the top.
+ /// \return <tt>seq.top()</tt>
             template<typename Sequence>
             typename result<top(Sequence &)>::type operator()(Sequence &seq) const
             {
@@ -344,6 +382,7 @@
             }
         };
 
+ /// \brief \c first is a PolymorphicFunctionObject for fetching the first element of a pair.
         struct first
         {
             BOOST_PROTO_CALLABLE()
@@ -353,9 +392,11 @@
             template<typename This, typename Pair>
             struct result<This(Pair)>
             {
- typedef UNREF(Pair)::first_type type;
+ typedef typename remove_reference<Pair>::type::first_type type;
             };
 
+ /// \param p The pair from which to fetch the first element.
+ /// \return <tt>p.first</tt>
             template<typename Pair>
             typename Pair::first_type operator()(Pair const &p) const
             {
@@ -363,6 +404,7 @@
             }
         };
 
+ /// \brief \c second is a PolymorphicFunctionObject for fetching the second element of a pair.
         struct second
         {
             BOOST_PROTO_CALLABLE()
@@ -372,9 +414,11 @@
             template<typename This, typename Pair>
             struct result<This(Pair)>
             {
- typedef UNREF(Pair)::second_type type;
+ typedef typename remove_reference<Pair>::type::second_type type;
             };
 
+ /// \param p The pair from which to fetch the second element.
+ /// \return <tt>p.second</tt>
             template<typename Pair>
             typename Pair::second_type operator()(Pair const &p) const
             {
@@ -382,11 +426,15 @@
             }
         };
 
+ /// \brief \c matched is a PolymorphicFunctionObject for assessing whether a \c sub_match object
+ /// matched or not.
         struct matched
         {
             BOOST_PROTO_CALLABLE()
             typedef bool result_type;
 
+ /// \param sub The \c sub_match object.
+ /// \return <tt>sub.matched</tt>
             template<typename Sub>
             bool operator()(Sub const &sub) const
             {
@@ -394,6 +442,7 @@
             }
         };
 
+ /// \brief \c length is a PolymorphicFunctionObject for fetching the length of \c sub_match.
         struct length
         {
             BOOST_PROTO_CALLABLE()
@@ -403,9 +452,11 @@
             template<typename This, typename Sub>
             struct result<This(Sub)>
             {
- typedef UNREF(Sub)::difference_type type;
+ typedef typename remove_reference<Sub>::type::difference_type type;
             };
 
+ /// \param sub The \c sub_match object.
+ /// \return <tt>sub.length()</tt>
             template<typename Sub>
             typename Sub::difference_type operator()(Sub const &sub) const
             {
@@ -413,6 +464,8 @@
             }
         };
 
+ /// \brief \c str is a PolymorphicFunctionObject for turning a \c sub_match into an
+ /// equivalent \c std::string.
         struct str
         {
             BOOST_PROTO_CALLABLE()
@@ -422,9 +475,11 @@
             template<typename This, typename Sub>
             struct result<This(Sub)>
             {
- typedef UNREF(Sub)::string_type type;
+ typedef typename remove_reference<Sub>::type::string_type type;
             };
 
+ /// \param sub The \c sub_match object.
+ /// \return <tt>sub.str()</tt>
             template<typename Sub>
             typename Sub::string_type operator()(Sub const &sub) const
             {
@@ -435,75 +490,116 @@
         // This codifies the return types of the various insert member
         // functions found in sequence containers, the 2 flavors of
         // associative containers, and strings.
+ //
+ /// \brief \c insert is a PolymorphicFunctionObject for inserting a value or a
+ /// sequence of values into a sequence container, an associative
+ /// container, or a string.
         struct insert
         {
             BOOST_PROTO_CALLABLE()
- template<typename Sig, typename EnableIf = void>
- struct result
- {};
-
- // assoc containers
- template<typename This, typename Cont, typename Value>
- struct result<This(Cont, Value), void>
- {
- typedef UNREF(Cont) cont_type;
- typedef UNREF(Value) value_type;
- static cont_type &scont_;
- static value_type &svalue_;
- typedef char yes_type;
- typedef char (&no_type)[2];
- static yes_type check_insert_return(typename cont_type::iterator);
- static no_type check_insert_return(std::pair<typename cont_type::iterator, bool>);
- BOOST_STATIC_CONSTANT(bool, is_iterator = (sizeof(yes_type) == sizeof(check_insert_return(scont_.insert(svalue_)))));
- typedef
- typename mpl::if_c<
- is_iterator
- , typename cont_type::iterator
- , std::pair<typename cont_type::iterator, bool>
- >::type
- type;
- };
 
- // sequence containers, assoc containers, strings
- template<typename This, typename Cont, typename It, typename Value>
- struct result<This(Cont, It, Value),
- typename disable_if<mpl::or_<is_integral<UNCVREF(It)>, is_same<UNCVREF(It), UNCVREF(Value)> > >::type>
- {
- typedef UNREF(Cont)::iterator type;
- };
-
- // strings
- template<typename This, typename Cont, typename Size, typename T>
- struct result<This(Cont, Size, T),
- typename enable_if<is_integral<UNCVREF(Size)> >::type>
- {
- typedef UNREF(Cont) &type;
- };
-
- // assoc containers
- template<typename This, typename Cont, typename It>
- struct result<This(Cont, It, It), void>
- {
- typedef void type;
- };
-
- // sequence containers, strings
- template<typename This, typename Cont, typename It, typename Size, typename Value>
- struct result<This(Cont, It, Size, Value),
- typename disable_if<is_integral<UNCVREF(It)> >::type>
+ /// INTERNAL ONLY
+ ///
+ struct detail
             {
- typedef void type;
+ template<typename Sig, typename EnableIf = void>
+ struct result_detail
+ {};
+
+ // assoc containers
+ template<typename This, typename Cont, typename Value>
+ struct result_detail<This(Cont, Value), void>
+ {
+ typedef typename remove_reference<Cont>::type cont_type;
+ typedef typename remove_reference<Value>::type value_type;
+ static cont_type &scont_;
+ static value_type &svalue_;
+ typedef char yes_type;
+ typedef char (&no_type)[2];
+ static yes_type check_insert_return(typename cont_type::iterator);
+ static no_type check_insert_return(std::pair<typename cont_type::iterator, bool>);
+ BOOST_STATIC_CONSTANT(bool, is_iterator = (sizeof(yes_type) == sizeof(check_insert_return(scont_.insert(svalue_)))));
+ typedef
+ typename mpl::if_c<
+ is_iterator
+ , typename cont_type::iterator
+ , std::pair<typename cont_type::iterator, bool>
+ >::type
+ type;
+ };
+
+ // sequence containers, assoc containers, strings
+ template<typename This, typename Cont, typename It, typename Value>
+ struct result_detail<This(Cont, It, Value),
+ typename disable_if<
+ mpl::or_<
+ is_integral<typename remove_cv<typename remove_reference<It>::type>::type>
+ , is_same<
+ typename remove_cv<typename remove_reference<It>::type>::type
+ , typename remove_cv<typename remove_reference<Value>::type>::type
+ >
+ >
+ >::type
+ >
+ {
+ typedef typename remove_reference<Cont>::type::iterator type;
+ };
+
+ // strings
+ template<typename This, typename Cont, typename Size, typename T>
+ struct result_detail<This(Cont, Size, T),
+ typename enable_if<
+ is_integral<typename remove_cv<typename remove_reference<Size>::type>::type>
+ >::type
+ >
+ {
+ typedef typename remove_reference<Cont>::type &type;
+ };
+
+ // assoc containers
+ template<typename This, typename Cont, typename It>
+ struct result_detail<This(Cont, It, It), void>
+ {
+ typedef void type;
+ };
+
+ // sequence containers, strings
+ template<typename This, typename Cont, typename It, typename Size, typename Value>
+ struct result_detail<This(Cont, It, Size, Value),
+ typename disable_if<
+ is_integral<typename remove_cv<typename remove_reference<It>::type>::type>
+ >::type
+ >
+ {
+ typedef void type;
+ };
+
+ // strings
+ template<typename This, typename Cont, typename Size, typename A0, typename A1>
+ struct result_detail<This(Cont, Size, A0, A1),
+ typename enable_if<
+ is_integral<typename remove_cv<typename remove_reference<Size>::type>::type>
+ >::type
+ >
+ {
+ typedef typename remove_reference<Cont>::type &type;
+ };
+
+ // strings
+ template<typename This, typename Cont, typename Pos0, typename String, typename Pos1, typename Length>
+ struct result_detail<This(Cont, Pos0, String, Pos1, Length)>
+ {
+ typedef typename remove_reference<Cont>::type &type;
+ };
             };
 
- // strings
- template<typename This, typename Cont, typename Size, typename A0, typename A1>
- struct result<This(Cont, Size, A0, A1),
- typename enable_if<is_integral<UNCVREF(Size)> >::type>
+ template<typename Sig>
+ struct result
             {
- typedef UNREF(Cont) &type;
+ typedef typename detail::result_detail<Sig>::type type;
             };
 
- /// \brief operator()
+ /// \overload
             ///
             template<typename Cont, typename A0>
             typename result<insert(Cont &, A0 const &)>::type
@@ -529,8 +625,25 @@
             {
                 return cont.insert(a0, a1, a2);
             }
+
+ /// \param cont The container into which to insert the element(s)
+ /// \param a0 A value, iterator, or count
+ /// \param a1 A value, iterator, string, count, or character
+ /// \param a2 A value, iterator, or count
+ /// \param a3 A count
+ /// \return \li For the form <tt>insert()(cont, a0)</tt>, return <tt>cont.insert(a0)</tt>.
+ /// \li For the form <tt>insert()(cont, a0, a1)</tt>, return <tt>cont.insert(a0, a1)</tt>.
+ /// \li For the form <tt>insert()(cont, a0, a1, a2)</tt>, return <tt>cont.insert(a0, a1, a2)</tt>.
+ /// \li For the form <tt>insert()(cont, a0, a1, a2, a3)</tt>, return <tt>cont.insert(a0, a1, a2, a3)</tt>.
+ template<typename Cont, typename A0, typename A1, typename A2, typename A3>
+ typename result<insert(Cont &, A0 const &, A1 const &, A2 const &, A3 const &)>::type
+ operator()(Cont &cont, A0 const &a0, A1 const &a1, A2 const &a2, A3 const &a3) const
+ {
+ return cont.insert(a0, a1, a2, a3);
+ }
         };
 
+ /// \brief \c make_pair is a PolymorphicFunctionObject for building a \c std::pair out of two parameters
         struct make_pair
         {
             BOOST_PROTO_CALLABLE()
@@ -540,9 +653,16 @@
             template<typename This, typename First, typename Second>
             struct result<This(First, Second)>
             {
- typedef std::pair<UNCVREF(First), UNCVREF(Second)> type;
+ /// \brief For exposition only
+ typedef typename decay<First>::type first_type;
+ /// \brief For exposition only
+ typedef typename decay<Second>::type second_type;
+ typedef std::pair<first_type, second_type> type;
             };
 
+ /// \param first The first element of the pair
+ /// \param second The second element of the pair
+ /// \return <tt>std::make_pair(first, second)</tt>
             template<typename First, typename Second>
             std::pair<First, Second> operator()(First const &first, Second const &second) const
             {
@@ -550,12 +670,16 @@
             }
         };
 
+ /// \brief \c as\<\> is a PolymorphicFunctionObject for lexically casting a parameter to a different type.
+ /// \tparam T The type to which to lexically cast the parameter.
         template<typename T>
         struct as
         {
             BOOST_PROTO_CALLABLE()
             typedef T result_type;
 
+ /// \param val The value to lexically cast.
+ /// \return <tt>boost::lexical_cast\<T\>(val)</tt>
             template<typename Value>
             T operator()(Value const &val) const
             {
@@ -563,6 +687,7 @@
             }
 
             // Hack around some limitations in boost::lexical_cast
+ /// INTERNAL ONLY
             T operator()(csub_match const &val) const
             {
                 return val.matched
@@ -571,6 +696,7 @@
             }
 
             #ifndef BOOST_XPRESSIVE_NO_WREGEX
+ /// INTERNAL ONLY
             T operator()(wcsub_match const &val) const
             {
                 return val.matched
@@ -579,6 +705,7 @@
             }
             #endif
 
+ /// INTERNAL ONLY
             template<typename BidiIter>
             T operator()(sub_match<BidiIter> const &val) const
             {
@@ -594,6 +721,7 @@
             }
 
         private:
+ /// INTERNAL ONLY
             template<typename RandIter>
             T impl(sub_match<RandIter> const &val, mpl::true_) const
             {
@@ -602,6 +730,7 @@
                   : boost::lexical_cast<T>("");
             }
 
+ /// INTERNAL ONLY
             template<typename BidiIter>
             T impl(sub_match<BidiIter> const &val, mpl::false_) const
             {
@@ -609,12 +738,16 @@
             }
         };
 
+ /// \brief \c static_cast_\<\> is a PolymorphicFunctionObject for statically casting a parameter to a different type.
+ /// \tparam T The type to which to statically cast the parameter.
         template<typename T>
         struct static_cast_
         {
             BOOST_PROTO_CALLABLE()
             typedef T result_type;
 
+ /// \param val The value to statically cast.
+ /// \return <tt>static_cast\<T\>(val)</tt>
             template<typename Value>
             T operator()(Value const &val) const
             {
@@ -622,12 +755,16 @@
             }
         };
 
+ /// \brief \c dynamic_cast_\<\> is a PolymorphicFunctionObject for dynamically casting a parameter to a different type.
+ /// \tparam T The type to which to dynamically cast the parameter.
         template<typename T>
         struct dynamic_cast_
         {
             BOOST_PROTO_CALLABLE()
             typedef T result_type;
 
+ /// \param val The value to dynamically cast.
+ /// \return <tt>dynamic_cast\<T\>(val)</tt>
             template<typename Value>
             T operator()(Value const &val) const
             {
@@ -635,12 +772,17 @@
             }
         };
 
+ /// \brief \c const_cast_\<\> is a PolymorphicFunctionObject for const-casting a parameter to a cv qualification.
+ /// \tparam T The type to which to const-cast the parameter.
         template<typename T>
         struct const_cast_
         {
             BOOST_PROTO_CALLABLE()
             typedef T result_type;
 
+ /// \param val The value to const-cast.
+ /// \pre Types \c T and \c Value differ only in cv-qualification.
+ /// \return <tt>const_cast\<T\>(val)</tt>
             template<typename Value>
             T operator()(Value const &val) const
             {
@@ -648,29 +790,38 @@
             }
         };
 
+ /// \brief \c construct\<\> is a PolymorphicFunctionObject for constructing a new object.
+ /// \tparam T The type of the object to construct.
         template<typename T>
         struct construct
         {
             BOOST_PROTO_CALLABLE()
             typedef T result_type;
 
+ /// \overload
             T operator()() const
             {
                 return T();
             }
 
+ /// \overload
             template<typename A0>
             T operator()(A0 const &a0) const
             {
                 return T(a0);
             }
 
+ /// \overload
             template<typename A0, typename A1>
             T operator()(A0 const &a0, A1 const &a1) const
             {
                 return T(a0, a1);
             }
 
+ /// \param a0 The first argument to the constructor
+ /// \param a1 The second argument to the constructor
+ /// \param a2 The third argument to the constructor
+ /// \return <tt>T(a0,a1,...)</tt>
             template<typename A0, typename A1, typename A2>
             T operator()(A0 const &a0, A1 const &a1, A2 const &a2) const
             {
@@ -678,29 +829,41 @@
             }
         };
 
+ /// \brief \c throw_\<\> is a PolymorphicFunctionObject for throwing an exception.
+ /// \tparam Except The type of the object to throw.
         template<typename Except>
         struct throw_
         {
             BOOST_PROTO_CALLABLE()
             typedef void result_type;
 
+ /// \overload
             void operator()() const
             {
                 BOOST_THROW_EXCEPTION(Except());
             }
 
+ /// \overload
             template<typename A0>
             void operator()(A0 const &a0) const
             {
                 BOOST_THROW_EXCEPTION(Except(a0));
             }
 
+ /// \overload
             template<typename A0, typename A1>
             void operator()(A0 const &a0, A1 const &a1) const
             {
                 BOOST_THROW_EXCEPTION(Except(a0, a1));
             }
 
+ /// \param a0 The first argument to the constructor
+ /// \param a1 The second argument to the constructor
+ /// \param a2 The third argument to the constructor
+ /// \throw <tt>Except(a0,a1,...)</tt>
+ /// \note This function makes use of the \c BOOST_THROW_EXCEPTION macro
+ /// to actually throw the exception. See the documentation for the
+ /// Boost.Exception library.
             template<typename A0, typename A1, typename A2>
             void operator()(A0 const &a0, A1 const &a1, A2 const &a2) const
             {
@@ -708,6 +871,7 @@
             }
         };
 
+ /// \brief \c unwrap_reference is a PolymorphicFunctionObject for unwrapping a <tt>boost::reference_wrapper\<\></tt>.
         struct unwrap_reference
         {
             BOOST_PROTO_CALLABLE()
@@ -726,6 +890,8 @@
                 typedef typename boost::unwrap_reference<Ref>::type &type;
             };
 
+ /// \param r The <tt>boost::reference_wrapper\<T\></tt> to unwrap.
+ /// \return <tt>static_cast\<T &\>(r)</tt>
             template<typename T>
             T &operator()(boost::reference_wrapper<T> r) const
             {
@@ -734,88 +900,245 @@
         };
     }
 
- template<typename Fun>
+ /// \brief A unary metafunction that turns an ordinary function object type into the type of
+ /// a deferred function object for use in xpressive semantic actions.
+ ///
+ /// Use \c xpressive::function\<\> to turn an ordinary polymorphic function object type
+ /// into a type that can be used to declare an object for use in xpressive semantic actions.
+ ///
+ /// For example, the global object \c xpressive::push_back can be used to create deferred actions
+ /// that have the effect of pushing a value into a container. It is defined with
+ /// \c xpressive::function\<\> as follows:
+ ///
+ /** \code
+ xpressive::function<xpressive::op::push_back>::type const push_back = {};
+ \endcode
+ */
+ ///
+ /// where \c op::push_back is an ordinary function object that pushes its second argument into
+ /// its first. Thus defined, \c xpressive::push_back can be used in semantic actions as follows:
+ ///
+ /** \code
+ namespace xp = boost::xpressive;
+ using xp::_;
+ std::list<int> result;
+ std::string str("1 23 456 7890");
+ xp::sregex rx = (+_d)[ xp::push_back(xp::ref(result), xp::as<int>(_) ]
+ >> *(' ' >> (+_d)[ xp::push_back(xp::ref(result), xp::as<int>(_) ) ]);
+ \endcode
+ */
+ template<typename PolymorphicFunctionObject>
     struct function
     {
- typedef typename proto::terminal<Fun>::type type;
+ typedef typename proto::terminal<PolymorphicFunctionObject>::type type;
     };
 
+ /// \brief \c at is a lazy PolymorphicFunctionObject for indexing into a sequence in an
+ /// xpressive semantic action.
     function<op::at>::type const at = {{}};
+
+ /// \brief \c push is a lazy PolymorphicFunctionObject for pushing a value into a container in an
+ /// xpressive semantic action.
     function<op::push>::type const push = {{}};
+
+ /// \brief \c push_back is a lazy PolymorphicFunctionObject for pushing a value into a container in an
+ /// xpressive semantic action.
     function<op::push_back>::type const push_back = {{}};
+
+ /// \brief \c push_front is a lazy PolymorphicFunctionObject for pushing a value into a container in an
+ /// xpressive semantic action.
     function<op::push_front>::type const push_front = {{}};
+
+ /// \brief \c pop is a lazy PolymorphicFunctionObject for popping the top element from a sequence in an
+ /// xpressive semantic action.
     function<op::pop>::type const pop = {{}};
+
+ /// \brief \c pop_back is a lazy PolymorphicFunctionObject for popping the back element from a sequence in an
+ /// xpressive semantic action.
     function<op::pop_back>::type const pop_back = {{}};
+
+ /// \brief \c pop_front is a lazy PolymorphicFunctionObject for popping the front element from a sequence in an
+ /// xpressive semantic action.
     function<op::pop_front>::type const pop_front = {{}};
+
+ /// \brief \c top is a lazy PolymorphicFunctionObject for accessing the top element from a stack in an
+ /// xpressive semantic action.
     function<op::top>::type const top = {{}};
+
+ /// \brief \c back is a lazy PolymorphicFunctionObject for fetching the back element of a sequence in an
+ /// xpressive semantic action.
     function<op::back>::type const back = {{}};
+
+ /// \brief \c front is a lazy PolymorphicFunctionObject for fetching the front element of a sequence in an
+ /// xpressive semantic action.
     function<op::front>::type const front = {{}};
+
+ /// \brief \c first is a lazy PolymorphicFunctionObject for accessing the first element of a \c std::pair\<\> in an
+ /// xpressive semantic action.
     function<op::first>::type const first = {{}};
+
+ /// \brief \c second is a lazy PolymorphicFunctionObject for accessing the second element of a \c std::pair\<\> in an
+ /// xpressive semantic action.
     function<op::second>::type const second = {{}};
+
+ /// \brief \c matched is a lazy PolymorphicFunctionObject for accessing the \c matched member of a \c xpressive::sub_match\<\> in an
+ /// xpressive semantic action.
     function<op::matched>::type const matched = {{}};
+
+ /// \brief \c length is a lazy PolymorphicFunctionObject for computing the length of a \c xpressive::sub_match\<\> in an
+ /// xpressive semantic action.
     function<op::length>::type const length = {{}};
+
+ /// \brief \c str is a lazy PolymorphicFunctionObject for converting a \c xpressive::sub_match\<\> to a \c std::basic_string\<\> in an
+ /// xpressive semantic action.
     function<op::str>::type const str = {{}};
+
+ /// \brief \c insert is a lazy PolymorphicFunctionObject for inserting a value or a range of values into a sequence in an
+ /// xpressive semantic action.
     function<op::insert>::type const insert = {{}};
+
+ /// \brief \c make_pair is a lazy PolymorphicFunctionObject for making a \c std::pair\<\> in an
+ /// xpressive semantic action.
     function<op::make_pair>::type const make_pair = {{}};
+
+ /// \brief \c unwrap_reference is a lazy PolymorphicFunctionObject for unwrapping a \c boost::reference_wrapper\<\> in an
+ /// xpressive semantic action.
     function<op::unwrap_reference>::type const unwrap_reference = {{}};
 
+ /// \brief \c value\<\> is a lazy wrapper for a value that can be used in xpressive semantic actions.
+ /// \tparam T The type of the value to store.
+ ///
+ /// Below is an example that shows where \c <tt>value\<\></tt> is useful.
+ ///
+ /** \code
+ sregex good_voodoo(boost::shared_ptr<int> pi)
+ {
+ using namespace boost::xpressive;
+ // Use val() to hold the shared_ptr by value:
+ sregex rex = +( _d [ ++*val(pi) ] >> '!' );
+ // OK, rex holds a reference count to the integer.
+ return rex;
+ }
+ \endcode
+ */
+ ///
+ /// In the above code, \c xpressive::val() is a function that returns a \c value\<\> object. Had
+ /// \c val() not been used here, the operation <tt>++*pi</tt> would have been evaluated eagerly
+ /// once, instead of lazily when the regex match happens.
     template<typename T>
     struct value
       : proto::extends<typename proto::terminal<T>::type, value<T> >
     {
+ /// INTERNAL ONLY
         typedef proto::extends<typename proto::terminal<T>::type, value<T> > base_type;
 
+ /// \brief Store a default-constructed \c T
         value()
           : base_type()
         {}
 
+ /// \param t The initial value.
+ /// \brief Store a copy of \c t.
         explicit value(T const &t)
           : base_type(base_type::proto_base_expr::make(t))
         {}
 
         using base_type::operator=;
 
+ /// \overload
         T &get()
         {
             return proto::value(*this);
         }
 
+ /// \brief Fetch the stored value
         T const &get() const
         {
             return proto::value(*this);
         }
     };
 
+ /// \brief \c reference\<\> is a lazy wrapper for a reference that can be used in
+ /// xpressive semantic actions.
+ ///
+ /// \tparam T The type of the referent.
+ ///
+ /// Here is an example of how to use \c reference\<\> to create a lazy reference to
+ /// an existing object so it can be read and written in an xpressive semantic action.
+ ///
+ /** \code
+ using namespace boost::xpressive;
+ std::map<std::string, int> result;
+ reference<std::map<std::string, int> > result_ref(result);
+
+ // Match a word and an integer, separated by =>,
+ // and then stuff the result into a std::map<>
+ sregex pair = ( (s1= +_w) >> "=>" >> (s2= +_d) )
+ [ result_ref[s1] = as<int>(s2) ];
+ \endcode
+ */
     template<typename T>
     struct reference
       : proto::extends<typename proto::terminal<reference_wrapper<T> >::type, reference<T> >
     {
+ /// INTERNAL ONLY
         typedef proto::extends<typename proto::terminal<reference_wrapper<T> >::type, reference<T> > base_type;
 
+ /// \param t Reference to object
+ /// \brief Store a reference to \c t
         explicit reference(T &t)
           : base_type(base_type::proto_base_expr::make(boost::ref(t)))
         {}
 
         using base_type::operator=;
 
+ /// \brief Fetch the stored value
         T &get() const
         {
             return proto::value(*this).get();
         }
     };
 
+ /// \brief \c local\<\> is a lazy wrapper for a reference to a value that is stored within the local itself.
+ /// It is for use within xpressive semantic actions.
+ ///
+ /// \tparam T The type of the local variable.
+ ///
+ /// Below is an example of how to use \c local\<\> in semantic actions.
+ ///
+ /** \code
+ using namespace boost::xpressive;
+ local<int> i(0);
+ std::string str("1!2!3?");
+ // count the exciting digits, but not the
+ // questionable ones.
+ sregex rex = +( _d [ ++i ] >> '!' );
+ regex_search(str, rex);
+ assert( i.get() == 2 );
+ \endcode
+ */
+ ///
+ /// \note As the name "local" suggests, \c local\<\> objects and the regexes
+ /// that refer to them should never leave the local scope. The value stored
+ /// within the local object will be destroyed at the end of the \c local\<\>'s
+ /// lifetime, and any regex objects still holding the \c local\<\> will be
+ /// left with a dangling reference.
     template<typename T>
     struct local
       : detail::value_wrapper<T>
       , proto::terminal<reference_wrapper<T> >::type
     {
+ /// INTERNAL ONLY
         typedef typename proto::terminal<reference_wrapper<T> >::type base_type;
 
+ /// \brief Store a default-constructed value of type \c T
         local()
           : detail::value_wrapper<T>()
           , base_type(base_type::make(boost::ref(detail::value_wrapper<T>::value)))
         {}
 
+ /// \param t The initial value.
+ /// \brief Store a default-constructed value of type \c T
         explicit local(T const &t)
           : detail::value_wrapper<T>(t)
           , base_type(base_type::make(boost::ref(detail::value_wrapper<T>::value)))
@@ -823,121 +1146,369 @@
 
         using base_type::operator=;
 
+ /// Fetch the wrapped value.
         T &get()
         {
             return proto::value(*this);
         }
 
+ /// \overload
         T const &get() const
         {
             return proto::value(*this);
         }
     };
 
- /// as (a.k.a., lexical_cast)
- ///
- template<typename X2_0, typename A0>
- typename detail::make_function::impl<op::as<X2_0> const, A0 const &>::result_type const
- as(A0 const &a0)
+ /// \brief \c as() is a lazy funtion for lexically casting a parameter to a different type.
+ /// \tparam T The type to which to lexically cast the parameter.
+ /// \param a The lazy value to lexically cast.
+ /// \return A lazy object that, when evaluated, lexically casts its argument to the desired type.
+ template<typename T, typename A>
+ typename detail::make_function::impl<op::as<T> const, A const &>::result_type const
+ as(A const &a)
     {
- return detail::make_function::impl<op::as<X2_0> const, A0 const &>()((op::as<X2_0>()), a0);
+ return detail::make_function::impl<op::as<T> const, A const &>()((op::as<T>()), a);
     }
 
- /// static_cast_
- ///
- template<typename X2_0, typename A0>
- typename detail::make_function::impl<op::static_cast_<X2_0> const, A0 const &>::result_type const
- static_cast_(A0 const &a0)
+ /// \brief \c static_cast_ is a lazy funtion for statically casting a parameter to a different type.
+ /// \tparam T The type to which to statically cast the parameter.
+ /// \param a The lazy value to statically cast.
+ /// \return A lazy object that, when evaluated, statically casts its argument to the desired type.
+ template<typename T, typename A>
+ typename detail::make_function::impl<op::static_cast_<T> const, A const &>::result_type const
+ static_cast_(A const &a)
     {
- return detail::make_function::impl<op::static_cast_<X2_0> const, A0 const &>()((op::static_cast_<X2_0>()), a0);
+ return detail::make_function::impl<op::static_cast_<T> const, A const &>()((op::static_cast_<T>()), a);
     }
 
- /// dynamic_cast_
- ///
- template<typename X2_0, typename A0>
- typename detail::make_function::impl<op::dynamic_cast_<X2_0> const, A0 const &>::result_type const
- dynamic_cast_(A0 const &a0)
+ /// \brief \c dynamic_cast_ is a lazy funtion for dynamically casting a parameter to a different type.
+ /// \tparam T The type to which to dynamically cast the parameter.
+ /// \param a The lazy value to dynamically cast.
+ /// \return A lazy object that, when evaluated, dynamically casts its argument to the desired type.
+ template<typename T, typename A>
+ typename detail::make_function::impl<op::dynamic_cast_<T> const, A const &>::result_type const
+ dynamic_cast_(A const &a)
     {
- return detail::make_function::impl<op::dynamic_cast_<X2_0> const, A0 const &>()((op::dynamic_cast_<X2_0>()), a0);
+ return detail::make_function::impl<op::dynamic_cast_<T> const, A const &>()((op::dynamic_cast_<T>()), a);
     }
 
- /// const_cast_
- ///
- template<typename X2_0, typename A0>
- typename detail::make_function::impl<op::const_cast_<X2_0> const, A0 const &>::result_type const
- const_cast_(A0 const &a0)
+ /// \brief \c dynamic_cast_ is a lazy funtion for const-casting a parameter to a different type.
+ /// \tparam T The type to which to const-cast the parameter.
+ /// \param a The lazy value to const-cast.
+ /// \return A lazy object that, when evaluated, const-casts its argument to the desired type.
+ template<typename T, typename A>
+ typename detail::make_function::impl<op::const_cast_<T> const, A const &>::result_type const
+ const_cast_(A const &a)
     {
- return detail::make_function::impl<op::const_cast_<X2_0> const, A0 const &>()((op::const_cast_<X2_0>()), a0);
+ return detail::make_function::impl<op::const_cast_<T> const, A const &>()((op::const_cast_<T>()), a);
     }
 
- /// val()
- ///
+ /// \brief Helper for constructing \c value\<\> objects.
+ /// \return <tt>value\<T\>(t)</tt>
     template<typename T>
     value<T> const val(T const &t)
     {
         return value<T>(t);
     }
 
- /// ref()
- ///
+ /// \brief Helper for constructing \c reference\<\> objects.
+ /// \return <tt>reference\<T\>(t)</tt>
     template<typename T>
     reference<T> const ref(T &t)
     {
         return reference<T>(t);
     }
 
- /// cref()
- ///
+ /// \brief Helper for constructing \c reference\<\> objects that
+ /// store a reference to const.
+ /// \return <tt>reference\<T const\>(t)</tt>
     template<typename T>
     reference<T const> const cref(T const &t)
     {
         return reference<T const>(t);
     }
 
- /// check(), for testing custom assertions
+ /// \brief For adding user-defined assertions to your regular expressions.
+ ///
+ /// \param t The UnaryPredicate object or Boolean semantic action.
     ///
+ /// A \RefSect{user_s_guide.semantic_actions_and_user_defined_assertions.user_defined_assertions,user-defined assertion}
+ /// is a kind of semantic action that evaluates
+ /// a Boolean lambda and, if it evaluates to false, causes the match to
+ /// fail at that location in the string. This will cause backtracking,
+ /// so the match may ultimately succeed.
+ ///
+ /// To use \c check() to specify a user-defined assertion in a regex, use the
+ /// following syntax:
+ ///
+ /** \code
+ sregex s = (_d >> _d)[check( XXX )]; // XXX is a custom assertion
+ \endcode
+ */
+ ///
+ /// The assertion is evaluated with a \c sub_match\<\> object that delineates
+ /// what part of the string matched the sub-expression to which the assertion
+ /// was attached.
+ ///
+ /// \c check() can be used with an ordinary predicate that takes a
+ /// \c sub_match\<\> object as follows:
+ ///
+ /** \code
+ // A predicate that is true IFF a sub-match is
+ // either 3 or 6 characters long.
+ struct three_or_six
+ {
+ bool operator()(ssub_match const &sub) const
+ {
+ return sub.length() == 3 || sub.length() == 6;
+ }
+ };
+
+ // match words of 3 characters or 6 characters.
+ sregex rx = (bow >> +_w >> eow)[ check(three_or_six()) ] ;
+ \endcode
+ */
+ ///
+ /// Alternately, \c check() can be used to define inline custom
+ /// assertions with the same syntax as is used to define semantic
+ /// actions. The following code is equivalent to above:
+ ///
+ /** \code
+ // match words of 3 characters or 6 characters.
+ sregex rx = (bow >> +_w >> eow)[ check(length(_)==3 || length(_)==6) ] ;
+ \endcode
+ */
+ ///
+ /// Within a custom assertion, \c _ is a placeholder for the \c sub_match\<\>
+ /// That delineates the part of the string matched by the sub-expression to
+ /// which the custom assertion was attached.
+#ifdef BOOST_XPRESSIVE_DOXYGEN_INVOKED // A hack so Doxygen emits something more meaningful.
+ template<typename T>
+ detail::unspecified check(T const &t);
+#else
     proto::terminal<detail::check_tag>::type const check = {{}};
+#endif
 
- /// let(), for binding references to non-local variables
+ /// \brief For binding local variables to placeholders in semantic actions when
+ /// constructing a \c regex_iterator or a \c regex_token_iterator.
+ ///
+ /// \param args A set of argument bindings, where each argument binding is an assignment
+ /// expression, the left hand side of which must be an instance of \c placeholder\<X\>
+ /// for some \c X, and the right hand side is an lvalue of type \c X.
+ ///
+ /// \c xpressive::let() serves the same purpose as <tt>match_results::let()</tt>;
+ /// that is, it binds a placeholder to a local value. The purpose is to allow a
+ /// regex with semantic actions to be defined that refers to objects that do not yet exist.
+ /// Rather than referring directly to an object, a semantic action can refer to a placeholder,
+ /// and the value of the placeholder can be specified later with a <em>let expression</em>.
+ /// The <em>let expression</em> created with \c let() is passed to the constructor of either
+ /// \c regex_iterator or \c regex_token_iterator.
     ///
+ /// See the section \RefSect{user_s_guide.semantic_actions_and_user_defined_assertions.referring_to_non_local_variables, "Referring to Non-Local Variables"}
+ /// in the Users' Guide for more discussion.
+ ///
+ /// \em Example:
+ ///
+ /**
+ \code
+ // Define a placeholder for a map object:
+ placeholder<std::map<std::string, int> > _map;
+
+ // Match a word and an integer, separated by =>,
+ // and then stuff the result into a std::map<>
+ sregex pair = ( (s1= +_w) >> "=>" >> (s2= +_d) )
+ [ _map[s1] = as<int>(s2) ];
+
+ // The string to parse
+ std::string str("aaa=>1 bbb=>23 ccc=>456");
+
+ // Here is the actual map to fill in:
+ std::map<std::string, int> result;
+
+ // Create a regex_iterator to find all the matches
+ sregex_iterator it(str.begin(), str.end(), pair, let(_map=result));
+ sregex_iterator end;
+
+ // step through all the matches, and fill in
+ // the result map
+ while(it != end)
+ ++it;
+
+ std::cout << result["aaa"] << '\n';
+ std::cout << result["bbb"] << '\n';
+ std::cout << result["ccc"] << '\n';
+ \endcode
+ */
+ ///
+ /// The above code displays:
+ ///
+ /** \code{.txt}
+ 1
+ 23
+ 456
+ \endcode
+ */
+#ifdef BOOST_XPRESSIVE_DOXYGEN_INVOKED // A hack so Doxygen emits something more meaningful.
+ template<typename...ArgBindings>
+ detail::unspecified let(ArgBindings const &...args);
+#else
     detail::let_<proto::terminal<detail::let_tag>::type> const let = {{{}}};
+#endif
 
- /// placeholder<T>, for defining a placeholder to stand in fo
- /// a variable of type T in a semantic action.
+ /// \brief For defining a placeholder to stand in for a variable a semantic action.
+ ///
+ /// Use \c placeholder\<\> to define a placeholder for use in semantic actions to stand
+ /// in for real objects. The use of placeholders allows regular expressions with actions
+ /// to be defined once and reused in many contexts to read and write from objects which
+ /// were not available when the regex was defined.
+ ///
+ /// \tparam T The type of the object for which this placeholder stands in.
+ /// \tparam I An optional identifier that can be used to distinguish this placeholder
+ /// from others that may be used in the same semantic action that happen
+ /// to have the same type.
+ ///
+ /// You can use \c placeholder\<\> by creating an object of type \c placeholder\<T\>
+ /// and using that object in a semantic action exactly as you intend an object of
+ /// type \c T to be used.
     ///
+ /**
+ \code
+ placeholder<int> _i;
+ placeholder<double> _d;
+
+ sregex rex = ( some >> regex >> here )
+ [ ++_i, _d *= _d ];
+ \endcode
+ */
+ ///
+ /// Then, when doing a pattern match with either \c regex_search(),
+ /// \c regex_match() or \c regex_replace(), pass a \c match_results\<\> object that
+ /// contains bindings for the placeholders used in the regex object's semantic actions.
+ /// You can create the bindings by calling \c match_results::let as follows:
+ ///
+ /**
+ \code
+ int i = 0;
+ double d = 3.14;
+
+ smatch what;
+ what.let(_i = i)
+ .let(_d = d);
+
+ if(regex_match("some string", rex, what))
+ // i and d mutated here
+ \endcode
+ */
+ ///
+ /// If a semantic action executes that contains an unbound placeholder, a exception of
+ /// type \c regex_error is thrown.
+ ///
+ /// See the discussion for \c xpressive::let() and the
+ /// \RefSect{user_s_guide.semantic_actions_and_user_defined_assertions.referring_to_non_local_variables, "Referring to Non-Local Variables"}
+ /// section in the Users' Guide for more information.
+ ///
+ /// <em>Example:</em>
+ ///
+ /**
+ \code
+ // Define a placeholder for a map object:
+ placeholder<std::map<std::string, int> > _map;
+
+ // Match a word and an integer, separated by =>,
+ // and then stuff the result into a std::map<>
+ sregex pair = ( (s1= +_w) >> "=>" >> (s2= +_d) )
+ [ _map[s1] = as<int>(s2) ];
+
+ // Match one or more word/integer pairs, separated
+ // by whitespace.
+ sregex rx = pair >> *(+_s >> pair);
+
+ // The string to parse
+ std::string str("aaa=>1 bbb=>23 ccc=>456");
+
+ // Here is the actual map to fill in:
+ std::map<std::string, int> result;
+
+ // Bind the _map placeholder to the actual map
+ smatch what;
+ what.let( _map = result );
+
+ // Execute the match and fill in result map
+ if(regex_match(str, what, rx))
+ {
+ std::cout << result["aaa"] << '\n';
+ std::cout << result["bbb"] << '\n';
+ std::cout << result["ccc"] << '\n';
+ }
+ \endcode
+ */
+#ifdef BOOST_XPRESSIVE_DOXYGEN_INVOKED // A hack so Doxygen emits something more meaningful.
+ template<typename T, int I = 0>
+ struct placeholder
+ {
+ /// \param t The object to associate with this placeholder
+ /// \return An object of unspecified type that records the association of \c t
+ /// with \c *this.
+ detail::unspecified operator=(T &t) const;
+ /// \overload
+ detail::unspecified operator=(T const &t) const;
+ };
+#else
     template<typename T, int I, typename Dummy>
     struct placeholder
     {
         typedef placeholder<T, I, Dummy> this_type;
- typedef typename proto::terminal<detail::action_arg<T, mpl::int_<I> > >::type action_arg_type;
+ typedef
+ typename proto::terminal<detail::action_arg<T, mpl::int_<I> > >::type
+ action_arg_type;
 
         BOOST_PROTO_EXTENDS(action_arg_type, this_type, proto::default_domain)
     };
+#endif
 
- /// Usage: construct\<Type\>(arg1, arg2)
- ///
- /// Usage: throw_\<Exception\>(arg1, arg2)
- ///
- #define BOOST_PROTO_LOCAL_MACRO(N, typename_A, A_const_ref, A_const_ref_a, a)\
- \
- template<typename X2_0 BOOST_PP_COMMA_IF(N) typename_A(N)>\
- typename detail::make_function::impl<op::construct<X2_0> const BOOST_PP_COMMA_IF(N) A_const_ref(N)>::result_type const\
- construct(A_const_ref_a(N))\
- {\
- return detail::make_function::impl<op::construct<X2_0> const BOOST_PP_COMMA_IF(N) A_const_ref(N)>()((op::construct<X2_0>()) BOOST_PP_COMMA_IF(N) a(N));\
- }\
- \
- template<typename X2_0 BOOST_PP_COMMA_IF(N) typename_A(N)>\
- typename detail::make_function::impl<op::throw_<X2_0> const BOOST_PP_COMMA_IF(N) A_const_ref(N)>::result_type const\
- throw_(A_const_ref_a(N))\
- {\
- return detail::make_function::impl<op::throw_<X2_0> const BOOST_PP_COMMA_IF(N) A_const_ref(N)>()((op::throw_<X2_0>()) BOOST_PP_COMMA_IF(N) a(N));\
- }\
+ /// \brief A lazy funtion for constructing objects objects of the specified type.
+ /// \tparam T The type of object to construct.
+ /// \param args The arguments to the constructor.
+ /// \return A lazy object that, when evaluated, returns <tt>T(xs...)</tt>, where
+ /// <tt>xs...</tt> is the result of evaluating the lazy arguments
+ /// <tt>args...</tt>.
+#ifdef BOOST_XPRESSIVE_DOXYGEN_INVOKED // A hack so Doxygen emits something more meaningful.
+ template<typename T, typename ...Args>
+ detail::unspecified construct(Args const &...args);
+#else
+/// INTERNAL ONLY
+#define BOOST_PROTO_LOCAL_MACRO(N, typename_A, A_const_ref, A_const_ref_a, a) \
+ template<typename X2_0 BOOST_PP_COMMA_IF(N) typename_A(N)> \
+ typename detail::make_function::impl< \
+ op::construct<X2_0> const \
+ BOOST_PP_COMMA_IF(N) A_const_ref(N) \
+ >::result_type const \
+ construct(A_const_ref_a(N)) \
+ { \
+ return detail::make_function::impl< \
+ op::construct<X2_0> const \
+ BOOST_PP_COMMA_IF(N) A_const_ref(N) \
+ >()((op::construct<X2_0>()) BOOST_PP_COMMA_IF(N) a(N)); \
+ } \
+ \
+ template<typename X2_0 BOOST_PP_COMMA_IF(N) typename_A(N)> \
+ typename detail::make_function::impl< \
+ op::throw_<X2_0> const \
+ BOOST_PP_COMMA_IF(N) A_const_ref(N) \
+ >::result_type const \
+ throw_(A_const_ref_a(N)) \
+ { \
+ return detail::make_function::impl< \
+ op::throw_<X2_0> const \
+ BOOST_PP_COMMA_IF(N) A_const_ref(N) \
+ >()((op::throw_<X2_0>()) BOOST_PP_COMMA_IF(N) a(N)); \
+ } \
     /**/
 
- #define BOOST_PROTO_LOCAL_a BOOST_PROTO_a
- #define BOOST_PROTO_LOCAL_LIMITS (0, BOOST_PP_DEC(BOOST_PROTO_MAX_ARITY))
+ #define BOOST_PROTO_LOCAL_a BOOST_PROTO_a ///< INTERNAL ONLY
+ #define BOOST_PROTO_LOCAL_LIMITS (0, BOOST_PP_DEC(BOOST_PROTO_MAX_ARITY)) ///< INTERNAL ONLY
     #include BOOST_PROTO_LOCAL_ITERATE()
+#endif
 
     namespace detail
     {
@@ -996,9 +1567,6 @@
     }
 }}
 
-#undef UNREF
-#undef UNCVREF
-
 #if BOOST_MSVC
 #pragma warning(pop)
 #endif

Modified: trunk/libs/xpressive/doc/Jamfile.v2
==============================================================================
--- trunk/libs/xpressive/doc/Jamfile.v2 Sat Oct 12 13:46:00 2013 (r86266)
+++ trunk/libs/xpressive/doc/Jamfile.v2 2013-10-12 15:24:17 EDT (Sat, 12 Oct 2013) (r86267)
@@ -16,8 +16,10 @@
                                    \"BOOST_XPRESSIVE_GLOBAL_MARK_TAG(x,y)=mark_tag const x(y)\" \\
                                    \"BOOST_STATIC_CONSTANT(x,y)=static x const y\" \\
                                    \"BOOST_XPR_NONDEDUCED_TYPE_(X)=X\" \\
+ \"BOOST_PROTO_DISABLE_IF_IS_CONST(X)=\" \\
                                    \"UNREF(X)=typename remove_reference<X>::type\" \\
                                    \"UNCV(X)=typename remove_const<X>::type\" \\
+ \"UNREF(X)=typename remove_reference<X>::type\" \\
                                    \"UNCVREF(X)=typename remove_const<typename remove_reference<X>::type>::type\""
         <doxygen:param>HIDE_UNDOC_MEMBERS=NO
         <doxygen:param>EXTRACT_PRIVATE=NO
@@ -26,6 +28,8 @@
         <doxygen:param>EXPAND_ONLY_PREDEF=YES
         <doxygen:param>SEARCH_INCLUDES=YES
         <doxygen:param>INCLUDE_PATH=$(BOOST_ROOT)
+ # So that Doxygen comments can link to sections in the quickbook users' guide
+ <doxygen:param>"ALIASES=\"RefSect{2}=\\xmlonly<link linkend='boost_xpressive.\\1'>\\2</link>\\endxmlonly\""
     ;
 
 xml xpressive


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