Back to Fish

prompt_pwd - print pwd suitable for prompt¶

docs/docs/3.4/cmds/prompt_pwd.html

latest1.7 KB
Original Source

prompt_pwd - print pwd suitable for prompt

Synopsis

prompt\_pwd

Description

prompt_pwd is a function to print the current working directory in a way suitable for prompts. It will replace the home directory with “~” and shorten every path component but the last to a default of one character.

To change the number of characters per path component, pass --dir-length= or set fish_prompt_pwd_dir_length to the number of characters. Setting it to 0 or an invalid value will disable shortening entirely. This defaults to 1.

To keep some components unshortened, pass --full-length-dirs= or set $fish_prompt_pwd_full_dirs to the number of components. This defaults to 1, keeping the last component.

If any positional arguments are given, prompt_pwd shortens them instead of $PWD.

Options

-d or --dir-length MAX

Causes the components to be shortened to MAX characters each. This overrides fish_prompt_pwd_dir_length.

-D or --full-length-dirs NUM

Keeps NUM components (counted from the right) as full length without shortening. This overrides fish_prompt_pwd_full_dirs.

-h or --help

Displays help about using this command.

Examples

\>\_ cd ~/\>\_ echo $PWD/home/alfa\>\_ prompt\_pwd~\>\_ cd /tmp/banana/sausage/with/mustard\>\_ prompt\_pwd/t/b/s/w/mustard\>\_ set -g fish\_prompt\_pwd\_dir\_length 3\>\_ prompt\_pwd/tmp/ban/sau/wit/mustard\>\_ prompt\_pwd --full-length-dirs=2 --dir-length=1/t/b/s/with/mustard