{
    "content": [
        {
            "type": "text",
            "text": "# nroff (man)\n\n## DESCRIPTION\n\nnroff  formats documents written in the \u001b]8;;man:groff(7)\u001b\\groff(7)\u001b]8;;\u001b\\ language for typewriter-like devices such as\nterminal emulators.  GNU nroff emulates the AT&T nroff command using \u001b]8;;man:groff(1)\u001b\\groff(1)\u001b]8;;\u001b\\.  nroff  gener‐\nates  output via \u001b]8;;man:grotty(1)\u001b\\grotty(1)\u001b]8;;\u001b\\, groff's terminal output driver, which needs to know the character\nencoding scheme used by the device.  Consequently, acceptable arguments to the -T option  are\nascii, latin1, utf8, and cp1047; any others are ignored.  If neither the GROFFTYPESETTER en‐\nvironment  variable nor the -T command-line option (which overrides the environment variable)\nspecifies a (valid) device, nroff consults the locale to select an appropriate output device.\nIt first tries the \u001b]8;;man:locale(1)\u001b\\locale(1)\u001b]8;;\u001b\\ program, then checks several  locale-related  environment  vari‐\nables; see section “Environment” below.  If all of the foregoing fail, -Tascii is implied.\n\n## Sections\n\n- **Name**\n- **Synopsis** (3 subsections)\n- **Description** (2 subsections)\n- **Exit status**\n- **Environment**\n- **Files**\n- **Notes**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "nroff",
        "section": "",
        "mode": "man",
        "summary": null,
        "synopsis": null,
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-t",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "-V",
                "long": null,
                "arg": null,
                "description": "the standard output stream, but does not execute it. -v and --version show version informa‐ tion about nroff and the programs it runs, while --help displays a usage message; all exit afterward."
            }
        ],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "Name",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "Synopsis",
                "lines": 5,
                "subsections": [
                    {
                        "name": "nroff --help",
                        "lines": 1
                    },
                    {
                        "name": "nroff -v",
                        "lines": 1
                    },
                    {
                        "name": "nroff --version",
                        "lines": 1
                    }
                ]
            },
            {
                "name": "Description",
                "lines": 13,
                "subsections": [
                    {
                        "name": "-e -q -s  -k -K -p -P -R -t",
                        "lines": 1,
                        "flag": "-t"
                    },
                    {
                        "name": "-S  -V",
                        "lines": 4,
                        "flag": "-V"
                    }
                ]
            },
            {
                "name": "Exit status",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "Environment",
                "lines": 18,
                "subsections": []
            },
            {
                "name": "Files",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "Notes",
                "lines": 7,
                "subsections": []
            }
        ],
        "sections": {
            "Name": {
                "content": "nroff - format documents with groff for TTY (terminal) devices\n",
                "subsections": []
            },
            "Synopsis": {
                "content": "nroff [-bcCEhikpRStUVz] [-d ctext] [-d string=text] [-K fallback-encoding] [-m macro-package]\n[-M macro-directory] [-n page-number] [-o page-list] [-P postprocessor-argument]\n[-r cnumeric-expression] [-r register=numeric-expression] [-T output-device]\n[-w warning-category] [-W warning-category] [file ...]\n",
                "subsections": [
                    {
                        "name": "nroff --help",
                        "content": ""
                    },
                    {
                        "name": "nroff -v",
                        "content": ""
                    },
                    {
                        "name": "nroff --version",
                        "content": ""
                    }
                ]
            },
            "Description": {
                "content": "nroff  formats documents written in the \u001b]8;;man:groff(7)\u001b\\groff(7)\u001b]8;;\u001b\\ language for typewriter-like devices such as\nterminal emulators.  GNU nroff emulates the AT&T nroff command using \u001b]8;;man:groff(1)\u001b\\groff(1)\u001b]8;;\u001b\\.  nroff  gener‐\nates  output via \u001b]8;;man:grotty(1)\u001b\\grotty(1)\u001b]8;;\u001b\\, groff's terminal output driver, which needs to know the character\nencoding scheme used by the device.  Consequently, acceptable arguments to the -T option  are\nascii, latin1, utf8, and cp1047; any others are ignored.  If neither the GROFFTYPESETTER en‐\nvironment  variable nor the -T command-line option (which overrides the environment variable)\nspecifies a (valid) device, nroff consults the locale to select an appropriate output device.\nIt first tries the \u001b]8;;man:locale(1)\u001b\\locale(1)\u001b]8;;\u001b\\ program, then checks several  locale-related  environment  vari‐\nables; see section “Environment” below.  If all of the foregoing fail, -Tascii is implied.\n\nThe  -b,  -c, -C, -d, -E, -i, -m, -M, -n, -o, -r, -U, -w, -W, and -z options have the effects\ndescribed in \u001b]8;;man:troff(1)\u001b\\troff(1)\u001b]8;;\u001b\\.  -c and -h imply “-P-c” and “-P-h”, respectively; -c  is  also  inter‐\npreted  directly  by  troff.  In addition, this implementation ignores the AT&T nroff options",
                "subsections": [
                    {
                        "name": "-e -q -s  -k -K -p -P -R -t",
                        "content": "",
                        "flag": "-t"
                    },
                    {
                        "name": "-S  -V",
                        "content": "the  standard output stream, but does not execute it.  -v and --version show version informa‐\ntion about nroff and the programs it runs, while --help displays a usage  message;  all  exit\nafterward.\n",
                        "flag": "-V"
                    }
                ]
            },
            "Exit status": {
                "content": "nroff  exits  with error status 2 if there was a problem parsing its arguments, with status 0\nif any of the options -V, -v, --version, or --help were specified, and  with  the  status  of\ngroff otherwise.\n",
                "subsections": []
            },
            "Environment": {
                "content": "Normally, the path separator in environment variables ending with PATH is the colon; this may\nvary depending on the operating system.  For example, Windows uses a semicolon instead.\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\nGROFFTYPESETTER\nspecifies the default output device for groff.\n\nLCALL\nLCCTYPE\nLANG\nLESSCHARSET\nare pattern-matched in this order for contents matching standard  character  encodings\nsupported  by  groff in the event no -T option is given and GROFFTYPESETTER is unset,\nor the values specified are invalid.\n",
                "subsections": []
            },
            "Files": {
                "content": "/usr/share/groff/1.23.0/tmac/tty-char.tmac\ndefines fallback definitions of  roff  special  characters.   These  definitions  more\npoorly  optically approximate typeset output than those of tty.tmac in favor of commu‐\nnicating semantic information.  nroff loads it automatically.\n",
                "subsections": []
            },
            "Notes": {
                "content": "Pager programs like \u001b]8;;man:more(1)\u001b\\more(1)\u001b]8;;\u001b\\ and \u001b]8;;man:less(1)\u001b\\less(1)\u001b]8;;\u001b\\ may require command-line options to correctly  handle\nsome output sequences; see \u001b]8;;man:grotty(1)\u001b\\grotty(1)\u001b]8;;\u001b\\.\n\nSee also\n\u001b]8;;man:groff(1)\u001b\\groff(1)\u001b]8;;\u001b\\, \u001b]8;;man:troff(1)\u001b\\troff(1)\u001b]8;;\u001b\\, \u001b]8;;man:grotty(1)\u001b\\grotty(1)\u001b]8;;\u001b\\, \u001b]8;;man:locale(1)\u001b\\locale(1)\u001b]8;;\u001b\\, \u001b]8;;man:roff(7)\u001b\\roff(7)\u001b]8;;\u001b\\\n\ngroff 1.23.0                                31 March 2024                                   nroff(1)",
                "subsections": []
            }
        }
    }
}