9 files changed, 63 insertions, 15 deletions
diff --git a/docs/Doxyfile b/docs/Doxyfile
index 1a67d8c24..56bb5444e 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -598,6 +598,7 @@ INPUT                  = ../docs/src \
                          ../os/hal/platforms/AVR \
                          ../os/hal/platforms/LPC214x \
                          ../os/hal/platforms/MSP430 \
+                         ../os/hal/platforms/SPC56x \
                          ../os/hal/platforms/STM32 \
                          ../os/hal/platforms/STM8 \
                          ../os/various \
diff --git a/docs/readme.txt b/docs/readme.txt
index b8ee45e2a..17d5b9136 100644
--- a/docs/readme.txt
+++ b/docs/readme.txt
@@ -24,12 +24,11 @@ Build procedure:
 - Normal paragraphs, return rescriptions and notes must start with a capital
   letter and must be terminated with a dot.
 - Multiple return values should be listed using the @retval command.
-- AUTOBRIEF is enabled but deprecated, gradually convert to the use of explicit
-  @brief command.
+- Parameters direction must be specified.
 
 Examples:
 @note This is a note.
 @retval RDY_OK is a possible return value.
 @return The pointer to the created thread is returned.
-@param n the number of bytes to be written
-@param n the number of bytes to be written. This value can be zero.
+@param[in] n the number of bytes to be written
+@param[in] n the number of bytes to be written. This value can be zero.
diff --git a/docs/src/eclipse.dox b/docs/src/eclipse.dox
index 79e60825d..385335d7e 100644
--- a/docs/src/eclipse.dox
+++ b/docs/src/eclipse.dox
@@ -62,8 +62,6 @@
  *   OpenOCD home page</a>, more exactly
  *   <a href="http://openocd.berlios.de/doc/html/Debug-Adapter-Hardware.html#Debug-Adapter-Hardware"
  *   target="_blank">here</a>.
