Gerald Richter wrote:
I would do this in the final conversion state, since we decided that
this
docs that are generated in stage 1 are only contain content, while the
layout is added in stage 2
Yes, but it'll require special logic for parsing the intermediate
formats. This is not needed when you render that format, because you
already have the right tokens.
That makes sense
OK, how about the following: let's generate the intermediate and final
formats at the same time. This will save us a lot of unnecessary coding
and errors.
I think for now we will generate just one version. The one with the markup,
so we get the modperl docs out ASAP. A later version can support different
formats.
In that case it should be without the special markup that you wanted
(@func, @parm, etc.) There are lots of manpages, so I'd rather have them
most closely to the final version that will go online before we start to
manually edit them. Which probably will happen to all of them.
should be relatively simple. If the function is going into Apache:: say:
since: apache 2.xx.xx
APR:: say
since: apr 1.xx
ModPerl:: say:
since: mod_perl 2.xx
You already have the versions for apache and apr, for mod_perl can just
use the current version. In any case we don't have mod_perl docs that we
reuse, so it'll require manual setting of the version.
Not sure if we get version from Apache and APR. We have to check this....
Should be able to. APR is a standalone project, and its versions are
unrelated to Apache's versions.
P.S. I am on holiday for the next 5 days, but Lyle has told me that he will
take some time to work on it.
Cool!
__________________________________________________________________
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]
