raw/man1/gnroff.1

   1 .ig
   2 Copyright (C) 1989-2001 Free Software Foundation, Inc.
   3
   4 Permission is granted to make and distribute verbatim copies of
   5 this manual provided the copyright notice and this permission notice
   6 are preserved on all copies.
   7
   8 Permission is granted to copy and distribute modified versions of this
   9 manual under the conditions for verbatim copying, provided that the
  10 entire resulting derived work is distributed under the terms of a
  11 permission notice identical to this one.
  12
  13 Permission is granted to copy and distribute translations of this
  14 manual into another language, under the above conditions for modified
  15 versions, except that this permission notice may be included in
  16 translations approved by the Free Software Foundation instead of in
  17 the original English.
  18 ..
  19 .TH NROFF 1 "23 September 2003" "Groff Version 1.18.1"
  20 .SH NAME
  21 nroff \- emulate nroff command with groff
  22 .SH SYNOPSIS
  23 .nr a \n(.j
  24 .ad l
  25 .nr i \n(.i
  26 .in +\w'\fBnroff 'u
  27 .ti \niu
  28 .B nroff
  29 .de OP
  30 .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
  31 .el .RB "[\ " "\\$1" "\ ]"
  32 ..
  33 .OP \-h
  34 .OP \-i
  35 .OP \-m name
  36 .OP \-n num
  37 .OP \-o list
  38 .OP \-p
  39 .OP \-r cn
  40 .OP \-S
  41 .OP \-t
  42 .OP \-T name
  43 .OP \-U
  44 .OP \-v
  45 .RI "[\ " "file" "\ .\|.\|.\ ]"
  46 .br
  47 .ad \na
  48 .SH DESCRIPTION
  49 The
  50 .B nroff
  51 script emulates the
  52 .B nroff
  53 command using groff.
  54 Only
  55 .BR ascii ,
  56 .BR ascii8 ,
  57 .BR latin1 ,
  58 .BR utf8 ,
  59 .BR nippon ,
  60 and
  61 .B cp1047
  62 are valid arguments for the
  63 .B -T
  64 option.
  65 If an invalid or no
  66 .BR \-T
  67 option is given,
  68 .B nroff
  69 checks the current locale to select a default output device.
  70 It first tries the
  71 .B locale
  72 program, then the environment variables
  73 .BR LC_ALL ,
  74 .BR LC_CTYPE ,
  75 and
  76 .BR LANG ,
  77 and finally the
  78 .B LESSCHARSET
  79 environment variable.
  80 .PP
  81 The
  82 .B \-h
  83 and
  84 .B \-c
  85 options
  86 are equivalent to
  87 .BR grotty 's
  88 options
  89 .B \-h
  90 (using tabs in the output) and
  91 .B \-c
  92 (using the old output scheme instead of SGR escape sequences).
  93 The
  94 .BR \-C ,
  95 .BR \-i ,
  96 .BR \-n ,
  97 .BR \-m ,
  98 .BR \-o ,
  99 and
 100 .B \-r
 101 options have the effect described in
 102 .BR troff (1).
 103 In addition,
 104 .B nroff
 105 silently ignores the options
 106 .BR \-e ,
 107 .BR \-q ,
 108 and
 109 .BR \-s
 110 (which are not implemented in
 111 .BR troff ).
 112 Options
 113 .B \-p
 114 (pic),
 115 .B \-t
 116 (tbl),
 117 .B \-S
 118 (safer), and
 119 .B \-U
 120 (unsafe) are passed to
 121 .BR groff .
 122 .B \-v
 123 shows the version number.
 124 .SH ENVIRONMENT
 125 .TP
 126 .SM
 127 .B GROFF_BIN_PATH
 128 A colon separated list of directories in which to search for the
 129 .B groff
 130 executable before searching in PATH.  If unset, `/usr/bin' is used.
 131 .SH NOTES
 132 This shell script is basically intended for use with
 133 .BR man (1),
 134 so warnings are suppressed.
 135 nroff-style character definitions (in the file tty-char.tmac) are also
 136 loaded to emulate unrepresentable glyphs.
 137 .SH "SEE ALSO"
 138 .BR groff (1),
 139 .BR troff (1),
 140 .BR grotty (1)
 141 .
 142 .\" Local Variables:
 143 .\" mode: nroff
 144 .\" End: