From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D3C8371B35; Tue, 30 Jan 2024 20:18:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=45.79.88.28 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706645897; cv=none; b=HtCRJcDQ1EBN3n6ARfHx3QcoVCNlxhRAKKoFcRYVLxBUq4goH+cLJjL788Lb6fWN+3YnNfEMarLSCUNNLDjJmU0R4a5l9T3XjqVHQV2Nn92UEDpeuIcBQaRiGLjkuFavPWT7nywLRsxJ74MFUvbuchi2Bo3YJw99HbTm4GrPBM8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706645897; c=relaxed/simple; bh=kw4/vZsQ4igABvQM8UwIbtkB/TnHdIU/pnO5e+cNS8k=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=EpjJRm61kUwrzxssde99KjDX34wRr9ZsOqHuUX0moiyJoWct7/6Yvl/opKeBIgBFrABDpds9gOA2GX4qkRgOnXuhZEC1Lgg9Lj8xu2fT3CJWp+4qmcCdScaoZPWJg3z1uIjb96FCLcFAgKkFv/ELtG958bO9ydMRpbvkLNLK/tY= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net; spf=pass smtp.mailfrom=lwn.net; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=g/karfMa; arc=none smtp.client-ip=45.79.88.28 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=lwn.net Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="g/karfMa" DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net E576B41A47 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1706645895; bh=9KysNAjR2JJqZckLeN84dmIjHnc6rN2+vXgE45980uU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=g/karfMalEzLnFfjmYg+HXbUBUv2mpeqvy66J883uo9ZS4xhTNI19ANDbgGhXNt4E qyyje5/F3tftwwKw67XZXbIXuJIixYSm+yAuxgR7ETaeNkun9o1xR//ewH6RJk6pMf nHqNHB5h5fdWDVRQcI8c4dBwviuXjkJI+0+c7ByB0RRUTY1at7XhEqXweYVU0hn0uR HR8ikFK2kmUIu2GuN8NVf6TKHXeJRJ5ZRPHJrY2QZaJZMcm0cdiVB2O6KoxuJaxn8K CG5qwT3CD9I5CWpS6RsFHPPbYKw2B30GNXIxtojAO3XIbw5JAcKgMSF5P/J0ufiohm pjp3598pgy8Hg== Received: from localhost (unknown [IPv6:2601:280:5e00:7e19::646]) (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 E576B41A47; Tue, 30 Jan 2024 20:18:14 +0000 (UTC) From: Jonathan Corbet To: Daniel Vetter , LKML Cc: DRI Development , Daniel Vetter , Randy Dunlap , Thomas Zimmermann , Maxime Ripard , "Steven Rostedt (Google)" , linux-doc@vger.kernel.org, Daniel Vetter Subject: Re: [PATCH] kernel-doc: document object-like preprocessor macros In-Reply-To: <20240109140345.3344094-1-daniel.vetter@ffwll.ch> References: <20240109140345.3344094-1-daniel.vetter@ffwll.ch> Date: Tue, 30 Jan 2024 13:18:14 -0700 Message-ID: <87il3abmnt.fsf@meer.lwn.net> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Daniel Vetter writes: > I had no idea this exists, but Randy pointed out it's been added quite > a long time ago in cbb4d3e6510b ("scripts/kernel-doc: handle > object-like macros"). Definitely way before I started to write all the > drm docs sadly, so there's a few things where I skipped writing > kernel-doc since I didn't know it was possible. > > Fix this asap by documenting the two possible kernel-doc flavours for > preprocessor definitions. > > References: https://lore.kernel.org/dri-devel/dd917333-9ae8-4e76-991d-39b6229ba8ce@infradead.org/ > Cc: Randy Dunlap > Cc: Thomas Zimmermann > Cc: Maxime Ripard > Cc: Daniel Vetter > Cc: "Steven Rostedt (Google)" > Cc: Jonathan Corbet > Cc: linux-doc@vger.kernel.org > Signed-off-by: Daniel Vetter > --- > Documentation/doc-guide/kernel-doc.rst | 26 ++++++++++++++++++++++++++ > 1 file changed, 26 insertions(+) Applied, thanks. jon