Re: Links to sources in docs

[Petr Vorel <pvorel@suse.cz>]

> > 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.

Kind regards,
Petr

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