<div dir="ltr">This looks good.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Aug 10, 2022 at 8:24 AM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">The interfaces in the MallocSupport group belong to the implementation.  They<br>
are used by confdefs.h for example.<br>
---<br>
 cpukit/include/rtems/malloc.h | 60 ++++++++++++++++++++++++-----------<br>
 1 file changed, 41 insertions(+), 19 deletions(-)<br>
<br>
diff --git a/cpukit/include/rtems/malloc.h b/cpukit/include/rtems/malloc.h<br>
index 7d7f8fa677..c26b262881 100644<br>
--- a/cpukit/include/rtems/malloc.h<br>
+++ b/cpukit/include/rtems/malloc.h<br>
@@ -3,7 +3,12 @@<br>
 /**<br>
  * @file<br>
  *<br>
- * This file defines the interface to RTEMS extensions to the Malloc Family.<br>
+ * @ingroup MallocSupport<br>
+ *<br>
+ * @ingroup RTEMSAPIMalloc<br>
+ *<br>
+ * @brief This header file defines interfaces to support and use dynamic memory<br>
+ *   allocation.<br>
  */<br>
<br>
 /*<br>
@@ -46,11 +51,13 @@ extern "C" {<br>
 #endif<br>
<br>
 /**<br>
- *  @defgroup MallocSupport Malloc Support<br>
+ * @defgroup MallocSupport Malloc Support<br>
+ *<br>
+ * @ingroup libcsupport<br>
  *<br>
- *  @ingroup libcsupport<br>
+ * @brief This group contains interfaces to support dynamic memory allocation.<br>
  *<br>
- *  @brief RTEMS extensions to the Malloc Family<br>
+ * @{<br>
  */<br>
<br>
 /**<br>
@@ -63,8 +70,6 @@ extern Heap_Control *RTEMS_Malloc_Heap;<br>
<br>
 void _Malloc_Initialize( void );<br>
<br>
-void rtems_heap_set_sbrk_amount( ptrdiff_t sbrk_amount );<br>
-<br>
 typedef void *(*rtems_heap_extend_handler)(<br>
   Heap_Control *heap,<br>
   size_t alloc_size<br>
@@ -78,19 +83,6 @@ void *rtems_heap_extend_via_sbrk(<br>
   size_t alloc_size<br>
 );<br>
<br>
-/**<br>
- * @brief Greedy allocate that empties the sbrk memory<br>
- *<br>
- * Afterwards all the sbrk avialable memory will have been allocated<br>
- * to the provided heap.<br>
- *<br>
- * @see rtems_heap_extend_via_sbrk().<br>
- */<br>
-void rtems_heap_sbrk_greedy_allocate(<br>
-  Heap_Control *heap,<br>
-  size_t alloc_size<br>
-);<br>
-<br>
 void *rtems_heap_null_extend(<br>
   Heap_Control *heap,<br>
   size_t alloc_size<br>
@@ -104,6 +96,34 @@ extern const rtems_heap_extend_handler rtems_malloc_extend_handler;<br>
 typedef void (*rtems_malloc_dirtier_t)(void *, size_t);<br>
 extern rtems_malloc_dirtier_t rtems_malloc_dirty_helper;<br>
<br>
+/** @} */<br>
+<br>
+/**<br>
+ * @defgroup RTEMSAPIMalloc Dynamic Memory Allocation<br>
+ *<br>
+ * @ingroup RTEMSAPI<br>
+ *<br>
+ * @brief This group contains non-standard interfaces to use dynamic memory<br>
+ *   allocation.<br>
+ *<br>
+ * @{<br>
+ */<br>
+<br>
+void rtems_heap_set_sbrk_amount( ptrdiff_t sbrk_amount );<br>
+<br>
+/**<br>
+ * @brief Greedy allocate that empties the sbrk memory<br>
+ *<br>
+ * Afterwards all the sbrk avialable memory will have been allocated<br>
+ * to the provided heap.<br>
+ *<br>
+ * @see rtems_heap_extend_via_sbrk().<br>
+ */<br>
+void rtems_heap_sbrk_greedy_allocate(<br>
+  Heap_Control *heap,<br>
+  size_t alloc_size<br>
+);<br>
+<br>
 /**<br>
  *  @brief Dirty Memory Function<br>
  *<br>
@@ -251,6 +271,8 @@ void *rtems_heap_greedy_allocate_all_except_largest(<br>
  */<br>
 void rtems_heap_greedy_free( void *opaque );<br>
<br>
+/** @} */<br>
+<br>
 #ifdef __cplusplus<br>
 }<br>
 #endif<br>
-- <br>
2.35.3<br>
<br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div>