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 9948BCA0FFC for ; Fri, 30 Aug 2024 14:36:53 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 2F28C6B015E; Fri, 30 Aug 2024 10:36:53 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 2A29D6B015F; Fri, 30 Aug 2024 10:36:53 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 16B806B0160; Fri, 30 Aug 2024 10:36:53 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id EC11D6B015E for ; Fri, 30 Aug 2024 10:36:52 -0400 (EDT) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id A6C6C141A8F for ; Fri, 30 Aug 2024 14:36:52 +0000 (UTC) X-FDA: 82509163464.11.EDD3593 Received: from mail-ed1-f43.google.com (mail-ed1-f43.google.com [209.85.208.43]) by imf17.hostedemail.com (Postfix) with ESMTP id BC59B4001F for ; Fri, 30 Aug 2024 14:36:50 +0000 (UTC) Authentication-Results: imf17.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=iEoehSMM; spf=pass (imf17.hostedemail.com: domain of richard.weiyang@gmail.com designates 209.85.208.43 as permitted sender) smtp.mailfrom=richard.weiyang@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1725028565; a=rsa-sha256; cv=none; b=eW1RVwZ7L80dvPjjYfnBTpH3BGaNrYfJIoAF2XSbXaNeiAcrHmAajn3AUR7Sgg41b5xkQs rBlRFqM7NxwLGXETkS2oko8ooMYjMqaWwDtHRJOvD6tHkgdoIXS+cBmJTJzaKD2NIyIBZE gd74QaWZ2US0Zz+jHOgVWsfH6UMiDxI= ARC-Authentication-Results: i=1; imf17.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=iEoehSMM; spf=pass (imf17.hostedemail.com: domain of richard.weiyang@gmail.com designates 209.85.208.43 as permitted sender) smtp.mailfrom=richard.weiyang@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1725028565; h=from:from:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=fIpKqLpeh7t16FQ1g87VhHjvMhe70CKLe2MkGKRDHY4=; b=pSrs3/LgcUYbQ9fs9hiCgFBxXjv+dR5IuPrSJ5rx5lYPid0J/cYcybKz1sbwEEDT91HZhn IVWeDLmA5fogQ9wzrongVewiLeUALEZOXS4FcFSMUaDyrh/Gum0YiQEYoZUGpBv/9w9kuG Xsq/NAubjmEBoRARHm42ZewkOU8QtCs= Received: by mail-ed1-f43.google.com with SMTP id 4fb4d7f45d1cf-5befd2f35bfso1873917a12.2 for ; Fri, 30 Aug 2024 07:36:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725028609; x=1725633409; darn=kvack.org; h=user-agent:in-reply-to:content-disposition:mime-version:references :reply-to:message-id:subject:to:from:date:from:to:cc:subject:date :message-id:reply-to; bh=fIpKqLpeh7t16FQ1g87VhHjvMhe70CKLe2MkGKRDHY4=; b=iEoehSMMUWGk8PWDbQSm2bWCxLsCHiqO4SCj0dDv8RhTXBeinq/bZc/O6aJb+nQPVH gbKrDafvA5eHkknOVGw5mMfuSuh37ffalSIlvwsryXhHWynbB0lXap/o2HkPkwHvV4cq M7l9YC8RUg1/SomcvIu3wiwkxsvut1sAvwkI4/QKg/jS1ol2in2euuhYG1rgi/InCUHA Z+lfnJKlJYYT92wTcH3lZj6rMlwBxQuZ9Ebi8ZsNHEuEqstBMEzyvLVvSAKXRPpJtGU5 2QecCESd3Qplbv0eZrdy6YrXW0hnOuSWT+1VlRedjkEenLdwPwtGbYzSpWya66Kfzzit 3KwQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725028609; x=1725633409; h=user-agent:in-reply-to:content-disposition:mime-version:references :reply-to:message-id:subject:to:from:date:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=fIpKqLpeh7t16FQ1g87VhHjvMhe70CKLe2MkGKRDHY4=; b=u0owiNcaK55Nq+16whvMVzVO7XvtGUqQdXfyqf5IKulD8FqOh2g1gGcyw1soCJFJUR PdphuJIDtBdP176iWgwRf9eMSjfMSUJGYlvVh4cLU7GdjFP9LM3x5/jd+DGnHO3DMJHt +2mSryhbV5cBdfRmUcDAT48CJaiDJImGYzU0ohx0O0eWp7KcER6LCyYeYabydiOrnjN7 Tn/jzQ8LKeCSQz2TYixtZtE8HTLDz+FXse6LvX43v3Ivy0F5v2s4S4pJP/lL+Ih+Xs+V G1yCjSDk+3+ZEvE1lmBuh9cbrYLa9D/yxfbqmDEI0TTRQR/cWAiI0MqcQxgeOeJLHopF xmQg== X-Forwarded-Encrypted: i=1; AJvYcCUGPJrFf9cqQ0mJZTn3xrsQ6jXsMybRZy0IQgIhGAcMoq7yMShzPoC6ZWfeOryYAPgyj7vPRlWAQw==@kvack.org X-Gm-Message-State: AOJu0YzSSzRCerqga7gkrVb0YsCMVooUGC3Z5QJNwPDeuOl8k/LN4lIr neNe/gMUG/eCGTMGf5SNDtXxILMw9PiX44sCoKPHTj0EAI7aPVgE X-Google-Smtp-Source: AGHT+IFM3spMlcyM4St27W7kxKMIHq5nZuidSCadjY06IzUbJsjOj17UBKzf1IsNHRdZmuaxMOixlg== X-Received: by 2002:a05:6402:3705:b0:5c0:aadc:8b51 with SMTP id 4fb4d7f45d1cf-5c21ed5758emr5788019a12.22.1725028608712; Fri, 30 Aug 2024 07:36:48 -0700 (PDT) Received: from localhost ([185.92.221.13]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-5c225ac5ae6sm2014008a12.0.2024.08.30.07.36.48 (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 30 Aug 2024 07:36:48 -0700 (PDT) Date: Fri, 30 Aug 2024 14:36:47 +0000 From: Wei Yang To: "Liam R. Howlett" , Wei Yang , akpm@linux-foundation.org, maple-tree@lists.infradead.org, linux-mm@kvack.org Subject: Re: [PATCH v2] maple_tree: cleanup interface descriptions Message-ID: <20240830143647.bs5bkmkicb4buqjp@master> Reply-To: Wei Yang References: <20240830025648.22224-1-richard.weiyang@gmail.com> <20240830084701.7omry63kjgy2xsls@master> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: NeoMutt/20170113 (1.7.2) X-Stat-Signature: xpmzrh1fd965r55z6znwpsraoqqkso7i X-Rspamd-Queue-Id: BC59B4001F X-Rspam-User: X-Rspamd-Server: rspam10 X-HE-Tag: 1725028610-463614 X-HE-Meta: U2FsdGVkX19vDf77Kd86XTZrxYFYa+ZllsWYIsPOXw2nt1iLcyuPsBF3wLBD1Zh6FrLHEUsFf2NN0xWozrrN2CSnMErLtkWnZDbOOwlaOw1r+EZfKBE4DIkxbf0dB+WZlBWr6EtmTlUHEwJdqo/SV7ObcZ/0QLZcVoBViepRHsj4EZlvp5hu3uvFQO0oTdecqbzvRdVfJ9kUrY+/Gxz6jWElZPGUHUzW9SPdawEHjEvhTrQTZ3tAnQX/BVsh347wiTCI6wLDdtbYITBERg6gxv2MArwoi3g+gEiywZXCU1yLHtzE7gVBx/573p9rqQXcQypDIgvXuIJuiiBEDcMo1J6gjGzZTKMq6WhL6mVYOh4irpmbj286IXmgfzbivTYU40PBGvCrw/bQ/2HzUi/vD3rgIiG5IxmhV8VnbAMJGgb8f17sdlZwl8v7UUphpSlUheL6Cmc6wd0Nt2klWqALxH02uiFmRr9lxwgCXC/4E3U1BHF/2ai4y2g6gExDiK1MfPGhNzKicHDHOfAkG22dtxoTMK/foY7tG0Hv/cDdzOjNgXT9il8w0cB8YSA1fD/fz7RzUziKyLOmX9ivffUT0vdZUg7I5rGuMuSurIlvaXectXSFdJOqpWJkoyv1vfj7Qiv+cmGyXgwGBwkxfjF8w8V9iDLSAkrsoI3inwIBVf66tnNJxNABnl/ioHVi5ehVX9wBaONSb4Pmy5JsqiWNGamN0zV5BFagaNIt0a1pwJDvK67o967Z0fl1pENfaOefYBI8+oXk/U4dtM6t0dxXjY1b/AuF/Nu6B+xF994aYUN7lK2X8jZzGo/YtK1cD3iFllBvZWDaO+xTtFuEdK9wtRkaN+1Ji9InG56E9KQ53Tgf33q+y7XYEpxTDQT6i2OJuyMEpV0nIa3Jvq30yt0TrlYmA29EhZL44lVS/dbsJ/Rj4QEbvqXFsoEJVYs69GKB4LPQk0laqBCt02bjVL+ c8z0OTcw GNVEghdKltoHCc2q1gFlBPjQhQYGsr9zPKgJYGtdvXZcafKfqJ2MvswHqjnG0Av3MVh8F9LHiW1Y8+2I2uCpcD7PokI50IT1PX07juUqIxzXWOO+TV9f9/1V0GVkybO5CVTDW90gtx3DTwAltUwHNZcxRabyxqb6KSj783QzxsN4wH3dzXjQmC/c36Ail6qUBiW1/4BoehCb+MdLtUhfVmiBg3N6knAxQWv5dyNHz0hVxXf5eBv47fEGnSaEhaMxMwx8yoUBDmwsMuQ8wrVNgJUkhU0P0nz2SQ0zhy4nLSr/uhm047sqfceB04WTJAJAZkH2oWTArEe6ry+SK4tCw5H/ElREnU38vpxeKiPZST64IMkhU2FU6qdG31j4WsyaGcob8TpI6F0kIerQzVo1tNxy9FDAQk/2SS8gHmrS7RwpeK98o9m6wSGMxeVCo1BZ8aF1UPTf58vzOUNYbtbR6abeOpRGpaWERfl+11Q/48rWot4jLsZYx39lzac62z6Mi9syaTckJPzZ+3kUImZER/Xueul7GCTw0n9IpxQt+5wV8S3FfQm1TsIZAKYNJejXpB2ASsthMmcWnkIjA/rcJMPNGHC8Di+BKBUCdI2SzLRjsnWbVRqhcwJYsF4dAe2hoKc5XLiP1exUnP5HrFJGmOlF6kQ1dSBKs7sma6ESBaNPLAWjK7TwvyyrivEsuehVuhoJC X-Bogosity: Ham, tests=bogofilter, spamicity=0.042774, 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 Fri, Aug 30, 2024 at 09:30:37AM -0400, Liam R. Howlett wrote: >* 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. > Not fully get your point. You are fine to keep this change, or prefer me to drop it in next version? -- Wei Yang Help you, Help me