> I have already started using something like the following: > http://perl.apache.org/release/docs/2.0/api/mod_perl-2.0/APR/Table.html > as I said I'm not happy with it, just trying. > > So as you say we are talking about two different templates: > > 1. for the autogenerated docs, which keeps as much info as possible, if > the info that we will not use (e.g. some C side effects, like 'const > char *' vs 'char *') > > 2. the template for the final pod. >
(2) is the final layout, which *I* don't care much about for now. I thinking about something between 1 and 2. (1) is what is generated automaticly, then we take this and do manualy editing it, so it contains the final content. This final content should be independend of the final layout, so we would get 1,2,3 1.) autogenerated 2.) editied 3.) layout -> pod,html,pdf etc. (autogenerated from 2) 2 should be something that is still editable by hand (so I perfer not use XML here too), but also can be easly parsed (maybe transformed to XML and then from there via XSLT to the other output formats) > > Though we should discuss the (2), again see the URL above for some ideas. > > actually we have only 2 types of arguments: > > param > return > Yes, but for my (2) I also would like to see something like func:, note:, since: etc. > so it shouldn't be a problem. I also had 'remark' in the APR::Table doc, > but this can probably go into the body of the description of the method. > For the final layout it can, for the editited version (my 2) it may not. 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 ------------------------------------------------------------- --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
