diff --git a/src/chsem.c b/src/chsem.c
index edec3b5db..47ea2fc50 100644
--- a/src/chsem.c
+++ b/src/chsem.c
@@ -43,8 +43,8 @@ void chSemInit(Semaphore *sp, t_cnt n) {
  * @param sp pointer to a \p Semaphore structure
  * @param n the new value of the semaphore counter. Must be non-negative.
  * @note The released threads can recognize they were waked up by a reset
- *       instead than a signal because the \p p_rdymsg field is set to
- *       \p RDY_RESET.
+ *       instead than a signal because the \p chSemWait() will return
+ *       \p RDY_RESET instead of \p RDY_OK.
  */
 void chSemReset(Semaphore *sp, t_cnt n) {
 
@@ -61,8 +61,8 @@ void chSemReset(Semaphore *sp, t_cnt n) {
  * @param sp pointer to a \p Semaphore structure
  * @param n the new value of the semaphore counter. Must be non-negative.
  * @note The released threads can recognize they were waked up by a reset
- *       instead than a signal because the \p p_rdymsg field is set to
- *       \p RDY_RESET.
+ *       instead than a signal because the \p chSemWait() will return
+ *       \p RDY_RESET instead of \p RDY_OK.
  * @note This function does not reschedule.
  */
 void chSemResetI(Semaphore *sp, t_cnt n) {
@@ -146,8 +146,8 @@ t_msg chSemWaitTimeoutS(Semaphore *sp, t_time time) {
   }
   return RDY_OK;
 }
-
 #endif /* CH_USE_SEMAPHORES_TIMEOUT */
+
 /**
  * Performs a signal operation on a semaphore.
  * @param sp pointer to a \p Semaphore structure
diff --git a/src/chserial.c b/src/chserial.c
index 54c2f9f7e..196c9d5c2 100644
--- a/src/chserial.c
+++ b/src/chserial.c
@@ -25,7 +25,6 @@
 #include <ch.h>
 
 #ifdef CH_USE_SERIAL_FULLDUPLEX
-
 /**
  * Initializes a generic full duplex driver. The HW dependent part of the
  * initialization has to be performed outside, usually in the hardware
@@ -108,7 +107,6 @@ t_dflags chFDDGetAndClearFlags(FullDuplexDriver *sd) {
   sd->sd_flags = SD_NO_ERROR;
   return mask;
 }
-
 #endif /* CH_USE_SERIAL_FULLDUPLEX */
 
 #ifdef CH_USE_SERIAL_HALFDUPLEX