Skip Menu |
 

This queue is for tickets about the podlators CPAN distribution.

Report information
The Basics
Id: 44447
Status: rejected
Priority: 0/
Queue: podlators

People
Owner: Nobody in particular
Requestors: era+rt=cpan [...] iki.fi
Cc:
AdminCc:

Bug Information
Severity: (no value)
Broken in: 1.08
Fixed in: (no value)



Subject: Nested =over lists in HTML render without nesting in Firefox
Download (untitled) / with headers
text/plain 1.3k
I noticed that Firefox renders multiple nested levels of =over as if they were all a single list. This is a readability problem where the author wanted them to render differently. For example, some of the SpamAssassin documentation pages are hard to read in Firefox -- http://spamassassin.apache.org/full/3.2.x/doc/Mail_SpamAssassin_Conf.html is a good example; searching for "example@foo" should get you to a place where a nested list of examples is displayed as if it were a new definition in the topmost definition list, and there are multiple other instances on that page which are really hard to interpret in the absence of logical indentation. I found that adding a <dd> tag before any nested <dl> in the generated HTML would fix the problem, and allow Firefox to render the indentation in the expected way. I am attaching an example input file nested-over.pod, the generated output from pod2html in nested-over.out; and a fixed, hand-edited version nested-over.html (this also has a CSS style experiment which I left in for you to review, but I don't think it's a good fix if you can put in a <dd> instead). Pod::Htmp.pm on my system has $VERSION = 1.08; -- I hope that this is the correct version number to report, and that it isn't too old. This is stock Perl 5.10 on an up-to-date Ubuntu 8.10. If this is fixed in a more recent version, I hope the repro steps are clear enough to allow you to quickly close it.
Subject: nested-over.html
No Title

outer 1
inner 1

Fnord

inner 2

Bar

Back in outer

outer 2

Foo bar.

End.

Subject: nested-over.out
Download nested-over.out
application/octet-stream 922b

Message body not shown because it is not plain text.

Subject: nested-over.pod
Download nested-over.pod
text/x-pod 131b
=over =item outer 1 =over =item inner 1 Fnord =item inner 2 Bar =back Back in outer =item outer 2 Foo bar. =back End.
Download (untitled) / with headers
text/plain 685b
On Fri Mar 20 14:39:37 2009, era wrote: Show quoted text
> I am attaching an example input file > nested-over.pod, the generated output from pod2html in nested-over.out; > and a fixed, hand-edited version nested-over.html (this also has a CSS > style experiment which I left in for you to review, but I don't think > it's a good fix if you can put in a <dd> instead).
I see now that it would have been better to use differnt names, so that RT would have displayed them inline. Here are duplicates of the two files which did not have a proper extension before. nested-over-pod.txt <- nested-over.pod # original input POD nested-over-orig.html <-- nested-over.out # original outpuf from pod2html
/tmp/nested-over.pod

outer 1
inner 1

Fnord

inner 2

Bar

Back in outer

outer 2

Foo bar.

End.

