Hi Andy,
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 ;-)
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
