Re: [PATCH] drm/i915: fix Sphinx build duplicate label warning

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Fri, 17 Apr 2020, Chris Wilson <chris@xxxxxxxxxxxxxxxxxx> wrote:
> 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@xxxxxxxxx>
>
> Reviewed is probably too strong, but I comprehend your problem
> statement, if not entirely grokking Sphinx,

Thanks for the review, pushed with some more explanation of the exact
failure mode added to the commit message.

BR,
Jani.

-- 
Jani Nikula, Intel Open Source Graphics Center
_______________________________________________
Intel-gfx mailing list
Intel-gfx@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/intel-gfx



[Index of Archives]     [AMD Graphics]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux