nroff.man revision 114410
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 114410 2003-05-01 13:18:29Z 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
3769631Sru.OP \-m name
3869631Sru.OP \-n num
3969631Sru.OP \-o list
4069631Sru.OP \-r cn
4169631Sru.OP \-T name
42104868Sru.RI "[\ " "file" "\ .\|.\|.\ ]"
4369631Sru.br
4469631Sru.ad \na
4518099Spst.SH DESCRIPTION
4618099SpstThe
4718099Spst.B @g@nroff
4818099Spstscript emulates the
4918099Spst.B nroff
5018099Spstcommand using groff.
5179550SruOnly 
5269631Sru.BR ascii ,
5369631Sru.BR latin1 ,
5469631Sru.BR koi8-r ,
5569631Sru.BR utf8 ,
5679550Sruand
5769631Sru.B cp1047
5879550Sruare valid arguments for the
5979550Sru.B -T
60114410Sruoption, selecting the output encoding emitted by
61114410Sru.BR grotty ,
62114410Srugroff's TTY output device.
6379550SruIf an invalid or no
6479550Sru.BR \-T
6579550Sruoption is given,
6679550Sru.B @g@nroff
6779550Sruchecks the current locale to select a default output device.
6879550SruIt first tries the
6979550Sru.B locale
7079550Sruprogram, then the environment variables
7179550Sru.BR LC_ALL ,
7279550Sru.BR LC_CTYPE ,
7379550Sruand
7479550Sru.BR LANG ,
7579550Sruand finally the
7679550Sru.B LESSCHARSET
7779550Sruenvironment variable.
7879550Sru.PP
7918099SpstThe
8018099Spst.B \-h
81104868Sruand
82104868Sru.B \-c
83104868Sruoptions
84104868Sruare equivalent to
8579550Sru.BR grotty 's
86104868Sruoptions
8718099Spst.B \-h
88104868Sru(using tabs in the output) and
89104868Sru.B \-c
90104868Sru(using the old output scheme instead of SGR escape sequences).
9118099SpstThe
92104868Sru.BR \-C ,
9318099Spst.BR \-i ,
94114410Sru.BR \-m ,
9518099Spst.BR \-n ,
96104868Sru.BR \-o ,
9769631Sruand
9851622Sphantom.B \-r
9918099Spstoptions have the effect described in
10018099Spst.BR @g@troff (@MAN1EXT@).
10179550SruIn addition,
10218099Spst.B @g@nroff
10379550Srusilently ignores the options
10418099Spst.BR \-e ,
10579550Sru.BR \-q ,
10679550Sruand
10779550Sru.BR \-s
10879550Sru(which are not implemented in
10979550Sru.BR @g@troff ).
11055844SasmodaiOptions 
11175590Sru.B \-p
11275590Sru(pic),
11375590Sru.B \-t
11475590Sru(tbl),
11555844Sasmodai.B \-S
11679550Sru(safer), and
11755844Sasmodai.B \-U
11869631Sru(unsafe) are passed to
11969631Sru.BR groff . 
12075590Sru.B \-v
12175590Srushows the version number.
12275590Sru.SH ENVIRONMENT
12375590Sru.TP
12475590Sru.SM
12575590Sru.B GROFF_BIN_PATH
12675590SruA colon separated list of directories in which to search for the
12775590Sru.B groff
12876025Sruexecutable before searching in PATH.  If unset, `@BINDIR@' is used.
12969631Sru.SH NOTES
13069631SruThis shell script is basically intended for use with
13169631Sru.BR man (1),
13269631Sruso warnings are suppressed.
13375590Srunroff-style character definitions (in the file tty-char.tmac) are also
13469631Sruloaded to emulate unrepresentable glyphs.
13518099Spst.SH "SEE ALSO"
13618099Spst.BR groff (@MAN1EXT@),
13718099Spst.BR @g@troff (@MAN1EXT@),
13818099Spst.BR grotty (@MAN1EXT@)
13979550Sru.
14079550Sru.\" Local Variables:
14179550Sru.\" mode: nroff
14279550Sru.\" End:
143