From 8c1b1b85381a1c20e1cd145aeb30029945403f6c Mon Sep 17 00:00:00 2001
From: Kirill Chibisov <contact@kchibisov.com>
Date: Thu, 23 Nov 2023 21:54:07 +0400
Subject: [PATCH] Improve section to TOML section refs

This should give more hints where to put things.
---
 extra/man/alacritty.5.scd | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/extra/man/alacritty.5.scd b/extra/man/alacritty.5.scd
index 3fe05905..f7ac1767 100644
--- a/extra/man/alacritty.5.scd
+++ b/extra/man/alacritty.5.scd
@@ -65,7 +65,7 @@ args = [_"-l"_]
 
 # ENV
 
-All key-value pairs in the *env* section will be added as environment variables
+All key-value pairs in the *[env]* section will be added as environment variables
 for any process spawned by Alacritty, including its shell. Some entries may
 override variables set by alacritty itself.
 
@@ -269,6 +269,8 @@ Colors are specified using their hexadecimal values with a _#_ prefix: _#RRGGBB_
 
 *primary*
 
+	This section documents the *[colors.primary]* table of the configuration file.
+
 	*foreground* = _"<string>"_
 
 		Default: _"#d8d8d8"_
@@ -313,7 +315,7 @@ Colors are specified using their hexadecimal values with a _#_ prefix: _#RRGGBB_
 
 *search*
 
-	Colors used for the search bar and match highlighting.
+	This section documents the *[colors.search]* table of the configuration.
 
 	Allowed values are hexadecimal colors like _#ff00ff_, or
 	_CellForeground_/_CellBackground_, which references the affected cell.
@@ -328,6 +330,8 @@ Colors are specified using their hexadecimal values with a _#_ prefix: _#RRGGBB_
 
 *hints*
 
+	This section documents the *[colors.hints]* table of the configuration.
+
 	*start* = { foreground = _"<string>"_, background = _"<string>"_ }
 
 		First character in the hint label.
@@ -373,6 +377,8 @@ Colors are specified using their hexadecimal values with a _#_ prefix: _#RRGGBB_
 
 *normal*
 
+	This section documents the *[colors.normal]* table of the configuration.
+
 	*black* = _"<string>"_
 		Default: _"#181818"_
 	*red* = _"<string>"_
@@ -392,6 +398,8 @@ Colors are specified using their hexadecimal values with a _#_ prefix: _#RRGGBB_
 
 *bright*
 
+	This section documents the *[colors.bright]* table of the configuration.
+
 	*black* = _"<string>"_
 		Default: _"#6b6b6b"_
 	*red* = _"<string>"_
@@ -411,6 +419,8 @@ Colors are specified using their hexadecimal values with a _#_ prefix: _#RRGGBB_
 
 *dim*
 
+	This section documents the *[colors.dim]* table of the configuration.
+
 	If the dim colors are not set, they will be calculated automatically based
 	on the _normal_ colors.
 
@@ -505,7 +515,7 @@ This section documents the *[selection]* table of the configuration file.
 
 This section documents the *[cursor]* table of the configuration file.
 
-*style*
+*style* = { *<shape>*, *<blinking>* }
 
 	*shape* = _"Block"_ | _"Underline"_ | _"Beam"_
 
@@ -524,13 +534,11 @@ This section documents the *[cursor]* table of the configuration file.
 
 		Default: _"Off"_
 
-*vi_mode_style*
+*vi_mode_style* = { *<shape>*, *<blinking>* } | _"None"_
 
 	If the vi mode cursor style is _"None"_ or not specified, it will fall back to
 	the active value of the normal cursor.
 
-	See _cursor.style_ for available options.
-
 	Default: _"None"_
 
 *blink_interval* = _<integer>_