.\" 2000 PTM Przemek Borys <pborys@dione.ids.pl>
'\" t
.\"***************************************************************************
.\" Copyright (c) 1998 Free Software Foundation, Inc.                        *
.\"                                                                          *
.\" Permission is hereby granted, free of charge, to any person obtaining a  *
.\" copy of this software and associated documentation files (the            *
.\" "Software"), to deal in the Software without restriction, including      *
.\" without limitation the rights to use, copy, modify, merge, publish,      *
.\" distribute, distribute with modifications, sublicense, and/or sell       *
.\" copies of the Software, and to permit persons to whom the Software is    *
.\" furnished to do so, subject to the following conditions:                 *
.\"                                                                          *
.\" The above copyright notice and this permission notice shall be included  *
.\" in all copies or substantial portions of the Software.                   *
.\"                                                                          *
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
.\" IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
.\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
.\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
.\"                                                                          *
.\" Except as contained in this notice, the name(s) of the above copyright   *
.\" holders shall not be used in advertising or otherwise to promote the     *
.\" sale, use or other dealings in this Software without prior written       *
.\" authorization.                                                           *
.\"***************************************************************************
.\"
.\" $Id: tput.1,v 1.1 2000/02/15 20:15:08 pborys Exp $
.TH tput 1 ""
.ds d /usr/share/terminfo
.ds n 5
.SH NAZWA
\fBtput\fR - inicjalizuj terminal lub pytaj baz terminfo
.SH SKADNIA
\fBtput\fR [\fB-T\fR\fItyp\fR] \fInazwawaciwoci\fR [\fIparm\fR ... ]
.br
\fBtput\fR [\fB-T\fR\fItyp\fR] \fBinit\fR
.br
\fBtput\fR [\fB-T\fR\fItyp\fR] \fBreset\fR
.br
\fBtput\fR [\fB-T\fR\fItyp\fR] \fBlongname\fR
.br
\fBtput -S\fR  \fB<<\fR
.br
.SH OPIS
Narzdzie \fBtput\fR robi uytek z bazy \fBterminfo\fR, dajc molwio
dojcia do zalenych od terminala waciwoci z poziomu powoki (zobacz
\fBsh\fR(1)), a take inicjalizowania lub resetowania terminala, lub
zwracania dugiej nazwy danego typu terminala. 
.PP
Jeli atrybut
(\fInazwawaciwoci\fR) jest typu acuchowego, \fBtput\fR wydaje warto
acuchow, a jeli jest typu cakowitego, wydaje liczb cakowit.
Jeli atrybut jest wartoci logiczn, \fBtput\fR po prostu ustawia kod
wyjcia (\fB0\fR to prawda, jeli terminal ma dan waciwo, a \fB1\fR to
fasz, jeli terminal danej waciwoci nie posiada) i nie wydaje adnego
wyjcia tekstowego. 
.PP
Przed uyciem zwrconej wartoci, uytkownik powinien
przetestowa kod wyjscia i upewni si, e wynosi on \fB0\fR.
(Zobacz sekcje \fBKODY WYJCIA\fR i \fBDIAGNOSTYKA\fR.)
Dla kompletnej listy waciwoci i \fInazwwaciwoci\fR zwizanych z kad
z nich, zobacz \fBterminfo\fR(\*n).
.TP
\fB-T\fR\fItyp\fR
okrela typ terminala. Normalnie opcja ta jest niepotrzebna, gdy warto
domylna jest pobierana ze zmiennej rodowiskowej \fBTERM\fR. Jeli podane
jest \fB-T\fR, zmienne powoki \fBLINES\fR i \fBCOLUMNS\fR bd ignorowane,
a system operacyjny nie bdzie zapytywany o rzeczywisty rozmiar ekranu.
.TP
\fInazwawaciwoci\fR
okrela atrybut z bazy \fBterminfo\fR. Gdy wkompilowana jest obsuga
\fBtermcap\fR, mona podawa rwnie termcapowe nazwy atrybutw.
.TP
\fIparm\fR
Jeli atrybut jest acuchem, ktry wymaga parametrw, argumenty
\fIparam\fR zostan przeniesione do tego acucha. Wszystkie argumenty
numeryczne zostan atrybutowi przekazane jako liczby.
.TP
\fB-S\fR
umoliwiwa uywanie wicej ni jednej waciwoci na jedno wywoanie
\fBtput\fR. Waciwoci musz by przekazywane do \fBtput\fR ze
standardowego wejcia, a nie przez lini polece (zobacz przykad). Na lini
dozwolona jest tylko jedna \fInazwawaciwoci\fR. Opcja \fB-S\fR zmienia
znaczenie kodw wyjcia \fB0\fR i \fB1\fR (zobacz sekcj KODY WYJCIA).
.TP
\fBinit\fR
Jeli baza \fBterminfo\fR istnieje i znajduje si w niej opis dla terminala
uytkownika (zobacz wyej \fB-T\fItyp\fR), to stanie sie co nastpuje:
(1) jeli istniej acuchy inicjalizacyjne, to zostan one wysane
(\fBis1\fR, \fBis2\fR, \fBis3\fR, \fBif\fR, \fBiprog\fR), (2)
wszelkie opnienia (np. nowej linii), podane w opisie zostan ustawione w
sterowniku tty, (3) rozszerzanie tabulacji zostanie wczone lub wyczone,
zalenie od specyfikacji w opisie i (4) jeli tabulacje nie s rozszerzane,
ustawione zostan standardowe tabulacje (co 8 spacji).
Jeli opis nie zawiera informacji wymaganej dla ktrego z tych czterech
dziaa, to zostanie ono cicho pominite.
.TP
\fBreset\fR
Zamiast wystawiania acuchw inicjalizacji, wysane zostan (o ile s
obecne) acuchy resetowania (\fBrs1\fR, \fBrs2\fR, \fBrs3\fR, \fBrf\fR).
Jeli acuchy resetowania nie s zdefiniowane, lecz zdefiniowane s
acuchy inicjalizacji, to wysane zostan acuchy inicjalizacji. W
przeciwnym wypadku, \fBreset\fR dziaa analogicznie do \fBinit\fR.
.TP
\fBlongname\fR
Jeli obecna jest baza terminfo i istnieje w niej opis dla terminala
uytkownika (zobacz wyej \fB-T\fItyp\fR), to wywietlona zostanie duga
nazwa terminala. Duga nazwa jest ostatni nazw w pierwszej linii opisu
terminala w bazie terminfo [zobacz \fBterm\fR(5)].
.SH PRZYKADY
.TP 5
\fBtput init\fR
Inicjalizuj terminal wedug typu terminala ze zmiennej rodowiskowej
\fBTERM\fR. Komenda ta powinna by zaczona do .profile kadego uytkownika
po wyeksportowaniu zmiennej rodowiskowej \fBTERM\fR, jak pokazano w
podrczniku \fBprofile\fR(4).
.TP 5
\fBtput -T5620 reset\fR
Resetuj terminal AT&T 5620, przeciajc rodzaj terminala ze zmiennej
rodowiskowej \fBTERM\fR.
.TP 5
\fBtput cup 0 0\fR
Wylij sekwencj do przesunicia kursora do wiersza \fB0\fR, kolumny \fB0\fR
(lewy grny naronik ekranu, znany zwykle jako "domowa" (home) pozycja
kursora).
.TP 5
\fBtput clear\fR
Wylij na biecy terminal sekwencj czyszczc ekran.
.TP 5
\fBtput cols\fR
Wydrukuj liczb kolumn w biecym terminalu.
.TP 5
\fBtput -T450 cols\fR
Wydrukuj liczb kolumn terminala 450.
.TP 5
\fBbold=`tput smso` offbold=`tput rmso`\fR
Ustaw zmienne powoki \fBbold\fR na pocztek sekwencji trybu standout i
\fBoffbold\fR na koniec sekwencji trybu standout biecego terminala. Moe
to by uyte w znaku zachty:
\fBecho "${bold}Prosz wpisa imi: ${offbold}\\c"\fR
.TP 5
\fBtput hc\fR
Ustaw kod wyjcia, okrelajcy czy terminal jest terminalem hard copy.
.TP 5
\fBtput cup 23 4\fR
Wylij sekwencj przesuwajc kursor do wiersza 23 w 4 kolumnie.
.TP 5
\fBtput longname\fR
Wydrukuj dug nazw terminala \fBTERM\fR, okrelon w bazie \fBterminfo\fR.
.TP 0
\fBtput -S <<!\fR
.br
\fB> clear\fR
.br
\fB> cup 10 10\fR
.br
\fB> bold\fR
.br
\fB> !\fR
.TP 5
\&
Ten przykad pokazuje przetwarzania przez tput kilku waciwoci w jednym
wywoaniu. Przykad ten czyci ekran, przesuwa kursor do pozycji 10, 10 i
wcza tryb wytuszczenia. Lista jest koczona znakiem wykrzyknika,
znajdujcym si w osobnej linii.
.SH PLIKI
.TP
\fB\*d\fR
skompilowana baza opisu terminala
.TP
\fB/usr/include/curses.h\fR
plik nagwkowy \fBcurses\fR(3X)
.TP
\fB/usr/include/term.h\fR
plik nagwkowy \fBterminfo\fR
.TP
\fB/usr/share/tabset/*\fR
ustawienia tab dla niektrych terminali w formacie odpowiednim do wysyania
na terminal (sekwencje specjalne, ustawiajce marginesy i tabulacje); dla
dalszych informacji, zobacz sekcj "Tabs and Initialization"
\fBterminfo\fR(4).
.SH ZOBACZ TAKE
\fBclear\fR(1), \fBstty\fR(1), \fBtabs\fR(\*n).  \fBprofile\fR(\*n),
\fBterminfo\fR(4) w podrczniku \fISystem\fR \fIAdministrator\fR'\fIs\fR
\fIReference\fR \fIManual\fR.  Rozdzia 10 podrcznika
\fIProgrammer\fR'\fIs\fR \fIGuide\fR.
.SH KODY WYJCIA
Jeli \fInazwawaciwoci\fR jest typu logicznego, dla prawdy zwracana jest
warto \fB0\fR, a dla faszu \fB1\fR. Wyjtkiem jest uycie opcji \fB-S\fR.

Jeli \fInazwawaciwoci\fR jest typu acuchowego, zwracane jest \fB0\fR,
gdy wasciwo jest zdefiniowana dla tego terminala (warto
\fInazwywaciwoci\fR jest zwracana na standardowe wyjcie); zwracane jest
\fB1\fR jeli waciwo \fInazwawaciwoci\fR nie jest zdefiniowana dla
tego terminala (na stdout nie jest nic wypisywane).

Jeli \fInazwawaciwoci\fR jest typu logicznego, lub acuchowego i uyto
opcji \fB-S\fR, w wypadku gdy wszystkie linie byy pomylne zwracane jest
\fB0\fR. Poniewa nie mona okreli, ktra z linii si nie powioda, nie
jest zwracana warto \fB1\fR. Kody wyjcia \fB2\fR, \fB3\fR i \fB4\fR maj
swoj tradycyjn interpretacj.

Jeli \fInazwawaciwoci\fR jest typu cakowitego, zwracane jest zawsze
\fB0\fR. Aby okreli czy wasciwo jest zdefiniowana, uytkownik musi
testowa warto standardowego wyjcia. Warto \fB-1\fR oznacza, e
wasciwo nie jest zdefiniowana dla tego terminala.

Wszystkie inne kody wyjcia oznaczaj bdy; zobacz sekcj DIAGNOSTYKA.
.SH DIAGNOSTYKA
\fBtput\fR drukuje nastpujce komunikaty o bdach i ustawia odpowiednie
kody bdw:

.TS
l l.
kod bdu	komunikat bdu
\fB0\fR	(\fInazwawaciwoci\fR jest zmienn numeryczn, ktra nie jest
	podana w bazie \fBterminfo\fR(\*n) tego typu terminala, np.
	\fBtput -T450 lines\fR i \fBtput -T2621 xmc\fR)
\fB1\fR	nie jest drukowany aden komunikat bdu, zobacz sekcj \fBKODY
	WYJCIA\fR.
\fB2\fR	bd uycia.
\fB3\fR	nieznany typ terminala, lub brak bazy \fBterminfo\fR.
\fB4\fR	nieznana wasciwo \fInazwawaciwoci\fR \fBterminfo\fR
.TE
.SH PRZENONO
Opcje \fBlongname\fR i \fB-S\fR oraz waciwoci podstawiania parametrw,
uywane w przykadzie \fBcup\fR nie s obsugiwane w BSD curses i w
AT&T/USL curses przed SVr4.
.\"#
.\"# The following sets edit modes for GNU EMACS
.\"# Local Variables:
.\"# mode:nroff
.\"# fill-column:79
.\"# End: