version 1.4, 1999/03/06 20:19:21 |
version 1.5, 1999/03/06 20:27:42 |
|
|
.\" |
.\" |
.\" @(#)tput.1 8.2 (Berkeley) 3/19/94 |
.\" @(#)tput.1 8.2 (Berkeley) 3/19/94 |
.\" |
.\" |
.Dd July 25, 1998 |
.Dd March 19, 1994 |
.Dt TPUT 1 |
.Dt TPUT 1 |
.Os BSD 4.4 |
.Os BSD 4.4 |
.Sh NAME |
.Sh NAME |
|
|
.Ar attribute |
.Ar attribute |
.Op Ar attribute-args |
.Op Ar attribute-args |
.Ar ... |
.Ar ... |
.Nm tput |
|
.Op Fl T Ar term |
|
.Fl S |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm tput |
.Nm tput |
makes terminal-dependent information available to users or shell |
makes terminal-dependent information available to users or shell |
|
|
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl T |
.It Fl T |
The terminal name as specified in the |
The terminal name as specified in the |
.Xr terminfo |
.Xr termcap |
database, for example, ``vt100'' or ``xterm''. |
database, for example, ``vt100'' or ``xterm''. |
If not specified, |
If not specified, |
.Nm tput |
.Nm tput |
retrieves the |
retrieves the |
.Dq Ev TERM |
.Dq Ev TERM |
variable from the environment. |
variable from the environment. |
.It Fl S |
|
The |
|
.Ar attributes |
|
are read from stdin instead of from the command line. |
|
.El |
.El |
.Pp |
.Pp |
.Nm tput |
.Nm tput |
|
|
If the |
If the |
.Ar attribute |
.Ar attribute |
is of type string, and takes arguments (e.g. cursor movement, |
is of type string, and takes arguments (e.g. cursor movement, |
the terminfo |
the termcap |
.Dq cup |
.Dq cm |
sequence) the arguments are taken from the command line immediately |
sequence) the arguments are taken from the command line immediately |
following the attribute. |
following the attribute. |
.Pp |
.Pp |
|
|
.Bl -tag -width Ar |
.Bl -tag -width Ar |
.It clear |
.It clear |
Clear the screen (the |
Clear the screen (the |
.Xr terminfo |
.Xr termcap |
``clear'' sequence). |
``cl'' sequence). |
.It init |
.It init |
Initialize the terminal (the |
Initialize the terminal (the |
.Xr terminfo |
.Xr termcap |
``is2'' sequence). |
``is'' sequence). |
.It longname |
.It longname |
Print the descriptive name of the user's terminal type. |
Print the descriptive name of the user's terminal type. |
.It reset |
.It reset |
Reset the terminal (the |
Reset the terminal (the |
.Xr termifo |
.Xr termcap |
``rs2'' sequence). |
``rs'' sequence). |
.Sh DIAGNOSTICS |
.Sh DIAGNOSTICS |
The exit value of |
The exit value of |
.Nm tput |
.Nm tput |
|
|
.Nm tput |
.Nm tput |
exits 2 if any error occurred. |
exits 2 if any error occurred. |
.Sh EXAMPLES |
.Sh EXAMPLES |
.Bl -tag -width "tput cup 6 11 dch 6" -compact |
.Bl -tag -width "tput cm 6 11 DC 6" -compact |
.It Li "tput clear cup 5 10" |
.It Li "tput cl cm 5 10" |
clear the screen and goto line 5 column 10 |
clear the screen and goto line 5 column 10 |
.Pp |
.Pp |
.It Li "tput cup 6 11 dch 6" |
.It Li "tput cm 6 11 DC 6" |
goto line 6 column 11 and delete 6 characters |
goto line 6 column 11 and delete 6 characters |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr terminfo 3 , |
.Xr termcap 3 , |
.Xr terminfo 5 |
.Xr termcap 5 |
.Sh BUGS |
.Sh BUGS |
.Nm tput |
.Nm tput |
can't really distinguish between different types of attributes. |
can't really distinguish between different types of attributes. |