Add t/run/dtrace.pl to MANIFEST

[perl5.git] / README.solaris

diff --git a/README.solaris b/README.solaris
index 427e08d..0e6ffd9 100644 (file)
--- a/README.solaris
+++ b/README.solaris
@@ -4,7 +4,7 @@ specifically designed to be readable as is.
 
 =head1 NAME
 
-README.solaris - Perl version 5 on Solaris systems
+perlsolaris - Perl version 5 on Solaris systems
 
 =head1 DESCRIPTION
 
@@ -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.)
 
@@ -39,7 +39,7 @@ these modules is available on CPAN under the Sun::Solaris:: namespace.
 Solaris may include two versions of perl, e.g. Solaris 9 includes
 both 5.005_03 and 5.6.1.  This is to provide stability across Solaris
 releases, in cases where a later perl version has incompatibilities
-with the version included in the preceeding Solaris release.  The
+with the version included in the preceding Solaris release.  The
 default perl version will always be the most recent, and in general
 the old version will only be retained for one Solaris release.  Note
 also that the default perl will NOT be configured to search for modules
@@ -143,18 +143,25 @@ shipped with SunOS4 will not do.
 Several tools needed to build perl are located in /usr/ccs/bin/:  ar,
 as, ld, and make.  Make sure that /usr/ccs/bin/ is in your PATH.
 
-You need to make sure the following packages are installed
-(this info is extracted from the Solaris FAQ):
+
+On all the released versions of Solaris (8, 9 and 10) you need to make sure the following packages are installed (this info is extracted from the Solaris FAQ):
 
 for tools (sccs, lex, yacc, make, nm, truss, ld, as): SUNWbtool,
 SUNWsprot, SUNWtoo
 
 for libraries & headers: SUNWhea, SUNWarc, SUNWlibm, SUNWlibms, SUNWdfbh,
-SUNWcg6h, SUNWxwinc, SUNWolinc
+SUNWcg6h, SUNWxwinc
+
+Additionaly, on Solaris 8 and 9 you also need:
 
 for 64 bit development: SUNWarcx, SUNWbtoox, SUNWdplx, SUNWscpux,
 SUNWsprox, SUNWtoox, SUNWlmsx, SUNWlmx, SUNWlibCx
 
+And only on Solaris 8 you also need:
+
+for libraries & headers: SUNWolinc
+
+
 If you are in doubt which package contains a file you are missing,
 try to find an installation that has that file. Then do a
 
@@ -213,7 +220,7 @@ details.
 =head3 GNU as and GNU ld
 
 The following information applies to gcc version 2.  Volunteers to
-update it as appropropriate for gcc version 3 would be appreciated.
+update it as appropriately for gcc version 3 would be appreciated.
 
 The versions of as and ld supplied with Solaris work fine for building
 perl.  There is normally no need to install the GNU versions to
@@ -514,7 +521,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 +601,7 @@ L<http://www.cosy.sbg.ac.at/~andi/>. 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
-http://sunsolve.sun.com .
+L<http://sunsolve.sun.com> .
 
 It may be possible to use the Entropy Gathering Daemon (written in
 Perl!), available from L<http://www.lothar.com/tech/crypto/>.
@@ -609,7 +616,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