X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_getch.3x;h=8a57bb02d076aed9f6fed964aaeae352ccaabc10;hp=92ab55a0c16789f35fe350b24180ba65a86f7a9e;hb=32f9f5f12cd9159261f9db228461049e8c770404;hpb=c99e3eba2cce1c3bd7fa1b4a2eb4554e52ebe264 diff --git a/man/curs_getch.3x b/man/curs_getch.3x index 92ab55a0..8a57bb02 100644 --- a/man/curs_getch.3x +++ b/man/curs_getch.3x @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getch.3x,v 1.40 2015/04/11 10:23:49 tom Exp $ +.\" $Id: curs_getch.3x,v 1.41 2015/07/16 09:29:33 tom Exp $ .TH curs_getch 3X "" .na .hy 0 @@ -59,6 +59,7 @@ \fBint has_key(int ch);\fR .br .SH DESCRIPTION +.SS Reading characters The \fBgetch\fR, \fBwgetch\fR, \fBmvgetch\fR and \fBmvwgetch\fR, routines read a character from the window. In no-delay mode, if no input is waiting, the value \fBERR\fR is returned. @@ -91,6 +92,7 @@ Otherwise the character is simply output to the screen. If the window is not a pad, and it has been moved or modified since the last call to \fBwrefresh\fR, \fBwrefresh\fR will be called before another character is read. +.SS Keypad mode .PP If \fBkeypad\fR is \fBTRUE\fR, and a function key is pressed, the token for that function key is returned instead of the raw characters. @@ -109,6 +111,7 @@ time, the character is passed through; otherwise, the function key value is returned. For this reason, many terminals experience a delay between the time a user presses the escape key and the escape is returned to the program. +.SS Ungetting characters .PP The \fBungetch\fR routine places \fIch\fR back onto the input queue to be returned by the next call to \fBwgetch\fR. @@ -238,7 +241,7 @@ returns \fBTRUE\fP or \fBFALSE\fP according to whether the current terminal type recognizes a key with that value. Note that a few values do not correspond to a real key, e.g., \fBKEY_RESIZE\fP and \fBKEY_MOUSE\fP. -See \fBresizeterm\fR(3X) for more details about \fBKEY_RESIZE\fP, and +See \fBinitscr\fP(3X) and \fBresizeterm\fR(3X) for more details about \fBKEY_RESIZE\fP, and \fBcurs_mouse\fR(3X) for a discussion of \fBKEY_MOUSE\fP. .PP .SH RETURN VALUE