pod/buildtoc: generates warnings and errors in pod/perltoc.pod #16595

p5pRT · 2018-06-23T02:53:31Z

Migrated from rt.perl.org#133296 (status was 'open')

Searchable as RT133296$

p5pRT · 2018-06-23T02:53:31Z

From @jkeenan

The program 'pod/buildtoc' is nearly the last step run by 'make'. It
generates 'pod/perltoc.pod' from all the other .pod files in the core
distribution. If, however, you run the 'podchecker' utility over
'pod/perltoc.pod', you will get both WARNINGs and ERRORs. For example,
in perl-5.26.0, you get:

#####
$ perldoc -l perltoc
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod

$ podchecker `perldoc -l perltoc`
*** WARNING: empty section in previous paragraph at line 20657 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20675 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20677 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20815 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20817 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20833 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3896 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
has 3 pod syntax errors.
#####

I get what is effectively the same in perl-5.28.0 (so, not a regression):

#####
$ podchecker pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21226 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21244 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21246 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21384 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21386 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21402 in file
pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3909 in
file pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33790 in file
pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33790 in file
pod/perltoc.pod
pod/perltoc.pod has 3 pod syntax errors.
#####

1. The unresolved link 'Other Properties' has its origin in
pod/perlunicode.pod:

#####
1085 =head2 Unicode Regular Expression Support Level
1086
1087 The following list of Unicode supported features for regular
expressions describes
1088 all features currently directly supported by core Perl. The references
1089 to "Level I<N>" and the section numbers refer to
1090 L<UTS#18 "Unicode Regular
Expressions"|http://www.unicode.org/reports/tr18>,
1091 version 13, November 2013.
1092
1093 =head3 Level 1 - Basic Unicode Support
1094
1095 RL1.1 Hex Notation - Done [1]
1096 RL1.2 Properties - Done [2]
1097 RL1.2a Compatibility Properties - Done [3]
1098 RL1.3 Subtraction and Intersection - Experimental [4]
1099 RL1.4 Simple Word Boundaries - Done [5]
1100 RL1.5 Simple Loose Matches - Done [6]
1101 RL1.6 Line Boundaries - Partial [7]
1102 RL1.7 Supplementary Code Points - Done [8]
1103
1104 =over 4
1105
1106 =item [1] C<\N{U+...}> and C<\x{...}>
1107
1108 =item [2]
1109 C<\p{...}> C<\P{...}>. This requirement is for a minimal list of
1110 properties. Perl supports these and all other Unicode character
1111 properties, as R2.7 asks (see L</"Unicode Character Properties">
above).
1112
1113 =item [3]
1114 Perl has C<\d> C<\D> C<\s> C<\S> C<\w> C<\W> C<\X> C<[:I<prop>:]>
1115 C<[:^I<prop>:]>, plus all the properties specified by
1116 L<http://www.unicode.org/reports/tr18/#Compatibility_Properties>.
These
1117 are described above in L</Other Properties>
1118
1119 =item [4]
1120
...
#####

2. The unresolved links 'runtests' and 'summary' come from
cpan/Test-Harness/lib/TAP/Harness.pm:

#####
1012 =head1 SUBCLASSING
1013
1014 If you can't configure C<TAP::Harness> to do exactly what you want,
and writing
1015 a plugin isn't an option, consider extending it. It is designed to
be (mostly)
1016 easy to subclass, though the cases when sub-classing is necessary
should be few
1017 and far between.
1018
1019 =head2 Methods
1020
1021 The following methods are ones you may wish to override if you want to
1022 subclass C<TAP::Harness>.
1023
1024 =over 4
1025
1026 =item L</new>
1027
1028 =item L</runtests>
1029
1030 =item L</summary>
1031
1032 =back
#####

When I run pod/perlunicode.pod and cpan/Test-Harness/lib/TAP/Harness.pm
through the standard 'podchecker' utility, both are graded 'pod syntax
OK'. So something is probably amiss with the pod/buildtoc program.

Thank you very much.
Jim Keenan

p5pRT · 2018-06-23T02:53:31Z

From @jkeenan

