home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / mag_discs / 17 / judith / !Judith / !Help next >
Text File  |  1995-05-25  |  7KB  |  190 lines
  1. Name:    !Judith
  2. Purpose: Window iconiser
  3. Author:  Andrew Brooks (see end for addresses)
  4. Status:  FreeWare, copyright (C) 1995 Andrew Brooks
  5. Version: 1.43 Thu May 25 17:31:29 BST 1995
  6.  
  7. !Judith is a window iconiser that takes over from Pinboard,
  8. !Larger etc. (although they will continue to work as backdrops).
  9. Icons for iconised windows all go into a single window rather
  10. than ending up stuck to the backdrop so they are easier to access.
  11. Pinboard and !Larger place icons on the backdrop where they are
  12. difficult to access, and Pinboard even places them under the
  13. close icon of the window.  !Judith uses a window which may be
  14. brought to the front with the press of a 'hot key'.  Additionally,
  15. windows that are iconised and reopened will use the same icon
  16. position next time they are iconised, like X Window managers.
  17.  
  18.  
  19. Usage
  20. -----
  21. * Iconised windows go into a single window for ease of access.
  22. * Double click on an icon to reopen the corresponding iconised
  23.   window; the control window then goes to the back.
  24. * Closing the window quits the program and reopens all windows.
  25. * Hot key Shift-Ctrl-Tab brings the icon window to the front.
  26. * Iconised windows go back into the slot they held previously
  27.   rather than the first available so you can find them easily.
  28. * Iconised windows won't take an empty slot if the window that
  29.   was there previously is still open, in case it wants that slot
  30.   back again in the future.
  31. * Icons may be dragged to preferred positions.
  32. * The window can optionally resize automatically to hold its
  33.   contents comfortably.
  34. * Clicking Menu over an icon with Shift held down opens the menu
  35.   for the corresponding iconised window.
  36. * The options can be set using from a menu and saved for next
  37.   time.
  38. * Menu:
  39.   Auto shrink - when ticked, the window will shrink each time
  40.                 the last icon in the list is removed.
  41.   Go to back  - when ticked, the window will go to the back of
  42.                 the window stack each time an icon is double-
  43.                 clicked.
  44.   Small icons - when ticked, icons added to the window are half
  45.                 size.  Toggling this entry also changes the size
  46.                 of all existing icons.
  47.   Quit - reopens all iconised windows and exits.
  48.  
  49.  
  50. Configuration
  51. -------------
  52. The definition of the hot key is stored in the !RunImage file.
  53. It is a Wimp key number, see pages 3-122 and 3-123 in the RO3 PRMs.
  54.  
  55. The style of icons used can be altered by changing the template
  56. icons in the !Templates file.
  57.  
  58.  
  59. Notes
  60. -----
  61. * !Judith requires RISC OS 3 or later.
  62. * No visible distinction can be made between windows from the same
  63.   application which have the same title, eg. $.c.foo and $.h.foo
  64.   from !Zap will both show the title 'foo' (This is a problem with
  65.   !Zap).  This could have caused confusion if both were reopened and
  66.   then iconised again in a different order as they would be in
  67.   different slots.  Not so with this version of !Judith though, as
  68.   windows iconise to the same slot they occupied previously.
  69. * If the window being iconised has a window title which looks like
  70.   a pathname then the window title is used as the icon title. This
  71.   will allow you to distinguish between $.c.foo and $.h.foo
  72.   Only the last 20 characters will be used as that is the maximum
  73.   length that a title can be.
  74. * Use in conjunction with !Sticky (Brian Brunswick) or !StickBrd
  75.   (Sergio Monesi) for a productive working environment.  I wanted to
  76.   add these facilities to one or the other but one was written in
  77.   RISC_OSLib and the other came with no source!
  78. * The WimpSlot is currently 64k, it grew from 32k when I added the
  79.   menu.  It may work in less if you have a page size less then 32k.
  80.   You may have to increase it if you increase maxiconised%.
  81. * The gap at the bottom of the window is intentionally left blank!
  82.   It can be used when dragging to make the window larger [just like
  83.   defining the sort order in !Squirrel].
  84. * This program was greated with great help from:
  85.   o !Zap by Dominic Symes
  86.   o PRM Index by Andrew Brooks
  87.   o PRMs by Acorn Computers Ltd
  88.   o A310, 4M, 40M, standard resolution monitor
  89.  
  90.  
  91. Distribution
  92. ------------
  93. !Judith is FreeWare, not Public Domain, and comes with no warranty.
  94. You have permission to distribute !Judith as long as the following
  95. conditions are obeyed:
  96. * No charge is made for the software (only reasonable medium costs).
  97. * All copyright notices are clearly retained.
  98. * No files are added, removed or modified.
  99. * It is not bundled with other items for which a charge is made.
  100. You do not have to accept these terms, but if you do not accept
  101. them then nothing else grants you permission to own or distribute
  102. a copy of !Judith.
  103.  
  104.  
  105. Future improvements
  106. -------------------
  107. [ These are more likely to be implemented with some form of financial
  108. incentive, so if you wish to see them then feel free to send me a
  109. modest amount! ]
  110. * Better layout, such as multiple columns when full vertically
  111.   and auto icon widths.
  112. * Rewrite prototype in a 'proper' language and reduce memory needed.
  113. * Icon bar icon so it doesn't quit when window closed?
  114. * No fixed limit on number of windows that can be iconised
  115.   (ie. no arrays).
  116. * DragASprite?  I don't think it is appropriate.
  117. * Auto scroll window when dragging.
  118. * Shift or Adjust-double-click opens window but keeps icon
  119.   so window can be brought to the front easily.
  120. * Auto grow window when new icons added?
  121. * How about shading icons when reopening windows?
  122. * Add to RISC OS 3 boot sequence at shutdown.
  123.  
  124.  
  125. Hacks
  126. -----
  127. Returned messages have their sending task handle fixed.
  128. Indirected data and validation string data are stored twice,
  129. once in arrays (easy to access) and once in a buffer of which
  130. we can take the address.  If you donate code to find the address
  131. of a string then I will use it!
  132.  
  133.  
  134. Bugs
  135. ----
  136. Hmmm, tell me about it!
  137. * Errors loading/saving options are handled ungracefully.
  138. * Shift-Menu doesn't work for Impression windows (typical!).
  139. * On one occasion I iconsed filer window ADFS::Whopper.$ and it
  140.   had the title 'Stationary'!
  141. * Filer windows lie about the size of their indirected titles
  142.   (they say 14, even though it is much longer). Thus I cannot
  143.   reliably implement a check for windows still alive.
  144.  
  145.  
  146. History
  147. -------
  148. 1.43 If window title is a pathname then use it as icon title.
  149. 1.42 Added code to get window titles, but Filer windows lie.
  150. 1.41 Removed feature added in 1.30 until title checking is implemented.
  151. 1.40 Added Shift-Menu detection.
  152. 1.30 Added check for existing windows from empty slots.
  153. 1.20 Added icon dragging.
  154. 1.13 Fixed sprite name size bug.
  155. 1.12 Added interactive icon size toggling.
  156. 1.11 Fixed redraw bug when icon size toggled.
  157. 1.10 Added menu and options file.
  158. 1.00 First version.
  159.  
  160.  
  161. Why the name?
  162. -------------
  163. Well, we've had Sarah, Martin and Veronica to name but three, so why
  164. not Judith?  Besides, !Iconiser a bit of a boring name really…  (Oh,
  165. and I've just found out someone else has written one called just that!)
  166.  
  167.  
  168. Music
  169. -----
  170. Black Dog, "Bytes"
  171. DJ Shadow, "What Does Your Soul Look Like?"
  172. Paul Dolden, "On the Threshold of Deafening Silence"
  173. John Coltrane, "Ascension"
  174. Diesel Kings, "Purple Rain Etc."
  175. The Way We Live, "A Candle For Judith"
  176.  
  177.  
  178. Author
  179. ------
  180. Andrew Brooks
  181. http://www.sat.dundee.ac.uk/~arb/
  182.  
  183. arb@sat.dundee.ac.uk
  184. arb@ua.ndu.ac.uk
  185. arb@comp.lancs.ac.uk
  186.  
  187. Satellite Station, Dundee University, DD1 4HN, Scotland.
  188. Computing Department, Lancaster University, LA1 4YR, England.
  189. 7 Kennedy Close, Chester, CH2 2PL, England.
  190.