'br}

'br}

{\

NAME

podchecker - check the syntax of POD format documentation files

SYNOPSIS

podchecker [-help] [-man] [-(no)warnings] [file ...]

OPTIONS AND ARGUMENTS

\fB-help\fR 8

Print a brief help message and exit.

\fB-man\fR 8

Print the manual page and exit.

\fB-warnings\fR \fB-nowarnings\fR 8

Turn on/off printing of warnings. Repeating -warnings increases the warning level, i.e. more warnings are printed. Currently increasing to level two causes flagging of unescaped *(L"<,>*(R" characters.

\fIfile\fR 8

The pathname of a s-1PODs0 file to syntax-check (defaults to standard input).

DESCRIPTION

podchecker will read the given input files looking for s-1PODs0 syntax errors in the s-1PODs0 documentation and will print any errors it find to s-1STDERR.s0 At the end, it will print a status message indicating the number of errors found.

Directories are ignored, an appropriate warning message is printed.

podchecker invokes the f(BIpodchecker() function exported by Pod::Checker Please see *(L"podchecker()*(R" in Pod::Checker for more details.

RETURN VALUE

podchecker returns a 0 (zero) exit status if all specified s-1PODs0 files are ok.

ERRORS

podchecker returns the exit status 1 if at least one of the given s-1PODs0 files has syntax errors.

The status 2 indicates that at least one of the specified files does not contain any s-1PODs0 commands.

Status 1 overrides status 2. If you want unambiguous results, call podchecker with one single argument only.

SEE ALSO

Pod::Parser and Pod::Checker

AUTHORS

Please report bugs using <http://rt.cpan.org>.

Brad Appleton <bradapp@enteract.com>, Marek Rouchal <marekr@cpan.org>

Based on code for f(BIPod::Text::pod2text|(1) written by Tom Christiansen <tchrist@mox.perl.com>