Two possible patches to pod/perlfaq.pod in perl@18376

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