PERL_SRC already has brackets on VMS.

[perl5.git] / README.qnx

diff --git a/README.qnx b/README.qnx
index f59455b..5951810 100644 (file)
--- a/README.qnx
+++ b/README.qnx
@@ -8,34 +8,32 @@ README.qnx - Perl version 5 on QNX
 
 =head1 DESCRIPTION
 
 
 =head1 DESCRIPTION
 

-As of perl5.8.0 all tests pass under:
+As of perl5.7.2 all tests pass under:

 
   QNX 4.24G
   Watcom 10.6 with Beta/970211.wcc.update.tar.F
   socket3r.lib Nov21 1996.
 
 
   QNX 4.24G
   Watcom 10.6 with Beta/970211.wcc.update.tar.F
   socket3r.lib Nov21 1996.
 

-Some tests may complain under known circumstances. See
-below and hints/qnx.sh for more information.
+As of perl5.8.1 there is at least one test still failing.

 
 

-[ Perl 5.6.0 is shipping with QNX RTP (aka QNX6, Neutrino), but
-the build does not appear to be straightforward. If anyone has
-more data in this regard, please let me know.
+Some tests may complain under known circumstances.

 
 

-These notes were originally written for QNX4 and do not
-necessarily apply to Neutrino, but see hints/qnx.sh for
-more information. ] 
+See below and hints/qnx.sh for more information.

 
 

-=head2 Required Software for Compiling Perl on QNX
+Under QNX 6.2.0 there are still a few tests which fail.
+See below and hints/qnx.sh for more information.
+
+=head2 Required Software for Compiling Perl on QNX4

 
 As with many unix ports, this one depends on a few "standard"
 
 As with many unix ports, this one depends on a few "standard"

-unix utilities which are not necessarily standard for QNX.
+unix utilities which are not necessarily standard for QNX4.

 
 =over 4
 
 =item /bin/sh
 
 This is used heavily by Configure and then by
 
 =over 4
 
 =item /bin/sh
 
 This is used heavily by Configure and then by

-perl itself. QNX's version is fine, but Configure
+perl itself. QNX4's version is fine, but Configure

 will choke on the 16-bit version, so if you are
 running QNX 4.22, link /bin/sh to /bin32/ksh
 
 will choke on the 16-bit version, so if you are
 running QNX 4.22, link /bin/sh to /bin32/ksh
 


@@ -70,11 +68,23 @@ from quics for earlier versions.
 
 =back
 
 
 =back
 

-=head2 Outstanding Issues with Perl on QNX
+=head2 Outstanding Issues with Perl on QNX4

 
 There is no support for dynamically linked libraries in QNX4.
 
 
 There is no support for dynamically linked libraries in QNX4.
 

-The following tests may report errors:
+If you wish to compile with the Socket extension, you need
+to have the TCP/IP toolkit, and you need to make sure that
+-lsocket locates the correct copy of socket3r.lib. Beware
+that the Watcom compiler ships with a stub version of
+socket3r.lib which has very little functionality. Also
+beware the order in which wlink searches directories for
+libraries. You may have /usr/lib/socket3r.lib pointing to
+the correct library, but wlink may pick up
+/usr/watcom/10.6/usr/lib/socket3r.lib instead. Make sure
+they both point to the correct library, that is,
+/usr/tcptk/current/usr/lib/socket3r.lib.
+
+The following tests may report errors under QNX4:

 
 ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
 the same results. cwd calls `fullpath -t`, so if you
 
 ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
 the same results. cwd calls `fullpath -t`, so if you


@@ -85,11 +95,13 @@ lib/File/Find/taint.t will complain if '.' is in your
 PATH. The PATH test is triggered because cwd calls
 `fullpath -t`.
 
 PATH. The PATH test is triggered because cwd calls
 `fullpath -t`.
 

-ext/IO/lib/IO/t/io_sock.t: Subtest 14 is skipped due to
+ext/IO/lib/IO/t/io_sock.t: Subtests 14 and 22 are skipped due to

 the fact that the functionality to read back the non-blocking
 the fact that the functionality to read back the non-blocking

-status of a socket is not implemented in QNX's TCP/IP. This
-has been reported to QNX and it may work with later versions
-of TCP/IP.
+status of a socket is not implemented in QNX's TCP/IP. This has
+been reported to QNX and it may work with later versions of
+TCP/IP.
+
+t/io/tell.t: Subtest 27 is failing. We are still investigating.

 
 =head2 QNX auxiliary files
 
 
 =head2 QNX auxiliary files
 


@@ -103,9 +115,7 @@ A script that emulates the standard unix archive (aka library)
 utility.  Under Watcom 10.6, ar is linked to wlib and provides the
 expected interface. With Watcom 9.5, a cover function is
 required. This one is fairly crude but has proved adequate for
 utility.  Under Watcom 10.6, ar is linked to wlib and provides the
 expected interface. With Watcom 9.5, a cover function is
 required. This one is fairly crude but has proved adequate for

-compiling perl.  A more thorough version is available at:
-
-       http://www.fdma.com/pub/qnx/porting/ar
+compiling perl.

 
 =item qnx/cpp
 
 
 =item qnx/cpp
 


@@ -116,6 +126,17 @@ options that perl throws at it. This might be reasonably placed in
 
 =back
 
 
 =back
 

+=head2 Outstanding issues with perl under QNX6
+
+The following tests are still failing for Perl 5.8.1 under QNX 6.2.0:
+
+  op/sprintf.........................FAILED at test 91
+  lib/Benchmark......................FAILED at test 26
+
+This is due to a bug in the C library's printf routine.
+printf("'%e'", 0. ) produces '0.000000e+0', but ANSI requires
+'0.000000e+00'. QNX has acknowledged the bug.
+

 =head1 AUTHOR
 
 Norton T. Allen (allen@huarp.harvard.edu)
 =head1 AUTHOR
 
 Norton T. Allen (allen@huarp.harvard.edu)