home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsf / install / README13.TXT < prev   
Text File  |  1993-12-21  |  8KB  |  240 lines
  1. Auto-Installation v1.3          (c) Psion GmbH 1993
  2. ----------------------
  3.  
  4.  Author: G.Tappenden
  5. Address: Psion GmbH, Saalburgstr.157, D-61350 Bad Homburg
  6. Hotline: +49 6172 37097           Cix: mhoelscher
  7. Mailbox: +49 6172 37090      Internet: mhoelscher@uk.co.compulink.cix
  8.     Fax: +49 6172 39192        Cserve: 71333,2070
  9.  
  10. BACKGROUND TO THE PROGRAM
  11.  
  12. If you ever have to reset your Series3a, this causes one problem - you have
  13. to re-install all of your applications, groups, and lists.  To overcome this
  14. auto-install allows you to setup your Desktop in a way which suits you, and
  15. following a soft reset you can re-install all of your applications in one
  16. go.
  17.  
  18. INTRODUCTION TO VERSION 1.3
  19.  
  20. Version 1.2 of the Auto-Installer was the first version released.  I
  21. originally wrote the program purely for my own use, since during the
  22. development of other programs it is sometimes necessary to reset the 3a.
  23.  
  24. After uploading it to Cix, it found its way onto CompuServe, where it seems
  25. to have been quite successful.  This inspired me to somewhat expand on the
  26. script language, so that the program could be used in a more flexible way.
  27.  
  28. INSTALLATION
  29.  
  30. The program is saved as a .OPO file, so that it appears under the normal
  31. RunOpl icon.  You should copy the file INSTALL.OPO into the \OPO\ directory
  32. on either an SSD or the internal disk.
  33.  
  34. THE SCRIPT FILE
  35.  
  36. In order for Install to know how you like your Desktop, you need to write
  37. a script file, which will be used in the installation process.
  38.  
  39. In Version 1.2 this file HAD to be called M:\SCRIPT.CFG.
  40.  
  41. In Version 1.3 you may now have multiple script files, on any drive,
  42. although the default position remains the root directory, with the .CFG
  43. extension, to allow maximum compatibility with version 1.2.
  44.  
  45. The following commands are available in the script language:
  46.  
  47. * COMMANDS COMPATIBLE WITH VERSION 1.2
  48.  
  49. HOME
  50. This moves the cursor to the left-most application in the System Screen.
  51.  
  52. END
  53. This moves the cursor to the right-most application in the System Screen.
  54.  
  55. LEFT
  56. This moves the cursor one position left.
  57.  
  58. RIGHT
  59. This moves the cursor one position right.
  60.  
  61. IN filename.ext drive position
  62. Installs a filename from the given drive at the given position,
  63. eg. IN MONEY.APP A L installs money from drive A: in the position "Last".
  64.  
  65. JN appname position
  66. Installs a standard application at the given position, eg. JN Word L
  67. installs Word in the position "Last".
  68.  
  69. REMOVE
  70. Removes the application which is currently under the cursor.
  71.  
  72. KEY key extra
  73. Assigns a key to the application currently unter the cursor,
  74. eg. KEY A C assigns the key Ctrl+Agenda.
  75. NB: To assign a Key to "World" use KEY WW x instead of KEY W x (which is 
  76.      used for "Word")
  77.  
  78. ZOOM+
  79. Increases the zoom factor.
  80.  
  81. ZOOM-
  82. Decreases the zoom factor.
  83.  
  84. STATUSWIN
  85. Toggles the status window.
  86.  
  87. STATUSBAR
  88. Toggles the status bar at the bottom of the screen.
  89.  
  90. Any line beginning ' is regarded as a comment.
  91.  
  92. * NEW COMMANDS IN VERSION 1.3
  93.  
  94. CONFIRM
  95. The confirmation is no longer a standard option.  Using this command
  96. will prompt the user to confirm that they wish to proceed with processing
  97. the file.  You may use this as much as you wish within the file.
  98.  
  99. BEEP
  100. Produces a beep.
  101.  
  102. BEEP time% pitch%
  103. Produces a beep using the same parameters as in OPL.
  104. In the English handbook this is explained on page 165.
  105.  
  106. OPENGROUP
  107. If the cursor is on a group, this expands the group.
  108.  
  109. CLOSEGROUP
  110. If the cursor is within a group, this closes the group.
  111.  
  112. UPDATELISTS
  113. This forces the System Screen to update the file lists.
  114.  
  115. PLAY filename ticks volume
  116. Plays a 3a sound file.  The filename must be specified WITH the path,
  117. although the drive may be omitted.  There are 32 ticks per second.
  118. Volume 0 is the loudest, volume 5 is the quietest.
  119.  
  120. SOUND allsound alarm beeps keyclick
  121. Sets the five available options in the "Sound Options" dialog.
  122. NB: For German machines "L" will toggle between "Leise" and "Laut".
  123.  
  124. LINK link baud extra
  125. This can be used to turn on the Remote Link, or to set the Baud Rate.
  126. NB: If you use this to turn the link on, then the 3-Link MUST be plugged
  127.     in.
  128.  
  129. DEFAULTDISK disk
  130. Sets the default disk for new files.
  131.  
  132. AUTOOFF option time
  133. Sets the options for Auto-Switchoff.  When entering the time you should
  134. omit the seperators.  eg. AUTOOFF Y 000500 sets five munites.
  135.  
  136. STATUSWIN clocktype disk link batterie capslock
  137. Sets the options for the Status Window.
  138.  
  139. PREFERENCES listopt openopt font
  140. Sets the options in the "Preferences" dialog.
  141.  
  142. ICOMMS pos
  143. Installs the comms program without the need for the 3-link to be
  144. plugged in.  pos MUST BE SPECIFIED.
  145.  
  146. ISCRIPT pos
  147. Installs the script program without the need for the 3-link to be
  148. plugged in.  pos MUST BE SPECIFIED.
  149.  
  150. * FILE COMMANDS
  151. These commands are useful when installing (or de-insatlling) an application
  152. from an SSD using a specific script file.
  153.  
  154. FILECOPY source dest            copies a file
  155.  
  156. FILEDELETE filename             deletes a file
  157.  
  158. MAKEDIR name                    creates a sub-directory
  159.  
  160. REMDIR name                     removes a sub-directory
  161.  
  162. None of the above commands provide any confirmation of their actions.
  163. If you wish to provide this, you should use the CONFIRM command.
  164.  
  165. Please note also that none of the commands return any error messages
  166. if they are note successful.
  167.  
  168.  
  169. * DISPLAY COMMANDS
  170.  
  171. ECHO OFF                stops the commands being listed.
  172. ECHO ON                 turns the option back on.
  173.  
  174. ECHO text               prints "text" to the screen.
  175.  
  176. SHOWPIC filename        displays a .pic file on the screen
  177.  
  178.  
  179. RUNNING THE PROGRAM AFTER A SOFT RESET
  180.  
  181. After a soft reset, select "Install" under the RunOpl icon.  You will be
  182. which file to process.  The script file will then be processed and the
  183. applications installed as specified.
  184.  
  185.  
  186. INTERNATIONAL USE
  187.  
  188. The Series3a comes in a variety of languages.  I have successfully tested
  189. Version 1.3 on both German and English machines.  If anyone has a machine
  190. which uses a different language, I cannot say whether or not the program
  191. will work.
  192.  
  193.  
  194. CREDITS
  195.  
  196. Thanks for all the comments, praise, etc.
  197.  
  198. A few credits:
  199. * The file selector was requested by Michael Haas.
  200. * Michael also asked me to remove the confirmation dialog, so I turned
  201.   this into an option.
  202. * Thanks to Brian Wilson for pointing out the problem with the World key.
  203.   I hadn't spotted up to now.  Also thanks to John Boyce for his
  204.   suggested solution.  To my knowledge this won't work on version 1.2, but
  205.   is implemented in version 1.3.
  206. * A mention for Mark Esposito from CompuServe, who wrote the accessory
  207.   to automatically write the script files.  This program should also
  208.   be compatible with version 1.3.
  209. * Another mention for Michael.  He asked me to add the option to turn on
  210.   the Remote Link.
  211. * The Default Disk and Preferences options were requested by John Boyce.
  212. * Finally, thanks to David Wood in Cix for his support for the program.
  213.  
  214.  
  215. TECHNICAL SUPPORT
  216.  
  217. If anyone has any problems with Install 1.3, please get in touch.
  218.  
  219. Please include the following details:
  220.         The version of Install the you are running (eg. 1.3)
  221.         The version of Series3a you are using (eg. 3.22F - Deutsch)
  222.  
  223. Please also send me a copy of your script file which causes the problem.
  224. Without the file it is difficult to trace any problems.
  225.  
  226. We also welcome any comments or suggestions you may have.  Please send
  227. these to one of the addresses listed above.
  228.  
  229.  
  230. CONDITIONS OF USE
  231.  
  232. All rights reserved.  Psion accepts no responsibility for any damage caused
  233. by the direct or indirect use of this program.  The software remains the
  234. property of Psion GmbH.
  235.  
  236. No fee may be charged for this product, without the express permission of
  237. Psion GmbH.  Also, this product may not be used to distribute any product
  238. for which a fee is charged without the express permission of Psion GmbH.
  239.  
  240.