aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2025-10-10 09:10:38 +0000
committerDaniel Eklöf <daniel@ekloef.se>2025-10-10 09:10:38 +0000
commit7ed36c10334c0b2480fa026238f8f1791d2f9439 (patch)
treedffe1021b5d308fb856185d8f64c7a7197df145a /doc
parentchangelog: updated jump label colors in modus-operandi (diff)
config: add colors.dim-blend-towards=black|white
Before this patch, we always blended towards black when dimming text. However, with light color themes, it usually looks better if we dim towards white instead. This option allows you to choose which color to blend towards. The default is 'black' in '[colors]', and 'white' in '[colors2]'. Closes #2187
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd14
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 7b08d5d4..8697add2 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -1031,7 +1031,8 @@ dark theme (since the default theme is dark).
a color value, and a "dim" attribute.
By default, foot implements this by blending the current color
- with black. This is a generic approach that applies to both
+ with black or white, depending on what the *dim-blend-towards*
+ option is set to . This is a generic approach that applies to both
colors from the 256-color palette, as well as 24-bit RGB colors.
You can change this behavior by setting the *dimN* options. When
@@ -1086,6 +1087,14 @@ dark theme (since the default theme is dark).
Default: _default_
+*dim-blend-towards*
+ Which color to blend towards when "auto" dimming a color (see
+ *dim0*..*dim7* above). One of *black* or *white*. Blending towards
+ black makes the text darker, while blending towards white makes it
+ whiter (but still dimmer than normal text).
+
+ Default: _black_ (*colors*), _white_ (*colors2*)
+
*selection-foreground*, *selection-background*
Foreground (text) and background color to use in selected
text. Default: _inverse foreground/background_.
@@ -1124,7 +1133,8 @@ dark theme (since the default theme is dark).
# SECTION: colors2
This section defines an alternative color theme. It has the exact same
-keys as the *colors* section. The default values are the same.
+keys as the *colors* section. The default values are the same, except
+for *dim-blend-towards*, which defaults to *white* instead.
Note that values are not inherited. That is, if you set a value in
*colors*, but not in *colors2*, the value from *colors* is not