mirror of
https://github.com/fish-shell/fish-shell
synced 2024-11-13 16:37:34 +00:00
26 lines
938 B
Text
26 lines
938 B
Text
\section fish_prompt fish_prompt - define the apperance of the command line prompt
|
|
|
|
\subsection fish_prompt-synopsis Synopsis
|
|
<pre>function fish_prompt
|
|
...
|
|
end</pre>
|
|
|
|
\subsection fish_prompt-description Description
|
|
|
|
By defining the \c fish_prompt function, the user can choose a custom
|
|
prompt. The \c fish_prompt function is executed when the prompt is to
|
|
be shown, and the output is used as a prompt.
|
|
|
|
Please keep in mind that the function is executed by <a
|
|
href='index.html#expand-command-substitution'>command substitution</a>, and so the exit status of commands within fish_prompt will not modify the <a href="index.html#variables-status">$status</a> seen outside of fish_prompt.
|
|
|
|
\subsection fish_prompt-example Example
|
|
|
|
A simple prompt:
|
|
|
|
<pre>
|
|
function fish_prompt -d "Write out the prompt"
|
|
printf '\%s\@\%s\%s\%s\%s> ' (whoami) (hostname|cut -d . -f 1) (set_color \$fish_color_cwd) (prompt_pwd) (set_color normal)
|
|
end
|
|
</pre>
|
|
|