Podify the remaining README.platform files;

merge README.plan9 and plan9/perlplan9.pod;
delete plan9/perlplan9.* (the perlplan.doc needs to
be regenerated in Plan 9); make the =head1 and =head2
in the README.platform to be a little more verbose
(skipped README.os2 not to anger Ilya) so that they
look better in the toc; regen toc.

p4raw-id: //depot/perl@10461

1 files changed, 87 insertions, 13 deletions

diff --git a/README.qnx b/README.qnx
index 0cfe3533ca..ebff5482a1 100644
--- a/README.qnx
+++ b/README.qnx
@@ -1,22 +1,96 @@
-README.qnx
+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 specially
+designed to be readable as is.
 
-Please see hints/qnx.sh for more detailed information about compiling
-perl under QNX4.
+=head1 NAME
+
+README.qnx - Perl version 5 on QNX
+
+=head1 DESCRIPTION
+
+As of perl5.004_04, all tests pass under:
+
+  QNX 4.23A
+  Watcom 10.6 with Beta/970211.wcc.update.tar.F
+  socket3r.lib Nov21 1996.
+
+Update June 2001: Perl 5.6.1 most probably also works just fine in QNX.
+
+=head2 Required Software for Compiling Perl on QNX
+
+As with many unix ports, this one depends on a few "standard"
+unix utilities which are not necessarily standard for QNX.
+
+=over 4
+
+=item /bin/sh
+
+This is used heavily by Configure and then by
+perl itself. QNX'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
+
+=item ar
+
+This is the standard unix library builder.
+We use wlib. With Watcom 10.6, when wlib is
+linked as "ar", it behaves like ar and all is
+fine. Under 9.5, a cover is required. One is
+included in ../qnx
+
+=item nm
+
+This is used (optionally) by configure to list
+the contents of libraries. I will generate
+a cover function on the fly in the UU directory.
+
+=item cpp
+
+Configure and perl need a way to invoke a C
+preprocessor. I have created a simple cover
+for cc which does the right thing. Without this,
+Configure will create it's own wrapper which works,
+but it doesn't handle some of the command line arguments
+that perl will throw at it.
+
+=item make
+
+You really need GNU make to compile this. GNU make
+ships by default with QNX 4.23, but you can get it
+from quics for earlier versions.
+
+=back
+
+=head2 Outstanding Issues with Perl on QNX
+
+There is currently no support for dynamically linked libraries.
+
+=head2 QNX auxiliary files
 
 The files in the "qnx" directory are:
 
- * "qnx/ar" is 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
-   compiling perl.  A more thorough version is available at:
+=over 4
+
+=item qnx/ar
+
+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
+compiling perl.  A more thorough version is available at:
 
 	http://www.fdma.com/pub/qnx/porting/ar
 
- * "qnx/cpp" is a script that provides C preprocessing functionality.
-   Configure can 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.
+=item qnx/cpp
+
+A script that provides C preprocessing functionality.  Configure can
+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.
+
+=back
+
+=head1 AUTHOR
 
---
 Norton T. Allen (allen@huarp.harvard.edu)
+