home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsd / et_demo / !ET_Demo / !Help next >
Text File  |  1995-07-26  |  12KB  |  269 lines
  1. EmptyTasks v 1.00                                  (Requires RISC-OS 3.xx)
  2.  
  3.  
  4.  
  5. Registering: see the section entitled "Registering" at the bottom of this
  6. file.
  7.  
  8.  
  9.  
  10. -=-=-=-=-= Description: (What does it do?) =-=-=-=-=-
  11.  
  12.    EmptyTasks allows you to temporarily put the memory of an application on
  13. disc (called swapping out of a task). The memory it occupied becomes
  14. available for other use now.
  15.    As the word “temporarily” in the previous sentence already indicated you
  16. can swap a swapped out task back in and continue using it, if of course you
  17. have enough free memory to swap the task back in again.
  18.  
  19.  
  20.  
  21. -=-=-=-=-= Usage (How to use it) =-=-=-=-=-
  22.  
  23.    After having run EmptyTasks, the EmptyTasks icon will appear on the
  24. iconbar. Clicking on it with select will openup a Tasklist window displaying
  25. all application tasks currently running. Alongside each task the amount of
  26. discspace and memory it occupies (in Kilobytes) are also displayed.
  27.  
  28.    Clicking with select or adjust on one of the tasknames displayed will swap
  29. that task out: all windows belonging to this task are temporarily closed and
  30. all its iconbar icons are temporarily replaced by “DeadTask”-icons,
  31. underneath which the first 5 characters of the taskname are displayed, the
  32. contents of the taskmemory are written to disc and the memory is freed.
  33. (In the Tasklist window, swapped out tasks will have their name and
  34. information printed in red instead of black.)
  35.  
  36.    To swap a task back in, click on its name in the Tasklist window again or
  37. on one of its “DeadTask” icons on the iconbar.
  38.  
  39.  
  40.  
  41. -=-=-=-=-= Installing EmptyTasks on your harddisc =-=-=-=-=-
  42.  
  43.    Just copy the !ET_demo directory to your harddisc. You can either run
  44. EmptyTasks when you need it or put it in your boot sequence.
  45.    If you decide to put it in your boot sequence just copy !ET_demo to your
  46. AfterDesk directory if you have a RiscPC. Run it from your desktop boot file
  47. if you have a non RiscPC.  
  48.  
  49.  
  50.  
  51. -=-=-=-=-= Copyright =-=-=-=-=-
  52.    
  53.    You may make as many copies of !ET_demo as you want, as long as all files
  54. within the !ET_demo are copied without any modifications. And it may be
  55. distributed freely.
  56.  
  57.    Remeber however that although this demo version of EmptyTasks can only
  58. handle one swapped out task at a time that you should buy the full version if
  59. you want to use EmptyTasks (on a regular basis), even if one swapped out task
  60. at a time is sufficient for your purposes. You may only try this demo version
  61. for a period of 28 days. After that you are still allowed to copy it and keep
  62. a copy of it but if you still like to use EmptyTasks (even the demo-version),
  63. you should register to obtain the full version.
  64.  
  65.    I could keep going on and on trying to make a foolproof clause, but I hope
  66. that that's not necassary. We all know what I'm trying to say: if you like to
  67. use EmptyTasks, buy it.
  68.  
  69.  
  70.  
  71. -=-=-=-=-= Set up of swapfile directories =-=-=-=-=-
  72.  
  73.    When a task is being swapped out it is moved to a swapfile on disc into
  74. the directory: “<EmptyTasks_Tasks$Dir>”.
  75.  
  76.    When EmptyTasks is started (or after a soft-break while EmptyTasks was
  77. running) all swapfiles in “<EmptyTasks_Tasks$Dir>” will be moved to the
  78. directory “<EmptyTasks_OldTasks$Dir>”.
  79.  
  80.    If the two system variables mentioned above are not set (eg. in your boot
  81. sequence) then they will be set to “<EmptyTasks$Dir>.Tasks” and
  82. “<EmptyTasks$Dir>.OldTasks” respectively.
  83.  
  84.    You may set them to point at an archived directory like CFS#.... or
  85. SparkFS#.... .This will save you some discspace when swapping out files.
  86. Remember however that this will slow down the swapping of tasks (especially
  87. swapping out). Note: The “Min. disc free” option won’t work when using an
  88. archived directory as swap space.
  89.  
  90.  
  91.    Q: Why are the files in “<EmptyTasks_Tasks$Dir>” moved to “<EmptyTasks_
  92. OldTasks$Dir>“?
  93.    A: If you reset the machine or turn off the power of the machine whilst
  94. some tasks are still swapped out, their memory contents will still be on disc
  95. (the swapfiles). So, you could still try to retrieve data from them by
  96. loading them into an editor like Zap. But to keep the current task swap
  97. directory clean, all swap files that were still on disc will be moved to a
  98. backup directory when EmptyTasks is started.
  99.  
  100.    The name given to a swapfile consists of the first 5 characters of the
  101. taskname followed by the 4 l.s. digits of the hexadecimal representation of
  102. the taskhandle, separated by a “_”.  If neccesary, “_”s will be added to the
  103. taskname until the taskname occupies 5 characters.
  104.  
  105.  
  106.  
  107. -=-=-=-=-= Options Window =-=-=-=-=-
  108.  
  109. Max. swapped out   : The maximum number of swapped out tasks at any time
  110. ----------------------------------------------------------------------------
  111. In this demo version of EmptyTasks Max. swapped out has been restricted to 1
  112. ----------------------------------------------------------------------------
  113. Max. known         : The maximum number of application tasks EmptyTasks will
  114.                      keep track of
  115. Min. disc free     : The minimum space to be left free on the swap-out disc,
  116.                      specified in either Kilobytes (default) or Megabytes
  117.                      (add a “K” or “M” to the number)
  118. Max. swap mem.     : The maximum amount of memory to be swapped out from a
  119.                      task (specified in Kilobytes or Megabytes)
  120. Close window after : Close Tasklist window after swap when taskname was
  121.                      selected with:
  122.                         Select, Adjust or neither (in the latter case, the
  123.                         EmptyTasks window will never be closed after clicking
  124.                         in it)
  125. Maximize Window    : Maximize the Tasklist window whenever it is opened or
  126.                      whenever a new task is started or quitted:
  127.                         No, Yes
  128. Clear              : Delete the OldTasks directory every time EmptyTasks is
  129.                      started:
  130.                         No, Yes
  131.  
  132. What happens if an icon is left completely blank:
  133.  - Max. swapped out,
  134.    Max. known       : if just one of these is blank it will be set to the
  135.                       value of the other. If both are blank, they’ll both
  136.                       be set to 32 (in this demo version, Max. swapped out
  137.                       will be set to 1)
  138.  - Min. disc free   : will be set to 0K
  139.  - Max. swap mem.   : will be ignored (equivalent to setting it to 1024 Mega-
  140.                         byte)
  141.                        
  142.  
  143.                        
  144. -=-=-=-=-= Further usage (What else is there to know?) =-=-=-=-=-
  145.  
  146.    When a task is being swapped out it is moved to disc and then removed from
  147. memory. If you want to swap it back in again but you haven’t got/can’t
  148. release enough memory to reload it, you have a problem.
  149.    Things you can try at that moment:
  150.  - switch to a screen mode which occupies less memory (like mode 0)
  151.  - shrink your RAMdisc and/or Font Cache.
  152.  - Quit other tasks which are in memory or try swapping in and quitting
  153.    smaller tasks first (they may free memory in RMA or in the System Sprite
  154.    area or, on the RiscPC, may even free Dynamic Areas) thus hopefully 
  155.    giving you enough free memory.
  156.  
  157.    If you still can't get enough memory to swap a task back in, you might be
  158. able to retrieve some data which was stored within the taskmemory; the
  159. swapped out task is still saved on disc in the directory
  160. “<EmptyTasks_Tasks$Dir>” in a swapfile. You could load this swapfile into an
  161. editor (like Zap) and try to retrieve some data from it. (See also ‘Set up
  162. of swapfile directories’)
  163.  
  164. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 
  165.    Advice: always save documents (or any data processed in a task)
  166.            before swapping out a task.
  167. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  168.  
  169.  
  170.  
  171. -=-=-=-=-= Disclaimer =-=-=-=-=-
  172.  
  173. The user is personally responsible for any loss of data or any other damage
  174. caused due to the use of EmptyTasks. I won’t take any responsibility for the
  175. actions of this program.
  176.  
  177.  
  178.  
  179. -=-=-=-=-= Restrictions =-=-=-=-=-
  180.  
  181.  1) EmptyTasks requires RISC-OS 3.xx 
  182.  
  183.  2) Some tasks may read out the memory-page-numbers of their memory and swap
  184.     them around in their memoryspace. If they read their memory-page-numbers
  185.