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_strpkey.3 | 2 ++ 1 file changed, 2 insertions(+) (limited to 'termkey_strpkey.3') diff --git a/termkey_strpkey.3 b/termkey_strpkey.3 index 12e2d3a..f9de839 100644 --- a/termkey_strpkey.3 +++ b/termkey_strpkey.3 @@ -24,6 +24,8 @@ If the only modifier is \fBTERMKEY_MOD_CTRL\fP on a plain letter, accept it as " .B TERMKEY_FORMAT_ALTISMETA Use the name "Meta" or the letter "M" instead of "Alt" or "A". .PP +Before returning, this function canonicalises the \fIkey\fP structure according to the rules given for \fBtermkey_canonicalise\fP(3). +.PP The \fBTERMKEY_FORMAT_WRAPBRACKET\fP and \fBTERMKEY_FORMAT_MOUSE_POS\fP options are currently not supported by \fBtermkey_strpkey\fP(). When returning a \fBTERMKEY_TYPE_UNICODE\fP key structure, this function will fill in the \fIutf8\fP member. .SH "RETURN VALUE" After a successful parse, \fBtermkey_strpkey\fP() returns a pointer to the first character of the input it did not consume. If the input string contains more characters then this will point at the first character beyond. If the entire input string was consumed, then this will point at a null byte. If \fBtermkey_strpkey\fP() fails to parse, it returns \fBNULL\fP. After a failed parse, the \fIkey\fP structure may contain partial or invalid results. The structure will only be valid if the function returns a non-\fBNULL\fP result. -- cgit v1.2.3-54-g00ecf