Provided by: manpages-pl_0.7-2_all 
NAZWA
tput - inicjalizuj terminal lub pytaj bazę terminfo
SKŁADNIA
tput [-Ttyp] nazwawłaściwości [parm ... ]
tput [-Ttyp] init
tput [-Ttyp] reset
tput [-Ttyp] longname
tput -S <<
OPIS
Uwaga! To tłumaczenie może być nieaktualne!
Narzędzie tput robi użytek z bazy terminfo, dając możlwiość dojścia do zależnych od
terminala właściwości z poziomu powłoki (zobacz sh(1)), a także inicjalizowania lub
resetowania terminala, lub zwracania długiej nazwy żądanego typu terminala.
Jeśli atrybut (nazwawłaściwości) jest typu łańcuchowego, tput wydaje wartość łańcuchową, a
jeśli jest typu całkowitego, wydaje liczbę całkowitą. Jeśli atrybut jest wartością
logiczną, tput po prostu ustawia kod wyjścia (0 to prawda, jeśli terminal ma daną
właściwość, a 1 to fałsz, jeśli terminal żądanej właściwości nie posiada) i nie wydaje
żadnego wyjścia tekstowego.
Przed użyciem zwróconej wartości, użytkownik powinien przetestować kod wyjscia i upewnić
się, że wynosi on 0. (Zobacz sekcje KODY WYJŚCIA i DIAGNOSTYKA.) Dla kompletnej listy
właściwości i nazwwłaściwości związanych z każdą z nich, zobacz terminfo(5).
-Ttyp określa typ terminala. Normalnie opcja ta jest niepotrzebna, gdyż wartość domyślna
jest pobierana ze zmiennej środowiskowej TERM. Jeśli podane jest -T, zmienne
powłoki LINES i COLUMNS będą ignorowane, a system operacyjny nie będzie zapytywany
o rzeczywisty rozmiar ekranu.
nazwawłaściwości
określa atrybut z bazy terminfo. Gdy wkompilowana jest obsługa termcap, można
podawać również termcapowe nazwy atrybutów.
parm Jeśli atrybut jest łańcuchem, który wymaga parametrów, argumenty param zostaną
przeniesione do tego łańcucha. Wszystkie argumenty numeryczne zostaną atrybutowi
przekazane jako liczby.
-S umożliwiwa używanie więcej niż jednej właściwości na jedno wywołanie tput.
Właściwości muszą być przekazywane do tput ze standardowego wejścia, a nie przez
linię poleceń (zobacz przykład). Na linię dozwolona jest tylko jedna
nazwawłaściwości. Opcja -S zmienia znaczenie kodów wyjścia 0 i 1 (zobacz sekcję
KODY WYJŚCIA).
init Jeśli baza terminfo istnieje i znajduje się w niej opis dla terminala użytkownika
(zobacz wyżej -Ttyp), to stanie sie co następuje: (1) jeśli istnieją łańcuchy
inicjalizacyjne, to zostaną one wysłane (is1, is2, is3, if, iprog), (2) wszelkie
opóźnienia (np. nowej linii), podane w opisie zostaną ustawione w sterowniku tty,
(3) rozszerzanie tabulacji zostanie włączone lub wyłączone, zależnie od
specyfikacji w opisie i (4) jeśli tabulacje nie są rozszerzane, ustawione zostaną
standardowe tabulacje (co 8 spacji). Jeśli opis nie zawiera informacji wymaganej
dla któregoś z tych czterech działań, to zostanie ono cicho pominięte.
reset Zamiast wystawiania łańcuchów inicjalizacji, wysłane zostaną (o ile są obecne)
łańcuchy resetowania (rs1, rs2, rs3, rf). Jeśli łańcuchy resetowania nie są
zdefiniowane, lecz zdefiniowane są łańcuchy inicjalizacji, to wysłane zostaną
łańcuchy inicjalizacji. W przeciwnym wypadku, reset działa analogicznie do init.
longname
Jeśli obecna jest baza terminfo i istnieje w niej opis dla terminala użytkownika
(zobacz wyżej -Ttyp), to wyświetlona zostanie długa nazwa terminala. Długa nazwa
jest ostatnią nazwą w pierwszej linii opisu terminala w bazie terminfo [zobacz
term(5)].
PRZYKŁADY
tput init
Inicjalizuj terminal według typu terminala ze zmiennej środowiskowej TERM. Komenda ta
powinna być załączona do .profile każdego użytkownika po wyeksportowaniu zmiennej
środowiskowej TERM, jak pokazano w podręczniku profile(4).
tput -T5620 reset
Resetuj terminal AT&T 5620, przeciążając rodzaj terminala ze zmiennej środowiskowej
TERM.
tput cup 0 0
Wyślij sekwencję do przesunięcia kursora do wiersza 0, kolumny 0 (lewy górny narożnik
ekranu, znany zwykle jako "domowa" (home) pozycja kursora).
tput clear
Wyślij na bieżący terminal sekwencję czyszczącą ekran.
tput cols
Wydrukuj liczbę kolumn w bieżącym terminalu.
tput -T450 cols
Wydrukuj liczbę kolumn terminala 450.
bold=`tput smso` offbold=`tput rmso`
Ustaw zmienne powłoki bold na początek sekwencji trybu standout i offbold na koniec
sekwencji trybu standout bieżącego terminala. Może to być użyte w znaku zachęty: echo
"${bold}Proszę wpisać imię: ${offbold}\c"
tput hc
Ustaw kod wyjścia, określający czy terminal jest terminalem hard copy.
tput cup 23 4
Wyślij sekwencję przesuwającą kursor do wiersza 23 w 4 kolumnie.
tput longname
Wydrukuj długą nazwę terminala TERM, określoną w bazie terminfo.
tput -S <<!
> clear
> cup 10 10
> bold
> !
Ten przykład pokazuje przetwarzania przez tput kilku właściwości w jednym wywołaniu.
Przykład ten czyści ekran, przesuwa kursor do pozycji 10, 10 i włącza tryb
wytłuszczenia. Lista jest kończona znakiem wykrzyknika, znajdującym się w osobnej
linii.
PLIKI
/usr/share/terminfo
skompilowana baza opisu terminala
/usr/include/curses.h
plik nagłówkowy curses(3X)
/usr/include/term.h
plik nagłówkowy terminfo
/usr/share/tabset/*
ustawienia tab dla niektórych terminali w formacie odpowiednim do wysyłania na
terminal (sekwencje specjalne, ustawiające marginesy i tabulacje); dla dalszych
informacji, zobacz sekcję "Tabs and Initialization" terminfo(4).
ZOBACZ TAKŻE
clear(1), stty(1), tabs(5). profile(5), terminfo(4) w podręczniku System Administrator's
Reference Manual. Rozdział 10 podręcznika Programmer's Guide.
KODY WYJŚCIA
Jeśli nazwawłaściwości jest typu logicznego, dla prawdy zwracana jest wartość 0, a dla
fałszu 1. Wyjątkiem jest użycie opcji -S.
Jeśli nazwawłaściwości jest typu łańcuchowego, zwracane jest 0, gdy własciwość jest
zdefiniowana dla tego terminala (wartość nazwywłaściwości jest zwracana na standardowe
wyjście); zwracane jest 1 jeśli właściwość nazwawłaściwości nie jest zdefiniowana dla tego
terminala (na stdout nie jest nic wypisywane).
Jeśli nazwawłaściwości jest typu logicznego, lub łańcuchowego i użyto opcji -S, w wypadku
gdy wszystkie linie były pomyślne zwracane jest 0. Ponieważ nie można określić, która z
linii się nie powiodła, nie jest zwracana wartość 1. Kody wyjścia 2, 3 i 4 mają swoją
tradycyjną interpretację.
Jeśli nazwawłaściwości jest typu całkowitego, zwracane jest zawsze 0. Aby określić czy
własciwość jest zdefiniowana, użytkownik musi testować wartość standardowego wyjścia.
Wartość -1 oznacza, że własciwość nie jest zdefiniowana dla tego terminala.
Wszystkie inne kody wyjścia oznaczają błędy; zobacz sekcję DIAGNOSTYKA.
DIAGNOSTYKA
tput drukuje następujące komunikaty o błędach i ustawia odpowiednie kody błędów:
kod błędu komunikat błędu
0 (nazwawłaściwości jest zmienną numeryczną, która nie jest
podana w bazie terminfo(5) tego typu terminala, np.
tput -T450 lines i tput -T2621 xmc)
1 nie jest drukowany żaden komunikat błędu, zobacz sekcję
KODY WYJŚCIA.
2 błąd użycia.
3 nieznany typ terminala, lub brak bazy terminfo.
4 nieznana własciwość nazwawłaściwości terminfo
PRZENOŚNOŚĆ
Opcje longname i -S oraz właściwości podstawiania parametrów, używane w przykładzie cup
nie są obsługiwane w BSD curses i w AT&T/USL curses przed SVr4.
INFORMACJE O TŁUMACZENIU
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może
nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym
zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną
(angielską) wersją strony podręcznika za pomocą polecenia:
man --locale=C 1 tput
Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.
tput(1)