=over =item outer 1 =over =item inner 1 Fnord =item inner 2 Bar =back Back in outer =item outer 2 Foo bar. =back End.
Download (untitled) / with headers
text/plain 222b
On Fri Mar 20 14:44:10 2009, era wrote: Show quoted text
> On Fri Mar 20 14:39:37 2009, era wrote:
> > I am attaching an example input file
And here finally is a screen shot showing how Firefox 3.0.0.7 renders the two different versions.
Subject: Re: [rt.cpan.org #44447] Nested =over lists in HTML render without nesting in Firefox
Date: Fri, 20 Mar 2009 12:05:43 -0700
To: bug-podlators [...] rt.cpan.org
From: Russ Allbery <rra [...] stanford.edu>
Download (untitled) / with headers
text/plain 955b
"era via RT" <bug-podlators@rt.cpan.org> writes: Show quoted text
> On Fri Mar 20 14:39:37 2009, era wrote:
Show quoted text
>> I am attaching an example input file nested-over.pod, the generated >> output from pod2html in nested-over.out; and a fixed, hand-edited >> version nested-over.html (this also has a CSS style experiment which I >> left in for you to review, but I don't think it's a good fix if you can >> put in a <dd> instead).
> > I see now that it would have been better to use differnt names, so that > RT would have displayed them inline. Here are duplicates of the two > files which did not have a proper extension before.
I think you've got the wrong ticket queue -- podlators doesn't provide pod2html. (I'm not sure what does currently. There were something like four different modules that provided various versions of pod2html last time I looked, and I'm not sure which one "won.") -- Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>
Subject: Re: [rt.cpan.org #44447] Nested =over lists in HTML render without nesting in Firefox
Date: Fri, 20 Mar 2009 21:27:17 +0200
To: bug-podlators [...] rt.cpan.org
From: era+rt=cpan [...] iki.fi
Download (untitled) / with headers
text/plain 778b
On Fri, 20 Mar 2009 15:06:27 -0400, "rra@stanford.edu via RT" <bug-podlators@rt.cpan.org> said: Show quoted text
> <URL: http://rt.cpan.org/Ticket/Display.html?id=44447 > > > I think you've got the wrong ticket queue -- podlators doesn't provide > pod2html. (I'm not sure what does currently. There were something like > four different modules that provided various versions of pod2html last > time I looked, and I'm not sure which one "won.")
Ooops, my bad. I'm not too familiar with the maintenance infra of Perl but my hunch would be to reassign to "perl proper", whatever it's called (core?). The Pod::Html.pm source says =head1 AUTHOR tchrist which kind of sounds like very very core, doesn't it? /* era */ -- If this were a real .signature, it would suck less. Well, maybe not.
Subject: Re: [rt.cpan.org #44447] Nested =over lists in HTML render without nesting in Firefox
Date: Fri, 20 Mar 2009 13:27:39 -0700
To: bug-podlators [...] rt.cpan.org
From: Russ Allbery <rra [...] stanford.edu>
Download (untitled) / with headers
text/plain 493b
"era via RT" <bug-podlators@rt.cpan.org> writes: Show quoted text
> Ooops, my bad. I'm not too familiar with the maintenance infra of Perl > but my hunch would be to reassign to "perl proper", whatever it's called > (core?). The Pod::Html.pm source says =head1 AUTHOR tchrist which kind > of sounds like very very core, doesn't it?
Yeah, it does. I'll see if I can figure out how to get RT to put the bug in the right place. -- Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>
Subject: Re: [rt.cpan.org #44447] Nested =over lists in HTML render without nesting in Firefox
Date: Fri, 20 Mar 2009 14:17:25 -0700
To: bug-podlators [...] rt.cpan.org
From: Russ Allbery <rra [...] stanford.edu>
Download (untitled) / with headers
text/plain 1.2k
"era via RT" <bug-podlators@rt.cpan.org> writes: Show quoted text
> Queue: podlators > Ticket <URL: http://rt.cpan.org/Ticket/Display.html?id=44447 > > > On Fri, 20 Mar 2009 15:06:27 -0400, "rra@stanford.edu via RT" > <bug-podlators@rt.cpan.org> said:
>> <URL: http://rt.cpan.org/Ticket/Display.html?id=44447 > >> >> I think you've got the wrong ticket queue -- podlators doesn't provide >> pod2html. (I'm not sure what does currently. There were something like >> four different modules that provided various versions of pod2html last >> time I looked, and I'm not sure which one "won.")
> > Ooops, my bad. I'm not too familiar with the maintenance infra of Perl > but my hunch would be to reassign to "perl proper", whatever it's called > (core?). The Pod::Html.pm source says =head1 AUTHOR tchrist which kind > of sounds like very very core, doesn't it?
I checked, and unfortunately it looks like Perl itself uses an entirely separate RT installation and there isn't any way for me to transfer your ticket to the other queue. :/ I hate to ask you to do this, but could you resubmit your ticket using perlbug to get it into the main Perl bug tracking system? Sorry about the hassle. -- Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>
Subject: Re: [rt.cpan.org #44447] Nested =over lists in HTML render without nesting in Firefox
Date: Sat, 21 Mar 2009 12:10:51 +0200
To: bug-podlators [...] rt.cpan.org
From: era+rt=cpan [...] iki.fi
Download (untitled) / with headers
text/plain 742b
On Fri, 20 Mar 2009 17:55:52 -0400, "rra@stanford.edu via RT" <bug-podlators@rt.cpan.org> said: Show quoted text
> <URL: http://rt.cpan.org/Ticket/Display.html?id=44447 > > I checked, and unfortunately it looks like Perl itself uses an entirely > separate RT installation and there isn't any way for me to transfer your > ticket to the other queue. :/ I hate to ask you to do this, but could > you resubmit your ticket using perlbug to get it into the main Perl bug > tracking system? Sorry about the hassle.
Welp, facts of life, along with death, taxes, and belonging to a minority. We live with them. Thanks for your very quick responses. I'll give it another go. /* era */ -- If this were a real .signature, it would suck less. Well, maybe not.
Download (untitled) / with headers
text/plain 380b
On Sat Mar 21 06:11:06 2009, era wrote: Show quoted text
> On Fri, 20 Mar 2009 17:55:52 -0400, "rra@stanford.edu via RT" > <bug-podlators@rt.cpan.org> said:
> > you resubmit your ticket using perlbug to get it into the main Perl > > bug tracking system? Sorry about the hassle.
For the record, this is now Perl bug #64050 (haven't heard anything back yet but posting this here before I forget).
Subject: Re: [rt.cpan.org #44447] Nested =over lists in HTML render without nesting in Firefox
Date: Sat, 21 Mar 2009 13:34:52 -0700
To: bug-podlators [...] rt.cpan.org
From: Russ Allbery <rra [...] stanford.edu>
Download (untitled) / with headers
text/plain 322b
"era via RT" <bug-podlators@rt.cpan.org> writes: Show quoted text
> For the record, this is now Perl bug #64050 (haven't heard anything back > yet but posting this here before I forget).
Thanks for refiling it! Sorry I couldn't have been more direct help. -- Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

Please report any issues with rt.cpan.org to rt-cpan-admin@bestpractical.com.