aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2021-02-14 13:18:11 +0000
committerDaniel Eklöf <daniel@ekloef.se>2021-02-21 19:15:31 +0000
commit06a9ffa7632abf201b0ea0270bb5058af4fc4a6b (patch)
tree7280dcfd13e641526278628bf663df830a81d848 /doc
parenturls: remove free-form ‘text’ member from URL struct (diff)
urls: add key binding that toggles whether URLs are displayed on jump-label
By default, the URL isn’t shown on the jump-label. For auto-detect URLs, doing so is virtually always useless, as the URL is already visible in the grid. For OSC-8 URLs however, the URL is often _not_ visible in the grid. Many times, seeing the URL is still not needed (if you’re doing ‘ls --hyperlink’, you already know what the URIs are). But it is still useful to have a way to show the URLs. This patch adds a new key binding action that can be used in url-mode to toggle the URL on and off in the jump label. It is bound to ctrl+t by default.
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 0d25fe12..6c1938a2 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -610,6 +610,20 @@ mode. The syntax is exactly the same as the regular **key-bindings**.
Exits URL mode without opening an URL. Default: _Control+g
Control+d Escape_.
+*toggle-url-visible*
+ By default, the jump label only shows the key sequence required to
+ activate it. This is fine as long as the URL is visible in the
+ original text.
+
+ But with e.g. OSC-8 URLs (the terminal version of HTML anchors,
+ i.e. "links"), the text on the screen can be something completey
+ different than the URL.
+
+ This action toggles between showing and hiding the URL on the jump
+ label.
+
+ Default: _Control+t_
+
# SECTION: mouse-bindings