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: 41995
Status: open
Priority: 0/
Queue: Pod-Simple
People
Owner: Nobody in particular
Requestors: REHSACK [...] cpan.org
Cc:
AdminCc:
Bug Information
Severity: Wishlist
Broken in: 3.07
Fixed in: (no value)
Attachments
patch-aa
pod_simple_select.patch

History Show all quoted text
  Sun Dec 28 07:49:01 2008 REHSACK [...] cpan.org - Ticket created
Subject: Enhance Pod::Simple to support select() like Pod::Parser
Since we updated to perl-5.10, we got a problem with our "modular help output", because Pod::Text is now derived from Pod::Simple and doesn't support select() anymore as it does in perl-5.8 series. I tried to add a Pod::Simple::Select as a preview how a select() implementation could look like - but of course a better solution would be an integration in the parsing backend.
Subject: patch-aa
Download patch-aa
application/octet-stream 20.2k

Message body not shown because it is not plain text.

  Sun Dec 28 07:54:47 2008 REHSACK [...] cpan.org - Correspondence added
On So. 28. Dez. 2008, 07:49:01, REHSACK wrote: Show quoted text
> Since we updated to perl-5.10, we got a problem with our "modular help > output", because Pod::Text is now derived from Pod::Simple and doesn't > support select() anymore as it does in perl-5.8 series. > I tried to add a Pod::Simple::Select as a preview how a select() > implementation could look like - but of course a better solution would > be an integration in the parsing backend.
I created a similar ticket for podlators (see https://rt.cpan.org/Ticket/Display.html?id=41996), because this affects both modules ...
  Sun Dec 28 07:54:48 2008 REHSACK [...] cpan.org - Status changed from 'new' to 'open'
  Mon Dec 28 08:16:32 2009 REHSACK [...] cpan.org - Correspondence added
Great to see that Pod::Simple is actively maintained again. Might I (even if open bugs are hidden since P:S 3.11) ask if someone would take care of this issue?
  Mon Dec 28 12:38:30 2009 dwheeler [...] cpan.org - Correspondence added
Subject: Re: [rt.cpan.org #41995] Enhance Pod::Simple to support select() like Pod::Parser
Date: Mon, 28 Dec 2009 09:38:10 -0800
To: bug-Pod-Simple [...] rt.cpan.org
From: "David E. Wheeler" <dwheeler [...] cpan.org>
On Dec 28, 2009, at 5:16 AM, Jens Rehsack via RT wrote: Show quoted text
> Great to see that Pod::Simple is actively maintained again. Might I (even if > open bugs are hidden since P:S 3.11) ask if someone would take care of this > issue?
Looks as though you could release a standalone module for this, no? Best, David
  Mon Dec 28 15:21:55 2009 rehsack [...] web.de - Correspondence added
Subject: Re: [rt.cpan.org #41995] Enhance Pod::Simple to support select() like Pod::Parser
Date: Mon, 28 Dec 2009 20:18:10 +0000
To: bug-Pod-Simple [...] rt.cpan.org
From: Jens Rehsack <rehsack [...] web.de>
On 12/28/09 17:38, David Wheeler via RT wrote: Show quoted text
> <URL: https://rt.cpan.org/Ticket/Display.html?id=41995> > > On Dec 28, 2009, at 5:16 AM, Jens Rehsack via RT wrote: >
>> Great to see that Pod::Simple is actively maintained again. Might I (even if >> open bugs are hidden since P:S 3.11) ask if someone would take care of this >> issue?
> > Looks as though you could release a standalone module for this, no?
Not really. I just created a hack to show what I mean - but as written in open statement, it's required to get reasonable support in Pod::Text and Pod::Man - which is patched there in and is not usable out-of-the-box. If you say, it's impossible to add such support to Pod::Simple, than an additional module would be the only remaining solution. Does it makes sense? Pod::Text [-> Pod::Simple::Select] -> Pod::Simple. This would be a new module dependency - for a feature add. I don't think it makes sense to create a new module for this. Best regards, Jens
  Mon Dec 28 21:54:22 2009 RRA [...] cpan.org - Correspondence added
On Mon Dec 28 15:21:55 2009, rehsack@web.de wrote:
Show quoted text
> On 12/28/09 17:38, David Wheeler via RT wrote:

Show quoted text
>> Looks as though you could release a standalone module for this, no?

Show quoted text
> Not really. I just created a hack to show what I mean - but as written
> in open statement, it's required to get reasonable support in Pod::Text
> and Pod::Man - which is patched there in and is not usable out-of-the-box.

It's a little nicer on the podlators side if the feature were supported directly
by Pod::Simple.  If I support it in Pod::Man or Pod::Text in the most
straightforward way, it would pull the new module into core anyway.

See the select() method of Pod::Usage, which currently extends
Pod::Simple in the same way in order to accomplish something similar,
but inherits from Pod::Text to do it, making it unsuitable for applications
that want to use a different formatting module.
  Mon Dec 28 21:56:24 2009 dwheeler [...] cpan.org - Correspondence added
Subject: Re: [rt.cpan.org #41995] Enhance Pod::Simple to support select() like Pod::Parser
Date: Mon, 28 Dec 2009 18:56:08 -0800
To: bug-Pod-Simple [...] rt.cpan.org
From: "David E. Wheeler" <dwheeler [...] cpan.org>
On Dec 28, 2009, at 6:54 PM, Russ_Allbery via RT wrote: Show quoted text
> It's a little nicer on the podlators side if the feature were supported > directly > by Pod::Simple. If I support it in Pod::Man or Pod::Text in the most > straightforward way, it would pull the new module into core anyway. > > See the select() method of Pod::Usage, which currently extends > Pod::Simple in the same way in order to accomplish something similar, > but inherits from Pod::Text to do it, making it unsuitable for applications > that want to use a different formatting module.
Happy to take a patch (with tests). It's not something personally know anything about, and so wouldn't be a good choice to do an implementation. Best, David
  Tue Apr 20 12:24:52 2010 dwheeler [...] cpan.org - Status changed from 'open' to 'stalled'
  Fri Sep 27 18:08:22 2013 florent.angly [...] gmail.com - Correspondence added
Hi, I also find myself in the need for a Pod::Simple::Select module. I played around a bit, trying to implement a module that subclasses Pod::Simple. My main concern is that it is inefficient to have Pod::Simple do an extensive parsing of the Pod, and then add a layer to reformat these results as a POD document. Any idea? Florent
  Fri Sep 27 18:08:23 2013 The RT System itself - Status changed from 'stalled' to 'open'
  Mon Oct 07 01:32:10 2013 florent.angly [...] gmail.com - Correspondence added
Here is my implementation of Pod::Simple::Select.
Subject: pod_simple_select.patch

Message body is not shown because it is too large.

  Mon Oct 07 13:03:57 2013 dwheeler [...] cpan.org - Correspondence added
On 2013-10-07 01:32:10, FANGLY wrote: Show quoted text
> Here is my implementation of Pod::Simple::Select.
Thanks. Seems like a lot of extra stuff still, though. What's with all the .pm files added to the `t` directory? Are those really necessary? There are already .pod files there to use for tests… Thanks, David
  Mon Oct 07 13:04:05 2013 dwheeler [...] cpan.org - Status changed from 'open' to 'stalled'
  Wed May 23 17:14:00 2018 khw [...] cpan.org - Correspondence added
On Mon Oct 07 11:03:57 2013, DWHEELER wrote: Show quoted text
> On 2013-10-07 01:32:10, FANGLY wrote:
> > Here is my implementation of Pod::Simple::Select.
> > Thanks. Seems like a lot of extra stuff still, though. What's with all > the .pm files added to the `t` directory? Are those really necessary? > There are already .pod files there to use for tests… > > Thanks, > > David
Independently of this, and apparently without knowledge of this patch, an effort was mounted to extract the raw pod inheriting from Pod::Simple. That effort is nearly complete, and it seems to me that we should go ahead and release that. It also seems to me that it would be pretty easy to add a select feature once this is done.
  Wed May 23 17:14:02 2018 The RT System itself - Status changed from 'stalled' to 'open'
  Wed May 22 11:36:50 2019 khw [...] cpan.org - Correspondence added
On Wed May 23 15:14:00 2018, khw wrote: Show quoted text
> On Mon Oct 07 11:03:57 2013, DWHEELER wrote:
> > On 2013-10-07 01:32:10, FANGLY wrote:
> > > Here is my implementation of Pod::Simple::Select.
> > > > Thanks. Seems like a lot of extra stuff still, though. What's with > > all > > the .pm files added to the `t` directory? Are those really necessary? > > There are already .pod files there to use for tests… > > > > Thanks, > > > > David
> > Independently of this, and apparently without knowledge of this patch, > an effort was mounted to extract the raw pod inheriting from > Pod::Simple. That effort is nearly complete, and it seems to me that > we should go ahead and release that. It also seems to me that it > would be pretty easy to add a select feature once this is done.
That effort is finally complete. Pod::Simple::JustPod is in version 3.36 now available from CPAN. If someone really wants this functionality, that would be the place to start from. This bug tracker is mostly obsolete, and I've opened an issue in the new one for this enhancement request https://github.com/perl-pod/pod-simple/issues/96 Future correspondence should go there, and you can subscribe to it to get updates