diff options
author | Fabian Homborg <FHomborg@gmail.com> | 2015-12-17 15:17:28 +0100 |
---|---|---|
committer | Fabian Homborg <FHomborg@gmail.com> | 2015-12-17 15:25:13 +0100 |
commit | 8a6f26ff9bd260101b56b1de39adbf5992fb27a8 (patch) | |
tree | b92730368c12beb6c5dbacdc7dc05a45e6c4a006 | |
parent | 71435121983cba54f15aff819929faedbae1ac8a (diff) |
Document prompt_pwd
Fixes #253
-rw-r--r-- | doc_src/prompt_pwd.txt | 28 | ||||
-rw-r--r-- | share/functions/prompt_pwd.fish | 6 |
2 files changed, 34 insertions, 0 deletions
diff --git a/doc_src/prompt_pwd.txt b/doc_src/prompt_pwd.txt new file mode 100644 index 00000000..7161d8aa --- /dev/null +++ b/doc_src/prompt_pwd.txt @@ -0,0 +1,28 @@ +\section prompt_pwd prompt_pwd - Print pwd suitable for prompt + +\subsection prompt_pwd-synopsis Synopsis +\fish{synopsis} +prompt_pwd +\endfish + +\subsection prompt_pwd-description 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, set $fish_prompt_pwd_dir_length to the number of characters. Setting it to 0 or an invalid value will disable shortening entirely. + +\subsection prompt_pwd-example Examples + +\fish +>_ 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 +\endfish diff --git a/share/functions/prompt_pwd.fish b/share/functions/prompt_pwd.fish index c519c6cc..96e9b2f3 100644 --- a/share/functions/prompt_pwd.fish +++ b/share/functions/prompt_pwd.fish @@ -1,4 +1,10 @@ function prompt_pwd --description "Print the current working directory, shortened to fit the prompt" + set -q argv[1]; and switch $argv[1] + case -h --help + __fish_print_help prompt_pwd + return 0 + end + # This allows overriding fish_prompt_pwd_dir_length from the outside (global or universal) without leaking it set -q fish_prompt_pwd_dir_length; or set -l fish_prompt_pwd_dir_length 1 |