Anonymous Monk has asked for the wisdom of the Perl Monks concerning the following question:

Run the following through pod2html (with latest Pod::Html::VERSION 1.09) 

=head1 THIS FROM Marek::Pod::HTML

THIS VALID POD

=head2 Pod directives and their translation

The following section gives an overview of the translation equivalence
+s.

=over 4

=item C<=head>I<n>

A heading is turned into a HTML heading, e.g. C<=head1> corresponds to
C<E<lt>H2E<gt>>. The C<E<lt>H1E<gt>> heading is reserved for page titl
+es.

=item S<C<=over> I<n>>, C<=item>, C<=back>

Itemized lists are turned into either C<E<lt>OLE<gt>> (numbered list),
C<E<lt>ULE<gt>> (buletted list), or C<E<lt>DLE<gt>> (definition list),
depending on whether the first item in the list starts with a digit,
a number or nothing, or anything else, respectively.

=item C<S<=for html>>, C<S<=begin html>>, C<=end>

Paragraphs starting with C<=for html> or encapsulated in
C<S<=begin html>> are parsed as HTML and included into the document.
All other C<=for>/C<=begin> paragraphs are ignored.

=item C<BE<lt>...E<gt>>

Turned into bold text using E<lt>BE<gt>...E<lt>/BE<gt>.

=item C<IE<lt>...E<gt>>

Turned into italic text using E<lt>IE<gt>...E<lt>/IE<gt>.

=item C<CE<lt>...E<gt>> C<FE<lt>...E<gt>>

Turned into monospaced (typewriter) text using 
E<lt>CODEE<gt>...E<lt>/CODEE<gt>.

=item C<EE<lt>...E<gt>>

Pod entities are mapped to the corresponding HTML characters or
entities. The most important HTML entities (e.g. C<EE<lt>copyE<gt>>)
are recognized. See also L<HTML::Entities>.

=item C<SE<lt>...E<gt>>

All whitespace in this sequence is turned into C<&nbsp;>, i.e.
non-breakable spaces.

=item C<XE<lt>...E<gt>>

=back

=cut

__END__
D:\Perl\bin/pod2html.bat: no title for pod-html-unefined-fragment-bug.
+t.
Undefined fragment 'E<...>' () from fragment_id() in emit_item_tag() i
+n pod-html-unefined-fragment-bug.t at D:/Perl/lib/Pod/Html.pm line 11
+29
    Pod::Html::emit_item_tag('C<EE<lt>...E<gt>>', 'E<...>', 1) called 
+at D:/Perl/lib/Pod/Html.pm line 1210
    Pod::Html::process_item('E<...>') called at D:/Perl/lib/Pod/Html.p
+m line 545
    Pod::Html::pod2html('pod-html-unefined-fragment-bug.t') called at 
+D:\Perl\bin/pod2html.bat line 157

[download]
  • Comment on Undefined fragment 'E<...>' () from fragment_id() in emit_item_tag()
  • Download Code

Replies are listed 'Best First'.
Re: Undefined fragment 'E<...>' () from fragment_id() in emit_item_tag()
by grinder (Bishop) on May 13, 2008 at 21:25 UTC

    Mmm, that's a bug alright. Thanks for the report. As a work around, you can use E<nnn> escapes to get around the lexing problems (specifically C<EE... C<XE... appear to cause problems):

    =item C<E<69>E<lt>...E<gt>>

Pod entities are mapped to the corresponding HTML characters or
entities. The most important HTML entities (e.g. C<EE<lt>copyE<gt>>)
are recognized. See also L<HTML::Entities>.

=item C<SE<lt>...E<gt>>

All whitespace in this sequence is turned into C<&nbsp;>, i.e.
non-breakable spaces.

=item C<E<88>E<lt>...E<gt>>

    [download]

    I'm currently dual-lifing Pod::Html and so I'll try to get this fixed for v1.10. Interestingly enough I've spent a lot of time merely writing a good test suite. I hadn't been able to tickle the code path that produces this error, so I'm grateful for your example.

    • another intruder with the mooring in the heart of the Perl

[reply]
[d/l]
Re: Undefined fragment 'E<...>' () from fragment_id() in emit_item_tag()
by moritz (Cardinal) on May 13, 2008 at 14:40 UTC
[reply]

Back to Seekers of Perl Wisdom