X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getch.3x.html;h=64953795ad9b5c4d6583f0842791b4c86269c90a;hp=70a62b59c8f825697b198b7cf53d2f01274cc8dd;hb=2e5d72d6396bb38a8d1d1b3534f62e28aebaa600;hpb=77afe78361875f531dc2bf8d73f2e781c8e76176 diff --git a/doc/html/man/curs_getch.3x.html b/doc/html/man/curs_getch.3x.html index 70a62b59..64953795 100644 --- a/doc/html/man/curs_getch.3x.html +++ b/doc/html/man/curs_getch.3x.html @@ -1,8 +1,8 @@ - + @@ -78,7 +78,7 @@ Unless noecho has been set, then the character will also be echoed into the designated window according to the fol- - lowing rules: If the character is the current erase char- + lowing rules: if the character is the current erase char- acter, left arrow, or backspace, the cursor is moved one space to the left and that screen position is erased as if delch had been called. If the character value is any oth- @@ -238,14 +238,16 @@ integer value other than ERR (OK in the case of ungetch()) upon successful completion. - ungetch - returns an error if there is no more room in - the FIFO. + ungetch + returns ERR if there is no more room in the FIFO. - wgetch - returns an error if the window pointer is - null, or if its timeout expires without having - any data. + wgetch + returns ERR if the window pointer is null, or if + its timeout expires without having any data. + + Functions with a "mv" prefix first perform a cursor move- + ment using wmove, and return an error if the position is + outside the window, or if the window pointer is null. @@ -264,6 +266,22 @@ says that KEY_ENTER is control/M, getch will return KEY_ENTER when you press control/M. + Generally, KEY_ENTER denotes the character(s) sent by the + Enter key on the numeric keypad: + + o the terminal description lists the most useful keys, + + o the Enter key on the regular keyboard is already han- + dled by the standard ASCII characters for carriage-re- + turn and line-feed, + + o depending on whether nl or nonl was called, pressing + "Enter" on the regular keyboard may return either a + carriage-return or line-feed, and finally + + o "Enter or send" is the standard description for this + key. + When using getch, wgetch, mvgetch, or mvwgetch, nocbreak mode (nocbreak) and echo mode (echo) should not be used at the same time. Depending on the state of the tty driver @@ -299,7 +317,7 @@ documentation. Under historical curses implementations, it varied depending on whether the operating system's im- plementation of handled signal receipt interrupts a - read(2) call in progress or not, and also (in some imple- + read(2) call in progress or not, and also (in some imple- mentations) depending on whether an input timeout or non- blocking mode has been set. @@ -317,10 +335,11 @@

SEE ALSO

-       curses(3x),        curs_inopts(3x),        curs_mouse(3x),
-       curs_move(3x), curs_refresh(3x), resizeterm(3x).
+       curses(3x),       curs_inopts(3x),       curs_outopts(3x),
+       curs_mouse(3x),   curs_move(3x),   curs_refresh(3x),   re-
+       sizeterm(3x).
 
-       Comparable  functions in the wide-character (ncursesw) li-
+       Comparable functions in the wide-character (ncursesw)  li-
        brary are described in curs_get_wch(3x).