diff options
| author | Robin Haberkorn <robin.haberkorn@googlemail.com> | 2024-09-23 11:35:15 +0200 |
|---|---|---|
| committer | Robin Haberkorn <robin.haberkorn@googlemail.com> | 2024-09-23 11:45:25 +0200 |
| commit | c2887621a37f429e2e05b561631fff01da8bd462 (patch) | |
| tree | 35ece0d6ab9593bc80d8d307a4c021cc307207b5 /doc | |
| parent | fbaa927a49694f771d770383bde3e1137fe172d4 (diff) | |
| download | sciteco-c2887621a37f429e2e05b561631fff01da8bd462.tar.gz | |
allow OSC-52 clipboards on all terminal emulators
* The XTerm version is still checked if we detect running under XTerm.
* Actually, the XTerm implementation is broken for Unicode clipboard contents.
* Kitty supports OSC-52, but you __must__ enable read-clipboard.
With read-clipboard-ask, there will be a timeout.
But we cannot read without a timeout since otherwise we would hang indefinitely
if the escape sequence turns out to not work.
* For urxvt, I have hacked an existing extension:
https://gist.github.com/rhaberkorn/d7406420b69841ebbcab97548e38b37d
* st currently supports only setting the clipboard, but not querying it.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/sciteco.7.template | 25 |
1 files changed, 18 insertions, 7 deletions
diff --git a/doc/sciteco.7.template b/doc/sciteco.7.template index 193d029..a476091 100644 --- a/doc/sciteco.7.template +++ b/doc/sciteco.7.template @@ -1525,16 +1525,27 @@ The existence of a clipboard register can thus be checked in macros to determine whether getting and modifying that particular clipboard is supported natively. .br -.SCITECO_TOPIC xterm +.SCITECO_TOPIC OSC-52 xterm \*(ST does \fBnot\fP generally support clipboards on ncurses, -but has special support when used with a sufficiently recent version -of \fBxterm\fP(1). -Since the operability of XTerm clipboards cannot be tested +but has special support for OSC-52 escape sequences, as were +introduced by sufficiently recent versions of +.BR xterm (1) +and have since been adopted by several other terminal emulators. +Since the operability of OSC-52 clipboards cannot be tested automatically, users will have to set the flag 256 of the -\fBED\fP flags if and only if their XTerm is configured for allowing +\fBED\fP flags if and only if their terminal emulator is properly +configured. +.BR xterm (1) +for instance must be configured for allowing the \fISetSelection\fP and \fIGetSelection\fP window operations. -\*(ST will still check whether XTerm is actually used in -a particular session. +If running under +.BR xterm (1), +\*(ST will still check whether the XTerm version is sufficient. +.SCITECO_TOPIC Kitty +Other terminal emulators like Kitty may ask for permission to read the +clipboard (\fBread-clipboard-ask\fP). +This is not supported by \*(ST and must be disabled +(use \fBread-clipboard\fP instead). .SCITECO_TOPIC xclip If native clipboard support is unavailable, users may still fall back to using external tools like \fBxclip\fP(1) |