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 .B latin1
  54 or
  55 .B utf8
  56 will be ignored.
  57 The
  58 .B \-h
  59 option
  60 is equivalent to the
  61 .B grotty
  62 .B \-h
  63 option.
  64 The
  65 .BR \-i ,
  66 .BR \-n ,
  67 .BR \-m ,
  68 .B \-o
  69 and
  70 .B \-r
  71 options have the effect described in
  72 .BR @g@troff (@MAN1EXT@).
  73 In addition
  74 .B @g@nroff
  75 silently ignores options of
  76 .BR \-e ,
  77 .B \-q
  78 or
  79 .BR \-s .
  80 Options
  81 .B \-S
  82 (safer) and
  83 .B \-U
  84 (unsafe) are passed to
  85 .BR groff .
  86 .B \-S
  87 is passed by default.
  88 .SH NOTES
  89 This shell script is basically intended for use with
  90 .BR man (1),
  91 so warnings are suppressed.
  92 nroff-style character definitions (in the file tmac.tty-char) are also
  93 loaded to emulate unrepresentable glyphs.
  94 .SH "SEE ALSO"
  95 .BR groff (@MAN1EXT@),
  96 .BR @g@troff (@MAN1EXT@),
  97 .BR grotty (@MAN1EXT@)