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

				 TYCOON 1.07

 *************** NOW WITH DRAG-AND-DROP SUPPORT FOR "OffiX" *******

			   Last updated 24/08/96.

******************************************************************************
NOTE: This file might not be updated to the latest state of the code

*******************************************************************************
WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
*******************************************************************************
      FORMAT OF THE TYCOON CONFIGURATION FILES HAD CHANGED DRASTICALLY
                     STARTING WITH VERSION (1.07a).
       LOOK AT THE EXAMPLE dot_tycoon TO FIGURE OUT HOW TO CHANGE YOUR
           EXISTING .tycoon OF VERSION PRIOR 1.07a TO A NEW FORMAT.
*******************************************************************************
WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
*******************************************************************************



General Information:
--------------------

   The program adds nicely shaped icons a little bit like those of window
manager. You can launch programs by clicking on them. The layout of the icons 
is remembered and restored on the next run.
   One interesting thing about this utility - it does not depend on any window
manager. For example, if you are using olvwm or mwm but like to have feature 
like FvwmButtons (GoodStuff) of fvwm, this package can provide you with 
similar functionality.
   Ah, almost forgot - why I named this program tycoon ? Very simple -
tycoon is improvised abbreviation for Tool Icons :).
   The snapshot of the current state of this program can always be
found at ftp://shani.net/pub/mitnits. Please note that I do not keep exact
version control information at ftp://shani.net/pub/mitnits, look at the DATE
of the file to figure out latest version, or use sunsite.unc.edu for
latest "released" version. At ftp://shani.net/pub/mitnits I will put
binary distribution of tycoon, including all utilities and config files
I am using to get the most of this cute little thing.

Installation:
-------------

   Untar the package like this:

> zcat tycoon-1.##.tar.gz | tar xvf - 
> cd tycoon-1.##

  There's file called Imake.conf that holds customizable paths and compiler
  flags that you might want to tp tweak. For example, if your XForms include
  files and/or libraries are located in unusual locations, adjust LIB_PATH and
  INCLUDE_PATH in Imake.conf.

  Then do the following:
   
> xmkmf -a
> make
> make install

NOTE: The package includes components based on *latest* XForms toolkit.
      Get the version 0.81 of toolkit and install it before you compile tycoon.
      It is available via FTP at laue.phys.uwm.edu:/pub/xforms/
      If you have older version, tycoon won't compile. 

      
      *****    WARNING - STUPID XFORMS     *********
      
      Please get the latest version of XForms 0.81 from
laue.phys.uwm.edu:/pub/xforms/  EVEN IF YOU THINK THAT YOU HAVE IT!
Xforms maintaners did not care to change version number when they fixed one
bug in previuos 0.81 release. If some of the goodies in Tycoon (notably -
xbackdrop) crash with veird X message - it's the sure sign you got wrong
library.
      
      ***** END OF WARNING - STUPID XFORMS *********      
      
   Then you need to run 
   
> make install

  All files and components of tycoon package will get installed. You will
need to be root to do it.

> tycoon &

  It will read the configuration file and wait for your orders.
  At first run you will probably get message like:

  open ini-file: No such file or directory
  Trying to use system-wide defaults.
 
  You can safely ignore it. Basically it means that from now tycoon
  will use $HOME/.tycoon as it's custom ini-file.
 

Configuration:
--------------

   Check out dot_tycoon file for the format - it's pretty obvious.
Don't EVER mess with editing this file by hand. Either use command line
tycoon invocation, OR <better> use GUI utility called tyman I 
am supplying with tycoon. 
   As from version 1.07d, tycoon icons have attached menu, just click right
mouse button on the icon to popup menu with basic operations.

