[PATCH] filemap: fix htmldoc warning for mapping_align_index()

[PATCH] filemap: fix htmldoc warning for mapping_align_index()

[Pankaj Raghav (Samsung)]

From: Pankaj Raghav <p.raghav@samsung.com>

Stephen reported that there is a kernel build warning due to a missing
description of a parameter in mapping_align_index().

Add the missing index parameter in the comment description.

Signed-off-by: Pankaj Raghav <p.raghav@samsung.com>
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Fixes: c104d25f8c49 ("filemap: allocate mapping_min_order folios in the page cache")
---
This applies to the vfs.blocksize branch on the vfs tree.

 include/linux/pagemap.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/include/linux/pagemap.h b/include/linux/pagemap.h
index 55b254d951da..6c0dde447c98 100644
--- a/include/linux/pagemap.h
+++ b/include/linux/pagemap.h
@@ -470,6 +470,7 @@ mapping_min_folio_nrpages(struct address_space *mapping)
 /**
  * mapping_align_index() - Align index for this mapping.
  * @mapping: The address_space.
+ * @index: The page index.
  *
  * The index of a folio must be naturally aligned.  If you are adding a
  * new folio to the page cache and need to know what index to give it,
-- 
2.44.1

Re: [PATCH] filemap: fix htmldoc warning for mapping_align_index()

[Christian Brauner]

On Tue, 27 Aug 2024 10:42:07 +0200, Pankaj Raghav (Samsung) wrote:
> Stephen reported that there is a kernel build warning due to a missing
> description of a parameter in mapping_align_index().
> 
> Add the missing index parameter in the comment description.
> 
> 

Applied to the vfs.blocksize branch of the vfs/vfs.git tree.
Patches in the vfs.blocksize branch should appear in linux-next soon.

Please report any outstanding bugs that were missed during review in a
new review to the original patch series allowing us to drop it.

It's encouraged to provide Acked-bys and Reviewed-bys even though the
patch has now been applied. If possible patch trailers will be updated.

Note that commit hashes shown below are subject to change due to rebase,
trailer updates or similar. If in doubt, please check the listed branch.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs.git
branch: vfs.blocksize

[1/1] filemap: fix htmldoc warning for mapping_align_index()
      https://git.kernel.org/vfs/vfs/c/18b184171112