Skip Menu |

Preferred bug tracker

Please visit the preferred bug tracker to report your issue.

This queue is for tickets about the Pod-Simple CPAN distribution.

Report information
The Basics
Id: 80082
Status: rejected
Priority: 0/
Queue: Pod-Simple

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

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



Subject: Laborious ain't working hard enough
The laborious option to Pod::Simple::Search is slightly mis-documented. It claims that "Turning on this option will disable the heuristics for seeing only files with Perl-like extensions", but that's not strictly true as even with the option enabled this check is made: unless (m/\.(pod|pm|plx?)\z/i || -x _ and -T _) It'd be nice if the doc was updated and even nicer if there was a laborious_harder option which skipped filename/permission checks like the above and essentially passed all files through limitre and then - Show quoted text
>contains_pod.
I meant to mention that this is _particularly_ annoying for files explicitly listed in the args to ->survey, since those files more likely than not contain POD.
On 2012-10-09 16:39:05, TSIBLEY wrote: Show quoted text
> I meant to mention that this is _particularly_ annoying for files > explicitly listed in the args to ->survey, since those files more likely > than not contain POD.
Would you like to suggest alternate wording, or submit a patch changing it or adding another option? At this point I daresay you know more about it than I do. I agree that there doesn't appear to be much difference. In fact, at a glance, laborious looks even stricter (it's just more laborious because it `stat`s the file).
On Wed Feb 13 16:30:41 2013, DWHEELER wrote: Show quoted text
> On 2012-10-09 16:39:05, TSIBLEY wrote:
> > I meant to mention that this is _particularly_ annoying for files > > explicitly listed in the args to ->survey, since those files more > > likely > > than not contain POD.
> > Would you like to suggest alternate wording, or submit a patch > changing it or adding another > option? At this point I daresay you know more about it than I do. I > agree that there doesn't > appear to be much difference. In fact, at a glance, laborious looks > even stricter (it's just more > laborious because it `stat`s the file).
I'm getting ready to issue a new version of Pod::Simple. This would be the best time possible in the near future to get your desired changes in.
Subject: Re: [rt.cpan.org #80082] Laborious ain't working hard enough
Date: Fri, 25 May 2018 22:29:40 -0700
To: bug-Pod-Simple [...] rt.cpan.org
From: Thomas Sibley <tsibley [...] cpan.org>
On 05/23/2018 01:28 PM, Karl Williamson via RT wrote: Show quoted text
> I'm getting ready to issue a new version of Pod::Simple. This would be > the best time possible in the near future to get your desired changes in.
Thanks for reaching out about this, Karl!  Unfortunately, I don't have the cycles to write this patch right now.  Are you interested in doing so?  I think at the least a doc patch to better describe the "laborious" option would be good.  Even better would be an additional patch that added an option to stop all heuristic filtering and just inspect the list of files given for POD.  I should have just written these patches 5 or 6 years ago!  :-) Whatever the outcome, thanks for your work on this important module in the Perl ecosystem. Thomas
Subject: Re: [rt.cpan.org #80082] Laborious ain't working hard enough
Date: Sat, 26 May 2018 12:17:57 -0600
To: bug-Pod-Simple [...] rt.cpan.org
From: Karl Williamson <public [...] khwilliamson.com>
On 05/25/2018 11:38 PM, Thomas Sibley via RT wrote: Show quoted text
> Queue: Pod-Simple > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=80082 > > > On 05/23/2018 01:28 PM, Karl Williamson via RT wrote:
>> I'm getting ready to issue a new version of Pod::Simple. This would be >> the best time possible in the near future to get your desired changes in.
> > Thanks for reaching out about this, Karl!  Unfortunately, I don't have > the cycles to write this patch right now.  Are you interested in doing > so?  I think at the least a doc patch to better describe the "laborious" > option would be good.  Even better would be an additional patch that > added an option to stop all heuristic filtering and just inspect the > list of files given for POD.  I should have just written these patches 5 > or 6 years ago!  :-) > > Whatever the outcome, thanks for your work on this important module in > the Perl ecosystem. > > Thomas >
I'd have to get up to speed on it, so I'm unlikely to do it, as I have many other things to do.
Since no one has the tuits or interest in doing this, I'm closing the ticket. This queue is no longer the place to track tickets for this module.