Re: Links to sources in docs

[Jani Nikula <jani.nikula@linux.intel.com>]

On Tue, 13 Jan 2026, Petr Vorel <pvorel@suse.cz> wrote:
>> > On Fri, 09 Jan 2026, Petr Vorel <pvorel@suse.cz> wrote:
>> > > Hi Jonathan, all,
>
>> > > I wonder how links in sources work.
>
>> > > Documentation/userspace-api/check_exec.rst has:
>
>> > > `samples/check-exec/inc.c`_ example.
>
>> > There's this bit at the end of check_exec.rst that defines the link:
>
>> > .. _samples/check-exec/inc.c:
>> >    https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/samples/check-exec/inc.c
>
>> > The content within the backticks is just the link text, and has no
>> > filename semantics. See [1] for details.
>
>> Thanks for a hint, I overlooked it.
>
> And I also wonder what does clickable links (e.g. [1]) in
> Documentation/process/adding-syscalls.rst [2]
>
>     - commit 75069f2b5bfb ("vfs: renumber FMODE_NONOTIFY and add to uniqueness
>       check")
>     - commit 12ed2e36c98a ("fanotify: FMODE_NONOTIFY and __O_SYNC in sparc
>       conflict")
>     - commit bb458c644a59 ("Safer ABI for O_TMPFILE")
>
> I haven't found anything in the document itself, nor in conf.py.

It's the automarkup extension, configured in conf.py extensions, and
implemented in Documentation/sphinx/automarkup.py.

BR,
Jani.

>
> Kind regards,
> Petr
>
> [1] https://git.kernel.org/torvalds/c/75069f2b5bfb
> [2] https://docs.kernel.org/process/adding-syscalls.html#references-and-sources
> ...

-- 
Jani Nikula, Intel