doxygen: Switch @brief and @ingroup

This order change fixes the Latex documentation build via Doxygen.

17 files changed, 34 insertions, 17 deletions

diff --git a/cpukit/libcsupport/src/_realloc_r.c b/cpukit/libcsupport/src/_realloc_r.c
index 57f0aaf834..95f9e054f5 100644
--- a/cpukit/libcsupport/src/_realloc_r.c
+++ b/cpukit/libcsupport/src/_realloc_r.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief  _realloc_r Implementation
  * @ingroup libcsupport
+ *
+ * @brief  _realloc_r Implementation
  */
 
 /*
diff --git a/cpukit/libcsupport/src/access.c b/cpukit/libcsupport/src/access.c
index cc3dee7ffa..57276305ac 100644
--- a/cpukit/libcsupport/src/access.c
+++ b/cpukit/libcsupport/src/access.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief access() - POSIX 1003.1b 5.6.3 - File Accessibility
  * @ingroup libcsupport
+ *
+ * @brief access() - POSIX 1003.1b 5.6.3 - File Accessibility
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assoclocalbyname.c b/cpukit/libcsupport/src/assoclocalbyname.c
index 2fba102abe..c0267f3f53 100644
--- a/cpukit/libcsupport/src/assoclocalbyname.c
+++ b/cpukit/libcsupport/src/assoclocalbyname.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief RTEMS Associate Local by Name
  * @ingroup Associativity Routines
+ *
+ * @brief RTEMS Associate Local by Name
  */
 
 /*
diff --git a/cpukit/libcsupport/src/assocremotebylocalbitfield.c b/cpukit/libcsupport/src/assocremotebylocalbitfield.c
index efcc87a3c4..4a9cc0b175 100644
--- a/cpukit/libcsupport/src/assocremotebylocalbitfield.c
+++ b/cpukit/libcsupport/src/assocremotebylocalbitfield.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief RTEMS Assoc Routines
  * @ingroup Associativity Routines
+ *
+ * @brief RTEMS Assoc Routines
  */
 
 /*
diff --git a/cpukit/libcsupport/src/chdir.c b/cpukit/libcsupport/src/chdir.c
index 55425345e8..6ef551f06d 100644
--- a/cpukit/libcsupport/src/chdir.c
+++ b/cpukit/libcsupport/src/chdir.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief POSIX 1003.1b - 5.2.1 - Change Current Working Directory
  * @ingroup libio Internal Interface
+ *
+ * @brief POSIX 1003.1b - 5.2.1 - Change Current Working Directory
  */
 
 /*
diff --git a/cpukit/libcsupport/src/chroot.c b/cpukit/libcsupport/src/chroot.c
index 3e7dfbae87..9db340174b 100644
--- a/cpukit/libcsupport/src/chroot.c
+++ b/cpukit/libcsupport/src/chroot.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief Change Root Directory
  * @ingroup libcsupport
+ *
+ * @brief Change Root Directory
  */
 
 /*
diff --git a/cpukit/libcsupport/src/close.c b/cpukit/libcsupport/src/close.c
index 21b375149d..5e6aa2c041 100644
--- a/cpukit/libcsupport/src/close.c
+++ b/cpukit/libcsupport/src/close.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief POSIX 1003.1b 6.3.1 - Close a File
  * @ingroup libcsupport
+ *
+ * @brief POSIX 1003.1b 6.3.1 - Close a File
  */
 
 /*
diff --git a/cpukit/libcsupport/src/dup.c b/cpukit/libcsupport/src/dup.c
index 98ee8fdf1e..8fe2514c7d 100644
--- a/cpukit/libcsupport/src/dup.c
+++ b/cpukit/libcsupport/src/dup.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief POSIX 1003.1b 6.2.1 Duplicate an Open File Descriptor
  * @ingroup libcsupport
+ *
+ * @brief POSIX 1003.1b 6.2.1 Duplicate an Open File Descriptor
  */
 
 /*
diff --git a/cpukit/libcsupport/src/fcntl.c b/cpukit/libcsupport/src/fcntl.c
index 111fd188d4..ba824dced1 100644
--- a/cpukit/libcsupport/src/fcntl.c
+++ b/cpukit/libcsupport/src/fcntl.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief POSIX 1003.1b 6.5.2 - File Control
  * @ingroup libcsupport
+ *
+ * @brief POSIX 1003.1b 6.5.2 - File Control
  */
 
 /*
diff --git a/cpukit/libcsupport/src/fdatasync.c b/cpukit/libcsupport/src/fdatasync.c
index 3b9a4ff9bf..a1ac7bc81e 100644
--- a/cpukit/libcsupport/src/fdatasync.c
+++ b/cpukit/libcsupport/src/fdatasync.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief POSIX 1003.1b 6.6.2 - Synchronize the Data of a File
  * @ingroup libcsupport
+ *
+ * @brief POSIX 1003.1b 6.6.2 - Synchronize the Data of a File
  */
 
 /*
diff --git a/cpukit/libcsupport/src/free.c b/cpukit/libcsupport/src/free.c
index e52516d854..f4542e0c72 100644
--- a/cpukit/libcsupport/src/free.c
+++ b/cpukit/libcsupport/src/free.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief calloc()
  * @ingroup libcsupport
+ *
+ * @brief calloc()
  */
 
 /*
diff --git a/cpukit/libcsupport/src/ioctl.c b/cpukit/libcsupport/src/ioctl.c
index e58889ae28..203a0aa5ba 100644
--- a/cpukit/libcsupport/src/ioctl.c
+++ b/cpukit/libcsupport/src/ioctl.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief ioctl() system call
  * @ingroup libcsupport
+ *
+ * @brief ioctl() system call
  */
 
 /*
diff --git a/cpukit/libcsupport/src/kill_noposix.c b/cpukit/libcsupport/src/kill_noposix.c
index a111f071d7..3792a81db8 100644
--- a/cpukit/libcsupport/src/kill_noposix.c
+++ b/cpukit/libcsupport/src/kill_noposix.c
@@ -1,9 +1,10 @@
 /**
  * @file
  *
- * @brief Kill No POSIX
  * @ingroup libcsupport
  *
+ * @brief Kill No POSIX
+ *
  *  Marginal implementations of some POSIX API routines
  *  to be used when POSIX is disabled.
  *
diff --git a/cpukit/libcsupport/src/setegid.c b/cpukit/libcsupport/src/setegid.c
index 2a3ef2f868..4303e73ebe 100644
--- a/cpukit/libcsupport/src/setegid.c
+++ b/cpukit/libcsupport/src/setegid.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief Get Real User, Effective User, Ral Group, and Effective Group IDs
  * @ingroup libcsupport
+ *
+ * @brief Get Real User, Effective User, Ral Group, and Effective Group IDs
  */
 
 /*
diff --git a/cpukit/libcsupport/src/sup_fs_mount_iterate.c b/cpukit/libcsupport/src/sup_fs_mount_iterate.c
index 4d986090df..281dfc73e5 100644
--- a/cpukit/libcsupport/src/sup_fs_mount_iterate.c
+++ b/cpukit/libcsupport/src/sup_fs_mount_iterate.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief Mount table entry visitor.
  * @ingroup Termios Termios
+ *
+ * @brief Mount table entry visitor.
  */
 
 /*
diff --git a/cpukit/libcsupport/src/utsname.c b/cpukit/libcsupport/src/utsname.c
index 22442c192a..c1ca216eb3 100644
--- a/cpukit/libcsupport/src/utsname.c
+++ b/cpukit/libcsupport/src/utsname.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief Get System Name
  * @ingroup utsname Service
+ *
+ * @brief Get System Name
  */
 
 /*
diff --git a/cpukit/libcsupport/src/write_r.c b/cpukit/libcsupport/src/write_r.c
index 0ecfda106e..6597337efb 100644
--- a/cpukit/libcsupport/src/write_r.c
+++ b/cpukit/libcsupport/src/write_r.c
@@ -1,8 +1,9 @@
 /**
  * @file
  *
- * @brief POSIX 1003.1b 6.4.2 - Write to a File
  * @ingroup libcsupport
+ *
+ * @brief POSIX 1003.1b 6.4.2 - Write to a File
  */
 
 /*