MSQueue/MoirQueue doc fix
authorkhizmax <khizmax@gmail.com>
Mon, 6 Oct 2014 16:08:57 +0000 (20:08 +0400)
committerkhizmax <khizmax@gmail.com>
Mon, 6 Oct 2014 16:08:57 +0000 (20:08 +0400)
cds/container/moir_queue.h
cds/container/msqueue.h
tools/make_docs.bat

index 0628cde76941ecef12d8d683b9eea72a3e6abbec..832e5c9d0cdfd86547ca2d758bcf884083cfb3e5 100644 (file)
@@ -26,7 +26,7 @@ namespace cds { namespace container {
 
         Template arguments:
         - \p GC - garbage collector type: \p gc::HP, \p gc::DHP
-        - \p T is a type stored in the queue.
+        - \p T - a type stored in the queue.
         - \p Traits - queue traits, default is \p msqueue::traits. You can use \p msqueue::make_traits
             metafunction to make your traits or just derive your traits from \p %msqueue::traits:
             \code
@@ -48,9 +48,9 @@ namespace cds { namespace container {
     template <typename GC, typename T, typename Traits>
     class MoirQueue:
 #ifdef CDS_DOXYGEN_INVOKED
-        intrusive::MoirQueue< GC, intrusive::msqueue::node< T >, Traits >
+        private intrusive::MoirQueue< GC, intrusive::msqueue::node< T >, Traits >
 #else
-        details::make_moir_queue< GC, T, Traits >::type
+        private details::make_moir_queue< GC, T, Traits >::type
 #endif
     {
         //@cond
@@ -66,7 +66,7 @@ namespace cds { namespace container {
         };
 
     public:
-        typedef T value_type ; ///< Value type stored in the stack
+        typedef T value_type ; ///< Value type stored in the queue
         typedef typename base_class::gc                 gc;             ///< Garbage collector
         typedef typename base_class::back_off           back_off;       ///< Back-off strategy
         typedef typename maker::allocator_type          allocator_type; ///< Allocator type used for allocate/deallocate the nodes
@@ -139,9 +139,9 @@ namespace cds { namespace container {
 
         /// Enqueues \p data to queue using a functor
         /**
-            \p Func is a functor called to create node.
-            The functor should initialize creating node 
-            and it \p f takes one argument - a reference to a new node of type \ref value_type:
+            \p Func is a functor calling to create a new node.
+            The functor should initialize creating node
+            and it takes one argument - a reference to a new node of type \ref value_type :
             \code
             cds:container::MoirQueue< cds::gc::HP, Foo > myQueue;
             Bar bar;
@@ -234,8 +234,8 @@ namespace cds { namespace container {
 
         /// Clear the queue
         /**
-            The function repeatedly calls \ref dequeue until it returns nullptr.
-            The disposer defined in template \p Options is called for each item
+            The function repeatedly calls \ref dequeue until it returns \p nullptr.
+            The disposer defined in template \p Traits is called for each item
             that can be safely disposed.
         */
         void clear()
index 7fbdd782736fd53e31e4b86062e89aaee9d335c0..df6a57738b65a76f0743a3a91a69d057be83bc75 100644 (file)
@@ -162,9 +162,9 @@ namespace cds { namespace container {
     template <typename GC, typename T, typename Traits = msqueue::traits>
     class MSQueue:
 #ifdef CDS_DOXYGEN_INVOKED
-        intrusive::MSQueue< GC, cds::intrusive::msqueue::node< T >, Traits >
+        private intrusive::MSQueue< GC, cds::intrusive::msqueue::node< T >, Traits >
 #else
-        details::make_msqueue< GC, T, Traits >::type
+        private details::make_msqueue< GC, T, Traits >::type
 #endif
     {
         //@cond
@@ -254,7 +254,7 @@ namespace cds { namespace container {
         /// Enqueues \p data to queue using a functor
         /**
             \p Func is a functor called to create node.
-            The functor \p f takes one argument - a reference to a new node of type \ref value_type:
+            The functor \p f takes one argument - a reference to a new node of type \ref value_type :
             \code
             cds:container::MSQueue< cds::gc::HP, Foo > myQueue;
             Bar bar;
@@ -347,7 +347,7 @@ namespace cds { namespace container {
 
         /// Clear the queue
         /**
-        The function repeatedly calls \ref dequeue until it returns \p nullptr.
+            The function repeatedly calls \ref dequeue until it returns \p nullptr.
         */
         void clear()
         {
index 16c6796ee02bfd69e2e4d9bfd383aa2c809fd75c..37695a727465ba1fcfa9e7c4a3676d5903e0b05b 100644 (file)
@@ -2,6 +2,6 @@ set DOXYPRJ_ROOT=.
 cd ..\r
 rm -fr doc\r
 md doc\r
-%DOXYGEN_PATH%\bin\doxygen doxygen\cds.doxy > tools\doxygen.log 2>&1\r
+"%DOXYGEN_PATH%\bin\doxygen" doxygen\cds.doxy > tools\doxygen.log 2>&1\r
 cp -f doxygen/index.html doc/index.html\r
 cd tools\r