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

nroff [-bcCEhikpRStUVz] [-d  ctext] [-d  string= text] [-K  fallback-encoding] [-m  macro-package] [-M  macro-directory] [-n  page-number] [-o  page-list] [-P  postprocessor-argument] [-r  cnumeric-expression] [-r  register= numeric-expression] [-T  output-device] [-w  warning-category] [-W  warning-category] [file . . .] nroff --help nroff -v nroff --version

nroff formats documents written in the

language for typewriter-like devices such as terminal emulators. GNU nroff emulates the AT&T nroff command using

nroff generates output via

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

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

-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, -R, -t, and -S are documented in

-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.