Summary of my perl5 (revision 5 version 28 subversion 0) configuration:
Commit id: 1efe078
Platform:
osname=linux
osvers=4.4.0-128-generic
archname=x86_64-linux
uname='linux zareason 4.4.0-128-generic #154-ubuntu smp fri may 25 14:15:18 utc 2018 x86_64 x86_64 x86_64 gnulinux '
config_args='-des -Dusedevel'
hint=recommended
useposix=true
d_sigaction=define
useithreads=undef
usemultiplicity=undef
use64bitint=define
use64bitall=define
uselongdouble=undef
usemymalloc=n
default_inc_excludes_dot=define
bincompat5005=undef
Compiler:
cc='cc'
ccflags ='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64'
optimize='-O2'
cppflags='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include'
ccversion=''
gccversion='5.4.0 20160609'
gccosandvers=''
intsize=4
longsize=8
ptrsize=8
doublesize=8
byteorder=12345678
doublekind=3
d_longlong=define
longlongsize=8
d_longdbl=define
longdblsize=16
longdblkind=3
ivtype='long'
ivsize=8
nvtype='double'
nvsize=8
Off_t='off_t'
lseeksize=8
alignbytes=8
prototype=define
Linker and Libraries:
ld='cc'
ldflags =' -fstack-protector-strong -L/usr/local/lib'
libpth=/usr/local/lib /usr/lib/gcc/x86_64-linux-gnu/5/include-fixed /usr/include/x86_64-linux-gnu /usr/lib /lib/x86_64-linux-gnu /lib/../lib /usr/lib/x86_64-linux-gnu /usr/lib/../lib /lib /lib64 /usr/lib64
libs=-lpthread -lnsl -ldb -ldl -lm -lcrypt -lutil -lc
perllibs=-lpthread -lnsl -ldl -lm -lcrypt -lutil -lc
libc=libc-2.23.so
so=so
useshrplib=false
libperl=libperl.a
gnulibc_version='2.23'
Dynamic Linking:
dlsrc=dl_dlopen.xs
dlext=so
d_dlsymun=undef
ccdlflags='-Wl,-E'
cccdlflags='-fPIC'
lddlflags='-shared -O2 -L/usr/local/lib -fstack-protector-strong'

Characteristics of this binary (from libperl):
Compile-time options:
HAS_TIMES
PERLIO_LAYERS
PERL_COPY_ON_WRITE
PERL_DONT_CREATE_GVSV
PERL_MALLOC_WRAP
PERL_OP_PARENT
PERL_PRESERVE_IVUV
PERL_USE_DEVEL
USE_64_BIT_ALL
USE_64_BIT_INT
USE_LARGE_FILES
USE_LOCALE
USE_LOCALE_COLLATE
USE_LOCALE_CTYPE
USE_LOCALE_NUMERIC
USE_LOCALE_TIME
USE_PERLIO
USE_PERL_ATOF
Built under linux
Compiled at Jun 22 2018 22:25:40
%ENV:
PERL2DIR="/home/jkeenan/gitwork/perl2"
PERLBREW_BASHRC_VERSION="0.78"
PERLBREW_HOME="/home/jkeenan/.perlbrew"
PERLBREW_MANPATH="/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/man"
PERLBREW_PATH="/home/jkeenan/perl5/perlbrew/bin:/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/bin"
PERLBREW_PERL="perl-5.26.0"
PERLBREW_ROOT="/home/jkeenan/perl5/perlbrew"
PERLBREW_VERSION="0.78"
PERL_WORKDIR="/home/jkeenan/gitwork/perl"
@INC:
lib
/usr/local/lib/perl5/site_perl/5.28.0/x86_64-linux
/usr/local/lib/perl5/site_perl/5.28.0
/usr/local/lib/perl5/5.28.0/x86_64-linux
/usr/local/lib/perl5/5.28.0

p5pRT · 2018-06-23T15:22:31Z

From @xsawyerx

Yup. This was caused by my release. I'm working on it and will push
commits as soon as it works.

On 06/23/2018 04:53 AM, James E Keenan (via RT) wrote:

# New Ticket Created by James E Keenan
# Please include the string: [perl #133296]
# in the subject line of all future correspondence about this issue.
# <URL: https://rt-archive.perl.org/perl5/Ticket/Display.html?id=133296 >

The program 'pod/buildtoc' is nearly the last step run by 'make'. It
generates 'pod/perltoc.pod' from all the other .pod files in the core
distribution. If, however, you run the 'podchecker' utility over
'pod/perltoc.pod', you will get both WARNINGs and ERRORs. For example,
in perl-5.26.0, you get:

