| Subject: | Documentation::RequirePodSections should not complain until the first line of POD |
Currently, because of the "whole-document" nature of this policy, its
complaints are reported at line 1 of the document, even if your POD
doesn't start until after __END__ long past line 1. This forces any
per-file disabling via "## no critic" to be the first line in the file.
This might not be feasible if the file is a script that needs a #! line
to be first, nor is is useful if more than one policy "demands" that its
no-critic be on line 1.
It would be more useful if this policy could react to no-critic
directives that simply appear before the first line of POD. Currently,
the only alternative is to globally disable the policy entirely, which
is a shame if you actually use it but just need the occasional exception.
--
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
Randy J. Ray Silicon Valley Scale Modelers:
http://www.svsm.org
rjray@blackperl.com
randy.j.ray@gmail.com