From 9fda8f176827a2a1f3a3ad2f5d7a594ac250ff3a Mon Sep 17 00:00:00 2001
From: Sebastian Huber <sebastian.huber@embedded-brains.de>
Date: Wed, 19 Aug 2026 05:19:32 +0200
Subject: [PATCH] cpukit/libcsupport: Fix the file groups

Nineteen files named a group which no file defines.  The names
Associativity, SET, ClassicCache, libio, Device and utsname had no
definition.  Two files left the @ingroup argument empty.  Nine files
had no @ingroup at all.  Seven sources sat in the API group
RTEMSAPIKernelCharIO, which holds the interface they implement.

Point the associativity files at RTEMSImplAssociativity and the kernel
character files at RTEMSImplKernelCharIO.  Give the nine files without
a group the group of their neighbours.  The file sup_fs_deviceio.c
implements the header which defines IMFSDevices, so it joins that group.

Thirty-one files still have no Doxygen block.  A later commit adds them.

Updates #5717.

Assisted-by: Claude:claude-opus-5 claude-code
Signed-off-by: Sebastian Huber <sebastian.huber@embedded-brains.de>
---
 cpukit/libcsupport/src/assoclocalbyname.c           | 2 +-
 cpukit/libcsupport/src/assoclocalbyremote.c         | 2 +-
 cpukit/libcsupport/src/assoclocalbyremotebitfield.c | 2 +-
 cpukit/libcsupport/src/assocnamebad.c               | 2 +-
 cpukit/libcsupport/src/assocnamebylocal.c           | 2 +-
 cpukit/libcsupport/src/assocnamebylocalbitfield.c   | 2 +-
 cpukit/libcsupport/src/assocnamebyremote.c          | 2 +-
 cpukit/libcsupport/src/assocnamebyremotebitfield.c  | 2 +-
 cpukit/libcsupport/src/assocptrbylocal.c            | 2 +-
 cpukit/libcsupport/src/assocptrbyname.c             | 2 +-
 cpukit/libcsupport/src/assocptrbyremote.c           | 2 +-
 cpukit/libcsupport/src/assocremotebylocal.c         | 2 +-
 cpukit/libcsupport/src/assocremotebylocalbitfield.c | 2 +-
 cpukit/libcsupport/src/assocremotebyname.c          | 2 +-
 cpukit/libcsupport/src/cachealignedalloc.c          | 2 ++
 cpukit/libcsupport/src/cachecoherentalloc.c         | 2 +-
 cpukit/libcsupport/src/chdir.c                      | 2 +-
 cpukit/libcsupport/src/error.c                      | 2 ++
 cpukit/libcsupport/src/flockfile.c                  | 2 +-
 cpukit/libcsupport/src/getchark.c                   | 2 +-
 cpukit/libcsupport/src/getgid.c                     | 2 +-
 cpukit/libcsupport/src/getppid.c                    | 2 +-
 cpukit/libcsupport/src/lseek.c                      | 2 ++
 cpukit/libcsupport/src/open_dev_console.c           | 2 ++
 cpukit/libcsupport/src/printk.c                     | 2 +-
 cpukit/libcsupport/src/printk_plugin.c              | 4 ++--
 cpukit/libcsupport/src/putk.c                       | 2 +-
 cpukit/libcsupport/src/rtems_put_char.c             | 2 +-
 cpukit/libcsupport/src/rtems_putc.c                 | 2 +-
 cpukit/libcsupport/src/setgid.c                     | 2 ++
 cpukit/libcsupport/src/sup_fs_deviceio.c            | 2 +-
 cpukit/libcsupport/src/tcflush.c                    | 2 ++
 cpukit/libcsupport/src/termios.c                    | 2 ++
 cpukit/libcsupport/src/termios_posix_isig_handler.c | 2 ++
 cpukit/libcsupport/src/utsname.c                    | 2 +-
 cpukit/libcsupport/src/vprintk.c                    | 2 +-
 cpukit/libcsupport/src/writev.c                     | 2 ++
 37 files changed, 47 insertions(+), 29 deletions(-)

