Add README.irix/perlirix.

p4raw-id: //depot/perl@17118

7 files changed, 77 insertions, 14 deletions

diff --git a/INSTALL b/INSTALL
index 233cf28731..0cac35948f 100644
--- a/INSTALL
+++ b/INSTALL
@@ -730,18 +730,6 @@ If you decide to use ithreads, the 'threads' module allows their use,
 and the 'Thread' module offers an interface to both 5005threads and
 ithreads (whichever has been configured).
 
-For IRIX 6.2, you have to have the following patches installed:
-
-        1404 Irix 6.2 Posix 1003.1b man pages
-        1645 IRIX 6.2 & 6.3 POSIX header file updates
-        2000 Irix 6.2 Posix 1003.1b support modules
-        2254 Pthread library fixes
-        2401 6.2 all platform kernel rollup
-
-IMPORTANT: Without patch 2401, a kernel bug in IRIX 6.2 will cause
-your machine to panic and crash when running threaded perl.  IRIX 6.3
-and later are okay.
-
 =head2 Large file support.
 
 Since Perl 5.6.0, Perl has supported large files (files larger than
diff --git a/MANIFEST b/MANIFEST
index fef504ea21..8ed35fbacc 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -2250,6 +2250,7 @@ README.epoc		Notes about EPOC port
 README.freebsd		Notes about FreeBSD
 README.hpux		Notes about HP-UX port
 README.hurd		Notes about GNU/Hurd port
+README.irix		Notes about Irix port
 README.jp		About using Perl and Japanese
 README.ko		About using Perl and Korean
 README.machten		Notes about Power MachTen port
diff --git a/README.irix b/README.irix
new file mode 100644
index 0000000000..d2bcb4cf9a
--- /dev/null
+++ b/README.irix
@@ -0,0 +1,72 @@
+If you read this file _as_is_, just ignore the funny characters you
+see.  It is written in the POD format (see pod/perlpod.pod) which is
+specifically designed to be readable as is.
+
+=head1 NAME
+
+README.irix - Perl version 5 on Irix systems
+
+=head1 DESCRIPTION
+
+This document describes various features of Irix that will affect how Perl
+version 5 (hereafter just Perl) is compiled and/or runs.
+
+=head2 Building 32-bit
+
+Use
+
+	sh Configure -Dcc='cc -n32'
+
+to compile Perl 32-bit.  Don't bother with -n32 unless you have 7.1
+or later compilers (use cc -version to check).
+
+(Building 'cc -n32' is the default.)
+
+=head2 Building 64-bot
+
+Use
+	
+	sh Configure -Dcc='cc -64'
+
+to compiler Perl 64-bit.
+
+=head2 About Compiler Versions
+
+Some IRIX cc versions, e.g. 7.3.1.1m (try cc -version) have been known
+to have issues (coredumps) when compiling perl.c.  If you've used
+-OPT:fast_io=ON and this happens, try removing it.  If that fails, or
+you didn't use that, then try adjusting other optimization options
+(-LNO, -INLINE, -O3 to -O2, etcetera).  The compiler bug has been
+reported to SGI.  (Allen Smith <easmith@beatrice.rutgers.edu>)
+
+=head2 Linker Problems
+
+If you get complaints about so_locations then search in the file
+hints/irix_6.sh for "lddflags" and do the suggested adjustments.
+(David Billinghurst <David.Billinghurst@riotinto.com.au>)
+
+=head2 Malloc
+
+Do not try to use Perl's malloc, this will lead into very mysterious
+errors (especially with -Duse64bitall).
+
+=head2 Building with threads
+
+For IRIX 6.2, you have to have the following patches installed:
+
+        1404 Irix 6.2 Posix 1003.1b man pages
+        1645 IRIX 6.2 & 6.3 POSIX header file updates
+        2000 Irix 6.2 Posix 1003.1b support modules
+        2254 Pthread library fixes
+        2401 6.2 all platform kernel rollup
+
+IMPORTANT: Without patch 2401, a kernel bug in IRIX 6.2 will cause
+your machine to panic and crash when running threaded perl.  IRIX 6.3
+and later are okay.
+
+=head1 AUTHOR
+
+Jarkko Hietaniemi <jhi@iki.fi>
+
+Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
+
diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index c9e9dfc824..44a547025c 100644
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -73,6 +73,7 @@ if (-d "pod") {
     perlfreebsd             
     perlhpux            
     perlhurd            
+    perlirix            
     perlmachten         
     perlmacos
     perlmint
diff --git a/pod/perl.pod b/pod/perl.pod
index aeb4f6751b..5aee015927 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -158,6 +158,7 @@ For ease of access, the Perl manual has been split up into several sections.
     perlfreebsd		Perl notes for FreeBSD
     perlhpux		Perl notes for HP-UX
     perlhurd		Perl notes for Hurd
+    perlirix		Perl notes for Irix
     perlmachten		Perl notes for Power MachTen
     perlmacos		Perl notes for Mac OS (Classic)
     perlmint		Perl notes for MiNT
diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 51f40c9855..c3a3bb85bf 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -1527,7 +1527,7 @@ as perlI<platform>:
 
     perlaix perlamiga perlapollo perlbeos perlbs2000
     perlce perlcygwin perldgux perldos perlepoc perlfreebsd perlhpux
-    perlhurd perlmachten perlmacos perlmint perlmpeix
+    perlhurd perlirix perlmachten perlmacos perlmint perlmpeix
     perlnetware perlos2 perlos390 perlplan9 perlqnx perlsolaris
     perltru64 perluts perlvmesa perlvms perlvos perlwin32
 
diff --git a/pod/perlport.pod b/pod/perlport.pod
index bc75280da2..b3e29cc4c8 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -2197,7 +2197,7 @@ http://www.cpan.org/ports/index.html for binary distributions.
 
 L<perlaix>, L<perlamiga>, L<perlapollo>, L<perlbeos>, L<perlbs2000>,
 L<perlce>, L<perlcygwin>, L<perldgux>, L<perldos>, L<perlepoc>,
-L<perlebcdic>, L<perlfreebsd>, L<perlhurd>, L<perlhpux>,
+L<perlebcdic>, L<perlfreebsd>, L<perlhurd>, L<perlhpux>, L<perlirix>,
 L<perlmachten>, L<perlmacos>, L<perlmint>, L<perlmpeix>,
 L<perlnetware>, L<perlos2>, L<perlos390>, L<perlplan9>, L<perlqnx>,
 L<perlsolaris>, L<perltru64>, L<perlunicode>, L<perlvmesa>,