home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / fish / disks / d1079.lha / Programs / FlipIt / FlipIt.doc < prev    next >
Encoding:
Text File  |  1995-03-16  |  4.1 KB  |  130 lines
  1. FlipIt v2.0
  2.  
  3. FlipIt and this documentation are Copyright © 1994-95 by Michael Barsoom.
  4.  
  5. -+- License  -+-
  6.  
  7. FlipIt may be freely distributed as long as no charge is made other than to
  8. cover time and copying costs.  If it is to be distributed via floppy disk,
  9. this cost should be no higher than $3.00 (three) dollars US.  If distribution
  10. is via CDRom, the total cost should be no more than $25.00 (twenty-five)
  11. dollars US.
  12.  
  13. You may not copy and/or distribute this program without the accompanying
  14. documentation unless you get permission from the author to do so.  Fred Fish
  15. and Walnut Creek already have my permission to include this program on their
  16. CDRom collections.
  17.  
  18. You may not disassemble, decompile, re-source or otherwise reverse engineer
  19. the program.  If you wish to incorporate parts of this program into other
  20. programs, write to the author to ask for permission.
  21.  
  22. Finally if you wish to include FlipIt on a disk magazine you are REQUIRED
  23. to get the author's permission FIRST.  Usually this will require you to
  24. just send me a copy of the issue which contains FlipIt free of charge.
  25.  
  26. -+- Disclaimer -+-
  27.  
  28. This product is sold "as is" without representation or warranty of any
  29. kind, either expressed or implied.  The user assumes all risks and
  30. responsibilities related to its use.
  31.  
  32. -+- Introduction -+-
  33.  
  34.     FlipIt lets you install hotkeys for flipping through screens.
  35.     You can specify a hotkey to push the frontmost screen to the back,
  36.     and a hotkey to bring the rearmost screen to the front.
  37.  
  38. -+- Requirements -+-
  39.  
  40. 1) Workbench 2.0+
  41.  
  42. -+- Optional -+-
  43.  
  44. gtlayout library v9+  Copyright © by Olaf `Olsen' Barthel
  45. If gtlayout library is present you will be able to use the popup window.
  46.  
  47. The library will only be opened when you request the window to appear, and
  48. will be closed immediately after the window is closed
  49.  
  50. -+- Usage -+-
  51.  
  52. Either put it in WBStartup or put it in your user-startup.  If placed in
  53. your user-startup make sure you 'Run' it as FlipIt does not detache from
  54. the cli.
  55.  
  56. FlipIt understands the following ToolTypes/cli arguments.
  57. BACKTOFRONT=<hotkey>  hoykey to bring the back screen to the front
  58.                       default is 'rawkey rcommand down'
  59. FRONTTOBACK=<hotkey>  hoykey to push the front screen to the back
  60.                       default is 'rawkey rcommand up'
  61.  
  62. And the following standard commodities arguments.  
  63. Please see your WorkBench manuals for explaination.
  64. CX_PRIORITY=
  65. CX_POPUP=
  66. CX_POPKEY=        default is 'rawkey control lcommand f'
  67.  
  68. To quit FlipIt, send it a kill message from the Cx Exchange, or send it a
  69. ctrl-c with a TaskX like program.
  70.  
  71. -+- Commodities interface -+-
  72. The following is available only if you have gtlayout installed.
  73. To see the interface press the popup kotkey, select show interface from the
  74. exchange, or run FlipIt again.
  75.  
  76. The interface is divided into three sections
  77. 1) Configure the screen flipping hotkeys
  78.     Here you specify the hotkey for flipping through the screens.  If you
  79.     type and invalid hotkey sequence, the last hotkey will reappear.
  80.  
  81. 2) Configure the commodity
  82.     Here you can change the standard commodity options
  83.  
  84. 3) Action keys
  85.     Use        - this will close the window and change all the options to
  86.               those specifed above.
  87.     Save    - this will save the options in the icon
  88.     Quit    - quit FlipIt all together
  89.  
  90.     Close gadget - this will close the window and cancel all changes made
  91.  
  92. -+- Thanks -+-
  93.  
  94. To my loving wife Barbara.
  95.  
  96. -+- Bugs, Suggestions -+-
  97.  
  98. you can reach me at:
  99.  
  100. Michael Barsoom
  101. 5524 Pine Street
  102. Omaha NE 68106
  103. USA
  104.  
  105. Internet:  mbars@bluejay.creighton.edu
  106. Fidonet:   Mike Barsoom @ 1:285/5.9
  107.  
  108. -+- History -+-
  109.  
  110. v1.0
  111.   o First Release
  112.  
  113. v1.1
  114.   o Added DisplayBeep() to notify user if FlipIt is rerun
  115.   o Forgot to put $VER: in version string
  116.   o Reduced stack usage.
  117.   o If run from a shell 'FlipIt' will be the task name instead of
  118.     'Background Process'
  119.   o Optimized code, saving a few bytes.
  120.  
  121. v1.2
  122.   o No longer will hang if you try to flipping through screens just
  123.     as a new screen is opening.
  124.  
  125. v1.3
  126.   o Optimized the code quite a bit, reduced size of executable in half.
  127.   o Other minor fixes.
  128.  
  129. v2.0
  130.   o Added commodities interface.  This feature requires gtlayout.library