> > Yes, it's a bit like doxygen that way. The problem being that POD has no > defined way to write: "This method is a class method and takes the > following parameters, and returns the following value in scalar context". > We can define a psuedo way of doing it, but it will either be > non-validating, or ugly. >
For validating we have to write a tool anyway. As far as I know there is nothing out that would be able to parse the Perl code and create the docs out of it, like doxygen does for C, but I think this should be doable, since Perl itself does the most things already. Also I didn't tried, I don't think that it must become ugly. > > I think that's a bit of a falacy of XML. Sure, if you use a huge number of > tags, but you just don't if you want source readability. In the end it's > no worse than POD (nested lists anyone?) > ok, maybe, I only can tell from my experiences of proof reading XML files (DocBook, which has of course more than a few tags) > > Does anybody know what the current discussion about pod in the Perl > > community is ? Are there any intentions the extent it, for example to > > display tables ? > > I doubt it. It's just not doable in a POD-like way, except by using > "=begin cals_table" or something similar! (SDL has an attempt, but IMHO > it's more ugly than using markup). > I like the way that PerlPoint (a presentation programm that create presentations out of a pod like syntax) does it. It usese the | to separates columes, so you end you with something like =over =item col1 | col2 | col3 =item a | b | c =back This seems quite readable to me (of course you cannot do everything with this syntax, but it's easy to write) Gerald ------------------------------------------------------------- Gerald Richter ecos electronic communication services gmbh Internetconnect * Webserver/-design/-datenbanken * Consulting Post: Tulpenstrasse 5 D-55276 Dienheim b. Mainz E-Mail: [EMAIL PROTECTED] Voice: +49 6133 925131 WWW: http://www.ecos.de Fax: +49 6133 925152 -------------------------------------------------------------
