From 178635c1c2a4e5e0b276f5ce141eb9b634ddafb1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Frank=20K=C3=BChndel?= Date: Fri, 3 Dec 2021 23:17:49 +0100 Subject: Doxygen: Adding Doxygen groups to files --- bsps/shared/doxygen.h | 8 ++++++++ bsps/shared/rtems-version.c | 9 +++++++++ bsps/sparc/include/bsp/gnatcommon.h | 15 +++++++++++++++ bsps/sparc/include/bsp/gr_leon4_n2x.h | 9 +++++++++ bsps/sparc/include/drvmgr/leon2_amba_bus.h | 9 +++++++++ bsps/sparc/leon3/clock/ckinit.c | 9 +++++++++ bsps/sparc/leon3/console/printk_support.c | 9 +++++++++ bsps/sparc/leon3/start/bspstart.c | 9 +++++++++ bsps/sparc/leon3/start/cache.c | 9 +++++++++ bsps/sparc/leon3/start/cpucounter.c | 9 +++++++++ bsps/sparc/leon3/start/eirq.c | 9 +++++++++ bsps/sparc/shared/doxygen.h | 8 ++++++++ bsps/sparc/shared/irq/bsp_isr_handler.c | 9 +++++++++ cpukit/doxygen.h | 8 ++++++++ cpukit/doxygen/appl-config.h | 9 +++++++++ cpukit/doxygen/top-level-groups.h | 8 ++++++++ cpukit/include/machine/_kernel_cpuset.h | 2 ++ cpukit/include/machine/_kernel_param.h | 8 ++++++++ cpukit/include/machine/_kernel_time.h | 9 +++++++++ cpukit/include/machine/_kernel_types.h | 2 ++ cpukit/include/machine/_timecounter.h | 2 ++ cpukit/include/rtems/linkersets.h | 15 +++++++++++++++ cpukit/include/rtems/posix/posixapi.h | 2 ++ cpukit/include/rtems/posix/spinlockimpl.h | 8 ++++++++ cpukit/include/rtems/rtems/mainpage.h | 8 ++++++++ cpukit/include/rtems/scheduler.h | 2 ++ cpukit/include/rtems/sysinit.h | 9 +++++++++ cpukit/include/rtems/test-info.h | 9 +++++++++ cpukit/include/rtems/test.h | 9 +++++++++ cpukit/include/rtems/thread.h | 15 +++++++++++++++ cpukit/include/sha256.h | 15 +++++++++++++++ cpukit/include/sys/_ffcounter.h | 9 +++++++++ cpukit/include/sys/endian.h | 15 +++++++++++++++ cpukit/include/sys/priority.h | 9 +++++++++ cpukit/include/sys/statvfs.h | 8 ++++++++ cpukit/include/sys/timeffc.h | 9 +++++++++ cpukit/include/sys/timepps.h | 9 +++++++++ cpukit/include/sys/timetc.h | 9 +++++++++ cpukit/include/sys/timex.h | 15 +++++++++++++++ cpukit/libc/search/qsort.c | 9 +++++++++ cpukit/libc/string/flsl.c | 9 +++++++++ cpukit/libc/string/local.h | 9 +++++++++ cpukit/libc/string/memcmp.c | 9 +++++++++ cpukit/libc/string/memcpy.c | 9 +++++++++ cpukit/libc/string/memset.c | 9 +++++++++ cpukit/libc/string/strchr.c | 9 +++++++++ cpukit/libc/string/strcmp.c | 9 +++++++++ cpukit/libc/string/strlen.c | 9 +++++++++ cpukit/libc/string/strrchr.c | 9 +++++++++ cpukit/libcsupport/src/malloc_p.h | 9 +++++++++ cpukit/libmd/sha256c.c | 9 +++++++++ cpukit/libmisc/cpuuse/cpuuseimpl.h | 9 +++++++++ cpukit/libtest/t-test-checks.c | 9 +++++++++ cpukit/libtest/t-test-hash-sha256.c | 9 +++++++++ cpukit/libtest/t-test-rtems-context.c | 9 +++++++++ cpukit/libtest/t-test-rtems-measure.c | 9 +++++++++ cpukit/libtest/t-test-rtems-memory.c | 9 +++++++++ cpukit/libtest/t-test-rtems.c | 9 +++++++++ cpukit/libtest/t-test-time.c | 9 +++++++++ cpukit/libtest/t-test.c | 9 +++++++++ cpukit/libtest/testbeginend.c | 9 +++++++++ cpukit/sapi/src/cpucounterconverter.c | 9 +++++++++ cpukit/score/cpu/no_cpu/cpuidle.c | 9 +++++++++ cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h | 9 +++++++++ cpukit/score/cpu/sparc/include/rtems/asm.h | 2 ++ cpukit/score/cpu/sparc/include/rtems/score/cpuatomic.h | 10 ++++++++++ cpukit/score/cpu/sparc/include/rtems/score/sparcimpl.h | 9 +++++++++ cpukit/score/cpu/sparc/syscall.h | 15 +++++++++++++++ 68 files changed, 605 insertions(+) diff --git a/bsps/shared/doxygen.h b/bsps/shared/doxygen.h index d3679c2f3d..fa16512d45 100644 --- a/bsps/shared/doxygen.h +++ b/bsps/shared/doxygen.h @@ -1,3 +1,11 @@ +/** + * @file + * + * @ingroup RTEMSImplDoxygen + * + * @brief This header file defines Doxygen groups. + */ + /** * @defgroup RTEMSBSPs Board Support Packages * diff --git a/bsps/shared/rtems-version.c b/bsps/shared/rtems-version.c index b12504a1c9..258f420dec 100644 --- a/bsps/shared/rtems-version.c +++ b/bsps/shared/rtems-version.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSAPIClassicVersion + * + * @brief This header file provides interfaces of the + * RTEMS versions. + */ + /* * COPYRIGHT (c) 2003, Ralf Corsepius, Ulm, Germany. * COPYRIGHT (c) 2003, On-Line Applications Research Corporation (OAR). diff --git a/bsps/sparc/include/bsp/gnatcommon.h b/bsps/sparc/include/bsp/gnatcommon.h index 1a04449293..40e8829bb9 100644 --- a/bsps/sparc/include/bsp/gnatcommon.h +++ b/bsps/sparc/include/bsp/gnatcommon.h @@ -1,3 +1,18 @@ +/** + * @file + * + * @ingroup RTEMSImplGnat + * + * @brief This header file provides interfaces of the + * gnat/rtems interrupts and exception handling. + */ + +/** + * @defgroup RTEMSImplGnat GNAT/RTEMS interrupts and exception handling + * + * @ingroup RTEMSImpl + */ + #ifndef __GNATCOMMON_H #define __GNATCOMMON_H diff --git a/bsps/sparc/include/bsp/gr_leon4_n2x.h b/bsps/sparc/include/bsp/gr_leon4_n2x.h index 79ea53f953..2ac5dc8373 100644 --- a/bsps/sparc/include/bsp/gr_leon4_n2x.h +++ b/bsps/sparc/include/bsp/gr_leon4_n2x.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This header file provides interfaces of the + * GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver + */ + /* GR-CPCI-LEON4-N2X (NGFP) PCI Peripheral driver * * COPYRIGHT (c) 2013. diff --git a/bsps/sparc/include/drvmgr/leon2_amba_bus.h b/bsps/sparc/include/drvmgr/leon2_amba_bus.h index 93e05442af..8f4b7dbbec 100644 --- a/bsps/sparc/include/drvmgr/leon2_amba_bus.h +++ b/bsps/sparc/include/drvmgr/leon2_amba_bus.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON2 + * + * @brief This header file provides interfaces of the + * LEON2 Hardcoded bus driver interface. + */ + /* LEON2 Hardcoded bus driver interface. * * COPYRIGHT (c) 2008. diff --git a/bsps/sparc/leon3/clock/ckinit.c b/bsps/sparc/leon3/clock/ckinit.c index 3f1cfe4bee..fc0043a70f 100644 --- a/bsps/sparc/leon3/clock/ckinit.c +++ b/bsps/sparc/leon3/clock/ckinit.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * the Clock Tick Device Driver. + */ + /* * Clock Tick Device Driver * diff --git a/bsps/sparc/leon3/console/printk_support.c b/bsps/sparc/leon3/console/printk_support.c index 9e260d2eac..f221110fbf 100644 --- a/bsps/sparc/leon3/console/printk_support.c +++ b/bsps/sparc/leon3/console/printk_support.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * the TTY driver for the serial ports on the LEON. + */ + /* * This file contains the TTY driver for the serial ports on the LEON. * diff --git a/bsps/sparc/leon3/start/bspstart.c b/bsps/sparc/leon3/start/bspstart.c index 19de325e12..06c996bb53 100644 --- a/bsps/sparc/leon3/start/bspstart.c +++ b/bsps/sparc/leon3/start/bspstart.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * a set of routines which start the application. + */ + /* * This set of routines starts the application. It includes application, * board, and monitor specific initialization and configuration. diff --git a/bsps/sparc/leon3/start/cache.c b/bsps/sparc/leon3/start/cache.c index e507e66e7e..8b3b209d92 100644 --- a/bsps/sparc/leon3/start/cache.c +++ b/bsps/sparc/leon3/start/cache.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * LEON3 CPU cache support. + */ + /* * Copyright (c) 2014 embedded brains GmbH. All rights reserved. * diff --git a/bsps/sparc/leon3/start/cpucounter.c b/bsps/sparc/leon3/start/cpucounter.c index 605ee269f7..db5b65164e 100644 --- a/bsps/sparc/leon3/start/cpucounter.c +++ b/bsps/sparc/leon3/start/cpucounter.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * LEON3 CPU counter support. + */ + /* * Copyright (c) 2014, 2018 embedded brains GmbH. All rights reserved. * diff --git a/bsps/sparc/leon3/start/eirq.c b/bsps/sparc/leon3/start/eirq.c index 50bd6fb7c6..f6f3fb2bd5 100644 --- a/bsps/sparc/leon3/start/eirq.c +++ b/bsps/sparc/leon3/start/eirq.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * the GRLIB/LEON3 extended interrupt controller. + */ + /* * GRLIB/LEON3 extended interrupt controller * diff --git a/bsps/sparc/shared/doxygen.h b/bsps/sparc/shared/doxygen.h index 100a9b6c18..82e5feb023 100644 --- a/bsps/sparc/shared/doxygen.h +++ b/bsps/sparc/shared/doxygen.h @@ -1,3 +1,11 @@ +/** + * @file + * + * @ingroup RTEMSImplDoxygen + * + * @brief This header file defines Doxygen groups. + */ + /** * @defgroup RTEMSBSPsSPARC SPARC * diff --git a/bsps/sparc/shared/irq/bsp_isr_handler.c b/bsps/sparc/shared/irq/bsp_isr_handler.c index 22d168cdb6..87f0e35d59 100644 --- a/bsps/sparc/shared/irq/bsp_isr_handler.c +++ b/bsps/sparc/shared/irq/bsp_isr_handler.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This source file contains a definition of + * ::_SPARC_Interrupt_dispatch. + */ + /* * COPYRIGHT (c) 2015 * Cobham Gaisler diff --git a/cpukit/doxygen.h b/cpukit/doxygen.h index a60d138c03..30da23e378 100644 --- a/cpukit/doxygen.h +++ b/cpukit/doxygen.h @@ -1,3 +1,11 @@ +/** + * @file + * + * @ingroup RTEMSImplDoxygen + * + * @brief This header file defines Doxygen groups. + */ + /** * @defgroup RTEMSAPIIO IO * diff --git a/cpukit/doxygen/appl-config.h b/cpukit/doxygen/appl-config.h index 6e57405870..8cac6fe484 100644 --- a/cpukit/doxygen/appl-config.h +++ b/cpukit/doxygen/appl-config.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSApplConfig + * + * @brief This header file provides interfaces of the + * application configuration + */ + /* * Copyright (C) 2019, 2022 embedded brains GmbH (http://www.embedded-brains.de) * Copyright (C) 2010 Gedare Bloom diff --git a/cpukit/doxygen/top-level-groups.h b/cpukit/doxygen/top-level-groups.h index 8d38195f3e..e563e1a12e 100644 --- a/cpukit/doxygen/top-level-groups.h +++ b/cpukit/doxygen/top-level-groups.h @@ -1,5 +1,13 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSImplDoxygen + * + * @brief This header file defines top level Doxygen groups. + */ + /* * Copyright (C) 2019, 2020 embedded brains GmbH (http://www.embedded-brains.de) * diff --git a/cpukit/include/machine/_kernel_cpuset.h b/cpukit/include/machine/_kernel_cpuset.h index 19c1a3e504..93ead320e5 100644 --- a/cpukit/include/machine/_kernel_cpuset.h +++ b/cpukit/include/machine/_kernel_cpuset.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup RTEMSImplKernel + * * @brief This header file provides CPU set definitions for the kernel space * (_KERNEL is defined before including ). */ diff --git a/cpukit/include/machine/_kernel_param.h b/cpukit/include/machine/_kernel_param.h index 5b381ccca5..cd02644e91 100644 --- a/cpukit/include/machine/_kernel_param.h +++ b/cpukit/include/machine/_kernel_param.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup RTEMSImplKernel + * * @brief This header file provides parameter definitions for the kernel space * (_KERNEL is defined before including ). */ @@ -32,6 +34,12 @@ * POSSIBILITY OF SUCH DAMAGE. */ +/** + * @defgroup RTEMSImplKernel RTEMS Kernel Interface + * + * @ingroup RTEMSImpl + */ + #include #include #include diff --git a/cpukit/include/machine/_kernel_time.h b/cpukit/include/machine/_kernel_time.h index cfd223f0b6..8ea3297f8e 100644 --- a/cpukit/include/machine/_kernel_time.h +++ b/cpukit/include/machine/_kernel_time.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplKernel + * + * @brief This header file provides interfaces of the + * kernel functions. + */ + /*- * SPDX-License-Identifier: BSD-3-Clause * diff --git a/cpukit/include/machine/_kernel_types.h b/cpukit/include/machine/_kernel_types.h index 98f0366b64..26e27ccaed 100644 --- a/cpukit/include/machine/_kernel_types.h +++ b/cpukit/include/machine/_kernel_types.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup RTEMSImplKernel + * * @brief This header file provides type definitions for the kernel space * (_KERNEL is defined before including ). */ diff --git a/cpukit/include/machine/_timecounter.h b/cpukit/include/machine/_timecounter.h index fc3d78c5ad..28f84336da 100644 --- a/cpukit/include/machine/_timecounter.h +++ b/cpukit/include/machine/_timecounter.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup RTEMSScoreTimecounter + * * @brief This header file provides timecounter definitions for the kernel space * (_KERNEL is defined before including ) and RTEMS. */ diff --git a/cpukit/include/rtems/linkersets.h b/cpukit/include/rtems/linkersets.h index c4b3e2b7dc..f81876d399 100644 --- a/cpukit/include/rtems/linkersets.h +++ b/cpukit/include/rtems/linkersets.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSImplLinker + * + * @brief This header file provides interfaces of the + * linker set support. + */ + /* * Copyright (c) 2015, 2020 embedded brains GmbH. All rights reserved. * @@ -25,6 +34,12 @@ * POSSIBILITY OF SUCH DAMAGE. */ +/** + * @defgroup RTEMSImplLinker RTEMS linker control + * + * @ingroup RTEMSImpl + */ + #ifndef _RTEMS_LINKERSET_H #define _RTEMS_LINKERSET_H diff --git a/cpukit/include/rtems/posix/posixapi.h b/cpukit/include/rtems/posix/posixapi.h index 24c1dc51e0..bb966920dc 100644 --- a/cpukit/include/rtems/posix/posixapi.h +++ b/cpukit/include/rtems/posix/posixapi.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup POSIXAPI + * * @brief POSIX API Implementation * * This include file defines the top level interface to the POSIX API diff --git a/cpukit/include/rtems/posix/spinlockimpl.h b/cpukit/include/rtems/posix/spinlockimpl.h index a5e5bb1850..599ed88ca3 100644 --- a/cpukit/include/rtems/posix/spinlockimpl.h +++ b/cpukit/include/rtems/posix/spinlockimpl.h @@ -2,6 +2,8 @@ /** * @file + * + * @ingroup RTEMSPOSIXAPISpinlock * * @brief Inlined Routines from the POSIX Spinlock Manager * @@ -37,6 +39,12 @@ * POSSIBILITY OF SUCH DAMAGE. */ +/** + * @defgroup RTEMSPOSIXAPISpinlock POSIX Spinlock Manager + * + * @ingroup POSIXAPI + */ + #ifndef _RTEMS_POSIX_SPINLOCKIMPL_H #define _RTEMS_POSIX_SPINLOCKIMPL_H diff --git a/cpukit/include/rtems/rtems/mainpage.h b/cpukit/include/rtems/rtems/mainpage.h index 78d5c6cc60..66c903f7e8 100644 --- a/cpukit/include/rtems/rtems/mainpage.h +++ b/cpukit/include/rtems/rtems/mainpage.h @@ -3,10 +3,18 @@ /** * @file * + * @ingroup RTEMSImplDoxygen + * * @brief This file exists to provide a top level description of RTEMS for * Doxygen. */ +/** + * @defgroup RTEMSImplDoxygen Doxygen document generator support + * + * @ingroup RTEMSImpl + */ + /* * Copyright (C) 2021 embedded brains GmbH (http://www.embedded-brains.de) * diff --git a/cpukit/include/rtems/scheduler.h b/cpukit/include/rtems/scheduler.h index a8004cb5e4..80e5d39f66 100644 --- a/cpukit/include/rtems/scheduler.h +++ b/cpukit/include/rtems/scheduler.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup RTEMSApplConfigGeneralSchedulerConfiguration + * * @brief Scheduler Configuration API */ diff --git a/cpukit/include/rtems/sysinit.h b/cpukit/include/rtems/sysinit.h index ad483684e7..f8395c3745 100644 --- a/cpukit/include/rtems/sysinit.h +++ b/cpukit/include/rtems/sysinit.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSAPIClassicInit + * + * @brief This header file provides interfaces of the + * system initialization handler. + */ + /* * Copyright (c) 2015, 2020 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/include/rtems/test-info.h b/cpukit/include/rtems/test-info.h index 3b839533c2..3f818eca49 100644 --- a/cpukit/include/rtems/test-info.h +++ b/cpukit/include/rtems/test-info.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This header file provides interfaces of the + * RTEMS Test Framework. + */ + /* * Copyright (c) 2014, 2018 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/include/rtems/test.h b/cpukit/include/rtems/test.h index aa6b4f88b2..2e4bb1a8de 100644 --- a/cpukit/include/rtems/test.h +++ b/cpukit/include/rtems/test.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This header file provides interfaces of the + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/include/rtems/thread.h b/cpukit/include/rtems/thread.h index f77b572e34..164f4b388a 100644 --- a/cpukit/include/rtems/thread.h +++ b/cpukit/include/rtems/thread.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSImplThread + * + * @brief This header file provides interfaces of the + * Thread Handler. + */ + /* * Copyright (c) 2017 embedded brains GmbH. All rights reserved. * @@ -25,6 +34,12 @@ * POSSIBILITY OF SUCH DAMAGE. */ +/** + * @defgroup RTEMSImplThread Thread Handler + * + * @ingroup RTEMSImpl + */ + #ifndef _RTEMS_THREAD_H #define _RTEMS_THREAD_H diff --git a/cpukit/include/sha256.h b/cpukit/include/sha256.h index f612713f3d..a49644df59 100644 --- a/cpukit/include/sha256.h +++ b/cpukit/include/sha256.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSHA256 + * + * @brief This header file provides interfaces of the + * SHA256 Checksum Implementation. + */ + /*- * Copyright 2005 Colin Percival * All rights reserved. @@ -26,6 +35,12 @@ * $FreeBSD$ */ +/** + * @defgroup RTEMSImplSHA256 SHA256 Checksum Implementation + * + * @ingroup RTEMSImpl + */ + #ifndef _SHA256_H_ #define _SHA256_H_ diff --git a/cpukit/include/sys/_ffcounter.h b/cpukit/include/sys/_ffcounter.h index d83c48cd44..c9cb9f6cda 100644 --- a/cpukit/include/sys/_ffcounter.h +++ b/cpukit/include/sys/_ffcounter.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSysTimer + * + * @brief This header file provides interfaces of the + * feed-forward clock counter. + */ + /*- * Copyright (c) 2011 The University of Melbourne * All rights reserved. diff --git a/cpukit/include/sys/endian.h b/cpukit/include/sys/endian.h index 0849a6a90b..d0037f2984 100644 --- a/cpukit/include/sys/endian.h +++ b/cpukit/include/sys/endian.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSysEndian + * + * @brief This header file provides interfaces of the + * system endianness. + */ + /*- * Copyright (c) 2002 Thomas Moestl * All rights reserved. @@ -26,6 +35,12 @@ * $FreeBSD: head/sys/sys/endian.h 208331 2010-05-20 06:16:13Z phk $ */ +/** + * @defgroup RTEMSImplSysEndian System Endianness Support + * + * @ingroup RTEMSImpl + */ + #ifndef _SYS_ENDIAN_H_ #define _SYS_ENDIAN_H_ diff --git a/cpukit/include/sys/priority.h b/cpukit/include/sys/priority.h index 855edb63c2..1ca2e35d7b 100644 --- a/cpukit/include/sys/priority.h +++ b/cpukit/include/sys/priority.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplKernel + * + * @brief This header file provides interfaces of the + * Process priority specifications. + */ + /*- * SPDX-License-Identifier: BSD-4-Clause * diff --git a/cpukit/include/sys/statvfs.h b/cpukit/include/sys/statvfs.h index 52d8e9d3fa..062d66ce02 100644 --- a/cpukit/include/sys/statvfs.h +++ b/cpukit/include/sys/statvfs.h @@ -3,6 +3,8 @@ /** * @file * + * @ingroup RTEMSAPIStatvfs + * * @brief Interface to the statvfs() Set of API Methods * * This include file defines the interface to the statvfs() set of @@ -39,6 +41,12 @@ /* */ +/** + * @defgroup RTEMSAPIStatvfs statvfs API Methods + * + * @ingroup RTEMSAPI + */ + #ifndef _SYS_STATVFS_H_ #define _SYS_STATVFS_H_ diff --git a/cpukit/include/sys/timeffc.h b/cpukit/include/sys/timeffc.h index c04de97f1d..ac66791012 100644 --- a/cpukit/include/sys/timeffc.h +++ b/cpukit/include/sys/timeffc.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSysTimer + * + * @brief This header file provides interfaces of the + * feed-forward clock counter. + */ + /*- * Copyright (c) 2011 The University of Melbourne * All rights reserved. diff --git a/cpukit/include/sys/timepps.h b/cpukit/include/sys/timepps.h index 030c734477..96b695d907 100644 --- a/cpukit/include/sys/timepps.h +++ b/cpukit/include/sys/timepps.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSysTimer + * + * @brief This header file provides interfaces of the + * Pulse Per Second timing. + */ + /*- * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): diff --git a/cpukit/include/sys/timetc.h b/cpukit/include/sys/timetc.h index 1ef58b378d..551fc998e5 100644 --- a/cpukit/include/sys/timetc.h +++ b/cpukit/include/sys/timetc.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSysTimer + * + * @brief This header file provides interfaces of the + * binary timecounter. + */ + /*- * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): diff --git a/cpukit/include/sys/timex.h b/cpukit/include/sys/timex.h index 8e763bb30f..049b29c998 100644 --- a/cpukit/include/sys/timex.h +++ b/cpukit/include/sys/timex.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSysTimer + * + * @brief This header file provides interfaces of the + * Network Time Protocol (NTP) + */ + /*- *********************************************************************** * * @@ -32,6 +41,12 @@ * */ +/** + * @defgroup RTEMSImplSysTimer System Timer Support + * + * @ingroup RTEMSImpl + */ + #ifndef _SYS_TIMEX_H_ #define _SYS_TIMEX_H_ 1 diff --git a/cpukit/libc/search/qsort.c b/cpukit/libc/search/qsort.c index b53400aa8e..6d93f6fb38 100644 --- a/cpukit/libc/search/qsort.c +++ b/cpukit/libc/search/qsort.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---sort an array diff --git a/cpukit/libc/string/flsl.c b/cpukit/libc/string/flsl.c index af6277d1a4..c4080daf94 100644 --- a/cpukit/libc/string/flsl.c +++ b/cpukit/libc/string/flsl.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /*- * Copyright (c) 2017 embedded brains GmbH * All rights reserved. diff --git a/cpukit/libc/string/local.h b/cpukit/libc/string/local.h index ef7ba3918f..d160c8018b 100644 --- a/cpukit/libc/string/local.h +++ b/cpukit/libc/string/local.h @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This header file provides interfaces of the + * C lib. + */ + #include <_ansi.h> #ifndef __rtems__ #include <../ctype/local.h> diff --git a/cpukit/libc/string/memcmp.c b/cpukit/libc/string/memcmp.c index 342fb9fbc8..4169d0fbf1 100644 --- a/cpukit/libc/string/memcmp.c +++ b/cpukit/libc/string/memcmp.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---compare two memory areas diff --git a/cpukit/libc/string/memcpy.c b/cpukit/libc/string/memcpy.c index 52f716b927..8efb4ba14b 100644 --- a/cpukit/libc/string/memcpy.c +++ b/cpukit/libc/string/memcpy.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---copy memory regions diff --git a/cpukit/libc/string/memset.c b/cpukit/libc/string/memset.c index a5ea43ea86..f75c527f65 100644 --- a/cpukit/libc/string/memset.c +++ b/cpukit/libc/string/memset.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---set an area of memory diff --git a/cpukit/libc/string/strchr.c b/cpukit/libc/string/strchr.c index 96f30be044..1ad6787055 100644 --- a/cpukit/libc/string/strchr.c +++ b/cpukit/libc/string/strchr.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---search for character in string diff --git a/cpukit/libc/string/strcmp.c b/cpukit/libc/string/strcmp.c index 894424a690..07930bdd88 100644 --- a/cpukit/libc/string/strcmp.c +++ b/cpukit/libc/string/strcmp.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---character string compare diff --git a/cpukit/libc/string/strlen.c b/cpukit/libc/string/strlen.c index acffa49e14..2b50b8e113 100644 --- a/cpukit/libc/string/strlen.c +++ b/cpukit/libc/string/strlen.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---character string length diff --git a/cpukit/libc/string/strrchr.c b/cpukit/libc/string/strrchr.c index 04897e162a..69f7ade6c2 100644 --- a/cpukit/libc/string/strrchr.c +++ b/cpukit/libc/string/strrchr.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This source file contains a definition of + * C lib functions. + */ + /* FUNCTION <>---reverse search for character in string diff --git a/cpukit/libcsupport/src/malloc_p.h b/cpukit/libcsupport/src/malloc_p.h index 054afd99b2..00be02ce08 100644 --- a/cpukit/libcsupport/src/malloc_p.h +++ b/cpukit/libcsupport/src/malloc_p.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup libcsupport + * + * @brief This header file provides interfaces of the + * C lib. + */ + /* * RTEMS Malloc Family Internal Header * diff --git a/cpukit/libmd/sha256c.c b/cpukit/libmd/sha256c.c index 8d8a2a467a..26f3e53b90 100644 --- a/cpukit/libmd/sha256c.c +++ b/cpukit/libmd/sha256c.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSImplSHA256 + * + * @brief This source file contains a definition of + * the SHA256 Checksum Implementation. + */ + /*- * Copyright 2005 Colin Percival * All rights reserved. diff --git a/cpukit/libmisc/cpuuse/cpuuseimpl.h b/cpukit/libmisc/cpuuse/cpuuseimpl.h index 1162d1e892..b440bcfc88 100644 --- a/cpukit/libmisc/cpuuse/cpuuseimpl.h +++ b/cpukit/libmisc/cpuuse/cpuuseimpl.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup libmisc_cpuuse + * + * @brief This header file provides interfaces of the + * CPU use accounting. + */ + /* * COPYRIGHT (c) 1989-2011. * On-Line Applications Research Corporation (OAR). diff --git a/cpukit/libtest/t-test-checks.c b/cpukit/libtest/t-test-checks.c index 1a278b55ec..3b2de75ed6 100644 --- a/cpukit/libtest/t-test-checks.c +++ b/cpukit/libtest/t-test-checks.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/t-test-hash-sha256.c b/cpukit/libtest/t-test-hash-sha256.c index a023d3969c..2457d2ab5c 100644 --- a/cpukit/libtest/t-test-hash-sha256.c +++ b/cpukit/libtest/t-test-hash-sha256.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/t-test-rtems-context.c b/cpukit/libtest/t-test-rtems-context.c index cadafcdf94..a16ffd888c 100644 --- a/cpukit/libtest/t-test-rtems-context.c +++ b/cpukit/libtest/t-test-rtems-context.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/t-test-rtems-measure.c b/cpukit/libtest/t-test-rtems-measure.c index e21b092a81..2b9da8be86 100644 --- a/cpukit/libtest/t-test-rtems-measure.c +++ b/cpukit/libtest/t-test-rtems-measure.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/t-test-rtems-memory.c b/cpukit/libtest/t-test-rtems-memory.c index 92d21a7ccd..1dc90f2cd2 100644 --- a/cpukit/libtest/t-test-rtems-memory.c +++ b/cpukit/libtest/t-test-rtems-memory.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * Copyright (C) 2020 embedded brains GmbH * diff --git a/cpukit/libtest/t-test-rtems.c b/cpukit/libtest/t-test-rtems.c index 71d8057aaf..aa806044a4 100644 --- a/cpukit/libtest/t-test-rtems.c +++ b/cpukit/libtest/t-test-rtems.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/t-test-time.c b/cpukit/libtest/t-test-time.c index c6a43acfc5..8e31658cd7 100644 --- a/cpukit/libtest/t-test-time.c +++ b/cpukit/libtest/t-test-time.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/t-test.c b/cpukit/libtest/t-test.c index 12d020446a..1bdf079ba0 100644 --- a/cpukit/libtest/t-test.c +++ b/cpukit/libtest/t-test.c @@ -1,3 +1,12 @@ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * SPDX-License-Identifier: BSD-2-Clause * diff --git a/cpukit/libtest/testbeginend.c b/cpukit/libtest/testbeginend.c index f96fdaf6c4..90f370da43 100644 --- a/cpukit/libtest/testbeginend.c +++ b/cpukit/libtest/testbeginend.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSTestFramework + * + * @brief This source file contains a definition of + * RTEMS Test Framework. + */ + /* * Copyright (c) 2014, 2018 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/sapi/src/cpucounterconverter.c b/cpukit/sapi/src/cpucounterconverter.c index 01499904f9..f83b57b433 100644 --- a/cpukit/sapi/src/cpucounterconverter.c +++ b/cpukit/sapi/src/cpucounterconverter.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSAPICounter + * + * @brief This source file contains a definition of + * the Free-Running Counter and Busy Wait Delay API. + */ + /* * Copyright (c) 2014, 2018 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/score/cpu/no_cpu/cpuidle.c b/cpukit/score/cpu/no_cpu/cpuidle.c index 85ca01b7ca..34636690e1 100644 --- a/cpukit/score/cpu/no_cpu/cpuidle.c +++ b/cpukit/score/cpu/no_cpu/cpuidle.c @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSScoreCPU + * + * @brief This source file contains a definition of + * the ::_CPU_Thread_Idle_body. + */ + /* * Copyright (c) 2013-2014 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h b/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h index bb43234128..c0b2e5f888 100644 --- a/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h +++ b/cpukit/score/cpu/sparc/include/libcpu/grlib-tn-0018.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARCLEON3 + * + * @brief This header file provides interfaces of the + * LEON3 TN0018 fix. + */ + /* * Copyright (C) 2020 Cobham Gaisler AB * diff --git a/cpukit/score/cpu/sparc/include/rtems/asm.h b/cpukit/score/cpu/sparc/include/rtems/asm.h index de65f35d2c..1b4e949842 100644 --- a/cpukit/score/cpu/sparc/include/rtems/asm.h +++ b/cpukit/score/cpu/sparc/include/rtems/asm.h @@ -1,6 +1,8 @@ /** * @file * + * @ingroup RTEMSScoreCPUSPARCASM + * * @brief Address the Problems Caused by Incompatible Flavor of * Assemblers and Toolsets * diff --git a/cpukit/score/cpu/sparc/include/rtems/score/cpuatomic.h b/cpukit/score/cpu/sparc/include/rtems/score/cpuatomic.h index 01bb99cda3..c8d4b4c4e7 100644 --- a/cpukit/score/cpu/sparc/include/rtems/score/cpuatomic.h +++ b/cpukit/score/cpu/sparc/include/rtems/score/cpuatomic.h @@ -1,5 +1,15 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSScoreAtomicCPU + * + * @brief This header file provides interfaces of the + * atomic operations implementation using + * functions provided by the C11/C++11. + */ + /* * COPYRIGHT (c) 2012-2013 Deng Hengyi. * diff --git a/cpukit/score/cpu/sparc/include/rtems/score/sparcimpl.h b/cpukit/score/cpu/sparc/include/rtems/score/sparcimpl.h index a62f0a488f..070e39718e 100644 --- a/cpukit/score/cpu/sparc/include/rtems/score/sparcimpl.h +++ b/cpukit/score/cpu/sparc/include/rtems/score/sparcimpl.h @@ -1,5 +1,14 @@ /* SPDX-License-Identifier: BSD-2-Clause */ +/** + * @file + * + * @ingroup RTEMSBSPsSPARC + * + * @brief This header file provides interfaces of the + * _SPARC_Counter and _SPARC_Counter_mutable global variables. + */ + /* * Copyright (c) 2016, 2018 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/score/cpu/sparc/syscall.h b/cpukit/score/cpu/sparc/syscall.h index 2f20886840..e7bc95efe3 100644 --- a/cpukit/score/cpu/sparc/syscall.h +++ b/cpukit/score/cpu/sparc/syscall.h @@ -1 +1,16 @@ +/** + * @file + * + * @ingroup RTEMSImplSysCall + * + * @brief This header file provides interfaces of the + * SYS_exit SysCall. + */ + +/** + * @defgroup RTEMSImplSysCall SysCall Definition for Assembler Interface + * + * @ingroup RTEMSImpl + */ + #define SYS_exit 1 -- cgit v1.2.3