Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: Perl: porters

[perl #113436] pod errors in perlmodlib

 

 

Perl porters RSS feed   Index | Next | Previous | View Threaded


perlbug-followup at perl

May 30, 2012, 12:53 PM

Post #1 of 2 (47 views)
Permalink
[perl #113436] pod errors in perlmodlib

# New Ticket Created by Jim Avera
# Please include the string: [perl #113436]
# in the subject line of all future correspondence about this issue.
# <URL: https://rt.perl.org:443/rt3/Ticket/Display.html?id=113436 >



This is a bug report for perl from james_avera [at] yahoo,
generated with the help of perlbug 1.39 running under perl 5.12.4.

-----------------------------------------------------------------
'perldoc perlmodlib' ends with the following:

POD ERRORS
Hey! The above document had some coding errors, which are explained
below:

Around line 3396:
You forgot a '=back' before '=head2'

Around line 3494:
=back without =over
-----------------------------------------------------------------
---
Flags:
category=docs
severity=low
---
Site configuration information for perl 5.12.4:

Configured by Debian Project at Tue Sep 6 08:08:24 UTC 2011.

Summary of my perl5 (revision 5 version 12 subversion 4) configuration:

Platform:
osname=linux, osvers=2.6.24-28-server,
archname=x86_64-linux-gnu-thread-multi
uname='linux allspice 2.6.24-28-server #1 smp wed aug 18 21:17:51
utc 2010 x86_64 x86_64 x86_64 gnulinux '
config_args='-Dusethreads -Duselargefiles -Dccflags=-DDEBIAN
-Dcccdlflags=-fPIC -Darchname=x86_64-linux-gnu -Dprefix=/usr
-Dprivlib=/usr/share/perl/5.12 -Darchlib=/usr/lib/perl/5.12
-Dvendorprefix=/usr -Dvendorlib=/usr/share/perl5
-Dvendorarch=/usr/lib/perl5 -Dsiteprefix=/usr/local
-Dsitelib=/usr/local/share/perl/5.12.4
-Dsitearch=/usr/local/lib/perl/5.12.4 -Dman1dir=/usr/share/man/man1
-Dman3dir=/usr/share/man/man3 -Dsiteman1dir=/usr/local/man/man1
-Dsiteman3dir=/usr/local/man/man3 -Duse64bitint -Dman1ext=1
-Dman3ext=3perl -Dpager=/usr/bin/sensible-pager -Uafs -Ud_csh -Ud_ualarm
-Uusesfio -Uusenm -Ui_libutil -DDEBUGGING=-g -Doptimize=-O2 -Duseshrplib
-Dlibperl=libperl.so.5.12.4 -des'
hint=recommended, useposix=true, d_sigaction=define
useithreads=define, usemultiplicity=define
useperlio=define, d_sfio=undef, uselargefiles=define, usesocks=undef
use64bitint=define, use64bitall=define, uselongdouble=undef
usemymalloc=n, bincompat5005=undef
Compiler:
cc='cc', ccflags ='-D_REENTRANT -D_GNU_SOURCE -DDEBIAN
-fno-strict-aliasing -pipe -fstack-protector -I/usr/local/include
-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64',
optimize='-O2 -g',
cppflags='-D_REENTRANT -D_GNU_SOURCE -DDEBIAN -fno-strict-aliasing
-pipe -fstack-protector -I/usr/local/include'
ccversion='', gccversion='4.6.1', gccosandvers=''
intsize=4, longsize=8, ptrsize=8, doublesize=8, byteorder=12345678
d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
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 -L/usr/local/lib'
libpth=/usr/local/lib /lib/x86_64-linux-gnu /lib/../lib
/usr/lib/x86_64-linux-gnu /usr/lib/../lib /lib /usr/lib
libs=-lgdbm -lgdbm_compat -ldb -ldl -lm -lpthread -lc -lcrypt
perllibs=-ldl -lm -lpthread -lc -lcrypt
libc=, so=so, useshrplib=true, libperl=libperl.so.5.12.4
gnulibc_version='2.13'
Dynamic Linking:
dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-Wl,-E'
cccdlflags='-fPIC', lddlflags='-shared -O2 -g -L/usr/local/lib
-fstack-protector'

Locally applied patches:


---
@INC for perl 5.12.4:
/home/jima/local/share/perl/5.12.4
/home/jima/local/share/perl
/home/jima/lib/perl
/etc/perl
/usr/local/lib/perl/5.12.4
/usr/local/share/perl/5.12.4
/usr/lib/perl5
/usr/share/perl5
/usr/lib/perl/5.12
/usr/share/perl/5.12
/usr/local/lib/site_perl
.

---
Environment for perl 5.12.4:
HOME=/home/jima
LANG=en_US.UTF-8
LANGUAGE (unset)
LD_LIBRARY_PATH=/home/jima/local/lib
LOGDIR (unset)

PATH=/home/jima/bin:/home/jima/local/bin:/home/jima/jima_tools/x86_64/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/bin/X11:/usr/local/bin:/opt/openoffice.org3/program:/usr/lib/lightdm/lightdm:/usr/local/sbin:/usr/games:.
PERL5LIB=/home/jima/local/share/perl:/home/jima/lib/perl
PERL_BADLANG (unset)
SHELL=/bin/bash


perlbug-followup at perl

May 30, 2012, 7:00 PM

Post #2 of 2 (43 views)
Permalink
[perl #113436] pod errors in perlmodlib [In reply to]

On Wed May 30 12:53:53 2012, jimav wrote:
>
> This is a bug report for perl from james_avera [at] yahoo,
> generated with the help of perlbug 1.39 running under perl 5.12.4.
>
> -----------------------------------------------------------------
> 'perldoc perlmodlib' ends with the following:
>
> POD ERRORS
> Hey! The above document had some coding errors, which are
> explained
> below:
>
> Around line 3396:
> You forgot a '=back' before '=head2'
>
> Around line 3494:
> =back without =over
> -----------------------------------------------------------------
> ---
> Flags:
> category=docs
> severity=low
> ---
> Site configuration information for perl 5.12.4:
>
> Configured by Debian Project at Tue Sep 6 08:08:24 UTC 2011.

Thanks for your report. I cannot reproduce this problem with the
version of perlmodlib that shipped recently with perl 5.16.0. In fact,
I'm fairly certain that it was fixed with this commit:

##########

$ git show abf06cc1af7
commit abf06cc1af73af95068298f4ffc40d1b3b651e10
Author: Michael Stevens <mstevens [at] etla>
Date: Mon Feb 7 17:36:50 2011 +0000

Fix invalid pod in perlmodlib

diff --git a/pod/perlmodlib.PL b/pod/perlmodlib.PL
index dc2faf2..e0b7d8f 100644
--- a/pod/perlmodlib.PL
+++ b/pod/perlmodlib.PL
@@ -1409,6 +1409,8 @@ old behavior if people rely on it. Document
incompatible

=back

+=back
+
=head2 Guidelines for Converting Perl 4 Library Scripts into Modules

=over 4
@@ -1507,8 +1509,6 @@ or

=back

-=back
-
=head1 NOTE

Perl does not enforce private and public parts of its modules as you may

##########

So I'm going to mark this RT as resolved.

Thank you very much.
Jim Keenan

---
via perlbug: queue: perl5 status: new
https://rt.perl.org:443/rt3/Ticket/Display.html?id=113436

Perl porters RSS feed   Index | Next | Previous | View Threaded
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.