CC: | perl5-porters [...] perl.org |
Subject: | fix podchecker warnings |
mstevens@eris:~/Filter-Simple-0.85 % find . -name \*.pm -exec
~/bleadperl/build/bin/podchecker5.13.10 {} \;
*** WARNING: Verbatim paragraph in NAME section at line 237 in file
./lib/Filter/Simple.pm
*** WARNING: line containing nothing but whitespace in paragraph at line
612 in file ./lib/Filter/Simple.pm
*** WARNING: line containing nothing but whitespace in paragraph at line
705 in file ./lib/Filter/Simple.pm
./lib/Filter/Simple.pm pod syntax OK.
./demo/DemoUnPod.pm does not contain any pod commands.
./demo/DemoSwear.pm does not contain any pod commands.
./demo/Demo_Exporter.pm does not contain any pod commands.
./demo/Demo_REM.pm does not contain any pod commands.
./demo/Demo2a.pm does not contain any pod commands.
./demo/Demo1.pm does not contain any pod commands.
./demo/DemoData.pm does not contain any pod commands.
./demo/DotsForArrows.pm does not contain any pod commands.
./demo/Demo2b.pm does not contain any pod commands.
./demo/Demo_Data.pm does not contain any pod commands.
./demo/DemoRevCat.pm does not contain any pod commands.
./demo/Demo_Importer.pm does not contain any pod commands.
./t/lib/Filter/Simple/ExportTest.pm does not contain any pod commands.
./t/lib/Filter/Simple/FilterTest.pm does not contain any pod commands.
./t/lib/Filter/Simple/FilterOnlyTest.pm does not contain any pod
commands.
./t/lib/Filter/Simple/ImportTest.pm does not contain any pod commands.
The attached diff attempts to fix these issues.
CC'd p5p on the bug as they're listed as maintainer.
Subject: | fs.diff |
diff -urN Filter-Simple-0.85.orig/lib/Filter/Simple.pm Filter-Simple-0.85/lib/Filter/Simple.pm
--- Filter-Simple-0.85.orig/lib/Filter/Simple.pm 2010-09-05 15:03:12.000000000 +0100
+++ Filter-Simple-0.85/lib/Filter/Simple.pm 2011-02-28 14:15:33.000000000 +0000
@@ -234,7 +234,6 @@
Filter::Simple - Simplified source filtering
-
=head1 SYNOPSIS
# in MyFilter.pm:
@@ -609,7 +608,7 @@
=head2 Filtering only the code parts of source code
-
+
Most source code ceases to be grammatically correct when it is broken up
into the pieces between string literals and regexes. So the C<'code'>
and C<'code_no_comments'> component filter behave slightly differently
@@ -702,7 +701,7 @@
use Filter::Simple;
FILTER { s/(\w+)/\U$1/ };
-
+
that will almost never be a problem, but if you install a filtering
subroutine by passing it directly to the C<use Filter::Simple>
statement: