> On Thu, Nov 26, 2020 at 05:44:28PM +1100, Stephen Rothwell wrote:
> > Hi all,
> >
> > After merging the rcu tree, today's linux-next build (htmldocs) produced
> > these warnings:
> >
> > include/linux/rcupdate.h:872: warning: Excess function parameter 'ptr' description in 'kfree_rcu'
> > include/linux/rcupdate.h:872: warning: Excess function parameter 'rhf' description in 'kfree_rcu'
> >
> > Introduced by commit
> >
> > beba8bdf2f16 ("rcu: Introduce kfree_rcu() single-argument macro")
>
> Heh! The documentation isn't dealing at all well with this situation.
>
> Would one of the docbook experts have some advice, keeping in mind
> that kfree_rcu might have either one or two arguments?
>
Indeed. The question is if the docbook is capable of describing such
macro usage, 1 or 2 args.
--
Vlad Rezki
