podchecker

СОДЕРЖАНИЕ

• ИМЯ
• СИНТАКСИС
• ПАРАМЕТРЫ И АРГУМЕНТЫ
• ОПИСАНИЕ
• ЗНАЧЕНИЕ ВОЗВРАТА
• ОШИБКИ
• СМОТРИТЕ ТАКЖЕ
• АВТОРЫ

ИМЯ

podchecker - проверка синтаксиса файлов документации в формате POD

СИНТАКСИС

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

ПАРАМЕТРЫ И АРГУМЕНТЫ

-help

Выводит краткое сообщение справки и завершает работу.

-man

Выводит страницу руководства и завершает работу.

-warnings -nowarnings

Включает/отключает вывод предупреждений. Повторное использование -warnings увеличивает уровень предупреждений, т.е. выводится больше предупреждений. В настоящее время увеличение до уровня два приводит к маркированию неэкранированных символов "<,>".

file

Путь к файлу формата POD, который нужно проверить на синтаксические ошибки (по умолчанию стандартный ввод).

ОПИСАНИЕ

podchecker прочитает указанные входные файлы, ища синтаксические ошибки в документации POD, и выведет все найденные ошибки в STDERR. В конце он выведет сообщение об успешности, указав количество найденных ошибок.

Директории игнорируются, выводится соответствующее сообщение об ошибке.

podchecker вызывает функцию podchecker(), экспортируемую модулем Pod::Checker. Подробнее см. "podchecker()" в Pod::Checker.

ЗНАЧЕНИЕ ВОЗВРАТА

podchecker возвращает код выхода 0 (ноль), если все указанные файлы POD корректны.

ОШИБКИ

podchecker возвращает код выхода 1, если хотя бы один из заданных файлов POD содержит синтаксические ошибки.

Код выхода 2 указывает, что по крайней мере один из указанных файлов не содержит никаких команд POD.

Код 1 имеет приоритет над кодом 2. Если вы хотите получить однозначные результаты, вызовите podchecker только с одним аргументом.

СМОТРИТЕ ТАКЖЕ

Pod::Simple и Pod::Checker

АВТОРЫ

Пожалуйста, сообщайте об ошибках используя http://rt.cpan.org.

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

Основано на коде для Pod::Text::pod2text(1), написанном Tom Christiansen <tchrist@mox.perl.com>