Command line arguments:
----------------------

   -h       
               Show some help.
	       
   -rm   
               Remove current (selected) icon.
	       
  -kill
               Terminate tycoon.

  -raise/-lower
               Raise/lower all icons.

  -freeze/-unfreeze
               Freeze/Unfreeze all icons. (Freezed icons can't be moved around)

  -add X Y LABEL ICON CMDLINE DROPCMD
               Add new icon at X,Y using LABEL as label, CMDLINE as command
               line to execute and ICON as .xpm file with icon picture.
	       DROPCMD is the command wich will be executed when OffiX
               file manager file icon will be dropped on this item.

  -edit X Y LABEL ICON CMDLINE DROPCMD
               Changes the attributes of the selected icon setting position
	       of X,Y using LABEL as label, CMDLINE as command
               line to execute, and ICON as .xpm file with icon picture.
               and DROPCMD as the command wich will be executed when OffiX
               file manager file icon will be dropped on this item.
  -align X Y ORIENTATION
               Align icons on desktop starting at X, Y. ORIENTATION can be
	       h (horizontal) or v (vertical).

For example:

> tycoon -add 12 140 xv /usr/include/X11/pixmap/xv.xpm xv 'xv $DROPOBJECT'
> tycoon -align 10 10 v

NOTE: 
   You can use "\n" to break the lines in the label strings. Do not edit the
file while running tycoon, it may cause confusion. In fact, try to avoid
editing it by hand, use tycoon command line instead, or tyman GUI configurer.
   $DROPOBJECT is a magic word, it will be replaced with filename corresponding
to the filemanager file icon dropped on the tycoon icon.

   There is very simple interactive utility for adding/editing icons,
found in the tyman directory. "tyman" is not necessary to run tycoon, but
you will find it very convinient.

   As from version 1.07d, tycoon icons have attached menu, just click right
mouse button on the icon to popup menu with basic operations. This menu has
"new icon" and "edit icon" options. They will work only if you have "tyman"
installed.

   Best idea for using the command line options is to insert invocations
of tycoon into the window-manager menus. For example, if you use fvwm 1.2,
you can add the following to your .fvwmrc menu, bound, say, to the right
mouse button:
 
PopUp "TycoonMenu"
        Title   "Tycoon menu"
        Nop             
        Exec    "Add new icon"         exec  tyman -add
        Exec    "Edit selected icon"   exec  tyman -edit
        Exec    "Lower icons"          exec tycoon -lower
        Exec    "Raise icons"          exec tycoon -raise
        Exec    "Unfreeze icons"       exec tycoon -unfreeze
        Exec    "Freeze icons"         exec tycoon -freeze
	Exec    "Remove selected icon" exec tycoon -rm
        Exec    "Shutdown tycoon"      exec tycoon -kill
        Exec    "Run tycoon"           exec tycoon
EndPopUp

Binding is done via:

Mouse 3         R       A       PopUp "TycoonMenu"    

Application defaults:
---------------------

   You will probably have to look at Tycoon.ad file if you want to set custom
colors or appearance for the icons and labels. After you make changes there,
you can copy it to your home (or to /usr/lib/X11/app-defaults) directory
under the name Tycoon, or insert the contents into your .Xdefaults.
I advise you to look at this file closely, many interesting things can be 
controlled via resources.


Last words:
-----------
 The program is not very stable, few annoying bugs are hanging around waiting
for me to remove them, but currently I have VERY little time to work on
tycoon, and if I will do anything it will be adding some new feature,
not fixing bugs. Bug fixes (in the form of context patches) are welcome.

 I would like very much to see this program turned into fvwm module, but
will not do anything in this direction. Any volonteers?

 Right now I have put into tycoon support for OffiX drag-and-drop,
so now you can drag icons from the OffiX filemanager into tycoon
icons and have apppropriate action invoked. Check out OffiX, it's
very fine package.

 If you are going to use this program drop an e-mail to mitnits@shani.net. 
I'll be glad to hear your opinion and just to get your e-mail :).

 Don't send any e-mail to vels@spider.cs.biu.ac.il, he is not participating
in this project any more.


 Roman Mitnitski                                 Vladimir Lobak
 mitnits@shani.net                               vels@spider.cs.biu.ac.il      


