From 55848af13c5077a42ef71b15ab98e003ed709948 Mon Sep 17 00:00:00 2001
From: gdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>
Date: Sat, 2 Oct 2010 10:27:36 +0000
Subject: [PATCH] Documentation related fixes.

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@2221 35acf78f-673a-0410-8e92-d51de3d6d3f4
---
 os/ports/GCC/MSP430/port.dox | 34 +++++++++++++++++++++-------------
 1 file changed, 21 insertions(+), 13 deletions(-)

diff --git a/os/ports/GCC/MSP430/port.dox b/os/ports/GCC/MSP430/port.dox
index 721540baf..3f9609cf9 100644
--- a/os/ports/GCC/MSP430/port.dox
+++ b/os/ports/GCC/MSP430/port.dox
@@ -21,8 +21,11 @@
  * @defgroup MSP430 MSP430
  * @details MSP430 port for the GCC compiler.
  *
+ * @section MSP430_INTRO Introduction
+ * This port supports all the cores implementing the MSP430 architecture.
+ *
  * @section MSP430_STATES Mapping of the System States in the MSP430 port
- * The ChibiOS/RT logical @ref system_states are mapped as follow in the MSP430
+ * The ChibiOS/RT logical system states are mapped as follow in the MSP430
  * port:
  * - <b>Init</b>. This state is represented by the startup code and the
  *   initialization code before @p chSysInit() is executed. It has not a
@@ -46,8 +49,7 @@
  * @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
- *     by modifying the @p INT_REQUIRED_STACK macro into
- *     <b>./ports/MSP430/chcore.h</b>.
+ *     by modifying the @p INT_REQUIRED_STACK configuration options.
  * - The state of the hardware multiplier is not saved in the thread context,
  *   make sure to use it in <b>Suspended</b> state (interrupts masked).
  * - The port code does not define the switch to a low power mode for the
@@ -60,10 +62,10 @@
 
 /**
  * @defgroup MSP430_CONF Configuration Options
- * @brief MSP430 Configuration Options.
- * @details The MSP430 port allows some architecture-specific configurations
- * settings that can be overridden by redefining them in @p chconf.h.
- * Usually there is no need to change the default values.
+ * @details MSP430 Configuration Options. The MSP430 port allows some
+ * architecture-specific configurations settings that can be overridden
+ * by redefining them in @p chconf.h. Usually there is no need to change
+ * the default values.
  * - @p INT_REQUIRED_STACK, this value represent the amount of stack space
  *   used by the interrupt handlers.<br>
  *   The default for this value is @p 32, this space is allocated for each
@@ -76,12 +78,18 @@
  * @ingroup MSP430
  */
 
-/**
- * @defgroup MSP430_CORE Core Port Implementation
- * @brief MSP430 specific port code, structures and macros.
+ /**
+ * @defgroup MSP430_STARTUP Startup Support
+ * @details ChibiOS/RT doed not provide startup files for the MSP430, there
+ * are no special startup requirement so the normal toolchain-provided
+ * startup files can be used.
+ *
+ * @ingroup MSP430
+ */
+
+/**
+ * @defgroup MSP430_CORE Core Port Implementation
+ * @details MSP430 specific port code, structures and macros.
  *
  * @ingroup MSP430
- * @file MSP430/chtypes.h Port types.
- * @file MSP430/chcore.h Port related structures and macros.
- * @file MSP430/chcore.c Port related code.
  */