From 6a07e67e57de343bf415857e53172417ad08917f Mon Sep 17 00:00:00 2001 From: Takashi Sakamoto Date: Wed, 22 Apr 2020 12:07:32 +0900 Subject: [PATCH] seq: event_data_queue/queue_tempo: improve annotation for skew methods Signed-off-by: Takashi Sakamoto --- src/seq/event-data-queue.c | 14 ++++++++------ src/seq/queue-tempo.c | 4 ++-- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/src/seq/event-data-queue.c b/src/seq/event-data-queue.c index 4a0adc6..48fa015 100644 --- 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 0d251b9..2c45daf 100644 --- 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]) { -- 2.47.3