home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / XFILE / XFILE16.TXT < prev    next >
Encoding:
Text File  |  1995-05-17  |  10.3 KB  |  251 lines
  1. ============================== XFILE v1.6 ==============================
  2.  
  3. XFILE V1.6 - Extended group filing system (Application launcher).
  4.  
  5. The Psion series 3A has a system limit of 50 icons. This is reduced 
  6. even more when using 'groups' because a group takes up an icon, and 
  7. all the members of the group take up one icon as well.
  8.  
  9. The purpose of this program is to implement a 'group' function in a
  10. manner similar to that of the PSION groups, but without it's members
  11. using up an icon slot. When installing within a group the visable 
  12. icon for each application can be altered to any icon from any file
  13. type.
  14.  
  15. XFILE Provides the following functions.
  16.  
  17. a) No limit of number of icons installed on a machine.
  18. b) An applications icon can be changed without altering the original file
  19. c) OPO files can be installed as applications.
  20. d) Reduced usage of system memory for installing applications.
  21.  
  22. This version of XFILE is the fullest version available and differs from
  23. version 1.5 in that some additional options are now available.
  24.  
  25. Please see the amendment history for details.
  26.  
  27.  
  28.                               ---oOo---
  29.  
  30. DISCLAIMER:
  31.  
  32. This software is supplied as is, no warranty is made on it's use and
  33. no responsibility will be accepted for any damage or data loss which
  34. results from it's use.
  35.  
  36. The software has been tested, and is believed to work but this should
  37. not be assummed.
  38.  
  39. The software is supplied as shareware. If you find it useful you are
  40. expected to register your copy. The code and supporting text are not
  41. public domain. Copyright remains with the author, and all rights are
  42. reserved.
  43.  
  44.                               ---oOo---
  45.  
  46. How to register:
  47.  
  48. Registration is simply a matter of sending me some money, specifically
  49. £10 (no cash please). The address to send this remmittance can be found
  50. at the end of this file.
  51.  
  52. CompuServe users can register on-line. simply GO SWREG and use code number
  53. 5131. This costs $20. The registration screen may mention an earlier version
  54. of XFILE, just ignore that.
  55.  
  56. Registration will allow full use of the XFILE software as well as a
  57. limited support service, ie in a time permitting capacity.
  58.  
  59. Registered users can also leave messages on various BBS systems and I will 
  60. respond in like as soon as possible. Currently I use the following;
  61.         Psion user group BBS
  62.         Internet   raymond@raymie.demon.co.uk
  63.         Compuserve 100573,2051
  64.  
  65.                               ---oOo---
  66.  
  67. Installation of XFILE 1.6:
  68.  
  69. The following files should be installed
  70.  
  71.      \OPO\XFILE.LIB  
  72.      \OPO\RJSLIB2.LIB    (upgraded version of RJSLIB1.LIB unchanged since 1.3)
  73.  
  74.      \RJS\XFILE\XFILE.RSC (help file - OPTIONAL)
  75.  
  76.      \OPL\XFILEG1.OPL
  77.      M:\PIC\XFILE11.PIC  (this must be on internal disk...)
  78.                          This is the same file as in version 1.1.
  79.      M:\PIC\XFILEB.PIC   (must also be on internal drive unchanged since 1.3)
  80.  
  81. (un-supplied files)
  82.  
  83.      \WVE\{various}      (not required, but if present will be used)
  84.                          TOHUMAN2, FUDDWEST, TELLME.
  85.  
  86. The WVE files used as a holdover from earlier versions, I am considering
  87. removing sound support in later versions (although I may perhaps just make
  88. it totally configurable instead).
  89.  
  90. Once these files have been installed you can use the OPL source to 
  91. create an OPA (installable program) which will act as the group file.
  92. You should alter the application name within this sample OPL to match
  93. the name of the group you wish to create.
  94.  
  95. You may alter this OPL (changing the APP name as well as the source 
  96. filename) and this will allow you to have as many groups as you wish.
  97.  
  98. The files may be installed on any drive, and indeed may be on different
  99. drives, the only drive specific reference is in the OPL source and this
  100. should be changed to match your selected location. The exeception is the
  101. PIC file which must be in the INTERNAL drive. This may change in later
  102. versions.
  103.  
  104.                               ---oOo---
  105. Using XFILE:
  106.  
  107. In this version of the documentation the instructions will be kept to
  108. a minimum. Future documentation will be expanded when the registered user 
  109. base merits it. There are no plans for non-English documentation.
  110.  
  111. The installed group icon is run in the same manner as any other icon.
  112. Pressing SPACE as you would with a Psion group will not work.
  113.  
  114. Programs can be installed within a group by pressing alt-I and then 
  115. selecting the file (the same as a normal install). Up to 8 icons can
  116. be installed per group.
  117.  
  118. SYSTEM applications cen be installed using alt-J as you would from the
  119. system screen. The ROM is searched for applications and so will pick up
  120. the 2MB ones as well as the normal ones.
  121.  
  122. When installing an application I have provided an option to allow the
  123. user to specify another Icon to be used instead of the applications
  124. internal one. This icon can be within ANY file type, for example you
  125. can specify that the icon to be used is that contained in the program
  126. xxx.APP.
  127.  
  128. Groups can be nested within each other with no limits, ie a group can be 
  129. installed within another group. This means that in theory you can have
  130. an unlimited number of icons installed. A group can not contain itself,
  131. however group 1 can contain group 2 which may contain group 1.
  132.  
  133. OPO files can be installed as applications if you wish.
  134.  
  135. Applications can be uninstalled by pressing alt-/.
  136.  
  137. The left and right arrow keys scroll through the icons. The Up and Down
  138. arrows will move up and down a directory list.
  139.  
  140. Pressing enter will run the selected program, pressing 'ALT-N' will run the
  141. program but will first of all prompt for a 'new' filename. Pressing
  142. enter will automatically request a file name if the application is of
  143. a type which requires one, unless a directory list is shown.
  144.  
  145. The number keys 1-8 can be used instead of the enter key, the specific key
  146. used is that icon number on the screen, ie. 1 for the leftmost etc.. This 
  147. will only run the program if there is no directory list shown.
  148.  
  149. Press the MENU key to view any other options which may be available.
  150.  
  151. KEEP RESIDENT OPTION: At the request of some registered users I have now
  152. added the KEEP RESIDENT option. This option will allow the XFILE group to
  153. remain open after you select an application to run, and therefore you will
  154. return to the group screen when the application completes. This option can
  155. be enabled from the DEFAULTS screen. 
  156.  
  157. Version 1.4 now has an attempt to deal with the performance issues relating
  158. to the mutitasking involved with this option. The option SHOULD now be more
  159. usable but I know that further investigation is required. If you have any
  160. comments and problems relating to this option please get in touch.
  161.  
  162. It seems that there may still be performance issues outstanding for this 
  163. option. I suggest not using it unless you really have to.
  164.  
  165.                               ---oOo---
  166. Technical Information:
  167.  
  168. XFILE is for the 3a only. It has only been tested on 2Mb machines
  169. but should work on smaller models as well.
  170.  
  171. Certain file types may not function correctly in this version. The only
  172. one I am aware of is PSION group files (.grp).
  173.  
  174. Memory usage is kept to a minimum at the point of actually executing 
  175. the selected program hence the small size of OPL code. 
  176.  
  177. Future enhancement planned are as follows.
  178.  
  179. a) potential speed improvements are being investigated via 'C' coding.
  180. b) More than 8 icons per group may be supported if enought interest shown.
  181. c) Option to expand 24x24 icons to 48x48 (as on system screen).
  182. d) Enhanced documentation to be written based on user feedback.
  183.  
  184. Comments and suggestions are always welcome.
  185.  
  186.                               ---oOo---
  187.  
  188. Registration fees and requests for support (registered owners only please)
  189. should be addressed as follows. Please allow 10 days for registration code
  190. to be provided. (Compuserve users will normally receive a code within 24
  191. hours on my receipt of the sharware registration).
  192.  
  193. Raymond Stone
  194. 31/3 Kingsknowe Rd N.
  195. Edinburgh
  196. EH14 2BN
  197.  
  198. Please include information regarding where you obtained the software so
  199. that I can ensure the source receives updates when available.
  200.  
  201. Sources currently updated:
  202.      Psion User Group BBS
  203.      Metcom BBS (unable to locate new phone number)
  204.      COMPUSERVE
  205.      INTERNET (comp.psion.binaries)
  206.  
  207.                               
  208.                               ---oOo---
  209.  
  210. The following list shows applications where there are confirmed installation
  211. problems.
  212.  
  213. Application     Problem (and work around if possible)
  214. -----------     ----------------------------------------------------------
  215. None            
  216. -----------     ----------------------------------------------------------
  217.  
  218. Please inform me of any applications which do not function with XFILE.
  219.  
  220.                               ---oOo---
  221.  
  222.     Version      Enhancement made
  223.     -------      ----------------------------------------------------------
  224.      1.6         Directory lists are now shown (Can be switched off).
  225.                  ALT-N selects a new file now (previously was 'n').
  226.                  Initial nag screen delays reduced again.
  227.                  IMG files should now install correctly
  228.      1.5         Allow FAX3 to be installed correctly.
  229.      1.4         Help system added (optional file)
  230.                  Performance improvements if using remain resident option
  231.                  ROM based applications now supported
  232.                  LISTS (alias files) now supported
  233.                  Nagg delays reduced by half
  234.                  If an application moves drive XFILE will still find it
  235.                  The X14 data files (after creation) can be moved onto SSD
  236.      1.3         Implemented keys 1-8
  237.                  Corrected OPO installation
  238.                  Implemented handling for a busy application
  239.                  Implemented resident processing
  240.      1.2         Removed most of the nag screen displays
  241.                  Fixed bug on HELP information screen
  242.      1.1         Show default icon if specified file is missing
  243.                  Some speed improvements via use of OS calls
  244.                  Correct problem with initial bug screens
  245.                  Allow full use even if unregistered
  246.                  Code in fairly sizeable delays for unregistered running
  247.                  Alter screen appearance to match system screen
  248.  
  249.                               ---oOo---
  250. XFILE 1.6 17/05/95 R.Stone
  251.