NROFF(1)                   General Commands Manual                  NROFF(1)

NAME         top

       nroff - emulate nroff command with groff

SYNOPSIS         top

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

DESCRIPTION         top

       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         top

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

              A colon separated list of directories in which to search for
              the groff executable before searching in PATH.  If unset,
              ‘/usr/local/bin’ is used.

NOTES         top

       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         top

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

COLOPHON         top

       This page is part of the groff (GNU troff) project.  Information
       about the project can be found at 
       ⟨⟩.  If you have a bug report for
       this manual page, see ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2019-03-06.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2019-03-03.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

Groff Version 1.22.3          24 November 2017                      NROFF(1)

Pages that refer to this page: col(1)colcrt(1)gdiffmk(1)groff(1)man(1)ul(1)write(1)zsoelim(1)