Re: [PATCH 1/2] docs: remove :c:func: from genericirq.rst

From: Matthew Wilcox
Date: Fri Oct 04 2019 - 15:07:25 EST


On Fri, Oct 04, 2019 at 10:39:54AM -0600, Jonathan Corbet wrote:
> To make the transition to the new model easier and prevent the breakage
> -of existing implementations, the :c:func:`__do_IRQ` super-handler is still
> +of existing implementations, the __do_IRQ() super-handler is still
> available. This leads to a kind of duality for the time being. Over time
> the new model should be used in more and more architectures, as it
> enables smaller and cleaner IRQ subsystems. It's deprecated for three

...

> @@ -369,7 +369,7 @@ handler(s) to use these basic units of low-level functionality.
> __do_IRQ entry point
> ====================
>
> -The original implementation :c:func:`__do_IRQ` was an alternative entry point
> +The original implementation __do_IRQ() was an alternative entry point
> for all types of interrupts. It no longer exists.

I think someone needs to rationalise these two paragraphs ;-)

__do_IRQ indeed no longer exists (since 2011). It should probably be
removed from the documentation too.