Closed p5pRT closed 18 years ago
This is a bug report for perl from bgstewart@covad.net\, generated with the help of perlbug 1.35 running under perl v5.8.8.
----------------------------------------------------------------- Pod::Html generates bad links for multiple-line =head# paragraphs that include X\<> elements. Other directives that generate HTML Anchors may exhibit the same problem.
An example from perlop.pod in the base documentation:
=head2 Operator Precedence and Associativity
X\<operator\, precedence> X\
produces: \
rather than the more useful: \
I believe the problem lies in sub dpod1 as indicated below.
Thanks. Bruce Stewart
sub depod1($;$$){
my( $rstr\, $func\, $closing ) = @_;
my $res = '';
return $res unless defined $$rstr;
if( ! defined( $func ) ){
# skip to next begin of an interior sequence
while( $$rstr =~ s/\A(.*?)([BCEFILSXZ])\<(\<+[^\S\n]+)?// ){
# previous line should be
# while( $$rstr =~ s/\A(.*?)([BCEFILSXZ])\<(\<+[^\S\n]+)?//s ){
#
# recurse into its text
$res .= $1 . depod1( $rstr\, $2\, closing $3);
}
$res .= $$rstr;
} elsif( $func eq 'E' ){
# E\
Moin\,
----------------------------------------------------------------- Pod::Html generates bad links for multiple-line =head# paragraphs that include X\<> elements. Other directives that generate HTML Anchors may exhibit the same problem.
An example from perlop.pod in the base documentation:
=head2 Operator Precedence and Associativity X\<operator\, precedence> X\
X\
As far as I know POD\, there should be an empty line after the =head2. I
think this is a bug in the POD\, not the converter.
Attached is what "podcheck" has to say.
Pod::Simple doesn't report any errors or warnings\, tho.
Best wishes\,
Tels
-- Signed on Sat Apr 29 16:30:21 2006 with key 0x93B84C15. Visit my photo gallery at http://bloodgate.com/photos/ PGP key on http://bloodgate.com/tels.asc or per email.
"Our second big loss has been the "IP" fudge\, which is blurring the distinctions between patents\, copyrights\, trademarks\, trade secrets\, competative advantages\, wishful thinking\, bullshit\, and marketing babble into one vague pile of lawyer poo." -- MarkusQ (450076)\, 2004-01-23
*** WARNING: multiple occurrence of link target 'tr' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '\n' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'quote\, double' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'backtick' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '-' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '\r' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'list operator' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '*' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '//' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '"' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '(TYPE)' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '/m' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '''' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '\<\<' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'qq' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '&' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '`' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'operator\, logical\, and' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'qx' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'qr' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '/i' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '""' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'm' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '/s' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '/x' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'operator\, logical\, or' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'q' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '/c' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '``' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '+' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target ''' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target '/o' at line - in file blead/pod/perlop.pod *** WARNING: multiple occurrence of link target 'qw' at line - in file blead/pod/perlop.pod blead/pod/perlop.pod pod syntax OK.
The RT System itself - Status changed from 'new' to 'open'
Tels \nospam\-abuse@​bloodgate\.com writes:
Moin\,
----------------------------------------------------------------- Pod::Html generates bad links for multiple-line =head# paragraphs that include X\<> elements. Other directives that generate HTML Anchors may exhibit the same problem.
An example from perlop.pod in the base documentation:
=head2 Operator Precedence and Associativity X\<operator\, precedence> X\
X\ As far as I know POD\, there should be an empty line after the =head2. I
think this is a bug in the POD\, not the converter.
That would make the X\<> sequences part of the following paragraph instead of part of the heading. I believe the intention is that they be part of the heading.
So far as I know\, this is valid POD\, if unusual.
-- Russ Allbery (rra@stanford.edu) \<http://www.eyrie.org/~eagle/>
On Fri\, Apr 28\, 2006 at 03:12:29PM -0700\, bgstewart@covad.net wrote:
# New Ticket Created by bgstewart@covad.net # Please include the string: [perl #39020] # in the subject line of all future correspondence about this issue. # \<URL: https://rt-archive.perl.org/perl5/Ticket/Display.html?id=39020 >
This is a bug report for perl from bgstewart@covad.net\, generated with the help of perlbug 1.35 running under perl v5.8.8.
----------------------------------------------------------------- Pod::Html generates bad links for multiple-line =head# paragraphs that include X\<> elements. Other directives that generate HTML Anchors may exhibit the same problem.
An example from perlop.pod in the base documentation:
=head2 Operator Precedence and Associativity X\<operator\, precedence> X\
X\ produces: \
\Operator Precedence and Associativity \\
rather than the more useful: \
\Operator Precedence and Associativity \\
I believe the problem lies in sub dpod1 as indicated below.
This problem was fixed with a combination of Changes #27832 and #27847 in bleadperl.
Steve Peters steve@fisharerojo.org
@smpeters - Status changed from 'open' to 'resolved'
Migrated from rt.perl.org#39020 (status was 'resolved')
Searchable as RT39020$