Re: automagically create browsable POD pages [pod2html]

2004-04-02 Thread Eric Lease Morgan
On Apr 1, 2004, at 10:33 AM, 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? Thank you for the prompt replies, but the

Re: automagically create browsable POD pages [pod2html]

2004-04-02 Thread Eric Lease Morgan
On Apr 2, 2004, at 6:55 AM, Eric Lease Morgan wrote: Thank you for the prompt replies, but the suggestions are overkill. I simply want to: 1. create a doc directory 2. loop through my lib directory looking for pods 3. convert each pod to xhtml 4. save converted files to the pod

Re: automagically create browsable POD pages [pod2html]

2004-04-02 Thread Michael McDonnell
Eric Lease Morgan wrote: BTW, pod2html looks like it will already do this, but I can't figure out how to make it: 1. create a single xhtml file for each pod 2. give each file a specific name Yeah, I can't do this pod by pod, but I'm lazy. I'm still not understanding what the problem is.

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

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