nroff.man revision 121880 
179550Sru.ig
2114410SruCopyright (C) 1989-2001, 2002 Free Software Foundation, Inc.
318099Spst
418099SpstPermission is granted to make and distribute verbatim copies of
518099Spstthis manual provided the copyright notice and this permission notice
618099Spstare preserved on all copies.
718099Spst
818099SpstPermission is granted to copy and distribute modified versions of this
918099Spstmanual under the conditions for verbatim copying, provided that the
1018099Spstentire resulting derived work is distributed under the terms of a
1118099Spstpermission notice identical to this one.
1218099Spst
1318099SpstPermission is granted to copy and distribute translations of this
1418099Spstmanual into another language, under the above conditions for modified
1518099Spstversions, except that this permission notice may be included in
1618099Spsttranslations approved by the Free Software Foundation instead of in
1718099Spstthe original English.
1851622Sphantom
1951622Sphantom	$FreeBSD: head/contrib/groff/src/roff/nroff/nroff.man 121880 2003-11-02 07:27:40Z ru $
2051622Sphantom
2118099Spst..
2218099Spst.TH @G@NROFF @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
2318099Spst.SH NAME
2418099Spst@g@nroff \- emulate nroff command with groff
2518099Spst.SH SYNOPSIS
2669631Sru.nr a \n(.j
2769631Sru.ad l
2869631Sru.nr i \n(.i
2969631Sru.in +\w'\fB@g@nroff 'u
3069631Sru.ti \niu
3118099Spst.B @g@nroff
3269631Sru.de OP
3369631Sru.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
3469631Sru.el .RB "[\ " "\\$1" "\ ]"
3569631Sru..
36114410Sru.OP \-CchipStUv
37121880Sru.OP \-d cs
3869631Sru.OP \-m name
3969631Sru.OP \-n num
4069631Sru.OP \-o list
4169631Sru.OP \-r cn
4269631Sru.OP \-T name
43104868Sru.RI "[\ " "file" "\ .\|.\|.\ ]"
4469631Sru.br
4569631Sru.ad \na
4618099Spst.SH DESCRIPTION
4718099SpstThe
4818099Spst.B @g@nroff
4918099Spstscript emulates the
5018099Spst.B nroff
5118099Spstcommand using groff.
5279550SruOnly 
5369631Sru.BR ascii ,
5469631Sru.BR latin1 ,
5569631Sru.BR koi8-r ,
5669631Sru.BR utf8 ,
5779550Sruand
5869631Sru.B cp1047
5979550Sruare valid arguments for the
6079550Sru.B -T
61114410Sruoption, selecting the output encoding emitted by
62114410Sru.BR grotty ,
63114410Srugroff's TTY output device.
6479550SruIf an invalid or no
6579550Sru.BR \-T
6679550Sruoption is given,
6779550Sru.B @g@nroff
6879550Sruchecks the current locale to select a default output device.
6979550SruIt first tries the
7079550Sru.B locale
7179550Sruprogram, then the environment variables
7279550Sru.BR LC_ALL ,
7379550Sru.BR LC_CTYPE ,
7479550Sruand
7579550Sru.BR LANG ,
7679550Sruand finally the
7779550Sru.B LESSCHARSET
7879550Sruenvironment variable.
7979550Sru.PP
8018099SpstThe
8118099Spst.B \-h
82104868Sruand
83104868Sru.B \-c
84104868Sruoptions
85104868Sruare equivalent to
8679550Sru.BR grotty 's
87104868Sruoptions
8818099Spst.B \-h
89104868Sru(using tabs in the output) and
90104868Sru.B \-c
91104868Sru(using the old output scheme instead of SGR escape sequences).
9218099SpstThe
93121880Sru.BR \-d ,
94104868Sru.BR \-C ,
9518099Spst.BR \-i ,
96114410Sru.BR \-m ,
9718099Spst.BR \-n ,
98104868Sru.BR \-o ,
9969631Sruand
10051622Sphantom.B \-r
10118099Spstoptions have the effect described in
10218099Spst.BR @g@troff (@MAN1EXT@).
10379550SruIn addition,
10418099Spst.B @g@nroff
10579550Srusilently ignores the options
10618099Spst.BR \-e ,
10779550Sru.BR \-q ,
10879550Sruand
10979550Sru.BR \-s
11079550Sru(which are not implemented in
11179550Sru.BR @g@troff ).
11255844SasmodaiOptions 
11375590Sru.B \-p
11475590Sru(pic),
11575590Sru.B \-t
11675590Sru(tbl),
11755844Sasmodai.B \-S
11879550Sru(safer), and
11955844Sasmodai.B \-U
12069631Sru(unsafe) are passed to
12169631Sru.BR groff . 
12275590Sru.B \-v
12375590Srushows the version number.
12475590Sru.SH ENVIRONMENT
12575590Sru.TP
12675590Sru.SM
12775590Sru.B GROFF_BIN_PATH
12875590SruA colon separated list of directories in which to search for the
12975590Sru.B groff
13076025Sruexecutable before searching in PATH.  If unset, `@BINDIR@' is used.
13169631Sru.SH NOTES
13269631SruThis shell script is basically intended for use with
13369631Sru.BR man (1),
13469631Sruso warnings are suppressed.
13575590Srunroff-style character definitions (in the file tty-char.tmac) are also
13669631Sruloaded to emulate unrepresentable glyphs.
13718099Spst.SH "SEE ALSO"
13818099Spst.BR groff (@MAN1EXT@),
13918099Spst.BR @g@troff (@MAN1EXT@),
14018099Spst.BR grotty (@MAN1EXT@)
14179550Sru.
14279550Sru.\" Local Variables:
14379550Sru.\" mode: nroff
14479550Sru.\" End:
145