Merge pull request #17461 from aabadie/pr/doc/various_fixes

doc: fix missing or non matching arguments in Doxygen documentation

drivers/include/can/candev.h

@@ -63,7 +63,7 @@ typedef struct candev candev_t;
  * @brief   Event callback for signaling event to upper layers
  *
  * @param[in] dev           CAN device descriptor
- * @param[in] type          type of the event
+ * @param[in] event         type of the event
  * @param[in] arg           event argument
  */
 typedef void (*candev_event_cb_t)(candev_t *dev, candev_event_t event, void *arg);

drivers/include/net/netdev.h

@@ -289,7 +289,8 @@ typedef struct netdev netdev_t;
 /**
  * @brief   Event callback for signaling event to upper layers
  *
- * @param[in] type          type of the event
+ * @param[in] dev           pointer to the device descriptor
+ * @param[in] event         type of the event
  */
 typedef void (*netdev_event_cb_t)(netdev_t *dev, netdev_event_t event);
 

sys/include/crypto/ciphers.h

@@ -104,6 +104,7 @@ typedef struct cipher_interface_st {
                    uint8_t *plain_block);
 } cipher_interface_t;
 
+/** Pointer type to BlockCipher-Interface for the Cipher-Algorithms */
 typedef const cipher_interface_t *cipher_id_t;
 
 /**

sys/include/net/cord/ep_standalone.h

@@ -45,7 +45,7 @@ typedef enum {
  * The registered callback function is executed in the context of the dedicated
  * standalone RD endpoint's thread.
  *
- * @param[in] t         type of event
+ * @param[in] event     type of event
  */
 typedef void(*cord_ep_standalone_cb_t)(cord_ep_standalone_event_t event);
 

sys/include/net/sock/async/types.h

@@ -154,7 +154,7 @@ typedef struct sock_udp sock_udp_t;     /**< forward declare for async */
  * @param[in] arg   Argument provided when setting the callback using
  *                  @ref sock_udp_set_cb(). May be NULL.
  */
-typedef void (*sock_udp_cb_t)(sock_udp_t *sock, sock_async_flags_t type,
+typedef void (*sock_udp_cb_t)(sock_udp_t *sock, sock_async_flags_t flags,
                               void *arg);
 #endif  /* defined(MODULE_SOCK_UDP) || defined(DOXYGEN) */