Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

mm: fix page_alloc.c kernel-doc warnings

Fix kernel-doc warnings and function name in mm/page_alloc.c:

Warning(..//mm/page_alloc.c:6074): No description found for parameter 'pfn'
Warning(..//mm/page_alloc.c:6074): No description found for parameter 'mask'
Warning(..//mm/page_alloc.c:6074): Excess function parameter 'start_bitidx' description in 'get_pfnblock_flags_mask'
Warning(..//mm/page_alloc.c:6102): No description found for parameter 'pfn'
Warning(..//mm/page_alloc.c:6102): No description found for parameter 'mask'
Warning(..//mm/page_alloc.c:6102): Excess function parameter 'start_bitidx' description in 'set_pfnblock_flags_mask'

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Mel Gorman <mgorman@suse.de>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

authored by

Randy Dunlap and committed by
Linus Torvalds
1aab4d77 31dab719

+9 -6
+9 -6
mm/page_alloc.c
··· 6062 6062 } 6063 6063 6064 6064 /** 6065 - * get_pageblock_flags_group - Return the requested group of flags for the pageblock_nr_pages block of pages 6065 + * get_pfnblock_flags_mask - Return the requested group of flags for the pageblock_nr_pages block of pages 6066 6066 * @page: The page within the block of interest 6067 - * @start_bitidx: The first bit of interest to retrieve 6068 - * @end_bitidx: The last bit of interest 6069 - * returns pageblock_bits flags 6067 + * @pfn: The target page frame number 6068 + * @end_bitidx: The last bit of interest to retrieve 6069 + * @mask: mask of bits that the caller is interested in 6070 + * 6071 + * Return: pageblock_bits flags 6070 6072 */ 6071 6073 unsigned long get_pfnblock_flags_mask(struct page *page, unsigned long pfn, 6072 6074 unsigned long end_bitidx, ··· 6093 6091 /** 6094 6092 * set_pfnblock_flags_mask - Set the requested group of flags for a pageblock_nr_pages block of pages 6095 6093 * @page: The page within the block of interest 6096 - * @start_bitidx: The first bit of interest 6097 - * @end_bitidx: The last bit of interest 6098 6094 * @flags: The flags to set 6095 + * @pfn: The target page frame number 6096 + * @end_bitidx: The last bit of interest 6097 + * @mask: mask of bits that the caller is interested in 6099 6098 */ 6100 6099 void set_pfnblock_flags_mask(struct page *page, unsigned long flags, 6101 6100 unsigned long pfn,