3 files changed, 9 insertions, 5 deletions
diff --git a/os/hal/include/hal_channels.h b/os/hal/include/hal_channels.h
index 688f7d4d9..e4ea25b29 100644
--- a/os/hal/include/hal_channels.h
+++ b/os/hal/include/hal_channels.h
@@ -220,7 +220,7 @@ typedef struct {
  *
  * @api
  */
-#define chnControl(sdp, operation, arg) ((ip)->vmt->ctl(ip, operation, arg)
+#define chnControl(ip, operation, arg) ((ip)->vmt->ctl(ip, operation, arg)
 /** @} */
 
 /**
diff --git a/os/hal/include/hal_crypto.h b/os/hal/include/hal_crypto.h
index 01ce3c33f..3edf23440 100644
--- a/os/hal/include/hal_crypto.h
+++ b/os/hal/include/hal_crypto.h
@@ -32,7 +32,7 @@
 /*===========================================================================*/
 
 /**
- * #brief   Maximum size of a key for all supported algorithms.
+ * @brief   Maximum size of a key for all supported algorithms.
  */
 #define HAL_CRY_MAX_KEY_SIZE                32
 
diff --git a/os/hal/include/hal_pal.h b/os/hal/include/hal_pal.h
index abd2d0fd7..a3c9818ce 100644
--- a/os/hal/include/hal_pal.h
+++ b/os/hal/include/hal_pal.h
@@ -920,8 +920,7 @@ typedef struct {
  *
  * @param[in] port      port identifier
  * @param[in] pad       pad number within the port
- * @param[in] mode      pad event mode
- * @param[in] callback  event callback function
+ * @param[in] cb        event callback function
  * @param[in] arg       callback argument
  *
  * @api
@@ -937,7 +936,7 @@ typedef struct {
  * @brief   Associates a callback to a line.
  *
  * @param[in] line      line identifier
- * @param[in] callback  event callback function
+ * @param[in] cb        event callback function
  * @param[in] arg       callback argument
  *
  * @iclass
@@ -956,6 +955,11 @@ typedef struct {
  *
  * @param[in] port      port identifier
  * @param[in] pad       pad number within the port
+ * @param[in] timeout   the number of ticks before the operation timeouts,
+ *                      the following special values are allowed:
+ *                      - @a TIME_IMMEDIATE immediate timeout.
+ *                      - @a TIME_INFINITE no timeout.
+ *                      .
  * @returns             The operation state.
  * @retval MSG_OK       if an edge has been detected.
  * @retval MSG_TIMEOUT  if a timeout occurred before an edge cound be detected.