mirror of
https://github.com/fish-shell/fish-shell.git
synced 2024-11-27 19:53:36 +08:00
af61ea1325
We are using only :: in a synopsis for fishscript examples given of the command being documented.
45 lines
1.0 KiB
ReStructuredText
45 lines
1.0 KiB
ReStructuredText
.. _cmd-fish_prompt:
|
|
|
|
fish_prompt - define the appearance of the command line prompt
|
|
==============================================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
``fish_prompt``
|
|
::
|
|
|
|
function fish_prompt
|
|
...
|
|
end
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
The ``fish_prompt`` function is executed when the prompt is to be shown, and the output is used as a prompt.
|
|
|
|
The exit status of commands within ``fish_prompt`` will not modify the value of :ref:`$status <variables-status>` outside of the ``fish_prompt`` function.
|
|
|
|
``fish`` ships with a number of example prompts that can be chosen with the ``fish_config`` command.
|
|
|
|
|
|
Example
|
|
-------
|
|
|
|
A simple prompt:
|
|
|
|
|
|
|
|
::
|
|
|
|
function fish_prompt -d "Write out the prompt"
|
|
# This shows up as USER@HOST /home/user/ >, with the directory colored
|
|
# $USER and $hostname are set by fish, so you can just use them
|
|
# instead of using `whoami` and `hostname`
|
|
printf '%s@%s %s%s%s > ' $USER $hostname \
|
|
(set_color $fish_color_cwd) (prompt_pwd) (set_color normal)
|
|
end
|
|
|
|
|