On Fri, Sep 01, 2000 at 10:03:21PM +0100, Nicholas Clark wrote:
> On Fri, Sep 01, 2000 at 03:35:49PM -0500, Jarkko Hietaniemi wrote:
> > Tick, tock, tick, tock...
>
> man perl56delta says
>
> See the section on "/www.plover.com/~mjd/perl/at-
> error.html" in the http: manpage for more details about
> the history here.
>
>
> perlpod.pod says
>
> L<name> A link (cross reference) to name
> L<name> manual page
> L<name/ident> item in manual page
> L<name/"sec"> section in other manual page
> L<"sec"> section in this manual page
> (the quotes are optional)
> L</"sec"> ditto
> same as above but only 'text' is used for output.
> (Text can not contain the characters '/' and '|',
> and should contain matched '<' or '>')
> L<text|name>
> L<text|name/ident>
> L<text|name/"sec">
> L<text|"sec">
> L<text|/"sec">
>
> so this would mean perlguts.pod's
>
> L<http://www.unicode.org/|http://www.unicode.org/>
>
> is illegal but it does work. Patch attached makes the same change for the
> instances in perlxs.pod perl56delta.pod and perlos2.pod.
> Long term would it be a better idea to ammend the rules of POD so that
> L<[a-z]+:/.*> is taken as being a URL, before the rule L<name/ident>
> is applied? I'm assuming that no man pages end in a colon - is this wise?
My understanding is that the correct markup for a URL is no
special markup at all. The POD translators are supposed to detect bare
URLs and convert them to links.
Ronald