diff --git a/cpukit/libcsupport/src/assoclocalbyname.c b/cpukit/libcsupport/src/assoclocalbyname.c
index aec533d33e..cc636bdb25 100644
--- a/cpukit/libcsupport/src/assoclocalbyname.c
+++ b/cpukit/libcsupport/src/assoclocalbyname.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup Associativity Routines
+ * @ingroup RTEMSImplAssociativity
  *
  * @brief RTEMS Associate Local by Name
  */
diff --git a/cpukit/libcsupport/src/assoclocalbyremote.c b/cpukit/libcsupport/src/assoclocalbyremote.c
index f4640f47d5..1864654954 100644
--- a/cpukit/libcsupport/src/assoclocalbyremote.c
+++ b/cpukit/libcsupport/src/assoclocalbyremote.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Local by Remote
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assoclocalbyremotebitfield.c b/cpukit/libcsupport/src/assoclocalbyremotebitfield.c
index 2b9d939e17..55c1235004 100644
--- a/cpukit/libcsupport/src/assoclocalbyremotebitfield.c
+++ b/cpukit/libcsupport/src/assoclocalbyremotebitfield.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Local by Remote Bitfield
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocnamebad.c b/cpukit/libcsupport/src/assocnamebad.c
index 71685c2942..8b5278d4ff 100644
--- a/cpukit/libcsupport/src/assocnamebad.c
+++ b/cpukit/libcsupport/src/assocnamebad.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Bad Name
  *
- *  @ingroup SET
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocnamebylocal.c b/cpukit/libcsupport/src/assocnamebylocal.c
index b181978faf..a94b0dc91a 100644
--- a/cpukit/libcsupport/src/assocnamebylocal.c
+++ b/cpukit/libcsupport/src/assocnamebylocal.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Name by Local
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocnamebylocalbitfield.c b/cpukit/libcsupport/src/assocnamebylocalbitfield.c
index 10940d1f99..cef8ec7bb3 100644
--- a/cpukit/libcsupport/src/assocnamebylocalbitfield.c
+++ b/cpukit/libcsupport/src/assocnamebylocalbitfield.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Name by Local Bitfield
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocnamebyremote.c b/cpukit/libcsupport/src/assocnamebyremote.c
index 748791e3a8..d68a350b04 100644
--- a/cpukit/libcsupport/src/assocnamebyremote.c
+++ b/cpukit/libcsupport/src/assocnamebyremote.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Name by Remote
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocnamebyremotebitfield.c b/cpukit/libcsupport/src/assocnamebyremotebitfield.c
index 006c76b8e8..c393a7bd6f 100644
--- a/cpukit/libcsupport/src/assocnamebyremotebitfield.c
+++ b/cpukit/libcsupport/src/assocnamebyremotebitfield.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Name by Remote Bitfield
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocptrbylocal.c b/cpukit/libcsupport/src/assocptrbylocal.c
index d135a34a4e..1463ba12e6 100644
--- a/cpukit/libcsupport/src/assocptrbylocal.c
+++ b/cpukit/libcsupport/src/assocptrbylocal.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Pointer by Local
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocptrbyname.c b/cpukit/libcsupport/src/assocptrbyname.c
index 12196df23d..3b3cbcace5 100644
--- a/cpukit/libcsupport/src/assocptrbyname.c
+++ b/cpukit/libcsupport/src/assocptrbyname.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Pointer by Name
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocptrbyremote.c b/cpukit/libcsupport/src/assocptrbyremote.c
index 8a32cd618e..1e2358ef71 100644
--- a/cpukit/libcsupport/src/assocptrbyremote.c
+++ b/cpukit/libcsupport/src/assocptrbyremote.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Pointer by Remote
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocremotebylocal.c b/cpukit/libcsupport/src/assocremotebylocal.c
index 166dd68402..3011bef918 100644
--- a/cpukit/libcsupport/src/assocremotebylocal.c
+++ b/cpukit/libcsupport/src/assocremotebylocal.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Remote by Local
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocremotebylocalbitfield.c b/cpukit/libcsupport/src/assocremotebylocalbitfield.c
index 3e5c3c0766..4b4085c371 100644
--- a/cpukit/libcsupport/src/assocremotebylocalbitfield.c
+++ b/cpukit/libcsupport/src/assocremotebylocalbitfield.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup Associativity Routines
+ * @ingroup RTEMSImplAssociativity
  *
  * @brief RTEMS Assoc Routines
  */
