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 7A8B1E7719A for ; Sat, 11 Jan 2025 20:25:09 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 0E2916B008C; Sat, 11 Jan 2025 15:25:09 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 093166B0092; Sat, 11 Jan 2025 15:25:09 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id EC46C6B0093; Sat, 11 Jan 2025 15:25:08 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id CCA826B008C for ; Sat, 11 Jan 2025 15:25:08 -0500 (EST) Received: from smtpin12.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 491E11614AD for ; Sat, 11 Jan 2025 20:25:08 +0000 (UTC) X-FDA: 82996300296.12.F4D0AFF Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) by imf08.hostedemail.com (Postfix) with ESMTP id 00D6C160019 for ; Sat, 11 Jan 2025 20:25:04 +0000 (UTC) Authentication-Results: imf08.hostedemail.com; dkim=pass header.d=infradead.org header.s=desiato.20200630 header.b=Dp21yJD4; spf=none (imf08.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.92.199) smtp.mailfrom=rdunlap@infradead.org; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1736627106; 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=xscASvHY31IopnZRnv/dfeqUZAApNb/GRLVn820yI6s=; b=tcnnwJbxcgYcDSMsf0SmrzapayeXhokDalhf2i+PfYU+u5NFmXSI54+pj0KIIzH/xnLNoL CQf9/kgBAHFVHTtnMZVMGTtJDB09+QdXX6I9tabFbL8nxitTxOXThqsqdA/XAxZx232Cs1 3cqT+CLAU0uVuCiN0PvVnXZGGzNtlH0= ARC-Authentication-Results: i=1; imf08.hostedemail.com; dkim=pass header.d=infradead.org header.s=desiato.20200630 header.b=Dp21yJD4; spf=none (imf08.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.92.199) smtp.mailfrom=rdunlap@infradead.org; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1736627106; a=rsa-sha256; cv=none; b=UolhOTxD2Zp6WxvwMggrUn8IIp3Ugr+Ykm8kJRkLq4IeU966Kg/I/s+SA/0oaBwgXJFrcO fCFUHgiX0DnBHHsCbChWYdZpbXhHhUX/mg3oWvUbz/fzbG5Ghi2KsFDnem1yQABJBdbRIj Pyp/Vt5RI5JpFj5UM37e1/ThMEjezzw= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=desiato.20200630; h=Content-Transfer-Encoding:Content-Type :In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date:Message-ID: Sender:Reply-To:Content-ID:Content-Description; bh=xscASvHY31IopnZRnv/dfeqUZAApNb/GRLVn820yI6s=; b=Dp21yJD4dtXlTeCokeItkULhj1 9UWDJyJzQL7v6ghsVdkQ6WAdki0Ws9qRlUKHoQ8F+Wgx20j9zQJ8Bww9yQnUPsiTT5FAFFLnHqX6L hqZfgK8SuEqgFtL+51ymQevXSrsOLLvTtS+ZJ5nJXGVP3ZBZ9d5zNksZ/2Za6JMzV9+7zrXCJzPKI 3uEPF2CVPYiPoyhGWXi4WDB/VITe/qXx+tw9bVuEeDkd/8mOAqTjHKeoQ51L75ppv1RGDz33QJlM0 S3kY2vvKSM85nRp5BrFB46szjWVNIOZfrAuWM+vCNzT2sJGGBV3tM6WPtdPAikxEogyfPoigOCqZU VG4nr46Q==; Received: from [50.53.2.24] (helo=[192.168.254.17]) by desiato.infradead.org with esmtpsa (Exim 4.98 #2 (Red Hat Linux)) id 1tWi1z-0000000A5eM-2PMx; Sat, 11 Jan 2025 20:24:59 +0000 Message-ID: <172cd677-f212-4eff-941d-627e9596918c@infradead.org> Date: Sat, 11 Jan 2025 12:24:23 -0800 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] mm/slab: fix kernel-doc func param names To: Vlastimil Babka , 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> Content-Language: en-US From: Randy Dunlap In-Reply-To: <839258c6-58e3-48e9-9791-0f4ab3ec2fb3@suse.cz> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: 00D6C160019 X-Rspam-User: X-Stat-Signature: trr1m5o9xwa4e4a6kws6c5o89ds7pbwo X-HE-Tag: 1736627104-838063 X-HE-Meta: U2FsdGVkX1+VSdLJ93ocrQF+mdNldpVFAvXmGDvdSN0jTyV/dsulNnOkg2wYqB7BGjyxJtaYBXPZi5PzNFvxtb/I/hb16+iXbNFNWjWztcV3I9nNRpSqw7t/3YTUJuvIQXxdlWUb0zN5t45B2LIltdVsgsd/wyEuZPiq6XhAracD5VcDoVRc4KGPQvT3MtryaLfUcOLUPb1d44mMlzAUrGpz8TmnqQrUUKob51bqyNVMGIPjxfL8+tiUbczDS6ZVJGZ95wr+c/u7gHPsGS/knBWQ3/5/ABNQTFS1ltveZP9egVRLCaa4CSei8VTfL89M/chjWXjzWFDUnGMwwLu2DTICM4J3/KHv7YuJ2cPistNozU8mUkFi2l/FOxw+dlDBtRkRV1aStjBzMm0kkYv1wpn3KDWJ/MC5t9wbrwdqyE1Od1s9WdXPnogTR98j1EM1WR4n43fmXfr1OgDEQqrkKHowH43BRA9nGzQSNeLNzIvllTuU2BmYGWFSnD5C/xiKcrzKr0Rkg8Eme3AF4O8aA9hg/63kfxw6TLfbU5zW/32t+xJoSGzlJYpb9NUEJjyCrP06FOUBNa9Ik9xgLrZZbd7hwYgBUpzN2NgoV4RcipLmIk8bRdnhYm2SazXUgyRXlpyak9A5kcydlj+kIT/sx6cd1Bob7R2mMbs29mRgLT0PboeN6W8JIgEmv9Ad2yP3isLFK9ajS/C2Dl0T7+pmU9S8p6YDUch+KrZQDBC5MDJzZ0nx4F7V9AAA/RF3U38EGkPhrXWle5S0gxPxRuc2fgVDtwZlr6FRS4yNwggGl5tXSiJdU8MjBXNpTDcxQxq55qIRZ+YaTasXFHchsr3kIE0htq31MAZ2Qp6inytcrBSq4Pd0+TvnhdtitoKXRHQbUkz1MRXN/yFLtiwQfWZIffzZCi0CHpnTOvCjN14l3mmcKUETgzdLcjRIHNOehheJ2wxX4yXnIJCiYpOx+Us zBwz1cd/ 0yaZaaVnRDK5ocMrsdqG0H3FI7oy0b7UqtU7CXCSuziiG5/A+OYLmghcEK7Ahl4VmTkEM3BWzPXeld1fFeXXKmaQ8E2NQt6UfSNIyHlzRcs8mqCocOX1rUT6IQlL15QqvZzzq4yXt4qf90buudzJXlhf8V+guuI6BpqULBLJ3c6C3Tmll0/7kAI/EKoExAaoHvDv95pjkdIWb5ycPTiW2R324qeHfT7FTzK5JhmZMAaKHN9kYpHz1pvFRaCb9/MQNuCZFUIuiKBO5ErXO6aQAN6OxeI5txbjQqNoOsXJM/uAMU+72U6LTmABKeoCM7qLnU6r4fGX/MZiOylk5gQih/8zi4EVBE8xfgCd8F6rycQMka9Y72grmgTLDIgdoYES34Nza/9lXQ4TF6+o0YRPCILxB5sHNJZXf4D6hEAvxfQYIsSkq+TUr6czdoAF5lZ+3yqtE/hecMolkDQUcIY/PncBmulNnKCnAfGPJlEhvnUEpwQoobaYotF2i2ZDJ9hPv9SKZM8hCSSwMG8I= 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: 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. Sorry. -- ~Randy