diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index c6d299d26..e5dcb0ab3 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -969,7 +969,12 @@ The tab bar style, can be one of:
 '''
     )
 
-opt('tab_bar_align', 'left', choices=('left', 'center', 'right'), long_text='The horizontal alignment of the tab bar')
+opt('tab_bar_align', 'left', choices=('left', 'center', 'right'),
+    long_text='''
+The horizontal alignment of the tab bar, can be one of: :code:`left`,
+:code:`center`, or :code:`right`.
+'''
+    )
 
 opt('tab_bar_min_tabs', '2',
     option_type='tab_bar_min_tabs', ctype='uint',
@@ -1136,12 +1141,19 @@ opt('background_image', 'none',
 
 opt('background_image_layout', 'tiled',
     choices=('mirror-tiled', 'scaled', 'tiled', 'clamped'), ctype='bglayout',
-    long_text='Whether to tile, scale or clamp the background image.'
+    long_text='''
+Whether to tile, scale or clamp the background image. The value can be one of
+:code:`tiled`, :code:`mirror-tiled`, :code:`scaled`, :code:`clamped`.
+'''
     )
 
 opt('background_image_anchor', 'top-left',
     choices=('top-left', 'top', 'top-right', 'left', 'center', 'right', 'bottom-left', 'bottom', 'bottom-right'), ctype='bganchor',
-    long_text='Where to position the background image in the window.'
+    long_text='''
+Where to position the background image in the window. The value can be one of:
+:code:`top-left`, :code:`top`, :code:`top-right`, :code:`left`, :code:`center`,
+:code:`right`, :code:`bottom-left`, :code:`bottom`, :code:`bottom-right`.
+'''
     )
 
 opt('background_image_linear', 'no',