Skip to content

Sync kernel-doc.py with Linux upstream

Mauro Carvalho Chehab qemu-arm qemu-devel 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest1 patch 8 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/1kernel-doc.py: sync with upstream Kernel v6.19-rc4scripts/lib/kdoc/kdoc_files.py scripts/lib/kdoc/kdoc_item.py scripts/lib/kdoc/kdoc_output.py +2 more+554 -4741 reply

Reviews trailers per patch

The patch has a Reviewed-by or Acked-by of their own; the series has one for all of them.

PatchPeter MaydellMichael S. Tsirkin
SeriesR-b
1/1A-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

Cover letter [PATCH 0/1] Sync kernel-doc.py with Linux upstream

Hi Peter/John,

There were several updates at kernel-doc upstream fixing bugs, doing cleanups and a couple of improvements.

Better to keep QEMU in sync with such changes.

Worth mentioning that we did some changes on Linux at the kernel-doc.py script itself, to avoid Kernel build to crash with too old Python versions, as there docs build is a separate target, and python >= 3.6 is a new requirement there.

On kernel, if python < 3.6, it will simply ignore docs build (emitting a warning).

I opted to not backport such changes, but if you prefer doing that, I can do that on a v2.

---

For now, I opted to keep kernel-doc libraries at the same directory as before - e.g. at scripts/lib/kdoc. On Linux, we ended moving it to tools/lib/python/kdoc. It could make sense to move it on QEMU too, as it makes a little bit easier to keep things in sync.

What do you think?

Mauro Carvalho Chehab (1):
kernel-doc.py: sync with upstream Kernel v6.19-rc4

 scripts/lib/kdoc/kdoc_files.py  |  11 +-
 scripts/lib/kdoc/kdoc_item.py   |   3 +-
 scripts/lib/kdoc/kdoc_output.py |  93 +++-
 scripts/lib/kdoc/kdoc_parser.py | 897 ++++++++++++++++----------------
 scripts/lib/kdoc/kdoc_re.py     |  24 +-
 5 files changed, 554 insertions(+), 474 deletions(-)
Signature · 1 line
2.52.0