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

Re: [PATCH: perl@8892] reduce podchecker ERRORs

Thread Previous | Thread Next
From:
Tim Jenness
Date:
February 25, 2001 20:06
Subject:
Re: [PATCH: perl@8892] reduce podchecker ERRORs
Message ID:
Pine.LNX.4.30.0102251801550.2978-100000@lapaki.jach.hawaii.edu
On 25 Feb 2001, Russ Allbery wrote:

> Prymmer/Kahn <pvhp@best.com> writes:
>
> > The command I was running was simply:
>
> >   ./perl pod/podchecker -warnings -warnings pod/perl*.pod
>
> > so it was not as extensive.  Enclosed patch attempts to eliminate the
> > ERRORs reported in the respecitve files and reduce the WARNINGs (some
> > but not all to zero).
>
> > Do note that I've turned common expressions such as I/O into
> > Input-Output so as to appease podchecker's ideas about linking, and I
> > have removed most ($section_number) markup since podchecker claims that
> > it is deprecated.  Hence this patch may not be without controversy:
>
> I think podchecker is in error in many of these rather than the POD.  I
> don't see anything wrong with any of the following:
>
> > -characters with the high bit set.  If too many strange characters (>30%)
> > +characters with the high bit set.  If too many strange characters (more than 30%)
>

This is a warning because you aren't really allowed bare ">" - should be
E<gt>. Unless we are expecting the parsers to check specifically for
remaining > and < ? (it's only a problem for formats that have a special
meaning for > - latex and html spring to mind).

-- 
Tim Jenness
JCMT software engineer/Support scientist
http://www.jach.hawaii.edu/~timj




Thread Previous | Thread Next


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