bug-ncurses
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 16/40] man/tput.1: Revise (5/10) (Aliases).


From: G. Branden Robinson
Subject: [PATCH 16/40] man/tput.1: Revise (5/10) (Aliases).
Date: Fri, 12 Jan 2024 13:29:37 -0600

Style:
* Recast.

Markup:
* Favor man(7) font style macros over *roff font selection escape
  sequences, except for man page cross references.
* Protect "@TPUT@" and operand literals from hyphenation.
---
 man/tput.1 | 32 +++++++++++++++++++++-----------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/man/tput.1 b/man/tput.1
index 6608d8141..efe5fd47a 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -265,18 +265,28 @@ .SS Operands
 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:
-it allows for the possibility that it is invoked by a link with those names.
-.PP
-If \fB@TPUT@\fP is invoked by a link named \fBreset\fP, this has the
-same effect as \fB@TPUT@ reset\fP.
-The \fB@TSET@\fP(1) utility also treats a link named \fBreset\fP specially.
+If \fB\%@TPUT@\fP is invoked via link with any of the names
+.BR clear ,
+.BR init ,
+or
+.BR \%reset ,
+it operates as if run with the corresponding (pseudo-)capability
+operand.
+For example,
+executing a link named
+.B \%reset
+that points to \fB\%@TPUT@\fP has the same effect as
+.RB \%\*(`` "@TPUT@ \%reset" \*(''.
+(The \fB\%@TSET@\fP(1) utility also treats a link named
+.B \%reset
+specially.)
 .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
-named \fBinit\fP has a more well-established use.
+If \fB\%@TPUT@\fP is invoked by a link named
+.BR \%init ,
+this has the same effect as
+.RB \%\*(`` "@TPUT@ init" \*(''.
+Such a link is seldom employed because another program of that name
+is in widespread use.
 .SS "Terminal Size"
 Besides the special commands (e.g., \fBclear\fP),
 @TPUT@ treats certain terminfo capabilities specially:
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]