Update docs for fish_emoji_width defaulting to 2

This commit is contained in:
Fabian Boehm
2026-03-27 16:23:06 +01:00
parent 8756bc3afb
commit 454939d5ab
2 changed files with 2 additions and 2 deletions

View File

@@ -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:

View File

@@ -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