Welcome to the OPL User Guide
*****************************

The documents contained in this directory constitute a full guide to programming in OPL
on your Psion machine. They are distributed in Adobe Acrobat Portable Document Format
(also known as PDF), and should be read using PDF reader software compatible with Adobe
Acrobat Reader version 3.0 or higher.

Contents
========
This file contains the following sections:

1. Obtaining PDF Reader software.

2. Installing Acrobat Reader.

3. Viewing the OPL User Guide.

4. About the User Guide index.

5. Using the index.


1. Obtaining PDF reader software
================================
· If you have a copy of PsiWin 2.x on CD-ROM, it will contain a Self-Extracting Archive
  of Adobe Acrobat Reader for Windows. Running the PsiWin installation will have copied
  this across to your PC, and should be found in the directory where you installed 
  PsiWin. (The standard location for this is C:\Program Files\Psion\PsiWin.)

· The Psion Web site contains links to Adobe's Web site for downloading Adobe Acrobat Reader.
  This is available for a wide range of machines. For more information, go to
  http://www.psion.com/ on the World Wide Web.

Note: If you want to use the full index to the OPL User Guide, please ensure you have
      Acrobat Reader with Search. To check what version of Acrobat Reader you
      have, click on the 'Tools' menu in the Reader. If there is a 'Search' command on the
      menu, you have the appropriate version of Acrobat Reader. Without the Search facility,
      you can still view all the documentation on programming in OPL, but you will not be
      able to perform cross-document searches on specific subjects.


2. Installing Acrobat Reader
============================
To install Acrobat Reader, double-click on the Adobe Acrobat Reader archive and follow the
on-screen instructions.

For information on using Acrobat Reader, please refer to Adobe's own Online Guide. You can
access this by starting Acrobat Reader, then selecting the appropriate command on the 'Help'
menu.


3. Viewing the OPL User Guide
=============================
The OPL User Guide is split into a number of sections according to subject matter.
For an overview of the sections and an introduction to using the guide, open the
"Welcome.pdf" file.


4. About the User Guide index
=============================
When you extract the OPL User Guide archive of files, a number of files and folders
besides the PDF files are created. These files are form an index of the whole body of OPL
documentation, and enable you to search through all of the PDF documents for information
on a particular subject.

Note: In order to be able to search the complete OPL User Guide, you need to be using
      Adobe Acrobat Reader with Search. To check what version of Acrobat Reader you
      have, click on the 'Tools' menu in the Reader. If there is a 'Search' command on the
      menu, you have the appropriate version of Acrobat Reader. If there is no 'Search' command
      on the 'Tools' menu, you can get an appropriate version of Adobe Acrobat Reader from Adobe's
      Web site "http://www.adobe.com/", or via the link at Psion's Web site "http://www.psion.com/".


5. Using the index
==================
Before performing searches using the User Guide Index, you need to 'attach' the appropriate index.

To do this:
-----------

1. Open one of the OPL User Guide PDF files in Acrobat Reader with Search.

2. Select 'Search -> Indexes' on the 'Tools' menu.

3. Click on the 'Add' button in the 'Index selection' dialog. In the file browsing window, move to
   the folder which contains all the OPL documentation.

4. Select the file 'OPLindex.pdx' and click on the 'Open' button. You should now have a box marked
   'OPL User Guide index' ticked in the 'Index selection' dialog. Make sure there aren't any other
   boxes ticked in this dialog and click the 'OK' button.

Note: You should not move or delete any of the files in the OPLindex folder which is created when
      extract the archive of the OPL User Guide. Doing this will prevent the index from working
      properly.


You will now be able to search the full body of OPL documentation.

To do this:
-----------

1. Open one of the OPL User Guide PDF files in Acrobat Reader with Search.

2. Select 'Search -> Query' on the 'Tools' menu.

3. Enter the text you want to find in the 'Adobe Acrobat Search' dialog, and click on 'Search'.

4. After a short while, Acrobat Reader will display a list of all the files containing the text
   you ran a search for. Double-click on any of these to display the page in which the text occurred.

Tip:  To display your list of results again, select 'Search -> Results' on the 'Tools' menu.

For more information about using Acrobat Reader's Search facility, please see the online
documentation provided by Adobe.



Document Version: 1.00
Adobe and Acrobat are trademarks of Adobe Systems Incorporated.
Copyright Psion Computers 1997.
Copyright Psion Software 1997.
All trademarks are acknowledged.
Date: 24.11.97.