This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
fix typo in src comment
[perl5.git] / README.qnx
index 9c4e39a..a1c2e92 100644 (file)
@@ -4,7 +4,7 @@ designed to be readable as is.
 
 =head1 NAME
 
 
 =head1 NAME
 
-README.qnx - Perl version 5 on QNX
+perlqnx - Perl version 5 on QNX
 
 =head1 DESCRIPTION
 
 
 =head1 DESCRIPTION
 
@@ -14,10 +14,13 @@ As of perl5.7.2 all tests pass under:
   Watcom 10.6 with Beta/970211.wcc.update.tar.F
   socket3r.lib Nov21 1996.
 
   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.
 
 
-Under QNX 6.1.0 there are still a few tests which fail.
+Some tests may complain under known circumstances.
+
+See below and hints/qnx.sh for more information.
+
+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
 See below and hints/qnx.sh for more information.
 
 =head2 Required Software for Compiling Perl on QNX4
@@ -69,9 +72,21 @@ from quics for earlier versions.
 
 There is no support for dynamically linked libraries in QNX4.
 
 
 There is no support for dynamically linked libraries in QNX4.
 
+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:
 
 The following tests may report errors under QNX4:
 
-ext/Cwd/Cwd.t will complain if `pwd` and cwd don't give
+dist/Cwd/Cwd.t will complain if `pwd` and cwd don't give
 the same results. cwd calls `fullpath -t`, so if you
 cd `fullpath -t` before running the test, it will
 pass.
 the same results. cwd calls `fullpath -t`, so if you
 cd `fullpath -t` before running the test, it will
 pass.
@@ -80,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
 
@@ -98,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
 
@@ -109,16 +124,18 @@ generate a similar cover, but it doesn't handle all the command-line
 options that perl throws at it. This might be reasonably placed in
 /usr/local/bin.
 
 options that perl throws at it. This might be reasonably placed in
 /usr/local/bin.
 
+=back
+
 =head2 Outstanding issues with perl under QNX6
 
 =head2 Outstanding issues with perl under QNX6
 
-The following tests are still failing for Perl 5.7.1 under QNX 6.1.0:
+The following tests are still failing for Perl 5.8.1 under QNX 6.2.0:
 
   op/sprintf.........................FAILED at test 91
 
   op/sprintf.........................FAILED at test 91
-  lib/1_compile......................FAILED at test 33
-  ext/IO/lib/IO/t/io_sock............FAILED at test 12
-  ext/IO/lib/IO/t/io_udp.............FAILED at test 4
+  lib/Benchmark......................FAILED at test 26
 
 
-=back
+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
 
 
 =head1 AUTHOR