diff --git a/cpukit/libcsupport/src/assocremotebyname.c b/cpukit/libcsupport/src/assocremotebyname.c
index 4b5079eacc..35ff7de4a8 100644
--- a/cpukit/libcsupport/src/assocremotebyname.c
+++ b/cpukit/libcsupport/src/assocremotebyname.c
@@ -5,7 +5,7 @@
  *
  *  @brief RTEMS Associate Remote by Name
  *
- *  @ingroup Associativity
+ *  @ingroup RTEMSImplAssociativity
  */
 
 /*
diff --git a/cpukit/libcsupport/src/cachealignedalloc.c b/cpukit/libcsupport/src/cachealignedalloc.c
index 24bbd51ee5..94a227cd5b 100644
--- a/cpukit/libcsupport/src/cachealignedalloc.c
+++ b/cpukit/libcsupport/src/cachealignedalloc.c
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup RTEMSImplClassicCache
  * @brief RTEMS Cache Aligned Malloc
  */
 
diff --git a/cpukit/libcsupport/src/cachecoherentalloc.c b/cpukit/libcsupport/src/cachecoherentalloc.c
index 0c774f73b1..e4364dffc7 100644
--- a/cpukit/libcsupport/src/cachecoherentalloc.c
+++ b/cpukit/libcsupport/src/cachecoherentalloc.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup ClassicCache
+ * @ingroup RTEMSImplClassicCache
  */
 
 /*
diff --git a/cpukit/libcsupport/src/chdir.c b/cpukit/libcsupport/src/chdir.c
index c255ba4268..4c10689fac 100644
--- a/cpukit/libcsupport/src/chdir.c
+++ b/cpukit/libcsupport/src/chdir.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup libio Internal Interface
+ * @ingroup libcsupport
  *
  * @brief POSIX 1003.1b - 5.2.1 - Change Current Working Directory
  */
diff --git a/cpukit/libcsupport/src/error.c b/cpukit/libcsupport/src/error.c
index 593248f82a..e79cf2b7eb 100644
--- a/cpukit/libcsupport/src/error.c
+++ b/cpukit/libcsupport/src/error.c
@@ -3,6 +3,8 @@
 /**
  *  @file
  *
+ * @ingroup ErrorPanicSupport
+ *
  *  @brief
  */
 
diff --git a/cpukit/libcsupport/src/flockfile.c b/cpukit/libcsupport/src/flockfile.c
index 66dcc279b4..4099f6bf3f 100644
--- a/cpukit/libcsupport/src/flockfile.c
+++ b/cpukit/libcsupport/src/flockfile.c
@@ -2,7 +2,7 @@
  *  @file
  *
  *  @brief Lock File for Stdio
- *  @ingroup SET
+ *  @ingroup libcsupport
  */
 /*
  * Copyright (c) 2009 by
diff --git a/cpukit/libcsupport/src/getchark.c b/cpukit/libcsupport/src/getchark.c
index 499b76069e..8a3c67ab94 100644
--- a/cpukit/libcsupport/src/getchark.c
+++ b/cpukit/libcsupport/src/getchark.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
+ * @ingroup RTEMSImplKernelCharIO
  *
  * @brief This source file contains the implementation of getchark().
  */
