diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/tput.1')
-rw-r--r-- | upstream/opensuse-tumbleweed/man1/tput.1 | 39 |
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 |