From 46eefda07367e63b7ceffeecb2778409f1d4b387 Mon Sep 17 00:00:00 2001 From: Paul LeoNerd Evans Date: Sat, 27 Aug 2011 19:59:02 +0100 Subject: Provide an explicit termkey_canonicalise() function; canonicalise Space/SP in both directions --- termkey_canonicalise.3 | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 termkey_canonicalise.3 (limited to 'termkey_canonicalise.3') diff --git a/termkey_canonicalise.3 b/termkey_canonicalise.3 new file mode 100644 index 0000000..d208251 --- /dev/null +++ b/termkey_canonicalise.3 @@ -0,0 +1,24 @@ +.TH TERMKEY_CANONICALISE 3 +.SH NAME +termkey_canonicalise \- canonicalise a key event +.SH SYNOPSIS +.nf +.B #include +.sp +.BI "void termkey_canonicalise(TermKey *" tk ", TermKeyKey *" key ); +.fi +.sp +Link with \fI-ltermkey\fP. +.SH DESCRIPTION +\fBtermkey_canonicalise\fP(3) modifies the key event structure given by \fIkey\fP according to the flags set on the given \fItk\fP instance. This operation is performed implicitly by \fBtermkey_getkey\fP(3), \fBtermkey_waitkey\fP(3) and \fBtermkey_strpkey\fP(3), and is also provided explicitly by this function. +.PP +The canonicalisation operation is affected by the following flags: +.TP +.B TERMKEY_FLAG_SPACESYMBOL +If this flag is set then a Unicode space character is represented using the \fBTERMKEY_SYM_SPACE\fP symbol. If this flag is not set, it is represented by the U+0020 Unicode codepoint. +.SH "RETURN VALUE" +\fBtermkey_canonicalise\fP() returns no value. +.SH "SEE ALSO" +.BR termkey_new (3), +.BR termkey_waitkey (3), +.BR termkey_strpkey (3) -- cgit v1.2.3-54-g00ecf