fix docstrings

util/mqtt.c

@@ -37,7 +37,7 @@
 #define G_LOG_DOMAIN "libgvm util"
 
 #define QOS 1
-#define TIMEOUT 10000L
+#define TIMEOUT 10000Lg
 
 typedef struct
 {
@@ -108,8 +108,6 @@ mqtt_set_global_username (const char *username)
 
 /**
  * @brief Get global username.
- *
- * @return Username, NULL if not found.
  */
 static const char *
 mqtt_get_global_username ()
@@ -130,8 +128,6 @@ mqtt_set_global_password (const char *password)
 
 /**
  * @brief Get global password.
- *
- * @return Password, NULL if not found.
  */
 static const char *
 mqtt_get_global_password ()
@@ -312,7 +308,10 @@ mqtt_set_client (mqtt_t *mqtt, MQTTClient client)
 /**
  * @brief Make new client and connect to mqtt broker.
  *
- * @param mqtt  Initialized mqtt_t
+ * @param mqtt        Initialized mqtt_t
+ * @param server_uri  Server URI
+ * @param username    Username
+ * @param password    Password
  *
  * @return 0 on success, <0 on error.
  */
@@ -364,6 +363,8 @@ mqtt_connect (mqtt_t *mqtt, const char *server_uri, const char *username,
  * @brief Init MQTT communication
  *
  * @param server_uri  Server URI
+ * @param username    Username
+ * @param password    Password
  *
  * @return 0 on success, <0 on error.
  */
@@ -518,8 +519,8 @@ mqtt_publish (const char *topic, const char *msg)
  * meant for error messages and the likes emitted by openvas.
  *
  * @param server_uri_in Server URI
- * @param username      Username
- * @param password      Password
+ * @param username_in   Username
+ * @param password_in   Password
  * @param topic         Topic to publish to
  * @param msg           Message to publish
  *