develooper Front page | perl.perl5.porters | Postings from February 2001

[PATCH] doc fixes

From:
Michael Stevens
Date:
February 27, 2001 09:54
Subject:
[PATCH] doc fixes
Message ID:
20010227175437.A20180@firedrake.org
I posted these previously - should apply to bleadperl, and fix some
of schwern's podchecker nits. I don't *think* I mangled the meaning of
the vms stuff.

Michael

diff -urN perl-current.dist/ext/Encode/Encode.pm perl-current/ext/Encode/Encode.pm
--- perl-current.dist/ext/Encode/Encode.pm	Fri Feb 23 15:27:29 2001
+++ perl-current/ext/Encode/Encode.pm	Fri Feb 23 15:38:28 2001
@@ -38,7 +38,7 @@
 
 =head2 TERMINOLOGY
 
-=over
+=over 4
 
 =item *
 
@@ -129,6 +129,8 @@
 If the UTF-8 in STRING is malformed?  See L</"Handling Malformed Data">.
 
 [INTERNAL] The UTF-8 flag of STRING is not checked.
+
+=back
 
 =back
 
diff -urN perl-current.dist/lib/Exporter/Heavy.pm perl-current/lib/Exporter/Heavy.pm
--- perl-current.dist/lib/Exporter/Heavy.pm	Fri Feb 23 15:27:35 2001
+++ perl-current/lib/Exporter/Heavy.pm	Fri Feb 23 15:39:16 2001
@@ -21,6 +21,7 @@
 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 -urN perl-current.dist/lib/File/Spec/Epoc.pm perl-current/lib/File/Spec/Epoc.pm
--- perl-current.dist/lib/File/Spec/Epoc.pm	Fri Feb 23 15:27:35 2001
+++ perl-current/lib/File/Spec/Epoc.pm	Fri Feb 23 15:39:52 2001
@@ -24,7 +24,7 @@
 o.flebbe@gmx.de
 
 
-=over
+=over 4
 
 =item devnull
 
@@ -62,6 +62,7 @@
 there is no search path supported, it returns undef, sorry.
 
 =cut
+
 sub path {
     return undef;
 }
diff -urN perl-current.dist/lib/Test/Harness.pm perl-current/lib/Test/Harness.pm
--- perl-current.dist/lib/Test/Harness.pm	Fri Feb 23 15:27:36 2001
+++ perl-current/lib/Test/Harness.pm	Fri Feb 23 15:40:33 2001
@@ -765,6 +765,7 @@
   not ok 2
   # got 'Bush' expected 'Gore'
 
+=back
 
 =head1 EXPORT
 
diff -urN perl-current.dist/lib/utf8.pm perl-current/lib/utf8.pm
--- perl-current.dist/lib/utf8.pm	Fri Feb 23 15:27:40 2001
+++ perl-current/lib/utf8.pm	Fri Feb 23 15:41:49 2001
@@ -57,7 +57,7 @@
 
 Enabling the C<utf8> pragma has the following effects:
 
-=over
+=over 4
 
 =item *
 
@@ -78,6 +78,8 @@
 	use utf8;			# force char semantics
 	@chars = split //, $data;	# splits characters
     }
+
+=back
 
 =head1 SEE ALSO
 
diff -urN perl-current.dist/vms/ext/DCLsym/DCLsym.pm perl-current/vms/ext/DCLsym/DCLsym.pm
--- perl-current.dist/vms/ext/DCLsym/DCLsym.pm	Fri Feb 23 15:27:52 2001
+++ perl-current/vms/ext/DCLsym/DCLsym.pm	Fri Feb 23 15:29:12 2001
@@ -201,7 +201,7 @@
 cases, this allows you finer control than using a tied hash aggregate.  The
 following methods are supported:
 
-=over
+=over 4
 
 =item new
 
@@ -253,6 +253,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
 
diff -urN perl-current.dist/vms/ext/Stdio/Stdio.pm perl-current/vms/ext/Stdio/Stdio.pm
--- perl-current.dist/vms/ext/Stdio/Stdio.pm	Fri Feb 23 15:27:52 2001
+++ perl-current/vms/ext/Stdio/Stdio.pm	Fri Feb 23 15:35:07 2001
@@ -146,7 +146,7 @@
 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 @@
 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 @@
 
 =back
 
-=back
-
 =item vmssysopen
 
 This function bears the same relationship to the CORE function
@@ -633,6 +629,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
 
diff -urN perl-current.dist/x2p/a2p.pod perl-current/x2p/a2p.pod
--- perl-current.dist/x2p/a2p.pod	Fri Feb 23 15:27:54 2001
+++ perl-current/x2p/a2p.pod	Fri Feb 23 15:37:07 2001
@@ -47,12 +47,12 @@
 
 =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
@@ -61,6 +61,8 @@
 
 old awk considers I<extra_args> to be arguments to C<sprintf>; new awk
 considers them arguments to C<print>.
+
+=back
 
 =back
 



nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About