On Wed, Aug 03, 2022 at 09:24:49AM +0200, Ricardo Cañuelo wrote: > Hi Matthew, > > On mar, ago 02 2022 at 16:56:48, Matthew Wilcox <willy@xxxxxxxxxxxxx> wrote: > > You don't need to use :c:func:`foo`. You can just write foo() and the > > tooling will convert it into :c:func:`foo` for you. > > Thanks for the tip. However, I did some tests and the results aren't > quite the same. For functions with kerneldocs that are referenced in the > same document (.. kernel-doc::) the tool does efectively link to the > generated documentation, but for all the other functions using > c:func:`foo` generates a different formatting than `foo`, which does no > formatting at all. I didn't say `foo`, I said foo(). This is handled by Documentation/sphinx/automarkup.py. To quote the doc-guide: Please note that there is no need to use ``c:func:`` to generate cross references to function documentation. Due to some Sphinx extension magic, the documentation build system will automatically turn a reference to ``function()`` into a cross reference if an index entry for the given function name exists. If you see ``c:func:`` use in a kernel document, please feel free to remove it.
