Re: Pod::Simple issues
[email protected] (Karl Williamson) Fri, 29 Apr 2016 22:47:58 -0600
| Newsgroups | perl.pod-people |
|---|---|
| Message-ID | <[email protected]> |
On 04/29/2016 04:33 PM, Russ Allbery wrote: > Karl Williamson <[email protected]> writes: > >> Rather than aborting parsing at the point where this occurs, I think it >> should continue on, but generate an errors section, like it does for most >> other errors. > > This will cause a hard failure in pod2man and pod2text by default, since > they do not generate ERRORS sections by default (you have to request that > behavior with a flag). They used to generate ERRORS sections, which made > people very unhappy because they didn't want their documents published > with sections saying the documents were bad, and after a lot of previous > discussion I changed the default to fail on generation. (I'd really > rather not reverse that decision at this point.) > I'm not sure I understand what "fail on generation" means. I think it might mean just not generate a pod, rather than generate one with an error section. What I was intending was to add a scream() call. The only failure that I saw in Pod::Simple that stopped parsing was when it was clear the encoding of the pod was not understandable, so there was no point in continuing. So I don't understand what you do, unless it is to die on pod errors, or some such. I tend to agree about not reversing your earlier decision.