Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
docs: kdoc: trim __cacheline_group_* with the other annotations
The special case for __cacheline_group_begin/end() can be handled by just
adding another pattern to the struct_prefixes, eliminating the need for a
special case in push_parameter().
One change is that these annotations no longer appear in the rendered
output, just like all the other annotations that we clean out.
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
+1
-6
+1
-6
scripts/lib/kdoc/kdoc_parser.py
+1
-6
scripts/lib/kdoc/kdoc_parser.py
···
90
90
(KernRe(r'\s*CRYPTO_MINALIGN_ATTR', re.S), ' '),
91
91
(KernRe(r'\s*____cacheline_aligned_in_smp', re.S), ' '),
92
92
(KernRe(r'\s*____cacheline_aligned', re.S), ' '),
93
+
(KernRe(r'\s*__cacheline_group_(begin|end)\([^\)]+\);'), ''),
93
94
#
94
95
# Unwrap struct_group macros based on this definition:
95
96
# __struct_group(TAG, NAME, ATTRS, MEMBERS...)
···
447
446
param = "{unnamed_" + param + "}"
448
447
self.entry.parameterdescs[param] = "anonymous\n"
449
448
self.entry.anon_struct_union = True
450
-
451
-
# Handle cache group enforcing variables: they do not need
452
-
# to be described in header files
453
-
elif "__cacheline_group" in param:
454
-
# Ignore __cacheline_group_begin and __cacheline_group_end
455
-
return
456
449
457
450
# Warn if parameter has no description
458
451
# (but ignore ones starting with # as these are not parameters