{
    "content": [
        {
            "type": "text",
            "text": "# POD2USAGE (info)\n\n## NAME\n\npod2usage - print usage messages from embedded pod docs in files\n\n## SYNOPSIS\n\npod2usage   [-help] [-man] [-exitexitval] [-outputoutfile] [-verbose\nlevel] [-pathlist dirlist] [-formatter module] [-utf8] file\n\n## DESCRIPTION\n\npod2usage will read the given input file looking for pod documentation\nand will print the corresponding usage message.  If no input file is\nspecified then standard input is read.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **OPTIONS AND ARGUMENTS**\n- **DESCRIPTION**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "POD2USAGE",
        "section": "",
        "mode": "info",
        "summary": "pod2usage - print usage messages from embedded pod docs in files",
        "synopsis": "pod2usage   [-help] [-man] [-exitexitval] [-outputoutfile] [-verbose\nlevel] [-pathlist dirlist] [-formatter module] [-utf8] file",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "OPTIONS AND ARGUMENTS",
                "lines": 38,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 8,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "pod2usage - print usage messages from embedded pod docs in files\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "pod2usage   [-help] [-man] [-exitexitval] [-outputoutfile] [-verbose\nlevel] [-pathlist dirlist] [-formatter module] [-utf8] file\n",
                "subsections": []
            },
            "OPTIONS AND ARGUMENTS": {
                "content": "-help   Print a brief help message and exit.\n\n-man    Print this command's manual page and exit.\n\n-exit exitval\nThe exit status value to return.\n\n-output outfile\nThe output file to print to. If the special names \"-\" or \">&1\"\nor \">&STDOUT\" are used then standard output is used. If \">&2\"\nor \">&STDERR\" is used then standard error is used.\n\n-verbose level\nThe desired level of verbosity to use:\n\n1 : print SYNOPSIS only\n2 : print SYNOPSIS sections and any OPTIONS/ARGUMENTS sections\n3 : print the entire manpage (similar to running pod2text)\n\n-pathlist dirlist\nSpecifies one or more directories to search for the input file\nif it was not supplied with an absolute path. Each directory\npath in the given list should be separated by a ':' on Unix\n(';' on MSWin32 and DOS).\n\n-formatter module\nWhich text formatter to use. Default is Pod::Text, or for very\nold Perl versions Pod::PlainText. An alternative would be e.g.\nPod::Text::Termcap.\n\n-utf8   This option assumes that the formatter (see above) understands\nthe option \"utf8\". It turns on generation of utf8 output.\n\nfile    The pathname of a file containing pod documentation to be\noutput in usage message format. If omitted, standard input is\nread - but the output is then formatted with Pod::Text only -\nunless a specific formatter has been specified with -formatter.\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "pod2usage will read the given input file looking for pod documentation\nand will print the corresponding usage message.  If no input file is\nspecified then standard input is read.\n\npod2usage invokes the pod2usage() function in the Pod::Usage module.\nPlease see \"pod2usage()\" in Pod::Usage.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "Pod::Usage, pod2text, Pod::Text, Pod::Text::Termcap, perldoc\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "Please report bugs using <http://rt.cpan.org>.\n\nBrad Appleton <bradapp@enteract.com>\n\nBased on code for pod2text(1) written by Tom Christiansen\n<tchrist@mox.perl.com>\n\nperl v5.34.0                      2026-06-23                      POD2USAGE(1)",
                "subsections": []
            }
        }
    }
}