aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2021-02-14 20:29:22 +0000
committerDaniel Eklöf <daniel@ekloef.se>2021-02-21 19:15:32 +0000
commit2074f8b6563b7a6331c94a9231cd5b5af8bd7ade (patch)
tree19e61bff351d784e0f2959edd19239bf243fdb53 /doc
parentgrid: refactor: break out allocation of ‘extra’ member to separate function (diff)
urls: OSC-8 URLs can now optionally be underlined outside of url-mode
This patch adds a new configuration option, ‘osc8-underline=url-mode|always’. When set to ‘url-mode’, OSC-8 URLs are only highlighted (i.e. underlined) in url-mode, just like auto-detected URLs. When set to ‘always’, they are always underlined, regardless of mode, and regardless of their other attributes. This is implemented by tagging collected URLs with a boolean, instructing urls_render() and urls_reset() whether they should update the cells’ ‘url’ attribute or not. The OSC-8 collecter sets this based on the value of ‘osc8-underline’. Finally, when closing an OSC-8 URL, the cells are immediately tagged with the ‘url’ attribute if ‘osc8-underline’ is set to ‘always’.
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd14
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index cdcdcfaa..3108c750 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -241,13 +241,25 @@ in this order:
Clipboard target to automatically copy selected text to. One of
*none*, *primary*, *clipboard* or *both*. Default: _primary_.
-
*workers*
Number of threads to use for rendering. Set to 0 to disable
multithreading. Default: the number of available logical CPUs
(including SMT). Note that this is not always the best value. In
some cases, the number of physical _cores_ is better.
+*osc8-underline*
+ When to underline OSC-8 URLs. Possible values are *url-mode* and
+ *always*.
+
+ When set to *url-mode*, OSC-8 URLs are only highlighted in URL
+ mode, just like auto-detected URLs.
+
+ When set to *always*, OSC-8 URLs are always highlighted,
+ regardless of their other attributes (bold, italic etc). Note that
+ this does _not_ make them clickable.
+
+ Default: _url-mode_
+
# SECTION: scrollback