diff --git a/kitty/fonts/core_text.py b/kitty/fonts/core_text.py
index b656ae341..6718fc0f2 100644
--- a/kitty/fonts/core_text.py
+++ b/kitty/fonts/core_text.py
@@ -65,7 +65,7 @@ def find_best_match(family: str, bold: bool = False, italic: bool = False, ignor
         ] == italic else 0
         monospace_match = 1 if candidate['monospace'] else 0
         is_regular_width = not candidate['expanded'] and not candidate['condensed']
-        # prefer demi-bold to bold to heavy, less bold means less chance of
+        # prefer semi-bold to bold to heavy, less bold means less chance of
         # overflow
         weight_distance_from_medium = abs(candidate['weight'])
         return style_match, monospace_match, 1 if is_regular_width else 0, 1 - weight_distance_from_medium
diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index d907e3ccd..542ea4550 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -33,9 +33,11 @@ opt('font_family', 'monospace',
     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, by the OSes font system. Setting
-them manually is useful for font families that have many weight variants like
-Book, Medium, Thick, etc. For example::
+By default they are derived automatically, by the OSes font system. When
+bold_font or bold_italic_font is set to :code:`auto`, 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