Skip to content

kernel-doc/docproc prep work for reStructuredText

Jani Nikula lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest9 patches 1 replyIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/9kernel-doc: rewrite usage description, remove duplicated commentsscripts/kernel-doc+37 -460 replies
2/9kernel-doc: produce RestructuredText outputscripts/kernel-doc+233 -00 replies
3/9kernel-doc: use rst C domain directives and references for typesscripts/kernel-doc+9 -100 replies
4/9docproc: add variables for subcommand and filenamescripts/docproc.c+11 -60 replies
5/9docproc: reduce unnecessary indentationscripts/docproc.c+47 -460 replies
6/9docproc: abstract docproc directive detectionscripts/docproc.c+20 -100 replies
7/9docproc: abstract terminating lines at first spacescripts/docproc.c+21 -130 replies
8/9docproc: add support for reStructuredText format via --rst optionscripts/docproc.c+80 -100 replies
9/9docproc: print a comment about autogeneration for rst outputscripts/docproc.c+7 -00 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH 0/9] kernel-doc/docproc prep work for reStructuredText

Jon, I was hoping we could consider nudging things forward a bit in the kernel-doc and docproc reStructuredText front already in 4.7. I know it's a bit close to the merge window, but this should not interfere with anything else, and some of it are just trivial cleanups that I've been carrying around locally.

Obviously this doesn't actually add anything that uses them yet, but I think it would be helpful to have some common base in to ease collaboration.

BR,
Jani.

Jani Nikula (8):
kernel-doc: rewrite usage description, remove duplicated comments
kernel-doc: use rst C domain directives and references for types
docproc: add variables for subcommand and filename
docproc: reduce unnecessary indentation
docproc: abstract docproc directive detection
docproc: abstract terminating lines at first space
docproc: add support for reStructuredText format via --rst option
docproc: print a comment about autogeneration for rst output

Jonathan Corbet (1):
kernel-doc: produce RestructuredText output

 scripts/docproc.c  | 221 +++++++++++++++++++++++++++----------
 scripts/kernel-doc | 315 +++++++++++++++++++++++++++++++++++++++++++++--------
 2 files changed, 430 insertions(+), 106 deletions(-)
Signature · 1 line
2.1.4