fix various podcheck nits

14 files changed, 52 insertions, 52 deletions

diff --git a/Porting/how_to_write_a_perldelta.pod b/Porting/how_to_write_a_perldelta.pod
index 5c2d88cf03..c9b5ea6bd2 100644
--- a/Porting/how_to_write_a_perldelta.pod
+++ b/Porting/how_to_write_a_perldelta.pod
@@ -1,4 +1,8 @@
-=head1 How to write a perldelta
+=head1 NAME
+
+how_to_write_a_perldelta - How to write a perldelta
+
+=head2 Description
 
 This is intended as a guide for how to write a perldelta. There has never
 been a formal specification - the working rule is "fake up a document that
diff --git a/Porting/release_schedule.pod b/Porting/release_schedule.pod
index 9249f18530..80704d97ef 100644
--- a/Porting/release_schedule.pod
+++ b/Porting/release_schedule.pod
@@ -1,5 +1,9 @@
 =encoding utf8
 
+=head1 NAME
+
+release_schedule - Perl 5 release schedule
+
 =head1 STABLE RELEASE SCHEDULE
 
 This schedule lists the projected or historical development and
diff --git a/dist/Filter-Simple/lib/Filter/Simple.pm b/dist/Filter-Simple/lib/Filter/Simple.pm
index 5de131fec2..d1da0b2dea 100644
--- a/dist/Filter-Simple/lib/Filter/Simple.pm
+++ b/dist/Filter-Simple/lib/Filter/Simple.pm
@@ -4,7 +4,7 @@ use Text::Balanced ':ALL';
 
 use vars qw{ $VERSION @EXPORT };
 
-$VERSION = '0.89';
+$VERSION = '0.90';
 
 use Filter::Util::Call;
 use Carp;
@@ -243,7 +243,6 @@ __END__
 
 Filter::Simple - Simplified source filtering
 
-
 =head1 SYNOPSIS
 
  # in MyFilter.pm:
diff --git a/dist/Math-BigInt/lib/Math/BigInt/CalcEmu.pm b/dist/Math-BigInt/lib/Math/BigInt/CalcEmu.pm
index c82e153986..6295d86259 100644
--- a/dist/Math-BigInt/lib/Math/BigInt/CalcEmu.pm
+++ b/dist/Math-BigInt/lib/Math/BigInt/CalcEmu.pm
@@ -5,7 +5,7 @@ use strict;
 # use warnings;	# dont use warnings for older Perls
 use vars qw/$VERSION/;
 
-$VERSION = '1.998';
+$VERSION = '1.999';
 
 package Math::BigInt;
 
@@ -305,11 +305,15 @@ using a call to the native lib.
 
 =head1 METHODS
 
-=head2 __emu_bxor
+=over
 
-=head2 __emu_band
+=item __emu_bxor
 
-=head2 __emu_bior
+=item __emu_band
+
+=item __emu_bior
+
+=back
 
 =head1 LICENSE
 
