Skip to content

Several kdoc fixes

Mauro Carvalho Chehab linux-doc linux-hardening lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest18 patches 5 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/18docs: kdoc_re: add support for groups()tools/lib/python/kdoc/kdoc_re.py+7 -00 replies
2/18docs: kdoc_re: don't go past the end of a linetools/lib/python/kdoc/kdoc_re.py+1 -10 replies
3/18docs: kdoc_parser: move var transformers to the beginningtools/lib/python/kdoc/kdoc_parser.py+13 -100 replies
4/18docs: kdoc_parser: don't mangle with function definestools/lib/python/kdoc/kdoc_parser.py+7 -50 replies
5/18docs: kdoc_parser: fix variable regexes to work with size_ttools/lib/python/kdoc/kdoc_parser.py+4 -30 replies
6/18docs: kdoc_parser: fix the default_value logic for variablestools/lib/python/kdoc/kdoc_parser.py+2 -20 replies
7/18docs: kdoc_parser: don't exclude defaults from prototypetools/lib/python/kdoc/kdoc_parser.py+0 -10 replies
8/18docs: kdoc_parser: fix parser to support multi-word typestools/lib/python/kdoc/kdoc_parser.py+2 -24 replies
9/18docs: kdoc_parser: add support for LIST_HEADtools/lib/python/kdoc/kdoc_parser.py+1 -00 replies
10/18docs: kdoc_parser: handle struct member macro VIRTIO_DECLARE_FEATURES(name)tools/lib/python/kdoc/kdoc_parser.py+1 -00 replies
11/18docs: kdoc_re: better show KernRe() at documentationtools/lib/python/kdoc/kdoc_re.py+22 -10 replies
12/18docs: kdoc_parser: move transform lists to a separate fileDocumentation/tools/kdoc_parser.rst tools/lib/python/kdoc/kdoc_files.py tools/lib/python/kdoc/kdoc_parser.py +1 more+168 -1410 replies
13/18docs: xforms_lists: ignore context analysis and lock attributestools/lib/python/kdoc/kdoc_parser.py tools/lib/python/kdoc/xforms_lists.py+15 -00 replies
14/18docs: kdoc_re: handle strings and escape chars on NextMatchtools/lib/python/kdoc/kdoc_re.py+18 -00 replies
15/18docs: kdoc_re: don't recompile NestedMatch regex every timetools/lib/python/kdoc/kdoc_re.py+22 -130 replies
16/18docs: kdoc_re: Change NestedMath args replacement to \0tools/lib/python/kdoc/kdoc_parser.py tools/lib/python/kdoc/kdoc_re.py+5 -50 replies
17/18docs: kdoc_re: make NestedMatch use KernRetools/lib/python/kdoc/kdoc_parser.py tools/lib/python/kdoc/kdoc_re.py+29 -200 replies
18/18docs: kdoc_parser: move nested match transforms to xforms_lists.pytools/lib/python/kdoc/kdoc_parser.py tools/lib/python/kdoc/xforms_lists.py+13 -220 replies

Reviews trailers per patch

17 of 18 patches have a Reviewed-by or Acked-by.

PatchRandy DunlapAleksandr LoktionovMauro Carvalho Chehab
1/18A-b T-b R-b
2/18A-b T-b R-b
3/18A-b T-b R-b
4/18A-b T-b R-b
5/18A-b T-b R-b
6/18A-b T-b R-b
7/18A-b T-b R-b
8/18A-b T-b R-b
9/18A-b T-b R-b
10/18R-b
11/18R-b
12/18R-b
13/18R-b R-b
14/18R-b
15/18R-b
16/18R-b
17/18R-b
18/18

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes. Scroll the table sideways for all 3 reviewers.

Read the v1 thread

Cover letter [PATCH 00/18] Several kdoc fixes

Hi Jon,

This series contains patches from:

	https://lore.kernel.org/linux-doc/[email protected]/T/#t

I rebased them to make the changes cleaner, fixing mostly on fixes.

I dropped stuff related to NestedMatch arguments parsing. I'll be sending you on a new patch series, likely tomorrow.

The changes here basically addresses several issues discoverd by Randy and by me and makes NestedMatch more similar to KernRe.

It also moves the transforms ruleset to a separate file, to make easier to maintain kernel-doc code.

Mauro Carvalho Chehab (16):
docs: kdoc_re: add support for groups()
docs: kdoc_re: don't go past the end of a line
docs: kdoc_parser: move var transformers to the beginning
docs: kdoc_parser: don't mangle with function defines
docs: kdoc_parser: fix variable regexes to work with size_t
docs: kdoc_parser: fix the default_value logic for variables
docs: kdoc_parser: don't exclude defaults from prototype
docs: kdoc_parser: fix parser to support multi-word types
docs: kdoc_parser: add support for LIST_HEAD
docs: kdoc_re: better show KernRe() at documentation
docs: kdoc_parser: move transform lists to a separate file
docs: kdoc_re: handle strings and escape chars on NextMatch
docs: kdoc_re: don't recompile NestedMatch regex every time
docs: kdoc_re: Change NestedMath args replacement to \0
docs: kdoc_re: make NestedMatch use KernRe
docs: kdoc_parser: move nested match transforms to xforms_lists.py

Randy Dunlap (2):
docs: kdoc_parser: handle struct member macro
VIRTIO_DECLARE_FEATURES(name)
docs: xforms_lists: ignore context analysis and lock attributes

 Documentation/tools/kdoc_parser.rst   |   8 ++
 tools/lib/python/kdoc/kdoc_files.py   |   3 +-
 tools/lib/python/kdoc/kdoc_parser.py  | 172 +++-----------------------
 tools/lib/python/kdoc/kdoc_re.py      | 115 +++++++++++++----
 tools/lib/python/kdoc/xforms_lists.py | 170 +++++++++++++++++++++++++
 5 files changed, 286 insertions(+), 182 deletions(-)
 create mode 100644 tools/lib/python/kdoc/xforms_lists.py
Signature · 1 line
2.52.0