Man1 - nroff.1

nroff - use groff to format documents for TTY devices

nroff [*-CchipStUv*] [ -d*/cs/ ] [ *-M*/dir/ ] [ *-m*/name/ ] [ *-n*/num/ ] [ *-o*/list/ ] [ *-r*/cn/ ] [ *-T*/name/ ] [ *-W*/warning/ ] [ *-w*/warning/ ] [/file/ . . .] *nroff –help nroff -v nroff –version

nroff formats documents written in the /roff/(7) language for typewriter-like devices such as terminal emulators.

GNU nroff emulates the traditional Unix nroff command using groff/(1). /nroff generates output via grotty/(1), /groff’s TTY output device, which needs to know the character encoding scheme used by the terminal. 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 “ENVIRONMENT”, below. If all of the foregoing fail, -Tascii is implied.

Whitespace is not permitted between an option and its argument. The -h and -c options are equivalent to grotty’s options -h (using tabs in the output) and -c (using the old output scheme instead of SGR escape sequences). The -d, -C, -i, -M, -m, -n, -o, -r, -w, and -W options have the effect described in troff/(1). In addition, /nroff ignores -e, -q, and -s (which are not implemented in troff). The options -p (pic), -t (tbl), -S (safer), and -U (unsafe) are passed to groff. -v and –version show version information, while –help displays a usage message; all exit afterward.

GROFF_TYPESETTER

specifies the default output device for groff.

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/bin is used.

(no term)

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

Character definitions in the file /usr/share/groff/1.22.4/tmac/tty-char.tmac are loaded to replace unrepresentable glyphs.

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