#####
$ perldoc -l perltoc
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod

$ podchecker `perldoc -l perltoc`
*** WARNING: empty section in previous paragraph at line 20657 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20675 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20677 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20815 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20817 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20833 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3896 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-5.26.0/lib/5.26.0/pod/perltoc.pod
has 3 pod syntax errors.
#####

I get what is effectively the same in perl-5.28.0 (so, not a regression):

#####
$ podchecker pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21226 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21244 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21246 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21384 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21386 in file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21402 in file
pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3909 in
file pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33790 in file
pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33790 in file
pod/perltoc.pod
pod/perltoc.pod has 3 pod syntax errors.
#####

1. The unresolved link 'Other Properties' has its origin in
pod/perlunicode.pod:

#####
1085 =head2 Unicode Regular Expression Support Level
1086
1087 The following list of Unicode supported features for regular
expressions describes
1088 all features currently directly supported by core Perl. The references
1089 to "Level I<N>" and the section numbers refer to
1090 L<UTS#18 "Unicode Regular
Expressions"|http://www.unicode.org/reports/tr18>,
1091 version 13, November 2013.
1092
1093 =head3 Level 1 - Basic Unicode Support
1094
1095 RL1.1 Hex Notation - Done [1]
1096 RL1.2 Properties - Done [2]
1097 RL1.2a Compatibility Properties - Done [3]
1098 RL1.3 Subtraction and Intersection - Experimental [4]
1099 RL1.4 Simple Word Boundaries - Done [5]
1100 RL1.5 Simple Loose Matches - Done [6]
1101 RL1.6 Line Boundaries - Partial [7]
1102 RL1.7 Supplementary Code Points - Done [8]
1103
1104 =over 4
1105
1106 =item [1] C<\N{U+...}> and C<\x{...}>
1107
1108 =item [2]
1109 C<\p{...}> C<\P{...}>. This requirement is for a minimal list of
1110 properties. Perl supports these and all other Unicode character
1111 properties, as R2.7 asks (see L</"Unicode Character Properties">
above).
1112
1113 =item [3]
1114 Perl has C<\d> C<\D> C<\s> C<\S> C<\w> C<\W> C<\X> C<[:I<prop>:]>
1115 C<[:^I<prop>:]>, plus all the properties specified by
1116 L<http://www.unicode.org/reports/tr18/#Compatibility_Properties>.
These
1117 are described above in L</Other Properties>
1118
1119 =item [4]
1120
...
#####

2. The unresolved links 'runtests' and 'summary' come from
cpan/Test-Harness/lib/TAP/Harness.pm:

#####
1012 =head1 SUBCLASSING
1013
1014 If you can't configure C<TAP::Harness> to do exactly what you want,
and writing
1015 a plugin isn't an option, consider extending it. It is designed to
be (mostly)
1016 easy to subclass, though the cases when sub-classing is necessary
should be few
1017 and far between.
1018
1019 =head2 Methods
1020
1021 The following methods are ones you may wish to override if you want to
1022 subclass C<TAP::Harness>.
1023
1024 =over 4
1025
1026 =item L</new>
1027
1028 =item L</runtests>
1029
1030 =item L</summary>
1031
1032 =back
#####

When I run pod/perlunicode.pod and cpan/Test-Harness/lib/TAP/Harness.pm
through the standard 'podchecker' utility, both are graded 'pod syntax
OK'. So something is probably amiss with the pod/buildtoc program.

Thank you very much.
Jim Keenan

p5pRT · 2018-06-23T15:22:31Z

The RT System itself - Status changed from 'new' to 'open'

p5pRT · 2018-06-23T17:16:44Z

From @jkeenan

On Sat, 23 Jun 2018 15:22:31 GMT, xsawyerx@gmail.com wrote:

Yup. This was caused by my release. I'm working on it and will push
commits as soon as it works.

Well, not entirely your fault. The errors processing TAP::Harness can be found in perl-5.24.1. See below.

On 06/23/2018 04:53 AM, James E Keenan (via RT) wrote:

# New Ticket Created by James E Keenan
# Please include the string: [perl #133296]
# in the subject line of all future correspondence about this issue.
# <URL: https://rt-archive.perl.org/perl5/Ticket/Display.html?id=133296 >

