1NROFF(1)                    General Commands Manual                   NROFF(1)
2
3
4

NAME

6       nroff - use groff to format documents for TTY devices
7

SYNOPSIS

9       nroff [-CchipStUv] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn]
10             [-Tname] [-Wwarning] [-wwarning] [file ...]
11
12       nroff --help
13
14       nroff -v
15       nroff --version
16

DESCRIPTION

18       nroff formats documents written in the roff(7) language for typewriter-
19       like devices such as terminal emulators.
20
21       GNU  nroff  emulates the traditional Unix nroff command using groff(1).
22       nroff generates output via grotty(1), groff's TTY output device,  which
23       needs to know the character encoding scheme used by the terminal.  Con‐
24       sequently, acceptable arguments to the -T  option  are  ascii,  latin1,
25       utf8,   and   cp1047;   any   others   are  ignored.   If  neither  the
26       GROFF_TYPESETTER environment variable nor the  -T  command-line  option
27       (which  overrides the environment variable) specifies a (valid) device,
28       nroff consults the locale to select an appropriate output  device.   It
29       first  tries  the locale(1) program, then checks several locale-related
30       environment variables; see “ENVIRONMENT”, below.  If all of the forego‐
31       ing fail, -Tascii is implied.
32
33       Whitespace is not permitted between an option and its argument.  The -h
34       and -c options are equivalent to grotty's options -h (using tabs in the
35       output)  and  -c (using the old output scheme instead of SGR escape se‐
36       quences).  The -d, -C, -i, -M, -m, -n, -o, -r, -w, and -W options  have
37       the  effect  described in troff(1).  In addition, nroff ignores -e, -q,
38       and -s (which are not implemented in troff).  The options -p (pic),  -t
39       (tbl),  -S (safer), and -U (unsafe) are passed to groff.  -v and --ver‐
40       sion show version information, while --help displays a  usage  message;
41       all exit afterward.
42

ENVIRONMENT

44       GROFF_TYPESETTER
45              specifies the default output device for groff.
46
47       GROFF_BIN_PATH
48              is  a colon-separated list of directories in which to search for
49              the groff executable before searching in PATH.  If unset,  /usr/
50              bin is used.
51
52       LC_ALL
53       LC_CTYPE
54       LANG
55       LESSCHARSET
56              are  pattern-matched in this order for standard character encod‐
57              ings supported by groff in the event no -T option is  given  and
58              GROFF_TYPESETTER is unset.
59

NOTES

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

SEE ALSO

65       groff(1), troff(1), grotty(1), locale(1), roff(7)
66
67
68
69groff 1.22.4                     17 March 2021                        NROFF(1)
Impressum