NAME

       nroff - use groff to format documents for TTY devices

SYNOPSIS

       nroff [-CchipStUv] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn] [-Tname] [-Wwarning]
             [-wwarning] [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  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.

ENVIRONMENT

       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.

       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.

NOTES

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

SEE ALSO

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