The program 'pod/buildtoc' is nearly the last step run by 'make'. It
generates 'pod/perltoc.pod' from all the other .pod files in the core
distribution. If, however, you run the 'podchecker' utility over
'pod/perltoc.pod', you will get both WARNINGs and ERRORs. For
example,
in perl-5.26.0, you get:

#####
$ perldoc -l perltoc
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod

$ podchecker `perldoc -l perltoc`
*** WARNING: empty section in previous paragraph at line 20657 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20675 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20677 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20815 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20817 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20833 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3896
in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
has 3 pod syntax errors.
#####

I get what is effectively the same in perl-5.28.0 (so, not a
regression):

#####
$ podchecker pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21226 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21244 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21246 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21384 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21386 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21402 in
file
pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3909
in
file pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33790 in file
pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33790 in file
pod/perltoc.pod
pod/perltoc.pod has 3 pod syntax errors.
#####

1. The unresolved link 'Other Properties' has its origin in
pod/perlunicode.pod:

#####
1085 =head2 Unicode Regular Expression Support Level
1086
1087 The following list of Unicode supported features for regular
expressions describes
1088 all features currently directly supported by core Perl. The
references
1089 to "Level I<N>" and the section numbers refer to
1090 L<UTS#18 "Unicode Regular
Expressions"|http://www.unicode.org/reports/tr18>,
1091 version 13, November 2013.
1092
1093 =head3 Level 1 - Basic Unicode Support
1094
1095 RL1.1 Hex Notation - Done [1]
1096 RL1.2 Properties - Done [2]
1097 RL1.2a Compatibility Properties - Done [3]
1098 RL1.3 Subtraction and Intersection - Experimental [4]
1099 RL1.4 Simple Word Boundaries - Done [5]
1100 RL1.5 Simple Loose Matches - Done [6]
1101 RL1.6 Line Boundaries - Partial [7]
1102 RL1.7 Supplementary Code Points - Done [8]
1103
1104 =over 4
1105
1106 =item [1] C<\N{U+...}> and C<\x{...}>
1107
1108 =item [2]
1109 C<\p{...}> C<\P{...}>. This requirement is for a minimal list
of
1110 properties. Perl supports these and all other Unicode character
1111 properties, as R2.7 asks (see L</"Unicode Character
Properties">
above).
1112
1113 =item [3]
1114 Perl has C<\d> C<\D> C<\s> C<\S> C<\w> C<\W> C<\X>
C<[:I<prop>:]>
1115 C<[:^I<prop>:]>, plus all the properties specified by
1116
L<http://www.unicode.org/reports/tr18/#Compatibility_Properties>.
These
1117 are described above in L</Other Properties>
1118
1119 =item [4]
1120
...
#####

2. The unresolved links 'runtests' and 'summary' come from
cpan/Test-Harness/lib/TAP/Harness.pm:

#####
1012 =head1 SUBCLASSING
1013
1014 If you can't configure C<TAP::Harness> to do exactly what you
want,
and writing
1015 a plugin isn't an option, consider extending it. It is
designed to
be (mostly)
1016 easy to subclass, though the cases when sub-classing is
necessary
should be few
1017 and far between.
1018
1019 =head2 Methods
1020
1021 The following methods are ones you may wish to override if you
want to
1022 subclass C<TAP::Harness>.
1023
1024 =over 4
1025
1026 =item L</new>
1027
1028 =item L</runtests>
1029
1030 =item L</summary>
1031
1032 =back
#####

When I run pod/perlunicode.pod and cpan/Test-
Harness/lib/TAP/Harness.pm
through the standard 'podchecker' utility, both are graded 'pod
syntax
OK'. So something is probably amiss with the pod/buildtoc program.

Thank you very much.
Jim Keenan

#####
$ which perl
/home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/bin/perl
[~] 531 $ !518
podchecker `perldoc -l perltoc`
*** WARNING: (section) in 'bzip2(1)' deprecated at line 9619 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: Apparent command =head2 not preceded by blank line at line 18718 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20131 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20149 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20151 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20289 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20291 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20307 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' contains non-escaped | or / at line 26929 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' contains non-escaped | or / at line 26932 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' contains non-escaped | or / at line 27208 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' contains non-escaped | or / at line 27211 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' at line 26929 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' at line 26932 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' at line 27208 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' at line 27211 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 32483 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 32483 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod has 7 pod syntax errors.
#####

