Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-26 Thread Peter Zijlstra
On Mon, Oct 26, 2020 at 10:16:20AM +0100, Mauro Carvalho Chehab wrote: > Em Mon, 26 Oct 2020 09:10:59 +0100 > Peter Zijlstra escreveu: > > > On Sat, Oct 24, 2020 at 08:28:27AM +0200, Mauro Carvalho Chehab wrote: > > > If the intent is to document the struct and its internal fields, > > > this ker

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-26 Thread Mauro Carvalho Chehab
Em Mon, 26 Oct 2020 09:10:59 +0100 Peter Zijlstra escreveu: > On Sat, Oct 24, 2020 at 08:28:27AM +0200, Mauro Carvalho Chehab wrote: > > If the intent is to document the struct and its internal fields, > > this kernel-doc should work: > > > > /** > > * struct refcount_struct - variant o

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-26 Thread Peter Zijlstra
On Sat, Oct 24, 2020 at 08:28:27AM +0200, Mauro Carvalho Chehab wrote: > If the intent is to document the struct and its internal fields, > this kernel-doc should work: > > /** >* struct refcount_struct - variant of atomic_t specialized for > reference counts >* @refs: atomi

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-23 Thread Mauro Carvalho Chehab
Em Fri, 23 Oct 2020 13:47:57 -0600 Jonathan Corbet escreveu: > On Fri, 23 Oct 2020 21:39:07 +0200 > Peter Zijlstra wrote: > > > > > /** > > > > - * struct refcount_t - variant of atomic_t specialized for reference > > > > counts > > > > + * struct refcount_struct - variant of atomic_t special

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-23 Thread Jonathan Corbet
On Fri, 23 Oct 2020 21:39:07 +0200 Peter Zijlstra wrote: > > > /** > > > - * struct refcount_t - variant of atomic_t specialized for reference > > > counts > > > + * struct refcount_struct - variant of atomic_t specialized for > > > reference counts > > > > Hm, this is a weird one. Yes, it'

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-23 Thread Peter Zijlstra
On Fri, Oct 23, 2020 at 10:40:09AM -0700, Kees Cook wrote: > On Fri, Oct 23, 2020 at 06:33:36PM +0200, Mauro Carvalho Chehab wrote: > > The documented typedef just after the kernel-doc markup > > is named "refcount_struct". > > > > Signed-off-by: Mauro Carvalho Chehab > > --- > > include/linux/r

Re: [PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-23 Thread Kees Cook
On Fri, Oct 23, 2020 at 06:33:36PM +0200, Mauro Carvalho Chehab wrote: > The documented typedef just after the kernel-doc markup > is named "refcount_struct". > > Signed-off-by: Mauro Carvalho Chehab > --- > include/linux/refcount.h | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > di

[PATCH v3 49/56] refcount.h: fix a kernel-doc markup

2020-10-23 Thread Mauro Carvalho Chehab
The documented typedef just after the kernel-doc markup is named "refcount_struct". Signed-off-by: Mauro Carvalho Chehab --- include/linux/refcount.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/linux/refcount.h b/include/linux/refcount.h index 497990c69b0b..8f431b