RE: Blanks and underscores in html links

2011-04-26 Thread Jan Dubois 
On Tue, 26 Apr 2011, Karl Williamson wrote:
> 
> Look at
> http://search.cpan.org/~rjbs/perl-5.12.3/pod/perlsyn.pod
> 
> There is a heading in the original source
> =head2 Switch statements

If you look closely, the heading is actually:

| =head2 Switch statements
| X X X X X

Everything up to the paragraph separator is part of the headline.

> The anchor that is generated somehow on the web is
>  name="Switch_statements_"
>  >Switch statements ...
> 
> Note that the space in the original is translated into an underscore,
> and the addition of several trailing underscores.  This means that the
> link on the page that goes like
> See also L.
> 
> doesn't work, as it gets translated into
>  
> Can someone explain the trailing underscores?

The trailing underscores correspond to the spaces before and between the
X<> elements at the end of the heading.

Cheers,
-Jan

Re: Blanks and underscores in html links

2011-04-26 Thread Russ Allbery 
"Jan Dubois"  writes:
> On Tue, 26 Apr 2011, Karl Williamson wrote:

>> Look at
>> http://search.cpan.org/~rjbs/perl-5.12.3/pod/perlsyn.pod
>> 
>> There is a heading in the original source
>> =head2 Switch statements

> If you look closely, the heading is actually:

> | =head2 Switch statements
> | X X X X X

> Everything up to the paragraph separator is part of the headline.

Yeah, but they're still basically trailing whitespace.  I think this is a
(minor) bug in whatever module generated that HTML.  It should strip
trailing whitespace from the heading.

-- 
Russ Allbery (r...@stanford.edu)

RE: Blanks and underscores in html links

2011-04-26 Thread Jan Dubois 
On Tue, 26 Apr 2011, Russ Allbery wrote:
> "Jan Dubois"  writes:
> > If you look closely, the heading is actually:
> 
> > | =head2 Switch statements
> > | X X X X X
> 
> > Everything up to the paragraph separator is part of the headline.
> 
> Yeah, but they're still basically trailing whitespace.  I think this is a
> (minor) bug in whatever module generated that HTML.  It should strip
> trailing whitespace from the heading.

Oh, I agree, I was just answering the question *why* those underscores
are there.  Confirming déjà vu (from April 2010):

http://www.mail-archive.com/pod-people@perl.org/msg01285.html

Cheers,
-Jan

Re: Blanks and underscores in html links

2011-04-26 Thread David E. Wheeler 
On Apr 26, 2011, at 3:41 PM, Russ Allbery wrote:

>> Everything up to the paragraph separator is part of the headline.
> 
> Yeah, but they're still basically trailing whitespace.  I think this is a
> (minor) bug in whatever module generated that HTML.  It should strip
> trailing whitespace from the heading.

Hrm. I thought I fixed this.

  https://rt.cpan.org/Ticket/Display.html?id=56572
  
https://github.com/theory/pod-simple/commit/51a052ed53c52dc717e38e7685124a7e2023eb0

What version of Pod::Simple are you using?

Best,

David

Re: Blanks and underscores in html links

2011-04-27 Thread Karl Williamson 

On 04/26/2011 11:52 PM, David E. Wheeler wrote:

On Apr 26, 2011, at 3:41 PM, Russ Allbery wrote:


Everything up to the paragraph separator is part of the headline.


Yeah, but they're still basically trailing whitespace.  I think this is a
(minor) bug in whatever module generated that HTML.  It should strip
trailing whitespace from the heading.


Hrm. I thought I fixed this.

   https://rt.cpan.org/Ticket/Display.html?id=56572
   
https://github.com/theory/pod-simple/commit/51a052ed53c52dc717e38e7685124a7e2023eb0

What version of Pod::Simple are you using?


I wouldn't think
http://search.cpan.org/~rjbs/perl-5.12.3/pod/perlsyn.pod

would depend on my version of anything.

Re: Blanks and underscores in html links

2011-04-27 Thread David E. Wheeler 
On Apr 27, 2011, at 7:14 AM, Karl Williamson wrote:

> I wouldn't think
> http://search.cpan.org/~rjbs/perl-5.12.3/pod/perlsyn.pod
> 
> would depend on my version of anything.

Oh, right. I'll report it to Graham.

Best,

David