--
James E Keenan (jkeenan@cpan.org)

p5pRT · 2018-06-24T08:22:54Z

From @xsawyerx

I've finished all the steps for fixing the perltoc and preparing blead
for 5.29.0 and I'm not getting anymore errors and warnings.

Could you please confirm it is resolved, Jim?

On 06/23/2018 07:16 PM, James E Keenan via RT wrote:

On Sat, 23 Jun 2018 15:22:31 GMT, xsawyerx@gmail.com wrote:

Yup. This was caused by my release. I'm working on it and will push
commits as soon as it works.

Well, not entirely your fault. The errors processing TAP::Harness can be found in perl-5.24.1. See below.

On 06/23/2018 04:53 AM, James E Keenan (via RT) wrote:

# New Ticket Created by James E Keenan
# Please include the string: [perl #133296]
# in the subject line of all future correspondence about this issue.
# <URL: https://rt-archive.perl.org/perl5/Ticket/Display.html?id=133296 >

The program 'pod/buildtoc' is nearly the last step run by 'make'. It
generates 'pod/perltoc.pod' from all the other .pod files in the core
distribution. If, however, you run the 'podchecker' utility over
'pod/perltoc.pod', you will get both WARNINGs and ERRORs. For
example,
in perl-5.26.0, you get:

#####
$ perldoc -l perltoc
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod

$ podchecker `perldoc -l perltoc`
*** WARNING: empty section in previous paragraph at line 20657 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20675 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20677 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20815 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20817 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20833 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3896
in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33191 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
has 3 pod syntax errors.
#####

I get what is effectively the same in perl-5.28.0 (so, not a
regression):

#####
$ podchecker pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21226 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21244 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21246 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21384 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21386 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21402 in
file
pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3909
in
file pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33790 in file
pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33790 in file
pod/perltoc.pod
pod/perltoc.pod has 3 pod syntax errors.
#####

1. The unresolved link 'Other Properties' has its origin in
pod/perlunicode.pod:

#####
1085 =head2 Unicode Regular Expression Support Level
1086
1087 The following list of Unicode supported features for regular
expressions describes
1088 all features currently directly supported by core Perl. The
references
1089 to "Level I<N>" and the section numbers refer to
1090 L<UTS#18 "Unicode Regular
Expressions"|http://www.unicode.org/reports/tr18>,
1091 version 13, November 2013.
1092
1093 =head3 Level 1 - Basic Unicode Support
1094
1095 RL1.1 Hex Notation - Done [1]
1096 RL1.2 Properties - Done [2]
1097 RL1.2a Compatibility Properties - Done [3]
1098 RL1.3 Subtraction and Intersection - Experimental [4]
1099 RL1.4 Simple Word Boundaries - Done [5]
1100 RL1.5 Simple Loose Matches - Done [6]
1101 RL1.6 Line Boundaries - Partial [7]
1102 RL1.7 Supplementary Code Points - Done [8]
1103
1104 =over 4
1105
1106 =item [1] C<\N{U+...}> and C<\x{...}>
1107
1108 =item [2]
1109 C<\p{...}> C<\P{...}>. This requirement is for a minimal list
of
1110 properties. Perl supports these and all other Unicode character
1111 properties, as R2.7 asks (see L</"Unicode Character
Properties">
above).
1112
1113 =item [3]
1114 Perl has C<\d> C<\D> C<\s> C<\S> C<\w> C<\W> C<\X>
C<[:I<prop>:]>
1115 C<[:^I<prop>:]>, plus all the properties specified by
1116
L<http://www.unicode.org/reports/tr18/#Compatibility_Properties>.
These
1117 are described above in L</Other Properties>
1118
1119 =item [4]
1120
...
#####

2. The unresolved links 'runtests' and 'summary' come from
cpan/Test-Harness/lib/TAP/Harness.pm:

#####
1012 =head1 SUBCLASSING
1013
1014 If you can't configure C<TAP::Harness> to do exactly what you
want,
and writing
1015 a plugin isn't an option, consider extending it. It is
designed to
be (mostly)
1016 easy to subclass, though the cases when sub-classing is
necessary
should be few
1017 and far between.
1018
1019 =head2 Methods
1020
1021 The following methods are ones you may wish to override if you
want to
1022 subclass C<TAP::Harness>.
1023
1024 =over 4
1025
1026 =item L</new>
1027
1028 =item L</runtests>
1029
1030 =item L</summary>
1031
1032 =back
#####

