aboutsummaryrefslogtreecommitdiff
path: root/doc/foot-ctlseqs.7.scd (follow)
Commit message (Collapse)AuthorAgeLines
* csi: implement private mode 2031 (dark/light mode detection)Daniel Eklöf2025-04-26-0/+10
| | | | | | | | | | | | | | * Recognize 'CSI ? 996 n', and respond with - 'CSI ? 997 ; 1 n' if the primary theme is active - 'CSI ? 997 ; 2 n' if the alternative theme is actice * Implement private mode 2031, where changing the color theme (currently only possible via key bindings) causes the terminal to send the same CSI sequences as above. In this context, foot's primary theme is considered dark, and the alternative theme light (since the default theme is dark). Closes #2025
* doc: ctlseq: add OSC 66 (kitty text sizing)Daniel Eklöf2025-02-06-1/+4
|
* doc: ctlseqs: remove 'CSI 21 t'Daniel Eklöf2025-01-07-3/+0
|
* toplevel-icon: implement OSC-1, CSI 20/21/22/23 tDaniel Eklöf2024-09-13-4/+18
| | | | | | | | | | | | | | * The toplevel icon is now set to the app-id, unless "overridden" by OSC-1 or OSC-0. * Implemented OSC-1 * OSC-0 extended to also set the icon * Implemented CSI 20 t - report window icon * Implemented CSI 21 t - report window title * Implemented CSI 22 ; 1 t - push window icon * Implemented CS 23 ; 1 t - pop window icon * Extended CSI 22/23 ; 0 t to also push/pop the icon * Verify app-id set by OSC-176 is valid UTF-8 * Verify icon set by OSC-0/1 is valid UTF-8
* osc: kitty notifications: implement focus|reportDaniel Eklöf2024-07-23-1/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch adds support for window focusing, and sending events back to the client application when a notification is closed. * Refactor notification related configuration options: - add desktop-notifications sub-section - deprecate 'notify' in favor of 'desktop-notifications.command' - deprecate 'notify-focus-inhibit' in favor of 'desktop-notifications.inhibit-when-focused' * Refactor: rename 'struct kitty_notification' to 'struct notification' * Pass a 'struct notification' to notify_notify(), instead of many arguments. * notify_notify() now registers a reaper callback. When the notifier process has terminated, the notification is considered closed, and we either try to focus (activate) the window, or send an event to the client application, depending on the notification setting. * For the window activation, we need an XDG activation token. For now, assume *everything* written on stdout is part of the token. * Refactor: remove much of the warnings from OSC-99; we don't typically log anything when an OSC/CSI has invalid values. * Add icon support to OSC-99. This isn't part of the upstream spec. Foot's implementation: - uses the 'I' parameter - the value is expected to be a symbolic icon name - a quick check for absolute paths is done, and such icon requests are ignored. * Added ${icon} to the 'desktop-notifications.command' template. Uses the icon specified in the notification, or ${app-id} if not set.
* csi: in-band window resize notifications, private mode 2048Daniel Eklöf2024-07-19-0/+3
| | | | | | | | | | | | | This implements https://gist.github.com/rockorager/e695fb2924d36b2bcf1fff4a3704bd83, in-band window resize notifications. When user enables private mode 2048 (in-band resize notifications), *always* send current size, even if the mode is already active. This ensures applications can rely on getting a reply from the terminal.
* doc: foot-ctlseq: document XTPUSHCOLORS, XTPOPCOLORS and XTREPORTCOLORSDaniel Eklöf2024-07-03-0/+13
|
* csi: implement SGR 21, double underlinesDaniel Eklöf2024-07-03-0/+2
|
* doc: foot-ctlseq: add missing "E" to DECRQSS sequenceCraig Barnes2024-07-03-1/+1
| | | | This omission seems to have been a typo in commit add530e66d770954.
* doc: foot-ctlseq: add 58/59 (styled + colored underlines)Daniel Eklöf2024-06-26-3/+7
|
* doc: ctlseq: DECCARA, DECRARA, DECCRA, DECFRA and DECERADaniel Eklöf2024-03-07-0/+25
|
* csi: support DECRQM queries for ECMA-48 (SM/RM) modesCraig Barnes2024-02-11-5/+12
| | | | | This is in addition to the existing support for DECRQM queries of DEC private modes.
* osc: add support for osc 176 (app ID)delthas2024-02-06-0/+5
| | | | | | | | | | This adds support for a new OSC escape sequence: OSC 176, that lets terminal programs tell the terminal the name of the app that is running. foot then sets the app ID of the toplevel to that ID, which lets the compositor know which app is running, and typically sets the appropriate icon, window grouping, ... See: https://gist.github.com/delthas/d451e2cc1573bb2364839849c7117239
* doc: foot-ctlseq: add OSC 133 C/D (command output start/end)Daniel Eklöf2024-02-06-0/+6
|
* csi: implement DECSET/DECRST/DECRQM 2027 - grapheme cluster processingDaniel Eklöf2023-09-25-0/+3
| | | | | | | | | | | This implements private mode 2027 - grapheme cluster processing, as defined in the "Terminal Unicode Core"[1] specification. Internally, we just flip the already existing option "grapheme shaping". Since it's now runtime changeable, we need a copy of it in the terminal struct, rather than referencing the conf object. [1]: https://github.com/contour-terminal/terminal-unicode-core/blob/13fc5a8993a033ff10c1f3433d08cb618cde4ac2/spec/terminal-unicode-core.tex#L50-L53
* csi: implement "CSI ? m"Daniel Eklöf2023-04-26-0/+4
|
* doc: ctlseq: fix capitalization in description of DA3 sequenceCraig Barnes2023-02-16-1/+1
|
* doc: foot-ctlseq: expand last column to fill screen in all tablesDaniel Eklöf2022-12-14-9/+9
|
* doc: ctlseq: add trailing space to fix XTGETTCAP entry in DCS tableCraig Barnes2022-11-24-1/+1
| | | | | Without the trailing space, both the sequence and the description were getting packed into a single table column.
* osc: add support for OSC 133;A (prompt markers)Daniel Eklöf2022-06-16-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch adds support for the OSC-133;A sequence, introduced by FinalTerm and implemented by iTerm2, Kitty and more. See https://iterm2.com/documentation-one-page.html#documentation-escape-codes.html. The shell emits the OSC just before printing the prompt. This lets the terminal know where, in the scrollback, there are prompts. We implement this using a simple boolean in the row struct ("this row has a prompt"). The prompt marker must be reflowed along with the text on window resizes. In an ideal world, erasing, or overwriting the cell where the OSC was emitted, would remove the prompt mark. Since we don't store this information in the cell struct, we can't do that. The best we can do is reset it in erase_line(). This works well enough in the "normal" screen, when used with a "normal" shell. It doesn't really work in fullscreen apps, on the alt screen. But that doesn't matter since we don't support jumping between prompts on the alt screen anyway. To be able to jump between prompts, two new key bindings have been added: prompt-prev and prompt-next, bound to ctrl+shift+z and ctrl+shift+x respectively. prompt-prev will jump to the previous, not currently visible, prompt, by moving the viewport, ensuring the prompt is at the top of the screen. prompt-next jumps to the next prompt, visible or not. Again, by moving the viewport to ensure the prompt is at the top of the screen. If we're at the bottom of the scrollback, the viewport is instead moved as far down as possible. Closes #30
* csi: implement CSI > 4n (reset modifyOtherKeys)Daniel Eklöf2022-04-19-1/+7
|
* fix some small typosMerlin Büge2022-04-13-1/+1
|
* doc: ctlseq: document XTMODKEYSDaniel Eklöf2022-04-10-0/+5
|
* csi: add support for DECNKM private modeCraig Barnes2022-03-19-0/+3
| | | | | | | | | | | This is equivalent to DECKPAM/DECKPNM when enabled/disabled, but can also be saved/restored/queried with XTSAVE/XTRESTORE/DECRQM. See also: * https://vt100.net/docs/vt510-rm/DECNKM.html * https://vt100.net/docs/vt510-rm/DECKPAM.html * https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-PC-Style-Function-Keys
* doc: ctlseq: recommend using DECSET 2026 for synchronized updatesCraig Barnes2022-02-16-4/+4
| | | | | | Instead of the somewhat problematic[1] DCS-based equivalent. [1]: https://codeberg.org/dnkl/foot/issues/459
* doc: ctlseq: tweak formatting of OSC 22 sequence slightly, for clarityCraig Barnes2022-02-15-1/+1
| | | | | Having 3 separately underlined words made it look a bit like 3 separate parameters, at a glance.
* doc: ctlseq: make OSC 8 formatting consistent with other sequencesCraig Barnes2022-02-15-3/+3
|
* doc: ctlseq: OSC-22Daniel Eklöf2022-02-07-0/+4
|
* dcs: implement DECRQSSDaniel Eklöf2022-01-14-0/+3
| | | | | | | | | | | This patch adds support for DECRQSS (request Selection or Setting), for the following sub-queries: * DECSTBM Set Top and Bottom Margins * SGR Set Graphic Rendition * DECSCUSR Set Cursor Style Closes #798
* doc: ctlseq: add XTGETTCAPDaniel Eklöf2022-01-13-0/+3
|
* doc: ctlseq: add missing ‘[‘ to a couple of CSI sequencesDaniel Eklöf2022-01-01-5/+5
|
* doc: ctlseq: kitty kbd: swap name/fromDaniel Eklöf2022-01-01-4/+4
|
* doc: ctlseq: kitty keyboard protocolDaniel Eklöf2022-01-01-0/+17
|
* doc: ctlseq: private mode 1016 - SGR-PixelsDaniel Eklöf2022-01-01-0/+3
|
* doc: ctlseq: improve text formatting in CSI and SGR sectionsCraig Barnes2021-10-11-10/+10
| | | | | | | | Using underlining for parameters allows the angle brackets to be removed while still keeping a visual separation between literals and parameters. The removes any uncertainty about whether the angle brackets are part of the sequence or not. It also mirrors the formatting used further down in the document.
* doc: ctlseq: fix SGR table headingCraig Barnes2021-10-11-2/+2
| | | | | The other tables that contain only params also use the heading "Parameter" rather than "Sequence".
* doc: ctlseq: improve description of OSC 52 responseDaniel Eklöf2021-07-22-2/+2
|
* [foot-ctlseqs] 8-bit control characters are C1nick black2021-06-14-1/+1
|
* Merge branch 'xtversion'Daniel Eklöf2021-06-13-0/+5
|\ | | | | | | Closes #359
| * doc: ctlseq: add XTVERSIONDaniel Eklöf2021-06-13-0/+5
| |
* | doc: foot-ctlseqs: mention that SS2/SS3 only affect the next characterCraig Barnes2021-06-12-2/+2
| |
* | doc: foot-ctlseqs: rename SS0/SS1 to SO/SICraig Barnes2021-06-12-2/+2
|/ | | | | | | | | | | There's no mention of SS0 or SS1 functions in ECMA-48 or ECMA-35. 0x0E/0x0F are SO/SI (Shift In/Out) in "7-bit environments" or LS0/LS1 (Locking Shift 0/1) in "8-bit environments". The former is the one that applies to foot, since it generally follows "7-bit" conventions due to its use of UTF-8. See also: ECMA-35 §7.2 and §9.2.
* osc: implement iTerm2’s OSC-9 - desktop notificationsDaniel Eklöf2021-06-04-0/+3
|
* csi: add support for DECSET 2026, as an alternative to BSU/ESU sequencesCraig Barnes2021-04-25-0/+3
| | | | See: https://gitlab.freedesktop.org/terminal-wg/specifications/-/merge_requests/2#note_847720
* osc: implement OSC 17+19: change selection background/foreground colorsDaniel Eklöf2021-04-08-7/+22
| | | | | And of course, we also implement the corresponding reset sequences, OSC 117+119.
* doc: foot-ctlseq: mention that we support transparency in OSC 11Daniel Eklöf2021-04-08-1/+3
|
* Add NAME section to foot-ctlseqs.7; fixes whatis entry for manual page.Felix Lechner2021-02-28-0/+3
| | | | | | | | In a recent Debian build from master, Lintian complained about a bad whatis entry for this manual page. The tag description [1] says a NAME section is required. It is added here. [1] https://lintian.debian.org/tags/bad-whatis-entry.html
* doc: ctlseqs: rename "foot-ctlseqs.5" man page to "foot-ctlseqs.7"Craig Barnes2021-02-23-0/+634
Section 5 is for "file formats and conventions", which doesn't really apply to terminal escape sequences. Section 7 is for "miscellaneous".