Update docs of font_features to note that it is not needed for main font configuration anymore

This commit is contained in:
Kovid Goyal
2024-06-24 11:14:21 +05:30
parent c4d634d143
commit fb19bf057e
2 changed files with 10 additions and 16 deletions

View File

@@ -134,8 +134,11 @@ Note that this refers to programming ligatures, typically implemented using the
opt('+font_features', 'none', option_type='font_features', ctype='!font_features',
add_to_default=False, long_text='''
Choose exactly which OpenType features to enable or disable. This is useful as
some fonts might have features worthwhile in a terminal. For example, Fira Code
Choose exactly which OpenType features to enable or disable. Note that for the
main fonts, features can be specified when selecting the font using the choose-fonts kitten.
This setting is useful for fallback fonts.
Some fonts might have features worthwhile in a terminal. For example, Fira Code
includes a discretionary feature, :code:`zero`, which in that font changes the
appearance of the zero (0), to make it more easily distinguishable from Ø. Fira
Code also includes other discretionary features known as Stylistic Sets which
@@ -152,19 +155,8 @@ feature in the italic font but not in the regular font.
On Linux, font features are first read from the FontConfig database and then
this option is applied, so they can be configured in a single, central place.
To get the PostScript name for a font, use ``kitty +list-fonts --psnames``:
.. code-block:: sh
$ kitty +list-fonts --psnames | grep Fira
Fira Code
Fira Code Bold (FiraCode-Bold)
Fira Code Light (FiraCode-Light)
Fira Code Medium (FiraCode-Medium)
Fira Code Regular (FiraCode-Regular)
Fira Code Retina (FiraCode-Retina)
The part in brackets is the PostScript name.
To get the PostScript name for a font, use the ``fc-scan file.ttf`` command on Linux
or the `Font Book tool on macOS <https://apple.stackexchange.com/questions/79875/how-can-i-get-the-postscript-name-of-a-ttf-font-installed-in-os-x>`__.
Enable alternate zero and oldstyle numerals::