diff --git a/os/hal/platforms/STM32/USARTv1/serial_lld.c b/os/hal/platforms/STM32/USARTv1/serial_lld.c
index 1f069b34a..590568cdd 100644
--- a/os/hal/platforms/STM32/USARTv1/serial_lld.c
+++ b/os/hal/platforms/STM32/USARTv1/serial_lld.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file    STM32/serial_lld.c
+ * @file    STM32/USARTv1/serial_lld.c
  * @brief   STM32 low level serial driver code.
  *
  * @addtogroup SERIAL
diff --git a/os/hal/platforms/STM32/USARTv1/serial_lld.h b/os/hal/platforms/STM32/USARTv1/serial_lld.h
index d98cb14bd..1a32df55f 100644
--- a/os/hal/platforms/STM32/USARTv1/serial_lld.h
+++ b/os/hal/platforms/STM32/USARTv1/serial_lld.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file    STM32/serial_lld.h
+ * @file    STM32/USARTv1/serial_lld.h
  * @brief   STM32 low level serial driver header.
  *
  * @addtogroup SERIAL
diff --git a/os/hal/platforms/STM32/USARTv1/uart_lld.h b/os/hal/platforms/STM32/USARTv1/uart_lld.h
index 7994b1e62..4e4708bf1 100644
--- a/os/hal/platforms/STM32/USARTv1/uart_lld.h
+++ b/os/hal/platforms/STM32/USARTv1/uart_lld.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file    STM32/uart_lld.h
+ * @file    STM32/USARTv1/uart_lld.h
  * @brief   STM32 low level UART driver header.
  *
  * @addtogroup UART
diff --git a/os/hal/platforms/STM32/USARTv2/serial_lld.c b/os/hal/platforms/STM32/USARTv2/serial_lld.c
index b48996f45..3c6bb272a 100644
--- a/os/hal/platforms/STM32/USARTv2/serial_lld.c
+++ b/os/hal/platforms/STM32/USARTv2/serial_lld.c
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file    STM32/serial_lld.c
+ * @file    STM32/USARTv2/serial_lld.c
  * @brief   STM32 low level serial driver code.
  *
  * @addtogroup SERIAL
diff --git a/os/hal/platforms/STM32/USARTv2/serial_lld.h b/os/hal/platforms/STM32/USARTv2/serial_lld.h
index d98cb14bd..d3b3a9352 100644
--- a/os/hal/platforms/STM32/USARTv2/serial_lld.h
+++ b/os/hal/platforms/STM32/USARTv2/serial_lld.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file    STM32/serial_lld.h
+ * @file    STM32/USARTv2/serial_lld.h
  * @brief   STM32 low level serial driver header.
  *
  * @addtogroup SERIAL
diff --git a/os/hal/platforms/STM32/USARTv2/uart_lld.h b/os/hal/platforms/STM32/USARTv2/uart_lld.h
index 57fbfd975..d832b9d02 100644
--- a/os/hal/platforms/STM32/USARTv2/uart_lld.h
+++ b/os/hal/platforms/STM32/USARTv2/uart_lld.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file    STM32/uart_lld.h
+ * @file    STM32/USARTv2/uart_lld.h
  * @brief   STM32 low level UART driver header.
  *
  * @addtogroup UART
diff --git a/readme.txt b/readme.txt
index 8af436f34..88f8c8d0d 100644
--- a/readme.txt
+++ b/readme.txt
@@ -164,7 +164,8 @@
 - CHANGE: The STM32 Serial driver has been split in two distinct versions,
   one for older devices up the STM32F4xx, the other for new devices starting
   from the STM32F0xx.
-  (TODO: Update IAR and Keil projects because different paths).
+  (TODO: Update IAR and Keil projects because different paths, update
+         documentation projects).
 
 *** 2.5.0 ***
 - FIX: Fixed anomaly in USB enumeration (bug 3565325)(backported to 2.4.3).