[PATCH v3 00/21] Update Documentation/ cross references and fix issues

Subsystems: arm/coresight framework and drivers, can network drivers, chinese documentation, dma buffer sharing framework, documentation, drm drivers, drm drivers and misc gpu patches, drm gpu scheduler, elm327 can network driver, ext4 file system, filesystems (vfs and infrastructure), filesystems [netfs library], hugetlb subsystem, intel sgx, kernel virtual machine (kvm), kfence, led subsystem, memory management, pci endpoint subsystem, pci subsystem, the rest, tracing, x86 architecture (32-bit and 64-bit) · Maintainers: Suzuki K Poulose, Marc Kleine-Budde, Vincent Mailhol, Alex Shi, Yanteng Si, Sumit Semwal, Christian König, Philipp Stanner, Jonathan Corbet, David Airlie, Simona Vetter, Maarten Lankhorst, Maxime Ripard, Thomas Zimmermann, Matthew Brost, Danilo Krummrich, Max Staudt, "Theodore Ts'o", Alexander Viro, Christian Brauner, David Howells, Paulo Alcantara, Muchun Song, Oscar Salvador, Jarkko Sakkinen, Paolo Bonzini, Alexander Potapenko, Marco Elver, Lee Jones, Pavel Machek, Andrew Morton, Manivannan Sadhasivam, Krzysztof Wilczyński, Bjorn Helgaas, Linus Torvalds, Steven Rostedt, Masami Hiramatsu, Thomas Gleixner, Ingo Molnar, Borislav Petkov, Dave Hansen

Series: 21 patches touching 21 files, +34/-17

STALE1571d PENDING · 7 of 21 reviewed

Status: Pending, 7 of 21 reviewed.

2 messages, 1 author, 2022-07-09 · open the first message on its own page

[PATCH v3 00/21] Update Documentation/ cross references and fix issues

From: Mauro Carvalho Chehab <mchehab@kernel.org>
Date: 2022-07-09 10:07:50

This series fix almost all fixable issues when building the html docs at
linux-next (next-20220608):

- Address some broken cross-references;
- Fix kernel-doc warnings;
- Fix bad tags on ReST files.

With this series applied, plus other pending patches that should hopefully
be merged in time for the next merge window, htmldocs build will produce
just 4 warnings with Sphinx 2.4.4.

Sphinx >=3 will produce some extra false-positive warnings due to conflicts
between structs and functions sharing the same name. Hopefully this will
be fixed either on a new Sphinx 5.x version or Sphinx 6.0.

Mauro Carvalho Chehab (21):
  docs: networking: update netdevices.rst reference
  docs: update vmalloced-kernel-stacks.rst reference
  docs: update vmemmap_dedup.rst reference
  docs: zh_CN: page_migration: fix reference to mm index.rst
  dt-bindings: arm: update arm,coresight-cpu-debug.yaml reference
  x86/sgx: fix kernel-doc markups
  fscache: fix kernel-doc documentation
  fs: namei: address some kernel-doc issues
  drm/scheduler: fix a kernel-doc warning
  drm/scheduler: add a missing kernel-doc parameter
  kfence: fix a kernel-doc parameter
  genalloc: add a description for start_addr parameter
  textsearch: document list inside struct ts_ops
  dcache: fix a kernel-doc warning
  docs: ext4: blockmap.rst: fix a broken table
  docs: PCI: pci-vntb-function.rst: Properly include ascii artwork
  docs: PCI: pci-vntb-howto.rst: fix a title markup
  docs: virt: kvm: fix a title markup at api.rst
  docs: ABI: sysfs-bus-nvdimm
  docs: leds: index.rst: add leds-qcom-lpg to it
  Documentation: coresight: fix binding wildcards

 Documentation/ABI/testing/sysfs-bus-nvdimm             |  2 ++
 Documentation/PCI/endpoint/pci-vntb-function.rst       |  2 +-

25 more lines

[PATCH v3 01/21] docs: networking: update netdevices.rst reference

From: Mauro Carvalho Chehab <mchehab@kernel.org>
Date: 2022-07-09 10:09:15

Changeset 482a4360c56a ("docs: networking: convert netdevices.txt to ReST")
renamed: Documentation/networking/netdevices.txt
to: Documentation/networking/netdevices.rst.

Update its cross-reference accordingly.

Fixes: 482a4360c56a ("docs: networking: convert netdevices.txt to ReST")
Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>
---

To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
See [PATCH v3 00/21] at: https://lore.kernel.org/all/cover.1657360984.git.mchehab@kernel.org/

 drivers/net/can/can327.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/drivers/net/can/can327.c b/drivers/net/can/can327.c
index 5da7778d92dc..925e880bf570 100644
--- a/drivers/net/can/can327.c
+++ b/drivers/net/can/can327.c
@@ -827,7 +827,7 @@ static netdev_tx_t can327_netdev_start_xmit(struct sk_buff *skb,
 	netif_stop_queue(dev);
 
 	/* BHs are already disabled, so no spin_lock_bh().
-	 * See Documentation/networking/netdevices.txt
+	 * See Documentation/networking/netdevices.rst
 	 */
 	spin_lock(&elm->lock);
 	can327_send_frame(elm, frame);
-- 
2.36.1
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help