When I run pod/perlunicode.pod and cpan/Test-
Harness/lib/TAP/Harness.pm
through the standard 'podchecker' utility, both are graded 'pod
syntax
OK'. So something is probably amiss with the pod/buildtoc program.

Thank you very much.
Jim Keenan
#####
$ which perl
/home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/bin/perl
[~] 531 $ !518
podchecker `perldoc -l perltoc`
*** WARNING: (section) in 'bzip2(1)' deprecated at line 9619 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: Apparent command =head2 not preceded by blank line at line 18718 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20131 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20149 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20151 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20289 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20291 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20307 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' contains non-escaped | or / at line 26929 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' contains non-escaped | or / at line 26932 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' contains non-escaped | or / at line 27208 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' contains non-escaped | or / at line 27211 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' at line 26929 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' at line 26932 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_t able.htm' at line 27208 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'https://www.cia.gov/library/publications/the-world-factbook/appendix/prin t_appendix-d.html' at line 27211 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 32483 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 32483 in file /home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/lib/5.24.1/pod/perltoc.pod has 7 pod syntax errors.
#####

p5pRT · 2018-06-24T12:24:11Z

From @jkeenan

On Sun, 24 Jun 2018 08:22:54 GMT, xsawyerx@gmail.com wrote:

I've finished all the steps for fixing the perltoc and preparing blead
for 5.29.0 and I'm not getting anymore errors and warnings.

Could you please confirm it is resolved, Jim?

On 06/23/2018 07:16 PM, James E Keenan via RT wrote:

On Sat, 23 Jun 2018 15:22:31 GMT, xsawyerx@gmail.com wrote:

Yup. This was caused by my release. I'm working on it and will push
commits as soon as it works.

Well, not entirely your fault. The errors processing TAP::Harness
can be found in perl-5.24.1. See below.

On 06/23/2018 04:53 AM, James E Keenan (via RT) wrote:

# New Ticket Created by James E Keenan
# Please include the string: [perl #133296]
# in the subject line of all future correspondence about this
issue.
# <URL: https://rt-archive.perl.org/perl5/Ticket/Display.html?id=133296 >

The program 'pod/buildtoc' is nearly the last step run by 'make'.
It
generates 'pod/perltoc.pod' from all the other .pod files in the
core
distribution. If, however, you run the 'podchecker' utility over
'pod/perltoc.pod', you will get both WARNINGs and ERRORs. For
example,
in perl-5.26.0, you get:

#####
$ perldoc -l perltoc
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod

$ podchecker `perldoc -l perltoc`
*** WARNING: empty section in previous paragraph at line 20657 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20675 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20677 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20815 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20817 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20833 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line
3896
in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33191 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33191 in
file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-
5.26.0/lib/5.26.0/pod/perltoc.pod
has 3 pod syntax errors.
#####

I get what is effectively the same in perl-5.28.0 (so, not a
regression):

#####
$ podchecker pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21226 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21244 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21246 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21384 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21386 in
file
pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21402 in
file
pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line
3909
in
file pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33790 in
file
pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33790 in
file
pod/perltoc.pod
pod/perltoc.pod has 3 pod syntax errors.
#####

1. The unresolved link 'Other Properties' has its origin in
pod/perlunicode.pod:

#####
1085 =head2 Unicode Regular Expression Support Level
1086
1087 The following list of Unicode supported features for regular
expressions describes
1088 all features currently directly supported by core Perl. The
references
1089 to "Level I<N>" and the section numbers refer to
1090 L<UTS#18 "Unicode Regular
Expressions"|http://www.unicode.org/reports/tr18>,
1091 version 13, November 2013.
1092
1093 =head3 Level 1 - Basic Unicode Support
1094
1095 RL1.1 Hex Notation - Done [1]
1096 RL1.2 Properties - Done [2]
1097 RL1.2a Compatibility Properties - Done [3]
1098 RL1.3 Subtraction and Intersection - Experimental [4]
1099 RL1.4 Simple Word Boundaries - Done [5]
1100 RL1.5 Simple Loose Matches - Done [6]
1101 RL1.6 Line Boundaries - Partial [7]
1102 RL1.7 Supplementary Code Points - Done [8]
1103
1104 =over 4
1105
1106 =item [1] C<\N{U+...}> and C<\x{...}>
1107
1108 =item [2]
1109 C<\p{...}> C<\P{...}>. This requirement is for a minimal list
of
1110 properties. Perl supports these and all other Unicode
character
1111 properties, as R2.7 asks (see L</"Unicode Character
Properties">
above).
1112
1113 =item [3]
1114 Perl has C<\d> C<\D> C<\s> C<\S> C<\w> C<\W> C<\X>
C<[:I<prop>:]>
1115 C<[:^I<prop>:]>, plus all the properties specified by
1116
L<http://www.unicode.org/reports/tr18/#Compatibility_Properties>.
These
1117 are described above in L</Other Properties>
1118
1119 =item [4]
1120
...
#####

