NROFF(1) General Commands Manual NROFF(1)
NAME
nroff - use groff to format documents for TTY devices
SYNOPSIS
nroff [-CchipStUv] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn] [-Tname] [-Wwarning]
[-wwarning] [file ...]
nroff --help
nroff -v
nroff --version
DESCRIPTION
nroff formats documents written in the roff(7) language for typewriter-like devices such
as terminal emulators.
GNU nroff emulates the traditional Unix nroff command using groff(1). nroff generates
output via grotty(1), groff's TTY output device, which needs to know the character encod-
ing scheme used by the terminal. Consequently, acceptable arguments to the -T option are
ascii, latin1, utf8, and cp1047; any others are ignored. If neither the GROFF_TYPESETTER
environment variable nor the -T command-line option (which overrides the environment vari-
able) specifies a (valid) device, nroff consults the locale to select an appropriate out-
put device. It first tries the locale(1) program, then checks several locale-related en-
vironment variables; see "ENVIRONMENT", below. If all of the foregoing fail, -Tascii is
implied.
Whitespace is not permitted between an option and its argument. 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, -r, -w, and -W
options have the effect described in troff(1). In addition, nroff ignores -e, -q, and -s
(which are not implemented in troff). The options -p (pic), -t (tbl), -S (safer), and -U
(unsafe) are passed to groff. -v and --version show version information, while --help
displays a usage message; all exit afterward.
ENVIRONMENT
GROFF_TYPESETTER
specifies the default output device for groff.
GROFF_BIN_PATH
is a colon-separated list of directories in which to search for the groff exe-
cutable before searching in PATH. If unset, /usr/bin is used.
LC_ALL
LC_CTYPE
LANG
LESSCHARSET
are pattern-matched in this order for standard character encodings supported by
groff in the event no -T option is given and GROFF_TYPESETTER is unset.
NOTES
Character definitions in the file /usr/share/groff/1.22.4/tmac/tty-char.tmac are loaded to
replace unrepresentable glyphs.
SEE ALSO
groff(1), troff(1), grotty(1), locale(1), roff(7)
groff 1.22.4 23 March 2022 NROFF(1)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-11-21 16:57 @216.73.216.57 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)