develooper Front page | perl.perl5.porters | Postings from January 2011

[perl #83112] [PATCH] Pod cleanup for F<> and L<>

Thread Previous
Michael Stevens
January 31, 2011 13:56
[perl #83112] [PATCH] Pod cleanup for F<> and L<>
Message ID:
# New Ticket Created by  Michael Stevens 
# Please include the string:  [perl #83112]
# in the subject line of all future correspondence about this issue. 
# <URL: >

Add more L<> around links and F<> around filenames.
Fix one case where F<> had been incorrectly used instead of L<>.
 README.amiga   |    2 +-
 README.haiku   |    2 +-
 README.hpux    |   18 +++++++++---------
 README.os400   |    4 ++--
 README.solaris |   12 ++++++------
 README.tru64   |    2 +-
 6 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/README.amiga b/README.amiga
index 418a5fe..c86adef 100644
--- a/README.amiga
+++ b/README.amiga
@@ -67,7 +67,7 @@ Contents
 You need the Unix emulation for AmigaOS, whose most important part is
 B<ixemul.library>. For a minimum setup, get the latest versions
 of the following packages from the Aminet archives
-( ):
+( L<> ):
diff --git a/README.haiku b/README.haiku
index cbd928b..872d272 100644
--- a/README.haiku
+++ b/README.haiku
@@ -57,7 +57,7 @@ fail. This is due to bugs in Haiku's network stack implementation.
 =head1 CONTACT
 For Haiku specific problems contact the HaikuPorts developers:
 The initial Haiku port was done by Ingo Weinhold <>.
diff --git a/README.hpux b/README.hpux
index df3e6a8..a1b59de 100644
--- a/README.hpux
+++ b/README.hpux
@@ -41,7 +41,7 @@ of Perl and the updated modules.
 The official (threaded) builds from HP, as they are shipped on the
 Application DVD/CD's are available on
 for both PA-RISC and IPF (Itanium Processor Family). They are built
 with the HP ANSI-C compiler. Up till 5.8.8 that was done by ActiveState.
@@ -69,7 +69,7 @@ HP has asked the porting centre to move Open Source binaries
 from /opt to /usr/local, so binaries produced since the start
 of July 2002 are located in /usr/local.
-One of HP porting centres URL's is
+One of HP porting centres URL's is L<>
 The port currently available is built with GNU gcc.
 =head2 Compiling Perl 5 on HP-UX
@@ -122,7 +122,7 @@ ends as shown in the following table:
  | cores  |                | PA-8900/rp34x0 | 2014            |
+From L<>
  The last order date for HP 9000 systems was December 31, 2008.
@@ -272,7 +272,7 @@ support all versions of HP-UX, here is a short list
   11.31  11i v3     64   PA & IPF
 See for the full list of hardware/OS support and expected end-of-life
 =head2 Building Dynamic Extensions on HP-UX
@@ -402,16 +402,16 @@ for updates/patches. Enter "ANSI" as keyword.
 When you are going to use the GNU C compiler (gcc), and you don't have
 gcc yet, you can either build it yourself from the sources (available
-from e.g. or fetch
+from e.g. L<>) or fetch
 a prebuilt binary from the HP porting center. gcc prebuilds can be
 fetched from
 (Browse through the list, because there are often multiple versions of
 the same package available).
 Above mentioned distributions are depots. H.Merijn Brand has made prebuilt
-gcc binaries available on and/or
- for HP-UX 10.20, HP-UX 11.00, HP-UX 11.11
+gcc binaries available on L<> and/or
+L<> for HP-UX 10.20, HP-UX 11.00, HP-UX 11.11
 (HP-UX 11i v1), and HP-UX 11.23 (HP-UX 11i v2) in both 32- and 64-bit
 versions. These are bzipped tar archives that also include recent GNU
 binutils and GNU gdb.  Read the instructions on that page to rebuild gcc
@@ -481,7 +481,7 @@ HP-UX versions before 10.30 require a separate installation of a POSIX
 threads library package. Two examples are the HP DCE package, available
 on "HP-UX Hardware Extensions 3.0, Install and Core OS, Release 10.20,
 April 1999 (B3920-13941)" or the Freely available PTH package, available
-on H.Merijn's site ( The use of PTH
+on H.Merijn's site (L<>). The use of PTH
 will be unsupported in perl-5.12 and up and is rather buggy in 5.11.x.
 If you are going to use the HP DCE package, the library used for threading
diff --git a/README.os400 b/README.os400
index cd78916..0dcee2e 100644
--- a/README.os400
+++ b/README.os400
@@ -14,7 +14,7 @@ compiled and/or runs.
 By far the easiest way to build Perl for OS/400 is to use the PASE
 (Portable Application Solutions Environment), for more information see
 This environment allows one to use AIX APIs while programming, and it
 provides a runtime that allows AIX binaries to execute directly on the
 PowerPC iSeries.
@@ -105,7 +105,7 @@ There exists a port of Perl to the ILE environment.  This port, however,
 is based quite an old release of Perl, Perl 5.00502 (August 1998).
 (As of July 2002 the latest release of Perl is 5.8.0, and even 5.6.1
 has been out since April 2001.)  If you need to run Perl on ILE, though,
-you may need this older port:
+you may need this older port: L<>
 Note that any Perl release later than 5.00502 has not been ported to ILE.
 If you need to use Perl in the ILE environment, you may want to consider
diff --git a/README.solaris b/README.solaris
index cc5fbbf..342c2f6 100644
--- a/README.solaris
+++ b/README.solaris
@@ -18,7 +18,7 @@ For the most part, everything should just work.
 Starting with Solaris 8, perl5.00503 (or higher) is supplied with the
 operating system, so you might not even need to build a newer version
 of perl at all.  The Sun-supplied version is installed in /usr/perl5
-with /usr/bin/perl pointing to /usr/perl5/bin/perl.  Do not disturb
+with F</usr/bin/perl> pointing to F</usr/perl5/bin/perl>.  Do not disturb
 that installation unless you really know what you are doing.  If you
 remove the perl supplied with the OS, you will render some bits of
 your system inoperable.  If you wish to install a newer version of perl,
@@ -26,9 +26,9 @@ install it under a different prefix from /usr/perl5.  Common prefixes
 to use are /usr/local and /opt/perl.
 You may wish to put your version of perl in the PATH of all users by
-changing the link /usr/bin/perl.  This is probably OK, as most perl
+changing the link F</usr/bin/perl>.  This is probably OK, as most perl
 scripts shipped with Solaris use an explicit path.  (There are a few
-exceptions, such as /usr/bin/rpm2cpio and /etc/rcm/scripts/README, but
+exceptions, such as F</usr/bin/rpm2cpio> and F</etc/rcm/scripts/README>, but
 these are also sufficiently generic that the actual version of perl
 probably doesn't matter too much.)
@@ -514,7 +514,7 @@ directory.
 =head2 op/stat.t test 4 in Solaris
-op/stat.t test 4 may fail if you are on a tmpfs of some sort.
+F<op/stat.t> test 4 may fail if you are on a tmpfs of some sort.
 Building in /tmp sometimes shows this behavior.  The
 test suite detects if you are building in /tmp, but it may not be able
 to catch all tmpfs situations.
@@ -594,7 +594,7 @@ L<>. If you use SUNWski, make a
 symbolic link /dev/urandom pointing to /dev/random.  For more details,
 see Document ID27606 entitled "Differing /dev/random support requirements
 within Solaris[TM] Operating Environments", available at
- .
+L<> .
 It may be possible to use the Entropy Gathering Daemon (written in
 Perl!), available from L<>.
@@ -609,7 +609,7 @@ GNU ld gets very unhappy and spews a lot of errors like this
   ... relocation truncated to fit: BASE13 ...
 and dies.  Therefore the SunOS 4.1 hints file explicitly sets the
-ld to be /usr/bin/ld.
+ld to be F</usr/bin/ld>.
 As of Perl 5.8.1 the dynamic loading of libraries (DynaLoader, XSLoader)
 also seems to have become broken in in SunOS 4.x.  Therefore the default
diff --git a/README.tru64 b/README.tru64
index 6961a0e..618c574 100644
--- a/README.tru64
+++ b/README.tru64
@@ -106,7 +106,7 @@ and then using the BerkeleyDB module from CPAN instead of DB_File.
 The BerkeleyDB works with Berkeley DB versions 2.* or greater.
 The Berkeley DB 4.1.25 has been tested with Tru64 V5.1A and found
-to work.  The latest Berkeley DB can be found from F<>.
+to work.  The latest Berkeley DB can be found from L<>.
 =head2 64-bit Perl on Tru64

Thread Previous Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About