Skip Menu |

Preferred bug tracker

Please visit the preferred bug tracker to report your issue.

This queue is for tickets about the File-Which CPAN distribution.

Report information
The Basics
Id: 101893
Status: resolved
Priority: 0/
Queue: File-Which

People
Owner: Nobody in particular
Requestors: ether [...] cpan.org
Cc:
AdminCc:

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



Subject: documentation: compare to Devel::CheckBin
Should have a 'SEE ALSO' section in pod referring to Devel::CheckBin, and explain what is different about this module compared to that one. When would I choose each one?
On 2015-02-02 20:04:14, ETHER wrote: Show quoted text
> Should have a 'SEE ALSO' section in pod referring to Devel::CheckBin, > and explain what is different about this module compared to that one. > When would I choose each one?
I think this is clear: the Devel::* modules are typically used in a development environment. e.g. in a Makefile.PL/Build.PL. Judging from the name, File::Which is universal. Also, shouldn't Devel::CheckBin have this Pod section, as this one is the newcomer? Regards, Slaven
On 2015-02-02 22:46:40, SREZIC wrote: Show quoted text
> On 2015-02-02 20:04:14, ETHER wrote:
> > Should have a 'SEE ALSO' section in pod referring to Devel::CheckBin, > > and explain what is different about this module compared to that one. > > When would I choose each one?
> > I think this is clear: the Devel::* modules are typically used in a > development environment. e.g. in a Makefile.PL/Build.PL. Judging from > the name, File::Which is universal. Also, shouldn't Devel::CheckBin > have this Pod section, as this one is the newcomer?
They both should document the differences, sure. I don't think the difference is obvious, as I've seen File::Which also used in a Makefile.PL. (Also, Devel::CheckBin is used in runtime code.) I'm still not sure where I should use one over the other. :)
I am adding a SEE ALSO section that will be included in the next version.