This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta up to 1881532246
[perl5.git] / README.irix
index de06b00..23cc17b 100644 (file)
@@ -4,7 +4,7 @@ specifically designed to be readable as is.
 
 =head1 NAME
 
-README.irix - Perl version 5 on Irix systems
+perlirix - Perl version 5 on Irix systems
 
 =head1 DESCRIPTION
 
@@ -25,7 +25,7 @@ or later compilers (use cc -version to check).
 =head2 Building 64-bit Perl in Irix
 
 Use
-       
+
        sh Configure -Dcc='cc -64' -Duse64bitint
 
 This requires require a 64-bit MIPS CPU (R8000, R10000, ...)
@@ -74,14 +74,10 @@ errors (especially with -Duse64bitall).
 =head2 Building with threads in Irix
 
 Run Configure with -Duseithreads which will configure Perl with
-the new Perl 5.8.0 "interpreter threads", see L<threads>.
-
-The old Perl 5.005 threads is obsolete, unmaintained, and its use is
-discouraged.  If you really want it, run Configure with the
--Dusethreads -Duse5005threads options as described in INSTALL.
+the Perl 5.8.0 "interpreter threads", see L<threads>.
 
-For either thread model and for Irix 6.2, you have to have the
-following patches installed:
+For Irix 6.2 with perl threads, 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
@@ -96,6 +92,43 @@ and later are okay.
     Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
     pthreads patches information.
 
+=head2 Irix 5.3
+
+While running Configure and when building, you are likely to get
+quite a few of these warnings:
+
+  ld:
+  The shared object /usr/lib/libm.so did not resolve any symbols.
+        You may want to remove it from your link line.
+
+Ignore them: in IRIX 5.3 there is no way to quieten ld about this.
+
+During compilation you will see this warning from toke.c:
+
+  uopt: Warning: Perl_yylex: this procedure not optimized because it
+        exceeds size threshold; to optimize this procedure, use -Olimit option
+        with value >= 4252.
+
+Ignore the warning.
+
+In IRIX 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in IRIX 5.3)
+the following failures are known.
+
+ Failed Test                  Stat Wstat Total Fail  Failed  List of Failed
+ --------------------------------------------------------------------------
+ ../ext/List/Util/t/shuffle.t    0   139    ??   ??       %  ??
+ ../lib/Math/Trig.t            255 65280    29   12  41.38%  24-29
+ ../lib/sort.t                   0   138   119   72  60.50%  48-119
+ 56 tests and 474 subtests skipped.
+ Failed 3/811 test scripts, 99.63% okay. 78/75813 subtests failed, 99.90% okay.
+
+They are suspected to be compiler errors (at least the shuffle.t
+failure is known from some IRIX 6 setups) and math library errors
+(the Trig.t failure), but since IRIX 5 is long since end-of-lifed,
+further fixes for the IRIX are unlikely.  If you can get gcc for 5.3,
+you could try that, too, since gcc in IRIX 6 is a known workaround for
+at least the shuffle.t and sort.t failures.
+
 =head1 AUTHOR
 
 Jarkko Hietaniemi <jhi@iki.fi>