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