a/util: Improve docs structure

This commit is contained in:
Ryan Pavlik 2022-05-18 10:31:57 -05:00
parent 3de4488dfd
commit 588b4831a2
3 changed files with 10 additions and 7 deletions

View file

@ -20,7 +20,7 @@ extern "C" {
struct xrt_hmd_parts;
/*!
* @defgroup aux_distortion Distortion utilities.
* @defgroup aux_distortion Distortion utilities
* @ingroup aux_util
*/

View file

@ -24,7 +24,7 @@ struct xrt_device;
/*!
* @defgroup aux_log Logging functions.
* @defgroup aux_log Logging functions
* @ingroup aux_util
*/

View file

@ -16,10 +16,11 @@ extern "C" {
/*!
* @defgroup aux_pretty Pretty printing functions.
* @defgroup aux_pretty Pretty printing functions and helpers
* @ingroup aux_util
*
* Multiple modules implement additional pretty printing functions like
* @ref oxr_api.
* This is common functionality used directly and shared by additional pretty
* printing functions implemented in multiple modules, such as @ref oxr_api.
*
* Some functions have a `_indented` suffix added to them, this means that what
* they print starts indented, but also they start with a newline. This is so
@ -29,8 +30,10 @@ extern "C" {
*/
/*!
* Function prototype for receiving pretty printed strings, do not keep a
* reference to the pointer as it's often allocated on the stack for speed.
* Function prototype for receiving pretty printed strings.
*
* @note Do not keep a reference to the pointer as it's often allocated on the
* stack for speed.
*
* @ingroup aux_pretty
*/