[PATCH 15/40] man/tput.1: Revise (4/10) (relocate ncurses 6.1 material).

[G. Branden Robinson]

ncurses 6.1 is now several years old (January 2018); move discussion of
its changes to tput's reset behavior from "Aliases" subsection to
"HISTORY" section.
---
 man/tput.1 | 66 +++++++++++++++++++++++++++++++++---------------------
 1 file changed, 41 insertions(+), 25 deletions(-)

diff --git a/man/tput.1 b/man/tput.1
index 0c6e34c3b..6608d8141 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -273,31 +273,6 @@ .SS Aliases
 same effect as \fB@TPUT@ reset\fP.
 The \fB@TSET@\fP(1) utility also treats a link named \fBreset\fP specially.
 .PP
-Before \fI\%ncurses\fP 6.1,
-the two utilities were different from each other:
-.bP
-\fB@TSET@\fP utility reset the terminal modes and special characters
-(not done with \fB@TPUT@\fP).
-.bP
-On the other hand, \fB@TSET@\fP's repertoire of terminal capabilities for
-resetting the terminal was more limited,
-i.e., only \fBreset_1string\fP, \fBreset_2string\fP and \fBreset_file\fP
-in contrast to the tab-stops and margins which are set by this utility.
-.bP
-The \fBreset\fP program is usually an alias for \fB@TSET@\fP,
-because of this difference with resetting terminal modes and special 
characters.
-.PP
-With the changes made for \fI\%ncurses\fP 6.1,
-the \fIreset\fP feature of the two programs is (mostly) the same.
-A few differences remain:
-.bP
-The \fB@TSET@\fP program waits one second when resetting,
-in case it happens to be a hardware terminal.
-.bP
-The two programs write the terminal initialization strings
-to different streams (i.e., the standard error for \fB@TSET@\fP and the
-standard output for \fB@TPUT@\fP).
-.PP
 If \fB@TPUT@\fP is invoked by a link named \fBinit\fP, this has the
 same effect as \fB@TPUT@ init\fP.
 Again, you are less likely to use that link because another program
@@ -594,6 +569,47 @@ .SH HISTORY
 almost without change,
 Raymond made improvements to the way the command-line parameters
 were handled.
+.PP
+Before
+.I \%ncurses
+6.1 (2018),
+its \fB\%@TSET@\fP and \fB\%@TPUT@\fP utilities differed.
+.bP
+\fB\%@TSET@\fP was more effective,
+resetting the terminal modes and special characters.
+.bP
+On the other hand,
+\fB\%@TSET@\fP's repertoire of terminal capabilities for resetting the
+terminal was more limited;
+it had only equivalents of
+.B \%reset_1string
+.RB ( rs1 ),
+.B \%reset_2string
+.RB ( rs2 ),
+and
+.B \%reset_file
+.RB ( rf ),
+and not the tab stop and margin update features of \fB\%@TPUT@\fP.
+.PP
+The
+.B \%reset
+program is traditionally an alias for \fB\%@TSET@\fP due to its ability
+to reset terminal modes and special characters.
+.PP
+As of
+.I \%ncurses
+6.1,
+the \*(``reset\*('' features of the two programs are (mostly) the same.
+Two minor differences remain.
+.bP
+The \fB\%@TSET@\fP program waits one second when resetting,
+in case the terminal happens to be a hardware device.
+.bP
+The two programs write the terminal initialization strings
+to different streams;
+that is,
+standard error for \fB\%@TSET@\fP and
+standard output for \fB\%@TPUT@\fP.
 .SH EXAMPLES
 .TP 5
 \fB@TPUT@ init\fP
-- 
2.30.2

signature.asc
Description: PGP signature