[Intel-gfx] [PATCH v2 1/3] Documentation/i915: remove sphinx conversion artefact

Jani Nikula jani.nikula at intel.com
Thu Aug 10 16:13:50 UTC 2017


On Thu, 10 Aug 2017, Rodrigo Vivi <rodrigo.vivi at gmail.com> wrote:
> On Thu, Aug 10, 2017 at 5:29 AM, Jani Nikula <jani.nikula at intel.com> wrote:
>> Remove old warning about docproc directive that's not supported in the
>> Sphinx toolchain.
>
> I got confused... the warning is not supported by sphinx or docproc?

There used to be a docproc directive !C to ensure all (documented?)
functions in the specified file were used in the docbook build. The
docbook -> sphinx conversion retained those as commented out warnings in
the rst source. I don't think we'll have similar functionality in sphinx
anytime soon. So just nuke it.

BR,
Jani.

>
>>
>> Signed-off-by: Jani Nikula <jani.nikula at intel.com>
>> ---
>>  Documentation/gpu/i915.rst | 2 --
>>  1 file changed, 2 deletions(-)
>>
>> diff --git a/Documentation/gpu/i915.rst b/Documentation/gpu/i915.rst
>> index 46875c2bcc31..32c32b89e2e5 100644
>> --- a/Documentation/gpu/i915.rst
>> +++ b/Documentation/gpu/i915.rst
>> @@ -480,5 +480,3 @@ specific details than found in the more high-level sections.
>>
>>  .. kernel-doc:: drivers/gpu/drm/i915/i915_perf.c
>>     :internal:
>> -
>> -.. WARNING: DOCPROC directive not supported: !Cdrivers/gpu/drm/i915/i915_irq.c
>> --
>> 2.11.0
>>

-- 
Jani Nikula, Intel Open Source Technology Center


More information about the Intel-gfx mailing list