Installing and running Icon2 9.3.2 for MS Windows

Clint Jeffery, University of Nevada Las Vegas, jeffery@cs.unlv.edu

This public domain work was developed from University of Arizona
Icon source code while the author was employed by the University of
Texas at San Antonio.  It is being maintained by the author, presently
at the University of Nevada Las Vegas.

Installation is automated using standard Windows mechanisms.
The main things you need to do after the install are:
    
    1. Install Win32s, IF you need it (Windows 3.1 users).  See below.
    2. Setup your path and environment variables.  Normally these go
       in c:\autoexec.bat, and you can set your path and environment
       by launching the "Setup Autoexec" application included in the
       Windows Icon program group.  If you wish to do it manually:
       a. Add Windows Icon's bin directory (typically C:\WINICON\BIN) to
	  your PATH.  Often a line such as
		PATH=%PATH%;C:\WINICON\BIN
	  will do the job.
       b. Set up environment variables.  Assuming you installed in 
	  C:\WINICON, these variables might look like:
		set IPATH=C:\WINICON\IPL\GPROCS C:\WINICON\IPL\PROCS
		set LPATH=C:\WINICON\IPL\GINCL C:\WINICON\IPL\INCL
		set WICONINI=C:\WINICON\WI.INI
	  Put these in your AUTOEXEC.BAT, or if you are running NT, you
	  should set them in the System...Environment control panel dialog.
       c. Remember to use SPACES not SEMI-COLONS in your IPATH/LPATH!

	Note that you may want to reboot your machine after you finish setting
	up your environment variables, if you wish to proceed in running
	Windows Icon with the environment variables in effect.

Highlights of Changes in this Release (12/18/2000)

	Note that Windows Icon (and Idol, see the next paragraph) have
	been subsumed by their successor, Windows Unicon.  This distribution
	will be maintained and patched, but substantial new features and
	larger bug fixes are delivered in the Unicon distribution, which
	was derived from this code base and includes all the Icon tools.
	See http://icon.cs.unlv.edu for more details.

	This release supports Idol Version 10.  Idol is an object-oriented
	dialect of Icon.  Idol's homepage is icon.cs.unlv.edu/idol.
	Idol support is integrated into the Wi program and its project
	make facility.  Some sample source files for Idol are installed
	in \winicon\ipl\packs\idol\test.

	The NT console version of Icon now supports pipes, thanks to a
	suggestion from David Feustel.  They do not behave correctly yet
	under Windows95, nor from programs compiled with Wi or wicont.

	Temporary files are now written to the directory given in the
	TMP environment variable if there is one.  This fix is crucial
	for NT server environments; before, a Microsoft C library function
	was hardwired to write temporary files to C:\ which caused
	compilation to fail when run in NT server environments.

	Standard keyboard functions (getch/getche/kbhit) for both console and
	windows applications.  These were reported missing by Phillip Thomas
	and Louis Turk.

	FillRectangle() and DrawLine() now handle drawop=reverse correctly.
	Problems reported by Vladimir Grodzenski and Gary Newell.

	delay() fixed under nticont.  It used to fail.

	The Wi editor now supports parenthesis matching from the Edit... menu.
	Wi can also print source files as plain text to the default printer.
	Suggested by Joe Hall, Louis Turk, and Susie Jeffery.

	The native function WinEditRegion() is extended to report the current
	cursor and selection information.  See the on-line reference for
	further information.

	A bug was fixed in native functions WinSaveDialog() and
	WinOpenDialog(), which were not remembering the extension the
	user had selected unless it was typed into the filename.

System Requirements

	Intel 386 or higher, 4 MB of RAM, MS DOS and Windows 3.1 or higher.
	These are estimated bare minimums; a more reasonable operating
	environment would consist of an 8MB machine with speed equivalent
	to a 486 or better.  The Idol facilities probably require 16MB and
	Windows95 or Windows NT.

Installation Instructions (32-bit binaries)

	0) If you have a previously-installed version of Windows Icon, you
	may wish to take care to uninstall it before installing the new
	version.  The new version will happily install itself into the same
	directory as the old one, but doesn't guarantee to erase older files
	that may no longer be used (and may conflict with) the current version.

	1) If you are running Windows95 or NT, go to step 2.  Windows 3.1 users
	must install Microsoft's "Win32s" package.  A version of Win32s is
	available by FTP to ringer.cs.utsa.edu:pub/icont/nt/win32s; copy all
	the files there onto a floppy disk, insert the disk in your Windows 3.1
	machine, fire up Windows, and run a:setup.exe (or b:setup.exe if the
	floppy is in your b: drive).  Follow the setup program's instructions.

	2) Install Windows Icon binaries.  Run a:\setup.exe from disk 1 of the
	floppy distribution; you may setup from a different drive or directory
	if you are installing from the hard drive or a CD-ROM disk.  When
	Windows	Icon is installed, it will create a program group with icons
	to run the Icon system and view documentation files.  Instructions on
	how to compile and run programs are given in "Windows Icon Help".

ACKNOWLEDGEMENTS

	This work was made possible in part by a software donation from
	Microsoft, a hardware donation from Icon Project, and a UT
	San Antonio faculty research award.
