nroff.man revision 75590 
11590Srgrimes.ig \"-*- nroff -*-
259945SphantomCopyright (C) 1989-2000 Free Software Foundation, Inc.
31590Srgrimes
41590SrgrimesPermission is granted to make and distribute verbatim copies of
515714Sachethis manual provided the copyright notice and this permission notice
615714Sacheare preserved on all copies.
778046Sache
878046SachePermission is granted to copy and distribute modified versions of this
978046Sachemanual under the conditions for verbatim copying, provided that the
1013684Swoschentire resulting derived work is distributed under the terms of a
111590Srgrimespermission notice identical to this one.
121590Srgrimes
1313684SwoschPermission is granted to copy and distribute translations of this
1415008Sjdpmanual into another language, under the above conditions for modified
1514147Swoschversions, except that this permission notice may be included in
1614147Swoschtranslations approved by the Free Software Foundation instead of in
1786053Sddthe original English.
1815008Sjdp
1914147Swosch	$FreeBSD: head/contrib/groff/src/roff/nroff/nroff.man 75590 2001-04-17 12:28:31Z ru $
2078046Sache
2178046Sache..
2278046Sache.TH @G@NROFF @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
2378046Sache.SH NAME
2478046Sache@g@nroff \- emulate nroff command with groff
2578046Sache.SH SYNOPSIS
2678046Sache.nr a \n(.j
2778046Sache.ad l
281590Srgrimes.nr i \n(.i
291590Srgrimes.in +\w'\fB@g@nroff 'u
30.ti \niu
31.B @g@nroff
32.de OP
33.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
34.el .RB "[\ " "\\$1" "\ ]"
35..
36.OP \-v
37.OP \-h
38.OP \-i
39.OP \-m name
40.OP \-n num
41.OP \-o list
42.OP \-p
43.OP \-r cn
44.OP \-t
45.OP \-T name
46.RI "[\ " file\|.\|.\|. "\ ]"
47.br
48.ad \na
49.SH DESCRIPTION
50The
51.B @g@nroff
52script emulates the
53.B nroff
54command using groff.
55The
56.B \-T
57option with an argument other than
58.BR ascii ,
59.BR latin1 ,
60.BR koi8-r ,
61.BR utf8 ,
62or
63.B cp1047
64will be ignored (and
65.B \-Tascii
66will be used).
67The
68.B \-h
69option
70is equivalent to the
71.B grotty
72.B \-h
73option.
74The
75.BR \-i ,
76.BR \-n ,
77.BR \-m ,
78.B \-o
79and
80.B \-r
81options have the effect described in
82.BR @g@troff (@MAN1EXT@).
83In addition
84.B @g@nroff
85silently ignores options of
86.BR \-e ,
87.B \-q
88or
89.BR \-s .
90Options 
91.B \-p
92(pic),
93.B \-t
94(tbl),
95.B \-S
96(safer) and
97.B \-U
98(unsafe) are passed to
99.BR groff . 
100.B \-S
101is passed by default.
102.B \-v
103shows the version number.
104.SH ENVIRONMENT
105.TP
106.SM
107.B GROFF_BIN_PATH
108A colon separated list of directories in which to search for the
109.B groff
110executable.  If unset, `@BINDIR@' is used.
111.SH NOTES
112This shell script is basically intended for use with
113.BR man (1),
114so warnings are suppressed.
115nroff-style character definitions (in the file tty-char.tmac) are also
116loaded to emulate unrepresentable glyphs.
117.SH "SEE ALSO"
118.BR groff (@MAN1EXT@),
119.BR @g@troff (@MAN1EXT@),
120.BR grotty (@MAN1EXT@)
121