Вышла новая версия DBIx::Class::Schema::Loader с множеством изменений. Одно из этих изменений – генерация POD-документации для автоматически созданных классов. Пользователи PostgreSQL получат ещё одну вкусняшку – все комментарии к их таблицам и столбцам автоматически переедут в документацию. Не буду показывать на автора этого патча пальцем, так как это неприлично.
И второе. Test::Pod::Coverage::Permissive. Принцип работы такой же, как и у Test::Pod::Coverage, только тесты валятся лишь в том случае, если появилась ещё одна незадокументированная фунция.
Т.е. при первом запуске у вас тесты пройдут в любом случае. Задокументируете функцию — тесты пройдут. Напишете ещё одну незадокументированную функцию — обвалятся.
Это очень удобно, когда есть незадокументированный проект, который хочется дальше вести с документацией.
К чему это я — пользуйтесь и пишите баги.
Многострочные комментарии в perl
Синтаксисом языка они не предусмотрены.
Но можно воспользоваться Plain Old Documentation. Всякими
=pod, =comment, =rwerwerwe пользоваться не стоит, потому что ваши комменты вылезут в POD-документации.
Правильный вариант многострочных комментов выглядит так:
=for comment Some comment =cut