Skip to content

Fix kernel-doc parser for typedef functions

Mauro Carvalho Chehab linux-media 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest3 patches 1 replyIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/3docs-rst: improve typedef parserscripts/kernel-doc+3 -10 replies
2/3docs-rst: kernel-doc: fix typedef output in RST formatscripts/kernel-doc+23 -90 replies
3/3v4l2-dv-timings.h: let kernel-doc parte the typedef argumentinclude/media/v4l2-dv-timings.h+2 -20 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/3] Fix kernel-doc parser for typedef functions

The kernel-doc parser has two issues when handling typedef functions:

1) its parse is incomplete;
2) it causes warnings when a typedef is used as a function argument.

This series partially addresses (1), adding one extra syntax for the parser. I'm pretty sure that the parser is still incomplete and that we'll get some other places where it fails.

Jon,

My plan is to apply the last patch on my tree, together with a series of patches that I'm writing to fix the warnings on nitpick mode.

The other two patches better fit on your tree, IMHO.

Mauro Carvalho Chehab (3):
docs-rst: improve typedef parser
docs-rst: kernel-doc: fix typedef output in RST format [media] v4l2-dv-timings.h: let kernel-doc parte the typedef argument

 include/media/v4l2-dv-timings.h |  4 ++--
 scripts/kernel-doc              | 36 ++++++++++++++++++++++++++----------
 2 files changed, 28 insertions(+), 12 deletions(-)
Signature · 1 line
2.7.4