Docs: Switch back to vanilla :ref: for commands that should be linked

Unfortunately, currently :program: doesn't link to the program's page.

So we use the old-school :ref: again where we should link, i.e. for
everything that's not the program the current page is about.

Fixes #8438
This commit is contained in:
Fabian Homborg
2021-11-12 18:02:56 +01:00
parent 2e9e94f17e
commit edc09c8419
8 changed files with 16 additions and 10 deletions

View File

@@ -1,3 +1,4 @@
.. _cmd-realpath:
.. program::realpath
realpath - convert a path to an absolute path without symlinks
@@ -11,7 +12,7 @@ Synopsis
Description
-----------
:program:`realpath` follows all symbolic links encountered for the provided :envvar:`PATH`, printing the absolute path resolved. :program:`fish` provides a :command:`realpath`-alike builtin intended to be enrich systems where no such command is installed by default.
:program:`realpath` follows all symbolic links encountered for the provided :envvar:`PATH`, printing the absolute path resolved. :ref:`fish <cmd-fish>` provides a :command:`realpath`-alike builtin intended to be enrich systems where no such command is installed by default.
If a :command:`realpath` command exists, that will be preferred.
``builtin realpath`` will explicitly use the fish implementation of :command:`realpath`.