Nazwa¶

nroff - formatuje dokumenty za pomocą groff dla urządzeń terminali („TTY”)

Składnia¶

Opis¶

nroff formatuje dokumenty napisane w języku groff(7) dla urządzeń podobnych do maszyn do pisania, takich jak emulatory terminala. GNU nroff emuluje polecenie AT&T nroff za pomocą groff(1). nroff tworzy wyjście za pomocą grotty(1), sterownika wyjściowego terminala groff, który musi znać kodowanie, z którego korzysta urządzenie. Zatem akceptowanymi argumentami opcji -T są: ascii, latin1 i utf8; wszelkie inne są ignorowane. Jeśli (prawidłowego) urządzenia nie określa zmienna środowiskowa GROFF_TYPESETTER, ani opcja wiersza poleceń -T (która przesłania zmienną środowiskową), nroff sprawdza bieżące ustawienia językowe (locale), aby wybrać odpowiednie urządzenie wyjściowe. Na początku próbuje korzystać z programu locale(1) , następnie sprawdza kilka zmiennych środowiskowych związanych z locale; zob. rozdział „Środowisko” poniżej. Jeśli nic z tego się nie powiedzie, nroff przyjmuje „-Tascii”.

Opcje: -a, -b, -c, -C, -d, -E, -i, -I, -m, -M, -n, -o, -r, -U, -w, -W i -z działają zgodnie z opisem w podręczniku troff(1). Opcje -c i -h wymuszają, odpowiednio, „-P-c” i „-P-h”, -c ma znaczenie również dla samego troff. Co więcej, GNU nroff ignoruje opcje -e, -q i -s z AT&T nroff. groff(1) dokumentuje opcje: -D, -k, -K, -p, -P, -R, -t, -S i -Z. Opcja -V powoduje, że nroff wyświetli utworzone polecenie groff w standardowym strumieniu wyjściowym, ale go nie wykona. Opcje -v i --version pokazują informacje o wersji nroff i programów, które on wykonuje, a --help wyświetla pomoc, wszystkie następnie wychodzą z programu.

Status zakończenia¶

nroff wychodzi z: statusem 2, jeśli wystąpił problem przy przetwarzaniu argumentów; statusem 0, jeśli podano jedną z opcji -V, -v, --version lub --help; statusem programu groff w pozostałych przypadkach.

Środowisko¶

Separatorem ścieżki w zmiennych środowiskowych kończących się PATH, jest zwykle dwukropek; może się to różnić, w zależności od systemu operacyjnego. Przykładowo, Windows używa średnika.

GROFF_BIN_PATH

Szuka poleceń groff w tych katalogach, a następnie w katalogach z PATH. Jeśli nieustawiona, przed PATH przeszukiwany jest katalog instalacyjny plików wykonywalnych GNU roff, /usr/bin.

GROFF_TYPESETTER

określa domyślne urządzenie wyjściowe dla programu groff.

LC_ALL

LC_CTYPE

LANG

LESSCHARSET

są przeszukiwane w tej kolejności, dopasowując wzorzec odpowiadający jednemu ze standardowych kodowań obsługiwanych przez program groff, jeśli nie poda się opcji -T i nie ustawiono GROFF_TYPESETTER albo gdy podane tam wartości są nieprawidłowe.

Pliki¶

/usr/share/groff/1.24.1/tmac/tty-char.tmac

określa zapasowe definicje specjalnych znaków roff. Definicje te stanowią gorsze przybliżenie typograficzne wyjścia wobec tty.tmac, preferując właściwe zakomunikowanie znaczenia. nroff ładuje go automatycznie.

Uwagi¶

Programy stronicujące takie jak more(1) i less(1) mogą wymagać opcji wiersza poleceń, aby prawidłowo obsłużyć niektóre sekwencje wyjściowe; zob. grotty(1).

Zobacz także¶

groff(1), troff(1), grotty(1), locale(1), roff(7)

TŁUMACZENIE¶

Tłumaczenie niniejszej strony podręcznika: Przemek Borys <pborys@dione.ids.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.