Provided by: manpages-pl_0.5-1_all bug

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)