[net.sources.mac] MegaWatcher.doc

maclab@reed.UUCP (S.Gillespie/Mac Dev. Lab) (10/13/85)

You may remember the 'SegWatcher' desk accessory I posted a few weeks back: 
here is the documentation for a new improved version, MegaWatcher.  MegaWatcher
displays information about any type of resource (instead of just 'CODE').
All the bugs that I know about have been fixed (some SegWatcher crashes were
caused by incorrect handling of activate events).

I have posted MegaWatcher to net.sources.mac:  it is in apple Font/DA mover 
format, and must be converted with BinHex 4.0.

As usual, it was written with the Rascal Development system, and I will send 
source on request (and as usual, it is in the public domain).


Scott Gillespie
Reed College


{decvax, ucbvax, pur-ee, uw-beaver, masscomp, cbosg, aat,
 mit-ems, psu-cs, uoregon, orstcs, ihnp4, uf-cgrl, ssc-vax}!tektronix 
                                                                \
                                                                 -!reed!maclab 
{teneron, ogcvax, muddcs, cadic, oresoft, grpwre,               /
          harvard, psu-cs, omen, isonvax, nsc-pdc}-------------+




MegaWatcher.Doc

V.85.10.12.spg

     MegaWatcher is a Desk Accessory which tracks the loading and unloading of  
resources.  You may specify any resource type (CODE is the default), and 
MegaWatcher will keep a continuous display of all resources of that type.  
With MegaWatcher, you can determine the size, location, and status (in memory, 
locked, and/or purgeable) of each resource.

THE DISPLAY
MegaWatcher defaults to a small display, with type 'CODE' selected.  In the 
upper left corner of the window, the current type is displayed; each 
subsequent line displays the status of a resource.  The resource ID's are 
displayed along with boxes which indicate:

          (M) -- Segment is in Memory           
          (L) -- Segment is Locked          
          (P) -- Segment is Purgea
          (P) -- Segment is Purgeable.

As long as the current application calls SystemEvent regularly (as it  
should), MegaWatcher will update itself 2 times per second.  MegaWatcher will 
only display the first 26 or so resources of a given type.

THE MENU

Front: Select 'Front' to make the MegaWatcher window become the front window.
Back:  Select 'Back' to make the MegaWatcher window become the back-most 
       window.
Hide:  Causes window to disappear (it will reappear again when you select 
       'Back'  or 'Front'

Wide Display: Toggles window size:  when Wide Display is checked, MegaWatcher
       will display locations and sizes of resources, in addition to the 
       normal information.
Private:  Toggles 'Private' flag:  when Private is selected, only resources 
       owned by the current application will be displayed; if Private 
       isn't selected, all resources of the specified type are displayed.
New Type:  Select 'New Type' when you want to look at a new resource type.
       MegaWatcher will prompt you for the resource type:  Upper/Case 
       is toggled by the Shift Key, but the mapping is backwards 
       (shift-x -> X).  Enter the resource type, then hit <Return> :  
       the new type will be added to the MegaWatcher menu, and all 
       resources of that type will be displayed.

Other Menu Items:
       Each time you examine a new resource type, that type will be added to
       the menu:  if you want to re-display a type, just select the type
       from the MegaWatcher menu.


A typical MegaWatcher display might look like this (interpretation follows):

---------------- |
DITL  #  M  L  P |
    255  X  X  X |
    229          |  
    302  X       |  
    306          |  
    444  X  X    |  
    220  X     X |  
    165          | 
------------------

A display such as that above, would indicate the following:

-- DITL ID=255 is in memory, and Locked, and Purgeable 
-- DITLs 229, 306 and 165 are not in memory.
-- DITL 302  is in memory, and is neither locked nor purgeable. 
-- DITL 444 is in memory, and locked.
-- DITL 220  is in memory, and is purgeable. 


Mouse Clicks:  Click in the MegaWatcher window to cause window to be
re-drawn.  Click and hold mouse button down: MegaWatcher will freeze everything
until you let up on the button.


Historical Note:
   If you select Cut/Copy/Paste, MegaWatcher will disappear for a few seconds, 
then reappear.



---- End of documentation.