[PATCH 061/100] man/ncurses.3x: Recast "ENVIRONMENT" section, TERM (17/21).

[G. Branden Robinson]

---
 man/ncurses.3x | 44 +++++++++++++++++++++++++++-----------------
 1 file changed, 27 insertions(+), 17 deletions(-)

diff --git a/man/ncurses.3x b/man/ncurses.3x
index b13c1d03b..78781a14c 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -1428,23 +1428,33 @@ .SS "\fINCURSES_TRACE\fP"
 the library calls \fB\%curses_trace\fP(3X) with that value as the
 argument.
 .SS "\fITERM\fP"
-Denotes your terminal type.
-Each terminal type is distinct, though many are similar.
-.PP
-\fITERM\fP is commonly set by terminal emulators to help
-applications find a workable terminal description.
-Some of those choose a popular approximation, e.g.,
-\*(``ansi\*('', \*(``vt100\*('', \*(``xterm\*('' rather than an exact fit.
-Not infrequently, your application will have problems with that approach,
-e.g., incorrect function-key definitions.
-.PP
-If you set \fITERM\fP in your environment,
-it has no effect on the operation of the terminal emulator.
-It only affects the way applications work within the terminal.
-Likewise, as a general rule (\fBxterm\fP(1) being a rare exception),
-terminal emulators which allow you to
-specify \fITERM\fP as a parameter or configuration value do
-not change their behavior to match that setting.
+The
+.I TERM
+variable denotes the terminal type.
+Each is distinct,
+though many are similar.
+It is commonly set by terminal emulators to help applications find a
+workable terminal description.
+Some choose a popular approximation such as \*(``ansi\*('',
+\*(``vt100\*('', or \*(``xterm\*('' rather than an exact fit to their
+capabilities.
+Not infrequently,
+an application will have problems with that approach;
+for example,
+a key stroke may not operate correctly,
+or produce no effect but seeming garbage characters on the screen.
+.PP
+Setting
+.I TERM
+has no effect on hardware operation;
+it affects the way applications communicate with the terminal.
+Likewise,
+as a general rule
+(\fIxterm\fP(1) being a rare exception),
+terminal emulators that allow you to specify
+.I TERM
+as a parameter or configuration value do not change their behavior to
+match that setting.
 .SS "\fITERMCAP\fP"
 If the \fI\%ncurses\fP library has been configured with \fItermcap\fP
 support, \fI\%ncurses\fP will check for a terminal's description in
-- 
2.30.2

signature.asc
Description: PGP signature