# NROFF(1) - man - phpman

[NROFF(1)](https://www.chedong.com/phpMan.php/man/NROFF/1/markdown)                               General Commands Manual                              [NROFF(1)](https://www.chedong.com/phpMan.php/man/NROFF/1/markdown)



## NAME
       nroff - use groff to format documents for TTY devices

## SYNOPSIS
       **nroff** [**-CchipStUv**] [**-d**_cs_] [**-M**_dir_] [**-m**_name_] [**-n**_num_] [**-o**_list_] [**-r**_cn_] [**-T**_name_] [**-W**_warning_]
             [**-w**_warning_] [_file_ ...]

### nroff --help

### nroff -v
### nroff --version

## DESCRIPTION
       _nroff_ formats documents written in the [_roff_(7)](https://www.chedong.com/phpMan.php/man/roff/7/markdown) language for typewriter-like devices  such  as
       terminal emulators.

       GNU _nroff_ emulates the traditional Unix _nroff_ command using [_groff_(1)](https://www.chedong.com/phpMan.php/man/groff/1/markdown).  _nroff_ generates output
       via [_grotty_(1)](https://www.chedong.com/phpMan.php/man/grotty/1/markdown), _groff_'s TTY output device, which needs to know the character  encoding  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  vari‐
       able  nor  the  **-T** command-line option (which overrides the environment variable) specifies a
       (valid) device, _nroff_ consults the locale to select an appropriate output device.   It  first
       tries  the  [_locale_(1)](https://www.chedong.com/phpMan.php/man/locale/1/markdown)  program, then checks several locale-related environment 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**  op‐
       tions  have  the  effect  described  in  [_troff_(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown).  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** dis‐
       plays 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_  executable
              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)](https://www.chedong.com/phpMan.php/man/groff/1/markdown), [_troff_(1)](https://www.chedong.com/phpMan.php/man/troff/1/markdown), [_grotty_(1)](https://www.chedong.com/phpMan.php/man/grotty/1/markdown), [_locale_(1)](https://www.chedong.com/phpMan.php/man/locale/1/markdown), [_roff_(7)](https://www.chedong.com/phpMan.php/man/roff/7/markdown)



groff 1.22.4                                23 March 2022                                   [NROFF(1)](https://www.chedong.com/phpMan.php/man/NROFF/1/markdown)