From 1f944c1c5464e0f0be99d6231687f935f1eb5fda Mon Sep 17 00:00:00 2001 From: Johannes Altmanninger Date: Thu, 24 Apr 2025 09:31:28 +0200 Subject: [PATCH] set_color.rst: update docs on fallback colors Commit 6fcb418ae39 (Enable 24-bit RGB colors by default, 2025-04-11) invalidated some documentation about fallback colors; by default we prefer RGB unless the user has explicitly set fish_term256=0. Note that this made fallback colors much less useful, because they are only active if the user sets fish_term256=0. Note that setting fish_term24bit=0 is *not* enough; in that case we use the 256 color palette (and assume that it is a subset of the 24-bit colors). We do have some themes that use fallback colors: fish_pager_color_description B3A06D yellow By default, those will be less useful now. See also https://github.com/fish-shell/fish-shell/issues/11393 --- doc_src/cmds/set_color.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc_src/cmds/set_color.rst b/doc_src/cmds/set_color.rst index 31e01acb7..21e2b519b 100644 --- a/doc_src/cmds/set_color.rst +++ b/doc_src/cmds/set_color.rst @@ -30,7 +30,8 @@ If :envvar:`fish_term24bit` is set to 0, fish will translate RGB values to the n If :envvar:`fish_term256` is also set to 0, fish will translate them to the 16-color palette instead. Fish launched as ``fish -d term_support`` will include diagnostic messages that indicate the color support mode in use. -A second color may be given as a desired fallback color. e.g. ``set_color 124212 brblue`` will instruct set_color to use *brblue* if a terminal is not capable of the exact shade of grey desired. This is very useful when an 8 or 16 color terminal might otherwise not use a color. +If multiple colors are specified, fish prefers the first RGB one. +However if :envvar:`fish_term256` is set to 0, fish prefers the first named color specified. The following options are available: