Release 2.5 11/6/15 - Fixed crash when using ">&" output redirection. Release 2.5 11/5/15 - Ported to Apple OS X El Capitan with MacPorts X installed. Fixed a number of anachronisms not accepted by clang. The configure can't find X, so added a special case in ./build. Other targets where X is in an oddball location can be fixed this way, see note in build. Verified out-of-the-box build on RedHat EL5, CentOS 6, CentOS 7, OpenSuse 13.1, OS X (as above) Cygwin (you need libXt-devel and libXaw-devel and the X server) Release 2.5 1/11/09 - Tweeks so that the program will build with recent compilers, such as gcc-4.2. Release 2.5 5/1/01 - Time to put this tired workhorse out to public-domain pasture. Anyone who wants a "real" simulation tool should investigate WRspice - see www.wrcad.com. - Portability check: this distribution is known to build on Solaris 7, FreeBSD 4.3, RH Linux 6.0. It should build on about any unix-like platform, but a little tweeking may be required. - Support in sced for true-color displays. - MOS level 8 cryo-cmos model added. This was developed by Luong Huynh at U. C. Berkeley as a masters project for Prof. T. Van Duzer in 1994-1995. A master's thesis describing the work is available, probably from the same location as this Jspice3 distribution. - The "sfft" (superconducting flux-flow transistor) model has been removed, since the device does not appear to have technological importance. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSPICE3 (C) Stephen R. Whiteley 1990-1994 stevew@srware.com README V2.4 12-18-94 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ See TROUBLE below if your target is a SparcStation. Before you start, you should check and possibly edit the files conf/unixconf/mkheader.0 (for UNIX) or conf/dosconf/mkheader.1 (for DOS) as they contain user configurable options for fine-tuning your installation. For DOS, you will need the djgpp package 1.11m5 or later, plus a few unix-like utilities such as mv, rm, cp, and GNU make with UNIX-friendly extensions (available from S. Whiteley). The CC_OPT_S variable is designed to apply maximum optimization to the routines that need it. It defaults to the standard -O, unless changed. FreeBSD 2.x "-O3 -m486" (on 486 or Pentium) gcc 2.6 on sparc 5, 10, 20 "-O3 -msupersparc" gcc 2.6 on sparc 1, 2, IPX "-O3" gcc 2.5 "-O2" See your compiler manual for others. Under UNIX, the configuration script will set the compiler to gcc if found. This can be overridden by setting the environment variable CC to the name of your compiler before the build. To build the binaries, simply type "build" in the directory containing this file. Under UNIX, you will probably have to become root to actually install the program. The configuration script has a pretty high IQ, so building the program should be automatic. If this is not so on your machine, the author would like to know about it. A file named "errs" will exist in this directory upon completion (UNIX only). This will contain any compilation or linking errors, and should be saved and sent to the author in case of trouble. The build script takes the argument "make", which if given stops the build process after generating the main makefile in src/bin. You can complete the build and installation from this makefile, if necessary. You should only need to run the build script once, as it will always attempt to build the complete distribution. Once the makefile in the bin directory is created, this can be used to rebuild the binaries if fine tuning is necessary. Go to the bin directory and type "make" for a list of options. In particular, you can edit the conf/mkheader file and remake all the other makefiles, without causing a recompilation of the entire source tree (the header of the bin makefile should be similarly changed). User configurable options such as default file locations are most quickly changed in this way. TROUBLE: *Sun 4.1.x Bug* If you are using the Sun cc and openwin X libraries, the link will fail unless you first issue the command setenv LD_FLAGS -Bstatic This is due to an error in the Sun X dynamically linked libraries. You must issue the command before the link (or before typing "build"). The script has been checked with SunOS 4.1.3 and FreeBSD 2.0. You shouldn't have any problems with any BSD-like UNIX, but some off- brands will fail. In this case, you should build the makefiles, then fine-tune them by hand, for example to alter the X include string to access strange locations. Some really stupid compilers don't support the "cc -M" option to create dependency rules. In this case, you should indicate to your vendor that you have been ripped off (you have!) and alter the bin makefile to remove the dependency creation. Then, in bin, type "make make" to create the other makefiles, and build from bin (follow the procedure in the build script). Or, you can install gcc. This all gets pretty technical, so you may need to consult a UNIX guru.