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: 84627
Status: rejected
Priority: 0/
Queue: Pod-Simple
People
Owner: Nobody in particular
Requestors: mschwern [...] cpan.org
Cc:
AdminCc:
Bug Information
Severity: (no value)
Broken in: 3.26
Fixed in: (no value)

History Show all quoted text
  Sun Apr 14 11:33:12 2013 mschwern [...] cpan.org - Ticket created
Subject: perldoc won't recognize POD without a =headX
perldoc won't recognize something contains POD unless it sees a =head1 or =head2 or ... line.  Even if it contains =pod.  This seems a bit silly.

$ cat ~/tmp/test.out
=pod

This is POD!

=cut
$ perldoc -T -t ~/tmp/test.out
No documentation found for "/Users/schwern/tmp/test.out".

$ cat ~/tmp/test.out
=pod

=head1 Foo

This is POD!

=cut

$ perldoc -T -t ~/tmp/test.out
Foo
    This is POD!

Note that it will recognize a file ending in .pod as POD.  I'm not 100% sure this is in Pod::Simple and in perldoc.
  Mon Apr 15 12:13:35 2013 dwheeler [...] cpan.org - Correspondence added
Subject: Re: [rt.cpan.org #84627] perldoc won't recognize POD without a =headX
Date: Mon, 15 Apr 2013 09:13:27 -0700
To: bug-Pod-Simple [...] rt.cpan.org
From: "David E. Wheeler" <dwheeler [...] cpan.org>
On Apr 14, 2013, at 8:33 AM, "Michael G Schwern via RT" <bug-Pod-Simple@rt.cpan.org> wrote: Show quoted text
> Note that it will recognize a file ending in .pod as POD. I'm not 100% sure > this is in Pod::Simple and in perldoc.
It may be formatter-specific. Observer: Show quoted text
> cat try.out
=pod This is POD! =cut Show quoted text
> perl -MPod::Simple::HTML -e Pod::Simple::HTML::go try.out
<html><head><title></title> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" > </head> <body class='pod'> <!-- generated by Pod::Simple::HTML v3.25, using Pod::Simple::PullParser v3.25, under Perl v5.016002 at Mon Apr 15 16:11:47 2013 GMT. If you want to change this HTML document, you probably shouldn't do that by changing it directly. Instead, see about changing the calling options to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML, then reconverting this document from the Pod source. When in doubt, email the author of Pod::Simple::HTML for advice. See 'perldoc Pod::Simple::HTML' for more info. --> <!-- start doc --> <a name='___top' class='dummyTopAnchor' ></a> <p>This is POD!</p> <!-- end doc --> </body></html> Fine for HTML, not so much for XHTML: Show quoted text
> perl -MPod::Simple::XHTML -e Pod::Simple::HTML::go try.out
Yeah, nothing output. But the issue is not Pod::Simple itself, and it may also be a bug in perldoc. David
  Mon Apr 15 12:13:35 2013 The RT System itself - Status changed from 'new' to 'open'
  Fri May 03 12:20:41 2013 dwheeler [...] cpan.org - Correspondence added
On 2013-04-15 12:13:35, DWHEELER wrote: Show quoted text
> Fine for HTML, not so much for XHTML: >
> > perl -MPod::Simple::XHTML -e Pod::Simple::HTML::go try.out
> > > Yeah, nothing output. But the issue is not Pod::Simple itself, and it > may also be a bug in perldoc.
Oh, look, bug in my one-liner: It loads XHTML but calls HTML. This works: % perl -Ilib -MPod::Simple::XHTML -E 'Pod::Simple::XHTML->new->parse_string_document("=pod\n\nThis is pod!\n\n=cut\n");' <html> <head> <title></title> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> </head> <body> <p>This is pod!</p> </body> </html> So I blame perldoc.
  Fri May 03 12:20:48 2013 dwheeler [...] cpan.org - Status changed from 'open' to 'rejected'