From 1ef2efa0a763bd17faee4957ccae5aec06b0c824 Mon Sep 17 00:00:00 2001 From: NotAShelf Date: Thu, 25 Jun 2026 15:37:43 +0300 Subject: [PATCH] doc: document unicode-input and the kitty keyboard protocol Signed-off-by: NotAShelf Change-Id: I9c6df910f57c42f37344b6859a2b58356a6a6964 --- doc/beer.1.scd | 10 ++++++++++ doc/beer.toml.5.scd | 3 ++- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/beer.1.scd b/doc/beer.1.scd index ef7f85f..ab8ad4d 100644 --- a/doc/beer.1.scd +++ b/doc/beer.1.scd @@ -59,6 +59,8 @@ table of _beer.toml_(5). : Jump to the previous / next shell prompt (OSC 133) | Ctrl+Shift+O : Enter URL hint mode +| Ctrl+Shift+U +: Enter a Unicode codepoint by hex value The *pipe-command-output* action (unbound by default) feeds the last command's output to the configured command; see *shell-integration* in _beer.toml_(5). @@ -69,6 +71,14 @@ previous match, *Down* to the next, and *Escape* exits. In URL hint mode each visible URL is tagged with a label; type the label to open the URL in the configured launcher, or press *Escape* to cancel. +In Unicode codepoint-input mode, type the hexadecimal value of a codepoint (e.g. +_2603_ for a snowman) and press *Return* or *Space* to insert it; *Escape* +cancels. + +*beer* implements the kitty keyboard protocol (progressive enhancement via +*CSI u*), so applications that request it receive disambiguated keys, key +release and repeat events, alternate keys, and associated text. + # MOUSE Left-click and drag selects text; double-click selects a word, triple-click a diff --git a/doc/beer.toml.5.scd b/doc/beer.toml.5.scd index 5ee8ea4..15acd1e 100644 --- a/doc/beer.toml.5.scd +++ b/doc/beer.toml.5.scd @@ -109,7 +109,8 @@ _"none"_ unbinds the chord. Recognized actions: _copy_, _paste_, _paste-primary_, _scrollback-up_, _scrollback-down_, _scrollback-top_, _scrollback-bottom_, _search_, _font-increase_, _font-decrease_, _font-reset_, _fullscreen_, _new-window_, -_jump-prompt-up_, _jump-prompt-down_, _pipe-command-output_, _url-mode_. +_jump-prompt-up_, _jump-prompt-down_, _pipe-command-output_, _url-mode_, +_unicode-input_. ``` [key-bindings]