---------------------
xmib 1.0 beta version
---------------------

Requirements:
	1) a Unix box
	2) ansi c compiler
	3) socket library
	4) SNMP agents
	5) Motif
	6) The Tricklet package

Installation:
	- First, you must have the Tricklet package installed. During
	compilation process, xmib uses files from the Tricklet
	package, including *.o files.
	In order to install Tricklet, download it:

	filename: tricklet.1.4.tar.Z (I hope it'll work with future vers.)
	host:     cs.huji.ac.il
	loc:      /pub/network/snmp

	- uncompress and untar it, read the Readme file and follow
	the installation instructions there. You need not install
	Tricklet (executables, man pages) in a public directory; 
	the final xmib executable is a stand-alone program.
	- After Tricklet has been successfully compiled, edit
	xmib's Makefile. You should specify the directory where 
	the compiled Tricklet package can be found, as well as
	the directory of Motif. 
	- type 'make' and wait. Successful compilation should
	  result in the executable file 'xmib'.
	- Edit the resource file Xmib.res . If you're using a
	  monochrome monitor then you'd probably HAVE to do
	  some editing, as I have done the configuration for
	  a color monitor only (and I doubt if you can find
	  better colors than mine :-) ). The manual page explains
	  the app-specific resources.
	- xmib is ready to go. Read the manual page for usage
	  instructions.


Dialogs, Traversal, and Everything:
	When a dialog window is popped-up, xmib tries to set the focus
	on the text-input field. This operation may fail, if the
	dialog box is opened for the first time now. Actually, it is
	most likely to fail in this situation, and there is no good
	solution (as far as I know) to this problem.
	The solution (?) I use is a trying to set the focus again,
	after a predefined interval. Setting this interval to 1 sec.
	or so, would be enough for the X-server to realize/manage/map
	the dialog box. The interval can be set using the travInterval
	resource. The unit is msec, and the default value is 0.
	There should be no problem in getting the focus on the 
	text-input field in further pop-ups of the same dialog.


Bugs:
	- xmib does NOT support SNMP-tables in any way. The release
	version will (hopefully) fix this.
	- xmib flashes the root node several times when a new tree is
	displayed. This causes problems if you try to redraw the tree
	(or create a new one), as xmib would try to flash a non-existing
	widget. In order to prevent the problem, xmib waits till all
	widgets stop flashing, and only then attempts to recreate the
	tree. In most cases it works fine, but if you're getting real
	wild in redisplaying trees (eg. 5 clicks/sec), you may get
	core dumps. This may happen only in the very top of the tree,
	when tree is redisplayed very fast.
	- xmib might crash if the user "wildly" redraws the xmib tree (ie.
	presses the left mouse button very rapidly).


Copyright: (what's that?)
	Use, distribute and alter this program freely.
	Please be kind enough to give me the credit.
	This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


Author:
	xmib has been developed by Ranen Goren, from the CS dept.
	of the Hebrew University of Jerusalem, ISRAEL (HUJI) with
	the help and support of the HUJI system group.	
	Mail anything you want to say about xmib to ranen@cs.huji.ac.il .
	xmib is based on an idea by Izar Tarandach, from the
	CS dept. of HUJI.
	xmib is heavily based on the Tricklet package,
	version 1.4 (wow, I hope they don't change it too much
	so we can upgrade xmib hand in hand with Tricklet).
	Tricklet is made by the DNPAP group from the Technical
	University Delft in Holland.


More information about xmib can be found in xmib.man .
--
End of README
