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

From: David Hildenbrand (Arm)

Date: Fri Nov 13 2026 - 07:33:27 EST


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.

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

--
Cheers,

David