diff --git a/cpukit/libcsupport/src/getgid.c b/cpukit/libcsupport/src/getgid.c
index 6134108b68..d2aae48849 100644
--- a/cpukit/libcsupport/src/getgid.c
+++ b/cpukit/libcsupport/src/getgid.c
@@ -3,7 +3,7 @@
 /**
  *  @file
  *
- *  @ingroup
+ * @ingroup libcsupport
  *
  *  @brief
  */
diff --git a/cpukit/libcsupport/src/getppid.c b/cpukit/libcsupport/src/getppid.c
index 2ca7a8f900..301c83b053 100644
--- a/cpukit/libcsupport/src/getppid.c
+++ b/cpukit/libcsupport/src/getppid.c
@@ -3,7 +3,7 @@
 /**
  *  @file
  *
- *  @ingroup
+ * @ingroup libcsupport
  *
  *  @brief
  */
diff --git a/cpukit/libcsupport/src/lseek.c b/cpukit/libcsupport/src/lseek.c
index c8017d3cc3..afc7763b4a 100644
--- a/cpukit/libcsupport/src/lseek.c
+++ b/cpukit/libcsupport/src/lseek.c
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup LibIO
  * @brief lseek() - POSIX 1003.1b 6.5.3 - Reposition Read/Write File Offset
  */
 
diff --git a/cpukit/libcsupport/src/open_dev_console.c b/cpukit/libcsupport/src/open_dev_console.c
index 67b436ce1a..735ecc149f 100644
--- a/cpukit/libcsupport/src/open_dev_console.c
+++ b/cpukit/libcsupport/src/open_dev_console.c
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup LibIO
  * @brief open_dev_console - open /dev/console
  */
 
diff --git a/cpukit/libcsupport/src/printk.c b/cpukit/libcsupport/src/printk.c
index dfa1a508fd..2b25b14b2d 100644
--- a/cpukit/libcsupport/src/printk.c
+++ b/cpukit/libcsupport/src/printk.c
@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
+ * @ingroup RTEMSImplKernelCharIO
  *
  * @brief This source file contains the implementation of printk().
  */
diff --git a/cpukit/libcsupport/src/printk_plugin.c b/cpukit/libcsupport/src/printk_plugin.c
index 9c58a5ce7c..03ad0bb59f 100644
--- a/cpukit/libcsupport/src/printk_plugin.c
+++ b/cpukit/libcsupport/src/printk_plugin.c
@@ -3,8 +3,8 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
- * @ingroup RTEMSPrintSupport
+ * @ingroup RTEMSImplKernelCharIO
+ * @ingroup RTEMSImplPrintSupport
  *
  * @brief This source file contains the implementation of
  *   rtems_printk_printer() and rtems_print_printer_printk().
diff --git a/cpukit/libcsupport/src/putk.c b/cpukit/libcsupport/src/putk.c
index bf5adf91f9..7c10328b73 100644
--- a/cpukit/libcsupport/src/putk.c
+++ b/cpukit/libcsupport/src/putk.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
+ * @ingroup RTEMSImplKernelCharIO
  *
  * @brief This source file contains the implementation of putk().
  */
diff --git a/cpukit/libcsupport/src/rtems_put_char.c b/cpukit/libcsupport/src/rtems_put_char.c
index 171d9980b4..2a715ae9ac 100644
--- a/cpukit/libcsupport/src/rtems_put_char.c
+++ b/cpukit/libcsupport/src/rtems_put_char.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
+ * @ingroup RTEMSImplKernelCharIO
  *
  * @brief This source file contains the implementation of rtems_put_char().
  */
diff --git a/cpukit/libcsupport/src/rtems_putc.c b/cpukit/libcsupport/src/rtems_putc.c
index a9e84c0043..fbf814626a 100644
--- a/cpukit/libcsupport/src/rtems_putc.c
+++ b/cpukit/libcsupport/src/rtems_putc.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
+ * @ingroup RTEMSImplKernelCharIO
  *
  * @brief This source file contains the implementation of rtems_putc().
  */
