kdoc: allow dots in inline @param names

Inline kernel-doc blocks failed to parse tags containing dots (e.g. creator.process_name in panfrost_gem.h) because the @name regex only matched word characters. Modify the single-line pattern to match doc_inline_sect so it includes \. and parses the same as a multi-line comment.

Steven Price committed 11 months ago

Commit 9dbbd321 parent 197bbeb1 file · +1 −1Browse files

Showing the changes to tools/lib/python/kdoc (1 of 1 file). Show all

Unified · Split

tools/lib/python/kdoc/kdoc_parser.py+1−1

@@ -53,7 +53,7 @@ doc_content = doc_com_body + KernRe(r'(.*)', cache=False) · 52 unmodified lines
53	doc_inline_start = KernRe(r'^\s/\\\s$', cache=False)	53	doc_inline_start = KernRe(r'^\s/\\\s$', cache=False)
54	doc_inline_sect = KernRe(r'\s\\s(@\s[\w][\w\.]\s):(.*)', cache=False)	54	doc_inline_sect = KernRe(r'\s\\s(@\s[\w][\w\.]\s):(.*)', cache=False)
55	doc_inline_end = KernRe(r'^\s\/\s*$', cache=False)	55	doc_inline_end = KernRe(r'^\s\/\s*$', cache=False)
56	doc_inline_oneline = KernRe(r'^\s/\\\s(@[\w\s]+):\s(.)\s\/\s*$', cache=False)	56	doc_inline_oneline = KernRe(r'^\s/\\\s(@\s[\w][\w\.]\s):\s(.)\s\/\s$', cache=False)
57		57
58	export_symbol = KernRe(r'^\sEXPORT_SYMBOL(_GPL)?\s$\s(\w+)\s$\s*', cache=False)	58	export_symbol = KernRe(r'^\sEXPORT_SYMBOL(_GPL)?\s$\s(\w+)\s$\s*', cache=False)
59	export_symbol_ns = KernRe(r'^\sEXPORT_SYMBOL_NS(_GPL)?\s$\s(\w+)\s,\s"\S+"$\s', cache=False)	59	export_symbol_ns = KernRe(r'^\sEXPORT_SYMBOL_NS(_GPL)?\s$\s(\w+)\s,\s"\S+"$\s', cache=False)