Move comment to the right function

Author: PhilDay-CT

include/mqtt.h

@@ -137,6 +137,14 @@ int __cheri_compartment("MQTT")
  *
  * `qos` indicates the level of QoS (0, 1, or 2).
  *
+ * `retain` indicates whether the message should be published as retained or
+ * not. The broker stores the last retained message and the corresponding QoS
+ * for that topic. Each client that subscribes to a topic pattern that matches
+ * the topic of the retained message receives the retained message immediately
+ * after they subscribe. The broker stores only one retained message per topic.
+ * Retained messages are cleared by publishing a zero length message with the
+ * retain flag set.
+ *
  * Both the topic and payload buffers must remain valid during the execution of
  * this function. If the caller frees them during the execution of this
  * function, the publish may leak application data to the broker through the
@@ -182,14 +190,6 @@ int __cheri_compartment("MQTT") mqtt_publish(Timeout    *t,
  *
  * `qos` indicates the level of QoS (0, 1, or 2).
  *
- * `retain` indicates whether the message should be published as retained or
- * not. The broker stores the last retained message and the corresponding QoS
- * for that topic. Each client that subscribes to a topic pattern that matches
- * the topic of the retained message receives the retained message immediately
- * after they subscribe. The broker stores only one retained message per topic.
- * Retained messages are cleared by publishing a zero length message with the
- * retain flag set.
- *
  * The filter buffer must remain valid during the execution of this function.
  * If the caller frees it during the execution of this function, the subscribe
  * may leak application data to the broker through the filter.