Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



   nroff    ( 1 )

форматировать документы с помощью groff для TTY (оконечных) устройств (format documents with groff for TTY (terminal) devices)

Имя (Name)

nroff - format documents with groff for TTY (terminal) devices


Синопсис (Synopsis)

nroff [-bcCEhikpStUVz] [-d cs] [-d name=string] [-K enc] [-m name] [-M dir] [-n num] [-o list] [-P arg] [-r cn] [-r reg=expr] [-T dev] [-w name] [-W name] [file ...]

nroff --help

nroff -v nroff --version


Описание (Description)

nroff formats documents written in the roff(7) language for typewriter-like devices such as terminal emulators. GNU nroff emulates the AT&T nroff command using groff(1). nroff generates output via grotty(1), groff's terminal output driver, which needs to know the character encoding scheme used by the device. Consequently, acceptable arguments to the -T option are ascii, latin1, utf8, and cp1047; any others are ignored. If neither the GROFF_TYPESETTER environment variable nor the -T command-line option (which overrides the environment variable) specifies a (valid) device, nroff consults the locale to select an appropriate output device. It first tries the locale(1) program, then checks several locale-related environment variables; see section 'Environment', below. If all of the foregoing fail, -Tascii is implied.

The -b, -c, -C, -d, -E, -i, -m, -M, -n, -o, -r, -U, -w, -W, and -z options have the effects described in troff(1). -c and -h imply '-P-c' and '-P-h', respectively; -c is also interpreted directly by troff. In addition, this implementation ignores the AT&T nroff options -e, -q, and -s (which are not implemented in groff). The options -k, -K, -p, -P, -t, and -S are documented in groff(1). -V causes nroff to display the constructed groff command on the standard output stream, but does not execute it. -v and --version show version information about nroff and the programs it runs, while --help displays a usage message; all exit afterward.


Статус выхода (Exit)

nroff exits with error status 2 if there was a problem parsing its arguments, with status 0 if any of the options -V, -v, --version, or --help were specified, and with the status of groff otherwise.


Окружение (Environment)

GROFF_BIN_PATH is a colon-separated list of directories in which to search for the groff executable before searching in PATH. If unset, /usr/local/bin is used.

GROFF_TYPESETTER specifies the default output device for groff.

LC_ALL LC_CTYPE LANG LESSCHARSET are pattern-matched in this order for contents matching standard character encodings supported by groff in the event no -T option is given and GROFF_TYPESETTER is unset.


Файлы (Files)

/usr/local/share/groff/1.23.0/tmac/tty-char.tmac Character definitions from this file are loaded to replace unrepresentable glyphs.


Примечание (Note)

Pager programs like more(1) and less(1) may require command-line options to correctly handle some output sequences; see grotty(1).


Смотри также (See also)

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