[PATCH 43/98] doxygen: score: adjust doc in rbtree.h to doxygen guidelines

[Chris Johns]

Hi,

The patch breaks master. It might pay to build it locally.

On 7/5/19 3:39 pm, Sebastian Huber wrote:
> From: Andreas Dachsberger <andreas.dachsberger at embedded-brains.de>
> 
> ---
>  cpukit/include/rtems/score/rbtree.h | 154 +++++++++++++++++++++---------------
>  1 file changed, 90 insertions(+), 64 deletions(-)
> 
> diff --git a/cpukit/include/rtems/score/rbtree.h b/cpukit/include/rtems/score/rbtree.h
> index b63c5cb4c2..1e18d08fd3 100644
> @@ -258,6 +267,12 @@ RTEMS_INLINE_ROUTINE RBTree_Node **_RBTree_Root_reference(
>  
>  /**
>   * @brief Returns a constant reference to the root pointer of the red-black tree.
> + *
> + * @param the_rbtree The red-black tree control.
> + *
> + * @retval pointer Pointer to the root node.
> + * @retval NULL The tree is empty.
> + */
>   */

Double end comment block marker on psim is giving me ...

In file included from
/opt/work/chris/rtems/kernel/rtems.git/cpukit/include/rtems/score/priority.h:25:0,
                 from
/opt/work/chris/rtems/kernel/rtems.git/cpukit/include/rtems/score/threadq.h:27,

                 from
/opt/work/chris/rtems/kernel/rtems.git/cpukit/include/rtems/score/coremsg.h:26,

                 from
/opt/work/chris/rtems/kernel/rtems.git/cpukit/include/rtems/posix/mqueue.h:34,

                 from
/opt/work/chris/rtems/kernel/rtems.git/cpukit/include/rtems/posix/mqueueimpl.h:22,

                 from
/opt/work/chris/rtems/kernel/rtems.git/c/src/../../cpukit/posix/src/mqueuenotify.c:21:
/opt/work/chris/rtems/kernel/rtems.git/cpukit/include/rtems/score/rbtree.h:276:3:
error: expected identifier or '(' before '/' token



  */

   ^


I will push a fix soon.

Chris