{
    "content": [
        {
            "type": "text",
            "text": "# podchecker(1) (man)\n\n**Summary:** podchecker - check the syntax of POD format documentation files\n\n**Synopsis:** podchecker [-help] [-man] [-(no)warnings] [file ...]\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **OPTIONS AND ARGUMENTS** (1 lines) — 3 subsections\n  - -help (1 lines)\n  - -man (1 lines)\n  - -warnings -nowarnings (6 lines)\n- **DESCRIPTION** (9 lines)\n- **RETURN VALUE** (2 lines)\n- **ERRORS** (9 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHORS** (9 lines)\n\n## Full Content\n\n### NAME\n\npodchecker - check the syntax of POD format documentation files\n\n### SYNOPSIS\n\npodchecker [-help] [-man] [-(no)warnings] [file ...]\n\n### OPTIONS AND ARGUMENTS\n\n#### -help\n\n#### -man\n\n#### -warnings -nowarnings\n\nTurn on/off printing of warnings. Repeating -warnings increases the warning level,\ni.e. more warnings are printed. Currently increasing to level two causes flagging of\nunescaped \"<,>\" characters.\n\nfile    The pathname of a POD file to syntax-check (defaults to standard input).\n\n### DESCRIPTION\n\npodchecker will read the given input files looking for POD syntax errors in the POD\ndocumentation and will print any errors it find to STDERR. At the end, it will print a status\nmessage indicating the number of errors found.\n\nDirectories are ignored, an appropriate warning message is printed.\n\npodchecker invokes the podchecker() function exported by Pod::Checker Please see\n\"podchecker()\" in Pod::Checker for more details.\n\n### RETURN VALUE\n\npodchecker returns a 0 (zero) exit status if all specified POD files are ok.\n\n### ERRORS\n\npodchecker returns the exit status 1 if at least one of the given POD files has syntax\nerrors.\n\nThe status 2 indicates that at least one of the specified files does not contain any POD\ncommands.\n\nStatus 1 overrides status 2. If you want unambiguous results, call podchecker with one single\nargument only.\n\n### SEE ALSO\n\nPod::Simple and Pod::Checker\n\n### AUTHORS\n\nPlease report bugs using <http://rt.cpan.org>.\n\nBrad Appleton <bradapp@enteract.com>, Marek Rouchal <marekr@cpan.org>\n\nBased on code for Pod::Text::pod2text(1) written by Tom Christiansen <tchrist@mox.perl.com>\n\n\n\nperl v5.34.0                                 2025-07-25                                PODCHECKER(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "podchecker",
        "section": "1",
        "mode": "man",
        "summary": "podchecker - check the syntax of POD format documentation files",
        "synopsis": "podchecker [-help] [-man] [-(no)warnings] [file ...]",
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "OPTIONS AND ARGUMENTS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "-help",
                        "lines": 1
                    },
                    {
                        "name": "-man",
                        "lines": 1
                    },
                    {
                        "name": "-warnings -nowarnings",
                        "lines": 6
                    }
                ]
            },
            {
                "name": "DESCRIPTION",
                "lines": 9,
                "subsections": []
            },
            {
                "name": "RETURN VALUE",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "ERRORS",
                "lines": 9,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHORS",
                "lines": 9,
                "subsections": []
            }
        ]
    }
}