silence -Wdocumentation warnings

src/bindings/fluid_filerenderer.c

@@ -288,10 +288,10 @@ new_fluid_file_renderer(fluid_synth_t* synth)
  * @since 1.1.7
  */
 int
-fluid_file_set_encoding_quality(fluid_file_renderer_t* r, double q)
+fluid_file_set_encoding_quality(fluid_file_renderer_t* dev, double q)
 {
 #if LIBSNDFILE_SUPPORT
-	if (sf_command (r->sndfile, SFC_SET_VBR_ENCODING_QUALITY, &q, sizeof (double)) == SF_TRUE)
+	if (sf_command (dev->sndfile, SFC_SET_VBR_ENCODING_QUALITY, &q, sizeof (double)) == SF_TRUE)
 		return FLUID_OK;
 	else
 #endif
@@ -453,7 +453,6 @@ fluid_file_renderer_parse_options (char *filetype, char *format, char *endian,
 /**
  * Searches for a supported libsndfile file type by extension.
  * @param extension The extension string
- * @param ext_len Length of the extension string
  * @param type Location to store the type (unmodified if not found)
  * @return TRUE if found, FALSE otherwise
  */

src/midi/fluid_midi.c

@@ -797,7 +797,6 @@ new_fluid_midi_event ()
 /**
  * Delete MIDI event structure.
  * @param evt MIDI event structure
- * @return Always returns #FLUID_OK
  */
 void
 delete_fluid_midi_event(fluid_midi_event_t *evt)
@@ -1259,7 +1258,6 @@ new_fluid_player(fluid_synth_t *synth)
 /**
  * Delete a MIDI player instance.
  * @param player MIDI player instance
- * @return Always returns #FLUID_OK
  */
 void
 delete_fluid_player(fluid_player_t *player)

src/sfloader/fluid_ramsfont.c

@@ -1211,7 +1211,6 @@ new_fluid_ramsample (void)
 /**
  * Delete a RAM SoundFont sample.
  * @param sample Sample to delete
- * @return #FLUID_OK
  */
 void
 delete_fluid_ramsample (fluid_sample_t* sample)

src/synth/fluid_synth.c

@@ -790,7 +790,6 @@ new_fluid_synth(fluid_settings_t *settings)
 /**
  * Delete a FluidSynth instance.
  * @param synth FluidSynth instance to delete
- * @return FLUID_OK
  *
  * @note Other users of a synthesizer instance, such as audio and MIDI drivers,
  * should be deleted prior to freeing the FluidSynth instance.

src/utils/fluid_ringbuffer.h

@@ -46,7 +46,7 @@ void delete_fluid_ringbuffer (fluid_ringbuffer_t *queue);
 /**
  * Get pointer to next input array element in queue.
  * @param queue Lockless queue instance
- * @param count Normally zero, or more if you need to push several items at once
+ * @param offset Normally zero, or more if you need to push several items at once
  * @return Pointer to array element in queue to store data to or NULL if queue is full
  *
  * This function along with fluid_ringbuffer_next_inptr() form a queue "push"