diff --git a/dist/Math-BigRat/lib/Math/BigRat.pm b/dist/Math-BigRat/lib/Math/BigRat.pm
index a70a42905a..757a03b8f3 100644
--- a/dist/Math-BigRat/lib/Math/BigRat.pm
+++ b/dist/Math-BigRat/lib/Math/BigRat.pm
@@ -24,7 +24,7 @@ use vars qw($VERSION @ISA $upgrade $downgrade
 
 @ISA = qw(Math::BigFloat);
 
-$VERSION = '0.2604';
+$VERSION = '0.2605';
 $VERSION = eval $VERSION;
 
 # inherit overload from Math::BigFloat, but disable the bitwise ops that don't
@@ -1925,7 +1925,7 @@ Euler's number.
 
 This method was added in v0.20 of Math::BigRat (May 2007).
 
-See also L</blog()>.
+See also C<blog()>.
 
 =head2 bnok()
 
diff --git a/dist/Safe/Safe.pm b/dist/Safe/Safe.pm
index f00853e386..bee3718593 100644
--- a/dist/Safe/Safe.pm
+++ b/dist/Safe/Safe.pm
@@ -3,7 +3,7 @@ package Safe;
 use 5.003_11;
 use Scalar::Util qw(reftype refaddr);
 
-$Safe::VERSION = "2.35";
+$Safe::VERSION = "2.36";
 
 # *** Don't declare any lexicals above this point ***
 #
@@ -590,9 +590,7 @@ Deny I<only> the listed operators from being used when compiling code
 in the compartment (I<all> other operators will be permitted, so you probably
 don't want to use this method).
 
-=head2 trap (OP, ...)
-
-=head2 untrap (OP, ...)
+=head2 trap (OP, ...), untrap (OP, ...)
 
 The trap and untrap methods are synonyms for deny and permit
 respectfully.
diff --git a/lib/diagnostics.t b/lib/diagnostics.t
index 6eecdda0ad..206d2a4696 100644
--- a/lib/diagnostics.t
+++ b/lib/diagnostics.t
@@ -43,7 +43,7 @@ seek STDERR, 0,0;
 $warning = '';
 warn
  'Lexing code attempted to stuff non-Latin-1 character into Latin-1 input';
-like $warning, qr/using lex_stuff_pvn or similar/, 'L<foo|bar/baz>';
+like $warning, qr/lex_stuff_pvn or similar/, 'L<foo|bar/baz>';
 
 # Multiple messages with the same description
 seek STDERR, 0,0;
diff --git a/lib/unicore/mktables b/lib/unicore/mktables
index 76d4c684b7..5bb67e9f98 100644
--- a/lib/unicore/mktables
+++ b/lib/unicore/mktables
@@ -15493,20 +15493,34 @@ B<Legend summary:>
 
 =over 4
 
-=item Z<>B<*> is a wild-card
+=item *
 
-=item B<(\\d+)> in the info column gives the number of code points matched by
+B<*> is a wild-card
+
+=item *
+
+B<(\\d+)> in the info column gives the number of code points matched by
 this property.
 
-=item B<$DEPRECATED> means this is deprecated.
+=item *
+
+B<$DEPRECATED> means this is deprecated.
+
+=item *
+
+B<$OBSOLETE> means this is obsolete.
+
+=item *
+
+B<$STABILIZED> means this is stabilized.
 
-=item B<$OBSOLETE> means this is obsolete.
+=item *
 
-=item B<$STABILIZED> means this is stabilized.
+B<$STRICTER> means tighter (stricter) name matching applies.
 
-=item B<$STRICTER> means tighter (stricter) name matching applies.
+=item *
 
-=item B<$DISCOURAGED> means use of this form is discouraged, and may not be
+B<$DISCOURAGED> means use of this form is discouraged, and may not be
 stable.
 
 =back
diff --git a/op.c b/op.c
index 96a06b1f7c..1501e14982 100644
--- a/op.c
+++ b/op.c
@@ -4969,7 +4969,7 @@ Perl_newGVOP(pTHX_ I32 type, I32 flags, GV *gv)
 Constructs, checks, and returns an op of any type that involves an
 embedded C-level pointer (PV).  I<type> is the opcode.  I<flags> gives
 the eight bits of C<op_flags>.  I<pv> supplies the C-level pointer, which
-must have been allocated using L</PerlMemShared_malloc>; the memory will
+must have been allocated using C<PerlMemShared_malloc>; the memory will
 be freed when the op is destroyed.
 
 =cut
@@ -5664,7 +5664,7 @@ Perl_newASSIGNOP(pTHX_ I32 flags, OP *left, I32 optype, OP *right)
 
 Constructs a state op (COP).  The state op is normally a C<nextstate> op,
 but will be a C<dbstate> op if debugging is enabled for currently-compiled
-code.  The state op is populated from L</PL_curcop> (or L</PL_compiling>).
+code.  The state op is populated from C<PL_curcop> (or C<PL_compiling>).
 If I<label> is non-null, it supplies the name of a label to attach to
 the state op; this function takes ownership of the memory pointed at by
 I<label>, and will free it.  I<flags> gives the eight bits of C<op_flags>
diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 3d58c7b9b0..229ce0dc38 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -4662,11 +4662,7 @@ L<perlre>.
 (F) The end of the perl code contained within the {...} must be
 followed immediately by a ')'.
 
-=item Z<>500 Server error
-
-See Server error.
-
-=item Server error
+=item Server error (a.k.a. "500 Server error")
 
 (A) This is the error message generally seen in a browser window
 when trying to run a CGI program (including SSI) over the web.  The
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 9540a01883..5c6b4f8606 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -2471,8 +2471,7 @@ is left as an exercise to the reader.
 
 The C<POSIX::getattr> function can do this more portably on
 systems purporting POSIX compliance.  See also the C<Term::ReadKey>
-module from your nearest CPAN site; details on CPAN can be found under
-L<perlmodlib/CPAN>.
+module from your nearest L<CPAN|http://www.cpan.org> site.
 
 =item getlogin
 X<getlogin> X<login>
diff --git a/pod/perlunifaq.pod b/pod/perlunifaq.pod
index f952d1a3f9..93997683c4 100644
--- a/pod/perlunifaq.pod
+++ b/pod/perlunifaq.pod
@@ -136,8 +136,6 @@ concern, and you can just C<eval> dumped data as always.
 
 =head2 Why do regex character classes sometimes match only in the ASCII range?
 
-=head2 Why do some characters not uppercase or lowercase correctly?
-
 Starting in Perl 5.14 (and partially in Perl 5.12), just put a
 C<use feature 'unicode_strings'> near the beginning of your program.
 Within its lexical scope you shouldn't have this problem.  It also is
@@ -164,6 +162,10 @@ already been upgraded.
 
 For a more detailed discussion, see L<Unicode::Semantics> on CPAN.
 
+=head2 Why do some characters not uppercase or lowercase correctly?
+
+See the answer to the previous question.
+
 =head2 How can I determine if a string is a text string or a binary string?
 
 You can't. Some use the UTF8 flag for this, but that's misuse, and makes well
diff --git a/t/porting/known_pod_issues.dat b/t/porting/known_pod_issues.dat
index 233fda15ff..61157fcbae 100644
--- a/t/porting/known_pod_issues.dat
+++ b/t/porting/known_pod_issues.dat
@@ -184,34 +184,18 @@ Win32::Locale
 YAML
 YAML::Syck
 YAML::Tiny
-dist/filter-simple/lib/filter/simple.pm	Verbatim paragraph in NAME section	1
-dist/locale-maketext/lib/locale/maketext/tpj13.pod	No items in =over / =back list	3
-dist/math-bigint/lib/math/bigint/calcemu.pm	empty section in previous paragraph	3
-dist/math-bigrat/lib/math/bigrat.pm	unresolved internal link	1
 dist/net-ping/lib/net/ping.pm	Verbatim line length including indents exceeds 100 by	1
-dist/safe/safe.pm	empty section in previous paragraph	1
-ext/pod-html/bin/pod2html	Pod NAME already used	1
 ext/posix/lib/posix.pod	Verbatim line length including indents exceeds 100 by	2
-pod/perlapi.pod	unresolved internal link	3
 pod/perlbook.pod	Verbatim line length including indents exceeds 100 by	1
 pod/perldebguts.pod	Verbatim line length including indents exceeds 100 by	2
-pod/perldiag.pod	=item type mismatch	1
 pod/perldtrace.pod	Verbatim line length including indents exceeds 100 by	4
 pod/perlebcdic.pod	Verbatim line length including indents exceeds 100 by	10
-pod/perlfunc.pod	There is more than one target	1
 pod/perlmacosx.pod	Verbatim line length including indents exceeds 100 by	3
 pod/perlos2.pod	Verbatim line length including indents exceeds 100 by	4
 pod/perlperf.pod	Verbatim line length including indents exceeds 100 by	32
 pod/perlrun.pod	Verbatim line length including indents exceeds 100 by	1
 pod/perlthrtut.pod	Verbatim line length including indents exceeds 100 by	1
 pod/perltru64.pod	Verbatim line length including indents exceeds 100 by	1
-pod/perlunifaq.pod	empty section in previous paragraph	1
-pod/perluniprops.pod	=item type mismatch	6
 pod/perlwin32.pod	Verbatim line length including indents exceeds 100 by	6
-porting/how_to_write_a_perldelta.pod	There is no NAME	1
 porting/release_managers_guide.pod	Verbatim line length including indents exceeds 100 by	1
-porting/release_schedule.pod	There is no NAME	1
-utils/pod2html	Pod NAME already used	1
-x2p/a2p.pod	empty section in previous paragraph	2
 lib/benchmark.pm	Verbatim line length including indents exceeds 100 by	2
-lib/config.pod	nested commands F<...F<...>...>	3
diff --git a/x2p/a2p.pod b/x2p/a2p.pod
index 9bab1f8814..aeddf9a0d5 100644
--- a/x2p/a2p.pod
+++ b/x2p/a2p.pod
@@ -159,16 +159,12 @@ A2p uses no environment variables.
 
 Larry Wall E<lt>F<larry@wall.org>E<gt>
 
-=head1 FILES
-
 =head1 SEE ALSO
 
  perl	The perl compiler/interpreter
 
  s2p	sed to perl translator
 
-=head1 DIAGNOSTICS
-
 =head1 BUGS
 
 It would be possible to emulate awk's behavior in selecting string