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

NAME

6       nroff - emulate nroff command with groff
7

SYNOPSIS

9       nroff [-CchipStUvwW] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn]
10             [-Tname] [file ...]
11       nroff --help
12       nroff -v | --version
13

DESCRIPTION

15       The nroff script emulates the nroff command using groff.   Only  ascii,
16       latin1,  utf8,  and  cp1047 are devices accepted by nroff to select the
17       output encoding emitted by grotty, groff's TTY output device.  If  nei‐
18       ther  the GROFF_TYPESETTER environment variable nor the -T command line
19       option (which overrides the environment variable) specifies  a  (valid)
20       device,  nroff  checks  the  current  locale to select a default output
21       device.  It first tries the locale program, then the environment  vari‐
22       ables  LC_ALL, LC_CTYPE, and LANG, and finally the LESSCHARSET environ‐
23       ment variable.
24
25       The -h and -c options are equivalent to grotty's options -h (using tabs
26       in  the  output)  and  -c  (using  the old output scheme instead of SGR
27       escape sequences).  The -d, -C, -i, -M, -m, -n,  -o,  -r,  -w,  and  -W
28       options  have  the  effect  described  in troff(1).  In addition, nroff
29       silently ignores the options -e, -q, and -s (which are not  implemented
30       in troff).  Options -p (pic), -t (tbl), -S (safer), and -U (unsafe) are
31       passed to groff.  -v and --version  show  the  version  number,  --help
32       prints a help message.
33

ENVIRONMENT

35       GROFF_TYPESETTER
36              The  default  device for groff.  If not set (which is the normal
37              case), it defaults to ‘ps’.
38
39       GROFF_BIN_PATH
40              A colon separated list of directories in which to search for the
41              groff executable before searching in PATH.  If unset, ‘/usr/bin’
42              is used.
43

NOTES

45       This shell script is basically intended for use  with  man(1).   nroff-
46       style character definitions (in the file tty-char.tmac) are also loaded
47       to emulate unrepresentable glyphs.
48

SEE ALSO

50       groff(1), troff(1), grotty(1)
51

COPYING

53       Copyright © 1989-2014 Free Software Foundation, Inc.
54
55       Permission is granted to make and distribute verbatim  copies  of  this
56       manual  provided  the  copyright  notice and this permission notice are
57       preserved on all copies.
58
59       Permission is granted to copy and distribute modified versions of  this
60       manual  under  the  conditions  for verbatim copying, provided that the
61       entire resulting derived work is distributed under the terms of a  per‐
62       mission notice identical to this one.
63
64       Permission  is granted to copy and distribute translations of this man‐
65       ual into another language, under the above conditions for modified ver‐
66       sions,  except  that this permission notice may be included in transla‐
67       tions approved by the Free Software Foundation instead of in the origi‐
68       nal English.
69
70
71
72Groff Version 1.22.3            4 November 2014                       NROFF(1)
Impressum