summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man1/tput.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/tput.1')
-rw-r--r--upstream/opensuse-tumbleweed/man1/tput.139
1 files changed, 22 insertions, 17 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/tput.1 b/upstream/opensuse-tumbleweed/man1/tput.1
index 54e8fe4e..ffe8801c 100644
--- a/upstream/opensuse-tumbleweed/man1/tput.1
+++ b/upstream/opensuse-tumbleweed/man1/tput.1
@@ -28,8 +28,8 @@
.\" authorization. *
.\"***************************************************************************
.\"
-.\" $Id: tput.1,v 1.105 2024/01/20 19:41:02 tom Exp $
-.TH tput 1 2024-01-20 "ncurses 6.4" "User commands"
+.\" $Id: tput.1,v 1.113 2024/04/20 19:58:50 tom Exp $
+.TH tput 1 2024-04-20 "ncurses 6.5" "User commands"
.ie \n(.g \{\
.ds `` \(lq
.ds '' \(rq
@@ -79,7 +79,7 @@ Terminal capabilities are accessed by
.PP
\fB\%terminfo\fP(5) discusses terminal capabilities at length
and presents a complete list of
-.I cap-codes.
+.IR cap-codes .
.PP
When retrieving capability values,
the result depends upon the capability's type.
@@ -88,7 +88,7 @@ Boolean
\fB\%tput\fP sets its exit status to
.B 0
if the terminal possesses
-.I cap-code,
+.IR cap-code ,
and
.B 1
if it does not.
@@ -114,7 +114,7 @@ see section \*(``EXIT STATUS\*('' below.
.SS Operands
Generally,
an operand is a
-.I cap-code,
+.IR cap-code ,
a capability code from the terminal database,
or a parameter thereto.
Three others are specially recognized by \fB\%tput\fP:
@@ -129,8 +129,13 @@ we term them \*(``pseudo-capabilities\*(''.
.I cap-code
indicates a capability from the terminal database.
.IP
-If the capability is of string type and takes parameters,
-the arguments following the capability will be used as its parameters.
+If
+.I cap-code
+is of string type and takes parameters,
+\fB\%tput\fP interprets arguments following
+.I cap-code
+as the parameters,
+up to the (fixed) quantity the capability requires.
.IP
Most parameters are numeric.
Only a few terminal capabilities require string parameters;
@@ -319,7 +324,7 @@ Finally,
it inspects the environment variables
.I LINES
and
-.I \%COLUMNS,
+.IR \%COLUMNS ,
which may override the terminal size.
.PP
If the
@@ -357,7 +362,7 @@ and whether to use \fB\%tparm\fP(3NCURSES).
.TP
.BI \-T\ type
indicates the terminal's
-.I type.
+.IR type .
Normally this option is unnecessary,
because a default is taken from the
.I TERM
@@ -514,7 +519,7 @@ to port NetBSD's
.IR termcap -based
.B tput
to
-.I \%term\%info,
+.IR \%term\%info ,
and modified it to interpret multiple
.I cap-codes
(and parameters)
@@ -556,7 +561,7 @@ to
but
.B \%parm_delete_line
to
-.I \%term\%info.
+.IR \%term\%info .
.I termcap
uses the code
.B DL
@@ -564,7 +569,7 @@ for
.BR \%parm_delete_line .
.I \%term\%info
uses the code
-.B dch1
+.B dl1
for
.BR \%delete_line .
.bP
@@ -578,7 +583,7 @@ to
but
.B \%clr_eos
to
-.I \%term\%info.
+.IR \%term\%info .
.I termcap
uses the code
.B cd
@@ -623,7 +628,7 @@ A few observations of interest arise from that selection.
supports
.B clear
as it does any other standard
-.I cap-code.
+.IR cap-code .
The others
.RB ( init
and
@@ -693,13 +698,13 @@ X/Open Curses and the terminal capability database.
While it is certainly possible to write a
.B tput
program without using
-.I curses,
+.IR curses ,
no system with a
.I curses
implementation provides a
.B tput
utility that does not also support standard
-.I cap-codes.
+.IR cap-codes .
.PP
X/Open Curses Issue 7 (2009) is the first version to document utilities.
However that part of X/Open Curses does not follow existing practice
@@ -729,7 +734,7 @@ The various System\ V implementations
HP-UX,
Solaris)
use the same exit statuses as
-.I \%ncurses.
+.IR \%ncurses .
.PP
NetBSD
.I curses