Test::Pod throws a whole lot of non-errors which I presume are from Pod::Simple. They fall into three categories.
* reporting that =item lists are out of order. One set of failures is because it doesn't recognize that item lists can start with 0. More generally the problem is not all numbered item lists are supposed to be ordered lists! perlpodspec says that if all your =item's are numbered then it must be an ordered list starting with 1, possibly to make deciding if you should output <OL> or <UL> easier. That's too limiting and should be removed from the spec. The POD formatter should be smart enough to decide if it has an ordered list or not. * reporting that you can't have anything between an =over and an =item. I'm not entirely sure this should be disallowed. I can't find where in perlpodspec it is disallowed. =over 4 content =item should probably be treated as equivalent to either: content =over 4 =item or as =over 4 content =back =over 4 =item The latter seems most in keeping with the rest of the spec. I can't see any reason why leading indented paragraphs and item lists can't be mixed. * trouble with "C<< >> and C<< >> >>" This is in lib/Pod/t/basic.pod and apparently someone thought it to be valid. Pod::Simple doesn't like it. I guess Pod::Parser does. I have no opinion on it, just thought you should know. /usr/local/src/perl-current $ find . -name '*.pm' | xargs perl -wle 'use Test::Pod 'no_plan'; pod_file_ok($_) foreach @ARGV' | grep -v '^ok' not ok 315 - POD test for ./lib/Net/Config.pm # Failed test (-e at line 1) # ./lib/Net/Config.pm (215): You have '=item 0' instead of the expected '=item 1' # ./lib/Net/Config.pm (219): You have '=item 1' instead of the expected '=item 2' # ./lib/Net/Config.pm (224): You have '=item 2' instead of the expected '=item 3' # ./lib/Net/Config.pm (231): You have '=item 3' instead of the expected '=item 4' # ./lib/Net/Config.pm (239): You have '=item 4' instead of the expected '=item 5' # ./lib/Net/Config.pm (247): You have '=item 5' instead of the expected '=item 6' # ./lib/Net/Config.pm (252): You have '=item 6' instead of the expected '=item 7' # ./lib/Net/Config.pm (259): You have '=item 7' instead of the expected '=item 8' not ok 348 - POD test for ./lib/Pod/InputObjects.pm # Failed test (-e at line 1) # ./lib/Pod/InputObjects.pm (41): You can't have =items (as at line 54) unless the first thing after the =over is an =item not ok 393 - POD test for ./lib/Term/Cap.pm # Failed test (-e at line 1) # ./lib/Term/Cap.pm (64): You can't have =items (as at line 114) unless the first thing after the =over is an =item not ok 406 - POD test for ./lib/Text/ParseWords.pm # Failed test (-e at line 1) # ./lib/Text/ParseWords.pm (217): You have '=item 0' instead of the expected '=item 1' # ./lib/Text/ParseWords.pm (221): You have '=item 1' instead of the expected '=item 2' # ./lib/Text/ParseWords.pm (225): You have '=item 2' instead of the expected '=item 3' # ./lib/Text/ParseWords.pm (229): You have '=item 3' instead of the expected '=item 4' # ./lib/Text/ParseWords.pm (233): You have '=item 4' instead of the expected '=item 5' # ./lib/Text/ParseWords.pm (237): You have '=item 5' instead of the expected '=item 6' 1..470 # Looks like you failed 4 tests of 470. /usr/local/src/perl-current $ find . -name '*.pod' | xargs perl -wle 'use Test::Pod 'no_plan'; pod_file_ok($_) foreach @ARGV' | grep -v '^ok' # Failed test (-e at line 1) not ok 18 - POD test for ./lib/Pod/t/basic.pod # ./lib/Pod/t/basic.pod (316): Unterminated C<< ... >> sequence # Failed test (-e at line 1) # ./lib/Pod/t/htmlview.pod (45): You can't have =items (as at line 49) unless the first thing after the =over is an =item not ok 20 - POD test for ./lib/Pod/t/htmlview.pod not ok 32 - POD test for ./pod/perl573delta.pod # Failed test (-e at line 1) # ./pod/perl573delta.pod (28): You have '=item 11362' instead of the expected '=item 1' # ./pod/perl573delta.pod (32): You have '=item 11371' instead of the expected '=item 2' # ./pod/perl573delta.pod (36): You have '=item 11375' instead of the expected '=item 3' # ./pod/perl573delta.pod (40): You have '=item 11405' instead of the expected '=item 4' # ./pod/perl573delta.pod (44): You have '=item 11410' instead of the expected '=item 5' # ./pod/perl573delta.pod (48): You have '=item 11423' instead of the expected '=item 6' # ./pod/perl573delta.pod (52): You have '=item 11459' instead of the expected '=item 7' # ./pod/perl573delta.pod (57): You have '=item 11475' instead of the expected '=item 8' # ./pod/perl573delta.pod (61): You have '=item 11485' instead of the expected '=item 9' # ./pod/perl573delta.pod (65): You have '=item 11490' instead of the expected '=item 10' # ./pod/perl573delta.pod (69): You have '=item 11516' instead of the expected '=item 11' # ./pod/perl573delta.pod (74): You have '=item 11541' instead of the expected '=item 12' # ./pod/perl573delta.pod (78): You have '=item 11549' instead of the expected '=item 13' # ./pod/perl573delta.pod (82): You have '=item 11589' instead of the expected '=item 14' # ./pod/perl573delta.pod (86): You have '=item 11594' instead of the expected '=item 15' # ./pod/perl573delta.pod (91): You have '=item 11623' instead of the expected '=item 16' # ./pod/perl573delta.pod (96): You have '=item 111631' instead of the expected '=item 17' # ./pod/perl573delta.pod (100): You have '=item 11643' instead of the expected '=item 18' # ./pod/perl573delta.pod (104): You have '=item 11656' instead of the expected '=item 19' # ./pod/perl573delta.pod (110): You have '=item 11725' instead of the expected '=item 20' # ./pod/perl573delta.pod (114): You have '=item 11743' instead of the expected '=item 21' # ./pod/perl573delta.pod (118): You have '=item 11794' instead of the expected '=item 22' # ./pod/perl573delta.pod (122): You have '=item 11825' instead of the expected '=item 23' # ./pod/perl573delta.pod (126): You have '=item 11865' instead of the expected '=item 24' # ./pod/perl573delta.pod (130): You have '=item 11874' instead of the expected '=item 25' # ./pod/perl573delta.pod (134): You have '=item 11877' instead of the expected '=item 26' # ./pod/perl573delta.pod (138): You have '=item 11993' instead of the expected '=item 27' # ./pod/perl573delta.pod (142): You have '=item 12056' instead of the expected '=item 28' # ./pod/perl573delta.pod (146): You have '=item 12180' instead of the expected '=item 29' # ./pod/perl573delta.pod (150): You have '=item 12243' instead of the expected '=item 30' # ./pod/perl573delta.pod (154): You have '=item 12288' instead of the expected '=item 31' # ./pod/perl573delta.pod (158): You have '=item 12542' instead of the expected '=item 32' # ./pod/perl573delta.pod (162): You have '=item 12652' instead of the expected '=item 33' # ./pod/perl573delta.pod (166): You have '=item 12756' instead of the expected '=item 34' # ./pod/perl573delta.pod (170): You have '=item 12874' instead of the expected '=item 35' # ./pod/perl573delta.pod (174): You have '=item 13162' instead of the expected '=item 36' # ./pod/perl573delta.pod (178): You have '=item 13179' instead of the expected '=item 37' # ./pod/perl573delta.pod (182): You have '=item 13326' instead of the expected '=item 38' # ./pod/perl573delta.pod (186): You have '=item 13358' instead of the expected '=item 39' # ./pod/perl573delta.pod (190): You have '=item 13452' instead of the expected '=item 40' # ./pod/perl573delta.pod (194): You have '=item 13575' instead of the expected '=item 41' # ./pod/perl573delta.pod (198): You have '=item 13684' instead of the expected '=item 42' # ./pod/perl573delta.pod (202): You have '=item 14694' instead of the expected '=item 43' # ./pod/perl573delta.pod (206): You have '=item 14832' instead of the expected '=item 44' # ./pod/perl573delta.pod (210): You have '=item 14854' instead of the expected '=item 45' not ok 46 - POD test for ./pod/perldebguts.pod # Failed test (-e at line 1) # ./pod/perldebguts.pod (304): You have '=item 4' instead of the expected '=item 3' # ./pod/perldebguts.pod (322): You have '=item 6' instead of the expected '=item 4' # ./pod/perldebguts.pod (346): You have '=item 14' instead of the expected '=item 5' # ./pod/perldebguts.pod (367): You have '=item 30' instead of the expected '=item 6' not ok 99 - POD test for ./pod/perlretut.pod # Failed test (-e at line 1) # ./pod/perlretut.pod (616): You have '=item 0' instead of the expected '=item 1' # ./pod/perlretut.pod (620): You have '=item 1' instead of the expected '=item 2' # ./pod/perlretut.pod (624): You have '=item 2' instead of the expected '=item 3' # ./pod/perlretut.pod (628): You have '=item 3' instead of the expected '=item 4' # ./pod/perlretut.pod (634): You have '=item 4' instead of the expected '=item 5' # ./pod/perlretut.pod (639): You have '=item 5' instead of the expected '=item 6' # ./pod/perlretut.pod (644): You have '=item 6' instead of the expected '=item 7' # ./pod/perlretut.pod (648): You have '=item 7' instead of the expected '=item 8' # ./pod/perlretut.pod (654): You have '=item 8' instead of the expected '=item 9' # ./pod/perlretut.pod (659): You have '=item 9' instead of the expected '=item 10' # ./pod/perlretut.pod (1086): You have '=item 0' instead of the expected '=item 1' # ./pod/perlretut.pod (1090): You have '=item 1' instead of the expected '=item 2' # ./pod/perlretut.pod (1095): You have '=item 2' instead of the expected '=item 3' # ./pod/perlretut.pod (1100): You have '=item 3' instead of the expected '=item 4' # ./pod/perlretut.pod (1105): You have '=item 4' instead of the expected '=item 5' # ./pod/perlretut.pod (1109): You have '=item 5' instead of the expected '=item 6' # ./pod/perlretut.pod (1114): You have '=item 6' instead of the expected '=item 7' -- Michael G Schwern [EMAIL PROTECTED] http://www.pobox.com/~schwern/ Shrtr is btr. -- Abhijit Menon-Sen in <[EMAIL PROTECTED]>
