home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / appmanager / addapps_1 / !AddApps / !Help < prev    next >
Text File  |  1995-02-02  |  7KB  |  167 lines
  1. AddApps v1.60 - © Rob Clark 1994
  2.  
  3. Purpose and function
  4. ====================
  5.  
  6. AddApps creates a relocatable module based upon the selection of applications
  7. dragged to its main window during normal use. Once saved and run (*RMRun,
  8. *RMLoad results in minor problems - see below) the module places images of
  9. the selected applications into the Resources filing system. Thus if you
  10. dragged Zap and ChangeFSI to the window the resultant module would make it
  11. appear that Zap and ChangeFSI are in the same directory as Edit and Draw etc.
  12. When you run one of these image applications the original is fetched from
  13. disc and is run.
  14.  
  15. How it works
  16. ============
  17.  
  18. Instead of storing entire applications in the Resources, which consumes the
  19. same amount of memory as the amount of disc space the apps take up (1.1mb for
  20. my copy of Publisher), an image is stored which is much smaller. What is
  21. stored in Resources for each application is an application directory with a
  22. !Run file and optionally !Boot and !Help files, these are all of type Obey.
  23. When run they simply call the original file. Thus running
  24. Resources:$.Apps.!Publisher.!Run (which is done by RISC OS when you
  25. double-click) will in turn run IDEFS::Rob's.$.Apps.DTP.!Publisher
  26. This will slow down the running of these apps slightly but the benefits are
  27. greater than that slight deficiency (I think).
  28.  
  29. Why do I want to use it ?
  30. =========================
  31.  
  32. AddApps and the RomApps module it creates allows you to have all (well, some)
  33. of your favourite applications to be in a filer window only one click away
  34. from the iconbar. You may already have this with your hard-disc but mine is
  35. organised ;-) It also removes the need for another iconbar icon to fill
  36. things up as it uses the existing Resources filer supplied with all RISC OS
  37. 3.1x machines.
  38.  
  39. Menon (or similar) puts all of the application names into a menu which
  40. requires you to read it while this solution allows you to use the existing
  41. Filer mechanisms which I personally prefer (you get [big] pictures).
  42.  
  43. What are the Cons if the above are the Pros ?
  44. =============================================
  45.  
  46. The module takes up your memory (well, your computer's). I add 3 apps on
  47. startup and this consumes 2396 bytes of memory. A module with 50 apps stored
  48. comes to 19624 bytes. I personally think that this is not a lot of memory to
  49. give up for the convenience of the features it provides.
  50.  
  51. Other features
  52. ==============
  53.  
  54. If the module was *RMRun'd when you run AddApps next the system variable
  55. AddApps$LoadCurrent is examined. If this is equal to 'Yes' (case-insensitive)
  56. then the apps held in the resident RomApps module will be read in by the
  57. program. This variable is set in the !AddApps.!Run file by default.
  58.  
  59. Double-clicking on one of the image applications while holding down either of
  60. the Alt keys will result in it being as though you had Shift-Double_Clicked
  61. on the original wherever it is on your disc.
  62.  
  63. Double-clicking with Select in the AddApps selection window over an
  64. application will do the same as choosing the App->Edit menu option.
  65.  
  66. Double-clicking with Adjust in the AddApps selection window over an
  67. application will do the same as choosing the App->Remove menu option.
  68.  
  69. Double-clicking with Select and Shift held down in the AddApps selection
  70. window over an application will do the same as choosing the App->Open parent
  71. menu option.
  72.  
  73. Bugs
  74. ====
  75.  
  76. Actually I've spent most of today debugging so there shouldn't be any :-)
  77. Actually I'm sure there are some and I'd greatly appreciate knowing what they
  78. are so that I can correct them. Contact details are at the end of this file.
  79.  
  80. Trivia
  81. ======
  82.  
  83. The first version of this was written on the 29th of October 1993. I consider
  84. it to be an original application although I'm sure there are others out there
  85. that do the same or similar (can you say Risc PC !Boot application ?).
  86.  
  87. There is currently a maximum of 50 apps allowed to be added. If any user is
  88. massochistic enough to require more then mail me.
  89.  
  90. The uncompressed BASIC code is ~48K and requires a larger WimpSlot than I
  91. felt comfortable asking for. The uncompressed source is available from me if
  92. you have a good reason for wanting it. The fact that I've been fiddling with
  93. this code since Oct93 means that some is really awful. This is why I want to
  94. know why you want the code (if indeed you do) so I can see if I have
  95. rewritten effectively the same thing elsewhere since then.
  96.  
  97. If you want this program to do what the program supplied with the Risc PC
  98. does (scan a given directory and construct a module from that) then you need
  99. a different program. I have a program that does this and I'll send it to you
  100. (via email) if you would rather use that than AddApps.
  101.  
  102. Testing with a RiscPC was conducted by Keven Cook for which I am very
  103. grateful.
  104.  
  105. Compatability
  106. =============
  107.  
  108. The code has been tested extensively on RISC OS versions 3.10 and 3.11. By
  109. the time of distribution I hope to have tested it on RISC OS 3.5 as well. The
  110. redraw may prove buggy under v3.5 in which case I apologise but I have no
  111. Risc PC to test with.
  112.  
  113. The module uses one 'cheat' which occurs when the module is *RMRun. It
  114. backtracks from the pointer provided in R0 upon entry to the run code. I
  115. think that this is supposed to point to the command line string used to
  116. invoke the module but I find it points to the terminating zero of that
  117. string. Bactracking seems to work on both versions of RISC OS that the
  118. RomApps module has been tested with. It is always possible that this won't
  119. work with later versions of RISC OS.
  120.  
  121. nb. I think the above 'cheat' is required because of a bug in RISC OS - can
  122. anyone tell me if this is true and if Acorn are aware of it ?
  123.  
  124. Licensing
  125. =========
  126.  
  127. Everything contained within the AddApps directory is © Rob Clark 1994
  128. although the Style Guide compliant templates came from TemplEd 1.28. At this
  129. point I must comment on how unfortunate it is that Acorn's 3d borders are
  130. 'buggy' so nice Style Guide compliant programs like mine have dodgy buttons.
  131. Please examine the Cancel button on the save window if you don't believe me.
  132.  
  133. I retain all copyright but give freedom of distribution to all as long as
  134. they agree not to change any of the files in any way without my prior
  135. consent or make any profit from the distribution.
  136.  
  137. The only Shareware-like requirement of this program is that if you got it
  138. from the Internet you must contact me with your opinions via the contact
  139. details given below - please :-)
  140.  
  141. Contacting the author
  142. =====================
  143.  
  144. My name is Rob Clark.
  145.  
  146. My Email for term-time is: R.A.Clark@herts.ac.uk
  147.  
  148. The only other way of contacting me is via the Arcade bulletin board. I am
  149. user number 0898 and I believe that email to 'RobClark@arcade.demon.co.uk'
  150. will eventually reach me there. That said I haven't called them for around 14
  151. weeks now.
  152.  
  153. Changes
  154. =======
  155.  
  156. Since this help file was written the following changes have been made:
  157.  
  158. • There was a bug when loading a module if one of the sprites required was
  159. not known which resulted in the application refusing to load. This has now
  160. been fixed.
  161. • The application now supports the desktop save protocol.
  162. • Support for interactive help has been brought up to date
  163. • A small icon and ic_? icon have been drawn (badly) for small icons mode in
  164. the filer and for when you iconise any of the AddApps windows
  165. • Menu rearranged to make it more ‘user-friendly’. Interactive help updated
  166. accordingly.
  167. • Redraw should work under all release versions of RISC OS 3