Mac Developer Library Developer


This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

NROFF(1)                                                                                            NROFF(1)

       nroff - emulate nroff command with groff

       nroff [ -CchipStUv ] [ -dcs ] [ -Mdir ] [ -mname ] [ -nnum ] [ -olist ] [ -rcn ] [ -Tname ]
             [ file ... ]

       The nroff script emulates the nroff command using groff.  Only ascii, latin1, utf8,  and  cp1047  are
       valid  arguments for the -T option, selecting the output encoding emitted by grotty, groff's TTY out-put output
       put device.  If an invalid or no -T option is given, 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, and -r
       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 shows the version number.

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

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

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

Groff Version 1.19.2                            12 April 2005                                       NROFF(1)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.