warning: these questions are completely off list topic, but
i bet they're still interesting to lots of you.

does anybody know if nice fancey pod2html replacements
exist? specifically, i want a tool that generates framesets
with package and class indexes like javadoc does.

also, what's the opinion on extending pod? my method
documentation currently looks like this:

  =head2 METHODS

  =over

  =item new()

  Construct and return an instance.

  =item setFooBar($value)

  Sets the value of the FooBar.

  B<Parameters:>

  =over

  =item $value

  the value to set

  =back

  B<Throws:>

  =over

  =item B<Exception::Class::Base>

  if something goes wrong

  =back

  =back

wouldn't it be nicer to have a set of compact constructs for
code documentation? maybe like so:

  =constructor new()

  Construct and return an instance.

  =method setFooBar($value)

  Sets the value of the FooBar.

  =param $value

  the value to set

  =exception B<Exception::Class::Base>

  if something goes wrong

would enable the fancy javadoc-like tool to easily generate
constructor and method summary and detail lists and to
format all that stuff in attractive and easy to read ways,
rather than having big sets of lists that are semantically
meaningless.

i bet somebody's gonna say "hey, use xml instead!" but then
i lose all the pod support built into tools like makemaker.

Reply via email to