Improve macro and comments documentation.

Author: adel-mamin

CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [0-based versioning](https://0ver.org/).
 ### Changed
 
 - Improve macro comments in `libs/common/macros.h`.
+- Improve macro and comments documentation.
 
 ## v0.14.1 - 30-August-2025
 

Doxyfile.in

@@ -12,23 +12,18 @@ WARN_AS_ERROR          = YES
 
 MACRO_EXPANSION        = YES
 PREDEFINED             = "AM_PRINTF(a,b)=" \
-                         "AM_MAY_ALIAS="
+                         "AM_MAY_ALIAS=" \
+                         "AM_ASSERT_STATIC(x)="
 
 EXCLUDE_PATTERNS       = *test*,\
                          *stubs*,\
                          *cobszpe*,\
                          *freertos*
 
-EXCLUDE_SYMBOLS        = AM_ASSERT_STATIC \
-                         AM_POOL_BLOCK_SIZEOF \
+EXCLUDE_SYMBOLS        = AM_POOL_BLOCK_SIZEOF \
                          AM_POOL_BLOCK_ALIGNMENT \
                          _POSIX_C_SOURCE \
                          _GNU_SOURCE \
-                         AM_EVT_RANGE_HSM_BEGIN \
-                         AM_EVT_RANGE_HSM_END \
-                         AM_EVT_RANGE_FSM_BEGIN \
-                         AM_EVT_RANGE_FSM_END \
-                         AM_EVT_INTERNAL_MAX \
                          AM_EVENT_REF_COUNTER_BITS \
                          AM_EVENT_REF_COUNTER_MASK \
                          AM_EVENT_TICK_DOMAIN_BITS \

docs/api.rst

@@ -5,12 +5,46 @@ API
 
 This part of the documentation covers all the Amast interfaces.
 
-.. _common_constants:
+.. _common_macros_and_constants:
 
-Common Constants
-----------------
+Common Macros And Constants
+---------------------------
 
-.. doxygenfile:: alignment.h
+.. doxygendefine:: AM_ALIGNOF
+
+.. doxygendefine:: AM_ALIGNOF_DEFINE
+
+.. doxygendefine:: AM_ALIGNOF_PTR
+
+.. doxygendefine:: AM_ALIGN_MAX
+
+.. doxygendefine:: AM_ALIGN_PTR_DOWN
+
+.. doxygendefine:: AM_ALIGN_PTR_UP
+
+.. doxygendefine:: AM_ALIGN_SIZE
+
+.. doxygendefine:: AM_ASSERT
+
+.. doxygendefine:: AM_ASSERT_STATIC
+
+.. doxygendefine:: AM_CAST
+
+.. doxygendefine:: AM_COUNTOF
+
+.. doxygendefine:: AM_CONTAINER_OF
+
+.. doxygendefine:: AM_DO_EVERY
+
+.. doxygendefine:: AM_DO_ONCE
+
+.. doxygendefine:: AM_DO_EACH_MS
+
+.. doxygendefine:: AM_MAX
+
+.. doxygendefine:: AM_MIN
+
+.. doxygendefine:: AM_VCAST
 
 .. _common_types: