seq: event_data_queue/event_fixed: improve annotations for quadlets 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 0c19f0ef653e83b8186e8fa56cdce5b3890e3b3d..19e1164ad4d975d7cc4d5b9d060e459150cdc5fb 100644 (file)
--- a/src/seq/event-data-queue.c
+++ b/src/seq/event-data-queue.c
@@ -150,10 +150,10 @@ void alsaseq_event_data_queue_set_skew_param(ALSASeqEventDataQueue *self,
 /**
  * alsaseq_event_data_queue_get_quadlet_param:
  * @self: A #ALSASeqEventDataQueue.
- * @quadlets: (array fixed-size=2)(out)(transfer none): Two quadlets as param of
- *            the queue event.
+ * @quadlets: (array fixed-size=2)(out)(transfer none): The array with two
+ *            elements for quadlets as the parameter of queue event.
  *
- * Get two quadlets as param of the queue event.
+ * Refer to two quadlets as the parameter of queue event.
  */
 void alsaseq_event_data_queue_get_quadlet_param(ALSASeqEventDataQueue *self,
                                                 const guint32 *quadlets[2])
@@ -164,10 +164,10 @@ void alsaseq_event_data_queue_get_quadlet_param(ALSASeqEventDataQueue *self,
 /**
  * alsaseq_event_data_queue_set_quadlet_param:
  * @self: A #ALSASeqEventDataQueue.
- * @quadlets: (array fixed-size=2)(transfer none): Two quadlets as param of the
- *            queue event.
+ * @quadlets: (array fixed-size=2)(transfer none): The array with two elements
+ *            for quadlets as the parameter of queue event.
  *
- * Set two quadlets as param of the queue event.
+ * Set two quadlets from the given buffer as the parameter of queue event.
  */
 void alsaseq_event_data_queue_set_quadlet_param(ALSASeqEventDataQueue *self,
                                                 const guint32 quadlets[2])

diff --git a/src/seq/event-fixed.c b/src/seq/event-fixed.c
index 9ca2fe78a9bf3a1c3db7392b61b0c8a0c4d8f62d..92c81c676ae1d7687fb7c48a344dc9ed22f90632 100644 (file)
--- a/src/seq/event-fixed.c
+++ b/src/seq/event-fixed.c
@@ -260,11 +260,10 @@ void alsaseq_event_fixed_set_byte_data(ALSASeqEventFixed *self,
 /**
  * alsaseq_event_fixed_get_quadlet_data:
  * @self: A #ALSASeqEventFixed.
- * @quadlets: (array fixed-size=3)(out)(transfer none): The 3 quadlet data for
- *            the event. The lifetime of the object is the same as the event
- *            itself.
+ * @quadlets: (array fixed-size=3)(out)(transfer none): The array with three
+ *            elements for quadlets as the data of event.
  *
- * Get the 3 quadlet data for the event.
+ * Refer to three quadlet as the data of event.
  */
 void alsaseq_event_fixed_get_quadlet_data(ALSASeqEventFixed *self,
                                           const guint32 *quadlets[3])
@@ -282,10 +281,10 @@ void alsaseq_event_fixed_get_quadlet_data(ALSASeqEventFixed *self,
 /**
  * alsaseq_event_fixed_set_quadlet_data:
  * @self: A #ALSASeqEventFixed.
- * @quadlets: (array fixed-size=3)(transfer none): The 3 quadlet data for the
- *            event.
+ * @quadlets: (array fixed-size=3)(transfer none): The array with three elements
+ *            for quadlets for the data of event.
  *
- * Copy the 3 quadlet data for the event.
+ * Copy three quadlets from the given buffer as the data of event.
  */
 void alsaseq_event_fixed_set_quadlet_data(ALSASeqEventFixed *self,
                                           const guint32 quadlets[3])