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

[Rodrigo Vivi]

On Thu, Aug 10, 2017 at 9:13 AM, Jani Nikula  wrote:
> On Thu, 10 Aug 2017, Rodrigo Vivi  wrote:
>> On Thu, Aug 10, 2017 at 5:29 AM, Jani Nikula  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.

Oh I see... makes sense

Reviewed-by: Rodrigo Vivi 

>
> BR,
> Jani.
>
>>
>>>
>>> Signed-off-by: Jani Nikula 
>>> ---
>>>  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



-- 
Rodrigo Vivi
Blog: http://blog.vivi.eng.br
___
Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/intel-gfx

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

[Jani Nikula]

On Thu, 10 Aug 2017, Rodrigo Vivi  wrote:
> On Thu, Aug 10, 2017 at 5:29 AM, Jani Nikula  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 
>> ---
>>  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
___
Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/intel-gfx

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

[Rodrigo Vivi]

On Thu, Aug 10, 2017 at 5:29 AM, Jani Nikula  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?

>
> Signed-off-by: Jani Nikula 
> ---
>  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
>



-- 
Rodrigo Vivi
Blog: http://blog.vivi.eng.br
___
Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/intel-gfx

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

[Jani Nikula]

Remove old warning about docproc directive that's not supported in the
Sphinx toolchain.

Signed-off-by: Jani Nikula 
---
 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

___
Intel-gfx mailing list
Intel-gfx@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/intel-gfx