From 8feafa8f00d304a936d926246c29fc48d92535e7 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Wed, 2 Nov 2022 18:45:53 -0400 Subject: Improve documentation --- include/zix/digest.h | 2 +- include/zix/status.h | 7 ++++++- include/zix/zix.h | 9 ++++++++- 3 files changed, 15 insertions(+), 3 deletions(-) (limited to 'include/zix') diff --git a/include/zix/digest.h b/include/zix/digest.h index 4c4fb02..deffaf0 100644 --- a/include/zix/digest.h +++ b/include/zix/digest.h @@ -13,7 +13,7 @@ ZIX_BEGIN_DECLS /** @defgroup zix_digest Digest - @ingroup zix_utilities + @ingroup zix_algorithms Functions to generate a short "digest" of data with minimal collisions. diff --git a/include/zix/status.h b/include/zix/status.h index dfd6412..47aede8 100644 --- a/include/zix/status.h +++ b/include/zix/status.h @@ -32,7 +32,12 @@ typedef enum { ZIX_STATUS_MAX_LINKS, ///< Too many links } ZixStatus; -/// Return a string describing a status code +/** + Return a string describing a status code in plain English. + + The returned string is always one sentence, with an uppercase first + character, and no trailing period. +*/ ZIX_CONST_API const char* zix_strerror(ZixStatus status); diff --git a/include/zix/zix.h b/include/zix/zix.h index db54ce4..d0ac943 100644 --- a/include/zix/zix.h +++ b/include/zix/zix.h @@ -17,7 +17,6 @@ */ #include "zix/attributes.h" -#include "zix/digest.h" #include "zix/status.h" #include "zix/string_view.h" @@ -30,6 +29,14 @@ #include "zix/allocator.h" #include "zix/bump_allocator.h" +/** + @} + @defgroup zix_algorithms Algorithms + @{ +*/ + +#include "zix/digest.h" + /** @} @defgroup zix_data_structures Data Structures -- cgit v1.2.1