Mirrors/fish-shell
2
0
Fork 0
mirror of https://github.com/fish-shell/fish-shell synced 2024-11-10 15:14:44 +00:00
Code Issues Projects Releases Packages Wiki Activity

document real change

Browse source
This commit is contained in:
Fabian Homborg 2022-01-25 21:25:15 +01:00
parent 479fde27d7
commit 5844164feb
1 changed files with 6 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
doc_src/cmds/path.rst
View file

@ -265,7 +265,7 @@ Examples
``path real`` returns the normalized, physical versions of all paths. That means it resolves symlinks and does what ``path normalize`` does: it squashes duplicate "/" (except for two leading "//"), collapses "../" with earlier components and removes "." components. ``path real`` returns the normalized, physical versions of all paths. That means it resolves symlinks and does what ``path normalize`` does: it squashes duplicate "/" (except for two leading "//"), collapses "../" with earlier components and removes "." components.
It is the same as ``realpath``, as it creates the "real", canonical version of the path. As such it can't operate on nonexistent paths. It is the same as ``realpath``, as it creates the "real", canonical version of the path. However, for nonexistent paths it will resolve as far as it can and normalize the nonexistent part.
It returns 0 if any normalization or resolution was done, i.e. any given path wasn't in canonical form. It returns 0 if any normalization or resolution was done, i.e. any given path wasn't in canonical form.
@ -279,6 +279,11 @@ Examples
# sh here is bash (on an Archlinux system) # sh here is bash (on an Archlinux system)
/usr/bin/bash /usr/bin/bash
>_ path real /bin/foo///bar/../baz
# Assuming /bin exists and is a symlink to /usr/bin, but /bin/foo doesn't.
# This resolves the /bin/ and normalizes the nonexistent rest:
/usr/bin/foo/baz
"change-extension" subcommand "change-extension" subcommand
----------------------------- -----------------------------