Subject: | Errors in the POD |
The POD for Tagger.pm contains a few coding errors, which end up at the
bottom of the manpage when run through pod2man:
POD ERRORS
Hey! The above document had some coding errors, which are
explained below:
Around line 179:
You forgot a '=back' before '=head1'
Around line 183:
'=item' outside of any '=over'
Around line 970:
You forgot a '=back' before '=head1'
I've attached a patch to fix the few errors in the POD.
I've also attached a second patch that adds a test to the t/ directory
that will use the Test::Pod module if available to check for POD errors,
which you may want to apply to prevent any errors creeping into future
versions.
Subject: | lingua-en-tagger-pod-test.patch |
diff -x debian -urN orig/Lingua-EN-Tagger-0.15//Makefile.PL Lingua-EN-Tagger-0.15//Makefile.PL
--- orig/Lingua-EN-Tagger-0.15//Makefile.PL 2008-07-28 21:53:50.000000000 +0100
+++ Lingua-EN-Tagger-0.15//Makefile.PL 2010-05-04 20:42:50.000000000 +0100
@@ -12,6 +12,7 @@
WriteMakefile(
'NAME' => 'Lingua::EN::Tagger',
'VERSION_FROM' => 'Tagger.pm', # finds $VERSION
+ 'BUILD_REQUIRES' => { 'Test::Pod' => '1.00' },
'PREREQ_PM' => { 'Lingua::Stem' => '0.81',
'HTML::Parser' => '3.45',
'Memoize' => '1.01',
diff -x debian -urN orig/Lingua-EN-Tagger-0.15//t/pod.t Lingua-EN-Tagger-0.15//t/pod.t
--- orig/Lingua-EN-Tagger-0.15//t/pod.t 1970-01-01 01:00:00.000000000 +0100
+++ Lingua-EN-Tagger-0.15//t/pod.t 2010-05-04 20:28:41.000000000 +0100
@@ -0,0 +1,7 @@
+#
+# Tests that there are no errors in the PODs
+#
+use Test::More;
+eval "use Test::Pod 1.00";
+plan skip_all => "Test::Pod 1.00 required for testing POD" if $@;
+all_pod_files_ok();
Subject: | lingua-en-tagger-pod-errors.patch |
diff -x debian -urN orig/Lingua-EN-Tagger-0.15//Tagger.pm Lingua-EN-Tagger-0.15//Tagger.pm
--- orig/Lingua-EN-Tagger-0.15//Tagger.pm 2008-07-29 15:34:44.000000000 +0100
+++ Lingua-EN-Tagger-0.15//Tagger.pm 2010-05-04 20:27:09.000000000 +0100
@@ -138,6 +138,8 @@
=back
+=back
+
=cut
######################################################################
@@ -178,7 +180,7 @@
=head1 METHODS
-
+=over
=item add_tags TEXT
@@ -967,6 +969,8 @@
__END__
+=back
+
=head1 AUTHORS
Aaron Coburn <aaron@coburncuadrado.com>