xref: /netbsd-src/external/gpl2/groff/dist/src/roff/nroff/nroff.man (revision 89a07cf815a29524268025a1139fac4c5190f765)
Copyright (C) 1989-2001, 2002, 2003, 2005 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English. .. .
@G@NROFF @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
.
NAME
@g@nroff - emulate nroff command with groff .
SYNOPSIS
.nr a \n(.j .nr i \n(.i @g@nroff .. . .OP -CchipStUv .OP -d cs .OP -M dir .OP -m name .OP -n num .OP -o list .OP -r cn .OP -T name "[ " "file" " .\|.\|. ]"

.

DESCRIPTION
The @g@nroff script emulates the nroff command using groff. Only ascii , latin1 , utf8 , and cp1047 are valid arguments for the -T option, selecting the output encoding emitted by grotty , groff's TTY output device. If an invalid or no -T option is given, @g@nroff checks the current locale to select a default output device. It first tries the locale program, then the environment variables LC_ALL , LC_CTYPE , and LANG , and finally the LESSCHARSET environment variable.

The -h and -c options are equivalent to grotty 's options -h (using tabs in the output) and -c (using the old output scheme instead of SGR escape sequences). The -d , -C , -i , -M , -m , -n , -o , and -r options have the effect described in @g@troff (@MAN1EXT@). In addition, @g@nroff silently ignores the options -e , -q , and -s (which are not implemented in @g@troff ). Options -p (pic), -t (tbl), -S (safer), and -U (unsafe) are passed to groff . -v shows the version number. .

ENVIRONMENT

GROFF_BIN_PATH A colon separated list of directories in which to search for the groff executable before searching in PATH. If unset, `@BINDIR@' is used.

NOTES
This shell script is basically intended for use with man (1), so warnings are suppressed. nroff-style character definitions (in the file tty-char.tmac) are also loaded to emulate unrepresentable glyphs. .
"SEE ALSO"
groff (@MAN1EXT@), @g@troff (@MAN1EXT@), grotty (@MAN1EXT@) . Local Variables:
mode: nroff
End: