src: fix doxygen warnings (#847)

src/http/server.c

@@ -512,7 +512,7 @@ struct tcp_sock *http_sock_tcp(struct http_sock *sock)
 /**
  * Get the TLS struct of an HTTP sock
  *
- * @param conn HTTP connection
+ * @param sock HTTP socket
  *
  * @return TLS struct
  */

src/main/init.c

@@ -180,6 +180,8 @@ void libre_close(void)
 
 /**
  * Enable/Disable exception signal handling (SIGSEGV, SIGABRT, SIGILL...)
+ *
+ * @param enable True to enable, false to disable
  */
 void libre_exception_btrace(bool enable)
 {

src/main/main.c

@@ -1311,6 +1311,8 @@ void re_set_mutex(void *mutexp)
 /**
  * Check for NON-RE thread calls
  *
+ * @param debug True to print debug warning
+ *
  * @return 0 if success, otherwise EPERM
  */
 int re_thread_check(bool debug)

src/sipreg/reg.c

@@ -630,6 +630,8 @@ void sipreg_set_srcport(struct sipreg *reg, uint16_t srcport)
  *
  * @param reg      SIP registration client
  * @param cparams  Contact URI optional parameters
+ *
+ * @return 0 if success, otherwise errorcode
  */
 int sipreg_set_contact_params(struct sipreg *reg, const char *cparams)
 {

src/tls/openssl/tls.c

@@ -1028,10 +1028,13 @@ static int tls_verify_handler_ud(int ok, X509_STORE_CTX *ctx)
  * Enable request certificate from peer in TLS server connection
  * Set verify handler.
  *
- * @param tc     TLS connection
- * @param depth  Max depth certificate chain accepted.
- *               A negative depth uses default depth.
- * @param cb     SSL verify handler. If NULL default verify handler is used.
+ * @param tc      TLS connection
+ * @param depth   Max depth certificate chain accepted.
+ *                A negative depth uses default depth.
+ * @param verifyh SSL verify handler. If NULL default verify handler is used.
+ * @param arg     Handler argument
+ *
+ * @return 0 if success, otherwise errorcode
  */
 int tls_set_verify_client_handler(struct tls_conn *tc, int depth,
 	int (*verifyh) (int ok, void *arg), void *arg)