[Intel-gfx] [PATCH] drm/i915: fix Sphinx build duplicate label warning

Chris Wilson chris at chris-wilson.co.uk
Fri Apr 17 14:08:18 UTC 2020


Quoting Jani Nikula (2020-04-17 14:01:09)
> Fix the warning caused by enabling the autosectionlabel extension in the
> kernel Sphinx build:
> 
> Documentation/gpu/i915.rst:610: WARNING: duplicate label
> gpu/i915:layout, other instance in Documentation/gpu/i915.rst
> 
> In the warning message, Sphinx is unable to reference the labels in
> their true locations in the kernel-doc comments in source. In this case,
> there's "Layout" sections in both gt/intel_workarounds.c and
> i915_reg.h. Rename the section in the latter to "File Layout".
> 
> Fixes: 58ad30cf91f0 ("docs: fix reference to core-api/namespaces.rst")
> Signed-off-by: Jani Nikula <jani.nikula at intel.com>

Reviewed is probably too strong, but I comprehend your problem
statement, if not entirely grokking Sphinx,

Reviewed-by: Chris Wilson <chris at chris-wilson.co.uk>
-Chris


More information about the Intel-gfx mailing list