
Operator Installation procedures

 1.  Make sure that you have a wish version with the following extensions:
      .... (see the README file, at the end of this file see also
            INSTALLATION OF OP-WISH)
 2.  Untar the Operator-1.0.tar.gz file in the directory that will be used
      as the home directory for the operator package.
 3.  Edit the Makefile and change the variables at the top part of the file.
     WISHNAME - name of wish interpreter with the necessary extension.
       -- by default 'wish', if you have a local directory op-wish then don't
          change the WISHNAME, the make with take the right wish name
     INSTALLDIR - name of the directory that will contain the symbolic link
       to the operator startup script.
       -- by default '/usr/local/bin'
     MANDIR - where to install the man pages of the operator.
       -- by default '/usr/local/man'
 4.  Edit c-src/Makefile and set the following variables
     CC - the C compiler to use for C compilation.
       -- by default 'gcc'
     CFLAGS - The compiling flags for the specific C compiler
       -- by default '-ansi -O2'
 4.  Execute make
     This make will create the srtree executable in the ./bin directory,
     the program is needed for the operation of the Operator.
   
 5.  (optional) test locally the Operator by running './operator'.
 6.  end the installation by running 'make install'

Example:

 ...

 mkdir /usr/local
 gzip -dc operator-1.0.tar.gz | tar xvf -
 cd /usr/local/Operator-1.0
 vi Makefile
 make
 ./operator
 make install
 rehash

now you can run the operator program.

Thank you for using the Operator Program.
Please remember that it is a Shareware and *not* Public Domain Software :-)

XTerm, TkSteal and xterm-title
------------------------------
 When changing the name of the xterm with some escape sequence at the startup
script (like .cshrc), an additional procedure should be taken if you also
want to use the xterm from within Operator (very useful). The new command that
should be added before the name updating is 'sleep'. Example:
You had in ~/.cshrc :

# change terminal name.
alias chtname       'echo -n "]2;\!:*]1;\!*"'

chtname "$HOST:$cwd"

You should change it to :

(sleep 8 ; chtname "$HOST:$cwd" & )

This time is enough for tksteal to reparent the xterm window.
If the tksteal doesn't take control over the newly created xterm before the
xterm updates its name, the tksteal will not find the xterm window with the
original name.

The CHECKSUM file
-----------------
 The CHECKSUM file contains the checksum produced with GNU cksum program for
all the files in the distribution.

INSTALLATION OF OP-WISH
-----------------------

As the installation of wish with all the Operator needed extensions is quit
complicated, I included in the etc directory scripts to help you to
create the needed wish. The installation is local to the directory and will
not add file to any other place in the file system.
To create the new wish you should have (download) the following files.

tcl7.3.tar.gz
tk3.6.tar.gz
itcl-1.5.tar.gz
TkPixmap3.6h.tar.gz
BLT-1.7.tar.gz
TkIcon3.6f.tar.gz
TkSteal3.6f.tar.gz

NOTE:
   1  This wish has nothing special. If you have other installed wish with
      all the following extension then you can skip this installation.
      The Operator installation will use any wish with name given in the
      Makefile ( Operator-1.0/Makefile, See WISHNAME ).
   2  If you are running on Linux (I use Slackware 2.1.0 with Kernels
      1.1.[59,81,91])
      or SUN-Solaris-2.4, then you probably can get the binary distribution
      that includes the executable of op-wish.

First do the Step-2 of the Operator installation, untar the Operator-*.tar.gz
file in the final directory. For example

cd /usr/local
gzip -dc Operator-1.0.tar.gz | tar xvf -
cd Operator-1.0

Now you should create a new directory inside the Operator-1.0 directory named
op-wish. Copy the etc/op-wish-build and etc/op-wish-clean to the new directory.

mkdir op-wish
cp etc/op-wish-build etc/op-wish-clean op-wish

Now you should copy all the compressed files into the new directory.
cp  ~/tgz-files/tcl7.3.tar.gz  /usr/local/Operator-1.0/op-wish/
 .
 .
 .

After copying all the *.tar.gz files into the new directory, you should enter
into it and type './op-wish-build'

cd op-wish
./op-wish-build

The op-wish-script opens all the compressed files into the current directory,
runs configure for each, run make, and *ignores* many errors that you might
see. You might encounter two problems
  1. question about shared library - I answered no, I didn't try to build
     shared libraries with wish.
  2. The XPM library might be needed in case it will fail to create it by
     itself.

Now there should be a op-wish executable file in the current directory.
If you have the op-wish executable, you made it.
Now you can remove all the ~~32 MG that we don't need any more by typing

./op-wish-clean

The script cleans *all* the files in the current directory that are not
used by the Operator. Don't use it if you want the op-wish to be used for
other programs or if you want to read Tcl/Tk man pages from within the
current directory.

After the successful creation of op-wish you can continue with the Operator
installation.

Thank you for your time :-)

NOTES ABOUT THE BINARY DISTRIBUTION

 The op-wish was build from the above mentioned files that I down loaded from
ftp.aud.alcatel.com. They are not included to reduce network traffic.
All Copyrights about the software in the op-wish directory belong to those
holding the copyrights about the files that used for building the op-wish.

Please let me know if there is any copyright problem.

Thank you for using Operator.
