At 12:04 12.06.2002, Gerald Richter - ecos gmbh wrote:
That's only a rought idea, maybe somebodyelse has another idea how to handle
this?
Might not be the best idea, but what I was thinking about was making it template-like, having the auto-fetches things inserted in the manual edited POD. Like.
[% ap_table_add %] <---- inserts POD with function synopsis etc.
Manually added notes go here......
The problem is that new functions won't be picked up automatically, except if we have some special mark at the EOF where new functions can be inserted. However, I think that new functions will need to be handled manually anyway, as they need to have some order/classification that automatic generation can't do.
As I've explained in my reply to Gerald, I doubt it'll be possible to automatically modify docs which were manually adjusted, because we want to be able to adjust parts that were autogenerated.
> And of course we need to discuss the template, but this can be done > later when and if we start deploying ExtUtils::XSBuilder.
I think he meant the data structure...
No, I meant the template for the Apache::Foo manpage. Template in a sense of how the manpage should be constructed to keep docs consistent and intuitive. Check the existing manpages to see what I mean.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
