Introduction:
=============

This is an X11-based 3D graphical interface to rz (zmodem). To build
and install it, please follow the follwing steps carefully.


Installation:
=============

* 	Get the stock zmodem package from any SIMTEL mirror. I got mine
	from oak.oakland.edu at pub/unix-c/xyzmodem.

*	Install the bitmaps (xrz.ico and frame.ico) in you default bitmap
	directory (usually /usr/include/X11/bitmaps).

*	Apply the patches (xrz3D.diff) to the stock zmodem sources.

*	Edit the makefile to define the appropriate flags and compile
	using 'make rz' or simply 'make'.

*	Install XRz in your app-defaults directory. This is very
	important. The program will not work properly without it.

*	Note: You can also get the sources to the Control Panel (Xc)
	library, build and install it, and use it instead of the supplied
	one. I got mine from export.lcs.mit.edu in contrib. You'll have to
	do this if you're building Xrz3D on a platform other than linux.


That should do it. If you like the program, please send me mail to
that effect. That would give me an incentive to continue maintaining it.
If you hate the program, or if you have any suggestions, I welcome your
mail also. 

I'm also very inetersted in feedback from people running an OS other
than linux, as I haven't really tried the program on any other platform. 


                                        -- Muhammad Saggaf
                                           alsaggaf@athena.mit.edu


Changes:
========

0.32 --> 0.4:
	* Restored the default behaviour to use the standard input/output
	  instead of a modem device. The program can now be safely called
	  from withen minicom and similar programs.
	* Added an icon bitmap and and icon mask.
	* Changed the way the program is packaged to make it easier to
	  install.
	* Added [preliminary] BSD support.
	* Added the copyright notices to the README file. 

0.31 --> 0.32:
	* Added the missing header files of the Xc library.
	* Expanded the README file a little bit.

0.3 --> 0.31:
	* Fixed a bug related to interrupting the transfer.

0.2 --> 0.3:
	* Rewrote from scratch using the Control Panel widget
	  high-level routines to give it a 3D Motif-like look.

0.2:
	* Initial release. Used the Xlib low-level routines.
	

To Do:
======

	* Make the program display the total percentage in the icon (when
	  iconified). I'll do that as soon as I figure out how. Any
	  suggestions are welcome.


Copyrights:
===========

* Rz:
	Copyright (c) by Omen Technology. Consult the top of the file
	'rz.c' for a full description of their copyright.

* Control Panel Widget, Xc:
	Copyright (c) 1992 by Paul D. Johnston. "You may freely use and
	distribute the Control Panel Widget Set (Xc), but you may not use
	it, or any widget in the set, in your commercial or freely
	distributable applications without giving the author due
	recognition."
 
* Xrz3D:
	Copyright (c) 1992 by Muhammad M. Saggaf. You may freely use the
	Xrz3D modifications and distribute them both for free and otherwise
	so long as they are intact not made part another program. 

	
Disclaimer: 
===========

	I have no affiliation with Omen Technology and I accept no
	responsibilty for using or modifying their code. 


