From 9ddcedc1268c30d000cd897670915c007a0cb1c4 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Mon, 24 Jun 2024 11:21:15 +0530 Subject: [PATCH] Update docs of font_family to reference the choose-fonts kitten --- docs/kittens/choose-fonts.rst | 1 + kitty/options/definition.py | 16 ++++------------ 2 files changed, 5 insertions(+), 12 deletions(-) diff --git a/docs/kittens/choose-fonts.rst b/docs/kittens/choose-fonts.rst index 69c05f910..8fefc848b 100644 --- a/docs/kittens/choose-fonts.rst +++ b/docs/kittens/choose-fonts.rst @@ -49,6 +49,7 @@ above the font supports precise weight adjustment. If you are lucky the font designer has included descriptive names for font features, which will be displayed, if not, consult the documentation of the font to see what each feature does. +.. _font_spec_syntax: The font specification syntax -------------------------------- diff --git a/kitty/options/definition.py b/kitty/options/definition.py index 8517888b7..1c8307c5b 100644 --- a/kitty/options/definition.py +++ b/kitty/options/definition.py @@ -35,18 +35,10 @@ and even specify special fonts for particular characters. opt('font_family', 'monospace', option_type='parse_font_spec', long_text=''' You can specify different fonts for the bold/italic/bold-italic variants. -To get a full list of supported fonts use the ``kitty +list-fonts`` command. -By default, they are derived automatically, via the Operating System's font -management. When :opt:`bold_font` or :opt:`bold_italic_font` is set to -:code:`auto` on macOS, the priority of bold fonts is semi-bold, bold, heavy. -Setting them manually is useful for font families that have many weight variants -like Book, Medium, Thick, etc. -For example:: - - font_family Operator Mono Book - bold_font Operator Mono Medium - italic_font Operator Mono Book Italic - bold_italic_font Operator Mono Medium Italic +The easiest way to select fonts is to run the ``kitten choose-fonts`` command +which will present a nice UI for you to select the fonts you want with previews +and support for selecting variable fonts and font features. If you want to learn +to select fonts manually, read the :ref:`font specification syntax `. ''' )