X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_util.3x;h=7cee63fe1337babbbabfd246d8f7497097235e6b;hp=969f54fa550f32ec72807c9166eb12827a1424ab;hb=f79af94ad91dfe693eb9779caf71ea892fb1eff6;hpb=17c5992a16be94247b83f2bbb9accdd9b7e7bb72 diff --git a/man/curs_util.3x b/man/curs_util.3x index 969f54fa..7cee63fe 100644 --- a/man/curs_util.3x +++ b/man/curs_util.3x @@ -1,6 +1,7 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998-2017,2018 Free Software Foundation, Inc. * +.\" Copyright 2018-2019,2020 Thomas E. Dickey * +.\" Copyright 1998-2015,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,7 +28,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_util.3x,v 1.54 2018/07/28 22:08:59 tom Exp $ +.\" $Id: curs_util.3x,v 1.57 2020/02/02 23:34:34 tom Exp $ .TH curs_util 3X "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -57,13 +58,13 @@ .SH SYNOPSIS \fB#include \fR .sp -\fBchar *unctrl(chtype c);\fR +\fBconst char *unctrl(chtype c);\fR .br \fBwchar_t *wunctrl(cchar_t *c);\fR .br -\fBchar *keyname(int c);\fR +\fBconst char *keyname(int c);\fR .br -\fBchar *key_name(wchar_t w);\fR +\fBconst char *key_name(wchar_t w);\fR .br \fBvoid filter(void);\fR .br @@ -114,8 +115,8 @@ Values above 256 may be the names of the names of function keys. .bP Otherwise (if there is no corresponding name) the function returns null, to denote an error. -X/Open also lists an "UNKNOWN KEY" return value, which some implementations -return rather than null. +X/Open also lists an \*(``UNKNOWN KEY\*('' return value, +which some implementations return rather than null. .LP The corresponding \fBkey_name\fR returns a character string corresponding to the wide-character value \fIw\fR. @@ -289,7 +290,7 @@ The \fBkeyname\fP function may return the names of user-defined string capabilities which are defined in the terminfo entry via the \fB\-x\fP option of \fB@TIC@\fP. This implementation automatically assigns at run-time keycodes to -user-defined strings which begin with "k". +user-defined strings which begin with \*(``k\*(''. The keycodes start at KEY_MAX, but are not guaranteed to be the same value for different runs because user-defined codes are merged from all terminal descriptions which have been loaded.