X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftput.1.html;h=0d9d1788cb731d46ba603675cbc02449de2202f2;hb=e2153a14ebfb90265151d608778aaf9f403b3d24;hp=d60ad9823fb51829576d1521817002dc37105af5;hpb=235aa9c4f39efed13a7b9a40d191f3a591095f75;p=ncurses.git diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html index d60ad982..0d9d1788 100644 --- a/doc/html/man/tput.1.html +++ b/doc/html/man/tput.1.html @@ -28,19 +28,19 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tput.1,v 1.105 2024/01/20 19:41:02 tom Exp @ + * @Id: tput.1,v 1.116 2024/06/08 20:50:34 tom Exp @ --> -tput 1 2024-01-20 ncurses 6.4 User commands +tput 1 2024-06-08 ncurses 6.5 User commands -

tput 1 2024-01-20 ncurses 6.4 User commands

tput 1 2024-06-08 ncurses 6.5 User commands

 tput(1)                          User commands                         tput(1)
 
@@ -53,19 +53,19 @@

SYNOPSIS

-       tput [-T terminal-type] {cap-code [parameter ...]} ...
+       tput [-v] [-T terminal-type] {cap-code [parameter ...]} ...
 
-       tput [-T terminal-type] [-x] clear
+       tput [-v] [-T terminal-type] [-x] clear
 
-       tput [-T terminal-type] init
+       tput [-v] [-T terminal-type] init
 
-       tput [-T terminal-type] reset
+       tput [-v] [-T terminal-type] reset
 
-       tput [-T terminal-type] longname
+       tput [-v] [-T terminal-type] longname
 
-       tput -S
+       tput [-v] -S
 
-       tput -V
+       tput [-v] -V

DESCRIPTION

@@ -76,13 +76,13 @@
        code.
 
        terminfo(5) discusses terminal capabilities at length  and  presents  a
-       complete list of cap-codes.
+       complete list of cap-codes.
 
        When   retrieving  capability  values,  the  result  depends  upon  the
        capability's type.
 
        Boolean  tput sets its exit status to 0 if the terminal possesses  cap-
-                code, and 1 if it does not.
+                code, and 1 if it does not.
 
        numeric  tput  writes  cap-code's  decimal value to the standard output
                 stream if defined (-1 if it is not) followed by a newline.
@@ -96,7 +96,7 @@

Operands

-       Generally,  an  operand  is  a  cap-code,  a  capability  code from the
+       Generally,  an  operand  is  a  cap-code,  a  capability  code from the
        terminal database, or a parameter thereto.  Three others are  specially
        recognized by tput: init, reset, and longname.  Although these resemble
        capability codes, they in fact receive special handling; we  term  them
@@ -104,9 +104,9 @@
 
        cap-code   indicates a capability from the terminal database.
 
-                  If  the  capability  is of string type and takes parameters,
-                  the arguments following the capability will be used  as  its
-                  parameters.
+                  If  cap-code  is  of  string type and takes parameters, tput
+                  interprets arguments following cap-code as  the  parameters,
+                  up to the (fixed) quantity the capability requires.
 
                   Most   parameters   are   numeric.    Only  a  few  terminal
                   capabilities require string parameters; tput uses a table to
@@ -233,7 +233,7 @@
            generally  works,  unless  the connection is via a serial line that
            does not support "NAWS": negotiations about window size.
 
-       o   Finally, it inspects the environment variables LINES  and  COLUMNS,
+       o   Finally, it inspects the environment variables LINES  and  COLUMNS,
            which may override the terminal size.
 
        If  the  -T  option is given, tput ignores the environment variables by
@@ -254,11 +254,13 @@
                 parameters in its input to decide how to interpret  them,  and
                 whether to use tparm(3x).
 
-       -T type  indicates  the  terminal's  type.   Normally  this  option  is
+       -T type  indicates  the  terminal's  type.   Normally  this  option  is
                 unnecessary,  because  a  default  is  taken  from  the   TERM
                 environment variable.  If specified, the environment variables
                 LINES and COLUMNS are also ignored.
 
+       -v       causes tput to operate verbosely, reporting warnings.
+
        -V       reports the version of ncurses associated with tput, and exits
                 with a successful status.
 
@@ -338,7 +340,7 @@
            While  more reliable than System V's utility, a portability problem
            is introduced by this analysis.  An OpenBSD developer  adapted  the
            internal  library  function  from ncurses to port NetBSD's termcap-
-           based tput to terminfo, and modified it to interpret multiple  cap-
+           based tput to terminfo, and modified it to interpret multiple  cap-
            codes  (and parameters) on the command line.  Portable applications
            should not rely upon this feature; ncurses  offers  it  to  support
            applications written specifically for OpenBSD.
@@ -349,11 +351,11 @@
        assumes the terminfo code.
 
        o   The cap-code dl means delete_line to termcap  but  parm_delete_line
-           to terminfo.  termcap uses the code DL for parm_delete_line.  term-
-           info uses the code dch1 for delete_line.
+           to terminfo.  termcap uses the code DL for parm_delete_line.  term-
+           info uses the code dl1 for delete_line.
 
        o   The cap-code ed means exit_delete_mode to termcap  but  clr_eos  to
-           terminfo.  termcap uses the code cd for clr_eos.  terminfo uses the
+           terminfo.  termcap uses the code cd for clr_eos.  terminfo uses the
            code rmdc for exit_delete_mode.
 
        The  longname  operand,  -S  option,  and  the   parameter-substitution
@@ -366,7 +368,7 @@
        (POSIX.1-2008)  documents  only the clear, init, and reset operands.  A
        few observations of interest arise from that selection.
 
-       o   ncurses supports clear as it does any other standard cap-code.  The
+       o   ncurses supports clear as it does any other standard cap-code.  The
            others   (init   and   longname)  do  not  correspond  to  terminal
            capabilities.
 
@@ -395,8 +397,8 @@
            terminal capability database.
 
        o   While it is certainly possible to  write  a  tput  program  without
-           using  curses,  no  system  with a curses implementation provides a
-           tput utility that does not also support standard cap-codes.
+           using  curses,  no  system  with a curses implementation provides a
+           tput utility that does not also support standard cap-codes.
 
        X/Open  Curses  Issue  7  (2009)  is  the  first  version  to  document
        utilities.  However that part of X/Open Curses does not follow existing
@@ -413,7 +415,7 @@
            (unsigned) exit status.
 
        The various System V implementations (AIX, HP-UX, Solaris) use the same
-       exit statuses as ncurses.
+       exit statuses as ncurses.
 
        NetBSD  curses  documents  exit  statuses  that  correspond  to neither
        ncurses nor X/Open Curses.
@@ -498,8 +500,8 @@
               Set cursor to normal visibility.
 
        tput home
-              Move the cursor to row 0, column 0: the upper left corner of the
-              screen, usually known as the "home" cursor position.
+              Move the cursor to line 0, column 0: the upper  left  corner  of
+              the screen, usually known as the "home" cursor position.
 
        tput clear
               Clear  the  screen: write the clear_screen capability's value to
@@ -523,7 +525,7 @@
               device.
 
        tput cup 23 4
-              Move the cursor to row 23, column 4.
+              Move the cursor to line 23, column 4.
 
        tput cup
               Report  the  value  of the cursor_address (cup) capability (used
@@ -555,7 +557,7 @@
 
 
 
-ncurses 6.4                       2024-01-20                           tput(1)
+ncurses 6.5                       2024-06-08                           tput(1)