github-mirror/fish-shell
2
0
Fork 0
mirror of https://github.com/fish-shell/fish-shell.git synced 2024-11-27 03:13:37 +08:00
Code Issues Actions Packages Projects Releases 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.
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.
@ -279,6 +279,11 @@ Examples
# sh here is bash (on an Archlinux system)
/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
-----------------------------