seq: event_data_queue/queue_tempo: improve annotation for skew methods

Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>

diff --git a/src/seq/event-data-queue.c b/src/seq/event-data-queue.c
index 4a0adc6b5444d2b0290d6a8f1ec389096a712e3f..48fa015c712610d4f91a00f9f0c40b37568e9410 100644 (file)
--- a/src/seq/event-data-queue.c
+++ b/src/seq/event-data-queue.c
@@ -117,10 +117,11 @@ void alsaseq_event_data_queue_set_position_param(ALSASeqEventDataQueue *self,
 /**
  * alsaseq_event_data_queue_get_skew_param:
  * @self: A #ALSASeqEventDataQueue.
- * @skew: (array fixed-size=2)(out)(transfer none): The skew as param of the
- *        queue event. The first element is for 'value' and another is for 'base'.
+ * @skew: (array fixed-size=2)(out)(transfer none): The array with two elements
+ *        for numerator and denominator of fraction for skew.
  *
- * Get the skew as param of the queue event.
+ * Refer to numerator and denominator of fraction for skew as the parameter of
+ * queue event.
  */
 void alsaseq_event_data_queue_get_skew_param(ALSASeqEventDataQueue *self,
                                              const guint *skew[2])
@@ -133,10 +134,11 @@ void alsaseq_event_data_queue_get_skew_param(ALSASeqEventDataQueue *self,
 /**
  * alsaseq_event_data_queue_set_skew_param:
  * @self: A #ALSASeqEventDataQueue.
- * @skew: (array fixed-size=2)(transfer none): the skew as param of the queue
- *        event. The first element is for 'value' and another is for 'base'.
+ * @skew: (array fixed-size=2)(transfer none): The array with two elements for
+ *        numerator and denominator of fraction for skew.
  *
- * Set the skew as param of the queue event.
+ * Copy numerator and denominator of fraction for skew from the given buffer as
+ * the parameter of queue event.
  */
 void alsaseq_event_data_queue_set_skew_param(ALSASeqEventDataQueue *self,
                                              const guint skew[2])

diff --git a/src/seq/queue-tempo.c b/src/seq/queue-tempo.c
index 0d251b921790331220ba01b7b592b74b917586ef..2c45daf9fd2f5273093a65e536ebfb5cc6171c7b 100644 (file)
--- a/src/seq/queue-tempo.c
+++ b/src/seq/queue-tempo.c
@@ -117,7 +117,7 @@ ALSASeqQueueTempo *alsaseq_queue_tempo_new()
  * @skew: (array fixed-size=2)(out)(transfer none): The array with two elements
  *        for numerator and denominator of fraction for skew.
  *
- * Refer to numerator and denominator of skew.
+ * Refer to numerator and denominator of fraction for skew.
  */
 void alsaseq_queue_tempo_get_skew(ALSASeqQueueTempo *self, const guint32 *skew[2])
 {
@@ -138,7 +138,7 @@ void alsaseq_queue_tempo_get_skew(ALSASeqQueueTempo *self, const guint32 *skew[2
  * @skew: (array fixed-size=2)(transfer none): The array with two elements for
  *        numerator and denominator of fraction for skew.
  *
- * Copy numerator and denominator of skew.
+ * Copy numerator and denominator of fraction for skew.
  */
 void alsaseq_queue_tempo_set_skew(ALSASeqQueueTempo *self, const guint32 skew[2])
 {