{
    "mode": "man",
    "parameter": "nroff",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/nroff/1/json",
    "generated": "2026-06-03T01:23:31Z",
    "synopsis": "nroff [-CchipStUv] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn] [-Tname] [-Wwarning]\n[-wwarning] [file ...]",
    "sections": {
        "NAME": {
            "content": "nroff - use groff to format documents for TTY devices\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "nroff [-CchipStUv] [-dcs] [-Mdir] [-mname] [-nnum] [-olist] [-rcn] [-Tname] [-Wwarning]\n[-wwarning] [file ...]\n",
            "subsections": [
                {
                    "name": "nroff --help",
                    "content": ""
                },
                {
                    "name": "nroff -v",
                    "content": ""
                },
                {
                    "name": "nroff --version",
                    "content": ""
                }
            ]
        },
        "DESCRIPTION": {
            "content": "nroff formats documents written in the roff(7) language for typewriter-like devices  such  as\nterminal emulators.\n\nGNU nroff emulates the traditional Unix nroff command using groff(1).  nroff generates output\nvia grotty(1), groff's TTY output device, which needs to know the character  encoding  scheme\nused by the terminal.  Consequently, acceptable arguments to the -T option are ascii, latin1,\nutf8, and cp1047; any others are ignored.  If neither the GROFFTYPESETTER environment  vari‐\nable  nor  the  -T command-line option (which overrides the environment variable) specifies a\n(valid) device, nroff consults the locale to select an appropriate output device.   It  first\ntries  the  locale(1)  program, then checks several locale-related environment variables; see\n“ENVIRONMENT”, below.  If all of the foregoing fail, -Tascii is implied.\n\nWhitespace is not permitted between an option and its argument.  The -h and  -c  options  are\nequivalent  to  grotty's  options  -h (using tabs in the output) and -c (using the old output\nscheme instead of SGR escape sequences).  The -d, -C, -i, -M, -m, -n, -o, -r, -w, and -W  op‐\ntions  have  the  effect  described  in  troff(1).  In addition, nroff ignores -e, -q, and -s\n(which are not implemented in troff).  The options -p (pic), -t (tbl),  -S  (safer),  and  -U\n(unsafe)  are  passed to groff.  -v and --version show version information, while --help dis‐\nplays a usage message; all exit afterward.\n",
            "subsections": []
        },
        "ENVIRONMENT": {
            "content": "GROFFTYPESETTER\nspecifies the default output device for groff.\n\nGROFFBINPATH\nis a colon-separated list of directories in which to search for the  groff  executable\nbefore searching in PATH.  If unset, /usr/bin is used.\n\nLCALL\nLCCTYPE\nLANG\nLESSCHARSET\nare  pattern-matched in this order for standard character encodings supported by groff\nin the event no -T option is given and GROFFTYPESETTER is unset.\n",
            "subsections": []
        },
        "NOTES": {
            "content": "Character definitions in the file /usr/share/groff/1.22.4/tmac/tty-char.tmac  are  loaded  to\nreplace unrepresentable glyphs.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "groff(1), troff(1), grotty(1), locale(1), roff(7)\n\n\n\ngroff 1.22.4                                23 March 2022                                   NROFF(1)",
            "subsections": []
        }
    },
    "summary": "nroff - use groff to format documents for TTY devices",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "groff",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/groff/1/json"
        },
        {
            "name": "troff",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/troff/1/json"
        },
        {
            "name": "grotty",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/grotty/1/json"
        },
        {
            "name": "locale",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/locale/1/json"
        },
        {
            "name": "roff",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/roff/7/json"
        }
    ]
}