[PATCH 029/100] man/ncurses.3x: Revise and rename subsection "Effects of GUIs and Environment Variables" to "Initialization".

[G. Branden Robinson]

Coalesce discussion of terminal (re-)initialization.

Few systems still exist that require anyone to run `tput` or `tset` from
a shell startup file for curses programs to work.

But if you change $TERM, you accept this responsibility.
---
 man/ncurses.3x | 27 ++++++++++-----------------
 1 file changed, 10 insertions(+), 17 deletions(-)

diff --git a/man/ncurses.3x b/man/ncurses.3x
index 163b37087..c3d7229b4 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -351,23 +351,7 @@ .SS Overview
 translates these into unique
 .I "key codes."
 See \fB\%getch\fP(3X).
-.SS "Effects of GUIs and Environment Variables"
-Before a
-.I curses
-program is run,
-the tab stops of the terminal should be set and its initialization
-strings,
-if defined,
-must be written to it.
-Achieve this by exporting the
-.I TERM
-environment variable in the shell,
-then run the
-.RB \*(`` "@TPUT@ init" \*(''
-command.
-(The BSD-style \fB\%@TSET@\fP(1) utility also performs this function.)
-See subsection \*(``Tabs and Initialization\*('' of \fB\%terminfo\fP(5).
-.PP
+.SS "Initialization"
 The selection of an appropriate value of
 .I TERM
 in the process environment is essential to correct
@@ -380,6 +364,15 @@ .SS "Effects of GUIs and Environment Variables"
 value automatically;
 \fB\%tset\fP(1) may assist with troubleshooting exotic situations.
 .PP
+If you change the terminal type,
+export the
+.I TERM
+environment variable in the shell,
+then run \fB\%tset\fP(1) or the
+.RB \*(`` "@TPUT@ init" \*(''
+command.
+See subsection \*(``Tabs and Initialization\*('' of \fB\%terminfo\fP(5).
+.PP
 If the environment variables \fILINES\fP and \fI\%COLUMNS\fP are set,
 or if the
 .I curses
-- 
2.30.2

signature.asc
Description: PGP signature