[PATCH 17/23] man/ncurses.3x: Explicitly introduce SCREENs.

[G. Branden Robinson]

...and distinguish them from WINDOWs.

Throw user a hint regarding accessor functions for opaque SCREEN
properties.
---
 man/ncurses.3x | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/man/ncurses.3x b/man/ncurses.3x
index b97970661..86fedda05 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -228,10 +228,27 @@ .SS "Application Structure"
 .SS Overview
 A
 .I curses
-library abstracts the terminal screen by representing all or part of it
-as a
+library abstracts the terminal with a
+.I \%SCREEN
+data structure,
+and represents all or part of its display
+with
 .I \%WINDOW
-data structure.
+structures.
+Distinct properties apply to each;
+for example,
+the
+.I "line discipline"
+of a typical Unix terminal driver
+is in one of three modes:
+raw,
+\%cbreak,
+or normal (\*(``cooked\*('').
+In
+.IR curses ","
+the line discipline is a property of the screen,
+applying identically to all windows associated with it.
+.PP
 A
 .I window
 is a rectangular grid of character cells,
@@ -1932,9 +1949,12 @@ .SH EXTENSIONS
 An
 .I \%ncurses
 application can eschew knowledge of
+.I \%SCREEN
+and
 .I \%WINDOW
 structure internals,
 instead using accessor functions such as
+\fB\%is_cbreak\fP(3X) and
 \fB\%is_scrollok\fP(3X).
 .PP
 .I \%ncurses
-- 
2.30.2

signature.asc
Description: PGP signature