[PATCH 14/40] man/tput.1: Revise (3/10) (redirecting init/reset).

[G. Branden Robinson]

Decouple this point from discussion of ncurses history before and after
version 6.1, and relocate it from "Aliases" to "Operands" subsection.
Drop mention of tset(1).  Explain why redirection won't work to capture
the alteration of terminal modes: add cross reference to ioctl(2).
---
 man/tput.1 | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/man/tput.1 b/man/tput.1
index 925e1c60c..0c6e34c3b 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -254,6 +254,16 @@ .SS Operands
 \fB\%@TPUT@\fP reports its description to the standard output stream,
 without a trailing newline.
 See \fB\%terminfo\fP(5).
+.PP
+.I Note:
+Redirecting the output of
+.RB \%\*(`` "@TPUT@ init" \*(''
+or
+.RB \%\*(`` "@TPUT@ reset" \*(''
+to a file will capture only part of their actions.
+Changes to the terminal modes are not affected by file descriptor
+redirection,
+since the terminal modes are altered via \fB\%ioctl\fP(2).
 .SS Aliases
 \fB@TPUT@\fP handles the \fBclear\fP, \fBinit\fP and \fBreset\fP
 commands specially:
@@ -287,10 +297,6 @@ .SS Aliases
 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).
-.IP
-\fBNote:\fP although these programs write to different streams,
-redirecting their output to a file will capture only part of their actions.
-The changes to the terminal modes are not affected by redirecting the output.
 .PP
 If \fB@TPUT@\fP is invoked by a link named \fBinit\fP, this has the
 same effect as \fB@TPUT@ init\fP.
-- 
2.30.2

signature.asc
Description: PGP signature