Several mqtt documentation fixes found by clang
diff --git a/src/apps/mqtt/mqtt.c b/src/apps/mqtt/mqtt.c
index 1929a6d..2e4132c 100644
--- a/src/apps/mqtt/mqtt.c
+++ b/src/apps/mqtt/mqtt.c
@@ -139,7 +139,8 @@
/**
* Message type value to string
- * @param msg_type @see mqtt_message_type
+ * @param msg_type see enum mqtt_message_type
+ *
* @return Control message type text string
*/
static const char *
@@ -447,7 +448,7 @@
/**
* Append fixed header
* @param rb Output ring buffer
- * @param msg_type @see mqtt_message_type
+ * @param msg_type see enum mqtt_message_type
* @param dup MQTT DUP flag
* @param qos MQTT QoS field
* @param retain MQTT retain flag
@@ -613,7 +614,6 @@
/**
* Subscribe response from server
- * @param client MQTT client
* @param r Matching request
* @param result Result code from server
*/
@@ -629,7 +629,7 @@
/**
* Complete MQTT message received or buffer full
* @param client MQTT client
- * @param var_hdr_payload Pointer to beginning of variable headers and optional payload
+ * @param fixed_hdr_idx header index
* @param length length received part
* @param remaining_length Remaining length of complete message
*/
diff --git a/src/include/lwip/apps/mqtt.h b/src/include/lwip/apps/mqtt.h
index ce8c6ca..8d7c457 100644
--- a/src/include/lwip/apps/mqtt.h
+++ b/src/include/lwip/apps/mqtt.h
@@ -114,7 +114,6 @@
* Function prototype for MQTT incoming publish data callback function. Called when data
* arrives to a subscribed topic @see mqtt_subscribe
*
- * @param client MQTT client itself
* @param arg Additional argument to pass to the callback function
* @param data User data, pointed object, data may not be referenced after callback return,
NULL is passed when all publish data are delivered
@@ -130,11 +129,9 @@
* Function prototype for MQTT incoming publish function. Called when an incoming publish
* arrives to a subscribed topic @see mqtt_subscribe
*
- * @param client MQTT client itself
* @param arg Additional argument to pass to the callback function
* @param topic Zero terminated Topic text string, topic may not be referenced after callback return
* @param tot_len Total length of publish data, if set to 0 (no publish payload) data callback will not be invoked
- * @return Optional numerical topic identifier to be used in data callback
*/
typedef void (*mqtt_incoming_publish_cb_t)(void *arg, const char *topic, u32_t tot_len);