Ronald J Kimball
|| at Jun 25, 2008 at 2:52 pm
On Wed, Jun 25, 2008 at 04:43:09PM +0200, Ren?e B?cker wrote:
Attached is a patch that adds a warning when a lone =cut is used
--- perldiag.pod.orig 2008-06-25 12:31:27.000000000 +0200
+++ perldiag.pod 2008-06-25 12:36:35.000000000 +0200
@@ -4563,6 +4563,11 @@
(F) You called a Win32 function with incorrect arguments.
See L<Win32> for more information.
+=item Used POD directive '=cut' without other POD directive
+(W misc) =cut indicates the end of POD, but you used this directive
+without any other directive in this POD paragraph.
If I understand this correctly, this warning will be emitted when =cut
appears as the beginning of a block of Pod. However, I don't think this is
clear from the suggested text for the warning or the explanation.
Also, the perlpod documentation uses the capitalization 'Pod' rather than
I suggest something like this:
=item Pod directive '=cut' as beginning of Pod block
(W misc) =cut indicates the end of a Pod block, but you used this directive
at the beginning of a Pod block.