docs: fix documentation build parsing errors
Status from this message: Applied, thanks.
Get series with b4
b4 am [email protected]Versions newest first
Patches in v1 Applied
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/30 | .gitignore: docs: ignore sphinx_*/ directories.gitignore | +3 | 1 reply | |
| 2/30 | kernel-doc: include line numbers for function prototypesscripts/ | +2 | 0 replies | |
| 3/30 | dt-bindings: fix references to files converted to yamlDocumentation/ Documentation/ Documentation/ +5 more | +16 | 0 replies | |
| 4/30 | docs: hwmon: adm1266.rst: fix a broken referenceDocumentation/ | +1 | 0 replies | |
| 5/30 | docs: scheduler: fix the directory name on two filesDocumentation/ Documentation/ | +2 | 1 reply | |
| 6/30 | docs: trace: fix the location of kprobes.rstDocumentation/ samples/ samples/ | +3 | 0 replies | |
| 7/30 | MAINTAINERS: fix location of qlogic/LICENSE.qla3xxxMAINTAINERS | +1 | 0 replies | |
| 8/30 | docs: fix location of nommu-mmap.rst fileinit/ mm/ mm/ | +3 | 0 replies | |
| 9/30 | net: appletalk: Kconfig: Fix docs locationdrivers/ | +1 | 0 replies | |
| 10/30 | drivers: net: hamradio: fix document locationdrivers/ | +1 | 0 replies | |
| 11/30 | tools: docs: memory-model: fix references for some filestools/ tools/ | +2 | 0 replies | |
| 12/30 | scripts: device_attr_show.cocci: update location of sysfs docscripts/ | +1 | 0 replies | |
| 13/30 | docs: SafeSetID: fix a warningDocumentation/ | +1 | 0 replies | |
| 14/30 | docs: add some new files to their respective index.rst filesDocumentation/ Documentation/ Documentation/ +1 more | +4 | 0 replies | |
| 15/30 | docs: powerpc: syscall64-abi.rst: fix a malformed tableDocumentation/ | +16 | 0 replies | |
| 16/30 | docs: watch_queue: fix some warningsDocumentation/ | +9 | 0 replies | |
| 17/30 | docs: kvm: api.rst: add missing spacesDocumentation/ | +1 | 0 replies | |
| 18/30 | block: bio: fix a warning at the kernel-doc markupsblock/ | +1 | 0 replies | |
| 19/30 | docs: soundwire: fix some identation at stream.rstDocumentation/ | +4 | 0 replies | |
| 20/30 | docs: dma-buf: fix some warningsDocumentation/ | +1 | 0 replies | |
| 21/30 | iio: industrialio-core.c: solve a kernel-doc warningdrivers/ | +1 | 0 replies | |
| 22/30 | kunit: test.h: solve kernel-doc warningsinclude/ | +8 | 0 replies | |
| 23/30 | docs: submitting-patches: use :doc: for referencesDocumentation/ | +8 | 0 replies | |
| 24/30 | docs: lockdep-design: fix some warning issuesDocumentation/ | +40 | 0 replies | |
| 25/30 | docs: admin-guide: net.rst: add a missing blank lineDocumentation/ | +1 | 0 replies | |
| 26/30 | iio: iio.h: fix a warning at the kernel-doc markupinclude/ | +1 | 2 replies | |
| 27/30 | docs: bio: fix a kerneldoc markupblock/ | +1 | 0 replies | |
| 28/30 | drivers: core: fix kernel-doc markup for dev_err_probe()drivers/ | +5 | 0 replies | |
| 29/30 | kunit: test.h: fix a bad kernel-doc markupinclude/ | +2 | 0 replies | |
| 30/30 | docs: amdgpu: fix a warning when building the documentationDocumentation/ | +2 | 0 replies |
Reviews trailers per patch
2 of 30 patches have a Reviewed-by or Acked-by.
| Patch | Valentin Schneider | Jonathan Cameron |
|---|---|---|
| 1/30 | ||
| 2/30 | ||
| 3/30 | ||
| 4/30 | ||
| 5/30 | R-b | |
| 6/30 | ||
| 7/30 | ||
| 8/30 | ||
| 9/30 | ||
| 10/30 | ||
| 11/30 | ||
| 12/30 | ||
| 13/30 | ||
| 14/30 | ||
| 15/30 | ||
| 16/30 | ||
| 17/30 | ||
| 18/30 | ||
| 19/30 | ||
| 20/30 | ||
| 21/30 | ||
| 22/30 | ||
| 23/30 | ||
| 24/30 | ||
| 25/30 | ||
| 26/30 | A-b | |
| 27/30 | ||
| 28/30 | ||
| 29/30 | ||
| 30/30 |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.
Cover letter [PATCH 00/30] docs: fix documentation build parsing errors
Currently, there are several warnings/errors produced when building the documentation with "make htmldocs".
This series fixes almost all such errors. It is produced against linux-next, branch next-20200909.
Some of the patches here were already sent individually, but nobody picked them. So, I'm re-sending the full series.
After this series, there will be just two parse warnings due to Documentation/bpf/ringbuf.rst, which seems to have been included at linux-next before the actual feature. I already wrote an e-mail to the author asking for a fix.
There are still plenty warnings produced by kernel-doc, but those are due to missing files and/or parameters, like:
./include/linux/blk-mq.h:267: warning: Function parameter or member 'active_queues_shared_sbitmap' not described in 'blk_mq_tag_set' ./drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c:1: warning: no structured comments found ./drivers/gpu/drm/amd/amdgpu/amdgpu_device.c:675: warning: Excess function parameter 'dev' description in 'amdgpu_device_asic_init' ./drivers/usb/typec/bus.c:1: warning: 'typec_altmode_unregister_driver' not found
As time allows, I will try to cleanup most of those too, although some may require a deeper knowledge of the affected subsystems.
Jon,
I know that you don't like very much patches against linux-next, but that seems to be the only way to address issues when building the docs, as warnings can come from random trees.
My suggestion would be for you to pick at least the ones that apply cleanly on your tree. I can rebase the ones later for them to be applied along the merge window.
I'm aiming here to have Kernel 5.10 free of documentation warnings. Hopefully, people will take more care to avoid introducing new warnings once we get rid of all of them.
Mauro Carvalho Chehab (30):
.gitignore: docs: ignore sphinx_*/ directories
kernel-doc: include line numbers for function prototypes
dt-bindings: fix references to files converted to yaml
docs: hwmon: adm1266.rst: fix a broken reference
docs: scheduler: fix the directory name on two files
docs: trace: fix the location of kprobes.rst
MAINTAINERS: fix location of qlogic/LICENSE.qla3xxx
docs: fix location of nommu-mmap.rst file
net: appletalk: Kconfig: Fix docs location
drivers: net: hamradio: fix document location
tools: docs: memory-model: fix references for some files
scripts: device_attr_show.cocci: update location of sysfs doc
docs: SafeSetID: fix a warning
docs: add some new files to their respective index.rst files
docs: powerpc: syscall64-abi.rst: fix a malformed table
docs: watch_queue: fix some warnings
docs: kvm: api.rst: add missing spaces
block: bio: fix a warning at the kernel-doc markups
docs: soundwire: fix some identation at stream.rst
docs: dma-buf: fix some warnings
iio: industrialio-core.c: solve a kernel-doc warning
kunit: test.h: solve kernel-doc warnings
docs: submitting-patches: use :doc: for references
docs: lockdep-design: fix some warning issues
docs: admin-guide: net.rst: add a missing blank line
iio: iio.h: fix a warning at the kernel-doc markup
docs: bio: fix a kerneldoc markup
drivers: core: fix kernel-doc markup for dev_err_probe()
kunit: test.h: fix a bad kernel-doc markup
docs: amdgpu: fix a warning when building the documentation
.gitignore | 3 + Documentation/admin-guide/LSM/SafeSetID.rst | 2 +- Documentation/admin-guide/sysctl/net.rst | 1 + .../bindings/display/tilcdc/tilcdc.txt | 2 +- .../bindings/mailbox/omap-mailbox.txt | 2 +- .../devicetree/bindings/media/i2c/tvp5150.txt | 2 +- .../bindings/pwm/google,cros-ec-pwm.yaml | 2 +- .../bindings/soc/qcom/qcom,smd-rpm.yaml | 2 +- .../bindings/sound/google,cros-ec-codec.yaml | 2 +- Documentation/driver-api/dma-buf.rst | 2 +- Documentation/driver-api/nvdimm/index.rst | 1 + Documentation/driver-api/soundwire/stream.rst | 8 +-- Documentation/firmware-guide/acpi/index.rst | 1 + Documentation/gpu/amdgpu.rst | 4 +- Documentation/hwmon/adm1266.rst | 2 +- Documentation/hwmon/index.rst | 1 + Documentation/locking/lockdep-design.rst | 69 +++++++++++-------- Documentation/powerpc/syscall64-abi.rst | 32 ++++----- Documentation/process/submitting-patches.rst | 20 +++--- Documentation/scheduler/sched-capacity.rst | 2 +- Documentation/scheduler/sched-energy.rst | 2 +- Documentation/trace/kprobetrace.rst | 2 +- Documentation/virt/kvm/api.rst | 2 +- Documentation/vm/index.rst | 1 + Documentation/watch_queue.rst | 14 ++-- MAINTAINERS | 20 +++--- block/bio.c | 4 +- drivers/base/core.c | 7 +- drivers/iio/industrialio-core.c | 2 +- drivers/net/appletalk/Kconfig | 2 +- drivers/net/hamradio/scc.c | 2 +- .../bindings/net/wireless/siliabs,wfx.txt | 2 +- include/kunit/test.h | 16 +++-- include/linux/iio/iio.h | 2 +- init/Kconfig | 2 +- mm/Kconfig | 2 +- mm/nommu.c | 2 +- samples/kprobes/kprobe_example.c | 2 +- samples/kprobes/kretprobe_example.c | 2 +- scripts/coccinelle/api/device_attr_show.cocci | 2 +- scripts/kernel-doc | 2 + tools/memory-model/Documentation/README | 2 +- tools/memory-model/Documentation/ordering.txt | 2 +- 43 files changed, 142 insertions(+), 114 deletions(-)
Signature · 1 line
2.26.2