From b7185613e8a572fd35b0bed21a8e0f1fdecfc668 Mon Sep 17 00:00:00 2001 From: Alex Ivanov Date: Fri, 7 Dec 2012 09:57:04 -0500 Subject: score misc: Clean up Doxygen GCI Task #12 http://www.google-melange.com/gci/task/view/google/gci2012/7983217 --- cpukit/score/cpu/arm/armv7m-context-initialize.c | 6 +++ cpukit/score/cpu/arm/armv7m-context-restore.c | 6 +++ .../score/cpu/arm/armv7m-exception-handler-get.c | 6 +++ .../score/cpu/arm/armv7m-exception-handler-set.c | 6 +++ .../score/cpu/arm/armv7m-exception-priority-get.c | 5 +++ .../score/cpu/arm/armv7m-exception-priority-set.c | 6 +++ cpukit/score/cpu/arm/armv7m-isr-enter-leave.c | 6 +++ cpukit/score/cpu/arm/armv7m-isr-level-get.c | 6 +++ cpukit/score/cpu/arm/armv7m-isr-level-set.c | 6 +++ cpukit/score/cpu/arm/armv7m-isr-vector-install.c | 6 +++ cpukit/score/cpu/arm/armv7m-thread-idle.c | 6 +++ cpukit/score/cpu/avr/cpu.c | 46 +++------------------ cpukit/score/cpu/i386/cpu.c | 19 +++------ cpukit/score/cpu/i386/sse_test.c | 6 +++ cpukit/score/cpu/m32c/context_init.c | 7 ++++ cpukit/score/cpu/m68k/cpu.c | 35 +++------------- cpukit/score/cpu/no_cpu/cpu.c | 47 +++------------------- cpukit/score/cpu/no_cpu/cpu_asm.c | 6 +++ cpukit/score/cpu/powerpc/cpu.c | 6 +++ cpukit/score/cpu/powerpc/ppc-isr-vector-install.c | 6 +++ 20 files changed, 120 insertions(+), 123 deletions(-) (limited to 'cpukit/score/cpu') diff --git a/cpukit/score/cpu/arm/armv7m-context-initialize.c b/cpukit/score/cpu/arm/armv7m-context-initialize.c index 451c6b5b55..640adae03d 100644 --- a/cpukit/score/cpu/arm/armv7m-context-initialize.c +++ b/cpukit/score/cpu/arm/armv7m-context-initialize.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief CPU Initialize Context + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-context-restore.c b/cpukit/score/cpu/arm/armv7m-context-restore.c index effa3e704e..477904953b 100644 --- a/cpukit/score/cpu/arm/armv7m-context-restore.c +++ b/cpukit/score/cpu/arm/armv7m-context-restore.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief CPU Restore Context + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-exception-handler-get.c b/cpukit/score/cpu/arm/armv7m-exception-handler-get.c index f6aa663436..cf25cafe77 100644 --- a/cpukit/score/cpu/arm/armv7m-exception-handler-get.c +++ b/cpukit/score/cpu/arm/armv7m-exception-handler-get.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief ARMV7M Get Exception Handler + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-exception-handler-set.c b/cpukit/score/cpu/arm/armv7m-exception-handler-set.c index 1f2564faf0..ea3fce3ca5 100644 --- a/cpukit/score/cpu/arm/armv7m-exception-handler-set.c +++ b/cpukit/score/cpu/arm/armv7m-exception-handler-set.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief ARMV7M Set Exception Handler + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-exception-priority-get.c b/cpukit/score/cpu/arm/armv7m-exception-priority-get.c index 446b5c145c..79224e184f 100644 --- a/cpukit/score/cpu/arm/armv7m-exception-priority-get.c +++ b/cpukit/score/cpu/arm/armv7m-exception-priority-get.c @@ -1,3 +1,8 @@ +/** + * @file + * + * @brief ARMV7M Get Exception Priority + */ /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-exception-priority-set.c b/cpukit/score/cpu/arm/armv7m-exception-priority-set.c index f9d2098df9..085ce2dd96 100644 --- a/cpukit/score/cpu/arm/armv7m-exception-priority-set.c +++ b/cpukit/score/cpu/arm/armv7m-exception-priority-set.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief ARMV7M Set Exception Priority + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-isr-enter-leave.c b/cpukit/score/cpu/arm/armv7m-isr-enter-leave.c index cd5844b255..1bce10ae77 100644 --- a/cpukit/score/cpu/arm/armv7m-isr-enter-leave.c +++ b/cpukit/score/cpu/arm/armv7m-isr-enter-leave.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief ARMV7M Interrupt Service Enter and Leave + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-isr-level-get.c b/cpukit/score/cpu/arm/armv7m-isr-level-get.c index 79a03ee0d2..887e30843d 100644 --- a/cpukit/score/cpu/arm/armv7m-isr-level-get.c +++ b/cpukit/score/cpu/arm/armv7m-isr-level-get.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief CPU Get ISR Level + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-isr-level-set.c b/cpukit/score/cpu/arm/armv7m-isr-level-set.c index 981ac063f4..2f4c36312e 100644 --- a/cpukit/score/cpu/arm/armv7m-isr-level-set.c +++ b/cpukit/score/cpu/arm/armv7m-isr-level-set.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief CPU Set ISR Level + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-isr-vector-install.c b/cpukit/score/cpu/arm/armv7m-isr-vector-install.c index c2f52943cb..82b8e02e2b 100644 --- a/cpukit/score/cpu/arm/armv7m-isr-vector-install.c +++ b/cpukit/score/cpu/arm/armv7m-isr-vector-install.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief CPU ISR Vector Install + */ + /* * Copyright (c) 2011 Sebastian Huber. All rights reserved. * diff --git a/cpukit/score/cpu/arm/armv7m-thread-idle.c b/cpukit/score/cpu/arm/armv7m-thread-idle.c index cc9a05c94d..52a3dbd179 100644 --- a/cpukit/score/cpu/arm/armv7m-thread-idle.c +++ b/cpukit/score/cpu/arm/armv7m-thread-idle.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief CPU Thread Idle Body + */ + /* * Copyright (c) 2012 embedded brains GmbH. All rights reserved. * diff --git a/cpukit/score/cpu/avr/cpu.c b/cpukit/score/cpu/avr/cpu.c index a3153fc72e..75084821dc 100644 --- a/cpukit/score/cpu/avr/cpu.c +++ b/cpukit/score/cpu/avr/cpu.c @@ -1,7 +1,10 @@ -/* - * AVR CPU Dependent Source - * +/** + * @file * + * @brief AVR CPU Dependent Source + */ + +/* * COPYRIGHT (c) 1989-2008. * On-Line Applications Research Corporation (OAR). * @@ -20,16 +23,6 @@ #include /* XXX remove me later */ -/* _CPU_Initialize - * - * This routine performs processor dependent initialization. - * - * INPUT PARAMETERS: NONE - * - * NO_CPU Specific Information: - * - * XXX document implementation including references if appropriate - */ void _CPU_Initialize(void) { @@ -43,14 +36,6 @@ void _CPU_Initialize(void) /* FP context initialization support goes here */ } -/* - * _CPU_ISR_Get_level - * - * NO_CPU Specific Information: - * - * XXX document implementation including references if appropriate - */ - uint32_t _CPU_ISR_Get_level( void ) { /* @@ -81,25 +66,6 @@ void _CPU_ISR_install_raw_handler( */ } -/* - * _CPU_ISR_install_vector - * - * This kernel routine installs the RTEMS handler for the - * specified vector. - * - * Input parameters: - * vector - interrupt vector number - * old_handler - former ISR for this vector number - * new_handler - replacement ISR for this vector number - * - * Output parameters: NONE - * - * - * NO_CPU Specific Information: - * - * XXX document implementation including references if appropriate - */ - void _CPU_ISR_install_vector( uint32_t vector, proc_ptr new_handler, diff --git a/cpukit/score/cpu/i386/cpu.c b/cpukit/score/cpu/i386/cpu.c index 15ff3c7619..c87a76dc0b 100644 --- a/cpukit/score/cpu/i386/cpu.c +++ b/cpukit/score/cpu/i386/cpu.c @@ -1,6 +1,10 @@ -/* - * Intel i386 Dependent Source +/** + * @file * + * @brief Intel i386 Dependent Source + */ + +/* * COPYRIGHT (c) 1989-1999. * On-Line Applications Research Corporation (OAR). * @@ -22,13 +26,6 @@ #include #include -/* _CPU_Initialize - * - * This routine performs processor dependent initialization. - * - * INPUT PARAMETERS: NONE - */ - void _CPU_Initialize(void) { #if CPU_HARDWARE_FP @@ -91,10 +88,6 @@ void _CPU_Initialize(void) #endif } -/* - * _CPU_ISR_Get_level - */ - uint32_t _CPU_ISR_Get_level( void ) { uint32_t level; diff --git a/cpukit/score/cpu/i386/sse_test.c b/cpukit/score/cpu/i386/sse_test.c index 1c8d852da0..416a07f01a 100644 --- a/cpukit/score/cpu/i386/sse_test.c +++ b/cpukit/score/cpu/i386/sse_test.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief Test FPU/SSE Context Save and Restore + */ + /* * Authorship * ---------- diff --git a/cpukit/score/cpu/m32c/context_init.c b/cpukit/score/cpu/m32c/context_init.c index 713f8fa161..d7c1c5dd92 100644 --- a/cpukit/score/cpu/m32c/context_init.c +++ b/cpukit/score/cpu/m32c/context_init.c @@ -1,3 +1,10 @@ +/** + * @file + * + * @brief Initialize Context Area + * @ingroup ScoreContext + */ + /* * COPYRIGHT (c) 1989-2008. * On-Line Applications Research Corporation (OAR). diff --git a/cpukit/score/cpu/m68k/cpu.c b/cpukit/score/cpu/m68k/cpu.c index 23051c28a6..3776345769 100644 --- a/cpukit/score/cpu/m68k/cpu.c +++ b/cpukit/score/cpu/m68k/cpu.c @@ -1,6 +1,10 @@ -/* - * Motorola MC68xxx Dependent Source +/** + * @file * + * @brief Motorola MC68xxx Dependent Source + */ + +/* * COPYRIGHT (c) 1989-1999. * On-Line Applications Research Corporation (OAR). * @@ -20,15 +24,6 @@ uint32_t _CPU_cacr_shadow; #endif -/* _CPU_Initialize - * - * This routine performs processor dependent initialization. - * - * INPUT PARAMETERS: NONE - * - * OUTPUT PARAMETERS: NONE - */ - void _CPU_Initialize(void) { #if ( M68K_HAS_VBR == 0 ) @@ -47,10 +42,6 @@ void _CPU_Initialize(void) #endif /* M68K_HAS_VBR */ } -/* - * _CPU_ISR_Get_level - */ - uint32_t _CPU_ISR_Get_level( void ) { uint32_t level; @@ -111,20 +102,6 @@ void _CPU_ISR_install_raw_handler( #endif /* M68K_HAS_VBR */ } -/* - * _CPU_ISR_install_vector - * - * This kernel routine installs the RTEMS handler for the - * specified vector. - * - * Input parameters: - * vector - interrupt vector number - * new_handler - replacement ISR for this vector number - * old_handler - former ISR for this vector number - * - * Output parameters: NONE - */ - void _CPU_ISR_install_vector( uint32_t vector, proc_ptr new_handler, diff --git a/cpukit/score/cpu/no_cpu/cpu.c b/cpukit/score/cpu/no_cpu/cpu.c index 89162bb411..287e5d6e18 100644 --- a/cpukit/score/cpu/no_cpu/cpu.c +++ b/cpukit/score/cpu/no_cpu/cpu.c @@ -1,7 +1,10 @@ -/* - * XXX CPU Dependent Source - * +/** + * @file * + * @brief No CPU Dependent Source + */ + +/* * COPYRIGHT (c) 1989-1999. * On-Line Applications Research Corporation (OAR). * @@ -18,17 +21,6 @@ #include #include -/* _CPU_Initialize - * - * This routine performs processor dependent initialization. - * - * INPUT PARAMETERS: NONE - * - * NO_CPU Specific Information: - * - * XXX document implementation including references if appropriate - */ - void _CPU_Initialize(void) { /* @@ -41,14 +33,6 @@ void _CPU_Initialize(void) /* FP context initialization support goes here */ } -/* - * _CPU_ISR_Get_level - * - * NO_CPU Specific Information: - * - * XXX document implementation including references if appropriate - */ - uint32_t _CPU_ISR_Get_level( void ) { /* @@ -78,25 +62,6 @@ void _CPU_ISR_install_raw_handler( */ } -/* - * _CPU_ISR_install_vector - * - * This kernel routine installs the RTEMS handler for the - * specified vector. - * - * Input parameters: - * vector - interrupt vector number - * old_handler - former ISR for this vector number - * new_handler - replacement ISR for this vector number - * - * Output parameters: NONE - * - * - * NO_CPU Specific Information: - * - * XXX document implementation including references if appropriate - */ - void _CPU_ISR_install_vector( uint32_t vector, proc_ptr new_handler, diff --git a/cpukit/score/cpu/no_cpu/cpu_asm.c b/cpukit/score/cpu/no_cpu/cpu_asm.c index e2e466cbc9..c1e008aafd 100644 --- a/cpukit/score/cpu/no_cpu/cpu_asm.c +++ b/cpukit/score/cpu/no_cpu/cpu_asm.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief No CPU Assembly File + */ + /* cpu_asm.c ===> cpu_asm.S or cpu_asm.s * * This file contains the basic algorithms for all assembly code used diff --git a/cpukit/score/cpu/powerpc/cpu.c b/cpukit/score/cpu/powerpc/cpu.c index a1ede940db..1cac19c887 100644 --- a/cpukit/score/cpu/powerpc/cpu.c +++ b/cpukit/score/cpu/powerpc/cpu.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief PowerPC Dependent Source + */ + /* * The license and distribution terms for this file may be * found in the file LICENSE in this distribution or at diff --git a/cpukit/score/cpu/powerpc/ppc-isr-vector-install.c b/cpukit/score/cpu/powerpc/ppc-isr-vector-install.c index 4b8e81a5ea..98eff81a14 100644 --- a/cpukit/score/cpu/powerpc/ppc-isr-vector-install.c +++ b/cpukit/score/cpu/powerpc/ppc-isr-vector-install.c @@ -1,3 +1,9 @@ +/** + * @file + * + * @brief Install Interrupt Handler Vector + */ + /* * Copyright (c) 2012 embedded brains GmbH. All rights reserved. * -- cgit v1.2.3