fix doxygen op

git-svn-id: file:///raid/svn-main/kazu-ksynth/trunk@14 7b47e76f-e598-2f43-bc14-414d160cc389

diff --git a/src/ksynth.h b/src/ksynth.h
index b66da327a5afbe638d8a1de804c88025684a8f1f..38a5db35ed0bb9555d667e48d2d2276b035f4da2 100644 (file)
--- a/src/ksynth.h
+++ b/src/ksynth.h
@@ -33,7 +33,7 @@ struct KSynth {
  * @param sample_rate Sample rate
  * @param num_channel Number of channels (1-2)
  * @param max_polyphony Maximum polyphony (1-100,000)
- * @return struct KSynth* A pointer to the newly created KSynth instance on success, NULL on failure.
+ * @return A pointer to the newly created KSynth instance on success, NULL on failure.
  */
 struct KSynth* ksynth_new(const char* sample_file_path, int sample_rate, int num_channel, int max_polyphony);
 
@@ -68,7 +68,7 @@ void ksynth_note_off_all(struct KSynth* ksynth_instance);
  * @brief Gets the current polyphony.
  *
  * @param ksynth_instance Pointer to the KSynth instance
- * @return int The current polyphony
+ * @return The current polyphony
  */
 int ksynth_get_polyphony(struct KSynth* ksynth_instance);
 
@@ -76,17 +76,17 @@ int ksynth_get_polyphony(struct KSynth* ksynth_instance);
  * @brief Gets the maximum polyphony.
  *
  * @param ksynth_instance Pointer to the KSynth instance
- * @return int The maximum polyphony
+ * @return The maximum polyphony
  */
 int ksynth_get_max_polyphony(struct KSynth* ksynth_instance);
 
 /**
  * @brief Sets the maximum polyphony.
- * DO NOT CALL THIS FUNCTION. IT IS NOT WORKING NOW (IT IS RETURNINNG ALWAYS FALSE).
+ * @warning DO NOT CALL THIS FUNCTION. IT IS NOT WORKING NOW (IT IS RETURNINNG ALWAYS FALSE).
  *
  * @param ksynth_instance Pointer to the KSynth instance
  * @param max_polyphony Maximum polyphony (Note: Values exceeding 100,000 will be clamped)
- * @return bool Returns true on success, false on failure.
+ * @return Returns true on success, false on failure.
  */
 bool ksynth_set_max_polyphony(struct KSynth* ksynth_instance, int max_polyphony);
 
@@ -101,7 +101,7 @@ bool ksynth_set_max_polyphony(struct KSynth* ksynth_instance, int max_polyphony)
  *
  * @param ksynth_instance Pointer to the KSynth instance
  * @param buffer_size Size of the buffer (Note: Values are typically between 32 and 16384)
- * @return float* A pointer to the generated buffer on success, NULL on failure.
+ * @return A pointer to the generated buffer on success, NULL on failure.
  */
 float* ksynth_generate_buffer(struct KSynth* ksynth_instance, int buffer_size);
 
@@ -113,7 +113,7 @@ float* ksynth_generate_buffer(struct KSynth* ksynth_instance, int buffer_size);
  * and any longer processing time may result in buffer underrun, leading to audio glitches or gaps.
  *
  * @param ksynth_instance Pointer to the KSynth instance
- * @return float Rendering time as a percentage of the buffer duration (0 to 100%)
+ * @return Rendering time as a percentage of the buffer duration (0 to 100%)
  */
 float ksynth_get_rendering_time(struct KSynth* ksynth_instance);
 
@@ -122,7 +122,7 @@ float ksynth_get_rendering_time(struct KSynth* ksynth_instance);
  *
  * @param ksynth_instance Pointer to the KSynth instance
  * @param channel MIDI channel
- * @return int Number of active polyphony for the specified MIDI channel
+ * @return Number of active polyphony for the specified MIDI channel
  */
 int ksynth_get_polyphony_for_channel(struct KSynth* ksynth_instance, int channel);