From: khizmax Date: Mon, 6 Oct 2014 16:08:57 +0000 (+0400) Subject: MSQueue/MoirQueue doc fix X-Git-Tag: v2.0.0~224 X-Git-Url: http://plrg.eecs.uci.edu/git/?p=libcds.git;a=commitdiff_plain;h=efe24fc8499a5cc3db92ea2d1b78f36011fcf077 MSQueue/MoirQueue doc fix --- diff --git a/cds/container/moir_queue.h b/cds/container/moir_queue.h index 0628cde7..832e5c9d 100644 --- a/cds/container/moir_queue.h +++ b/cds/container/moir_queue.h @@ -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 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() diff --git a/cds/container/msqueue.h b/cds/container/msqueue.h index 7fbdd782..df6a5773 100644 --- a/cds/container/msqueue.h +++ b/cds/container/msqueue.h @@ -162,9 +162,9 @@ namespace cds { namespace container { template 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() { diff --git a/tools/make_docs.bat b/tools/make_docs.bat index 16c6796e..37695a72 100644 --- a/tools/make_docs.bat +++ b/tools/make_docs.bat @@ -2,6 +2,6 @@ set DOXYPRJ_ROOT=. cd .. rm -fr doc md doc -%DOXYGEN_PATH%\bin\doxygen doxygen\cds.doxy > tools\doxygen.log 2>&1 +"%DOXYGEN_PATH%\bin\doxygen" doxygen\cds.doxy > tools\doxygen.log 2>&1 cp -f doxygen/index.html doc/index.html cd tools