2. The unresolved links 'runtests' and 'summary' come from
cpan/Test-Harness/lib/TAP/Harness.pm:

#####
1012 =head1 SUBCLASSING
1013
1014 If you can't configure C<TAP::Harness> to do exactly what you
want,
and writing
1015 a plugin isn't an option, consider extending it. It is
designed to
be (mostly)
1016 easy to subclass, though the cases when sub-classing is
necessary
should be few
1017 and far between.
1018
1019 =head2 Methods
1020
1021 The following methods are ones you may wish to override if you
want to
1022 subclass C<TAP::Harness>.
1023
1024 =over 4
1025
1026 =item L</new>
1027
1028 =item L</runtests>
1029
1030 =item L</summary>
1031
1032 =back
#####

When I run pod/perlunicode.pod and cpan/Test-
Harness/lib/TAP/Harness.pm
through the standard 'podchecker' utility, both are graded 'pod
syntax
OK'. So something is probably amiss with the pod/buildtoc program.

Thank you very much.
Jim Keenan
#####
$ which perl
/home/jkeenan/perl5/perlbrew/perls/perl-5.24.1/bin/perl
[~] 531 $ !518
podchecker `perldoc -l perltoc`
*** WARNING: (section) in 'bzip2(1)' deprecated at line 9619 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: Apparent command =head2 not preceded by blank line at line
18718 in file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20131 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20149 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20151 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20289 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20291 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 20307 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node
'http://www.iso.org/iso/home/standards/country_codes/iso-3166-
1_decoding_t able.htm' contains non-escaped | or / at line 26929 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'https://www.cia.gov/library/publications/the-
world-factbook/appendix/prin t_appendix-d.html' contains non-escaped
| or / at line 26932 in file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node
'http://www.iso.org/iso/home/standards/country_codes/iso-3166-
1_decoding_t able.htm' contains non-escaped | or / at line 27208 in
file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** WARNING: node 'https://www.cia.gov/library/publications/the-
world-factbook/appendix/prin t_appendix-d.html' contains non-escaped
| or / at line 27211 in file /home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link
'http://www.iso.org/iso/home/standards/country_codes/iso-3166-
1_decoding_t able.htm' at line 26929 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link
'https://www.cia.gov/library/publications/the-world-
factbook/appendix/prin t_appendix-d.html' at line 26932 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link
'http://www.iso.org/iso/home/standards/country_codes/iso-3166-
1_decoding_t able.htm' at line 27208 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link
'https://www.cia.gov/library/publications/the-world-
factbook/appendix/prin t_appendix-d.html' at line 27211 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 32483 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 32483 in file
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod
/home/jkeenan/perl5/perlbrew/perls/perl-
5.24.1/lib/5.24.1/pod/perltoc.pod has 7 pod syntax errors.
#####

I don't see any change in the status of pod/perltoc.pod.

#####
# After make test_prep
$ git show | head -1
commit d361a1e
[perl] 597 $ podchecker pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21243 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21261 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21263 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21401 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21403 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 21419 in file pod/perltoc.pod
*** ERROR: unresolved internal link 'Other Properties' at line 3909 in file pod/perltoc.pod
*** ERROR: unresolved internal link 'runtests' at line 33867 in file pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 33867 in file pod/perltoc.pod
pod/perltoc.pod has 3 pod syntax errors.
#####

But I don't think that's due to anything you have or have not done. I think it's probably a long-standing implementation defect in pod/buildtoc. So this is not an impediment to perl-5.29.0.

Were you getting errors different from these?
--
James E Keenan (jkeenan@cpan.org)

khwilliamson · 2022-04-17T19:39:12Z

