EPOC Release 5 OPL SDK
Copyright (c) 1998-2002 Symbian Ltd

PRODUCT INFORMATION

The EPOC Release 5 OPL SDK provides a PC-hosted
development environment for rapid application development
in OPL.  It comprises EPOC Release 5 system components,
development tools including the EPOC emulator, system 
documentation and examples.

OPL (Organiser Programming Language) is a Symbian 
proprietary language with a long heritage in Psions 
Organiser range.  It provides a BASIC-like syntax, and 
its easy accessibility and shallow learning curve have 
spawned a vigorous development community.  The EPOC OPL 
SDK enhances ease of OPL programming by providing 
PC-hosted development tools and documentation.

OPL APIs provide access to the most commonly-used EPOC 
facilities.  OPL extensions (OPXs) may be written, in 
C++, to provide access to other C++ APIs, or to provide 
optimised function implementations.  To write OPXs, you 
need to the EPOC C++ SDK.  To use an OPX written by 
someone else, you need a suitable build of that OPX 
(either for the emulator, or for a target machine).

To see the full documentation, after the SDK is installed,
see \sysdoc\oindex.html.

SYSTEM REQUIREMENTS

To install and run the EPOC Release 5 OPL SDK, you will
need 
- a PC running Windows NT 4.0, Windows 95 or Windows 98
- 80MB of free space
- speed and RAM requirements as for Microsoft Windows
  installation

To install and run software on an EPOC device, you will
need
- an EPOC device using EPOC Release 1, 2 or 3, or later
  unless otherwise stated
- EPOC Connect 2.1 or above, or badged version such as 
  PsiWin, and link cable

To browse the system documentation, you will need
- a web browser which supports tables and frames, for 
  the HTML version
- a browser for HTML Help files, such as Microsoft 
  Internet Explorer 4.0 or above, for the HTML Help 
  version

If you wish to develop OPXs, you will need the EPOC 
Release 5 C++ SDK (and its PC requirements).

RELEASE NOTES

1) Installation drive must be distinct from other EPOC SDK
products

This SDK uses the \epoc32\ root directory on a root
directory of your PC.

If you have such a product, you must either delete it, or install this
SDK onto another drive. If you choose to install this SDK onto another
drive, you may need to create a logical drive. The following method is
suggested:

Make a directory, e.g. c:\epoc32a\, and use the subst
command to map this to (say) drive e:

   subst e: c:\epoc32a

You may install this subst command in your autoexec.bat or
some convenient command file that is executed prior to 
every EPOC32 development session. On Windows 95 and 
Windows NT, the subst command makes the mapped drive 
visible to all programs immediately.


Having used either of these methods to create a new logical drive
letter, run the SDK installation program (n:\opl\setup, where n:
is the letter of your CD ROM drive) and follow the instructions
on screen, selecting the installation drive to the logical drive
you have just created.

2) Emulator under Windows 95

The EPOC emulator is primarily developed and supported
under Windows NT 4.0.  Known limitations of the Emulator
under Windows 95 include

a) EPOC Spell does not exit cleanly

b) Sometimes, after a combination of applications has
   been invoked, the Emulator does not exit cleanly
  
c) Sometimes, when the Emulator is run in the Emulate
   EPOC Large mode, for example from the Start bar shortcut,
   the fascia bitmap is scrambled

3) Windows 98 support

Limited testing under Windows 98 indicates that Windows
98 issues are likely to be the same as those for Windows
95.

