On 1/5/24 21:01, Randy Dunlap wrote: > Since 2014 kernel-doc has supported describing object-like macros > macros but it is not documented anywhere. I should have required > some documentation for it when I merged the patch. :( > > There are currently only 3 uses of this (all in DRM headers, in > include/drm/*.h). There have recently been a few other attempts > at using kernel-doc for object-like macros, but they didn't use the > "define" keyword and I mistakenly told them that kernel-doc does > not support such documentation. :( again. > > Add object-like kernel-doc documentation now so that more may know > about it and use it. > > Fixes: cbb4d3e6510b ("scripts/kernel-doc: handle object-like macros") > Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx> > Cc: Jonathan Corbet <corbet@xxxxxxx> > Cc: linux-doc@xxxxxxxxxxxxxxx > --- > Documentation/doc-guide/kernel-doc.rst | 21 +++++++++++++++++++++ > 1 file changed, 21 insertions(+) Jon, I'm going to send a v2 of this patch. Please don't merge this one. Thanks. -- #Randy