Skip Menu |

This queue is for tickets about the HTML-FormEngine-DBSQL CPAN distribution.

Report information
The Basics
Id: 2713
Status: resolved
Priority: 0/
Queue: HTML-FormEngine-DBSQL

People
Owner: Nobody in particular
Requestors: mark [...] summersault.com
Cc:
AdminCc:

Bug Information
Severity: Normal
Broken in: 0.2.1
Fixed in: (no value)



Subject: broken POD
Most of your POD is not visible on CPAN. See here: http://search.cpan.org/author/MORNI/HTML-FormEngine-DBSQL-0.2.1/DBSQL/Checks.pm Attached is a sample test to add your "t" test directory to make sure your POD is at least mostly working before you upload it.
use Test::More; # Check our Pod # The test was provided by Andy Lester, # who stole it from Brian D. Foy # Thanks to both ! use File::Spec; use File::Find; use strict; eval { require Test::Pod; Test::Pod->import; }; my @files; if ($@) { plan skip_all => "Test::Pod required for testing POD"; } elsif ($Test::Pod::VERSION < 0.95) { plan skip_all => "Test::Pod 0.95 required for testing POD"; } else { my $blib = File::Spec->catfile(qw(blib lib)); find(\&wanted, $blib, 'bin'); plan tests => scalar @files; foreach my $file (@files) { pod_file_ok($file); } } sub wanted { push @files, $File::Find::name if /\.p(l|m|od)$/; }
Subject: broken POD (or a bug in CPAN code?)
From: mark [...] summersault.com
Upon closer inspection, this may be a bug in the CPAN code instead. Check out this page: http://search.cpan.org/author/MORNI/HTML-FormEngine-DBSQL-0.2.1/ The primary module is linked to the "Checks.pm" documentation, and the Checks.pm module isn't linked at all. Strange.
Subject: the Pod problem solved:
From: mark [...] summersault.com
Here's the answer, from Graham Barr: The NAME section in the Checks module is wrong. POD is for more than just modules and +search cannot make assumptions from file names as it does not know where any one file will be installed. So it uses the +NAME sections to cross-link documents.