add some doxygen documentation

git-svn-id: svn://svn.code.sf.net/p/loki-lib/code/trunk@396 7ec92016-0320-0410-acc4-a06ded1c099a

include/loki/Visitor.h

@@ -15,6 +15,8 @@
 
 // $Header:
 
+///  \defgroup VisitorGroup Visitor
+
 #ifndef LOKI_VISITOR_INC_
 #define LOKI_VISITOR_INC_
 
@@ -25,8 +27,10 @@ namespace Loki
 {
 
 ////////////////////////////////////////////////////////////////////////////////
-// class template BaseVisitor
+/// \class BaseVisitor
-// The base class of any Acyclic Visitor
+///  
+/// \ingroup VisitorGroup
+/// The base class of any Acyclic Visitor
 ////////////////////////////////////////////////////////////////////////////////
 
     class BaseVisitor
@@ -36,8 +40,86 @@ namespace Loki
     };
     
 ////////////////////////////////////////////////////////////////////////////////
-// class template Visitor
+/// \class Visitor
-// The building block of Acyclic Visitor
+///
+/// \ingroup VisitorGroup
+/// The building block of Acyclic Visitor
+///
+/// \par Usage
+///
+/// Defining the visitable class:
+/// 
+/// \code
+/// class RasterBitmap : public BaseVisitable<>
+/// {
+/// public:
+///     LOKI_DEFINE_VISITABLE()
+/// };
+/// \endcode
+///
+/// Way 1 to define a visitor:
+/// \code
+/// class SomeVisitor : 
+///     public BaseVisitor // required
+///     public Visitor<RasterBitmap>,
+///     public Visitor<Paragraph>
+/// {
+/// public:
+///     void Visit(RasterBitmap&); // visit a RasterBitmap
+///     void Visit(Paragraph &);   // visit a Paragraph
+/// };
+/// \endcode
+///
+/// Way 2 to define the visitor:
+/// \code
+/// class SomeVisitor : 
+///     public BaseVisitor // required
+///     public Visitor<LOKI_TYPELIST_2(RasterBitmap, Paragraph)>
+/// {
+/// public:
+///     void Visit(RasterBitmap&); // visit a RasterBitmap
+///     void Visit(Paragraph &);   // visit a Paragraph
+/// };
+/// \endcode
+///
+/// Way 3 to define the visitor:
+/// \code
+/// class SomeVisitor : 
+///     public BaseVisitor // required
+///     public Visitor<Seq<RasterBitmap, Paragraph>::Type>
+/// {
+/// public:
+///     void Visit(RasterBitmap&); // visit a RasterBitmap
+///     void Visit(Paragraph &);   // visit a Paragraph
+/// };
+/// \endcode
+///
+/// \par Using const visit functions:
+///
+/// Defining the visitable class (true for const):
+/// 
+/// \code
+/// class RasterBitmap : public BaseVisitable<void, DefaultCatchAll, true>
+/// {
+/// public:
+///     LOKI_DEFINE_CONST_VISITABLE()
+/// };
+/// \endcode
+///
+/// Defining the visitor which only calls const member functions:
+/// \code
+/// class SomeVisitor : 
+///     public BaseVisitor // required
+///     public Visitor<RasterBitmap, void, true>,
+/// {
+/// public:
+///     void Visit(const RasterBitmap&); // visit a RasterBitmap by a const member function
+/// };
+/// \endcode
+///
+/// \par Example:
+///
+/// test/Visitor/main.cpp 
 ////////////////////////////////////////////////////////////////////////////////
 
     template <class T, typename R = void, bool ConstVisit = false>
@@ -207,24 +289,35 @@ struct DefaultCatchAll
         }
     };
 
+
 ////////////////////////////////////////////////////////////////////////////////
-// macro DEFINE_VISITABLE
+/// \def LOKI_DEFINE_VISITABLE()
-// Put it in every class that you want to make visitable (in addition to 
+/// \ingroup VisitorGroup
-//     deriving it from BaseVisitable<R>
+/// Put it in every class that you want to make visitable 
+/// (in addition to deriving it from BaseVisitable<R>)
 ////////////////////////////////////////////////////////////////////////////////
 
 #define LOKI_DEFINE_VISITABLE() \
     virtual ReturnType Accept(::Loki::BaseVisitor& guest) \
     { return AcceptImpl(*this, guest); }
 
+////////////////////////////////////////////////////////////////////////////////
+/// \def LOKI_DEFINE_CONST_VISITABLE()
+/// \ingroup VisitorGroup
+/// Put it in every class that you want to make visitable by const member 
+/// functions (in addition to deriving it from BaseVisitable<R>)
+////////////////////////////////////////////////////////////////////////////////
+
 #define LOKI_DEFINE_CONST_VISITABLE() \
     virtual ReturnType Accept(::Loki::BaseVisitor& guest) const \
     { return AcceptImpl(*this, guest); }
 
 ////////////////////////////////////////////////////////////////////////////////
-// class template CyclicVisitor
+/// \class CyclicVisitor
-// Put it in every class that you want to make visitable (in addition to 
+///
-//     deriving it from BaseVisitable<R>
+/// \ingroup VisitorGroup
+/// Put it in every class that you want to make visitable (in addition to 
+/// deriving it from BaseVisitable<R>
 ////////////////////////////////////////////////////////////////////////////////
 
     template <typename R, class TList>
@@ -243,8 +336,9 @@ struct DefaultCatchAll
     };
     
 ////////////////////////////////////////////////////////////////////////////////
-// macro LOKI_DEFINE_CYCLIC_VISITABLE
+/// \def LOKI_DEFINE_CYCLIC_VISITABLE(SomeVisitor)
-// Put it in every class that you want to make visitable by a cyclic visitor
+/// \ingroup VisitorGroup
+/// Put it in every class that you want to make visitable by a cyclic visitor
 ////////////////////////////////////////////////////////////////////////////////
 
 #define LOKI_DEFINE_CYCLIC_VISITABLE(SomeVisitor) \