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 D9197C369DC for ; Mon, 28 Apr 2025 23:27:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id B42FB6B0005; Mon, 28 Apr 2025 19:27:19 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id AFCA96B0008; Mon, 28 Apr 2025 19:27:19 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 9B9DD6B000A; Mon, 28 Apr 2025 19:27:19 -0400 (EDT) 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 7E4136B0005 for ; Mon, 28 Apr 2025 19:27:19 -0400 (EDT) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 781011617E0 for ; Mon, 28 Apr 2025 23:27:20 +0000 (UTC) X-FDA: 83385041040.29.9CB4E24 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf09.hostedemail.com (Postfix) with ESMTP id C7157140004 for ; Mon, 28 Apr 2025 23:27:18 +0000 (UTC) Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=sxTodg3t; spf=pass (imf09.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=pass (policy=none) header.from=lwn.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1745882839; 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: in-reply-to:in-reply-to:references:references:dkim-signature; bh=71FJqd39YR5/emSke+WygmuKJTkl6XtVtGtAkhKOafk=; b=YWbsRdyPq0FvdClVyNKzmr+STaTvIo37NaJ3w5LPbFtvwxv4a/J4TIPn792suOGI0G2zb+ AqJpHoo725foj0b2XrAKty9ZSbU2aBuacv/VVitUA9+UEilN7P1DsU/aZYsThGRSHY6VSs AqI9PCZGle/5j934kQgfwPXFwlnWH4M= ARC-Authentication-Results: i=1; imf09.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=sxTodg3t; spf=pass (imf09.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=pass (policy=none) header.from=lwn.net ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1745882839; a=rsa-sha256; cv=none; b=wigHssv+ZYr2luEnfRPRywW/8BNEjzO8wEFkL5ZkPmjQPf98hQItIrbz5J+BqsLj9VEwyE yiV8cilbs8qyC3smwnvkqzPYMLoq2etTnY0jtpBW3PJKNsyTIMCW3Tc5lq/sqkrnOInJgx 7VlJi9CVx1G5D/8ta0lyZNSQ4DFrSo4= DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net DFB5B41060 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1745882837; bh=71FJqd39YR5/emSke+WygmuKJTkl6XtVtGtAkhKOafk=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=sxTodg3tv9H0eES1DEvFDxhb2+Ts8f6yX4c+QsMUVDEF27SgEDGHe8uDfpPZyZBxw wNgkfpsuQqczUXyczvgVPlohqEhVUT22xUh134bjf+ddWbd96eYXHemuCkAw+17Xuo 0j+TLmWxdiI4+4z57q+ZqdXLOSNl/Wd/Zxl4/tV1vpNRhbZOAUXTP230GmxdzKJ9al dQSsV06G4wgXfXoO7gyu/yG4nBFiDKYUpiA9e9YS7VjiH0IoLlhe5doc2VQyX9ylHs lXyGR6F3c244AsrRs/9KuN9oP7diab0VcHvnR5BdyF9JMfp+O3/eAXyepp10AA5w9b TeWq60Qls6+PQ== Received: from localhost (mdns.lwn.net [45.79.72.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id DFB5B41060; Mon, 28 Apr 2025 23:27:16 +0000 (UTC) From: Jonathan Corbet To: Kees Cook Cc: Kees Cook , Andrew Morton , Randy Dunlap , Bagas Sanjaya , Mike Rapoport , Arnd Bergmann , linux-doc@vger.kernel.org, linux-mm@kvack.org, Maxime Ripard , Tejun Heo , Natalie Vock , Xavier , Samuel Holland , Maarten Lankhorst , Dan Williams , Michael Kelley , Kuan-Wei Chiu , Christian Brauner , linux-kernel@vger.kernel.org, linux-hardening@vger.kernel.org Subject: Re: [PATCH] kernel-doc: Add initial binfmt docs In-Reply-To: <20250426000704.work.637-kees@kernel.org> References: <20250426000704.work.637-kees@kernel.org> Date: Mon, 28 Apr 2025 17:27:15 -0600 Message-ID: <87selrrhnw.fsf@trenco.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Rspam-User: X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: C7157140004 X-Stat-Signature: ra38ketybu6sac43m9xqigeutckmfuh9 X-HE-Tag: 1745882838-448174 X-HE-Meta: U2FsdGVkX1/3/uqyOqLyNeKXz/Kqlin86OPuSN2WgGCqmfbTx9obPlQOSHyaCvRj9khhj+3NvSE2xahngRwHA72Kq+cJosx0d2NX5pS27JiYnNujU23SL8LIQ1POPUff+DWg/XtyDryNMfM+qT7UZJMEQuR16/65apr454G+DGUH4JyNZ5dz6Tln5qiRQ7UG3rLihiAImwKR1V2NjlBpfXQ5TKDNW55EFcby6oQXCWMH49/UY879LrlgfzmhVWp5TK86tKA0pKEVbA4h9G+jUCLKTlF0R6POrkmqzIc7nuawk0htM1ZWrZy60lW0o11tHO/mYGWkLh6aGUDoNabFfIG0dCyb816rE5Eg36j+NlL5vLGz6JG0kiLzrVGsc4e7HJjZJR7OUCW8145iVIz4V2aAM76G+1PW+3+oXT/rlEr7QDR2wN/tMWpZ2WMiIhbI5AFDWqCueG8rP9kkzq38Y3gI2wEfYa1IzZcxBPHiWdE8kny0zVroWtY7rWw/KyhJl1ZRZ/clTmsVmuBl8tqWSIh8amH9V/2jgaTMH++rg1k2Y7fjwMNN9yUGmWKbHgEs3ZtXqYD/IDc/K+asAKgEzSel3EJzQnzlC2x78ziDlVvYmpkfhU2A7pkT6sajSp7nhNXRT81pCA3Wllxjk28Ghx3aLEzY+Ubg7lBlpJeiPc0cD/GqRQfNo3eNW8vC+9YKxE86wLpbu06EheGvjbl2m1/Px75vu8T2JXYpkJJCnJum+L5shQXFzkAe7+L6v9nE+R9RrHrrwj7GJvnXBHWjZZfAKXN+jARYk7d+VYYbKrzGSmIfDLyh2Bf3m0wc/xNe1xwe3A1XAHMxzMKQNOpUGf/FJIatnfwj+KIa5cKoyvpcCXUwC4cYHUmVoulQnL+S+OCQ0l1MYjgabn77AVy+LPr+/QfohfPoz7K4wFRjztM0fZqWG8iTL+39S8gzFqWMtvDEaSYeSaBvCCDAw+A Lw8WK9fr Lp0s6iWbWI/bWGq26BFiL5fiz7I9rz53PVZ9a+/Np2GjdR8saIQkw7hEI9HWJaIW9S2iUMRTPZ4pTJ8qGz3mV5B/RKtVqrnuXS4lmCcCqA74vRwi1CEYJWTSQPERrz91MpNdxCClT3Bh3Wx9W3S9Egnlg48a3HRKDPRZUY3L1v5FTmNQYulRfNr/iwJM1DEvrJKigH3EMAjUVBeAj53+fc3ejdmJ0EC+PAoTZF5uiUlt3nZBXq+mSTu6kdFDyuFDJriVkEwFSaj/0Yhw6SSZxajJuTqVteplPCYgxRlJlNOk6xINLCAwqL6vjwSPfgXogH6xM 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: Kees Cook writes: > Adds a framework to hold the initial exec.c and binfmt_elf.c > kernel-docs. Updates scripts/kernel-doc to allow leading whitespace so > that embedded "DOC:" tags can be found that aren't at the start of a > line so that in-function documentation can be found, like that recently > marked up in binfmt_elf.c[1]. Just one tiny little problem ... when you weren't looking, Mauro snuck in and replaced scripts/kernel-doc with a shiny new Python implementation. So that part of the patch won't apply to docs-next; if you apply it somewhere else, the change will get lost. I figured we were going to run into at least one of these ... sorry ... jon