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 80FBFC5AE59 for ; Tue, 3 Jun 2025 14:11:52 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 206E56B03F4; Tue, 3 Jun 2025 10:11:52 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 1DE466B046E; Tue, 3 Jun 2025 10:11:52 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0A6206B046C; Tue, 3 Jun 2025 10:11:52 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id D90916B0479 for ; Tue, 3 Jun 2025 10:11:51 -0400 (EDT) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 7C99EC0B6D for ; Tue, 3 Jun 2025 14:11:51 +0000 (UTC) X-FDA: 83514278022.06.8550899 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by imf03.hostedemail.com (Postfix) with ESMTP id 0363320005 for ; Tue, 3 Jun 2025 14:11:47 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2025-04-25 header.b=S1CLMQNY; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=Tj8cEnbn; dmarc=pass (policy=reject) header.from=oracle.com; spf=pass (imf03.hostedemail.com: domain of lorenzo.stoakes@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=lorenzo.stoakes@oracle.com; arc=pass ("microsoft.com:s=arcselector10001:i=1") ARC-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1748959908; a=rsa-sha256; cv=pass; b=rWzwwVVB1mtvAI2OylnOv1LkjE2eWU0gYQ+8z5rLwlSQPx93EehS+WpECGlVF3E/i9Qd1f MtBs1L0eKWeSVjPPoi+zTAHGM5pYiSPa46Zi8fyDxV39LJrv6vSwEVZh/VX5Zr0QFPfw9A k1qqwsrFCLtpre3m6swXZKsqmykSKmw= ARC-Authentication-Results: i=2; imf03.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2025-04-25 header.b=S1CLMQNY; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=Tj8cEnbn; dmarc=pass (policy=reject) header.from=oracle.com; spf=pass (imf03.hostedemail.com: domain of lorenzo.stoakes@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=lorenzo.stoakes@oracle.com; arc=pass ("microsoft.com:s=arcselector10001:i=1") ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1748959908; 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=8xjjUrLoC8VmxR5JdS+T0m6A0QH7XY3lJ0QO8QKmlfg=; b=uFCNd46H89bMcTV1TI6U2RxvOdTtZIo50OMD/FwqPBxJT5EPwh72X03IQigcH7VaAGGpKT K52xNKVjJYscIH6DgY+AHc47nEikHsNzMgYiX7UGpW1N0ZD4gXL3Cvt34O/trtQYjmnPy7 1bJm353KrgB/gTX6vDcyDTYZ53dGcZU= Received: from pps.filterd (m0246630.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 553AEvkl028953; Tue, 3 Jun 2025 14:11:38 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=cc :content-type:date:from:in-reply-to:message-id:mime-version :references:subject:to; s=corp-2025-04-25; bh=8xjjUrLoC8VmxR5JdS +T0m6A0QH7XY3lJ0QO8QKmlfg=; b=S1CLMQNYesvnALoO8dwdaH6V/8rH05ZLCu M+qjuYTQqlcLNHCdyXRmlHDM+wxcuIi1eHF8WcQLvOfBqx6geVDpB847dp0MqFoA +TJVUCQWMKlCMKGYD9TNoNYHdD4vNb48VE17a/rJNSSkgIRFW7ycF2imOcPLTwH4 4BET6qaNzkShLoYFgxugivMCTu+HckBRdJIh0hwjNP62WnizeAGxYMreJ3I3qGG8 X0ZA4H6qKQEupA/3MXTuKM+EJIQ4zxY417zQznrP0xPo9iCanXb2LfG3V8Alsk9J yQ1jUbYHdSDrn9jTPbn0I4sohsvzmAKQvrJmTFBHIMVXLvhVWPRg== Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 471g8g9ycu-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 03 Jun 2025 14:11:37 +0000 (GMT) Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 553DSTfU034915; Tue, 3 Jun 2025 14:11:36 GMT Received: from sj2pr03cu001.outbound.protection.outlook.com (mail-westusazon11012046.outbound.protection.outlook.com [52.101.43.46]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 46yr79msdq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 03 Jun 2025 14:11:36 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=hAj/IgkfcdLtf1qu11c0ys+/Mt91ml2H0tfxgEFTVMxg9AB6eanqx26ZoplDh/y44fQkMU0v9ejoxoyWDWoYHuc1hUjjoMtZYl7OTKf9dJUFPwuVnQ6jcX4E/jc0HWPof0BBpfl237XwfAgNhHWB+NDitfespie5y/o/x/be5S4KI3XC2vAggpfbEivmHxBCfue6YuztsoJb7mBqjorIOFOMjjDr+o2c/IFo3WlvI9o2pE8Zr09x9tif+nICjSHJdX9wkVf2FMlt1j75LleVyWtby852yZriLH9YMjIQrFnDaaXZcTfhXxez82T1guUEXBwSQQrwI7HKFWoKGKJsEw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=8xjjUrLoC8VmxR5JdS+T0m6A0QH7XY3lJ0QO8QKmlfg=; b=jYF8sGvuoi8azvzMyN2620tbPbyrVFtffs/s2bZU2mTqFKRHro/KES0uB7mr5Qs7f1tkCLNLsEE5qKRhobmAEJMxQGoO+dsuCBmGKS154z0Fu+5kaV+LJKoDjI//Pl/j5zU54T6DKxnLy0d8dHOxqlaIlLPZHx9agkYTIJtnA8r6pXbslrzwNMIOIltFI/9ymjgnycOI2ihNmW1FLQNEElrtz8TWMwlUpqXVNUfc/bCQYMrL2X5dQQHACZcTFxdgRCbd9MhyBg47DAv00ed8zedkngJYJyGEziI+Sxvln/DMd6c7rGDR9EwN/Fa9XTsB6tGSUjnzyYjCkIF2UVz9+w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=8xjjUrLoC8VmxR5JdS+T0m6A0QH7XY3lJ0QO8QKmlfg=; b=Tj8cEnbnGZaR+oTRxkp5MI7dBHQP4Mzx2/UQ3cw43AYzi7cBlMY+SKI6uDoiampBDX0GSY+v058Ee0JD5pbchkosSW3ZNJqphQKPfC2X4U19VpnAw243xP61C7VvntneKqdKw6syBiRIelviNj2JsUoNE1o0R1sVO1OvaU6G7w8= Received: from DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) by PH7PR10MB6283.namprd10.prod.outlook.com (2603:10b6:510:1a9::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8746.41; Tue, 3 Jun 2025 14:11:26 +0000 Received: from DM4PR10MB8218.namprd10.prod.outlook.com ([fe80::2650:55cf:2816:5f2]) by DM4PR10MB8218.namprd10.prod.outlook.com ([fe80::2650:55cf:2816:5f2%6]) with mapi id 15.20.8746.041; Tue, 3 Jun 2025 14:11:26 +0000 Date: Tue, 3 Jun 2025 15:11:24 +0100 From: Lorenzo Stoakes To: Jonathan Corbet Cc: Andrew Morton , Suren Baghdasaryan , "Liam R . Howlett" , Vlastimil Babka , Shakeel Butt , Jann Horn , Qi Zheng , linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs/mm: expand vma doc to highlight pte freeing, non-vma traversal Message-ID: <28f53f7e-5ac2-4ef4-8944-6741161e6870@lucifer.local> References: <20250602210710.106159-1-lorenzo.stoakes@oracle.com> <87bjr59634.fsf@trenco.lwn.net> <9fc9ac50-abce-48bd-979f-2e00b26917b5@lucifer.local> <38bcf562-86dc-42b2-9ffc-53cbc5d8ac22@lucifer.local> <877c1s9b6p.fsf@trenco.lwn.net> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <877c1s9b6p.fsf@trenco.lwn.net> X-ClientProxiedBy: LO4P123CA0563.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:33b::11) To DM4PR10MB8218.namprd10.prod.outlook.com (2603:10b6:8:1cc::16) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM4PR10MB8218:EE_|PH7PR10MB6283:EE_ X-MS-Office365-Filtering-Correlation-Id: 05217fe1-8b51-45fe-8ce2-08dda2a8875a X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|376014|7416014|1800799024|366016; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?hSQTKXuDuqjcPzHbnrW9OvxZGEXR1HQo6i4ZuVbytfbVrOYYaZv1iBCQ343l?= =?us-ascii?Q?vDGHGWPBNwYb43Kh2Jh7sSS/N4ivr/jM2ftyxHdvwMXnlkhNxAwIHYBvGWdd?= =?us-ascii?Q?nA2tiNhtFjjg5eSFyBd0810jEhgcRiVKfWBSexx1bP0X2WcGDnqnHcwwnkfZ?= =?us-ascii?Q?7sAgTlE6ycafn/9QtCqfx5YMHWggCllaTdezyUS32UsWJd3kz58cYHXhJ2rz?= =?us-ascii?Q?ugXf/y4hNhT83TZ1MTWQvaWRpMlejlkgW3f/FpZkdwMfYTtvMg5y/hi+Kchf?= =?us-ascii?Q?oyW080FrDtAMhTrSif6tevfqN7c8HxyCvMtL3WhtChI/rPAuuGgnMZygkCPe?= =?us-ascii?Q?do9VCatAAGkRdaSLSMv6Dd4I4QboRLJy8yOkZEgNIyxDo3UYq6nFOP210T4f?= =?us-ascii?Q?TCpHyWgN5YP+jqHWwNvy5zfoeermYK+rd98VFOsKXvf5n+edeosAFXKVZSTI?= =?us-ascii?Q?8yv/HTfGgLf6iJhm94xaXeIaHB9uae56EnD82yRck5hvp0BwCLBSZkMZO5BI?= =?us-ascii?Q?lWakMiq6k0vmiQr3CgMwR6ZSYx1eub43MeRjNV1xaCunZvN9pAo6QPOji47R?= =?us-ascii?Q?cahMsRwQHUo6WtUw2aJDLlqUhYHBjIs8/Mtbdqy5XnDX1Ep3+FmS7dcUxOl2?= =?us-ascii?Q?+aKmD1seGUJ+Kk1D2VRjFwS7BQIMpz5N2J5TG8M5RJnPgk2umEXmlUWnzc8O?= =?us-ascii?Q?1nuIsY6iW9sKpwEOFAfu9YVVyXxF20br+F+GK7RmIpOaFQToLWXsu9+3jSsI?= =?us-ascii?Q?qFX4kqRDD4fgWoM297m9Ue0Uga5vbVXDQVwtuFLJF6MVy92Hlz1IhURxiXZa?= =?us-ascii?Q?bsD5GVNd+jUQRMd8jkh83IfcbxnNtcTMK8Uc8KQfmpixIe9Sb7byGMJpiNxP?= =?us-ascii?Q?1UJgMhvgMTw/imxRj70Hu80Qq+NjZyDUZPS069Y3KGSuU4gJ/BmuSOZtwD7P?= =?us-ascii?Q?fb7yk9QkcAroZuYjN9IqVmwqNEVWwGMkaoEcTx7SluGS7/s2Od3qvFs1dZ4D?= =?us-ascii?Q?VkhhTbQ5/oZ2nZLVcqeqh+k1F5bAgTBcVFkcMDbr5OZtdwr619hDcUri1GDC?= =?us-ascii?Q?bG5LMlM1o7OaVfcy6Y6Y4/4DuEUlGmmZtgLSUSRzzdojUpH5UdCIgUQYrlND?= =?us-ascii?Q?AEtCMzFBvjLSgrETPx5MogH6LbQeZopHDsi8YExvd47jQemvBZLJaNMz35Gs?= =?us-ascii?Q?w/1tzhvVFMFY9aiNCG9nm/keedoShIiH0oAXr8S9lM8E27yJ5hcJqkoy3mx8?= =?us-ascii?Q?lypvgtK9wER9Fz8+fPulcRR9pOEf6ZbGhzF2kkdjXQUF2FHtKx5997GLEnvF?= =?us-ascii?Q?Lh9GXjt9EO6hLdafIxFqvUQ+y74rBu6DaPNDILDLYBndMMMp1jLK1oVrBKeo?= =?us-ascii?Q?S1em+b1zAI75ka9FoPhjK61WArTQYZg0/p01g9aa2jaTlpFUi7CWCRUwadZp?= =?us-ascii?Q?iBSwHDiHcAk=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM4PR10MB8218.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(376014)(7416014)(1800799024)(366016);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?QooKomKB3fSwqFlZXeJ1Ud4m2JgYAf0GdvqjAKu2INb+ha1uyNx+G+TfI24A?= =?us-ascii?Q?EXXfunW14PkSIFm0Trv1F67E8HL672g8wK/7p8UeAB9FoYQ6fuI3/tfHjeqL?= =?us-ascii?Q?90v/3xTPv/MTKRdJT7OUyBQXS8df4RzbP1BLknaE+8Dh8OMktN+Ou90UzF6p?= =?us-ascii?Q?DX+R0TwuD96Pz5qAvCzIwsvNi8DtezmdE1RcACX3nhQ9DvfxIXfVKHpI70Zy?= =?us-ascii?Q?h23AxneJwR4Acm1FUMmqyqt6kXXJB21qAIqrxS5F9/W0umdm8nYcbNvGgN3U?= =?us-ascii?Q?WWfuuVOW2rG005T3BcH4PUU1GeVUwAYFreV+rlZ1Kg03ZbDCjFSocF/LGuvw?= =?us-ascii?Q?52zYM6Qe0B1PkOmaW/1NGidNQzr6Q3BEChPodODkyp2WiJU1tAg9proCUD4Z?= =?us-ascii?Q?f/EW6EjlfwOFWZP1Q3Otbx4uVxNAtD/UGmRwT4Ql3k7iI3jdq5Ww3tgQQFNY?= =?us-ascii?Q?BFUVJomtppugEFtJKXrcL/CKybSuCep9dj//5guIMO/FppomgdwH3kaWM6QH?= =?us-ascii?Q?LGrEzVlHGlnBUWaqPGqlr7zpLil0DRJ1RXmRcHrHmp//s+p+Ocd4qgudVtMW?= =?us-ascii?Q?5OKs8aUSQOVJFeYO4YaIMPkfZFm9VPTf/Z4x12aTmrfYGfmmsR1yT2z1+HNZ?= =?us-ascii?Q?vhEWi1sB5/OaWJqoRlDTfWeU2pzE7LnhavUTnRjoxh2yNOd2yqkPMllgdrOJ?= =?us-ascii?Q?siakJX/d+GoQTjGAvWfI8JJc0YLdW/EuNf0wpNkZfzhco5iuBfpCd3MiWrt9?= =?us-ascii?Q?TCQ3Gd6c0ZdM/qgqDfUG/8UeMIn138JJqRcUdfIcJIVU/srqLzFTFkvjE1Jt?= =?us-ascii?Q?1vU+3/o2gOoSuEzgumwjSRy8Dzubtt7ErqSn27qQIb7ln4w6av3S21MDZ2Kf?= =?us-ascii?Q?0cowMFCXYNA/wEjYUPq7Go0gmycC4hm3IJgWNwwP1CCAOIBIx4D83aTfYz1u?= =?us-ascii?Q?QXeYWzROMkMSBrM/i3R6Xc1aS0uatv0cUjHZRGjxG09L6RSlIGhONn//01y8?= =?us-ascii?Q?KPeb2W1W+8RFhwOni1acqMbVSL6TMl/LvX7CZQUF7TfpGaLRp2M8rQpe57PV?= =?us-ascii?Q?Fm/7Di+Tx1gxO48lL+Qt+Xd+pSrluwLkCxs0T2vmhwIoTDbG15nEaeoK0BXo?= =?us-ascii?Q?IyT5+NLQZvruzD0bnBi0edtHoKP3RPc2Bw9iz/813rscAO3Yp+GJugJ6X7La?= =?us-ascii?Q?QYyKDfvU0vkY3UfjhW1tOXvuLOS7wS5fSFpBS84GmUWt8tUZRz244o3bDIIk?= =?us-ascii?Q?ackNNb34YEP+ixteBvLVA/kll3jT0LQczV+lfcYHOmRt9a/uDB72C6zSQn48?= =?us-ascii?Q?ehs6fWpSKhI7ZOClH5O5YALs9aeoQ7jXhYr5TLKjEh6G4pEzk8NHDAjraJhq?= =?us-ascii?Q?vIg7z3Icy351lZeSlqBLYcTah7UeMkweeUKGUO4iwQurXt9+7daI69DxgP3u?= =?us-ascii?Q?eU4cVSh7jSrvdnWacB8iKvhsTHVmwqp4tKM0W5HoX+1UZ2vijvQwbboQazbL?= =?us-ascii?Q?WEjau1fZeP9Bfq7piaVbdBC7GE/Ny2bL3sn/t39o9Ne5uTBOEO0ckCN+qqGm?= =?us-ascii?Q?7QvZoOImj2Y+sLP6DMFRISGErcTE6ArAkPnQ/Ui8voz91DcJlshwCrUmb7ly?= =?us-ascii?Q?1g=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: IGji7CSwaqFItX3objEQPJmNcb92PeIFEPSG5LjKOztSqZvGUy7nnRGQo7nuONkxy91BLzJDUNWdGtMWR74Bh98HpZLwW5ItFpYIyrTXiB4ogQZnTQ28l0bBZQpjSlgYI35XWHyfQqq6CxC1xSR4gSbbIUd4liwHoaJV4uBcssXlNM1Vjhr6VrdznBABZwfb3zpNUncT+tmv6q4f/CkYheUOE39j+eHlMswChR3sNEFU5fWrvGctEZglLQHyA0ySFF6rq1bASBBW6ZaJNwPDafdUPFXbxfbMmScxidZtrLOuISbVobNHs5s+NY2PRXWf9JDbegtvs3UnHux2r2xvDtLt9MMhIM+76VUSrBt2FxOVrPgmInDqS32+RrZIiXGbKI9W8BwouaphRxFMVxIHEBdKv/hw1F3J6i/GMN4Nss768xWMIMVu5RhPS6UQOfP2MCm9OD1fgnrBbWDi5m7VppJ1h40v/y+NnH3SaXzQXNqAm9LW0TZmchPzhox91WTpn01OVLVYBzFEssvvhSWTJUhaWHB1e22fc3b9JJ6Lqk+6PsziMch29lp2ZoPZywI78mYFk38cSR500zlnb/bly3qnKhsTFG+D5Z/Ho/B8eKg= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 05217fe1-8b51-45fe-8ce2-08dda2a8875a X-MS-Exchange-CrossTenant-AuthSource: DM4PR10MB8218.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 03 Jun 2025 14:11:26.6328 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 5RMfhqk0t+pgjLovSYZQ05dZFeaQsqKyuCuuuaYiTgtH1EWvDcO/pRM808eCIw0jTK12g5G5dU+XG1oLySP2QNpzrQVl6obBBWcyCKAQtIo= X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR10MB6283 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1099,Hydra:6.0.736,FMLib:17.12.80.40 definitions=2025-06-03_01,2025-06-02_01,2025-03-28_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 mlxlogscore=999 bulkscore=0 spamscore=0 suspectscore=0 malwarescore=0 mlxscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2505160000 definitions=main-2506030122 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjUwNjAzMDEyMyBTYWx0ZWRfXzfozZg97bp8o nFVs1k0d+4PJewf44RPwfg1J6h0cVdZ0YGJTjP7MonkypX85hceBGMwZUkipZBSANmYgDfgy2WR toLzC/j4o6olvw/7lqbeaOd3yAeX5Ed9FZVGSU3VlU77QxS/3E63GnS5++/THDMC1TpYLJ+LrET yo/0sJ5A93T4XK5Un+GN33aVKi/Ri0stDuda6sVk9erPd2HFk+cys/1HinuX4JfwFP2Sd07/zjZ D0/ISVrv5725vMhC4FtUX0dM8V5AHS0pFJhFMIBnew9HQJ+/fl70cL1l0IQEZlax2Q0FoYwv8fe G6nwExTBzlMDcNziv96kn/dRKgtboIQnl9DRhowTrCwmYfRMLbLlmn12GgZzfLSxRQQBClH2I4l cxzv6y9mK/MjNZESlnZDWTjXJai1X6FFdh1/vCOu/0+9z6MN/D1yJs2iMCh7P7DgQAk/ktox X-Proofpoint-GUID: bLjaloRe69WiJcIgeuEdd-IqAny4q9ov X-Proofpoint-ORIG-GUID: bLjaloRe69WiJcIgeuEdd-IqAny4q9ov X-Authority-Analysis: v=2.4 cv=H5Tbw/Yi c=1 sm=1 tr=0 ts=683f0299 b=1 cx=c_pps a=WeWmnZmh0fydH62SvGsd2A==:117 a=WeWmnZmh0fydH62SvGsd2A==:17 a=6eWqkTHjU83fiwn7nKZWdM+Sl24=:19 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=wKuvFiaSGQ0qltdbU6+NXLB8nM8=:19 a=Ol13hO9ccFRV9qXi2t6ftBPywas=:19 a=xqWC_Br6kY4A:10 a=kj9zAlcOel0A:10 a=6IFa9wvqVegA:10 a=GoEa3M9JfhUA:10 a=yPCof4ZbAAAA:8 a=lwG28bVMucyWlqBYmLIA:9 a=CjuIK1q_8ugA:10 X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: 0363320005 X-Stat-Signature: 44p4w4mmwrdjnhdugjznd3b1iot9b1y6 X-Rspam-User: X-HE-Tag: 1748959907-494910 X-HE-Meta: U2FsdGVkX19iY+daTUvc9lpYeCHpgJh3fPO2Ra54hFK1TKVgzmJB+IscpLvPaSvGVlGWsY16yip1PUinmHbqcOe5OneUcpQoIamdMMF/OSVuZF1qspauDU7cxIkLaxAZb0By4OR8lk/NHbM2+UijzG5rprBK/GHQ1F629RUUkE/irNBh3aohd4Vv/EJEB/mWg6/8Gp+04Zljmvhmhg8hnbciTKyN+5FJyGKfMzjWkwenRTXex3sQIeikQjq0vlS1ld/ka2HEAdR+y/Fkd22+EwOkz9HvASU+q22HCVS5vTL+udoMIZFjjA53VqxExrUgiZrqGhdQsvE+XzntbIIyK657pX5uifQCSno6GFe3smmdtY9BIkZSw/saxyXpuwl+bjbDgdtE5LTvrVhn9Kj/g35IgIIn4yB763FsESiZ7WCw9ll8qckaldelmAGx73IRqnDruYAx/gLKgeHUdsHkT8XCh7WVAGkuXDJdJanEjT2vbUmKnvNHZ3npC9mbIFArl0ph/t81jVxBQ2IDzA/bZTNMxPzmGTcRfPkecCFbZRy0PjDkym4YuYdml2bDi5zIa/RR9YTRpOMmzOeGX7swY8Ii//7JwAxRIA3Q/Uks7+w78teD3RIMEqV0lVkT28P8jQk+IQcxPYJ6tF4hyHmch8F2uS3QsBjSYWkXHJZu0gzWiUfR86UbP0HyftRWTrn2dmdJL+8oKXd+7PnWQ0YeXJKpKi604M5MofBfFGe6yifBd9UqvYJ30hcfVZnfBQhm164cAjw3yYWBxFVWhdM1PHhvq+MO6Pka1FIgf3+RTUFIFEkMACt/PHiImNFej1ixSv+KBfrlRGOOn6Xh1aqW+8DOzx69sfL3c8uB96f1YumVE/9YRXf4/oi3Jh+JS+6Hkx/YxM+37m3g6jA2E4XSrefWOgphxobN67Ov9oH4/zLwHiot+LugRZUfIuQ19R1fW38/LG7VYzZzUxsG1i2 Xyq8/Arn Ede38M0OX3r8dJsgwAq35/VhNCjgTsq71PXzI7kQCMEzsB4rFw4rbtEpHX+D7EE6HrXJvZxBYEglnV87MNmAMpsty+AzLmuzkiidptqESYghyTTbBjS8NfEOq+LEB+86U8jyH3pMBmNNsosL44JB6KjoONRF0+GrNnxq6PDTwZ6nHDgra+UT9cj+yJFtSMrv9R1oxZd4/ug8GPWsYxFPLiwNJN5F4QXhHh+Do8BdGpca7kLIa7cp9Ga557VlU+RxvCGzrw0mdwLPEXOlVKn1P4nB1Swg259k9IFb1iwhQjFK+CVT61yFqOialWpP0xbzXvaJueaL0Ro2zPHNpGwAeQjcMwpKNbH1LvFs7K70aVj7v++JbC2LHcnTxnLKyewURdDQZn42gZmBJJHARTLrcTX82NtZTc2C0+bilZ1s8WnRMVmRDHrkYybYzUASvrGbNNxXT6klUNlF37EnFpQR8/OhIs3FrMESzHJUJjj98PC4HPNiHxWTa0LMMRkXetALR7tX1ps7etlMhmQMLgRzL5oLQsrLWwonqdf3zsmRHshdQTV2UEWD0F6Lb31cVUCwQRwxGGLjEnX7WIcPLb0oy2GhiDrQbaHPup1w8C+NvF3vbkJvDWdPFm1KPGP5iLcby6866w8O+wr2bQ0lAvyOrahBQzqiUN+Yu/mDYb62Pike/aaOHKK2BEgUFMyjrsNwFHU5FP3uJujCQzi4= 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 Tue, Jun 03, 2025 at 08:01:02AM -0600, Jonathan Corbet wrote: > Lorenzo Stoakes writes: > > >> Re: the c:func: stuff - > >> > >> Well, the right thing is making function + type names clearly discernable, and > >> it just putting in the function name like that absolutely does not do the right > >> thing in that respect. > >> > >> I feel strongly on this, as I've tried it both ways and it's a _really_ big > >> difference in how readable the document is. > >> > >> I spent a lot of time trying to make it as readable as possible (given the > >> complexity) so would really rather not do anything that would hurt that. > >> > > > > Somebody told me that in _other_ .rst's, seemingly, it does figure out xxx() -> > > function and highlights it like this. > > > > But for me, it does not... :) > > OK ... If you look at what's going on, some of the functions will be > marked, others not. The difference is that there is no markup for > functions where a cross-reference cannot be made (because they are > undocumented). > > We could easily change the automarkup code to always do the markup; the > problem with that (which is also a problem with the existing markup > under Documentation/mm) is you'll have rendered text that looks like a > cross-reference link, but which is not. We also lose a clue as to which > functions are still in need of documentation. Isn't it a pretty egregious requirement to require documentation of every referenced function? I mean if that were a known requirement I'd simply not have written this document at all, frankly. And it's one I feel is really quite important, since this behaviour is complicated, confusing and has led to bugs, including security flaws. I really think we have to be careful about having barriers in the way of people writing documentation as much as possible. > > The right answer might be to mark them up differently, I guess. But... what I'm doing here, and what mm does elsewhere works perfectly fine? Why do we need something new? Surely this cross-referencing stuff is more useful for API documentation that explicitly intends to describe functions like this? > > jon