From 668ffa3febb116d20add6e9460fb1fb521a22e35 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Thu, 20 Oct 2022 21:03:17 -0400 Subject: Fix doc comments --- include/zix/btree.h | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'include/zix/btree.h') diff --git a/include/zix/btree.h b/include/zix/btree.h index 24a0171..1b36908 100644 --- a/include/zix/btree.h +++ b/include/zix/btree.h @@ -1,4 +1,4 @@ -// Copyright 2011-2020 David Robillard +// Copyright 2011-2022 David Robillard // SPDX-License-Identifier: ISC #ifndef ZIX_BTREE_H @@ -17,9 +17,8 @@ extern "C" { #endif /** - @addtogroup zix - @{ - @name BTree + @defgroup zix_btree BTree + @ingroup zix @{ */ @@ -81,8 +80,12 @@ zix_btree_new(ZixAllocator* ZIX_NULLABLE allocator, /** Free `t` and all the nodes it contains. + @param t The tree to free. + @param destroy Function to call once for every value in the tree. This can be used to free values if they are dynamically allocated. + + @param destroy_user_data Opaque pointer to pass to `destroy`. */ ZIX_API void @@ -93,8 +96,12 @@ zix_btree_free(ZixBTree* ZIX_NULLABLE t, /** Clear everything from `t`, leaving it empty. + @param t The tree to clear. + @param destroy Function called exactly once for every value in the tree, just before that value is removed from the tree. + + @param destroy_user_data Opaque pointer to pass to `destroy`. */ ZIX_API void @@ -203,7 +210,6 @@ zix_btree_iter_next(ZixBTreeIter iter); /** @} - @} */ #ifdef __cplusplus -- cgit v1.2.1