Commit 6573d552 authored Nov 07, 2025 by Bagas Sanjaya Committed by Joerg Roedel Nov 07, 2025

Documentation: genpt: Don't use code block marker before iommu_amdv1.c include listing



Stephen Rothwell reports htmldocs warning when merging iommu tree:

Documentation/driver-api/generic_pt.rst:32: WARNING: Literal block expected; none found. [docutils]

This is because of duplicate double colon code block markers: one after
generic_pt/fmt/iommu_amdv1.c and the one in its preceding paragraph. The
resulting htmldocs, however, only marks the include listing (after the
former) up as it should be.

Drop the latter to fix the warning.

Fixes: ab0b5728 ("genpt: Add Documentation/ files")
Reported-by: Stephen Rothwell <sfr@canb.auug.org.au>
Closes: https://lore.kernel.org/linux-next/20251106143925.578e411b@canb.auug.org.au/


Acked-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Jason Gunthorpe <jgg@nvidia.com>
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Signed-off-by: Joerg Roedel <joerg.roedel@amd.com>

parent 6303c018

Documentation/driver-api/generic_pt.rst

+1 −1

Original line number	Diff line number	Diff line
		@@ -27,7 +27,7 @@ compiled into a per-format IOMMU operations kernel module.
		For this to work the .c file for each compilation unit will include both the
		format headers and the generic code for the implementation. For instance in an
		implementation compilation unit the headers would normally be included as
		follows::
		follows:

		generic_pt/fmt/iommu_amdv1.c::