X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_inopts.3x;h=4abc3d09acfccd9d84ecc396b3db7a4e7f710f53;hp=69ad2c21fe2b964bd8356e051fa024d69313d40f;hb=b93d96b78ac5250135975df892cee793dc3c0797;hpb=58552e8c761a70f8f0bd591fecdf576fa8216e3e diff --git a/man/curs_inopts.3x b/man/curs_inopts.3x index 69ad2c21..4abc3d09 100644 --- a/man/curs_inopts.3x +++ b/man/curs_inopts.3x @@ -26,7 +26,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inopts.3x,v 1.24 2017/01/07 19:25:15 tom Exp $ +.\" $Id: curs_inopts.3x,v 1.26 2017/11/21 00:47:10 tom Exp $ .TH curs_inopts 3X "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -140,7 +140,7 @@ The \fBhalfdelay\fR routine is used for half-delay mode, which is similar to \fBcbreak\fR mode in that characters typed by the user are immediately available to the program. However, after blocking for \fItenths\fR tenths of -seconds, ERR is returned if nothing has been typed. +seconds, \fBERR\fP is returned if nothing has been typed. The value of \fItenths\fR must be a number between 1 and 255. Use \fBnocbreak\fR to leave half-delay @@ -266,9 +266,10 @@ If \fIfd\fR is \-1, then no typeahead checking is done. .\" .SH RETURN VALUE -All routines that return an integer return \fBERR\fR upon failure and OK (SVr4 -specifies only "an integer value other than \fBERR\fR") upon successful -completion, unless otherwise noted in the preceding routine descriptions. +All routines that return an integer return \fBERR\fR upon failure and \fBOK\fP +(SVr4 specifies only \*(``an integer value other than \fBERR\fR\*('') +upon successful completion, +unless otherwise noted in the preceding routine descriptions. .PP X/Open does not define any error conditions. In this implementation, @@ -298,13 +299,13 @@ ncurses loads the key-definitions for the current terminal description. If the terminal description includes extended string capabilities, e.g., from using the \fB\-x\fP option of \fB@TIC@\fP, then ncurses also defines keys for the capabilities whose names -begin with "k". +begin with \*(``k\*(''. The corresponding keycodes are generated and (depending on previous loads of terminal descriptions) may differ from one execution of a program to the next. The generated keycodes are recognized by the \fBkeyname\fP function -(which will then return a name beginning with "k" denoting the -terminfo capability name rather than "K", used for curses key-names). +(which will then return a name beginning with \*(``k\*('' denoting the +terminfo capability name rather than \*(``K\*('', used for curses key-names). On the other hand, an application can use \fBdefine_key\fP to establish a specific keycode for a given string. This makes it possible for an application to check for an extended @@ -334,7 +335,7 @@ Note that \fBecho\fR, \fBnoecho\fR, \fBhalfdelay\fR, \fBintrflush\fR, \fBqiflush\fR, \fBtimeout\fR, and \fBwtimeout\fR may be macros. .PP The \fBnoraw\fR and \fBnocbreak\fR calls follow historical practice in that -they attempt to restore to normal (`cooked') mode from raw and cbreak modes +they attempt to restore to normal (\*(``cooked\*('') mode from raw and cbreak modes respectively. Mixing raw/noraw and cbreak/nocbreak calls leads to tty driver control states that are hard to predict or understand; it is not recommended.