fix warnings regarding mismatched parameter docs

3 files changed, 11 insertions, 12 deletions

diff --git a/src/libmtp.c b/src/libmtp.c
index bbd0e4c..2e72dd6 100644
--- a/src/libmtp.c
+++ b/src/libmtp.c
@@ -3190,7 +3190,7 @@ static int get_suggested_storage_id(LIBMTP_mtpdevice_t *device,
  * device storage list.
  * @param device a pointer to the MTP device to free the storage
  * list for.
- * @param storageid the storage ID for the storage to flush and
+ * @param storage a pointer to the storage to flush and
  * get free space for.
  * @param freespace the free space on this storage will be returned
  * in this variable.
@@ -3871,7 +3871,7 @@ int LIBMTP_Set_Syncpartner(LIBMTP_mtpdevice_t *device,
  * if it's too big.
  * @param device a pointer to the device.
  * @param filesize the size of the file to check whether it will fit.
- * @param storageid the ID of the storage to try to fit the file on.
+ * @param storage a pointer to the storage to try to fit the file on.
  * @return 0 if the file fits, any other value means failure.
  */
 static int check_if_file_fits(LIBMTP_mtpdevice_t *device,
@@ -4880,7 +4880,6 @@ static void pick_property_to_track_metadata(LIBMTP_mtpdevice_t *device, MTPPrope
  * This function retrieves the track metadata for a track
  * given by a unique ID.
  * @param device a pointer to the device to get the track metadata off.
- * @param trackid the unique ID of the track.
  * @param objectformat the object format of this track, so we know what it supports.
  * @param track a metadata set to fill in.
  */
@@ -5687,8 +5686,8 @@ int LIBMTP_Send_Track_From_File(LIBMTP_mtpdevice_t *device,
 
 /**
  * This helper function checks if a filename already exists on the device
- * @param PTPParams*
- * @param string representing the filename
+ * @param params the PTP params to check against
+ * @param filename a string representing the filename
  * @return 0 if the filename doesn't exist, -1 if it does
  */
 static int check_filename_exists(PTPParams* params, char const * const filename)
@@ -5708,7 +5707,8 @@ static int check_filename_exists(PTPParams* params, char const * const filename)
 
 /**
  * This helper function returns a unique filename, with a random string before the extension
- * @param string representing the original filename
+ * @param params the PTP params to check against
+ * @param filename string representing the original filename
  * @return a string representing the unique filename
  */
 static char *generate_unique_filename(PTPParams* params, char const * const filename)
@@ -9035,7 +9035,7 @@ int LIBMTP_Get_Representative_Sample_Format(LIBMTP_mtpdevice_t *device,
  * maximum size, dimensions, etc..
  * @param device a pointer to the device which the object is on.
  * @param id unique id of the object to set artwork for.
- * @param pointer to LIBMTP_filesampledata_t struct containing data
+ * @param sampledata pointer to LIBMTP_filesampledata_t struct containing data
  * @return 0 on success, any other value means failure.
  * @see LIBMTP_Get_Representative_Sample()
  * @see LIBMTP_Get_Representative_Sample_Format()
@@ -9130,7 +9130,7 @@ int LIBMTP_Send_Representative_Sample(LIBMTP_mtpdevice_t *device,
  * if the device supports it.
  * @param device a pointer to the device which the object is on.
  * @param id unique id of the object to get data for.
- * @param pointer to LIBMTP_filesampledata_t struct to receive data
+ * @param sampledata pointer to LIBMTP_filesampledata_t struct to receive data
  * @return 0 on success, any other value means failure.
  * @see LIBMTP_Send_Representative_Sample()
  * @see LIBMTP_Get_Representative_Sample_Format()
diff --git a/src/libusb1-glue.c b/src/libusb1-glue.c
index 6cda999..46a09c9 100644
--- a/src/libusb1-glue.c
+++ b/src/libusb1-glue.c
@@ -209,7 +209,6 @@ static mtpdevice_list_t *append_to_mtpdevice_list(mtpdevice_list_t *devlist,
  * of USB MTP devices
  * @param devlist dynamic linked list of pointers to usb devices with MTP
  * properties.
- * @return nothing
  */
 static void free_mtpdevice_list(mtpdevice_list_t *devlist)
 {
diff --git a/src/playlist-spl.c b/src/playlist-spl.c
index 9b591bd..a3eb80e 100644
--- a/src/playlist-spl.c
+++ b/src/playlist-spl.c
@@ -256,7 +256,7 @@ int playlist_t_to_spl(LIBMTP_mtpdevice_t *device,
  * ignored.
  *
  * @param device mtp device pointer
- * @param new the LIBMTP_playlist_t to convert (pl->playlist_id will be updated
+ * @param newlist the LIBMTP_playlist_t to convert (pl->playlist_id will be updated
  *           with the newly created object's id)
  * @return 0 on success, any other value means failure.
  */
@@ -555,7 +555,7 @@ static uint32_t trackno_spl_text_t(text_t* p) {
  *               enough to accomodate all the tracks as reported by
  *               trackno_spl_text_t()
  * @param folders the folders list for the device
- * @param fiels the files list for the device
+ * @param files the files list for the device
  * @see spl_to_playlist_t()
  */
 static void tracks_from_spl_text_t(text_t* p,
@@ -582,7 +582,7 @@ static void tracks_from_spl_text_t(text_t* p,
  * @param p the text to search
  * @param tracks list of track id's to look up
  * @param folders the folders list for the device
- * @param fiels the files list for the device
+ * @param files the files list for the device
  * @see playlist_t_to_spl()
  */
 static void spl_text_t_from_tracks(text_t** p,