Messages in this thread | | | Date | Mon, 28 Oct 2019 15:44:19 +0100 | From | Takashi Iwai <> | 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
| |