Fixed doxygen compilation warnings

include/libssh/sftp.h

@@ -418,7 +418,7 @@ LIBSSH_API int sftp_file_close(SFTP_FILE *file) SFTP_DEPRECATED;
  * @return              A sftp file handle, NULL on error with ssh and sftp
  *                      error set.
  */
-LIBSSH_API SFTP_FILE *sftp_open(SFTP_SESSION *session, const char *file, int flags,
+LIBSSH_API SFTP_FILE *sftp_open(SFTP_SESSION *session, const char *file, int access,
     mode_t mode);
 
 LIBSSH_API void sftp_file_set_nonblocking(SFTP_FILE *handle);

libssh/channels.c

@@ -1229,13 +1229,13 @@ int channel_request_shell(ssh_channel channel) {
  *
  * @param channel       The channel to send the request.
  *
- * @param system        The subsystem to request (for example "sftp").
+ * @param subsys        The subsystem to request (for example "sftp").
  *
  * @return SSH_SUCCESS on success, SSH_ERROR on error.
  *
  * @warning You normally don't have to call it for sftp, see sftp_new().
  */
-int channel_request_subsystem(ssh_channel channel, const char *sys) {
+int channel_request_subsystem(ssh_channel channel, const char *subsys) {
   ssh_buffer buffer = NULL;
   ssh_string subsystem = NULL;
   int rc = SSH_ERROR;
@@ -1245,7 +1245,7 @@ int channel_request_subsystem(ssh_channel channel, const char *sys) {
     goto error;
   }
 
-  subsystem = string_from_char(sys);
+  subsystem = string_from_char(subsys);
   if (subsystem == NULL) {
     goto error;
   }

libssh/dh.c

@@ -856,8 +856,6 @@ int ssh_get_pubkey_hash(ssh_session session, unsigned char **hash) {
   return MD5_DIGEST_LEN;
 }
 
-/** \addtogroup ssh_session
- * @{ */
 /**
  * @brief Deallocate the hash obtained by ssh_get_pubkey_hash.
  * This is required under Microsoft platform as this library might use a 

libssh/error.c

@@ -76,13 +76,13 @@ const char *ssh_get_error(void *error) {
  *
  * @param  error        The SSH session pointer.
  *
- * \return SSH_NO_ERROR       No error occured\n
+ * \return SSH_NO_ERROR       No error occurred\n
  *         SSH_REQUEST_DENIED The last request was denied but situation is
  *                            recoverable\n
- *         SSH_FATAL          A fatal error occured. This could be an unexpected
+ *         SSH_FATAL          A fatal error occurred. This could be an unexpected
  *                            disconnection\n
  *
- *         \nOther error codes are internal but can be considered same than
+ *         Other error codes are internal but can be considered same than
  *         SSH_FATAL.
  */
 int ssh_get_error_code(void *error) {

libssh/keyfiles.c

@@ -865,7 +865,7 @@ void privatekey_free(ssh_private_key prv) {
 /** \brief Retrieve a public key from a file
  * \param session the SSH session
  * \param filename Filename of the key
- * \param _type Pointer to a integer. If it is not null, it contains the type of the key after execution.
+ * \param type Pointer to a integer. If it is not null, it contains the type of the key after execution.
  * \return a SSH String containing the public key, or NULL if it failed.
  * \see string_free()
  * \see publickey_from_privatekey()

libssh/options.c

@@ -997,7 +997,9 @@ int ssh_options_allow_ssh2(ssh_options opt, int allow) {
  *
  * @param opt           The options structure to use.
  *
- * @param callback      A callback function for the printing.
+ * @param cb      			A callback function for the printing.
+ *
+ * @param userdata			Pointer to user-provided data
  *
  * @return 0 on success, < 0 on error.
  *

libssh/string.c

@@ -96,7 +96,7 @@ struct ssh_string_struct *string_from_char(const char *what) {
 
 /**
  * \brief returns the size of a SSH string
- * \param str the input SSH string
+ * \param s the input SSH string
  * \return size of the content of str, 0 on error
  */
 size_t string_len(struct ssh_string_struct *s) {
@@ -109,7 +109,7 @@ size_t string_len(struct ssh_string_struct *s) {
 
 /**
  * \brief convert a SSH string to a C nul-terminated string
- * \param str the input SSH string
+ * \param s the input SSH string
  * \return a malloc'ed string pointer.
  * \warning If the input SSH string contains zeroes, some parts of
  * the output string may not be readable with regular libc functions.