aboutsummaryrefslogtreecommitdiff
path: root/man/termkey.7
diff options
context:
space:
mode:
authorPaul LeoNerd Evans <leonerd@leonerd.org.uk>2012-11-30 16:12:26 +0000
committerPaul LeoNerd Evans <leonerd@leonerd.org.uk>2012-11-30 16:12:26 +0000
commitc00f6cd3c63e01c84220b607eccf5a2ba2df8f63 (patch)
treeb7b183e4235f6bf88aaac1964a35ea8ea598ee86 /man/termkey.7
parentefc5b7e088fc219993f22dc827022b143913c1f8 (diff)
downloadtermo-c00f6cd3c63e01c84220b607eccf5a2ba2df8f63.tar.gz
termo-c00f6cd3c63e01c84220b607eccf5a2ba2df8f63.tar.xz
termo-c00f6cd3c63e01c84220b607eccf5a2ba2df8f63.zip
Only recognise DECCPR as a position report, so it is distinct from F3
Diffstat (limited to 'man/termkey.7')
-rw-r--r--man/termkey.72
1 files changed, 1 insertions, 1 deletions
diff --git a/man/termkey.7 b/man/termkey.7
index c96c4b4..2313fb5 100644
--- a/man/termkey.7
+++ b/man/termkey.7
@@ -132,7 +132,7 @@ protocol (\f(CWCSI M\fP followed by three bytes),
.SM SGR
encoding (\f(CWCSI < ... M\fP, as requested by \f(CWCSI ? 1006 h\fP), and rxvt encoding (\f(CWCSI ... M\fP, as requested by \f(CWCSI ? 1015 h\fP). Which encoding is in use is inferred automatically by \fBtermkey\fP, and does not need to be specified explicitly.
.SS Position Events
-The \fBTERMKEY_TYPE_POSITION\fP event type indicates a cursor position report. This is typically sent by a terminal in response to the Report Cursor Position command (\f(CWCSI 6 n\fP). The event bytes are opaque, but can be obtained by calling \fBtermkey_interpret_position\fP(3) passing the event structure and pointers to integers to store the result in.
+The \fBTERMKEY_TYPE_POSITION\fP event type indicates a cursor position report. This is typically sent by a terminal in response to the Report Cursor Position command (\f(CWCSI ? 6 n\fP). The event bytes are opaque, but can be obtained by calling \fBtermkey_interpret_position\fP(3) passing the event structure and pointers to integers to store the result in. Note that only a DEC CPR sequence (\f(CWCSI ? R\fP) is recognised, and not the non-DEC prefixed \f(CWCSI R\fP because the latter could be interpreted as the \f(CWF3\fP function key instead.
.SS Unrecognised CSIs
The \fBTERMKEY_TYPE_UNKNOWN_CSI\fP event type indicates a CSI sequence that the \fBtermkey\fP does not recognise. It will have been extracted from the stream, but is available to the application to inspect by calling \fBtermkey_interpret_csi\fP(3). It is important that if the application wishes to inspect this sequence it is done immediately, before any other IO operations on the \fBtermkey\fP instance (specifically, before calling \fBtermkey_waitkey\fP() or \fBtermkey_getkey\fP() again), otherwise the buffer space consumed by the sequence will be overwritten.
.SH "SEE ALSO"