home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsf / jblaun / JBLAUNCH.TXT < prev    next >
Text File  |  1995-07-13  |  9KB  |  208 lines

  1.                               JBLaunch
  2.                              version 2.5
  3.                            (c)JBSoft 1993-5
  4.  
  5. Overview
  6. --------
  7. This program allows for a clearer screen by amassing all the seldom
  8. used utilities under one roof. It will run .APP, .IMG, .ALS, .OPA and .OPO files from any drive (or ROM). Applications that use other files
  9. (Agenda, Notepad, World, Data etc.) should automatically install
  10. themselves. If an association has been established (either
  11. automatically or by editing the datafile under the JBLaunch icon
  12. then, on running the item, a file choice menu appears for you to
  13. select a file to run with the application.
  14.  
  15. N.B. This version will only run on the S3a due to modifications to the code.
  16.  
  17. Installation
  18. ------------
  19. The program should be placed in an APP directory (on any drive) and
  20. then installed using Psion-I. When it is first run it will display a dialog requesting which drive should contain the init files. Once this directory called \JBL\ has been made then a menu will appear allowing files to be added etc.
  21.  
  22. If upgrading to an earlier version there will be a file called '<init>' listed under the icon - this can be deleted as the program now uses a file called '!init!'.
  23.  
  24. Operation
  25. ---------
  26. Once installed and run for the first time this Management utility is
  27. run by selecting the file called '!init!' situated under the Launch
  28. Icon. There is a separate option to install programs from the ROM - if
  29. an Application other than CALC is given then the file information
  30. required to run the program is automatically included in the
  31. specification. This can be edited once the program is installed - see
  32. below.
  33.  
  34. If the application file is in the A, B, or M drives then the program
  35. should automatically check if datafile information is applicable and,
  36. if so, will extract the relevant information from the application
  37. program and save it to the .LNC datafile in the JBL directory.
  38. JBLaunch is barred from installing itself!
  39.  
  40. Manual Entry
  41. ------------
  42. If, for some reason, the automatic installation fails then the data
  43. can be edited by selecting Psion-E from the '!init!' Sundry menu. Both a path and file extension for the files to use (e.g. DATA uses DBF extensions) must be given if applicable. If entered manually, the
  44. files data must be valid for the Application but no checking for
  45. validity is made until the program is run. This obviously requires
  46. some inside knowledge concerning files (e.g. NOTEPAD normally requires
  47. a file in a \NOTE\ directory with a .PAD extension and VIEWAL requires
  48. files in an \OPD\ directory with a .PIC extension). No extension name
  49. should be given unless a file is to be run along with the application
  50. as this field is used to check for the type of file to Launch.
  51.  
  52. When files are added the path and name of the file, together with its
  53. type (.OPO, .APP etc.) are stored in a small file of the same name in
  54. the Launch directory. When the selected file is run, this information,
  55. together with the file details to be used to select the file to run as
  56. part of the process, is retrieved and used to run the program in the
  57. appropriate manner. Deletion of the file from the Launch Icon just
  58. deletes this information file. You could also delete the file using
  59. Psion-D from the System screen. An option to change the name of this
  60. small data file is also given under <Psion-C>.
  61.  
  62. Known Problems
  63. --------------
  64. There was a known problem with certain OPA files that had been renamed
  65. to APP files - this has now been cured by a check upon installation.
  66. YNOT.APP, when run from JBLaunch, does not appear under the Launch
  67. icon but does appear under the YNOT icon (if installed) or the RUNIMG
  68. icon (if not installed). This is because of programming of the
  69. application which should be fixed in later versions.
  70.  
  71. JUMPY.OPA requires all its files to be in a Jumpy directory and the
  72. only way I have succeeded in getting it to run is to generate a
  73. separate OPO file and run it from there. I've included the OPL file
  74. for alteration and use.
  75.  
  76. There are continuing problems with icons (normally shown when selecting an application that has a filelist). If you come across an icon that does not show correctly please let me know so that I might try to make the program work correctly. At present all known problems have been cured.
  77.  
  78. Usage
  79. -----
  80. Programs are run by selecting the appropriate name under the Launch
  81. Icon and pressing Enter. Multiple versions of the program can be run
  82. (if this is permitted by the program) and running applications will be
  83. displayed in Bold type under the Launch Icon. This will be the name of
  84. the application and not necessarily that of the file listed under the
  85. JBLaunch icon.
  86.  
  87. If a file specification to run with the application was initiated when
  88. the app was added, this will produce a file list from which to choose
  89. the file to run with the app. The file is selected using the cursor
  90. keys or by the first letter of its name and then pressing Enter. If
  91. Esc is pressed then you will return to the System screen. In order to
  92. allow navigation to other directories - press Tab and a normal file
  93. dialog will appear which behaves in the usual fashion. Pressing Esc
  94. from this dialog will return you to the previous file selection
  95. screen.
  96.  
  97. Applications are closed in the normal way but, if the Management
  98. utility (!init!) is selected and Edit or Delete is selected, that
  99. application is checked to see if it is running - if it is then an
  100. option to close it is given. If it isn't closed then you will be
  101. unable to enter the Edit or Delete menu. This is to protect against
  102. being able to delete or change the data file whilst leaving the
  103. application running.
  104.  
  105. If the JBL directory or !init! file is accidentally deleted then the
  106. !init! file will be re-created along with the directory when the
  107. Application is next run. All the other included files will have to be
  108. reinstalled if the directory was deleted.
  109.  
  110. An option has been given to change the name of the file listed under
  111. the JBLaunch icon. This is so that files that have unremarkable names
  112. can be given more obvious names (e.g. The Psion Spreadsheet is called
  113. SH3.APP and the file could be called Sheet to make its use more
  114. obvious. This rename utility is called with Psion-C.
  115.  
  116. >pa 4
  117. Limitations
  118. -----------
  119. 49 Data files
  120. 49 Applications
  121.  
  122. These figures could be increased if necessary - please advise.
  123.  
  124. N.B. If an OPL/OPA application is run complete with a data file then
  125. the name shown under the Launch icon is that of the data file and not
  126. the application. This is not a bug but what would happen if the data
  127. file was run under the application icon.
  128.  
  129. This program is free for you to use but I reserve copyright on the
  130. code. Any data that might be lost or corrupted is the responsibility
  131. of the user - Use this program at your peril!
  132.  
  133. New Versions
  134. ------------
  135. It is possible to clone the program using the OPO file INSTALLL.OPO. This will make a copy of the program under a new name and allow for a different icon and Sub-directory for the data files.
  136.  
  137. After the INSTALLL program has been run then the new clone can be run in exactly the same way as the original JBLaunch.
  138.  
  139. Data file tweaking
  140. ------------------
  141. It is possible to tweak all the data files (regardless of whether the program was modified with INSTALLL.OPO using JBLEXAM.OPO. This program should be self-explanatory for those of you brave enough to use it.
  142.  
  143. Thanks
  144. ------
  145. Sincere and profound thanks must be given to Dennis Lefebvre without
  146. who's help this program would not be in a fit state for use. Any
  147. errors are mine alone - any good points are his! Thanks also to Mark Briody for his beta testing and help.
  148.  
  149. Updates
  150. =======
  151. Ver 2.4
  152. -------
  153. Fixed some problems with wishing to use default drive for some files.
  154. Implemented .ALS alias files that are in the ROM::.
  155. Fixed a problem with running the ROM::COMMS.APP - it wouldn't but will now.
  156.  
  157. >pa4
  158. Ver 2.4a
  159. --------
  160. Tweaked the <init> file name to be !init! - this makes it more compatible with MS-DOS.
  161.  
  162. >pa4
  163. Ver 2.4b
  164. --------
  165. Fixed problem of some Apps not displaying the filelist wh