Fix various Doxygen warnings in Haiku book.

- Return tags for methods that don't return anything
- ingroup without matching defgroup
- confusion between ref, a, and link tags (they are not the same)
- missed API changes (BObjectList templated owning, new url
  encode/decode API)
- duplicate defgroup definitions

Change-Id: I94a31b04a10a62e71659522c5ed77098728c0843
Reviewed-on: https://review.haiku-os.org/c/haiku/+/9689
Tested-by: Commit checker robot <[email protected]>
Reviewed-by: waddlesplash <[email protected]>
This commit is contained in:
PulkoMandy
2025-10-14 19:18:14 +00:00
committed by Adrien Destugues
parent 4d9e77db67
commit c66bb38463
24 changed files with 74 additions and 181 deletions
+7 -5
View File
@@ -192,12 +192,14 @@
/*!
\fn status_t add_timer(timer *t, timer_hook hook, bigtime_t period, int32 flags)
\ingroup timers
\brief Schedule a timer to call the \ref hook function periodically or at a specified time.
\brief Schedule a timer to call the \a hook function periodically or at a specified time.
\param flags If B_ONE_SHOT_ABSOLUTE_TIMER, use the period as a date when the hook should be
called. Otherwise, use it as a period to call the hook repeatedly.
\param flags If B_TIMER_USE_TIMER_STRUCT_TIMES, use the period defined by \ref t instead of
\ref period.
\param[out] t Timer handler, for use in \ref cancel_timer.
\param flags
\li If B_ONE_SHOT_ABSOLUTE_TIMER, use the \a period as a date when the hook should be
called. Otherwise, use it as a period to call the hook repeatedly.
\li If B_TIMER_USE_TIMER_STRUCT_TIMES, use the period defined by \a t instead of
\a period.
*/
/*!