[prev in list] [next in list] [prev in thread] [next in thread] 

List:       perl5-porters
Subject:    Re: POD URL Links [Was: illguts-0.10]
From:       Ricardo Signes <perl.p5p () rjbs ! manxome ! org>
Date:       2009-11-30 23:02:28
Message-ID: 20091130230227.GA19543 () cancer ! codesimply ! com
[Download RAW message or body]

* "David E. Wheeler" <david@kineticode.com> [2009-11-30T13:14:54]
> I discovered it while fixing bugs earlier this month). perlpod says:
> 
> >Links to an absolute URL.  For example, "L<http://www.perl.org/>".
> >But note that there is no corresponding "L<text|scheme:...>"
> >syntax, for various reasons.
> 
> Anyone know what those reasons might be?

Mostly "L<> is hard, let's go shopping."  I mean, L<> is hard, and there may
have been specific pathological cases -- but I do not know of any yet.
perlpodspec says:

  Authors wanting to link to a particular (absolute) URL, must do so
  only with "L<scheme:...>" codes (like L<http://www.perl.org>), and
  must not attempt "L<Some Site Name|scheme:...>" codes.  This
  restriction avoids many problems in parsing and rendering L<...>
  codes.

Quite some time ago, someone proposed l<> to allow proper hyperlinking with
simpler semantics, but obviously nothing came of it.  If you'd like to take
this discussion to pod-people, we can see if we can do something about fixing
this somehow.

-- 
rjbs
[prev in list] [next in list] [prev in thread] [next in thread]