1. NAME

nroff - emulate nroff command with groff .

2. SYNOPSIS

. .SY nroff .OP -CchipStUvwW .OP -d cs .OP -M dir .OP -m name .OP -n num .OP -o list .OP -r cn .OP -T name [ file\~ . . .] . .SY nroff

--help . .SY nroff

-v |

--version .YS .

3. DESCRIPTION

The

nroff script emulates the

nroff command using groff. Only

R ascii ,

R latin1 ,

R utf8 , and

cp1047 are devices accepted by

R nroff to select the output encoding emitted by

R grotty , groff's TTY output device. If neither the

GROFF_TYPESETTER environment variable nor the

-T command line option (which overrides the environment variable) specifies a (valid) device,

nroff checks the current locale to select a default output device. It first tries the

locale program, then the environment variables

R LC_ALL ,

R LC_CTYPE , and

R LANG , and finally the

LESSCHARSET environment variable.

The

-h and

-c options are equivalent to

R grotty 's options

-h (using tabs in the output) and

-c (using the old output scheme instead of SGR escape sequences). The

R -d ,

R -C ,

R -i ,

R -M ,

R -m ,

R -n ,

R -o ,

R -r ,

R -w , and

-W options have the effect described in

R troff (1). In addition,

nroff silently ignores the options

R -e ,

R -q , and

R -s (which are not implemented in

R troff ). Options

-p (pic),

-t (tbl),

-S (safer), and

-U (unsafe) are passed to

R groff .

-v and

--version show the version number,

--help prints a help message. .

4. ENVIRONMENT


  •     .B GROFF_TYPESETTER The default device for

R groff . If not set (which is the normal case), it defaults to `ps'. .


  •     .B GROFF_BIN_PATH A colon separated list of directories in which to search for the

groff executable before searching in PATH. If unset, `/usr/bin' is used. .

5. NOTES

This shell script is basically intended for use with

R man (1). nroff-style character definitions (in the file tty-char.tmac) are also loaded to emulate unrepresentable glyphs. .

6. SEE ALSO

R groff (1),

R troff (1),

R grotty (1) .