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

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

Thread Previous | Thread Next
Tim Jenness
February 25, 2001 20:06
Re: [PATCH: perl@8892] reduce podchecker ERRORs
Message ID:
On 25 Feb 2001, Russ Allbery wrote:

> Prymmer/Kahn <> 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

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About