Amiga ISO Collection/AmigaUtilCD2.iso/Workbench/Misc/closew16.lha/CloseWB_1.6/CloseWB.DOC

Text File | 1994-12-05 | 7.4 KB | 174 lines

                          CloseWB version 1.6
                       © 1994 by Stefano Reksten
                     of 3AM - The Three Amigos !!!


 CONTENTS OF THIS FILE:

 o DISCLAIMER
 o COPYRIGHT
 o WHAT'S CLOSEWB?
 o WHAT DOES CLOSEWB NEED?
 o WHY COULD YOU NEED CLOSEWB?
 o USING CLOSEWB
 o HISTORY
 o KNOWN BUGS
 o HOW TO CONTACT THE AUTHOR


 DISCLAIMER
 ---------------------------------------------------------------------------
 The author is  NOT  responsible for  the  suitability or  accuracy of  this
 documentation and/or the program(s)  it describes.  Any damage  directly or
 indirectly caused by the use or  misuse of this  documentation  and/or  the
 program(s) it describes is the sole responsibility of the user her/him self
 ---------------------------------------------------------------------------


 COPYRIGHT
 ---------------------------------------------------------------------------
 CloseWB v1.6, Copyright  ©  1994  Stefano  Reksten.  All  rights  reserved.
 This program may be distributed  non-commercially only  providing that  the
 executable,  source  code,  documentation  and   copyright  notices  remain
 unchanged and  are included with the distribution.
 The archive must contain the following files:

    CloseWB_1.6/
        CloseWB
        CloseWB.c
        CloseWB.DOC
        CloseWB.DOC.info
        CloseWB.info
    CloseWB_1.6.info

 This program is CARDWARE.  That means, if you use it, what about sending me
 a postcard from your city/country?  My address is at the end of this file.
 ---------------------------------------------------------------------------


 WHAT'S CLOSEWB ?
 ---------------------------------------------------------------------------
 A small proggy that rids you of the Workbench screen.  «But why should I do
 close the WB screen ?»  If you are in need of CHIP ram, or, like me, if you
 are fed up with passing from CED to DM2 passing always thru' WB screen!
 But, CloseWB is able to reopen the WB screen, too!!! ;-)
 (That can be useful if using DPaint or DSS, or some other proggies that use
 to close WBscreen. You don't want to go search through the menues to reopen
 the screen, just press a couple of keys and hey presto...)
 An ability of CloseWB is to try to automatically close all drawers and quit
 all programs that have a window open on  Workbench screen (the A.C.O. ...or
 Automatic Closing Operation).  Of course, once quitted these  programs will
 NOT be automatically rerun when Workbench is reopened, it's up to you!!!
 That was made just to speed-up the closing operations, and moreover it DOES
 free more memory  :-)    This A.C.O. feature will not try to close a window
 called "Workbench" or with no name, that's to prevent Workbench application
 to be quitted! ...But, if you want to do so, you have my source...
 Moreover, to gain more memory CloseWB can try to flush all unused libraries
 devices and fonts you have in RAM.
 ---------------------------------------------------------------------------


 WHAT DOES CLOSEWB NEED?
 ---------------------------------------------------------------------------
 o    Any Amiga with kickstart 2.0 or higher.
 ---------------------------------------------------------------------------


 WHY COULD YOU NEED CLOSEWB?
 ---------------------------------------------------------------------------
 Because it's *small*,  it helps you freeing memory and closing every window
 on Workbench screen by just pressing some keys...   And there are not other
 programs like this around!!!
 ---------------------------------------------------------------------------


 USING CLOSEWB
 ---------------------------------------------------------------------------
 To install  CloseWB  just  drag it in  the  Commodities' drawer, or in  the
 WBStartup drawer if you want it to run from the very beginning.
 If you launch CloseWB from CLI you can kill it with CTRL_C.  The shell from
 which CloseWB was launched can be closed if it launched with "runCloseWB".
 To launch CloseWB from Workbench just click twice on its icon.  To kill it,
 use the Exchange commodity or CloseWB's GUI.
 To switch on or off the A.C.O.,  just set to TRUE or FALSE the CLOSEWINDOWS
 and CLOSESHELLS tooltype argument. You can set these two to TRUE and CLOSE-
 WORKBENCH to FALSE to just have to tap two keys to close everything in WB!
 The hotkey is the (combination of) key(s) that must be pressed in order to
 close everything; the popkey is the (combination of) key(s) that must be
 pressed to get to the program's GUI. Of course you can use Exchange, but a
 popkey is faster. If a tooltype is not present it will be set to TRUE (or
 to (ctrl+lalt/lalt) + w if it is the (pop/hot)key).
 To make CloseWB flush all the unused libraries, devices and fonts from RAM,
 set to TRUE the FLUSH tooltype or select the checkbox gadget.
 Of course Workbench won't be closed if there are still some locks on it.
 ---------------------------------------------------------------------------


 HISTORY
 ---------------------------------------------------------------------------
 v1.0 : Program created (930604, at 4.35 A.M. :-)

 v1.1 : If Workbench can't be closed, a DisplayBeep warning message is sent.
        (Thanks to Sergio Ruocco for the idea.)

 v1.2 : (internal release)
        Workbench is found and closed. If it can't be done, a requester will
        pop up, asking you to close all the windows and shells first.
        (Of course you don't need to close the drawers...)

 v1.3 : A.C.O. added. (Doesn't work on shells yet.)

 v1.4 : A.C.O. completed, works on shells.
        GUI added.
        Library flushing added (thanks to Luca Viola for the idea).
        It is possible to select what should be closed.
        ...NOW this is what I call a Commodity!!! ;-)

 v1.5 : Pops up window instead of quitting if re-launched.
        Device and Fonts flushing added.
        ("Flush Lbs" gadget changed to "Flush" due to that.)

 v1.6 : Bugs from 1.5 removed, CloseWB.DOC corrected. I must apologize for
        that, but v1.5 was really made in a hurry and I did not tested it
        very well. Made font-sensitive... and smaller than before! (941204)
 ---------------------------------------------------------------------------


 KNOWN BUGS:
 ---------------------------------------------------------------------------
 If you start to play fast with the hotkey and your Amiga isn't fast enough,
 you will be asked  to close the windows and the shells. Moreover,  I leaved
 the  DisplayBeep alert there  because playing too fast  with this commodity
 would crash your system.  Well, it shouldn't be MY fault, but then...   YOU
 tell the guys at CATS! :-)

 NOTE:
 Please note that if CloseWB has closed a window like that of Multiview, who
 takes a little time to clean up, you could get a "Close all" requester. For
 that, I am going to do *absolutely nothing*. I don't want to insert a delay
 routine. I like speed!

 INCOMPATIBILITY:
 CloseWB can't close a KingCON 1.3 shell,  although it managed to close KCON
 1.0 shells.
 ---------------------------------------------------------------------------


 HOW TO CONTACT THE AUTHOR
 ---------------------------------------------------------------------------
 I tested this program with a MMU on my accelerated A1200,  and it seemed to
 work correctly. If you find any bug or have some brilliant ideas or want to
 tell me how much time I am losing doing stupid proggies like this,  or any-
 thing else, write to:

 [e-mail]

 Stefano Reksten c/o Naimi
 v.le Cavour, 40
 53100 Siena
 ITALY
 ---------------------------------------------------------------------------

<EOF>