From f85150da74ba830ecd726e190969f3f2507d2a28 Mon Sep 17 00:00:00 2001 From: gdisirio Date: Sun, 14 Jun 2009 13:29:36 +0000 Subject: Doxygen-related fixes. git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1038 35acf78f-673a-0410-8e92-d51de3d6d3f4 --- ports/ARM7-AT91SAM7X/port.dox | 2 +- ports/ARM7-LPC214x/port.dox | 2 +- ports/ARM7/port.dox | 8 ++++---- ports/ARMCM3/port.dox | 6 +++--- ports/AVR/port.dox | 16 +++------------- ports/MSP430/port.dox | 6 +++--- 6 files changed, 15 insertions(+), 25 deletions(-) (limited to 'ports') diff --git a/ports/ARM7-AT91SAM7X/port.dox b/ports/ARM7-AT91SAM7X/port.dox index d17361875..245c4b4bc 100644 --- a/ports/ARM7-AT91SAM7X/port.dox +++ b/ports/ARM7-AT91SAM7X/port.dox @@ -25,7 +25,7 @@ * - EMAC driver with MII support. * - A demo supporting the kernel test suite. * - A Web server demo using the uIP TCP/IP stack. - * + * . * @ingroup ARM7 */ diff --git a/ports/ARM7-LPC214x/port.dox b/ports/ARM7-LPC214x/port.dox index 9cff4c11f..332c6c191 100644 --- a/ports/ARM7-LPC214x/port.dox +++ b/ports/ARM7-LPC214x/port.dox @@ -30,7 +30,7 @@ * - A minimal demo, useful as project template. * - A demo supporting the kernel test suite. * - A C++ demo supporting the kernel test suite. - * + * . * @ingroup ARM7 */ diff --git a/ports/ARM7/port.dox b/ports/ARM7/port.dox index 011e866bb..780c57083 100644 --- a/ports/ARM7/port.dox +++ b/ports/ARM7/port.dox @@ -34,7 +34,7 @@ * THUMB modules then the interworking compiler option is enabled. This is * usually the slowest mode and the code size is not as good as in pure * THUMB mode. - * + * . * @section ARM7_STATES Mapping of the System States in the ARM7 port * The ChibiOS/RT logical @ref system_states are mapped as follow in the ARM7 * port: @@ -69,7 +69,7 @@ * - Halted. Implemented as an infinite loop after disabling both IRQ * and FIQ sources. The ARM state is whatever the processor was running when * @p chSysHalt() was invoked. - * + * . * @section ARM7_NOTES The ARM7 port notes * The ARM7 port makes some assumptions on the application code organization: * - The @p main() function is invoked in system mode. @@ -90,7 +90,7 @@ * - FIQ sources can preempt the kernel (by design) so it is not possible to * invoke the kernel APIs from inside a FIQ handler. FIQ handlers are not * affected by the kernel activity so there is not added jitter. - * + * . * @section ARM7_IH ARM7 Interrupt Handlers * ARM7 Interrupt handlers do not save function-saved registers so you need to * make sure your code saves them or does not use them (this happens @@ -138,7 +138,7 @@ * can trim this down by defining the macro externally. This would save * some valuable RAM space for each thread present in the system.
* The default value is set into ./ports/ARM7/chcore.h. - * + * . * @ingroup ARM7 */ diff --git a/ports/ARMCM3/port.dox b/ports/ARMCM3/port.dox index 7fb8ac53f..db44ab9c5 100644 --- a/ports/ARMCM3/port.dox +++ b/ports/ARMCM3/port.dox @@ -60,7 +60,7 @@ * - Halted. Implemented as an infinite loop after globally masking all * the maskable interrupt sources. The ARM state is whatever the processor * was running when @p chSysHalt() was invoked. - * + * . * @section ARMCM3_NOTES The ARM Cortex-M3 port notes * The ARM Cortex-M3 port is organized as follow: * - The @p main() function is invoked in thread-privileged mode. @@ -78,7 +78,7 @@ * It is possible to share the SVC handler at the cost of slower context * switching. * - The PendSV vector is internally used for preemption context switching. - * + * . * @ingroup Ports */ @@ -107,7 +107,7 @@ * instruction from within the idle loop. This is defaulted to 0 because * it can create problems with some debuggers. Setting this option to 1 * reduces the system power requirements. - * + * . * @ingroup ARMCM3 */ diff --git a/ports/AVR/port.dox b/ports/AVR/port.dox index 01fe86742..5343037b1 100644 --- a/ports/AVR/port.dox +++ b/ports/AVR/port.dox @@ -19,7 +19,6 @@ /** * @defgroup AVR MegaAVR - * @{ * @details AVR port details. This section how the ChibiOS/RT features are * implemented on this architecture. * @@ -44,20 +43,18 @@ * - Serving Fast Interrupt. Not present in this architecture. * - Serving Non-Maskable Interrupt. Not present in this architecture. * - Halted. Implemented as an infinite loop with interrupts disabled. - * + * . * @section AVR_NOTES The AVR port notes * - The AVR does not have a dedicated interrupt stack, make sure to reserve * enough stack space for interrupts in each thread stack. This can be done * by modifying the @p INT_REQUIRED_STACK macro into * ./ports/AVR/chcore.h. - * + * . * @ingroup Ports */ -/** @} */ /** * @defgroup AVR_CONF Configuration Options - * @{ * @brief AVR Configuration Options. * @details The AVR port allows some architecture-specific configurations * settingsthat can be specified externally, as example on the compiler @@ -67,14 +64,12 @@ * The default for this value is @p 32, this space is allocated for each * thread so be careful in order to not waste precious RAM space.
* The default value is set into ./ports/AVR/chcore.h. - * + * . * @ingroup AVR */ -/** @} */ /** * @defgroup AVR_CORE AVR Core Implementation - * @{ * @brief AVR specific port code, structures and macros. * * @ingroup AVR @@ -82,24 +77,19 @@ * @file ports/AVR/chcore.h Port related structures and macros. * @file ports/AVR/chcore.c Port related code. */ -/** @} */ /** * @defgroup AVR_DRIVERS AVR Drivers - * @{ * @brief Device drivers included in the AVR support. * * @ingroup AVR */ -/** @} */ /** * @defgroup AVR_SERIAL USART Support - * @{ * @brief USART support. * @details The serial driver supports both the AVR USARTs in asynchronous * mode. * * @ingroup AVR_DRIVERS */ -/** @} */ diff --git a/ports/MSP430/port.dox b/ports/MSP430/port.dox index 6aa5c6c30..3300f4441 100644 --- a/ports/MSP430/port.dox +++ b/ports/MSP430/port.dox @@ -43,7 +43,7 @@ * - Serving Non-Maskable Interrupt. The MSP430 has several non * maskable interrupt sources that can be associated to this state. * - Halted. Implemented as an infinite loop with interrupts disabled. - * + * . * @section MSP430_NOTES The MSP430 port notes * - The MSP430 does not have a dedicated interrupt stack, make sure to reserve * enough stack space for interrupts in each thread stack. This can be done @@ -55,7 +55,7 @@ * idle thread because the MSP430 has several low power modes. You can * select the proper low power mode for you application by defining the * macro @p port_wait_for_interrupt(). - * + * . * @ingroup Ports */ @@ -70,7 +70,7 @@ * The default for this value is @p 32, this space is allocated for each * thread so be careful in order to not waste precious RAM space.
* The default value is set into ./ports/MSP430/chcore.h. - * + * . * @ingroup MSP430 */ -- cgit v1.2.3