Hey, gang
I was wondering whether we want to have a base for converting mod_perl
core pods into other formats (ps,pdf,html,xml?), just like we have for the
guide.
http://perl.apache.org/~sbekman/doc.tgz is a drop-in replacement for ./pod
directory in mod_perl-2.0 cvs tree.
Assuming that you have Pod::HtmlPsPdf installed, just run ./doc/bin/build
-df and you will get the linked html documentation in ./doc/rel_html/, the
ps and the pdf versions in ./doc/rel_ps/mod_perl_2.0.ps,
./doc/rel_ps/mod_perl_2.0.pdf respectively. If you use -s tag you can get
the split version (like we have for the guide now), which makes the search
of the documentation much more user friendly.
The total overhead of extra files is about 20k gzipped (because of
hyphen.tex mainly (17k), which I should install with Pod::HtmlPsPdf)
As for Pod::HtmlPsPdf, it should undergo a major rewrite to use the
streaming tools from podlators package, which will make it much more
flexible and allow us to incorporate new pod syntax which is getting
cooked up at pod-people@perl.org (see the archives from
http://archive.develooper.com/pod-people@perl.org/ for more info).
If you have some free time on your hands you are welcome to step in and
help me with the rewrite.
_____________________________________________________________________
Stas Bekman JAm_pH -- Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide http://perl.apache.org/guide
mailto:stas@stason.org http://apachetoday.com http://eXtropia.com/
http://singlesheaven.com http://perl.apache.org http://perlmonth.com/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@perl.apache.org
For additional commands, e-mail: dev-help@perl.apache.org
|