Re: [PATCH] mm/folio_batch: document missing struct members

[Lorenzo Stoakes (ARM)]

On Fri, Nov 13, 2026 at 11:17:49AM +0100, David Hildenbrand (Arm) wrote:
> On 11/13/26 05:10, Oscar Alejandro Sánchez Lucero wrote:
> > Add missing kernel-doc descriptions for @nr, @i, @percpu_pvec_drained,
> > and @folios in struct folio_batch to fix warnings.
> >
> > Signed-off-by: Oscar Alejandro Sánchez Lucero <aleszlucero@xxxxxxxxx>
> > ---
> >  include/linux/folio_batch.h | 5 +++++
> >  1 file changed, 5 insertions(+)
> >
> > diff --git a/include/linux/folio_batch.h b/include/linux/folio_batch.h
> > index b45946adc50b..7731dcd249a8 100644
> > --- a/include/linux/folio_batch.h
> > +++ b/include/linux/folio_batch.h
> > @@ -18,6 +18,11 @@ struct folio;
> >
> >  /**
> >   * struct folio_batch - A collection of folios.
> > + * @nr: Number of folios currently in the batch.
> > + * @i: Index of the next folio to process in folio_batch_next().
> > + * @percpu_pvec_drained: Whether the per-CPU deferred LRU queues have already
> > + *                       been drained during __folio_batch_release().
> > + * @folios: Array of pointers to the folios in the batch.
> >   *
> >   * The folio_batch is used to amortise the cost of retrieving and
> >   * operating on a set of folios.  The order of folios in the batch may be
> >
> > ---
> > base-commit: 9d66f26fefacebfeed15de31c1123451a17ff119
> > change-id: 20261112-folio-batch-doc-fa4f7e18ec85
> >
> > Best regards,
>
> Waiting for more review before queuing this.

Dreams do come true ;)

Reviewed-by: Lorenzo Stoakes (ARM) <ljs@xxxxxxxxxx>

>
> Reviewed-by: David Hildenbrand (Arm) <david@xxxxxxxxxx>
>
> --
> Cheers,
>
> David

--
Cheers, Lorenzo