Re: [PATCH v2 3/3] drivers: add deprecated remarks to strlcat()

[David Laight]

On Fri, 15 May 2026 09:32:06 +0200
Geert Uytterhoeven <geert@xxxxxxxxxxxxxx> wrote:

> Hi Andy,
> 
> On Fri, 15 May 2026 at 09:31, Andy Shevchenko <andy.shevchenko@xxxxxxxxx> wrote:
> > On Fri, May 15, 2026 at 10:23 AM Geert Uytterhoeven
> > <geert@xxxxxxxxxxxxxx> wrote:  
> > > On Thu, 14 May 2026 at 18:32, Manuel Ebner <manuelebner@xxxxxxxxxxx> 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' :-)
Most of the exceptions are words taken directly from Latin,
where something that might be a Latin plural is used (who knows what
the Romans actually used).
It many cases the 's' plural is also valid.

-- David

> 
> Gr{oetje,eeting}s,
> 
>                         Geert
>