******************* The Alliance 3.0 OS/2 & WIN32 PATCH ************************

Version 1.2							1997/1/10


This Readme.OS2WIN32 comes with
	
	(1) alliance-3.0.patch_12_OS2WIN32.tar.gz
	(2) alliance-3.0.bin_12_OS2.tar.gz
	(3) alliance-3.0.lesstif_12_OS2.tar.gz
	(4) alliance-3.0.src_12_WIN32.tar.gz

      / (5) alliance-3.0.bin_12_WIN32.tar.gz      \
      \ (6) alliance-3.0.lesstif_12_WIN32.tar.gz  /

you will find (1) - (4) at:

	ftp://ftp.uni-bremen.de/pub/os2/applications/alliance/

(5) & (6) at:

	< currently not supported, users have to compile itself >


Prerequisites (Alliance 3.0)
============================

Before working with Alliance 3.0 for OS/2 or WIN32 you have to download the
file alliance-3.0.tar.gz. This file contains the common files like
cell-libraries, documentation, man-pages, sources and some tutorials.
Read the file README for details and a general info about the Alliance 3.0
package. This file lists the place to get the alliance-3.0.tar.gz file
(don't try to download during the european daytime except you will wast your
time).

The Alliance package uses long filenames, so install on a filesystem which will
support this (OS/2: HPFS).

After you have unpacked this file with a command like:

	gzip -cd alliance-3.0.tar.gz | tar -xvf -

you need to have the unzipped binaries from alliance-3.0.bin_12_OS2.tar.gz or 
alliance-3.0.bin_12_WIN32.tar.gz. After this you should run tutorial.cmd
(tutorial.bat on WIN32 systems), this enables you to run the tutorials without
any modifications.

Prerequisites (genview)
========================

If you wan't to use genview, the best idea is to install XFree86, see

	http://borneo.gmd.de/%7Eveit/os2/xf86os2.html (OS/2 only)

If you use another X-Server you need at least the X11.dll from the
place above (XF32bin.zip).

WIN32 users have to use a different X-Server, the X11.dll for WIN32 will be
included in alliance-3.0.bin_12_WIN32.tar.gz.

Prerequisites (dreal/graal)
===========================

If you wan't to use dreal and graal, you have to install the LessTif Libraries
(Xm.dll) in a path-location where the system will find them. They are available
in compiled form as well as dreal and graal in the files:

	alliance-3.0.lesstif_12_OS2.tar.gz
     or alliance-3.0.lesstif_12_WIN32.tar.gz.

you will find them at /.

WIN32 users will find also the Xt.dll, ICE.dll and SM.dll for WIN32 in the
alliance-3.0.lesstif_12_WIN32.tar.gz archive.

The used version of LessTif is 0.75, not complete but usable.

Prerequisites (generics)
========================

You will need the GCC compiler (needed in the Alliance netlist compilation
procedures and for recompilation) and the various gnuutils (text, file and
system), gawk and a bash version installed (bison and flex for compilation).
Maybe I've forgotten some tool - you will see.

You will find most of these tools at

	ftp://ftp.leo.org/pub/comp/os/os2/gnu/ (OS/2)

or

	http://www.cygnus.com (WIN32)
	

Recompile
=========

OS/2:

The script to patch the tools sources is containded in
alliance-3.0.patch_12_OS2WIN32.tar.gz. Run the Script makeall.cmd from the
directory /alliance/patch, this should compile and link everything.

WIN32:

After ungzipping & untarring alliance-3.0.src_12_WIN32.tar.gz you must 
compile dolink.c and start it with parameter 'cyg', this would create some
desired sub-directories under the tools-tree and copy source-files into them.
After completion ungzip & untar the file src_12_WIN32.tar.gz (placed into 
/alliance by alliance-3.0.src_12_WIN32.tar.gz), this would create the
changed files over the (with dolink) newly created ones.
Attention: tar from cygnus seems to have a bug, it appends instead of replaces
a file when invoked with -x, so use another tar (especially for this
step of replacing files).
It's also necessary to move a dummy malloc.h from /alliance/patch into a
directory where cygnus-gcc will find the file by default.
Invoke make in /alliance, if you succeed you have to run cygexe.bat in the
patch directory, this will rename and compile the remaining file.

All:

Modify the file mk.head or mk.tail in the directory /alliance/patch
before the patch step (included in makeall.cmd), or emx.mk (OS/2)/ cyg.mk
(WIN32) in /alliance/etc before the make-step (if you need).

Compiling the X11/LessTif programs:

Patch.cmd searches the environment variable 'X11ROOT' to locate the
'XFree86' tree, the 'lesstif-current' tree is located in the same way
(should reside at the same drive letter).
If you install other versions of LessTif (they are named related to there
version number, e.g. lesstif-0.75), rename the tree before you compile.

Setup
=====

You should set the following Environment Variables in your
config.sys and reboot before starting any tool:

-	ALLIANCE_TMP		use FORWARD slashes without a drive-letter,
				must be present, and pointing to a valid
				directory!
				Without it eg. dreal and graal will terminate
				without any messages.
				Feel free to move it.


-	ALLIANCE_BIN 		use BACKWARD slashes without a drive-letter.

-	GENVIEW_GCC_PATH 	use BACKWARD slashes without a drive-letter.

	eg.: 	SET ALLIANCE_TMP=/alliance/tmp
		SET ALLIANCE_BIN=\alliance\archi\emx\bin
		SET GENVIEW_GCC_PATH=\alliance\archi\emx\bin

Restrictions
============

There are some restrictions belonging to the port:

	ALL tools:
	
	-	Due to the genview-lexer, GENVIEW_GCC_PATH must not contain
		any drive-letters. Therefor you should install and
		start all tools and tutorials from the same drive!

To Start
========

First you should read and try the tutorials.


Problems
========

If you encounter problems:

	Please, first read the Alliance 3.0 man-pages !!!

	Probably your problems are related to the various environment
	variables (my first errors in the most cases).

	The ALLIANCE_TMP directory holds the output files from dreal and graal,
	look at them not only if you got an uncommented exit from them.

	The technological files *.rds are not complete.
	The cmos_5.rds file has druc-rules but no
	hspice params (tas.exe / *.elp), the prol07/prol10 files have
	the former but lacks the latter.

	If you REALLY think the problem is related to the port,
	contact me at:
		
		jaeschke@item.uni-bremen.de
		Christoph Jaeschke, University of Bremen
