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

Report information
The Basics
Id:
63554
Status:
open
Priority:
Low/Low

People
Owner:
Nobody in particular
Requestors:
Cc:
AdminCc:

BugTracker
Severity:
Important
Broken in:
1.00
Fixed in:
(no value)



Subject: Module-level share is not documented in SYNOPSIS
Although it handles dist- and module-level share, it only documents the former. I'd suggest documenting both, and also providing a separate helper function (install_module_share) to to the later. This would make the API more usable (IMHO).
Show quoted text
> I'd suggest documenting both, and also providing a separate > helper function (install_module_share) to to the later. This would make > the API more usable (IMHO).
This is definately uuugly: install_module_share 'lib/Dist/Name/Mod/Sub1/Sub2/share', 'module', 'Dist::Name::Mod::Sub1::Sub2'; These would be "pretteir" install_module_share 'lib/Dist/Name/Mod/Sub1/Sub2/share'; or install_module_share 'lib::Dist::Name::Mod::Sub1::Sub2'; And... just for completeness, and self-documentation, an alias from install_share to install_dist_share would be great.
On Thu Dec 02 18:10:28 2010, MichaelRWolf@att.net wrote:
Show quoted text
> > I'd suggest documenting both, and also providing a separate > > helper function (install_module_share) to to the later. This would make > > the API more usable (IMHO).
> > This is definately uuugly: > install_module_share 'lib/Dist/Name/Mod/Sub1/Sub2/share', 'module', > 'Dist::Name::Mod::Sub1::Sub2'; > > These would be "pretteir" > > install_module_share 'lib/Dist/Name/Mod/Sub1/Sub2/share'; > or > install_module_share 'lib::Dist::Name::Mod::Sub1::Sub2'; >
Oops. I misread the code, expecting a shift on the args, when, in fact, it was a pop. Therefore, this isn't as uuugly as I had thought. install_module_share( 'module', 'Dist::Name::Mod::Sub1::Sub2', 'lib/Dist/Name/Mod/Sub1/Sub2/share'); But it could still be nicer... ... and documented.
Show quoted text
> > And... just for completeness, and self-documentation, an alias from > install_share to install_dist_share would be great. >


This service runs on Request Tracker, is sponsored by The Perl Foundation, and maintained by Best Practical Solutions.

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