.\" Copyright (c) 1989, 1990, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)tput.1	8.2 (Berkeley) 3/19/94
.\" %FreeBSD: src/usr.bin/tput/tput.1,v 1.3.2.2 1999/08/29 15:33:53 peter Exp %
.\"
.\" jpman %Id: tput.1,v 1.3 1997/08/11 14:35:00 horikawa Stab %
.\"
.Dd March 19, 1994
.Dt TPUT 1
.Os BSD 4.4
.Sh 名称
.Nm tput ,
.Nm clear
.Nd 端末属性を利用するためのインタフェース
.Sh 書式
.Nm tput
.Op Fl T Ar term
.Ar attribute
.Nm clear
.Sh 解説
.Nm
コマンドは、端末の属性情報を取り出して、ユーザやシェルアプリケーションから
利用できるようにします。
.Nm clear
ユーティリティとして起動されたときには、
.Dl tput clear
が実行されたように画面がクリアされます。
.Nm
のオプションは、次の通りです。
.Bl -tag -width Ds
.It Fl T
.Xr termcap
データベースの中の端末名 (
.Dq vt100
や
.Dq xterm
) を指定します。
端末名が指定されない場合には、環境変数
.Dq Ev TERM
の内容を参照します。
.El
.Pp
.Ar attribute
で指定する端末属性が文字列型の場合、
.Nm
コマンドはその文字列を出力します。
端末属性が整数型の場合、その数値を出力します。
どちらでもなければ
.Nm
は余分な動作をせずに、
端末が属性を持っているなら 0 、そうでないなら 1 を
終了コードにして終了します。
.Pp
.Ar attribute
が文字列型で引数を取る場合 (例えばカーソル移動 : termcap の
.Dq cm
シーケンス) には、引数は属性名 (attribute) のすぐ後ろから取られます。
.Pp
次の属性は、特別な意味を持っています。
.Bl -tag -width Ar
.It clear
画面をクリアします (
.Xr termcap
の
.Dq cl
シーケンス)
.It init
端末を初期化します (
.Xr termcap
の
.Dq is
シーケンス)
.It longname
ユーザの端末タイプの詳細名称を表示します。
.It reset
端末をリセットする (
.Xr termcap
の
.Dq rs
シーケンス)
.Sh 診断
.Nm
の終了コードは、最後に指定された属性 (attribute) によります。
属性が文字列型か整数型なら、
端末に属性が定義されていたら 0 、定義されていなければ 1 で終了します。
属性が論理型なら、
端末がこの属性を持っていたら 0 、持っていなければ 1 で終了します。
何かエラーが起きた場合、
.Nm
コマンドは 2 で終了します。
.Sh 関連項目
.Xr termcap 3 ,
.Xr termcap 5
.Sh バグ
.Nm
は属性毎の正しい型を知っているわけではありません。
.Pp
termcap エントリによっては
.Sq %
のみからなる
.Sq %
を持つことに依存しているものがあります。
現在、有効なタイプ宣言を持たないものに関しては警告を発っします。
これらの警告は標準エラー出力へと送られます。
.Sh 歴史
.Nm
コマンドは、
.Bx 4.4 
から登場しました。