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