Rework cursor config documentation
The documentation of the cursor fields has been completely reworked in
an attempt to make it more obvious what the specific fields in the
config are about.
diff --git a/alacritty.yml b/alacritty.yml
index 2858295..d1fb196 100644
--- a/alacritty.yml
+++ b/alacritty.yml
@@ -109,13 +109,15 @@
foreground: '0xeaeaea'
bright_foreground: '0xeaeaea'
- # Colors the cursor will use if `custom_cursor_colors` is true
cursor:
- # Use custom cursor colors. If true, always display the cursor in the
- # `colors.cursor.text` and `colors.cursor.cursor` colors,
- # otherwise invert the colors of the background and foreground.
+ # If this is `false` the text cursor inverses
+ # the foreground and background colors.
custom_colors: false
+ # Text color when the cursor is above a character.
+ # Only used when `custom_colors` is `true`.
text: '0x000000'
+ # Cursor color.
+ # Only used when `custom_colors` is `true`.
cursor: '0xffffff'
# Normal colors
@@ -223,13 +225,16 @@
dynamic_title: true
cursor:
- # Style of the cursor
+ # This is the default look of your text cursor.
+ # It might be overwritten by applications like `vim`.
#
- # Values for 'cursor_style':
- # - Block
- # - Underline
- # - Beam
+ # Values for `style`:
+ # - Block (Looks like: ▒)
+ # - Underline (Looks like: _)
+ # - Beam (Looks like: |)
style: Block
+ # When this is `true`, the text cursor is temporarily
+ # hidden when typing.
hide_when_typing: false
# Live config reload (changes require restart)
diff --git a/alacritty_macos.yml b/alacritty_macos.yml
index 99ca4c9..797bd36 100644
--- a/alacritty_macos.yml
+++ b/alacritty_macos.yml
@@ -89,13 +89,15 @@
foreground: '0xeaeaea'
bright_foreground: '0xeaeaea'
- # Colors the cursor will use if `custom_cursor_colors` is true
cursor:
- # Use custom cursor colors. If true, always display the cursor in the
- # `colors.cursor.text` and `colors.cursor.cursor` colors,
- # otherwise invert the colors of the background and foreground.
+ # If this is `false` the text cursor inverses
+ # the foreground and background colors.
custom_colors: false
+ # Text color when the cursor is above a character.
+ # Only used when `custom_colors` is `true`.
text: '0x000000'
+ # Cursor color.
+ # Only used when `custom_colors` is `true`.
cursor: '0xffffff'
# Normal colors
@@ -204,13 +206,16 @@
dynamic_title: true
cursor:
- # Style of the cursor
+ # This is the default look of your text cursor.
+ # It might be overwritten by applications like `vim`.
#
- # Values for 'cursor_style':
- # - Block
- # - Underline
- # - Beam
+ # Values for `style`:
+ # - Block (Looks like: ▒)
+ # - Underline (Looks like: _)
+ # - Beam (Looks like: |)
style: Block
+ # When this is `true`, the text cursor is temporarily
+ # hidden when typing.
hide_when_typing: false
# Live config reload (changes require restart)
