perlbug-followup at perl
Aug 10, 2013, 9:20 PM
Post #1 of 1
(15 views)
Permalink
|
|
[perl #101612] perldoc does not recognize =pod and =cut POD without other tags
|
|
On Sat Nov 19 00:35:21 2011, sprout wrote:
> On Wed Nov 16 21:34:45 2011, comdog wrote:
> > In article <rt-3.6.HEAD-5084-1321412398-1264.101612-15-0 [at] perl>,
> > "James E Keenan via RT" <perlbug-followup [at] perl> wrote:
> >
> > > On Tue Oct 18 04:11:19 2011, matti.linnanvuori [at] portalify wrote:
> > >
> > > >
> > > > perldoc does not produce any input when given a script with only
> > > > =pod and =cut tags and some text between them but prints
> > > > "No documentation found for <file>". Adding a =head1 tag
> > > > helps.
> > > > Example:
> > > > perldoc pod.t
> > > >
> > > > =pod
> > > >
> > > > Text
> > > >
> > > > =cut
> > > >
> > >
> > > I believe this has been the way =pod has worked for a long time,
perhaps
> > > always. I suspect people feel it's a feature, not a bug.
> >
> > This works just fine in my latest perldoc.
> >
>
> In BDFOY/Pod-Perldoc-3.15_09.tar.gz I have the same problem.
>
> It only occurs if there are no =head directives.
>
But as of 5.18.0 (at least), it appears to work fine:
#####
$ cat test.pod
=pod
Text; only POD directives are =pod and =cut.
=cut
#####
$ perldoc test.pod
Text; only POD directives are =pod and =cut.
/tmp/GfAr8HmD8b (END)
#####
Marking ticket resolved.
Thank you very much.
Jim Keenan
---
via perlbug: queue: perl5 status: open
https://rt.perl.org:443/rt3/Ticket/Display.html?id=101612
|
