To generate a test catalog HTML dir, run
$ rm -rf test_catalog $ perl util/catalog_tests.pl t/ test_catalog # regenerates the pods $ rm -rf test_catalog_html $ mkdir test_catalog_html $ perl -MPod::Simple::HTMLBatch -e 'Pod::Simple::HTMLBatch::go' test_catalog/ test_catalog_html/
and now you have test_catalog_html/
Note that only backlinked synopses are generated.
= TODO
== important
* rewrite to emit HTML - by converting pods with Pod::Simple::HTMLBatch, or otherwise - and by emiting HTML directly for tests - perhaps with an output more similar to Devel::Cover * put backlinks: - for links with no regex right after the heading, in a comma separated list so they don't take too much space - for links with a regex, as a superscripted number with a <a name="file">, at the *end* of the regex match *
== unimportant
* cause news:msg@id.com to link to google groups or wherever * correlate test results to their files
== long term
* determine if the regexes could be coerced into a more concrete link (low priority)
= BUGS
* cannot link to something like =item "Pointy subs" * synopsis pod is not parsed, but regexed * stuff is planted in a naughty way (substr) * too slurpy * there is no well defined object for test meta data. It should look like: - Pugs::TestFile - lines - test cases - type - todo - description - plan - links
=item "Pointy subs"
1 POD Error
The following errors were encountered while parsing the POD:
Unknown directive: =kwid
To install Perl6::Pugs, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Perl6::Pugs
CPAN shell
perl -MCPAN -e shell install Perl6::Pugs
For more information on module installation, please visit the detailed CPAN module installation guide.