plREADME.zip README.os2 and latest patches
plINSTL0.zip Executables for installator (should not change very often)
plINSTAL.zip Data for installator
perl_exc.zip Perl VIO and PM executables (dynamically linked)
perl_mlb.zip Main Perl library
perl_sh.zip Pdksh
perl_aou.zip Perl_ VIO executable (statically linked)
perl_blb.zip Tools to compile Perl modules
perl_inf.zip Perl manual in .INF format
perl_mam.zip Manpages for Perl modules
perl_man.zip Manpages for Perl and utilities
perl_pod.zip Source for Perl documentation
perl_ste.zip Additional Perl modules
perl_utl.zip Executables for Perl utilities

Minimal download for automatic installation:
plINSTL0.zip plINSTAL.zip perl_exc.zip

For automatic installation:
a) Do
unzip plINS*.zip
Do not unzip the rest!

b) Start install.exe, read through the invitation screen, then
pick up the components which correspond to zips you downloaded.

c) Edit the fields (all 11 of them!) to your pleasure. Take
time to read descriptions of components as well.

d) Install

(sometimes the edit_cfg.cmd window is shown in
background: you may need to Control-Esc to this window if
installation "hangs" showing this file).

e) Edit \\ to // in the "Location" field of the WWW objects in
the folder (if you plan to use them): double click + edit works on
Warp3, on Warp4 you probably need to Alt-Double-Click.

f) Keep in mind that sometimes SoftInstaller will uppercase a
chunk of your config.sys. Keep an eye on this file after a
binary install, notorious case-sensitive entries are TERM and
RCSINIT.

g) New script testperl.cmd may advice you about what is bad
with your installation (an icon is installed in the Perl folder).

h) If error happens during running edit_cfg.cmd - but see "d" -
and you managed to make SoftInstaller to ignore this error,
you may want to rerun edit_cfg.cmd later. Syntax is

edit_cfg.cmd perl.dll-dir perllib-dir perl.exe-dir

say,

edit_cfg.cmd c:\emx\dll c:/perllib/lib c:\emx\bin

Manual installation:
~~~~~~~~~~~~~~~~~~~
Follow README.os2 (or OS/2 section in .INF file)

Send your remarks to ilya@math.ohio-state.edu

The use of a camel image in conjunction with Perl is a trademark of
O'Reilly & Associates, Inc.

Older versions
~~~~~~~~~~~~~~
The structure of Perl linking has been changed. Now different
Perl OS/2 releases may coexist on the same machine - if you rename
executables so that there is no conflict of names (to enable this
names of DLLs are mungled to become something like perlE0AC.dll).

As a drawback, no backward compatibility with older modules which
contained DLLs is possible. One needs to recompile such older modules
when upgrading to a newer version of Perl. It is usually very easy to
do by using the module CPAN. To see documentation, give a command

view perl recompile

and go up a couple of times.

Glitch
~~~~~~
Due to a glitch the DLL for Term::ReadKey is missing from perl_ste.zip.

You can obtain this DLL from os2/readline.5.00553.dll.zip (unzip with
path into your site_perl directory).