nroff(1)

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

Składnia
nroff [-abcCEhikpRStUVzZ] [-d ztekst] [-d łańcuch=tekst] [-D zapasowe-kodowanie-wejściowe] [-I katalog-włączeń] [-K kodowanie-wejściowe] [-m pakiet-makr] [-M katalog-makr] [-n numer-strony] [-o lista-stron] [-P argument-postprocesora] [-r zwyrażenie-numeryczne] [-r rejestr=wyrażenie-numeryczne] [-T urządzenie-wyjściowe] [-w kategoria-ostrzeżeń] [-W kategoria-ostrzeżeń] [plik ...]

nroff --help

nroff -v [inna-opcja-nroff ...]
nroff --version [inna-opcja-nroff ...]

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.