AldurDlg OPX, v1.13 Copyright 2003-6 Graham L. Holden AldurDlg is an OPX that provides extended Dialog handling functions for OPL programmers. INSTALLATION ============ AldurDlg is delivered as two pairs of EPOC Installation (.SIS) files. The first file of each pair is intended for OPL developers' use while writing applications that will make use of AldurDlg.Opx. The second file of each pair is designed for redistribution to developers' end-users as part of the application's installation process. Both of these two installation files come in two flavours. One flavour is intended for development or deployment on real EPOC devices (e.g. 5mx or Revo); the other flavour is targeted for the PC-based EPOC Emulator but is otherwise identical. Development ----------- Install either or both of AldurDlgDEV.SIS (on a Psion) and AldurDlgDEV-WINS.SIS (on the Emulator) depending on where you intend doing your development work. The following files will be installed on the chosen installation drive of your system: \System\Opl\AldurDlg.oxh \System\Opx\AldurDlg.opx \AldurSoft\AldurDlgOpx.hlp \AldurSoft\AldurDlgDemo The file AldurDlg.oxh provides the interface to the functions implemented in AldurDlg.oxh. The file AldurDlg.hlp describes how to use the OPX, and AldurDlgDemo is an OPL program demonstrating some of the OPX's features. To use the OPX, add the following line near the top of you OPL source code: Include "AldurDlg.oxh" and start writing your application. Distribution ------------ If you intend distributing your application to others, you will need to ensure that your end-users get AldurDlg.opx installed on their machines. To do this, you will need to include AldurDlg.SIS with your distribution. If you are going to package your application in a .SIS file, you can simply include AldurDlg.SIS as one of its components. This will ensure that as your application is installed, AldurDlg is installed as well. If you distribute your application as discrete files, you will need to include AldurDlg.SIS among them. Your end-user installation instructions will need to direct your users to install AldurDlg.SIS. On no account should you just include the AldurDlg.opx file in your package, either as a component of a .SIS file or as a standalone file. Doing this would bypass the version-control system that EPOC uses and may result in your package overwriting a newer version of AldurDlg.opx with an older one. Installing AldurDlg.SIS on your users' machines will install the following files to their chosen drive: \System\Opl\AldurDlg.oxh \System\Opx\AldurDlg.opx If you intend to make your application available for use with the PC-based Emulator, you should follow the instructions above, but use AldurDlg-WINS.SIS in place of AldurDlg.SIS. The non-'DEV' versions of AldurDlg's installation packages are provided so your end-users can use your application without cluttering up their systems with the help file and example OPL source included in the developer versions. If you think your end-users would benefit from these files, or your application is aimed at developers, feel free to include the 'DEV' version of the .SIS file in your distribution. LICENCE ======= The copyright in AldurDlg -- the .SIS files and all component files -- is retained by the author, Graham L. Holden. The package, and/or any files within it, may only be used and distributed in accordance with the terms of this licence. If you cannot agree to be bound by the terms of the licence, you must stop using AldurDlg and delete all copies of the .SIS files and any component files from your system(s). Personal Use ------------ Everybody is granted permission to use AldurDlg to develop and run programs they develop for their own personal use, and to run any third-party programs they may acquire that make use of AldurDlg. Distribution ------------ Where permitted, AldurDlg must only be distributed as one or more of the standard package files: AldurDlgDEV.SIS, AldurDlgDEV-WINS.SIS, AldurDlg.SIS or AldurDlg-WINS.SIS. No component file or files may be distributed outside of these packages. These four .SIS files may be freely distributed provided that no charge is made. The .SIS files may be made available for download on a website provided that no charge is made either to download the files or to join, or otherwise be able to access the files. The files may not be held on a 'pay' or commercial website unless they are freely available to all visitors without them having to pay, join or provide credit-card details. A link should be provided back to my website so that users can check for updated versions. Distribution of Developed Programs ---------------------------------- The use of AldurDlg to develop any program or application that you want to distribute to others is permitted providing the following conditions are observed: -- If you include AldurDlg as part of your distribution, this can only be as one of the four .SIS files above, either as a standalone file, or preferably incorporated into your application's .SIS file. You may not distribute AldurDlg's component files separately. Should you choose not to include AldurDlg with your package (e.g. by relying on your users to acquire it for themselves) then the remaining conditions still apply. -- In your documentation and/or within the program (e.g. an 'About' screen) you must acknowledge your use of AldurDlg and include a link to my website. -- Programs developed with AldurDlg may be distributed as you see fit, e.g for free, as shareware or commercially. -- I would appreciate being informed of any use you make of AldurDlg, partly for my own interest and partly so I can let people know if I release any updates. Offering me a free copy of anything you develop would be doubly-appreciated but is in no way compulsory. Warranty -------- The software is offered "as is" with no warranty as to its suitability for any particular purpose. Your use of the software is entirely at your own risk and no liability will be accepted for any loss arising from the such use. However, without formally committing myself to any course of action, I will attempt to rectify any faults found in the software and would be glad for any feedback concerning the software. CONTACT ME ========== At the time of writing (June 2006), I can be reached by e-mail on: "g-holden" and "AldursLair.com", joined by an "@" sign. or mvia my website at: www.AldursLair.com/epoc I also try to keep an eye on the Psion-related newsgroups, including: comp.sys.psion.apps comp.sys.psion.misc comp.sys.psion.programmer I appreciate any feedback on this package, especially bug reports and typos in the help text. Suggestions for new features or improved clarity of the documentation are welcome, but no promises are made! I love 'dabbling' on the Psion, so any requests for future OPXs will be given a reasonable hearing. Graham Holden. REVISIONS ========= Version 1.13, 9th February 2006 First public release. The documentation file is incomplete. Recent changes to improve "on-change" callbacks appear to work OK, but have not been tested to destruction. Reports of any "odd" behaviour would be appreciated, in case I've goofed.