Is this still a problem?

jkeenan · 2022-07-02T02:37:49Z

The last two POD-formatting errors reported by running podchecker over pod/perltoc.pod in blead are:

*** ERROR: unresolved internal link 'runtests' at line 34985 in file pod/perltoc.pod
*** ERROR: unresolved internal link 'summary' at line 34985 in file pod/perltoc.pod
pod/perltoc.pod has 2 pod syntax errors.

These can be averted by using C<> rather than L</>. I have filed this patch upstream:
https://rt.cpan.org/Ticket/Display.html?id=143622

(However, given that on CPAN the TAP-Harness distribution is in ADOPTME status, I'm not optimistic about there being a new CPAN release any time soon.)

jkeenan · 2022-07-02T02:44:32Z

In blead (v5.37.1-51-g6e37db9b2e), we are now getting 7 instances of this kind of warning when running podchecker pod/perltoc.pod:

*** WARNING: empty section in previous paragraph at line 18738 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23147 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23165 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23167 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23309 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23311 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23327 in file pod/perltoc.pod

All but the first are situations where we have two =head2 statements with only a blank line between the first and second. Example:

23145 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
23146 
23147 =head2 Encode::CN - China-based Chinese Encodings
23148

Examining cpan/Encode/lib/Encode/CJKConstants.pm, we see that this is the only POD in the file and occurs at the end of the file.

 61 =head1 NAME
 62 
 63 Encode::CJKConstants.pm -- Internally used by Encode::??::ISO_2022_*
 64 
 65 =cut
 66

jkeenan · 2022-07-02T21:47:46Z

In blead (v5.37.1-51-g6e37db9b2e), we are now getting 7 instances of this kind of warning when running podchecker pod/perltoc.pod:
*** WARNING: empty section in previous paragraph at line 18738 in file pod/perltoc.pod

Addressed by @khwilliamson in e91f88a.

*** WARNING: empty section in previous paragraph at line 23147 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23165 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23167 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23309 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23311 in file pod/perltoc.pod
*** WARNING: empty section in previous paragraph at line 23327 in file pod/perltoc.pod
All but the first are situations where we have two `=head2` statements with only a blank line between the first and second. Example:
23145 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
23146
23147 =head2 Encode::CN - China-based Chinese Encodings
23148

Since this is not unreasonable coding, I think we can live with these 6 flaws.

Examining cpan/Encode/lib/Encode/CJKConstants.pm, we see that this is the only POD in the file and occurs at the end of the file.
 61 =head1 NAME
 62 
 63 Encode::CJKConstants.pm -- Internally used by Encode::??::ISO_2022_*
 64 
 65 =cut
 66 

And, as noted in #16595 (comment), a patch has been submitted upstream for the two ERRORs reported.

So there's nothing more that P5P can practically do here. Closing ticket.

p5pRT added Severity Low distro-All documentation type-utilities labels Oct 19, 2019

xenu removed affects-5.26 labels Nov 19, 2021

xenu removed the Severity Low label Dec 29, 2021

jkeenan closed this as completed Jul 2, 2022

haarg mentioned this issue Jul 18, 2022

buildtoc - fix inner links when generating perltoc.pod #19966

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

pod/buildtoc: generates warnings and errors in pod/perltoc.pod #16595

pod/buildtoc: generates warnings and errors in pod/perltoc.pod #16595

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

p5pRT commented Jun 24, 2018

p5pRT commented Jun 24, 2018

khwilliamson commented Apr 17, 2022

jkeenan commented Jul 2, 2022

jkeenan commented Jul 2, 2022

jkeenan commented Jul 2, 2022

pod/buildtoc: generates warnings and errors in pod/perltoc.pod #16595

pod/buildtoc: generates warnings and errors in pod/perltoc.pod #16595

Comments

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

From @jkeenan

p5pRT commented Jun 23, 2018

From @jkeenan

p5pRT commented Jun 23, 2018

From @xsawyerx

p5pRT commented Jun 23, 2018

p5pRT commented Jun 23, 2018

From @jkeenan

p5pRT commented Jun 24, 2018

From @xsawyerx

p5pRT commented Jun 24, 2018

From @jkeenan

khwilliamson commented Apr 17, 2022

jkeenan commented Jul 2, 2022

jkeenan commented Jul 2, 2022

jkeenan commented Jul 2, 2022