[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <s5hv9s99bgc.wl-tiwai@suse.de>
Date: Mon, 28 Oct 2019 15:44:19 +0100
From: Takashi Iwai <tiwai@...e.de>
To: Markus Elfring <Markus.Elfring@....de>
Cc: Navid Emamdoost <emamd001@....edu>, alsa-devel@...a-project.org,
linux-doc@...r.kernel.org,
Navid Emamdoost <navid.emamdoost@...il.com>,
Kangjie Lu <kjlu@....edu>, Stephen McCamant <smccaman@....edu>,
Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
Richard Fontana <rfontana@...hat.com>,
Thomas Gleixner <tglx@...utronix.de>,
kernel-janitors@...r.kernel.org,
LKML <linux-kernel@...r.kernel.org>
Subject: Re: [alsa-devel] ALSA: korg1212: Checking exception handling in snd_korg1212_create()
On Mon, 28 Oct 2019 15:40:09 +0100,
Markus Elfring wrote:
>
> >> Can the properties of this programming interface be documented also together
> >> with the function declaration for the safer handling of ALSA components?
> >> https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/sound/kernel-api/writing-an-alsa-driver.rst?id=d6d5df1db6e9d7f8f76d2911707f7d5877251b02#n567
> >
> > I can think of only adding some comment at each point mentioning that
> > the resource will be managed by the device destructor.
>
> * Which places will be corresponding update candidates?
At each place where this kind of code is seen.
> * Would you like to choose the wording?
I myself don't mind as long as it's clearly understandable for human
being.
> >> Can any more API information help to improve automatic source code analysis
> >> around similar functions?
> >
> > If anything we can add, let me know.
>
> Will any tags become more helpful also for the software documentation?
It's my question.
thanks,
Takashi
Powered by blists - more mailing lists