Open Source Software

nroff(1)



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.



Free and Open Source Software


Free Software Video

Useful Programs

Free Online Courses

Open Opportunity

Open Business