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 C1005CA0FF1 for ; Fri, 30 Aug 2024 13:30:49 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 44B026B0150; Fri, 30 Aug 2024 09:30:49 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3FB386B0151; Fri, 30 Aug 2024 09:30:49 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2746C6B0152; Fri, 30 Aug 2024 09:30:49 -0400 (EDT) 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 06E376B0150 for ; Fri, 30 Aug 2024 09:30:49 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 36C4C160479 for ; Fri, 30 Aug 2024 13:30:48 +0000 (UTC) X-FDA: 82508996976.28.0709B30 Received: from mx0b-00069f02.pphosted.com (mx0b-00069f02.pphosted.com [205.220.177.32]) by imf26.hostedemail.com (Postfix) with ESMTP id B54D3140012 for ; Fri, 30 Aug 2024 13:30:44 +0000 (UTC) Authentication-Results: imf26.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2023-11-20 header.b=U9eHEcTs; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=H6+W4J9o; spf=pass (imf26.hostedemail.com: domain of liam.howlett@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=liam.howlett@oracle.com; dmarc=pass (policy=reject) header.from=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=1725024525; 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=o7ncf8ZjdtkSeezAPXmd7E54tEiyA11g1vkJN7vKn/M=; b=0oncThhK0/y9NQ6YuT09NlBF4op2dRscfXAvN6/EepBcDjte3H30u1rdLwwPyuHpR516O6 RxaXQSPP6RYOGTZ4+dpsk244GjasinKIcucbS+tdfjqk1ZB++P7QBJ1owztLEcq87oAO3U EkEIruoqYXB735LTaD8RUaWLV5zoCL8= ARC-Authentication-Results: i=2; imf26.hostedemail.com; dkim=pass header.d=oracle.com header.s=corp-2023-11-20 header.b=U9eHEcTs; dkim=pass header.d=oracle.onmicrosoft.com header.s=selector2-oracle-onmicrosoft-com header.b=H6+W4J9o; spf=pass (imf26.hostedemail.com: domain of liam.howlett@oracle.com designates 205.220.177.32 as permitted sender) smtp.mailfrom=liam.howlett@oracle.com; dmarc=pass (policy=reject) header.from=oracle.com; arc=pass ("microsoft.com:s=arcselector10001:i=1") ARC-Seal: i=2; s=arc-20220608; d=hostedemail.com; t=1725024525; a=rsa-sha256; cv=pass; b=FPJDYeA2yEkb6JsykGhkpesVBHHGsB1OGq6PGhx/f7NkuqY2DYYmZ2K4GJMt6pBx76CkKP jyq/QHqlIFv7ctMl9nuPVGdbU84I+m5qX8oZw2CqrA4kqPQMzf9qYqGaTUSb7e1UGcX4be t55CpaRZtr33RK2VENKUcVMeOO/mBhQ= Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 47UDMVXw011710; Fri, 30 Aug 2024 13:30:43 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h= date:from:to:cc:subject:message-id:references:content-type :in-reply-to:mime-version; s=corp-2023-11-20; bh=o7ncf8ZjdtkSeez APXmd7E54tEiyA11g1vkJN7vKn/M=; b=U9eHEcTsd7Ya/+Ed1uaUdmeQ+DW2+U2 s5WfulsHPx0s/E8XWwTTRa2zZtDEeflKaFiJ8bmy1oajv94Tepipg+DOTFXQmKVT ZzJsPWyNrNSp0NKVGeB4TQGJP87QFNXFqUeFgN3vCGI2GPZ1dF60MD8+XzEEp7JI LYnhsIBx1Lqa3OfZ2P7kvrWA6IhxjgW4ZyjujSbqWJanimHqQODy1aSmSPi4PRgA 6ca8ZN4l37TRiETrbpVHVRnKowP2y2ofd47onOOaSaWqYbH35HgxK+Q5ykkCKUIn iXOSa9nqVZ5SUwGWQKb0A7TtXNxH99Y94tN96AYEy8Zay0/+QOPPGBw== Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 41ax0gsqn3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 30 Aug 2024 13:30:43 +0000 (GMT) Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.18.1.2/8.18.1.2) with ESMTP id 47UCdIxb036549; Fri, 30 Aug 2024 13:30:42 GMT Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2177.outbound.protection.outlook.com [104.47.57.177]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 4189jpkgyk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 30 Aug 2024 13:30:42 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=AeFouB/3rZv2FOK7wAn969DXlthSE6HKLsSNM7XI7lwyTyO0llkDgQvGGddkbLAEevzBhEomkSNoXZEmSVy/pIN8G0wzJS7cxZJIGKUCGTzaWNcP9EOozLE5tOFXGOMwcLZZhx/zqG4sl3L/CbD2a5rEJgZLEPCUtN8LZAUek11kFy2JmjWL8eGhKjGHObMQG4Tr+F1zALMs/sMSs84e7ein3OgWei0H7kEtE0PmYgWgLREFIUIbuaXwFbVoyDB3cGm/SuQ2CMdtCId/uopE0nUXh+84qJ6bSswYUUjTvXySchqVNaVcnwbYRlUqJnIeGte2Ow0crTQrGgS77/+6gw== 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=o7ncf8ZjdtkSeezAPXmd7E54tEiyA11g1vkJN7vKn/M=; b=FXeEJEJMXMsdVOvIQOc3SdqbXyFw24pQ7o3+tQSd53FC+j7Uw7kMMIullIMqo0HZRFfNG9gBf7m8ec+eGGJvhaJbwSjWUfcPp6aL9qoa7tITZ3cfWaQnBC4OsZ1SqEt1LPTTwGQi1cQsOQAgV5TVrZ+QlsrSiMAO9yBsuQJekoPuJrEpw+b71E9/5KyKTAZlBYpwD5k9wIgaPn+kozICs0gFI+UIuioILdEiB6c2iII3S1kfR+N0vcxRLS/qfrJ2zwaNUhxBhklaaEfOT/Ru7yrZddxZ4plZlTkMIjuKGKELvwqng6hhfrTrhjFiyso+DcPXomF5FMZ8lcAea2FpRg== 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=o7ncf8ZjdtkSeezAPXmd7E54tEiyA11g1vkJN7vKn/M=; b=H6+W4J9osTSftCCZ0WuD+WHdnNI69aO7fO2Xkgh/5lCik0xGotlX5X47b8pXdog26acCeo4aFPNuA+Me0dyJo5ShymEBMxy6jMqRMUVejDQz7NXmc7++vCsOHvz1QY4VPSOQ8WsdEkLzWboJPHHFb50QV/hiXTbFuSWzJr2HiDo= Received: from DS0PR10MB7933.namprd10.prod.outlook.com (2603:10b6:8:1b8::15) by PH0PR10MB7064.namprd10.prod.outlook.com (2603:10b6:510:280::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7918.20; Fri, 30 Aug 2024 13:30:39 +0000 Received: from DS0PR10MB7933.namprd10.prod.outlook.com ([fe80::2561:85b0:ae8f:9490]) by DS0PR10MB7933.namprd10.prod.outlook.com ([fe80::2561:85b0:ae8f:9490%3]) with mapi id 15.20.7918.019; Fri, 30 Aug 2024 13:30:39 +0000 Date: Fri, 30 Aug 2024 09:30:37 -0400 From: "Liam R. Howlett" To: Wei Yang Cc: akpm@linux-foundation.org, maple-tree@lists.infradead.org, linux-mm@kvack.org Subject: Re: [PATCH v2] maple_tree: cleanup interface descriptions Message-ID: Mail-Followup-To: "Liam R. Howlett" , Wei Yang , akpm@linux-foundation.org, maple-tree@lists.infradead.org, linux-mm@kvack.org References: <20240830025648.22224-1-richard.weiyang@gmail.com> <20240830084701.7omry63kjgy2xsls@master> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20240830084701.7omry63kjgy2xsls@master> User-Agent: NeoMutt/20240425 X-ClientProxiedBy: YT4PR01CA0393.CANPRD01.PROD.OUTLOOK.COM (2603:10b6:b01:108::26) To DS0PR10MB7933.namprd10.prod.outlook.com (2603:10b6:8:1b8::15) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR10MB7933:EE_|PH0PR10MB7064:EE_ X-MS-Office365-Filtering-Correlation-Id: 1e39fdf7-e1fe-4952-9581-08dcc8f7f038 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|366016|376014|27256017; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?BrgnAOrgKSC4RABbAsCANovCAt3UP8v/fOrCZ5xww5Acj+SG5/6g/injeFqI?= =?us-ascii?Q?l/38jtyTs2JgWVwXO+P1P+hZRZ/gJEnDVxgoRMLVrVEf4TIn6/T6YW0FxJbL?= =?us-ascii?Q?Zu5lGVsSQygUEZCIl7RXliRl6JAHe0Sy/mvy/NU0Nn0t6dv3QWGZzVIzwte1?= =?us-ascii?Q?pDu7N5V/k8JMLcAbnTJ1ZbilHRMDlAqI4aloWJJZ0vJAdBselLRqfInK3I6H?= =?us-ascii?Q?aq9mVRmnCg0AVLzYLoKT4FgMn2iZOjYn+xcQKQLt7bPHTYiImIvnEQnNs1Hw?= =?us-ascii?Q?afYTaYAWc/c2/aiN5rnxyoK6jqkbqs5AktC7h9klkhL3B41JUfCP/uLnULXt?= =?us-ascii?Q?b8AEUJ0beNOcD1kEMy1bq9DKF8tibnriXOSc0zRz4bXIAzfQcw00P++Y0lSv?= =?us-ascii?Q?gpfiFLj6M82ZZCSDoXV6zjgiXs3Z9kpqlycall7/NAhk64U7a5Bv9IHJXlpB?= =?us-ascii?Q?6Yr9Jg4548bEwthyoXcyqJbGCSmkX9vVPgJVC+H+WIRUmh8AKUrC64t6qkBy?= =?us-ascii?Q?kJfl7Ue6V9SU+G8g9p33hsE+XBGobgFvqZdsosxMn5qzThpn207I2jVzPAEx?= =?us-ascii?Q?z4vXybWLdhW7tYLcHb+7rA/I951r0m6Z1kKT6EI7i8D2EBQ5JGthKBkJw3Av?= =?us-ascii?Q?q7yh72DcHJQC0n3ohuvwTL/UFof0p/EHyuwNKljAB3F8NeQ+u35LXqAMtUo0?= =?us-ascii?Q?e/RCS8jqQmDmXduXu7HdTDB5N9lyerQzjgj06aq8U64nhzrniC2h983E3rep?= =?us-ascii?Q?e3zJs81JW4ZngQe3r6hJ8TOmCJKDegsWQT4hoJ3Mv07DHDKG8kK/8KDCYoEt?= =?us-ascii?Q?c2f8p29zR5ZjM5Jxlug+CMuFBAMoXRHg3P/9nY/l3kYk4QMjGoiSWhr9KlaQ?= =?us-ascii?Q?KA+vCt6iPm1ZR4VV4vhk/xeAieS6OubA588YECUfaNU5CE5tjfnQsvEoqsuE?= =?us-ascii?Q?Dy+hXRW7/HssxXCz4eU6kgB74YS66P9NZndDN2eMDKbJ2oBNch5KUZTI3JyF?= =?us-ascii?Q?Q05Z1IxVCeIGrEbG7gfetb0d8meXfWZmAJm4PC+VzcyTzDWQSkiuoMlimVDU?= =?us-ascii?Q?+2LBIyfsULuIgl26y7I0EZdoIxZRzrJTIXu0xMKHXlt95ruPPMaS30izxhkj?= =?us-ascii?Q?DTIqlxlk4DzHGTohe85WJxtkG75rRGId/bmb94dmLEvDhaBovNKGNdCU/dco?= =?us-ascii?Q?DaeE6CpZJku41ODs++E/ca1ftZugD2GmnKm8zCsKYrE3o74DWK7OGsFRTV0u?= =?us-ascii?Q?oA1fl0BeMI06FZ47OEc1xJh95nI+AMhoex80F/O6WpL+kq+MJ5rFb3hf/F09?= =?us-ascii?Q?7vJxqV5Pz4n24i9QNjWA3JdLRSluP+USKlhZQVOarbJ6BDp8A0ivXHsJZHHd?= =?us-ascii?Q?syX/ZB8rY5igZh6A9HLiZLwCJ/lMd9KRHfw5PPdvY3pmmBmcnQ=3D=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DS0PR10MB7933.namprd10.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(366016)(376014)(27256017);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?dRI2AfThuYsGrHVIyFRbDzc1lGNn+3nOxeNnd43ix7C/HP/7mzBT8ra1Cva/?= =?us-ascii?Q?n1YLuZM4CocnBnLqoTlmL2+yJw+B2IcCG3uKhXBt5Np9PpZKJWHCVfxaQuA3?= =?us-ascii?Q?Us65ATZz5YlX7HmBa4htuEbXmQyZcAFD5bLtNTAg4P51SgX1qSrFrrfMKy+q?= =?us-ascii?Q?XrBDRjvWgocnvU2lebjHeV+Lee/tvpzWrhJSh3OMMwll0BeXAOWchsybK3la?= =?us-ascii?Q?ehwmx0CW6Tj2m/0lS3JJSOt04IWAJvhdLxncVNy+Mi5hS0ekFRb0/Rj7R2Na?= =?us-ascii?Q?cVWzSn+xqcBISlnBfdyGvSHC8/V23CGe8NYEPtdKnMExtioirNH1ka8k9+d3?= =?us-ascii?Q?oHeNH8ZZuoX53IbwTQ3W9eu2Q5qhuBvpCXH4hSC3ryP9qRpYLH8TbGEFeMNw?= =?us-ascii?Q?K/Y025aps0ws2zspiVWWc2remruWZBm9pygq003VQ88dRj6GyTUieH9nabKE?= =?us-ascii?Q?tsY0YLdrKwkRgdsDRMjw2GOLZWJK1JewkzPo8uQnowofa1caVRfqdIZWoO2B?= =?us-ascii?Q?p1Apuo3PG3eAadNviGZfH3Z1t54+fyFXbGpAlID7wvWloMUpMEzy9KVE3Zad?= =?us-ascii?Q?x/08PPTd1g3ijIVupH3Q06/CzRxFi5LYbV4OrLUyHRb2TOpgJb89LYRlh6wt?= =?us-ascii?Q?F4h0yzxGR/6ZNDcl6Ku07kMY01GjVhre3YhN9u++95i9+i6FxKI9Ru0vfwjI?= =?us-ascii?Q?1yRkWGj9iV26dAmrEAEwMEQ+CuadTXjdcony6GVnGUaSjDrGbsLLFzTmTSKi?= =?us-ascii?Q?HIodHeTKiGlaAdTXfP/egbxKCCXpwq51r9VFDwueqmdR0XfCsawk/lSq/B1R?= =?us-ascii?Q?LQjiOytp9+9ZiISNpCEa2PyPBPjEawl/ZfJ9mmoVdnl+aNxzuxgG+AxsVKUm?= =?us-ascii?Q?rWHM3BnC/ANjUtjKnDZPqJKl43lSWFYtTdXhDP3NTl6P97xz5EZXS8/QHn7b?= =?us-ascii?Q?6ig9CRFcAb0pOgRLgfMJ0GXf83vQoTjK6kuX5vKVxfeXB/HZu1y89Al9F4XC?= =?us-ascii?Q?NvH9wH16Oey22cAoY6XfoijL/sypFHmt/RLeL2X9lDG2EPyFkvfv1XJURyRY?= =?us-ascii?Q?QjkxAh2s1+nAv2uYvmDIi9o5qjoKq/S5E/UCPCOCATwZk25nP6ZGtjBmnTIm?= =?us-ascii?Q?HQAhb7tI1VLOjfv4upPt965/Cy1+lQih/jm7D5hykovDfJpr2nzfur4TEPSL?= =?us-ascii?Q?9TEPA3VRtdZRvmlWfZSYvIz4HwtF6UaUbNeRx8T5Flbg/JYFagcBPsSw1DqG?= =?us-ascii?Q?SojwLqRQGoXQgIVtbeXlSaSCzjYMkGI85tynNfqJkU9ZEFPqNSd0ZKxO1kvl?= =?us-ascii?Q?WfLsEhMOFaNFhrpFrOfPf0GmF74SR7zc9+DNqBjvNnFUyyvPRoPq7xIpWLzY?= =?us-ascii?Q?2PwtBkeJ7Db6drTpQlWr9sAVYKPcIYJX/3aPmlbkAg8W0O0cy8+Y7paSfrzH?= =?us-ascii?Q?8UcPq6rJExY+ZQSj1KrKmNfKIyIQsXkJ1j9/pdPbeOrVfBq3v0lBrqzEpHxc?= =?us-ascii?Q?EaxR35SDNcYa/Aw3jXktPfHZXcBkwIUgdc5keF2w6Pubz3lXdZTgMzG4wP2H?= =?us-ascii?Q?3vp9xcqdN/PGSutnRk7kk8W2IHS8BsR5wFyzuTAnAN6o7dvEZm27jkbyn9Oo?= =?us-ascii?Q?6w=3D=3D?= X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: 27z8m4lpKmiPJELpBY7Fgiul1UXo5zCqJ4shZjhWd4D1Ac9WY4Buv1q80j0VELql3bUZRyqev7vfvFtFBLKg/U7pMUuuKdycVAtvrlix9XJJG6K2GOmrU4r6hweFCnYUGOr0j98+keX3NLSyYZ1tO8QIxe6q7yVEM7nP5B65KrTvsYbRYv5U7zdgbtZt9s3GR0D7iJjBxa3AXrWh9zaQjJB78S+afE6s38p6LG/+S9Orpr43uQ8weyPmzvgvJ47JApFjVxjVROBkcTq6BTsD6tbhkuhfyCfhLY1EkgbygZaPHggpwDSVBga18iQthN+kYU/mLIaEB+gUnx+xv9eQMEIqXWUJoMjelLj5jNewUpjr+67Hl6craorL+X7ab6aOrSTedaORHgrAFJwXdGfG9ZqppOf/GqRuMuYksDpaSv0KuIBlHKRj894wceObeL4Q2QU5fRf7fIShaNqdXiVwMYbTi/EQ/18FKkBOw5AYDuzpJo1c6GqF40CHqDtenxsMBnmzsCn66LpGaKAiZ4x5yR7AZw/mmT/08kVRtJm+7xbugdy8IQcYx7GEQKQBAo7zwZHxFWmusK4AxDsukGKV+2BqzaQEtQfM3KL10A8BWMs= X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1e39fdf7-e1fe-4952-9581-08dcc8f7f038 X-MS-Exchange-CrossTenant-AuthSource: DS0PR10MB7933.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Aug 2024 13:30:39.4018 (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: 32reX4iuIU/rxPDkcrA8v1p7yD5HrfNs1jYxyKZ2xHSll+Rb6h9BIzZ0JgxKZ2YXMJ8ymOVy238R0sh01ydhfg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR10MB7064 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1039,Hydra:6.0.680,FMLib:17.12.28.16 definitions=2024-08-30_08,2024-08-30_01,2024-05-17_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 mlxscore=0 suspectscore=0 phishscore=0 malwarescore=0 bulkscore=0 mlxlogscore=891 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2407110000 definitions=main-2408300102 X-Proofpoint-GUID: iLWdzg-JYMvruQDjRvfYKsxVCs1c3vhP X-Proofpoint-ORIG-GUID: iLWdzg-JYMvruQDjRvfYKsxVCs1c3vhP X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: B54D3140012 X-Stat-Signature: 9oxset7ofj1omfs4p84mz4mgezgc1ppd X-Rspam-User: X-HE-Tag: 1725024644-428187 X-HE-Meta: U2FsdGVkX1+50g8ONgUsO7dXoCbPjvhpVOy6ITou6up8TwnpZ13mpde1RiwdBUoHRNkjic7FyT6rQwTNKwwaNYXoCDnq7MGtv+2OYjguQgi3ULSZayG9r8FGmWwbJkqCshMWgefVpqSjrPhFhkEDIM9BhyXhpkR7UZojHiD2mCCUzTLqc4KmMTI2GaTm2eDPpO2vEjpQud6Ncsm/NIQgpVqKLX4ORL5M10h9C+aKQBaPekr/vh6HAkkH0kVSjxUaO8d95pQAggweEknGPeDGSICr6NOQIG7hF5KDUulpfcEkMH2bwrSogmN8A1QQxtFzK2lS/dEL3OYCh4HkPIzG7KfixsW22Xfmh5oWwrggM6Nouj+R1t8egAdyuTdtcu23pc7QfUX1r1C9/337XtmzIGe+26c6GWiarNWEWnFWDQKtN0oNp5QRsed54s+SBGaQ2dSMycfYKSaXmvW0pwKagn6lkZbcOmudJPehzjhebuCmHCTH0xvTK0FCnw5us93LpoSoGSWeaC66xuoDWZJbC5ih0OSf8/d7te4KkgB+dXZpdMfbi1wi0jhBav18zAHsabUcyZS9pLu2GULOUTgpYg7x6V6rIBxOCrwLocBZkwfM+2ZkQ3S5T4RInFy9C10J9QUy/im/3Odb1h94v51r9FKUMYCmgu0OCapgSYZEqXIdiv08D8pA7fkhzBE5cdncZjMHpx0ZYmViWPRBVnPaR9aqfnsFG9+LyBvs/MRo55ZyhEgVrpZbvHszhyDFcybiTo0Pdn//jQyHIrhNo0MmKlJtq2emhp/9TO9HIVhHhnxFM/dvwd8/VsZuHX28QtxMkH1JXJINgAeSMBxR0HPkiQRDrC+rmUFpee0NI1WEgfk4FvBdjkFyL3UJKEin0IiyCWf304tKzdM+OcwrgYc3K65y55Gx/wuKMBgEX2kNuukmeggtHfLqdIHzE3krdpb17tVHCCzKNo1CFbvdwJW pOasVvWQ jldhzkAXJsSbjFnSV1eMaQmU8FvOcZcKDDdxBbmDjVKg91ISEfxPclnsSJTLGWJDZpc4uljlcydmLSNlMncy81dp4+KcHrLy3RSmGIHwa+8HsSskjlinfXOXsSaulfenQol3b4cIWIZM1s7MYPsbSRbUsQx2hCAOu8dmtWstSIX4fgiidPY1rI/OwO1QVDZsgkzGgIEdEaGm3K/0hmAaJhqll8W0CbNIZ0Z0rOV7nISZOKxyPCG8ggypQlTvPAHuLwzpqrZf5ZKCHHAHWECpKmXL05Eypg3i50y9Y+QphH/Qz6oNxx79ICty/qBEo6e1LgJfqFWrqhiEw4VVrZpShR4zv+49CLgCjc3cj195/8gTar43Exzwvh5n3pQYdvBFrB2r+3u2sZbS8bBcW6UQFXxZB/aIYebXZ/6Sq1FkClehXyHH2X9y9jhrgWygCs8cBDTzYWJRg+ZFvHPR+1w7nDoOcdvaBACrhRP+53paUgEZIjFLGXhxctze+cD8eVPYRumQP8HoCOG4/pLKAXrRLL44KQBYAGMA/tFRoIOzNWJefXbqSHK1J3GyTBl0nByZi4oRKMM4B5QWnM8iT7OyqBDEt6gKzrGTTb/nYiQaypJI8uVEohPZz0qs/F3hSn8+a3CuZJbtqmi8tJgcURsF6dvL/lTwjsAY/GolDQ/uSbzVF9DQaRs8rzPB4YA== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000312, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: * Wei Yang [240830 04:47]: > On Fri, Aug 30, 2024 at 12:12:14AM -0400, Liam R. Howlett wrote: > >* Wei Yang [240829 22:57]: > >> This patch tries to cleanup some interface description: > >> > >> * function name mismatch > >> * parameter name mismatch > >> * parameter all end up with ':' > >> * not prefix '*' if parameter is a pointer > > > >Why not use * if the parameter is a pointer? > > This tries to comply with kernel doc format. > > If you prefix a '*' in kenrel doc, ./scripts/kernel-doc would report a > warning. Thanks. I wanted those so that it was overly obvious when they were used wrong but I guess they have to go. > > > > >> > >> There is still some missing description of parameters, I didn't add them > >> since I am not sure the exact meaning. > >> > >> Signed-off-by: Wei Yang > >> --- > >> v2: > >> * not change them to kernel doc since they are internal interface > > > >Thanks, since they are not internal interfaces, could you also change > >the patch description to state that? > > > > Sorry for the un-precise change log. > > s/interface/function/ looks good? Yes. Thanks, Liam