[perl5.git] / 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.

=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:

=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

=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)
Commit	Line	Data
a83b6f46 JH	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.
ff68c719	4
a83b6f46 JH	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
ff68c719	69
	70	The files in the "qnx" directory are:
	71
a83b6f46 JH	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:
ff68c719	81
	82	http://www.fdma.com/pub/qnx/porting/ar
	83
a83b6f46 JH	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
ff68c719	94
ff68c719	95	Norton T. Allen (allen@huarp.harvard.edu)
a83b6f46	96