automagically create browsable POD pages

2004-04-01 Thread Eric Lease Morgan
Is there some sort of incantation I can send to a Perl-generated Makefile in order to automagically create browsable POD pages? Here at MyLibrary Central we have been re-writing MyLibrary. We are using the following technique: 1. Write POD. 2. Write tests. 3. Write module. 4. Go to

Re: automagically create browsable POD pages

2004-04-01 Thread Michael McDonnell
Eric Lease Morgan wrote: Is there some sort of make command I can run that will read the PODs in my distribution, turn them into (X)HTML files, and save them in a specified local directory of my distribution's filesystem? Do you mean like the pod2html command or something different? --

Re: automagically create browsable POD pages

2004-04-01 Thread Bill Moseley
On Thu, Apr 01, 2004 at 10:33:00AM -0500, Eric Lease Morgan wrote: Is there some sort of incantation I can send to a Perl-generated Makefile in order to automagically create browsable POD pages? Might look at DocSet on CPAN. perl.apache.org is generated with it from pod files. -- Bill

Re: automagically create browsable POD pages

2004-04-01 Thread Andy Lester
What's the ultimate goal? Do you want these pages served up by Apache? If so, look at my Apache::Pod::HTML which I created just for this very purpose. We have all our docs (coding stanards and so on) done in POD, but browsable via Apache using it. (http://search.cpan.org/dist/Apache-Pod/)

Re: automagically create browsable POD pages

2004-04-01 Thread Bill Moseley
On Thu, Apr 01, 2004 at 05:10:23PM -0600, Andy Lester wrote: Might look at DocSet on CPAN. perl.apache.org is generated with it from pod files. All the perl.org sites (like qa.perl.org which I currently maintain) are done with Template Toolkit, and much of qa.perl.org is Pod that changes