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)

COPYING         top

       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.

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 tarball groff-1.22.3.tar.gz fetched from
       ⟨⟩ on 2017-09-15.  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           4 November 2014                      NROFF(1)

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