bug-ncurses
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 27/43] man/curs_inopts.3x: Migrate terminology.


From: G. Branden Robinson
Subject: [PATCH 27/43] man/curs_inopts.3x: Migrate terminology.
Date: Mon, 9 Sep 2024 09:17:26 -0500

Speak of raw, cbreak, and normal ("cooked") _line disciplines_ instead
of "modes", as ncurses.3x does since patch 20240622.
---
 man/curs_inopts.3x | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/man/curs_inopts.3x b/man/curs_inopts.3x
index 0d691b1b1..0469fad52 100644
--- a/man/curs_inopts.3x
+++ b/man/curs_inopts.3x
@@ -147,7 +147,7 @@ .SS "cbreak, nocbreak"
 and makes characters typed by the user immediately available to the
 program.
 .B \%nocbreak
-returns the terminal to normal (\*(``cooked\*('') mode.
+restores the terminal's normal (\*(``cooked\*('') line discipline.
 .PP
 The state of the terminal is unknown to a
 .I curses
@@ -328,7 +328,7 @@ .SS "nl, nonl"
 configures the terminal to perform this translation.
 .B nonl
 disables it.
-In normal (or \*(``cooked\*('') mode,
+Under its normal (\*(``cooked\*('') line discipline,
 the terminal driver always translates carriage returns to line feeds.
 .\"
 .SS nodelay
@@ -365,10 +365,8 @@ .SS "qiflush, noqiflush"
 configure the terminal driver's treatment of its input and output queues
 when it handles the interrupt,
 suspend,
-or quit characters in
-.I \%cbreak
-and \*(``cooked\*('' modes;
-on POSIX systems,
+or quit characters under the normal (\*(``cooked\*('')
+or cbreak line discplines on POSIX systems;
 see \fI\%termios\fP(3).
 The default behavior is inherited from the terminal driver settings.
 Calling
@@ -414,7 +412,7 @@ .SS "raw, noraw"
 .I curses
 does not handle.
 .B \%noraw
-returns the terminal to normal (\*(``cooked\*('') mode.
+restores the terminal's normal (\*(``cooked\*('') line discipline.
 .\"
 .SS "timeout, wtimeout"
 .B \%wtimeout
@@ -559,8 +557,9 @@ .SH NOTES
 .B \%noraw
 and
 .B \%nocbreak
-follow historical practice in that they attempt to restore normal
-(\*(``cooked\*('') mode from raw and cbreak modes,
+follow historical practice in that they attempt to restore
+the terminal's normal (\*(``cooked\*('') line discipline
+from raw and cbreak,
 respectively.
 Mixing
 .BR \%raw / noraw
@@ -643,7 +642,8 @@ .SH PORTABILITY
 or
 .B \%noecho
 explicitly just after initialization,
-even if your program remains in normal (\*(``cooked\*('') mode.
+even if your program retains the terminal's normal (\*(``cooked\*('')
+line discipline.
 .PP
 X/Open Curses is ambiguous regarding whether
 .I raw
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]