Re: [PATCH] Docs/mm: fix documentation warning for GFP parameter in kmalloc_obj, kmalloc_objs and kmalloc_flex

"Vlastimil Babka (SUSE)" <[email protected]> Thu, 25 Jun 2026 11:11:04 +0200
Newsgroups dev.linux.lists.linux-kernel-mentees,org.kernel.vger.linux-kernel,org.kvack.linux-mm
Message-ID <[email protected]>
On 6/25/26 03:48, Andrew Morton wrote:
> On Fri, 19 Jun 2026 13:36:22 +0200 Jakov Novak <[email protected]> wrote:
> 
>> Subject: [PATCH] Docs/mm: fix documentation warning for GFP parameter in kmalloc_obj, kmalloc_objs and kmalloc_flex
> 
> Thanks.
> 
> "mm/slab: ..." would be a better subject.
> 
>> Date: Fri, 19 Jun 2026 13:36:22 +0200
>> X-Mailer: git-send-email 2.54.0
>> 
>> Compiling the documentation currently gives the errors:
>> 
>> WARNING: ./include/linux/slab.h:1100 Excess function parameter 'GFP' description in 'kmalloc_obj'
>> WARNING: ./include/linux/slab.h:1112 Excess function parameter 'GFP' description in 'kmalloc_objs'
>> WARNING: ./include/linux/slab.h:1127 Excess function parameter 'GFP' description in 'kmalloc_flex'
>> WARNING: ./include/linux/slab.h:1100 Excess function parameter 'GFP' description in 'kmalloc_obj'
>> WARNING: ./include/linux/slab.h:1112 Excess function parameter 'GFP' description in 'kmalloc_objs'
>> WARNING: ./include/linux/slab.h:1127 Excess function parameter 'GFP' description in 'kmalloc_flex'
>> 
>> This effectively omits the GFP parameter from the current kernel
>> documentation. This patch marks the "..." parameter with the previous
>> description of the GFP parameter along with an "optional" tag in
>> parantheses.
> 
> "parentheses".
> 
> I'll assume that Vlastimil will be processing this patch.

As Harry pointed out, Randy already fixed this, since then it's in mainline.