[PATCH 01/30] man/curs_get{ch,_wch}.3x: Clarify use in cooked mode.

[G. Branden Robinson]

* Document behavior with `noraw()`, not just `nocbreak()`.
* Advise writer of cooked-mode application on usage.

* man/man_db.renames.in: Add rename for noraw(3X).
---
 man/curs_get_wch.3x   | 7 ++++++-
 man/curs_getch.3x     | 7 ++++++-
 man/man_db.renames.in | 1 +
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/man/curs_get_wch.3x b/man/curs_get_wch.3x
index c190a7ea1..3eea1e98f 100644
--- a/man/curs_get_wch.3x
+++ b/man/curs_get_wch.3x
@@ -106,9 +106,14 @@ .SS "Reading Characters"
 If \fB\%cbreak\fP(3X)
 has been called,
 this happens after one character is read.
-If \fB\%nocbreak\fP(3X)
+If \fB\%nocbreak\fP(3X) or \fB\%noraw\fP(3X)
 has been called,
 it occurs when the next newline is read.
+(Because the terminal's normal or \*(``cooked\*('' mode
+is line-buffered,
+multiple
+.B \%wget_wch
+calls may then be necessary to empty the input queue.)
 If \fB\%halfdelay\fP(3X)
 has been called,
 .I curses
diff --git a/man/curs_getch.3x b/man/curs_getch.3x
index bc88c0ac7..29b5f903d 100644
--- a/man/curs_getch.3x
+++ b/man/curs_getch.3x
@@ -106,9 +106,14 @@ .SS "Reading Characters"
 If \fB\%cbreak\fP(3X)
 has been called,
 this happens after one character is read.
-If \fB\%nocbreak\fP(3X)
+If \fB\%nocbreak\fP(3X) or \fB\%noraw\fP(3X)
 has been called,
 it occurs when the next newline is read.
+(Because the terminal's normal or \*(``cooked\*('' mode
+is line-buffered,
+multiple
+.B \%wgetch
+calls may then be necessary to empty the input queue.)
 If \fB\%halfdelay\fP(3X)
 has been called,
 .I curses
diff --git a/man/man_db.renames.in b/man/man_db.renames.in
index 6198b02cc..772e75b0b 100644
--- a/man/man_db.renames.in
+++ b/man/man_db.renames.in
@@ -227,6 +227,7 @@ nl.3x                               nl.3ncurses
 nocbreak.3x                    nocbreak.3ncurses
 nodelay.3x                     nodelay.3ncurses
 nonl.3x                                nonl.3ncurses
+noraw.3x                       noraw.3ncurses
 notimeout.3x                   notimeout.3ncurses
 pnoutrefresh.3x                        pnoutrefresh.3ncurses
 prefresh.3x                    prefresh.3ncurses
-- 
2.30.2

signature.asc
Description: PGP signature