I've put the PODS online. (Thanks Andrew, Paul, and crew for writing them). I'm currently building them out of cvs (updated nightly) every morning (~0430 EDT). A couple of them have some issues (bad POD). If you want to go take a look, they're at: http://www.kohalabs.com/resources/pod/ -pate
On Tue, Oct 08, 2002 at 07:27:17PM -0400, Pat Eyler wrote:
I've put the PODS online. (Thanks Andrew, Paul, and crew for writing them).
Cool beans! One issue, though: that page only appears to list the PODs in the C4 directory, not in its subdirectories (C4/Circulation/*, C4/Interface/*). I'd also like to encourage people to read these PODs, in case I misunderstood something. In particular, there might be some bugs that got documented as features.
I'm currently building them out of cvs (updated nightly) every morning (~0430 EDT). A couple of them have some issues (bad POD).
Do you have a list, so that I can (try to) fix them? I believe the most common cause for bad PODs is trailing whitespace. -- Andrew Arensburger This message *does* represent the arensb@ooblick.com views of ooblick.com "A witty saying proves nothing." -- Voltaire
On Wed, 9 Oct 2002, Andrew Arensburger wrote:
On Tue, Oct 08, 2002 at 07:27:17PM -0400, Pat Eyler wrote:
I've put the PODS online. (Thanks Andrew, Paul, and crew for writing them).
Cool beans! One issue, though: that page only appears to list the PODs in the C4 directory, not in its subdirectories (C4/Circulation/*, C4/Interface/*).
True, I'll fix that in the script.
I'd also like to encourage people to read these PODs, in case I misunderstood something. In particular, there might be some bugs that got documented as features.
This was one of the reasons I wanted to get these online. The more visibility we have of them, the more quickly we should be able to detct and fix problems.
I'm currently building them out of cvs (updated nightly) every morning (~0430 EDT). A couple of them have some issues (bad POD).
Do you have a list, so that I can (try to) fix them?
I'lll ship you the output from the script ... I don't want to try to parse it at this point.
I believe the most common cause for bad PODs is trailing whitespace.
-- Andrew Arensburger This message *does* represent the arensb@ooblick.com views of ooblick.com "A witty saying proves nothing." -- Voltaire
Here are the errors generated by building PODs. Note that I'm building from the main line, if you fix things in the rel_1_2 branch, please port your changes to the main line as well. If you see mistakes, POD errors, or ommissions, please don't hesitate to jump in and fix things. If you're not sure, ask in irc or here on the list. (If you ask on irc, it would be nice to drop a summary here for everyone to read) thanks, -pate /usr/bin/pod2html: Accounts.pm: unterminated list at =head in paragraph 33. ignoring. /usr/bin/pod2html: Accounts.pm: cannot resolve L<DBI(3)|DBI> in paragraph 34. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Accounts2.pm: unterminated list at =head in paragraph 52. ignoring. /usr/bin/pod2html: Accounts2.pm: cannot resolve L<DBI(3)|DBI> in paragraph 53. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Acquisitions.pm: cannot resolve L<perl> in paragraph 302. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Auth.pm: unterminated list at =head in paragraph 52. ignoring. /usr/bin/pod2html: Auth.pm: cannot resolve L<CGI(3)|CGI> in paragraph 53. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for Biblio.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: BookShelves.pm: cannot resolve L<perl> in paragraph 72. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Catalogue.pm: cannot resolve L<perl> in paragraph 212. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for Circmain.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: no title for Circulation.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: Context.pm: unterminated list at =head in paragraph 115. ignoring. /usr/bin/pod2html: Context.pm: cannot resolve L<DBI(3)|DBI> in paragraph 121. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for Database.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: Database.pm: unexpected =item directive in paragraph 11. ignoring. /usr/bin/pod2html: Database.pm: unterminated list at =head in paragraph 19. ignoring. /usr/bin/pod2html: Database.pm: cannot resolve L<DBI(3)|DBI> in paragraph 20. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Format.pm: cannot resolve L<perl> in paragraph 48. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for Groups.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: Input.pm: cannot resolve L<perl> in paragraph 36. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for InterfaceCDK.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: Maintainance.pm: cannot resolve L<perl> in paragraph 52. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Output.pm: unterminated list at =head in paragraph 215. ignoring. /usr/bin/pod2html: Output.pm: cannot resolve L<DBI(3)|DBI> in paragraph 216. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: Print.pm: cannot resolve L<perl> in paragraph 34. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for Reserves.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: no title for Reserves2.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: Search.pm: unterminated list at =head in paragraph 95. ignoring. /usr/bin/pod2html: Search.pm: unexpected =item directive in paragraph 144. ignoring. /usr/bin/pod2html: Search.pm: unterminated list at =head in paragraph 354. ignoring. /usr/bin/pod2html: Search.pm: cannot resolve L<perl> in paragraph 357. at /usr/share/perl/5.6.1/Pod/Html.pm line 1562. /usr/bin/pod2html: no title for Security.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: SimpleMarc.pm: unterminated list at =head in paragraph 88. ignoring. /usr/bin/pod2html: Stats.pm: unterminated list at =head in paragraph 33. ignoring. /usr/bin/pod2html: no title for Stock.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402. /usr/bin/pod2html: no title for Z3950.pm at /usr/share/perl/5.6.1/Pod/Html.pm line 402.
On Wed, Oct 09, 2002 at 11:03:31AM -0400, Pat Eyler wrote:
Here are the errors generated by building PODs.
I believe I've fixed all of these. Some PODs are empty 'cos I haven't gotten around to them yet. The one in C4/Biblio.pm is badly broken and needs to be rewritten from scratch. -- Andrew Arensburger This message *does* represent the arensb@ooblick.com views of ooblick.com Kill the extremists!
On Fri, 11 Oct 2002, Andrew Arensburger wrote:
On Wed, Oct 09, 2002 at 11:03:31AM -0400, Pat Eyler wrote:
Here are the errors generated by building PODs.
I believe I've fixed all of these. Some PODs are empty 'cos I haven't gotten around to them yet. The one in C4/Biblio.pm is badly broken and needs to be rewritten from scratch.
Great! As of this morning, there were still a number of errors. Is this worth posting to the list as a reminder to everyone? -pate
-- Andrew Arensburger This message *does* represent the arensb@ooblick.com views of ooblick.com Kill the extremists!
participants (2)
-
Andrew Arensburger -
Pat Eyler