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?

Nicholas Clark

--- pod/perlxs.pod.orig Tue Aug 29 20:59:59 2000
+++ pod/perlxs.pod      Fri Sep  1 21:52:25 2000
@@ -72,7 +72,7 @@
 
 Note: For some extensions, Dave Beazley's SWIG system may provide a
 significantly more convenient mechanism for creating the extension glue
-code. See L<http://www.swig.org> for more 
+code. See L<http://www.swig.org/|http://www.swig.org/> for more 
 information.
 
 =head2 On The Road
--- pod/perl56delta.pod.orig    Tue Aug 29 20:59:59 2000
+++ pod/perl56delta.pod Fri Sep  1 21:52:10 2000
@@ -790,8 +790,8 @@
 This warns you that C<"[EMAIL PROTECTED]"> is going to turn into
 C<fred.com> if you don't backslash the C<@>.
 
-See L<http://www.plover.com/~mjd/perl/at-error.html> for more details
-about the history here.
+See 
+L<http://www.plover.com/~mjd/perl/at-error.html|http://www.plover.com/~mjd/perl/at-error.html>
+for more details about the history here.
 
 =head1 Modules and Pragmata
 
--- pod/perlos2.pod.orig        Mon Aug 14 23:37:24 2000
+++ pod/perlos2.pod     Fri Sep  1 21:51:53 2000
@@ -724,7 +724,8 @@
 =head1 BUILD
 
 Here we discuss how to build Perl under OS/2. There is an alternative
-(but maybe older) view on L<http://www.shadow.net/~troc/os2perl.html>.
+(but maybe older) view on
+L<http://www.shadow.net/~troc/os2perl.html|http://www.shadow.net/~troc/os2perl.html>.
 
 =head2 Prerequisites
 

Reply via email to