Re: [PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-06 Thread Joel Fernandes
On Fri, Oct 04, 2019 at 03:24:39PM -0700, Paul E. McKenney wrote: > On Fri, Oct 04, 2019 at 11:54:02PM +0200, Jonathan Neuschäfer wrote: > > Without this patch, Sphinx shows "variable arguments" as the description > > of the cond argument, rather than the intended description, and prints > > the fo

Re: [PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-05 Thread Paul E. McKenney
On Sat, Oct 05, 2019 at 09:31:23PM +0200, Jonathan Neuschäfer wrote: > On Sat, Oct 05, 2019 at 06:33:30AM -0700, Paul E. McKenney wrote: > > On Sat, Oct 05, 2019 at 01:23:28AM +0200, Jonathan Neuschäfer wrote: > > > On Fri, Oct 04, 2019 at 03:24:39PM -0700, Paul E. McKenney wrote: > > > > On Fri, O

Re: [PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-05 Thread Jonathan Neuschäfer
On Sat, Oct 05, 2019 at 06:33:30AM -0700, Paul E. McKenney wrote: > On Sat, Oct 05, 2019 at 01:23:28AM +0200, Jonathan Neuschäfer wrote: > > On Fri, Oct 04, 2019 at 03:24:39PM -0700, Paul E. McKenney wrote: > > > On Fri, Oct 04, 2019 at 11:54:02PM +0200, Jonathan Neuschäfer wrote: > > > > Without t

Re: [PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-05 Thread Paul E. McKenney
On Sat, Oct 05, 2019 at 01:23:28AM +0200, Jonathan Neuschäfer wrote: > On Fri, Oct 04, 2019 at 03:24:39PM -0700, Paul E. McKenney wrote: > > On Fri, Oct 04, 2019 at 11:54:02PM +0200, Jonathan Neuschäfer wrote: > > > Without this patch, Sphinx shows "variable arguments" as the description > > > of t

Re: [PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-04 Thread Jonathan Neuschäfer
On Fri, Oct 04, 2019 at 03:24:39PM -0700, Paul E. McKenney wrote: > On Fri, Oct 04, 2019 at 11:54:02PM +0200, Jonathan Neuschäfer wrote: > > Without this patch, Sphinx shows "variable arguments" as the description > > of the cond argument, rather than the intended description, and prints > > the fo

Re: [PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-04 Thread Paul E. McKenney
On Fri, Oct 04, 2019 at 11:54:02PM +0200, Jonathan Neuschäfer wrote: > Without this patch, Sphinx shows "variable arguments" as the description > of the cond argument, rather than the intended description, and prints > the following warnings: > > ./include/linux/rculist.h:374: warning: Excess func

[PATCH] rculist: Describe variadic macro argument in a Sphinx-compatible way

2019-10-04 Thread Jonathan Neuschäfer
Without this patch, Sphinx shows "variable arguments" as the description of the cond argument, rather than the intended description, and prints the following warnings: ./include/linux/rculist.h:374: warning: Excess function parameter 'cond' description in 'list_for_each_entry_rcu' ./include/linux