*******************************************************************************

                             »»» IconSpy v1.2 «««

                       Beetware © 1994 The Beet Research

                         written by Grzegorz Calkowski

*******************************************************************************


Well, some legal fuss first...


DISCLAIMER
----------

    The  program  executable, its source code and information above is provided
"as  is".   No  representations  or  warranties  are  made  with respect to the
accuracy,  reliability, performance, currentness, or operation of this software
and  information,  and  all use is at your own risk.  The author doesn't assume
any  responsibility  or  liability  whatsoever  with respect to your use of the
program and information.


COPYRIGHT
---------

    SmartWB  is  published under "BeetWare" conception.  It's very special sort
of  GiftWare.   It means you should send a beet to the author (but not a rotten
one!   8).   Well, if you run short on beets send a disk or a small donation or
anything else.  (Have a hint:  a bottle of beer would be excellent...  :)

This program can be freely distributed under following conditions:


1. Everything in this distribution must be kept together & unaltered.
   Applies to:
     - IconSpy			(the program itself)
     - IconSpy.doc		(this doc file)
     - IconSpy.doc.info
     - IconSpy.info		(the icon, in MagicWB style :-)
     - src/IconSpy.s		(source code)
     - src/include/gcmacros.i	(my asm macros used in the source)

2. Copyright notices are not removed from the source, executable and
   documentation.

3. No more then a nominal fee is charged to cover cost of magnetic media.

IconSpy is Copyright (C) 1994 The Beet Research. All rights reserved.


INTRODUCTION
------------

    IconSpy  is  a  very simple proggie which monitors calls to GetDiskObject()
and FindToolType() functions in icon.library.  It will show you any attempts to
load  icons  or,  what  is more important, to find icon tool types.  Very often
applications  get  some  options, preferences and so on via tool types.  And if
the  doc  files  are  lost somewhere in the universe you simply don't know what
tool  types  programs looks for!  Using IconSpy you can also discover some even
secret tool types!  (Try it with IconEdit from Workbench3.0 :).


USAGE
-----

    IconSpy  can  be used from Shell and from Workbench as well.  When launched
from  Shell  IconSpy  automatically  detaches itself from Shell and runs in the
background.

       Options from Shell:

	  WINDOW <str>		: Set other output for IconSpy. As a side
				  effect not only console window can be
				  specified but a filename, too. WINDOW
				  can be abbreviated with WIN. Examples:

				  WINDOW="CON:0/200/640/100/IconSpy Window"
				  WINDOW ram:iconspy.out
				  WIN="CON:"
				
				  NOTE: In case of window make sure that
				        its size is at least 640 pixels wide
					or the window's contest will be
					distorted.
					
	  WBENABLE		: Enable tracing for calls made by Workbench
				  tasks. By default it's disabled to avoid
				  unusable mess in the window.

       Recognized Tool Types:
       
	  WINDOW=<str>		: See above.
				  Note: you cannot use the abbreviation.

	  WBENABLE		: See above.  
				  

    In  program  window  you  type  CTRL-C to exit IconSpy, or CTRL-D/CTRL-E to
disable/enable monitoring respectively.  It's a little-SnoopDos-like :)

NOTE: IconSpy requires Kickstart V37 (2.04) or above to run!
  


OTHER
-----

    No  doubt, IconSpy is really very small (3000 bytes, exactly :-) and simple
program,  so  I  don't  think  there will be any _major_ update Therefore don't
except  too much for future.  Especially GUI (scroll-bar, yeah...) and so on...
If  you  want  to  have  a scroll-bar (which is indeed very useful) use console
replacement  called  King-CON.   You  really  should  use it!  (Thanks to David
Larsson for such a great work!).

    Note  that  included  icons  are  in  MagicWB  style.   If you still prefer
4-colour-ugly-look you will have probably to change them.



CONTACTING THE AUTHOR
---------------------


    IF you find any bugs (or for any other reason), please contact me (only by
Snail, pity):

        Grzegorz Calkowski
        Rzedowice
        ul.Dobrodzienska 8
        42-780 Dobrodzien
        POLAND


                                "Beeting is believing..."

                                            Signed: GC 8-1


*******************************************************************************

                                   HISTORY:

v1.0 (09/08/94)

  o First release. (No doubt, easy to find bug here :-)


v1.1 (30/08/94)

  o Window now autosizes to system default font.
  o IconSpy now refuses to run if there is one already launched.
  

v1.2 (27/10/94)

  o IconSpy didn't refuse to run again if was launched from Workbench. Fixed.
  o Version string was incorrect. Fixed.
  o Icon for this doc file included.
  o Small optimizations.