Files
fish-shell/doc_src/cmds/fish_greeting.rst
Nahor 8679464689 color: prefer set_color --reset over set_color normal
`set_color normal` is too ambiguous and easily misinterpreted since
it actually reset all colors and modes instead of resetting just
the foreground color as one without prior knowledge might expect.

Closes #12548
2026-03-25 21:53:05 +08:00

44 lines
1.1 KiB
ReStructuredText

fish_greeting - display a welcome message in interactive shells
===============================================================
Synopsis
--------
.. synopsis::
fish_greeting
::
function fish_greeting
...
end
Description
-----------
When an interactive fish starts, it executes fish_greeting and displays its output.
The default fish_greeting is a function that prints a variable of the same name (``$fish_greeting``), so you can also just change that if you just want to change the text.
While you could also just put ``echo`` calls into config.fish, fish_greeting takes care of only being used in interactive shells, so it won't be used e.g. with ``scp`` (which executes a shell), which prevents some errors.
Example
-------
To just empty the text, with the default greeting function::
set -U fish_greeting
or ``set -g fish_greeting`` in :ref:`config.fish <configuration>`.
A simple greeting:
::
function fish_greeting
echo Hello friend!
echo The time is (set_color yellow)(date +%T)(set_color --reset) and this machine is called $hostname
end