X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_getch.3x;h=53716beeff916deed4482bd309abb049a05e56c9;hp=b8d6a82b05c242a0e23880bc94fdd4e36aa0a701;hb=321b81e6b3fa425daddac02420d862100dc3aac8;hpb=c3b21f65a2687f3894a0d3217006c23f162c893a diff --git a/man/curs_getch.3x b/man/curs_getch.3x index b8d6a82b..53716bee 100644 --- a/man/curs_getch.3x +++ b/man/curs_getch.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998-2015,2016 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2017,2018 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,12 +27,13 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_getch.3x,v 1.49 2016/10/15 16:44:01 tom Exp $ +.\" $Id: curs_getch.3x,v 1.53 2018/07/28 22:15:59 tom Exp $ .TH curs_getch 3X "" .na .hy 0 .de bP -.IP \(bu 4 +.ie n .IP \(bu 4 +.el .IP \(bu 2 .. .SH NAME \fBgetch\fR, @@ -102,7 +103,8 @@ keys are listed in \fB\fR as macros with values outside the range of 8-bit characters. Their names begin with \fBKEY_\fR. .bP -Other (user-defined) function keys which may be defined using \fBdefine_key\fP(3X) +Other (user-defined) function keys which may be defined +using \fBdefine_key\fP(3X) have no names, but also are expected to have values outside the range of 8-bit characters. .PP @@ -119,7 +121,8 @@ 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. .PP -In \fBncurses\fP, the timer normally expires after the value in \fBESCDELAY\fP (see \fBcurs_variables\fP(3X)). +In \fBncurses\fP, the timer normally expires after +the value in \fBESCDELAY\fP (see \fBcurs_variables\fP(3X)). If \fBnotimeout\fP is \fBTRUE\fP, the timer does not expire; it is an infinite (or very large) value. Because function keys usually begin with an escape character, @@ -294,11 +297,11 @@ completion. .RS 3 .TP 5 \fBungetch\fP -returns ERR +returns \fBERR\fP if there is no more room in the FIFO. .TP \fBwgetch\fP -returns ERR +returns \fBERR\fP if the window pointer is null, or if its timeout expires without having any data, or if the execution was interrupted by a signal (\fBerrno\fR will be set to @@ -314,7 +317,9 @@ discouraged, as it will cause a delay of up to one second while the keypad code looks for a following function-key sequence. .PP Some keys may be the same as commonly used control -keys, e.g., \fBKEY_ENTER\fP versus control/M, \fBKEY_BACKSPACE\fP versus control/H. +keys, e.g., +\fBKEY_ENTER\fP versus control/M, +\fBKEY_BACKSPACE\fP versus control/H. Some curses implementations may differ according to whether they treat these control keys specially (and ignore the terminfo), or use the terminfo definitions. @@ -380,12 +385,12 @@ input timeout or non-blocking mode has been set. terminfo capabilities, but no higher-level functions use the feature. The implementation in ncurses is an extension. .PP -\fBKEY_RESIZE\fP is an extension first implemented for ncurses. +\fBKEY_RESIZE\fP is an extension first implemented for ncurses. NetBSD curses later added this extension. .PP Programmers concerned about portability should be prepared for either of two cases: (a) signal receipt does not interrupt \fBgetch\fR; (b) signal receipt -interrupts \fBgetch\fR and causes it to return ERR with \fBerrno\fR set to +interrupts \fBgetch\fR and causes it to return \fBERR\fP with \fBerrno\fR set to \fBEINTR\fR. .PP The \fBhas_key\fR function is unique to \fBncurses\fR.