Lets have an eye on patches of the origin kernel-doc script from the kernel sources

[return42]

This is the history of the origin kernel-doc script (Perl) we should have an eye on:

• https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/log/scripts/kernel-doc?qt=grep&q=

• https://salsa.debian.org/guest/kernel-doc/-/commits/rework/scripts/kernel-doc

possible candidates for a takeover:

• kernel-doc: better handle '::' sequences which was improved by kernel-doc: better handle '::' sequences and docs: kernel-doc: properly recognize parameter lines with colons
• kernel-doc: improve parsing for kernel-doc comments syntax
• scripts: kernel-doc: reduce repeated regex expressions into variables e.g. to optimize FUNC_PROTOTYPES ..

linuxdoc/linuxdoc/kernel_doc.py

Lines 215 to 234 in 365757c

	FUNC_PROTOTYPES = [
	# RE(r"^(\w+)\s+\(\*([a-zA-Z0-9_]+)\)\s*\(([^\(]*)\)") # match: void (*foo) (int bar);
	RE(r"^()([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^(\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^(\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^(\w+\s+\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^(\w+\s+\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^(\w+\s+\w+\s+\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^(\w+\s+\w+\s+\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\(]*)\)")
	, RE(r"^()([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+\s+\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+\s+\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+\s+\w+\s+\w+)\s+([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+\s+\w+\s+\w+\s*\*+)\s*([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	, RE(r"^(\w+\s+\w+\s*\*\s*\w+\s*\*+\s*)\s*([a-zA-Z0-9_~:]+)\s*\(([^\{]*)\)")
	]

[c362]

You may be interested in this also:
https://salsa.debian.org/guest/kernel-doc

[return42]

@c362 Thanks! .. I updated my initial #14 (comment)