From a83b6f466440987720492416f8091f2530a9ab41 Mon Sep 17 00:00:00 2001 From: Jarkko Hietaniemi Date: Wed, 6 Jun 2001 23:10:00 +0000 Subject: 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 --- README.qnx | 100 +++++++++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 87 insertions(+), 13 deletions(-) (limited to 'README.qnx') 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) + -- cgit v1.2.1