mitigated -Wdocumentation and -Wdocumentation-unknown-command Clang compiler warnings

libipm/libipm.h

@@ -154,7 +154,7 @@ libipm_msg_out_init(struct trans *trans, unsigned short msgno,
  *
  * @param trans libipm transport
  * @param format a description of any arguments to add to the buffer.
- * @param != 0 if an error occurs
+ * @return != 0 if an error occurs
  *
  * The format string is followed immediately by the arguments it
  * describes. The format string may contain these characters (from the
@@ -299,7 +299,7 @@ libipm_msg_in_peek_type(struct trans *trans);
  *
  * @param trans libipm transport
  * @param format a description of the arguments to read from the buffer.
- * @param != 0 if an error occurs
+ * @return != 0 if an error occurs
  *
  * The format string is followed immediately by the arguments it
  * describes. The format string may contain these characters (from the

libipm/libipm_send.c

@@ -471,7 +471,6 @@ libipm_msg_out_appendv(struct trans *trans, const char *format, va_list *argptr)
  * Prepare the transport to build an output message
  * @param trans libipm trans
  * @param msgno Number of message
- * @return != 0 for error
  */
 static void
 init_output_buffer(struct trans *trans, unsigned short msgno)

libipm/scp_application_types.h

@@ -70,7 +70,7 @@ struct scp_session_info
 enum scp_login_status
 {
     E_SCP_LOGIN_OK = 0, ///< The connection is now loggned in
-    E_SCP_LOGIN_ALREADY_LOGGED_IN, //< A user is currently logged in
+    E_SCP_LOGIN_ALREADY_LOGGED_IN, ///< A user is currently logged in
     E_SCP_LOGIN_NO_MEMORY, ///< Memory allocation failure
     /**
      * User couldn't be authenticated, or user doesn't exist */

libipm/scp_sync.h

@@ -38,7 +38,7 @@
  * Waits on a single transport for a specific SCP message to be available for
  * parsing
  *
- * @param trans libipm transport
+ * @param t libipm transport
  * @param wait_msgno Message number to wait for
  * @return != 0 for error
  *