- * - An STM32 development board (but this guide apply to all the ARM targets
- *   supported by ChibiOS/RT. This guide describes the Olimex STM32-P103.
  * - <a href="https://sourceforge.net/projects/chibios/" target="_blank">
  *   ChibiOS/RT latest stable release</a>.
  * - <a href="http://www.java.com/en/" target="_blank">Java runtime</a>, you
@@ -76,8 +74,8 @@
  * - Zylin plugin for on-board debugging, see @ref install_zylin section.
  * - OpenOCD binaries for Windows, YAGARTO does not provide those anymore but
  *   you can download them from <a href="http://www.freddiechopin.info/"
- *   target="_blank">here</a>. This guide will describe the use with version
- *   3.1 but it should apply to newer releases as well.
+ *   target="_blank">here</a>. Linux users can try 
+ *   <a href="http://home.comcast.net/~mcatudal/" target="_blank">here</a>.
  * - <b>Optional</b>, <a href="http://www.stack.nl/~dimitri/doxygen/"
  *   target="_blank">MinGW compiler</a>, needed if you want to compile, debug
  *   and run the simulator from within Eclipse. Linux users do not need this
@@ -125,7 +123,9 @@
  *   to the ChibiOS/RT root directory (you may have as many workspaces you
  *   want, keep this for later), make sure to select the check box or it will
  *   ask you again each time.
+ *   <br>
  *   @image html tool001.jpg
+ *   <br>
  * - Now you should see the welcome screen, close it and you will be in the
  *   normal C/C++ perspective.
  * - Unselect "Project->Build Automatically" unless you like insanity.
@@ -143,9 +143,15 @@
  * - Press the "Add..." button and put http://opensource.zylin.com/zylincdt
  *   into the location field, then press OK. The Zylin plugin will appear in the
  *   available plugins view, select and install it.
+ *   <br>
  *   @image html tool002.jpg
  * .
  *
+ * @section install_openocd OpenOCD Installation
+ * Windows users just have to use the installer. Linux user should follow the
+ * normal installation procedure for deb or rpm packages, of course it is also
+ * possible to build it from the source code.
+ *
  * @section install_doxygen Doxygen Installation
  * Just use the installer, Linux users probably have Doxygen already available
  * from the repositories. Make sure that the Doxygen binaries directory
@@ -157,8 +163,9 @@
  * is listed in the PATH variable or Doxygen would not be able to locate it.
  *
  * @section install_eclox Eclox Installation
- * Use the same installation steps used for the Zylin plugin except use the
- * URL http://download.gna.org/eclox/update. Install "Eclox" not "Eclox Hot".
+ * Use the same installation steps used for the Zylin plugin except use
+ * http://download.gna.org/eclox/update as URL. Install "Eclox" not "Eclox
+ * Hot".
  * After installing Eclox you will be able to compile Doxygen documentation
  * using the button with the blue @@ inside.
  */
diff --git a/os/hal/platforms/SPC56x/hal_lld.c b/os/hal/platforms/SPC56x/hal_lld.c
index 8c7d496ef..c5d15dcfa 100644
--- a/os/hal/platforms/SPC56x/hal_lld.c
+++ b/os/hal/platforms/SPC56x/hal_lld.c
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file    SPC563/hal_lld.c
+ * @file    SPC56x/hal_lld.c
  * @brief   SPC563 HAL subsystem low level driver source.
  *
  * @addtogroup SPC563_HAL
diff --git a/os/hal/platforms/SPC56x/hal_lld.h b/os/hal/platforms/SPC56x/hal_lld.h
index 49943a098..47b823bf7 100644
--- a/os/hal/platforms/SPC56x/hal_lld.h
+++ b/os/hal/platforms/SPC56x/hal_lld.h
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file    SPC563/hal_lld.h
+ * @file    SPC56x/hal_lld.h
  * @brief   SPC563 HAL subsystem low level driver header.
  *
  * @addtogroup SPC563_HAL
diff --git a/os/hal/platforms/SPC56x/platform.dox b/os/hal/platforms/SPC56x/platform.dox
new file mode 100644
index 000000000..119300758
--- /dev/null
+++ b/os/hal/platforms/SPC56x/platform.dox
@@ -0,0 +1,41 @@
+/*
+    ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010 Giovanni Di Sirio.
+
+    This file is part of ChibiOS/RT.
+
+    ChibiOS/RT is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 3 of the License, or
+    (at your option) any later version.
+
+    ChibiOS/RT is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+/**
+ * @defgroup SPC563_DRIVERS SPC563 Drivers
+ * @brief Device drivers included in the SPC563 support.
+ *
+ * @ingroup PPC
+ */
+
+/**
+ * @defgroup SPC563_HAL SPC563 HAL Support
+ * @brief HAL support.
+ *
+ * @ingroup SPC563_DRIVERS
+ */
+
+/**
+ * @defgroup SPC563_SERIAL SPC563 ESCI Support
+ * @brief ESCI support.
+ * @details The serial driver supports both the SPC563 ESCIs in asynchronous
+ * mode.
+ *
+ * @ingroup SPC563_DRIVERS
+ */
diff --git a/os/hal/platforms/SPC56x/serial_lld.c b/os/hal/platforms/SPC56x/serial_lld.c
index 21a93764b..91127e767 100644
--- a/os/hal/platforms/SPC56x/serial_lld.c
+++ b/os/hal/platforms/SPC56x/serial_lld.c
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file    SPC563/serial_lld.c
+ * @file    SPC56x/serial_lld.c
  * @brief   SPC563 low level serial driver code.
  *
  * @addtogroup SPC563_SERIAL
diff --git a/os/hal/platforms/SPC56x/serial_lld.h b/os/hal/platforms/SPC56x/serial_lld.h
index 732a55bca..4da905cd9 100644
--- a/os/hal/platforms/SPC56x/serial_lld.h
+++ b/os/hal/platforms/SPC56x/serial_lld.h
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file    SPC563/serial_lld.h
+ * @file    SPC56x/serial_lld.h
  * @brief   SPC563 low level serial driver header.
  *
  * @addtogroup SPC563_SERIAL
diff --git a/os/hal/platforms/SPC56x/typedefs.h b/os/hal/platforms/SPC56x/typedefs.h
index b90ce8c68..b9611bf2c 100644
--- a/os/hal/platforms/SPC56x/typedefs.h
+++ b/os/hal/platforms/SPC56x/typedefs.h
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file    SPC563/typedefs.h
+ * @file    SPC56x/typedefs.h
  * @brief   Dummy typedefs file.
  */