Re: Autogenerated PODs :-)

> >
> > 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.

>
> 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....

Gerald

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.