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 4BA33CEE356 for ; Wed, 9 Oct 2024 22:02:38 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 96EEB6B007B; Wed, 9 Oct 2024 18:02:37 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 91D366B0082; Wed, 9 Oct 2024 18:02:37 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7E4696B0083; Wed, 9 Oct 2024 18:02:37 -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 5F6C76B007B for ; Wed, 9 Oct 2024 18:02:37 -0400 (EDT) Received: from smtpin07.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 26C9FC0175 for ; Wed, 9 Oct 2024 22:02:34 +0000 (UTC) X-FDA: 82655438754.07.3AD57A9 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf30.hostedemail.com (Postfix) with ESMTP id 26A6580016 for ; Wed, 9 Oct 2024 22:02:33 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=siatCB37; dmarc=none; spf=none (imf30.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=rdunlap@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1728511205; 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=HCh2YRncTzKIRqu2AgE80f/pX5qYbpsU8s2PLS/3fiY=; b=i/suySeAv95LpWjEmpzM8IlpHcc+mwk4/OiONC013n4pR4GYeXTdttwS1WLxgCf/5/rzNk P+kS4mBcdnAWP1nnA1fJm8uZek3r3LYXv6W4mQGtm0UDcNAE3vqGSb9ujNJ1ocupP5r1qH traUqcaZI7p7rW81ST/fcboLe2iwT3c= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1728511205; a=rsa-sha256; cv=none; b=LAiWGJ6iiWaXwETJzM9KnFtfOogfTlPkq1Itia0ydcNC7qfc/LNcwpkYEdkXicDGjBkWfh PYgKUkLsX587Z2PBoCbZy9VWlmpfV8GiwjKyNjuPgMAt8LAwCVPiluqaNVsYSx4eC3nn6n D6Q0hSoACXYx5oZTZMlNnchOgCVJSdk= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=siatCB37; dmarc=none; spf=none (imf30.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=rdunlap@infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; 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=HCh2YRncTzKIRqu2AgE80f/pX5qYbpsU8s2PLS/3fiY=; b=siatCB378wZ3PecidgHlodLsex G1r8lDqv5Z4b9Wh+HbDnMJDIjPhqKzdI5yth6fslhdRCR00CuFmOv8bmsHzUjG2+5iXz54XiAtZ3W ZZcoL6GMe9w9uDpplmzXJMe0YpKn6X/Y8wdI8v0ZE/SV2Hvnke3FV9mh8l71qX3JLARJmInhSCfI9 wdVNdtc2boSApVioXl9+BzYWqe+wXhctgVLNUFFS49ostn5cq85XguCi8D2jQefgTTSu4bqhDvvlB H+nypnR6VGVHoapUMg13yB8vcUAR1mptFZs5BtQ1LRMCnEkC2d9eYDpcPSlUmFyWTwt4LTCmtLbNt oXAxMy8A==; Received: from [50.53.2.24] (helo=[192.168.254.17]) by casper.infradead.org with esmtpsa (Exim 4.98 #2 (Red Hat Linux)) id 1syelC-00000005vRL-0jx9; Wed, 09 Oct 2024 22:02:24 +0000 Message-ID: <8b0c1bb9-4a9a-4f8e-87df-275994df739d@infradead.org> Date: Wed, 9 Oct 2024 15:02:17 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] mm, slab: add kerneldocs for common SLAB_ flags To: Jonathan Corbet , Vlastimil Babka , David Rientjes , Christoph Lameter Cc: Hyeonggon Yoo <42.hyeyoo@gmail.com>, Roman Gushchin , Andrew Morton , linux-mm@kvack.org, linux-doc@vger.kernel.org References: <20241009142936.56092-2-vbabka@suse.cz> <878quxe2kw.fsf@trenco.lwn.net> <878quxb4rm.fsf@trenco.lwn.net> Content-Language: en-US From: Randy Dunlap In-Reply-To: <878quxb4rm.fsf@trenco.lwn.net> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 26A6580016 X-Stat-Signature: 9eu9gbfupf3txnahrdxbjm7s8u85s7bo X-Rspam-User: X-HE-Tag: 1728511353-153002 X-HE-Meta: U2FsdGVkX19Jn23RxAqrsPq4JIdaBWpNftVhaQ5z8ebdTk12hZ9HG+FomUsdHC1QBCgEbM4DJJ6IG9vqleQfvTsLPCw1r5jxa+ROy/qRIDB37k3mqjVZoA9CjIxjfxxbUzkHLOosY/Sy8BPJLykuBuswHksElMEVPUgL+JbjxY1O8ElR7n4lvpt7pc5rdvjyYJZ9e50LZ5swPSwQ5HBGNUb/8yUErhkDi4PHP7mnIKc7xerQQ6uPOZHtj2MrkPDGFp8KujCwW29rq+4Q2nIuI3XrRWf+uygJ2q7Y5ZVwYGQR3Ft1q4Hv3HRlDCFkmopWLm38iJhotzf2d88SRmG0uAJHf0+GKOmw3DAIUqZUXVcoZJx/g6Im5Khr2lJ30rsiWcFeQdEwH0QCMQR+ctww5mFWsg3dweT/OIswciAEMtcJNHELml8NqP1y9kSo3fMQyQGthaTmMYstXjNSPKb1hvRxWoBEkQTimnpnqfzmos3e5sPFWeho+TAsm2hFgPdFt72XRzxnJ5cg1r5F0AxZ7cQJc6Wy6CUqhcuFMi173XdtQo0jZHen2xMpILq/oNJOa8M/CtiMqLyG7S69vkMeg6a33LK18bd2skR69qM2DgSpj8CyPcraBxJDN9f1saorRsXSbSIAco+htggG2N3jcgA1dos0mbzF6LBfBTGlPf+9ZB/2X4mJ6XfyrYesa6wPnBZtvQ7YbwndRGg5dcROgObjPyjjrLlk4kodVJvLU8R/YvMbWBSnqDlnZm/vsrC4K94CkLdtnnmrelypqSqxuuWJZJfNVkquFvcaW6CxUIHdx8NONPUEjq8NakF+YF2bohG0xaw6LgISPEg1xGG6Mp90w4+fZGY3CNNPCJGLyDc542BZkgswhRzBlcPGNCBzxZvmcMapYETwfIYRIj8JWdOhEvtPE5/jYs0+vjEQhuZTbhLZWzaVccQfP01Ll8q2neHmwi8eUK1OY8EqKLw hhsZW1Dv RocnCofUH7GUgmWjvxIjSwhUDfz/FN38qVX7Ez9wxOnjMMtQKudnTa7Y17DL4eLUw51fAhF2pFufkIadcDqJsJibdRDzvwd2VtFgquRLSOdlEWT13YA+rJDf27p4HOvFLWMVUZ1bDblbUxIH6DktkeLX58hVhTZg8Mn8pFZZt6U3d+DjnPa20X412zMnocuk88Cq5HUx92rcQYYD72YGxnhpQmgBpafGTEc247Fh0u/4qhFqRcJqHY4JNtFlUAAlO+3p8hOZRLowzDfH7+N5vVU+yOGicZFiF6s8WWLvSVXekOb7wWncYujlKbXctXPY6ex+5Lzoax6F2QLXnOFZ3hO0lPuOlyZkmWfddjiGbVIVMB0A2VBQX/VM4Fq2rPwbO2LuZ 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 10/9/24 9:49 AM, Jonathan Corbet wrote: > Vlastimil Babka writes: > >> Thanks for the hints. I hope if we can agree that documenting the macros was >> intended to be supported, doesn't break the build (there are users already) >> and has only those minor rendering issues, it can be used? > > I'd totally forgotten that this was supposed to work. > > Yes it can be used... $WE just need to find a way to make it work > properly. The code probably isn't expecting a macro on the right side. I'll take a look, but no promises. > > Every now and then I ponder rewriting kernel-doc in Rust, both to make > it more reasonable to modify and as a learning exercise. But then I > come to my senses and go back to stuff that actually needs to get done. That's a good way to lose helpers, although it might also gain you a few... Yesh, I know, current is Perl. -- ~Randy