Stas Bekman wrote:
[moving this discussion to the mod_perl docs list so others can contribute. Also CC'ing Lyle and Jack who has offered help with this project and probably have already gave up, trying to figure out where they could help. Hopefully this Gerald's code will provide the missing fuel]
I'm still here. But I'm a little bit confused. I'd like to work on Apache::RequestRec, but I'm not sure of the status of that document. Will there be additional changes from an import, or is that it (and I should get started).
Most likely, yes, there will be changes. As you have seen big chunks of information are already available from Apache docs. We just need to adjust them to the perl API.
At least you can see from the previously attached file what data we get from the import and whether it's good enough to be useful.
I have started to work on XSBuilder again. The first thing I have done is to
create a module called ModPerl::PODTemplate, which contains a set of methods
which allows to easily change the format of the generated POD. I attach you
the new version, along with two files I have generated. I didn't have made
any changes in the format so far. I would like to get your feedback, on how
the output should look like, them I can implement it imediately (or of
course you can change mpbuilder/lib/ModPerl/PODTemple.pm on your own and
play with it)
[snip feedback]
Finally, are you sure that we want to maintain this intermediary format. It's going to be a big pain. I suggest to drop the idea and go with the plain pod. We have very little human resources to work on docs, so the less we have to maintain the better.
Where is the intermediary format defined?
what you saw attached is the intermediary format, the final pod won't have any @param-like tags. Gerald wanted it for other docs processing tools.
It's documented in the file src/docs/2.0/api/AUTOGENERATION, which you can see from your local checkout or online:
http://cvs.apache.org/viewcvs.cgi/modperl-docs/src/docs/2.0/api/AUTOGENERATION
__________________________________________________________________ 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]
