Well, the obvious script "that someone else might have written" is of
course pod2html. Maybe you should start by explaining why that isn't
adequate for your needs (I can think of a couple of reasons, but my
reasons are probably not the same as your reasons).
The simple answer is that it doesn't do what I want it to.
For example, suppose I have the directory listing shown below because
it's rather lengthy.
Further suppose I run the following command at the command prompt,
generate_html_from_embedded_pod_in_perl_source_files *.pm *.plx *.cgi
expecting it to generate a sub-directory (perhaps called
'documentation') with the following files:
- index.html
- CCC_LOCATIONS.html
- console.html
- SQL.html
- etc.
I want a separate html file for every perl source file. I want the
index.html to list and link to each html file and each html file to
extract all the POD embedded in each plx, pm, or cgi file. pod2html
doesn't do this.
If nothing does this, it's okay. With a little effort I can write a
clunky something that does a minimal job. Obviously, I'd rather use
something the has been written and tested by someone who knows what
they are doing better than I do.
Thanks, CC.
04/25/2012 03:41 PM 152,319 ACAD_PROGS.pm
04/25/2012 10:01 AM 19,985 CAS.csv
04/26/2012 02:09 PM 14,618 cas_courses.csv
04/30/2012 01:49 PM 31,020 cas_courses.sql
04/25/2012 01:04 PM 3,656 CCC_LOCATIONS.plx
04/25/2012 10:00 AM 17,685 COE.csv
05/07/2012 12:06 PM 1,761 console.cgi
05/07/2012 01:16 PM 14,195 courses.cgi
05/07/2012 01:17 PM 329 courses_20120507.csv
04/26/2012 03:09 PM 3,369 coursetest.sql
05/07/2012 01:42 PM 1,635 database_schedules.plx
04/25/2012 03:25 PM 342 database_schema.txt
04/26/2012 09:07 AM 25,491 fac.csv
04/30/2012 05:07 PM 5,174 faculty.cgi
04/30/2012 04:13 PM 70,568 faculty.sql
04/30/2012 04:04 PM 10,916 get_resource.cgi
05/07/2012 11:58 AM 3,234 HTML.pm
05/07/2012 12:07 PM 2,498 locations.cgi
04/25/2012 02:08 PM 3,554 locations.sql
05/04/2012 05:11 PM 660 print_csv.cgi
05/07/2012 12:05 PM 3,161 programs.cgi
04/25/2012 04:03 PM 198,723 programs.sql
05/04/2012 05:42 PM 1,532 question.plx
04/27/2012 11:12 AM 1,606 schedules.css
05/07/2012 12:08 PM 192,512 schedules.db
04/03/2012 09:55 AM 74,955 SER_FINAL_FAC.pm
05/01/2012 12:52 PM 3,069 SER_programs.plx
05/04/2012 10:25 AM 4,857 SER_programs.sql
05/07/2012 12:05 PM 4,245 SQL.pm
04/30/2012 10:49 AM 424 term.sql
05/07/2012 11:16 AM 2,345 terms.cgi
05/04/2012 10:36 AM 2,197 todo.plx