From a1f6d5aa9b27a1c36269e78de15c14b932fef066 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/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/irq/bsp_isr_handler.c | 9 +++++++++ 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 | 6 ++++++ 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/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/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/syscall.h | 15 +++++++++++++++ 52 files changed, 485 insertions(+) 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 60ef5d3ab6..1835e4963e 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 dec92320e1..fd5a698694 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 5049b7f81c..d605679d33 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 & Co. KG * diff --git a/bsps/sparc/leon3/start/cpucounter.c b/bsps/sparc/leon3/start/cpucounter.c index 6af91f75e5..3931edeacf 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 & Co. KG * diff --git a/bsps/sparc/leon3/start/eirq.c b/bsps/sparc/leon3/start/eirq.c index 05e6789f69..fa2ae39a44 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/irq/bsp_isr_handler.c b/bsps/sparc/shared/irq/bsp_isr_handler.c index 54e82b15a4..8e27e17bd8 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/include/machine/_timecounter.h b/cpukit/include/machine/_timecounter.h index 127e5f6fd3..e20e051f84 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 ef1b0d38d4..36398d0804 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 & Co. KG * @@ -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 855e57cc14..670c15a4c7 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 d284429d20..02ee514b40 100644 --- a/cpukit/include/rtems/rtems/mainpage.h +++ b/cpukit/include/rtems/rtems/mainpage.h @@ -9,6 +9,12 @@ * Doxygen. */ +/** + * @defgroup RTEMSImplDoxygen Doxygen document generator support + * + * @ingroup RTEMSImpl + */ + /* * Copyright (C) 2021 embedded brains GmbH & Co. KG * diff --git a/cpukit/include/rtems/sysinit.h b/cpukit/include/rtems/sysinit.h index b973ecfc91..1099f3c972 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 & Co. KG * diff --git a/cpukit/include/rtems/test-info.h b/cpukit/include/rtems/test-info.h index 055ed4f25b..c1b41ccc6e 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 & Co. KG * diff --git a/cpukit/include/rtems/test.h b/cpukit/include/rtems/test.h index 79313343a0..85cf7f49f1 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 739744b4e0..6d0445a6f8 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 & Co. KG * @@ -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/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/libtest/t-test-checks.c b/cpukit/libtest/t-test-checks.c index 40479a8277..e9c3d2cfb5 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 a9aa4df023..93b13d68f4 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 351a29a1ca..6373f32f96 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 c165fc8f2a..09eb833fa6 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 1d41192f56..3a8f8ccdab 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 & Co. KG * diff --git a/cpukit/libtest/t-test-rtems.c b/cpukit/libtest/t-test-rtems.c index 97864c1c76..a8d8ce1060 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 3f953626a5..8d513c5b44 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 4f3bf56142..dd61377b6a 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 91ad6a376b..b69a3da121 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 & Co. KG * diff --git a/cpukit/sapi/src/cpucounterconverter.c b/cpukit/sapi/src/cpucounterconverter.c index 4cabdc5e4a..4be591a119 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 & Co. KG * diff --git a/cpukit/score/cpu/no_cpu/cpuidle.c b/cpukit/score/cpu/no_cpu/cpuidle.c index bff1309d39..25f92b59b9 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 & Co. KG * 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/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