From 454939d5ab027b8bf7fc636f25f10ae637699c84 Mon Sep 17 00:00:00 2001 From: Fabian Boehm Date: Fri, 27 Mar 2026 16:23:06 +0100 Subject: [PATCH] Update docs for fish_emoji_width defaulting to 2 --- doc_src/faq.rst | 2 +- doc_src/language.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc_src/faq.rst b/doc_src/faq.rst index d25dec9f1..0d6b1488a 100644 --- a/doc_src/faq.rst +++ b/doc_src/faq.rst @@ -329,7 +329,7 @@ Sometimes, there is disagreement on the width. There are numerous causes and fix - It is possible the character is too new for your system to know - in this case you need to refrain from using it. - Fish or your terminal might not know about the character or handle it wrong - in this case fish or your terminal needs to be fixed, or you need to update to a fixed version. - The character has an "ambiguous" width and fish thinks that means a width of X while your terminal thinks it's Y. In this case you either need to change your terminal's configuration or set $fish_ambiguous_width to the correct value. -- The character is an emoji and the host system only supports Unicode 8, while you are running the terminal on a system that uses Unicode >= 9. In this case set $fish_emoji_width to 2. +- The character is an emoji and your system only supports Unicode 8. In this case set $fish_emoji_width to 1. This also means that a few things are unsupportable: diff --git a/doc_src/language.rst b/doc_src/language.rst index 6902563fe..9b7b5097a 100644 --- a/doc_src/language.rst +++ b/doc_src/language.rst @@ -1573,7 +1573,7 @@ You can change the settings of fish by changing the values of certain variables. .. envvar:: fish_emoji_width - controls whether fish assumes emoji render as 2 cells or 1 cell wide. This is necessary because the correct value changed from 1 to 2 in Unicode 9, and some terminals may not be aware. Set this if you see graphical glitching related to emoji (or other "special" characters). It should usually be auto-detected. + controls whether fish assumes emoji render as 2 cells or 1 cell wide. This is necessary because the correct value changed from 1 to 2 in Unicode 9, and some terminals may not be aware. Set this if you see graphical glitching related to emoji (or other "special" characters). It defaults to 2. .. envvar:: fish_autosuggestion_enabled