Geoffrey Young wrote:

It's because all the docs live in the modperl-docs rep. modperl-2.0 gets modperl-docs/src/docs/2.0 extracted into modperl-2.0/docs. testing.pod lives in modperl-docs/src/docs/general/testing/testing.pod as it's not 2.0-specific.


yes, but Apache::Test is distributed with 2.0 so whatever docs are appropriate ought to be as well.

Apache::Test includes all the API docs (well, not all, but it should at some point) in its .pm files. testing.pod is a tutorial, not an API documentation.
Apache::Test/README includes a pointer to the testing doc online.


I'm not even sure we should carry the whole modperl-docs/src/docs/2.0 in the mp2 distro. Perhaps just modperl-docs/src/docs/2.0/api is what we need. I've already committed the code that glues the API docs back to their .pm files.

I think they all should be there - software isn't much good without the docs :)

sure, they can stay there, but I doubt that they are very useful there, just bloating the size of the distro. Would you read the long tutorials with perldoc? I doubt so. They are much more useful when formatted in html and pdf.


__________________________________________________________________
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]



Reply via email to