PSIBERIA

Psion Setup, v1.0 ================= Psion Setup is a freeware installation program for any Psion program that is supplied with a *.ctl control file. Psion Setup is similar to the PsiSetup Windows program (written by Psion PLC, UK), except that Psion Setup runs on the Psion itself, and thus allows MAC, UNIX, Amiga, and other non-Windows users to easily install standard Psion software. The only requirement is that the Psion software must be supplied with a *.ctl control file (eg: PsiMail Internet). Psion Setup is freeware, and may be distributed by software authors with their shareware or freeware applications. Licence Agreement - IMPORTANT ----------------------------- Before using Psion Setup, you must read and agree with the terms of the accompanying file LICENCE.TXT. Permanent Installation ---------------------- If desired, you can permanently install Psion Setup to your Psion. Software authors may however supply Psion Setup with their programs. To install Psion Setup... 1. Copy Setup.opo to an \OPO\ directory on any disk. The file is suitable for storage on a Flash SSD. Usage ----- Move the cursor to the RunOpl icon and press Enter. Select the *.ctl installation control file to use. NOTE: press Tab to help navigate to the control file location. Once you have selected the desired control file, press Enter and follow the on-screen prompts. NOTE: You can abandon the installation at any time with Esc, and you can kill Psion Setup at any time with Psion-Esc. Notes for Programmers --------------------- To use Setup.opo with your application, all you need to do is make a *.ctl control file and supply the *.ctl and Setup.opo files with your application. Making *.ctl files A *.ctl installation control file is a plain text (ASCII) file containing a list of files to be installed in the following format... [\DIR\]Filename.ext ...or... [Disk:\DIR\]Filename.ext eg: [A:\DIR\]Filename.ext Note: o The disk name is optional, if not given the files are installed to the disk chosen by the user during installation. o If the disk is explicitly specified, then it overrides the user's disk selection for that file. o The [brackets] are crucial, they must exist. o Filenames must be in valid MS-DOS and Psion 8.3 format and must end in an extension or a period (.), eg: Valid Invalid Filename.ext Filename.extn Filename. Filename o Leading and trailing spaces are ignored by Setup.opo, but cause PsiSetup to fail. You should ensure that all leading and trailing spaces are removed before distribution. o Lines starting with ; (semi-colon) or REM (remark) are ignored by Setup.opo, but cause PsiSetup.to fail. This feature allows you to comment out files during the testing phase. You should ensure that all comments are removed before distribution. Distribution You are free to distribute Setup.opo with any application you create, provided that you acknowledge the source of Setup.opo with the following or similar text: "Psion Setup (c) is written by Jochen Siegenthaler and used under licence." Initial Directory Psion Setup initially shows *.ctl files in the directory where Setup.opo itself is located. Setup.opo should reside in the same directory as the application's files (eg: on a floppy disk or in a zip archive). When the user starts Psion Setup any *.ctl file in the same directory is shown immediately. Disk Space Psion Setup calculates available + required disk space for all attached disks (A,B,C & M) and shows these to the user. Should the user try and install to a disk with insufficient available space, then no files are copied and the error "Insufficient disk space" results. Error Handling Extensive and intelligent error handling is built in. All errors that could be recoverable allow the user to retry. Errors in control files can be ignored if desired. Presence of existing files during installation causes a dialog to appear, forcing the user to skip, overwrite, or overwrite all. If he selects overwrite all, then he can choose to skip unchanged files. Setup checks file size and date/timestamp to see if a file has changed. Skipping all unchanged files is beneficial when installing to Flash SSDs. User Instructions Psion Setup is aimed at the first-time user. You should write your instructions accordingly, using exact mention of every keypress required. Psion Setup may be on a remote disk, in this case the user must start the remote link first and have the link program setup so that the Psion can "see" the remote file system. Note: this is *not* the default setting of PsiWin - see PsiWin's help file to change the setting. Note that you can speed up access to REM (remote) disks if you press Control-Tab and then enter the desired full path directly (eg: REM::A:\). To close the dialog use Shift-Control-Enter. This method prevents the remote disk from being scanned every time you change a disk or directory. Support ------- Please report all bugs and wishes to me at: 100127.3167@compuserve.com or jochen.siegenthaler@alcatel.ch Jochen Siegenthaler 23 July 1997