Re: Errors in core PODs

Message-ID: <20010223154756.A7723@firedrake.org>

p4raw-id: //depot/perl@8965

9 files changed, 21 insertions, 12 deletions

diff --git a/ext/Encode/Encode.pm b/ext/Encode/Encode.pm
index 2d49865491..72d6cc0fcc 100644
--- a/ext/Encode/Encode.pm
+++ b/ext/Encode/Encode.pm
@@ -446,7 +446,7 @@ possible values it easily fits in perl's much larger "logical character".
 
 =head2 TERMINOLOGY
 
-=over
+=over 4
 
 =item *
 
diff --git a/lib/Exporter/Heavy.pm b/lib/Exporter/Heavy.pm
index 39bce2d85e..1305318678 100644
--- a/lib/Exporter/Heavy.pm
+++ b/lib/Exporter/Heavy.pm
@@ -21,6 +21,7 @@ Exporter::Heavy - Exporter guts
 No user-serviceable parts inside.
 
 =cut
+
 #
 # We go to a lot of trouble not to 'require Carp' at file scope,
 #  because Carp requires Exporter, and something has to give.
diff --git a/lib/File/Spec/Epoc.pm b/lib/File/Spec/Epoc.pm
index 65d5e1fcb5..23c99fbf51 100644
--- a/lib/File/Spec/Epoc.pm
+++ b/lib/File/Spec/Epoc.pm
@@ -24,7 +24,7 @@ This package is still work in progress ;-)
 o.flebbe@gmx.de
 
 
-=over
+=over 4
 
 =item devnull
 
@@ -62,6 +62,7 @@ Takes no argument, returns the environment variable PATH as an array. Since
 there is no search path supported, it returns undef, sorry.
 
 =cut
+
 sub path {
     return undef;
 }
diff --git a/lib/Test/Harness.pm b/lib/Test/Harness.pm
index c26db92ac4..55a84fe066 100644
--- a/lib/Test/Harness.pm
+++ b/lib/Test/Harness.pm
@@ -765,6 +765,7 @@ ignore them.
   not ok 2
   # got 'Bush' expected 'Gore'
 
+=back
 
 =head1 EXPORT
 
diff --git a/lib/utf8.pm b/lib/utf8.pm
index f06b893a59..f9055b5dd9 100644
--- a/lib/utf8.pm
+++ b/lib/utf8.pm
@@ -57,7 +57,7 @@ rather than UTF-8).
 
 Enabling the C<utf8> pragma has the following effects:
 
-=over
+=over 4
 
 =item *
 
@@ -79,6 +79,8 @@ of byte semantics.
 	@chars = split //, $data;	# splits characters
     }
 
+=back
+
 =head1 SEE ALSO
 
 L<perlunicode>, L<bytes>
diff --git a/makedef.pl b/makedef.pl
index 1065801807..dbea24afe3 100644
--- a/makedef.pl
+++ b/makedef.pl
@@ -466,6 +466,8 @@ unless ($define{'USE_ITHREADS'}) {
 		    Perl_sys_intern_dup
 		    Perl_ptr_table_fetch
 		    Perl_ptr_table_new
+		    Perl_ptr_table_clear
+		    Perl_ptr_table_free
 		    Perl_ptr_table_split
 		    Perl_ptr_table_store
 		    perl_clone
diff --git a/vms/ext/DCLsym/DCLsym.pm b/vms/ext/DCLsym/DCLsym.pm
index 99adb94522..9f88c91db2 100644
--- a/vms/ext/DCLsym/DCLsym.pm
+++ b/vms/ext/DCLsym/DCLsym.pm
@@ -201,7 +201,7 @@ can also call methods directly to manipulate individual symbols.  In some
 cases, this allows you finer control than using a tied hash aggregate.  The
 following methods are supported:
 
-=over
+=over 4
 
 =item new
 
@@ -254,6 +254,8 @@ This method is a stopgap until we can incorporate code into this extension to
 traverse the process' symbol table directly, so it may disappear in a future
 version of this package.
 
+=back
+
 =head1 AUTHOR
 
 Charles Bailey  bailey@newman.upenn.edu
diff --git a/vms/ext/Stdio/Stdio.pm b/vms/ext/Stdio/Stdio.pm
index 446b0785e1..e36a3ec15b 100644
--- a/vms/ext/Stdio/Stdio.pm
+++ b/vms/ext/Stdio/Stdio.pm
@@ -146,7 +146,7 @@ VMS::Stdio function.  This compatibility interface will be
 removed in a future release of this extension, so please
 update your code to use the new routines.
 
-=over
+=over 4
 
 =item binmode
 
@@ -240,9 +240,7 @@ as a normal Perl file handle only.  When the scalar containing
 a VMS::Stdio file handle is overwritten, C<undef>d, or goes
 out of scope, the associated file is closed automatically.
 
-=over 4
-
-=head2 File characteristic options
+File characteristic options:
 
 =over 2
 
@@ -605,8 +603,6 @@ I/O timeout value
 
 =back
 
-=back
-
 =item vmssysopen
 
 This function bears the same relationship to the CORE function
@@ -634,6 +630,8 @@ subprocess through a pipe opened for writing without closing the
 pipe.  It returns a true value if successful, and C<undef> if
 it encounters an error.
 
+=back
+
 =head1 REVISION
 
 This document was last revised on 13-Oct-1998, for Perl 5.004, 5.005, and
diff --git a/x2p/a2p.pod b/x2p/a2p.pod
index f6395a4625..0506e2d827 100644
--- a/x2p/a2p.pod
+++ b/x2p/a2p.pod
@@ -47,12 +47,12 @@ tells a2p to use old awk behavior.  The only current differences are:
 
 =over 5
 
-=item
+=item *
 
 Old awk always has a line loop, even if there are no line
 actions, whereas new awk does not.
 
-=item
+=item *
 
 In old awk, sprintf is extremely greedy about its arguments.
 For example, given the statement
@@ -64,6 +64,8 @@ considers them arguments to C<print>.
 
 =back
 
+=back
+
 =head2 "Considerations"
 
 A2p cannot do as good a job translating as a human would, but it