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