From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 630E4E7719F for ; Mon, 13 Jan 2025 09:21:29 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EE16C6B0089; Mon, 13 Jan 2025 04:21:28 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id E91DE6B008A; Mon, 13 Jan 2025 04:21:28 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D0BFD6B008C; Mon, 13 Jan 2025 04:21:28 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id B36736B0089 for ; Mon, 13 Jan 2025 04:21:28 -0500 (EST) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 5F98BC1A87 for ; Mon, 13 Jan 2025 09:21:28 +0000 (UTC) X-FDA: 83001885456.19.35BCC3C Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.223.130]) by imf20.hostedemail.com (Postfix) with ESMTP id 181471C0010 for ; Mon, 13 Jan 2025 09:21:25 +0000 (UTC) Authentication-Results: imf20.hostedemail.com; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=dkIIlKgW; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=ZLmiMPZb; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=dkIIlKgW; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=ZLmiMPZb; dmarc=none; spf=pass (imf20.hostedemail.com: domain of vbabka@suse.cz designates 195.135.223.130 as permitted sender) smtp.mailfrom=vbabka@suse.cz ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1736760086; a=rsa-sha256; cv=none; b=AyMM2RFUEhAMJ+LajYPXw61iUymdrYRRVmYALPEqo4RLcrZroFvSpwAk29GzsphP3ZcJLr v6Uv6K9PH6rB1vpmVebLH5SgE6YusjbfKdsFur1gwIbnykIU+xSxjhNgyOrDqYtOuXiZfp SFSoQz3o6cvKzpP+8he4Uu7nJGghTtI= ARC-Authentication-Results: i=1; imf20.hostedemail.com; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=dkIIlKgW; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=ZLmiMPZb; dkim=pass header.d=suse.cz header.s=susede2_rsa header.b=dkIIlKgW; dkim=pass header.d=suse.cz header.s=susede2_ed25519 header.b=ZLmiMPZb; dmarc=none; spf=pass (imf20.hostedemail.com: domain of vbabka@suse.cz designates 195.135.223.130 as permitted sender) smtp.mailfrom=vbabka@suse.cz ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1736760086; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=mwnPcD0/eLqVo0aHRY7W36i/ufx/oFILngl/hhckU5I=; b=56rk+aso/gIZjUN3UzNQ7LZgeQWzdSsgLLz22Z0TFi8mGqRUqIuDKz3OOX0TnJP1I1cb65 AHCDxz1CbxM7qIngBAp5Y3WZeTwSJwXZnm9zmaCYsrTNUw7kvG+HjYZN0wNSXLnoMOCjIb ckJaItehu5pLhXowiMppuUH1rGl3KHU= Received: from imap1.dmz-prg2.suse.org (unknown [10.150.64.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id B70A421167; Mon, 13 Jan 2025 09:21:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1736760084; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:autocrypt:autocrypt; bh=mwnPcD0/eLqVo0aHRY7W36i/ufx/oFILngl/hhckU5I=; b=dkIIlKgWRxSHagnla7LPhmeraR+AChBBltM/rMC/1MUES9oxlnErapQ26FJyIE3wVLm8/J U+D2Wi8EKIeBG3Iy5GtAzdDYf/SjiJjypqGvC5Ab4HGrVcCEVoclSg3N7woekO5x/KgloH /2zLprV5GnXKcq/gZOQNkUmM+pZYV4Y= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1736760084; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:autocrypt:autocrypt; bh=mwnPcD0/eLqVo0aHRY7W36i/ufx/oFILngl/hhckU5I=; b=ZLmiMPZbDl3BjQCrbhELKxvHmS/TJ18+Zk6UWIwtBwJ4vfYyrYR/XCpZcbhfXjzRIbBgF3 PJSXZavZ1YHQ+IBQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1736760084; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:autocrypt:autocrypt; bh=mwnPcD0/eLqVo0aHRY7W36i/ufx/oFILngl/hhckU5I=; b=dkIIlKgWRxSHagnla7LPhmeraR+AChBBltM/rMC/1MUES9oxlnErapQ26FJyIE3wVLm8/J U+D2Wi8EKIeBG3Iy5GtAzdDYf/SjiJjypqGvC5Ab4HGrVcCEVoclSg3N7woekO5x/KgloH /2zLprV5GnXKcq/gZOQNkUmM+pZYV4Y= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1736760084; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:autocrypt:autocrypt; bh=mwnPcD0/eLqVo0aHRY7W36i/ufx/oFILngl/hhckU5I=; b=ZLmiMPZbDl3BjQCrbhELKxvHmS/TJ18+Zk6UWIwtBwJ4vfYyrYR/XCpZcbhfXjzRIbBgF3 PJSXZavZ1YHQ+IBQ== Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id A39F713876; Mon, 13 Jan 2025 09:21:24 +0000 (UTC) Received: from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167]) by imap1.dmz-prg2.suse.org with ESMTPSA id /MExJhTbhGcyVAAAD6G6ig (envelope-from ); Mon, 13 Jan 2025 09:21:24 +0000 Message-ID: Date: Mon, 13 Jan 2025 10:21:24 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] mm/slab: fix kernel-doc func param names Content-Language: en-US To: Randy Dunlap , linux-mm@kvack.org Cc: Christoph Lameter , Pekka Enberg , David Rientjes , Joonsoo Kim , Andrew Morton References: <20250111063257.910991-1-rdunlap@infradead.org> <839258c6-58e3-48e9-9791-0f4ab3ec2fb3@suse.cz> <172cd677-f212-4eff-941d-627e9596918c@infradead.org> From: Vlastimil Babka Autocrypt: addr=vbabka@suse.cz; keydata= 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 EP+ylKVEKb0Q2A== In-Reply-To: <172cd677-f212-4eff-941d-627e9596918c@infradead.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Stat-Signature: 3zndpf57b7ddrz3ay7rw3d58y5qwynd3 X-Rspam-User: X-Rspamd-Queue-Id: 181471C0010 X-Rspamd-Server: rspam08 X-HE-Tag: 1736760085-494140 X-HE-Meta: U2FsdGVkX19FiAjC6pK7VPl9idvp2xcmELUSQJx1j+YJBGhX/5zyk9d9iHbpHGQ01krilLMQUuhPYl00djmZfnCC+7+xcVQPB6lf1+d2iarfBKfT+qquGE/8XgLQnnOqy1RvqZMUwXkBiwgC/86F/BCt4JXvYbddN8pnblRpHv9/nSy1IE7K5L2YNE3lkKF8gnFXSuRr3K+jPoOZcn0sCnVkGoCHLwWVmP9A7s13vhHzgEdKYmoyrs1XaX0sLDII158/itb3N/sYDj1U5bEQW/gLWxp1RfNjRRobJOblZTEMTvKZKBuMvNeRWLnazL2Heswej7Y9ghZPzFGrZXmHLNOk+dkSxyCqbryfaLVpiDdQQWarf42lrHwS3Pw7GU+556qHY8uvgfecftfRNTMpxZT/o5qeIvFbcbFetpRoEDOObo4KOuwk9mBOW5fwLclCg5DHOFRxNMzytxizkMNPO0r4fVHaYl9gbnBbiLjHGJwf7uqex0BYW6q9YkOtt0ApPRnxKp7J4lEm88SQpNSz8a9D4nChQfoebufJQgdjhKOZKEN8erPxQL5FAD/+C8UKyCX8gwD9kcRPw3HNlqLtY/fNxVmASa8Fc0X4+a78hQvF/iq+/y1GqdfED3WDcy/P6TZw7J5yAFMsE5KH7ZSfMb5eb6hJsIWo+zmAElgHz0rrXCylGAbmt+LoFP5MBNMbFgxKq+5jEKd1Ti2WvkxNtkJ03ABUjykvLZw4mEfB3PjOrRBd2gd4nxti+kTTKA0/nuUMxYlersbrBK7DHYfFMd+vqTMydmmHlzcsLORGyTyI9MebPsRhaJy/c92VgWym/juEfRY3CDcCi5aN4kzQaLlprjWTSX59/vQpNk0sCoENawmbp1RAfSnmPQMDjW1rXkZsLxP6rbAXorKtfbHYPRyZonaRpcTSxf1cX/jK1g1pkNqMU/mviQjqb74VF8fYRr5xmAqKlncHI2S3g+8 7eZTrwRh xSGNUw2lqiMatBkkoP/0zSgRFeYFDID6ulLTPYpqDstkE3U3gylyh8PRkEvhtryXIA5FlKswH39Q4x4YOjWOEE0nnfC5nj/WBeMCNp1jKl/mWP3ZTn6ipx9DmaI0c1AsCn81Zd7r3wM6u+LgO/NU5sGB/UD7eF2rQ3K4U94A02H5d6QQsHR8ev4Qn98fdf+KeZHs0bFe4ws10P04t255i6kA+2fGBKyEwkV3Uf6smefZLtCLEzLqWEOnXypOCwIoeqWGfvdod1135J+Jnw0T4K65WAdFRSUo7WCk98rtUxNb2UtHMCv73zbA1AE5E7uLMxpKpydSy4onJA7q/jmO1OFXIih8nKAf8FR66Kq+WStqoT/UD9tjSq/bSgujSMnTWjtYQDvdxK7Sld7gMsbSuxuqF7CesXc4Md2iIClApwz1thaIPz2H+6SWs20kcOsP0fQdHZb/g8i8qnZ0hoKiYz1/Pmo2knnjLWwoQ7VM5bX/jWO6HbrrQeps+cNVIOcgyeoPAzT3Mymg9HcGVPJxRlf1VWw== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: On 1/11/25 21:24, Randy Dunlap wrote: > Hi, > > On 1/11/25 12:12 PM, Vlastimil Babka wrote: >> On 1/11/25 07:32, Randy Dunlap wrote: >>> Use corrected function parameter names to eliminate kernel-doc >>> warnings: >>> >>> slab.h:142: warning: Function parameter or struct member 's' not described in 'slab_folio' >>> slab.h:142: warning: Excess function parameter 'slab' description in 'slab_folio' >>> slab.h:168: warning: Function parameter or struct member 's' not described in 'slab_page' >>> slab.h:168: warning: Excess function parameter 'slab' description in 'slab_page' >> >> I'm unable to get those warnings with "make htmldocs", what exactly do I >> need to run? >> >>> Signed-off-by: Randy Dunlap >>> Cc: Christoph Lameter >>> Cc: Pekka Enberg >>> Cc: David Rientjes >>> Cc: Joonsoo Kim >>> Cc: Andrew Morton >>> Cc: Vlastimil Babka >> >> Anyway the problem and fix seem obvious, so applied. Thanks! > > Oops. I should have said something like with 'make W=1' or if > just running scripts/kernel-doc, use -Wall. Thanks, I forgot it's the normal build "make" and not "make htmldocs" (which I've been attempting with W=1) that will produce the warning. Because slab.h is likely not listed for inclusions into the htmldocs. > Sorry.