Skip Menu |
 

This queue is for tickets about the Module-Install-ReadmeFromPod CPAN distribution.

Report information
The Basics
Id: 59496
Status: new
Priority: 0/
Queue: Module-Install-ReadmeFromPod

People
Owner: Nobody in particular
Requestors: hakim.cassimally [...] gmail.com
Cc:
AdminCc:

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



Subject: Docpatch for case when extension not installed on author-side
Date: Sun, 18 Jul 2010 01:55:12 +0100
To: bugs-Module-Install-ReadmeFromPod [...] rt.cpan.org
From: Hakim Cassimally <hakim.cassimally [...] gmail.com>
Download (untitled) / with headers
text/plain 1.4k
I just submitted https://rt.cpan.org/Public/Bug/Display.html?id=59495 against M::I because the instructions for M::I::RFP "don't work" out of the box: $ perl Makefile.PL include /home/hakim/other_repos/Harold/inc/Module/Install.pm String found where operator expected at Makefile.PL line 7, near "readme_from 'lib/Harold.pm'" (Do you need to predeclare readme_from?) syntax error at Makefile.PL line 7, near "readme_from 'lib/Harold.pm'" Execution of Makefile.PL aborted due to compilation errors. Of course the problem is that I didn't have Module::Install::ReadmeFromPod installed... the confusing error seems to be a result of the way the M::I plugin system works, hence the above bug. But in the meantime, would a doc-patch be reasonable? diff --git a/lib/Module/Install/ReadmeFromPod.pm b/lib/Module/Install/ReadmeFromPod.pm index b04473b..99408cd 100644 --- a/lib/Module/Install/ReadmeFromPod.pm +++ b/lib/Module/Install/ReadmeFromPod.pm @@ -46,6 +46,9 @@ Module::Install::ReadmeFromPod - A Module::Install extension to automatically co A C<README> file will be generated from the POD of the indicated module file. +Note that the author will need to make sure C<Module::Install::ReadmeFromPod> is installed +before running the C<Makefile.PL>. (The extension will be bundled into the user-side distribution). + =head1 DESCRIPTION Module::Install::ReadmeFromPod is a L<Module::Install> extension that generates a C<README> file


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

Please report any issues with rt.cpan.org to rt-cpan-admin@bestpractical.com.