NAME

       nroff - emulate nroff command with groff

SYNOPSIS

       nroff [-CchipStUvwW] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn] [-Tname] [file ...]
       nroff --help
       nroff -v | --version

DESCRIPTION

       The  nroff  script  emulates the nroff command using groff.  Only ascii, latin1, utf8, and
       cp1047 are devices accepted by nroff to select the  output  encoding  emitted  by  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 LC_ALL, LC_CTYPE, and LANG, and finally
       the LESSCHARSET environment variable.

       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
       silently ignores the options -e, -q, and -s (which are not implemented in troff).  Options
       -p  (pic),  -t  (tbl),  -S (safer), and -U (unsafe) are passed to groff.  -v and --version
       show the version number, --help prints a help message.

ENVIRONMENT

       GROFF_TYPESETTER
              The default device for groff.  If not set (which is the normal case),  it  defaults
              to ‘ps’.

       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.

NOTES

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

SEE ALSO

       groff(1), troff(1), grotty(1)

COPYING

       Copyright © 1989-2014 Free Software Foundation, Inc.

       Permission  is  granted to make and distribute verbatim copies of this manual provided the
       copyright notice and this permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified versions of this  manual  under  the
       conditions  for  verbatim  copying,  provided  that  the  entire resulting derived work is
       distributed under the terms of a permission notice identical to this one.

       Permission is granted to copy and distribute translations  of  this  manual  into  another
       language,  under  the  above conditions for modified versions, except that this permission
       notice may be included in translations approved by the Free Software Foundation instead of
       in the original English.