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