Re: pod bugs

[Russ Allbery <rra@stanford.edu>]

Tom Christiansen <tchrist@chthon.perl.com> writes:

> I was using a pod2text from some release back.  Yes, the version in _63
> "works", but this is not a "fix" I enjoy seeing.  It should issue
> warnings on broken pod.  Pod is paragraph-based.  A paragraph ends in
> two or more consecutive newlines.  You're just making up for mistakes
> that will bite other people later.

There should be a lint program that finds this sort of thing, and we
should be running it regularly on all of the documentation that comes with
Perl.  I'd also like to see it run automatically on all of the
documentation in a module when you do make dist with MakeMaker.  But I
think it's properly a different program than the actual converter.

I could be persuaded I'm wrong, though.

-- 
Russ Allbery (rra@stanford.edu)         <URL:http://www.eyrie.org/~eagle/>

---

References to:

Tom Christiansen <tchrist@chthon.perl.com>

---

[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index][Thread Index][Top&Search][Original]

---