{
    "content": [
        {
            "type": "text",
            "text": "# soelim(1) (man)\n\n**Summary:** soelim - interpret .so requests in groff input\n\n**Synopsis:** soelim [-Crtv] [-I dir] [file ...]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -C | — | — |  |\n| -I | — | — | the command line and those named in .so requests). The search path is initialized with the current directory. This optio |\n| -r | — | — |  |\n| -t | — | — | file and line number. |\n| -v | — | — |  |\n\n## See Also\n\n- groff(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (13 lines)\n- **OPTIONS** (2 lines) — 5 subsections\n  - -C (1 lines)\n  - -I (8 lines)\n  - -r (1 lines)\n  - -t (2 lines)\n  - -v (1 lines)\n- **USAGE** (28 lines)\n- **SEE ALSO** (5 lines)\n\n## Full Content\n\n### NAME\n\nsoelim - interpret .so requests in groff input\n\n### SYNOPSIS\n\nsoelim [-Crtv] [-I dir] [file ...]\n\n### DESCRIPTION\n\nsoelim reads files and replaces lines of the form\n\n.so file\n\nby  the  contents  of file.  It is useful if files included with .so need to be preprocessed.\nNormally, soelim should be invoked with the -s option of groff.\n\nTo embed ‘\\’ in the file name, write ‘\\\\’ or ‘\\e’.  To embed a space, write ‘\\ ’.  Any  other\nescape sequence in file makes soelim ignore the whole line.\n\nNote  that there must be no whitespace between the leading dot and the two characters ‘s’ and\n‘o’.  Otherwise, only groff interprets the .so request (and soelim ignores it).\n\n### OPTIONS\n\nWhitespace is permitted between a command-line option and its argument.\n\n#### -C\n\n#### -I\n\nthe  command  line  and  those named in .so requests).  The search path is initialized\nwith the current directory.  This option may be specified more than once; the directo‐\nries  are then searched in the order specified (but before the current directory).  If\nyou want to make the current directory be read before other directories,  add  -I.  at\nthe appropriate place.\n\nNo directory search is performed for files with an absolute file name.\n\n#### -r\n\n#### -t\n\nfile and line number.\n\n#### -v\n\n### USAGE\n\nThe normal processing sequence of groff is this:\n\ninput        sourced\nfile          file\n|             |\nv             v\npreprocessor -> troff -> postprocessor\n|\nv\noutput\nfile\n\nThat is, files sourced with .so are normally read only by troff (the actual formatter).  soe‐‐\nlim is not required for troff to source files.\n\nIf a file to be sourced should also be preprocessed, it must already be read before the input\nfile passes through the preprocessor.  This is handled by soelim:\n\ninput\nfile\n|\nv\nsoelim -> preprocessor -> troff -> postprocessor\n^                                     |\n|                                     v\nsourced                               output\nfile                                  file\n\n### SEE ALSO\n\ngroff(1)\n\n\n\ngroff 1.22.4                                23 March 2022                                  SOELIM(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "soelim",
        "section": "1",
        "mode": "man",
        "summary": "soelim - interpret .so requests in groff input",
        "synopsis": "soelim [-Crtv] [-I dir] [file ...]",
        "flags": [
            {
                "flag": "-C",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "-I",
                "long": null,
                "arg": null,
                "description": "the command line and those named in .so requests). The search path is initialized with the current directory. This option may be specified more than once; the directo‐ ries are then searched in the order specified (but before the current directory). If you want to make the current directory be read before other directories, add -I. at the appropriate place. No directory search is performed for files with an absolute file name."
            },
            {
                "flag": "-r",
                "long": null,
                "arg": null,
                "description": ""
            },
            {
                "flag": "-t",
                "long": null,
                "arg": null,
                "description": "file and line number."
            },
            {
                "flag": "-v",
                "long": null,
                "arg": null,
                "description": ""
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "groff",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/groff/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 13,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 2,
                "subsections": [
                    {
                        "name": "-C",
                        "lines": 1,
                        "flag": "-C"
                    },
                    {
                        "name": "-I",
                        "lines": 8,
                        "flag": "-I"
                    },
                    {
                        "name": "-r",
                        "lines": 1,
                        "flag": "-r"
                    },
                    {
                        "name": "-t",
                        "lines": 2,
                        "flag": "-t"
                    },
                    {
                        "name": "-v",
                        "lines": 1,
                        "flag": "-v"
                    }
                ]
            },
            {
                "name": "USAGE",
                "lines": 28,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ]
    }
}