diff --git a/os/ports/GCC/MSP430/port.dox b/os/ports/GCC/MSP430/port.dox
index 66f2562c8..f57cafabe 100644
--- a/os/ports/GCC/MSP430/port.dox
+++ b/os/ports/GCC/MSP430/port.dox
@@ -25,7 +25,7 @@
  * 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 system states are mapped as follow in the MSP430
+ * The ChibiOS/RT logical @ref 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
diff --git a/os/ports/GCC/PPC/port.dox b/os/ports/GCC/PPC/port.dox
index 14116b90e..ee0d720b6 100644
--- a/os/ports/GCC/PPC/port.dox
+++ b/os/ports/GCC/PPC/port.dox
@@ -25,7 +25,7 @@
  * This port supports cores implementing a 32 bits Power Architecture.
  *
  * @section PPC_STATES Mapping of the System States in the Power Architecture port
- * The ChibiOS/RT logical system states are mapped as follow in the
+ * The ChibiOS/RT logical @ref system_states are mapped as follow in the
  * PowerPC 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
diff --git a/os/ports/RC/STM8/port.dox b/os/ports/RC/STM8/port.dox
index 5daf546f9..1a57ad754 100644
--- a/os/ports/RC/STM8/port.dox
+++ b/os/ports/RC/STM8/port.dox
@@ -25,7 +25,7 @@
  * This port supports all STM8 8 bits MCUs.
  *
  * @section STM8_RAISONANCE_STATES Mapping of the System States in the STM8 port
- * The ChibiOS/RT logical system states are mapped as follow in the STM8
+ * The ChibiOS/RT logical @ref system_states are mapped as follow in the STM8
  * 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
diff --git a/os/ports/cosmic/STM8/port.dox b/os/ports/cosmic/STM8/port.dox
index 4468de71f..3e428c909 100644
--- a/os/ports/cosmic/STM8/port.dox
+++ b/os/ports/cosmic/STM8/port.dox
@@ -25,7 +25,7 @@
  * This port supports all STM8 8 bits MCUs.
  *
  * @section STM8_COSMIC_STATES Mapping of the System States in the STM8 port
- * The ChibiOS/RT logical system states are mapped as follow in the STM8
+ * The ChibiOS/RT logical @ref system_states are mapped as follow in the STM8
  * 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