nroff.man revision 114410
1.ig 2Copyright (C) 1989-2001, 2002 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 114410 2003-05-01 13:18:29Z 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 \-CchipStUv 37.OP \-m name 38.OP \-n num 39.OP \-o list 40.OP \-r cn 41.OP \-T name 42.RI "[\ " "file" "\ .\|.\|.\ ]" 43.br 44.ad \na 45.SH DESCRIPTION 46The 47.B @g@nroff 48script emulates the 49.B nroff 50command using groff. 51Only 52.BR ascii , 53.BR latin1 , 54.BR koi8-r , 55.BR utf8 , 56and 57.B cp1047 58are valid arguments for the 59.B -T 60option, selecting the output encoding emitted by 61.BR grotty , 62groff's TTY output device. 63If an invalid or no 64.BR \-T 65option is given, 66.B @g@nroff 67checks the current locale to select a default output device. 68It first tries the 69.B locale 70program, then the environment variables 71.BR LC_ALL , 72.BR LC_CTYPE , 73and 74.BR LANG , 75and finally the 76.B LESSCHARSET 77environment variable. 78.PP 79The 80.B \-h 81and 82.B \-c 83options 84are equivalent to 85.BR grotty 's 86options 87.B \-h 88(using tabs in the output) and 89.B \-c 90(using the old output scheme instead of SGR escape sequences). 91The 92.BR \-C , 93.BR \-i , 94.BR \-m , 95.BR \-n , 96.BR \-o , 97and 98.B \-r 99options have the effect described in 100.BR @g@troff (@MAN1EXT@). 101In addition, 102.B @g@nroff 103silently ignores the options 104.BR \-e , 105.BR \-q , 106and 107.BR \-s 108(which are not implemented in 109.BR @g@troff ). 110Options 111.B \-p 112(pic), 113.B \-t 114(tbl), 115.B \-S 116(safer), and 117.B \-U 118(unsafe) are passed to 119.BR groff . 120.B \-v 121shows the version number. 122.SH ENVIRONMENT 123.TP 124.SM 125.B GROFF_BIN_PATH 126A colon separated list of directories in which to search for the 127.B groff 128executable before searching in PATH. If unset, `@BINDIR@' is used. 129.SH NOTES 130This shell script is basically intended for use with 131.BR man (1), 132so warnings are suppressed. 133nroff-style character definitions (in the file tty-char.tmac) are also 134loaded to emulate unrepresentable glyphs. 135.SH "SEE ALSO" 136.BR groff (@MAN1EXT@), 137.BR @g@troff (@MAN1EXT@), 138.BR grotty (@MAN1EXT@) 139. 140.\" Local Variables: 141.\" mode: nroff 142.\" End: 143