X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Ftput.1.html;h=f754de3cc43cc516e812114a65d710c07eb624fe;hb=29a36e53e1f77a0c3672f2e267d573823d6a9a60;hp=362db56ec0e76385f23778bdef29bd09cdddb650;hpb=5dbe81a41e3c75806996cd762b9e55dcc9edb835;p=ncurses.git diff --git a/doc/html/man/tput.1.html b/doc/html/man/tput.1.html index 362db56e..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 @@
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 @@ --------------------------------------------------------------------- +
+ 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. + +
- 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. -
clear(1), stty(1), tabs(1), tset(1), terminfo(5), curs_termcap(3x). - This describes ncurses version 6.0 (patch 20160514). + This describes ncurses version 6.0 (patch 20160820). @@ -404,6 +459,7 @@