POD Documentation

["T.J. Mather" <tj...@tjmather.com>]

Hi,

I'm interested in developing a script to automatically generate POD 
documentation for XML::Xerces.  What I was thinking of doing is using 
doxygen to generate XML, then writing a stylesheet to transform the XML 
into POD.  We could put in a SAX handler to convert the C++ code snippets 
to Perl code.

Of course this would require that doxygen outputs in XML, and this is on 
the TODO list of doxygen:
http://www.stack.nl/~dimitri/doxygen/todo.html  (#30, 37)

Also, are there plans to put XML::Xerces on CPAN?  This would greatly 
increase the visibility of XML::Xerces to the Perl community.

-TJ


---------------------------------------------------------------------
To unsubscribe, e-mail: xerces-p-dev-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-p-dev-help@xml.apache.org

Re: POD Documentation

["Jason E. Stewart" <ja...@openinformatics.com>]

"T.J. Mather" <tj...@tjmather.com> writes:

> I'm interested in developing a script to automatically generate POD
> documentation for XML::Xerces.  What I was thinking of doing is
> using doxygen to generate XML, then writing a stylesheet to
> transform the XML into POD.  We could put in a SAX handler to
> convert the C++ code snippets to Perl code.
> 
> Of course this would require that doxygen outputs in XML, and this is on 
> the TODO list of doxygen:
> http://www.stack.nl/~dimitri/doxygen/todo.html  (#30, 37)

That would be excellent. doxygen *already* outputs XML, even though
the TODO list doesn't tell you. Writing a stylesheet for this has been
on *my* TODO list for a few months. I'd be thrilled if someone else
were to take this up.

> Also, are there plans to put XML::Xerces on CPAN?  This would greatly 
> increase the visibility of XML::Xerces to the Perl community.

I've requested the XML::Xerces namespace from the CPAN maintainers,
but I haven't heard anything back from them. I'll give Damian Conway a
ping and ask him to nudge the maintainers for me.

jas.

---------------------------------------------------------------------
To unsubscribe, e-mail: xerces-p-dev-unsubscribe@xml.apache.org
For additional commands, e-mail: xerces-p-dev-help@xml.apache.org