README.qnx

   1 If you read this file _as_is_, just ignore the funny characters you see.
   2 It is written in the POD format (see pod/perlpod.pod) which is specially
   3 designed to be readable as is.
   4
   5 =head1 NAME
   6
   7 README.qnx - Perl version 5 on QNX
   8
   9 =head1 DESCRIPTION
  10
  11 As of perl5.004_04, all tests pass under:
  12
  13   QNX 4.23A
  14   Watcom 10.6 with Beta/970211.wcc.update.tar.F
  15   socket3r.lib Nov21 1996.
  16
  17 Update June 2001: Perl 5.6.1 most probably also works just fine in QNX.
  18
  19 =head2 Required Software for Compiling Perl on QNX
  20
  21 As with many unix ports, this one depends on a few "standard"
  22 unix utilities which are not necessarily standard for QNX.
  23
  24 =over 4
  25
  26 =item /bin/sh
  27
  28 This is used heavily by Configure and then by
  29 perl itself. QNX's version is fine, but Configure
  30 will choke on the 16-bit version, so if you are
  31 running QNX 4.22, link /bin/sh to /bin32/ksh
  32
  33 =item ar
  34
  35 This is the standard unix library builder.
  36 We use wlib. With Watcom 10.6, when wlib is
  37 linked as "ar", it behaves like ar and all is
  38 fine. Under 9.5, a cover is required. One is
  39 included in ../qnx
  40
  41 =item nm
  42
  43 This is used (optionally) by configure to list
  44 the contents of libraries. I will generate
  45 a cover function on the fly in the UU directory.
  46
  47 =item cpp
  48
  49 Configure and perl need a way to invoke a C
  50 preprocessor. I have created a simple cover
  51 for cc which does the right thing. Without this,
  52 Configure will create it's own wrapper which works,
  53 but it doesn't handle some of the command line arguments
  54 that perl will throw at it.
  55
  56 =item make
  57
  58 You really need GNU make to compile this. GNU make
  59 ships by default with QNX 4.23, but you can get it
  60 from quics for earlier versions.
  61
  62 =back
  63
  64 =head2 Outstanding Issues with Perl on QNX
  65
  66 There is currently no support for dynamically linked libraries.
  67
  68 =head2 QNX auxiliary files
  69
  70 The files in the "qnx" directory are:
  71
  72 =over 4
  73
  74 =item qnx/ar
  75
  76 A script that emulates the standard unix archive (aka library)
  77 utility.  Under Watcom 10.6, ar is linked to wlib and provides the
  78 expected interface. With Watcom 9.5, a cover function is
  79 required. This one is fairly crude but has proved adequate for
  80 compiling perl.  A more thorough version is available at:
  81
  82         http://www.fdma.com/pub/qnx/porting/ar
  83
  84 =item qnx/cpp
  85
  86 A script that provides C preprocessing functionality.  Configure can
  87 generate a similar cover, but it doesn't handle all the command-line
  88 options that perl throws at it. This might be reasonably placed in
  89 /usr/local/bin.
  90
  91 =back
  92
  93 =head1 AUTHOR
  94
  95 Norton T. Allen (allen@huarp.harvard.edu)
  96