Greetings, In running `make install` with the perl@18376 kit recently I could not help but notice this complaint from installman:
/home/pprymmer/perl_inst/man/man1/perlfaq.1 pod/perlfaq.pod:1369: Unmatched =back The fix for that specific problem could be as simple as this: --- pod/perlfaq.pod.orig Fri Jan 3 10:09:26 2003 +++ pod/perlfaq.pod Fri Jan 3 10:43:39 2003 @@ -1366,4 +1366,4 @@ for any particular purpose whatsoever. The authors accept no liability in respect of this information or its use. -=back +=cut End of mini patch. Upon running: podchecker5.9.0 -warnings -warnings pod/perlfaq.pod I also came up with a more extensive patch that fixes these complaints: *** WARNING: 2 unescaped <> in paragraph at line 456 in file pod/perlfaq.pod *** WARNING: 2 unescaped <> in paragraph at line 673 in file pod/perlfaq.pod *** WARNING: 1 unescaped <> in paragraph at line 681 in file pod/perlfaq.pod *** WARNING: 1 unescaped <> in paragraph at line 693 in file pod/perlfaq.pod *** WARNING: 2 unescaped <> in paragraph at line 952 in file pod/perlfaq.pod But I note (with some despair) that I'd really have to modify the other perlfaq*.pod docs for which perlfaq.pod serves merely as a TOC. I haven't found the time to carry that task out but I'll post the more extensive patch to perlfaq.pod here just in case someone else would like to take the issue up: --- pod/perlfaq.pod.orig Fri Jan 3 10:09:26 2003 +++ pod/perlfaq.pod Fri Jan 3 10:20:38 2003 @@ -453,7 +453,7 @@ =item * -Why don't my <<HERE documents work? +Why don't my E<lt>E<lt>HERE documents work? =item * @@ -670,7 +670,7 @@ =item * -Why do I sometimes get an "Argument list too long" when I use <*>? +Why do I sometimes get an "Argument list too long" when I use E<lt>*E<gt>? =item * @@ -678,7 +678,7 @@ =item * -How can I open a file with a leading ">" or trailing blanks? +How can I open a file with a leading "E<gt>" or trailing blanks? =item * @@ -690,7 +690,7 @@ =item * -Why can't I just open(FH, ">file.lock")? +Why can't I just C<open(FH, "E<gt>file.lock")>? =item * @@ -949,7 +949,7 @@ =item * -Why doesn't "my($foo) = <FILE>;" work right? +Why doesn't C<my($foo) = E<lt>FILEE<gt>;> work right? =item * @@ -1366,4 +1366,4 @@ for any particular purpose whatsoever. The authors accept no liability in respect of this information or its use. -=back +=cut End of larger patch. I hope that helps. Peter Prymmer
