home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / shells / closewd.lha / CloseWD.doc < prev    next >
Text File  |  1992-10-11  |  7KB  |  255 lines
  1.  
  2.  
  3.                                Documentation
  4.  
  5.  
  6.                               CloseWD Version 1.2
  7.  
  8.  
  9.                              written 1992 by H.P.G
  10.  
  11.  
  12.                                    FreeWare
  13.  
  14.  
  15. Index:
  16.  
  17.         Index
  18.         History
  19.         General Description
  20.         System Requirements
  21.         Legal Stuff
  22.         Installation
  23.         Using CloseWd
  24.         Cli-Parameters
  25.         Technical
  26.         Last
  27.         Address
  28.         List of Files
  29.  
  30.  
  31. History:
  32.  
  33. Version 0.1 - 0.7
  34.  
  35.         Versions for Kickstart 1.3. Without user-interface.
  36.  
  37. Version 0.8
  38.  
  39.         First version for Kickstart 2.xx. Without GadTools-userinterface
  40.  
  41. Version 0.9
  42.  
  43.         New, Using a GadTools-userinterface.
  44.  
  45. Version 1.0 - 1.1
  46.  
  47.         Enhancements. Several commandline options added.
  48.         CW can be startet via WBench.
  49.  
  50. Version 1.2
  51.  
  52.         Better design. Now CW looks for the window by name.
  53.         Now it supports Pattern-Matching. Added new ask-function.
  54.  
  55.  
  56.  
  57. General Description:
  58.  
  59.  
  60.     First:
  61.  
  62.     CloseWd is a OS 2.xx only tool. That means it doesn`t run under
  63.     Kickstart 1.2 and 1.3.
  64.  
  65.     An usual problem: There is a program which end but its window is
  66.     still be opened.
  67.  
  68.     To get rid of all those forgotten windows you can now use CloseWd.
  69.  
  70.     CloseWd [CW] first opens its window with several gadgets on it.
  71.  
  72.     By using one of the supported ways you are able to chose the window
  73.     you want to be closed.
  74.  
  75.     CW has a GadTools user interface. For each gadget exists an aquivalent
  76.     key you can press instead of click on a gadget.
  77.  
  78. System Requirements:
  79.  
  80.     You need at least OS 2.xx version 37L. Version 36 missed some
  81.     function features.
  82.  
  83. Legal Stuff:
  84.  
  85.  
  86. This program and all files come with it also the docfiles are released
  87. as FREEWARE.
  88.  
  89. this means:
  90.  
  91.     everybody may use CloseWd,
  92.  
  93.     everybody may copy CloseWd, if:
  94.  
  95.         1. you copy all included files see list below
  96.         2. no changes are made , this means the program amd all included files
  97.             must stay in the origin form. Exception: you may archieve it ; but
  98.             in this way you must also archieve the whole package.
  99.         3. if you recompile it, you have to include a notice to the original
  100.             author. if you also want to (re)distribute in this form you have to
  101.             send me a copy.
  102.         4. you may not sell CloseWd
  103.                 except:   you`re allowed to take a small copy fee which
  104.                             may not extend 5$.
  105.         5. if you want to include CloseWd or one of the included files as a part
  106.             of a commercial package, you must have written permission of the
  107.             author (address see below)
  108.  
  109.  
  110. I take no warranty or garanty for the function of this program.
  111. The whole risk of using it stays by the user.
  112.  
  113.  
  114.  
  115.  
  116. Installation:
  117.  
  118. CloseWd can be startet from CLi or from WBench.
  119.  
  120. If you want to start CloseWd mainly via Cli you should copy it
  121. into your C: directory or in any other directory in your current
  122. AmigaDOS searchpath.
  123.  
  124. If you will instead start CW mainly via WBench you can copy
  125. CW to any place just by dragging its icon to the drawer you
  126. want CW to be located.
  127.  
  128.  
  129. Using CloseWd:
  130.  
  131. Starting CW opens its window which contains several gadgets.
  132. There are two kinds of finding the window you want to be closed.
  133.  
  134.  
  135. 1. By activating the window:
  136.  
  137.     Therefor you must activate the Time gadget or type 'i'.
  138.     You can specify a delay time by type in the value into the Wait
  139.     gadget. Then CW delays the given time before searching for the
  140.     activated window.
  141.     If you e.g. want to close a window on another screen than WBench,
  142.     it can take a time to bring this screen to front and activate the
  143.     right window. If you have specify a delay value of 20 sec. CW waits
  144.     20 seconds before searching the active window.
  145.  
  146.  
  147.     Take Care:
  148.  
  149.           It will always delayed until the given time is finished.
  150.           There is no way to break this delay. All other instructiones
  151.           are in this time absolutely ignored. When the time delay has
  152.           finished, the screen will flash. You should take care not to
  153.           activate any other window before you see the flashing or the
  154.           wrong window may be closed.
  155.  
  156.  
  157. 2. By specifying the name of the window:
  158.  
  159.     Therefor you must type in the first chars of the window title in the
  160.     Title Stringgadget.
  161.     If CW finds a match for the name the found window will be closed.
  162.  
  163.  
  164. CloseWd has just another useful option, the ask-option.
  165. To use this option you must activate the Ask gadget (the hook must appear).
  166. The ask options support both window searching ways. If activated CW askes
  167. now for confirmation before closing any window.
  168.  
  169. The 'Okay try to ....' gadget starts the searching.
  170. With Cancel und Quit you can end the program.
  171.  
  172. Instead clicking on a gadget you can type the underline key of the gadget
  173. label.
  174.  
  175. Instead clicking the Zoom gadget (Iconify) you can type 'z'. Typing z or
  176. pressing the Zoom gadget again brings up the big window on the old place.
  177.  
  178. Instead using the Closegadget you can type 'q'.
  179.  
  180.  
  181. WARNING:
  182.  
  183. * You must not close windows which still be used by another program or
  184. * application.
  185. * This can lead to crashes. You should ever use the ask-option.
  186. * You should never use CW while another program is still reading or writing
  187. * something to a disk or harddisk, because you can never be sure if a window
  188. * is still be used by another program or task. In this case you can lose
  189. * datas.
  190.  
  191. Cli-Parameters
  192.  
  193. Starting CloseWd via CLI you can specify the following arguments:
  194.  
  195.  
  196. Syntax: CloseWd [Title][ASK/S][DELAY/N]
  197.  
  198.     with
  199.  
  200.         Title       specifies the title of the window gadget which will be displayed
  201.                     when CW first opens.
  202.  
  203.         ASK         if you specify ASK the ask gadget is activated when CW starts
  204.  
  205.         DELAY       you can specify the number which will be displayed in the
  206.                     wait gadget when CW first starts.
  207.  
  208.  
  209.  
  210. Technical:          CloseWd doesn`t use a ListView-gadget to display all
  211.                     opened windows. The allocation of a list and the nodes
  212.                     would takes too much time and results on a bigger
  213.                     code.
  214.                     CloseWD uses the new features of the DOS and GadTools.
  215.                     libraries.
  216.                     CW was compiled with the Aztec C Compiler Version 5.2a.
  217.  
  218.  
  219. Last:
  220.  
  221.         I hope there is no need to use CloseWd very often. Because CloseWd
  222.         is only used when another program has a bug and cannot close its
  223.         opened windows by termination.
  224.  
  225.         Nevertheless I hope this is a useful program.
  226.  
  227.         If there are any BUGS in this program please let me know
  228.  
  229.  
  230.         Have fun ...
  231.  
  232.  
  233. Address:
  234.  
  235.  
  236.             Hans-Peter Guenther
  237.             Gruener Weg 5
  238.             3501 Fuldatal 2
  239.             Germany
  240.  
  241.  
  242. List of files:
  243.  
  244. (If you miss one of the following files, your release is incomplete)
  245.  
  246. CloseWD            : The binary
  247. CloseWD.info
  248. CloseWd.doc        : Englishe manual
  249. CloseWd.doc.info
  250. CloseWd.dok        : German manual
  251. CloseWd.dok.info
  252.  
  253. ----------END
  254.  
  255.