fish-shell/doc_src/cmds/realpath.rst

.. program::realpath

realpath - convert a path to an absolute path without symlinks
==============================================================

Synopsis
--------

**realpath** [*options*] *PATH*

Description
-----------

:program:`realpath` follows all symbolic links encountered for the provided ``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.

If a :command:`realpath` command exists, it will be preferred.
``builtin realpath`` will eplicitly use this implementation.

The following options are available:

- ``-s`` or ``--no-symlinks``: Don't resolve symlinks, only make paths absolute, squash multiple slashes and remove trailing slashes.
Long march towards more structured text 2021-11-12 12:20:51 +00:00			`.. program::realpath`
docs: Add labels to all commands This allows us to use :ref: references, which don't require hardcoding it as html [ci skip] 2019-03-31 09:05:09 +00:00
doc: homogenize commands titles 2020-03-31 15:37:38 +00:00			`realpath - convert a path to an absolute path without symlinks`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`==============================================================`
Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00
Migrate the 'synopsis' sections to .rst format 2018-12-18 01:58:24 +00:00			`Synopsis`
			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Long march towards more structured text 2021-11-12 12:20:51 +00:00			`realpath [options] PATH`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Description`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-----------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Long march towards more structured text 2021-11-12 12:20:51 +00:00			:program:`realpath` follows all symbolic links encountered for the provided ``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.`
docs: improve realpath documentation 2019-09-17 12:48:22 +00:00
Long march towards more structured text 2021-11-12 12:20:51 +00:00			If a :command:`realpath` command exists, it will be preferred.
			``builtin realpath`` will eplicitly use this implementation.
builtin realpath: Add --no-symlinks option Taken from GNU realpath, this one makes realpath not resolve symlinks. It still makes paths absolute and handles duplicate and trailing slashes. (useful in fish_add_path) 2020-09-12 17:26:04 +00:00
			`The following options are available:`

fish_add_path: Don't resolve symlinks The case for symlinked directories being duplicated a lot isn't there, but there is a usecase for adding the symlink rather than the target, and that's homebrew. E.g. homebrew installs ruby into /usr/local/Cellar/ruby/2.7.1_2/bin, and links to it from /usr/local/opt/ruby/bin. If we add the target, we would miss updates. Having path entries that point to the same location isn't a big problem - it's a path lookup, so it takes a teensy bit longer. The canonicalization is mainly so paths don't end up duplicated via weird spelling and so relative paths can be used. 2020-09-12 17:28:01 +00:00			- ``-s`` or ``--no-symlinks``: Don't resolve symlinks, only make paths absolute, squash multiple slashes and remove trailing slashes.