diff --git a/docs/kittens/choose-fonts.rst b/docs/kittens/choose-fonts.rst index f9bcb0320..69c05f910 100644 --- a/docs/kittens/choose-fonts.rst +++ b/docs/kittens/choose-fonts.rst @@ -112,7 +112,9 @@ that is, they are used to set the variable value for some font characteristic. ``features`` A space separated list of OpenType font features to enable/disable or select a value of, for this font. Consult the documentation for the font - family to see what features it supports and their effects. + family to see what features it supports and their effects. The exact syntax + for specifying features is `documented by HarfBuzz + `__ ``system`` This can be used to pass an arbitrary string, usuall a family or full name diff --git a/kitty/options/definition.py b/kitty/options/definition.py index 21ad24e7c..8517888b7 100644 --- a/kitty/options/definition.py +++ b/kitty/options/definition.py @@ -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 `__. Enable alternate zero and oldstyle numerals::