src/roff/nroff/nroff.man

   1 .ig \"-*- nroff -*-
   2 Copyright (C) 1989-2000 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 @G@NROFF @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
  20 .SH NAME
  21 @g@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'\fB@g@nroff 'u
  27 .ti \niu
  28 .B @g@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 \-r cn
  39 .OP \-T name
  40 .RI "[\ " file\|.\|.\|. "\ ]"
  41 .br
  42 .ad \na
  43 .SH DESCRIPTION
  44 The
  45 .B @g@nroff
  46 script emulates the
  47 .B nroff
  48 command using groff.
  49 The
  50 .B \-T
  51 option with an argument other than
  52 .BR ascii ,
  53 .BR latin1 ,
  54 .BR utf8 ,
  55 or
  56 .B cp1047
  57 will be ignored.
  58 The
  59 .B \-h
  60 option
  61 is equivalent to the
  62 .B grotty
  63 .B \-h
  64 option.
  65 The
  66 .BR \-i ,
  67 .BR \-n ,
  68 .BR \-m ,
  69 .B \-o
  70 and
  71 .B \-r
  72 options have the effect described in
  73 .BR @g@troff (@MAN1EXT@).
  74 In addition
  75 .B @g@nroff
  76 silently ignores options of
  77 .BR \-e ,
  78 .B \-q
  79 or
  80 .BR \-s .
  81 Options
  82 .B \-S
  83 (safer) and
  84 .B \-U
  85 (unsafe) are passed to
  86 .BR groff .
  87 .B \-S
  88 is passed by default.
  89 .SH NOTES
  90 This shell script is basically intended for use with
  91 .BR man (1),
  92 so warnings are suppressed.
  93 nroff-style character definitions (in the file tmac.tty-char) are also
  94 loaded to emulate unrepresentable glyphs.
  95 .SH "SEE ALSO"
  96 .BR groff (@MAN1EXT@),
  97 .BR @g@troff (@MAN1EXT@),
  98 .BR grotty (@MAN1EXT@)