[PATCH v2 00/32] kernel-doc: update from Linux 5.10

Paolo Bonzini posted 32 patches 3 years, 5 months ago
Test checkpatch passed
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/qemu tags/patchew/20201201103502.4024573-1-pbonzini@redhat.com
Maintainers: Peter Maydell <peter.maydell@linaro.org>
docs/sphinx/kerneldoc.py |   6 +-
scripts/kernel-doc       | 455 +++++++++++++++++++++++++++------------
2 files changed, 324 insertions(+), 137 deletions(-)
[PATCH v2 00/32] kernel-doc: update from Linux 5.10
Posted by Paolo Bonzini 3 years, 5 months ago
v1->v2: fix bisectability (by disabling kernel-doc altogether)
	pass Sphinx version from docs/sphinx/kerneldoc.py
	remove unnecessary s/atomic_/qatomic_/ difference

Alexander A. Klimov (1):
  Replace HTTP links with HTTPS ones: documentation

André Almeida (2):
  kernel-doc: fix processing nested structs with attributes
  kernel-doc: add support for ____cacheline_aligned_in_smp attribute

Jonathan Cameron (1):
  kernel-doc: add support for ____cacheline_aligned attribute

Jonathan Neuschäfer (1):
  scripts/kernel-doc: Add support for named variable macro arguments

Mauro Carvalho Chehab (19):
  scripts: kernel-doc: proper handle @foo->bar()
  scripts: kernel-doc: accept negation like !@var
  scripts: kernel-doc: accept blank lines on parameter description
  scripts/kernel-doc: parse __ETHTOOL_DECLARE_LINK_MODE_MASK
  scripts/kernel-doc: handle function pointer prototypes
  kernel-doc: include line numbers for function prototypes
  scripts: kernel-doc: add support for typedef enum
  scripts: kernel-doc: make it more compatible with Sphinx 3.x
  scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx
    3.x
  scripts: kernel-doc: fix troubles with line counts
  scripts: kernel-doc: reimplement -nofunction argument
  scripts: kernel-doc: fix typedef identification
  scripts: kernel-doc: don't mangle with parameter list
  scripts: kernel-doc: allow passing desired Sphinx C domain dialect
  scripts: kernel-doc: fix line number handling
  scripts: kernel-doc: try to use c:function if possible
  scripts: kernel-doc: fix typedef parsing
  scripts: kernel-doc: split typedef complex regex
  scripts: kernel-doc: use :c:union when needed

Paolo Bonzini (7):
  docs: temporarily disable the kernel-doc extension
  Revert "scripts/kerneldoc: For Sphinx 3 use c:macro for macros with
    arguments"
  Revert "kernel-doc: Use c:struct for Sphinx 3.0 and later"
  Revert "kernel-doc: Handle function typedefs without asterisks"
  Revert "kernel-doc: Handle function typedefs that return pointers"
  Revert "docs: temporarily disable the kernel-doc extension"
  scripts: kernel-doc: remove unnecesssary change wrt Linux

Pierre-Louis Bossart (1):
  scripts/kernel-doc: optionally treat warnings as errors

 docs/sphinx/kerneldoc.py |   6 +-
 scripts/kernel-doc       | 455 +++++++++++++++++++++++++++------------
 2 files changed, 324 insertions(+), 137 deletions(-)

-- 
2.26.2


Re: [PATCH v2 00/32] kernel-doc: update from Linux 5.10
Posted by Peter Maydell 3 years, 5 months ago
On Tue, 1 Dec 2020 at 10:35, Paolo Bonzini <pbonzini@redhat.com> wrote:
>
> v1->v2: fix bisectability (by disabling kernel-doc altogether)
>         pass Sphinx version from docs/sphinx/kerneldoc.py
>         remove unnecessary s/atomic_/qatomic_/ difference

Tested-by: Peter Maydell <peter.maydell@linaro.org>
(build-tested on sphinx 1.6, 2.0, 2.4, 3.0, 3.2).
It doesn't seem sensible to "review" the upstream kernel
changes, but I think this is good to apply.

(We can update docs/sphinx/kerneldoc.py later I guess.)

thanks
-- PMM