sli wrote:
Tad offtopic, but is there anything like Python's doctest for Perl? What it does is scan source docstrings looking for test that looks like interactive interpreter sessions in the comments and converts them into unit tests (read: fucking awesome). This would let one test out the entire API quickly and easily.
Obviously a Perl one would be different since it doesn't use an interactive interpreter, but the idea is there.
You can run createdoc.pl from src/doc/
Code:
#!/usr/bin/env perl
# Documentation extractor. Extracts documentation from comments from .pm files and put them in HTML files.
But all it does is extract comments, so it's not exactly the one you're looking for (just the doc, not the test part).