From: Takashi Sakamoto Date: Sat, 12 Jul 2025 12:24:18 +0000 (+0900) Subject: timer: optimize to gi-docgen 2024.1 or later, approximately X-Git-Tag: v0.3.1~1 X-Git-Url: https://git.alsa-project.org/?a=commitdiff_plain;h=fd5ec7b1915435ec669d40bebda5df6ab811043c;p=alsa-gobject.git timer: optimize to gi-docgen 2024.1 or later, approximately As long as building with gi-docgen 2025.3.1 in Ubuntu 25.04, some annotations for SlaveClass become invalid and causes some warnings. /usr/bin/gi-docgen generate --no-namespace-dir --config=doc/timer/alsatimer.toml --output-dir=doc/timer/alsatimer --content-dir=/home/mocchi/git/alsa-project.org/alsa-gobject/doc/timer src/timer/ALSATimer-0.0.gir WARNING: Unknown namespace SlaveClass slave_id. If the slave_class is [enum@SlaveClass.APPLICATION], the slave_id is for the PID of ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~ WARNING: Unknown namespace SlaveClass [enum@SlaveClass.SEQUENCER], the slave_id is the numeric ID of queue bound for timer device. ^~~~~~~~~~~~~~~~~~~~~~~~~~~ WARNING: Unknown namespace SlaveClass slave_id. If the slave_class is [enum@SlaveClass.APPLICATION], the slave_id is for the PID of ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~ WARNING: Unknown namespace SlaveClass [enum@SlaveClass.SEQUENCER], the slave_id is the numeric ID of queue bound for timer device. ^~~~~~~~~~~~~~~~~~~~~~~~~~~ WARNING: Unknown namespace SlaveClass slave_id. If the slave_class is [enum@SlaveClass.APPLICATION], the slave_id is for the PID of ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~ WARNING: Unknown namespace SlaveClass [enum@SlaveClass.SEQUENCER], the slave_id is the numeric ID of queue bound for timer device. ^~~~~~~~~~~~~~~~~~~~~~~~~~~ This commit suppresses the warnings by using the pattern of enum@class. Signed-off-by: Takashi Sakamoto --- diff --git a/src/timer/user-instance.c b/src/timer/user-instance.c index 6e2c737..35ad3e9 100644 --- a/src/timer/user-instance.c +++ b/src/timer/user-instance.c @@ -332,9 +332,9 @@ gboolean alsatimer_user_instance_attach(ALSATimerUserInstance *self, ALSATimerDe * @error: A [struct@GLib.Error]. Error is generated with domain of `ALSATimer.UserInstanceError`. * * Attach the instance as an slave to another instance indicated by a pair of slave_class and - * slave_id. If the slave_class is [enum@SlaveClass:APPLICATION], the slave_id is for the PID of + * slave_id. If the slave_class is [enum@SlaveClass].APPLICATION, the slave_id is for the PID of * application process which owns the instance of timer. If the slave_class is - * [enum@SlaveClass:SEQUENCER], the slave_id is the numeric ID of queue bound for timer device. + * [enum@SlaveClass].SEQUENCER, the slave_id is the numeric ID of queue bound for timer device. * * The call of function executes `ioctl(2)` system call with `SNDRV_TIMER_IOCTL_SELECT` command * for ALSA timer character device.