[win32] maintpatch
Roderick Schertler [Fri, 24 Oct 1997 11:20:44 +0000 (07:20 -0400)]
    #70:  "Fix random whitespace errors in docs"
 Msg-ID:  <12726.877706444@eeyore.ibcinc.com>
  Files:  pod/checkpods.PL pod/perlfunc.pod

p4raw-id: //depot/win32/perl@724

pod/checkpods.PL

index ccd78ec..0cac623 100644 (file)
@@ -37,7 +37,7 @@ print OUT <<'!NO!SUBS!';
 # From: Roderick Schertler <roderick@gate.net>
 # To: perl5-porters@africa.nicoh.com
 # Subject: POD lines with only spaces
-# 
+#
 # There are some places in the documentation where a POD directive is
 # ignored because the line before it contains whitespace (and so the
 # directive doesn't start a paragraph).  This patch adds a way to check
@@ -53,18 +53,25 @@ print OUT <<'!NO!SUBS!';
 #      to grow.  Someone will probably want to rewrite in terms of
 #      some sort of Pod::Checker module.  Or something.  Consider this
 #      a placeholder for the future.
-$exit = $last_blank = 0;
+#  Version 1.02  Roderick Schertler <roderick@argon.org>
+#      Check for pod directives following any kind of unempty line, not
+#      just lines of whitespace.
+
+@directive = qw(head1 head2 item over back cut pod for begin end);
+@directive{@directive} = (1) x @directive;
+
+$exit = $last_unempty = 0;
 while (<>) {
-    chop;
-    if (/^(=\S+)/ && $last_blank) {
-       printf "%s: line %5d, Non-empty line preceeding directive %s\n",
+    chomp;
+    if (/^=(\S+)/ && $directive{$1} && $last_unempty) {
+       printf "%s: line %5d, no blank line preceeding directive =%s\n",
                $ARGV, $., $1;
        $exit = 1;
     }
-    $last_blank = /^\s+$/;
+    $last_unempty = ($_ ne '');
     if (eof) {
        close(ARGV);
-       $last_blank = 0;
+       $last_unempty = 0;
     }
 }
 exit $exit