home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / utilities / backicon / !BackIcon / !Help < prev    next >
Encoding:
Text File  |  1994-09-18  |  8.3 KB  |  170 lines
  1. Back Icon version 1.00
  2. © Sam Kington 19th August 1994
  3. This program is freeware, *not* public domain – i.e., I retain copyright (see
  4. “Boring legal message”).
  5. This module will only work with RISC OS 3 or later.
  6.  
  7. What this program does
  8. **********************
  9.  
  10.    For a start, this program is essentially one small module, BackIcon, which
  11. at about 1400 bytes is considerably smaller than the whole application, which
  12. weighs in at slightly more than 20K, of which most is the source code and
  13. this help file. If you decide you don’t need the whole application cluttering
  14. up your hard disc or floppy or whatever, you can put the module somewhere else
  15. (!System.Modules would be a good place), and RMLoad it in your Boot sequence.
  16. If you decide you don’t want *any* of the application, of course, you can
  17. delete the whole thing.
  18.  
  19.    So what does it do? Basically, it livens up the boring old Back icon – the
  20. button on the title bar of a window, furthest to the left, that sends a
  21. window to the back of the pile of windows. For all the buttons on a window,
  22. clicking Adjust or clicking with Shift held down does something something
  23. different from clicking Select – apart from the Back icon. This tragically
  24. inadequate state of affairs is now resolved ;).
  25.  
  26.    So, with the module loaded, this is how the Back icon behaves:
  27.       • Clicking Select sends the window to the back (no change)
  28.       • Clicking Adjust brings the window to the front, like Select-clicking
  29.         on the title bar or the Resize icon except that the window cannot be
  30.         accidentally moved or resized by accident.
  31.       • Clicking Shift-Select moves the window towards the front by one
  32.         step, moving it above the window that was immediately above it.
  33.       • Clicking Shift-Adjust, predictably, moves the window towards the
  34.         back by one step, so that the window immediately behind it is now in
  35.         front of it.
  36.         
  37. OK, but why is this useful?
  38. ***************************
  39.  
  40.    First of all, you now have a third way of bringing a window to the front
  41. (not counting things like KeyMouse or any other modules like that). It’s not
  42. earth-shattering, but it’s quite handy if you get paranoid about
  43. accidentally changing the finely-tuned position of your windows ;).
  44.  
  45.    The major difference, however, is that you can now control the position of
  46. windows in the stack with more precision. Often you will have a stack of
  47. windows, of which only some are useful at any given point; the others will be
  48. sitting there because they might come in handy at one point, but at the
  49. moment they will just get in the way. So if you have a main window covering
  50. most of the screen, and you decide you want one of the windows behind it, you
  51. will usually click on the Back icon, look in horror at all the masses of
  52. windows that had suddenly appeared, do what you wanted to do with the window
  53. you were looking for, then spend quite some time clicking on all those
  54. windows’ back icons to try and get your main window back. You may say, “you
  55. can always click on the title bar”, but often the title bar will be obscured.
  56.  
  57.    Now you can Shift-click on the back icon to move through the window stack
  58. one by one. If the window that appears was the one you wanted, you’ve got a
  59. much less cluttered screen than if you had clicked without Shift; if it
  60. isn’t, then you can consign it to the oblivion at the bottom of the stack it
  61. deserves. You can bring windows forward in the stack without bringing them
  62. all the way, and then having to bring other windows to the front, that should
  63. have been in front of it. And you can browse the window stack, holding down
  64. Select, clicking Select to go down, Adjust to go up. It beats window cycling
  65. utilities, that mindlessly go through all the windows, including the ones you
  66. know you didn’t want: if you don’t want to see a window, you won’t have to
  67. unless you really want to.
  68.  
  69. Limitations
  70. ***********
  71.  
  72.    First of all, Back Icon doesn't know about pane windows – open a window in
  73. front of a Draw window (with tool window open), shift-Select-click on the
  74. close icon, and see what happens.
  75.  
  76.    Also, sometimes you will shift-click on the back icon and nothing seems to
  77. have happened. This is because a window can be directly “in front” of another
  78. window, without overlapping it – if you have two windows side by side, one
  79. will be “behind” the other, even though they don’t look like it.
  80.  
  81. Miscellanea
  82. ***********
  83.  
  84.    BackIcon knows about Desktop Saves, but it needs a little help, namely the
  85. variable BackIcon$Module. This is set automatically if you run it from the
  86. application, but if you just run the module on its own the variable won't be
  87. set. If it can't find a variable, BackIcon assumes it was run as
  88. System:Modules.BackIcon; if that wasn't the case, set the variable before you
  89. run the module.
  90.  
  91. Boring legal message
  92. ********************
  93.  
  94.    This application is freeware, that is, it can be distributed freely as
  95. long as only reasonable charges are made for media and distribution. I retain
  96. copyright on all program code and documentation.
  97.  
  98.    This software is supplied “as is”: I make no warranty, expressed or
  99. implied, of the merchantability of this software or its fitness for any
  100. particular purpose. In no circumstances shall I be liable for any damage,
  101. loss of profits, or any indirect or consequential loss arising out of the use
  102. of this software or inability to use this software, even if I have been
  103. advised of the possibility of such loss.
  104.  
  105.    In other words, if your computer crashes, blows up, you lose all your work
  106. etc. all because of Back Icon (unlikely I know), don’t blame me.
  107.  
  108. Distribution
  109. ************
  110.  
  111.    You must distribute all files intact, including source code and this
  112. documentation, with this package – in other words, the files !Boot, !Run,
  113. !Sprites, BackIcon, ModSource, !Help and Vsn100. Feel free to muck around
  114. with it as much as you like when it’s on your machine, but distribute the
  115. original files, please.
  116.  
  117.    You can use bits of it in your own programs, provided you state clearly in
  118. the documentation and, if provided, the source code, which bits you borrowed.
  119. Feel free to slag off my programming style, but give me a credit please.
  120.  
  121. About all these strange foreign characters in this file
  122. *******************************************************
  123.  
  124.    OK, so if you’re reading this on a PC or a Mac or another strange machine
  125. like that, you may be wondering what all these strange ae things are. Well,
  126. they’re quotes (sorry, there was another one), dashes, ligatures, etc.
  127. Honest. But not on all machines...
  128.    Basically, character sets are only standard up to character 127, which is
  129. basically alphanumerics and a few standard punctuation marks. Foreign
  130. characters, typographical oddities like quotes and ligatures, and other more
  131. obscure symbols are “non-standard”, and each computer often has its own idea
  132. of where they should go in the character set. So don’t worry: even if it’s
  133. hard to read on your current machine, it won’t be on an Acorn machine. It may
  134. look slightly strange if you’re using the System font, however.
  135.    But why am I using these strange characters in the first place? Well,
  136. they’re in the character set and they look nice in an outine font, and I’ve
  137. written a program called Smart Quotes (sorry for the plug) that substitutes
  138. these sort of characters automatically, and I’ve got it turned on at the
  139. moment...
  140.  
  141. How to contact me
  142. *****************
  143.  
  144. All bug-reports, suggestions, comments or indeed any feedback at all will be
  145. welcomed. Here’s how to get to me:
  146.  
  147. E-mail     : 9262861k@arts.gla.ac.uk, 926286ki@udcf.gla.ac.uk during term-time
  148.              These should be OK until June 1996
  149.              At Christmas, Easter and during the summer, you can get me at
  150.              wombat@altern.com, wombat@email.teaser.com or sam@altern.com, in order
  151.              of preference (that is, if mail bounces off one of these or I don’t
  152.              answer within a week send to the next one).
  153.  
  154. Snail-mail : My term-time address, at least until June 1995, is:
  155.              Sam Kington
  156.              Flat 2/1
  157.              44 Hotspur Street
  158.              Glasgow G20 8NL
  159.              SCOTLAND
  160.              
  161.              Again, a backup is the home address – anything that goes here will get
  162.              to me eventually.
  163.              Sam Kington
  164.              Merlhiot
  165.              24420 Savignac les Eglises
  166.              FRANCE
  167.  
  168. Term-time is October to June, with bits off at Christmas (3 weeks) and
  169. Easter (4 weeks).
  170.