Re: [PATCH v2 3/3] drivers: add deprecated remarks to strlcat()
Geert Uytterhoeven <[email protected]>
| Newsgroups | org.kernel.vger.workflows,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <CAMuHMdWZ-WuD6Sq1BMS5eGm+xLm1Kr+C+AtkXmFjfkhk30SWZQ@mail.gmail.com> |
Hi David, On Fri, 15 May 2026 at 11:31, David Laight <[email protected]> wrote: > On Fri, 15 May 2026 09:32:06 +0200 > Geert Uytterhoeven <[email protected]> wrote: > > On Fri, 15 May 2026 at 09:31, Andy Shevchenko <[email protected]> wrote: > > > On Fri, May 15, 2026 at 10:23 AM Geert Uytterhoeven > > > <[email protected]> wrote: > > > > On Thu, 14 May 2026 at 18:32, Manuel Ebner <[email protected]> wrote: > > > > > add kernel-doc comment to strlcat() function definitions > > > > > > ... > > > > > > > > +/** > > > > > + * strlcat - Append a string to an existing string > > > > > + * > > > > > + * @dest: pointer to %NUL-terminated string to append to > > > > > + * @src: pointer to %NUL-terminated string to append from > > > > > + * @count: Maximum bytes available in @dest > > > > > + * > > > > > > > > Missing "Returns ...". > > > > > > Documentation says "Return:" as > > > - the section (note important colon) > > > - the singular (however plural is undocumented and supported) > > > > Trailing "s" is not always plural in English ;-) > > It is for 'Return' :-) In case "returns" is a shorthand for "return values", it indeed is ;-) I meant a conjugation of the verb "to return". Gr{oetje,eeting}s, Geert -- Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- [email protected] In personal conversations with technical people, I call myself a hacker. But when I'm talking to journalists I just say "programmer" or something like that. -- Linus Torvalds