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