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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.