X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fman%2Ftput.1.html;h=32a8b22ae05b23b103c8c4210deae926dd8c8b1e;hb=aa70bf3c762c5b6407bf34812d63c20f7ac8ffdd;hp=5fb2df5a5bd17d9ca9cc2dff63664fddf1bf24e2;hpb=56f1e8cd80dfb926f74e1739bf969489b0cfa56f;p=ncurses.git diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html index 5fb2df5a..32a8b22a 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.42 2016/07/30 21:01:09 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,56 @@
        ---------------------------------------------------------------------
 
 
+

HISTORY

+       The tput command was begun by Bill Joy in 1980.  The  ini-
+       tial version only cleared the screen.
+
+       Keith  Bostic replaced this in 1989 with a new implementa-
+       tion based on the AT&T SystemV  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.
+
+       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  writes to the standard output.  That need not be
+           a regular terminal.
+
+           The AT&T implementation's init and reset commands  use
+           the tset source, which manipulates terminal modes.  It
+           successively tries standard  output,  standard  error,
+           standard  input  before falling back to "/dev/tty" and
+           finally just assumes a 1200Bd terminal.  When updating
+           terminal modes, it ignores errors.
+
+       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 +415,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 20160521).
+       This describes ncurses version 6.0 (patch 20160730).
 
 
 
@@ -404,6 +441,7 @@
 
  • FILES
    • 
 
  • EXIT CODES
    • 
 
  • DIAGNOSTICS
    • 
+
  • HISTORY
    • 
 
  • PORTABILITY
    • 
 
  • SEE ALSO
    •