diff --git a/cpukit/libcsupport/src/setgid.c b/cpukit/libcsupport/src/setgid.c
index 6d47648d17..705cc9b505 100644
--- a/cpukit/libcsupport/src/setgid.c
+++ b/cpukit/libcsupport/src/setgid.c
@@ -3,6 +3,8 @@
 /**
  *  @file
  *
+ * @ingroup libcsupport
+ *
  *  @brief POSIX sets user and group ids
  */
 
diff --git a/cpukit/libcsupport/src/sup_fs_deviceio.c b/cpukit/libcsupport/src/sup_fs_deviceio.c
index 7ba23ea410..8f45a01950 100644
--- a/cpukit/libcsupport/src/sup_fs_deviceio.c
+++ b/cpukit/libcsupport/src/sup_fs_deviceio.c
@@ -4,7 +4,7 @@
  *  @file
  *
  *  @brief RTEMS DeviceIO Support
- *  @ingroup Device
+ *  @ingroup IMFSDevices
  */
 
 /*
diff --git a/cpukit/libcsupport/src/tcflush.c b/cpukit/libcsupport/src/tcflush.c
index 2552c05c50..013399cee4 100644
--- a/cpukit/libcsupport/src/tcflush.c
+++ b/cpukit/libcsupport/src/tcflush.c
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup Termios
  * @brief tcflush() - POSIX 1003.1b 7.2.2 - Line Control Functions
  */
 
diff --git a/cpukit/libcsupport/src/termios.c b/cpukit/libcsupport/src/termios.c
index b03605f1b2..7c10bade25 100644
--- a/cpukit/libcsupport/src/termios.c
+++ b/cpukit/libcsupport/src/termios.c
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup Termios
  * TERMIOS serial line support
  */
 
diff --git a/cpukit/libcsupport/src/termios_posix_isig_handler.c b/cpukit/libcsupport/src/termios_posix_isig_handler.c
index 5f505fecb4..f9b8bd9bfd 100644
--- a/cpukit/libcsupport/src/termios_posix_isig_handler.c
+++ b/cpukit/libcsupport/src/termios_posix_isig_handler.c
@@ -1,5 +1,7 @@
 /**
  * @file
+ *
+ * @ingroup Termios
  * TERMIOS POSIX behavior on INTR and QUIT characters
  */
 
diff --git a/cpukit/libcsupport/src/utsname.c b/cpukit/libcsupport/src/utsname.c
index c1c2bc6be1..deebd4b578 100644
--- a/cpukit/libcsupport/src/utsname.c
+++ b/cpukit/libcsupport/src/utsname.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup utsname Service
+ * @ingroup libcsupport
  *
  * @brief Get System Name
  */
diff --git a/cpukit/libcsupport/src/vprintk.c b/cpukit/libcsupport/src/vprintk.c
index f4ac81c5fc..3db7d8c4de 100644
--- a/cpukit/libcsupport/src/vprintk.c
+++ b/cpukit/libcsupport/src/vprintk.c
@@ -3,7 +3,7 @@
 /**
  * @file
  *
- * @ingroup RTEMSAPIKernelCharIO
+ * @ingroup RTEMSImplKernelCharIO
  *
  * @brief This source file contains the implementation of vprintk().
  */
diff --git a/cpukit/libcsupport/src/writev.c b/cpukit/libcsupport/src/writev.c
index b78f041a9a..31342ed7ca 100644
--- a/cpukit/libcsupport/src/writev.c
+++ b/cpukit/libcsupport/src/writev.c
@@ -2,6 +2,8 @@
 
 /**
  * @file
+ *
+ * @ingroup LibIO
  * @brief writev() - POSIX 1003.1 - Write a Vector
  *
  * OpenGroup URL: