X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftput.1.html;h=f754de3cc43cc516e812114a65d710c07eb624fe;hp=3bd8ea6c1f0f1d361538234a5aea824e263ebe0e;hb=29a36e53e1f77a0c3672f2e267d573823d6a9a60;hpb=092f1e4b79bca1d1cd3e24baa7abc3ad4cea8420 diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html index 3bd8ea6c..f754de3c 100644 --- a/doc/html/man/tput.1.html +++ b/doc/html/man/tput.1.html @@ -27,7 +27,7 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: tput.1,v 1.36 2016/04/02 23:41:08 tom Exp @ + * @Id: tput.1,v 1.44 2016/08/20 23:40:31 tom Exp @ --> @@ -53,6 +53,7 @@

SYNOPSIS

        tput [-Ttype] capname [parameters]
+       tput [-Ttype] clear
        tput [-Ttype] init
        tput [-Ttype] reset
        tput [-Ttype] longname
@@ -268,7 +269,7 @@
               tab settings for some terminals, in a format appro-
               priate   to  be  output  to  the  terminal  (escape
               sequences that set  margins  and  tabs);  for  more
-              information, see the "Tabs and Initialization" sec-
+              information,  see the Tabs and Initialization, sec-
               tion of terminfo(5)
 
 
@@ -324,10 +325,74 @@
        ---------------------------------------------------------------------
 
 
+

HISTORY

+       The tput command was begun by Bill Joy in 1980.  The  ini-
+       tial version only cleared the screen.
+
+       AT&T  System  V  provided  a different tput command, whose
+       init and reset  subcommands (more than half  the  program)
+       were incorporated from the reset feature of BSD tset writ-
+       ten by Eric Allman.  Later the corresponding  source  code
+       for  reset  was  removed  from the BSD tset (in June 1993,
+       released in 4.4BSD-Lite a year later).
+
+       Keith Bostic replaced the BSD tput command in 1989 with  a
+       new  implementation  based  on  the  AT&T System V program
+       tput.  Like the AT&T program,  Bostic's  version  accepted
+       some  parameters  named  for terminfo capabilities (clear,
+       init, longname and reset).  However (because he  had  only
+       termcap  available),  it  accepted termcap names for other
+       capabilities.  Also, Bostic's BSD tput did not modify  the
+       terminal I/O modes as the earlier BSD tset had done.
+
+       At  the  same  time,  Bostic  added  a  shell script named
+       "clear", which used tput to clear the screen.
+
+       Both of these appeared in 4.4BSD,  becoming  the  "modern"
+       BSD implementation of tput.
+
+

PORTABILITY

-       The longname and -S options, and  the  parameter-substitu-
-       tion  features  used in the cup example, are not supported
-       in BSD curses or in AT&T/USL curses before SVr4.
+       This  implementation of tput differs from AT&T tput in two
+       important areas:
+
+       o   tput capname writes to the standard output.  That need
+           not  be  a regular terminal.  However, the subcommands
+           which manipulate terminal modes may not use the  stan-
+           dard output.
+
+           The  AT&T implementation's init and reset commands use
+           the BSD (4.1c) tset source, which manipulates terminal
+           modes.   It  successively tries standard output, stan-
+           dard error, standard  input  before  falling  back  to
+           "/dev/tty" and finally just assumes a 1200Bd terminal.
+           When updating terminal modes, it ignores errors.
+
+           Until changes made after ncurses  6.0,  tput  did  not
+           modify  terminal  modes.   tput  now  uses  a  similar
+           scheme, using functions shared with  tset  (and  ulti-
+           mately  based  on the 4.4BSD tset).  If it is not able
+           to open a terminal, e.g., when running in  cron,  tput
+           will return an error.
+
+       o   AT&T  tput guesses the type of its capname operands by
+           seeing if all of the characters are numeric, or not.
+
+           Most implementations which provide support for capname
+           operands  use  the tparm function to expand parameters
+           in it.  That function expects a mixture of numeric and
+           string  parameters,  requiring tput to know which type
+           to use.
+
+           This implementation uses  a  table  to  determine  the
+           parameter types for the standard capname operands, and
+           an internal library function  to  analyze  nonstandard
+           capname operands.
+
+       The  longname  and -S options, and the parameter-substitu-
+       tion features used in the cup example, were not  supported
+       in  BSD curses before 4.3reno (1989) or in AT&T/USL curses
+       before SVr4 (1988).
 
        IEEE Std 1003.1/The Open Group  Base Specifications  Issue
        7  (POSIX.1-2008)  documents  only the operands for clear,
@@ -368,22 +433,12 @@
            curses implementation provide  a  tput  utility  which
            does not provide the capname feature.
 
-       Most implementations which provide support for capname op-
-       erands use the tparm function to expand parameters in  it.
-       That  function  expects  a  mixture  of numeric and string
-       parameters, requiring tput to  know  which  type  to  use.
-       This implementation uses a table to determine that for the
-       standard capname operands, and an internal  library  func-
-       tion  to  analyze  nonstandard  capname  operands.   Other
-       implementations may simply guess that an operand  contain-
-       ing only digits is intended to be a number.
-

SEE ALSO

        clear(1),    stty(1),   tabs(1),   tset(1),   terminfo(5),
        curs_termcap(3x).
 
-       This describes ncurses version 6.0 (patch 20160402).
+       This describes ncurses version 6.0 (patch 20160820).
 
 
 
@@ -404,6 +459,7 @@
 
  • FILES
    • 
 
  • EXIT CODES
    • 
 
  • DIAGNOSTICS
    • 
+
  • HISTORY
    • 
 
  • PORTABILITY
    • 
 
  • SEE ALSO
    •