This README file describes the v1.1 distribution of s2ibis2.

This is a minor bug-fix release. It affects only those users who were
using Spectre to produce their IBIS files. (Thanks to Ganesh Balamitran
for the bug report.) See the file doc/changes.txt for a description of
the bug.

To try s2ibis2, use the appropriate executable (found in the bin
directory) and use any of the files in the examples/ directory as input.
For example, for a quick test run on Solaris machine, you could try the
following (note that "%" is the prompt symbol, so don't type it):

    % cd examples/ex1
    % ../../bin/s2ibis2.solaris buffer.s2i

The program will execute, and in a few minutes, it will write the file
buffer.ibs. (Note that this example uses the Spectre simulator, so it
should be in your executable path.) You can compare this file to the
file my_buf.ibs in the same directory.

For a more permanent installation, I would suggest renaming the
appropriate executable to s2ibis2, and moving it to an appropriate
directory somewhere in your executable path (or adding the S2IBIS2/bin
directory to your path).

We are distributing the Perl script s2iplt, by Steve Lipa, with s2ibis2.
This script uses gnuplot to plot out all the curves found in an IBIS
file.  It's a handy thing to have.  For information on Perl and gnuplot,
see the README file in the s2iplt directory.

If you have comments, bug reports, or suggestions for features, please
email them to me at:

    awglaser@eos.ncsu.edu

Thanks very much.

***********************************************************************

This directory contains the following:


    bin/ contains the following executables:

        s2ibis2.ultrix  executable for DECstations (Ultrix 4.3)
        s2ibis2.hpux    executable for HPUX
        s2ibis2.aix32   executable for RS6000 (AIX 3.2)
        s2ibis2.sun4    executable for SPARCstation (SunOS 4)
        s2ibis2.solaris executable for SPARCstation (Solaris)

    doc/ contains documentation

    s2iplt/ contains the Perl script s2iplt

    src/ contains the source code and Makefile for s2ibis2

    examples/ contains various examples of how to use s2ibis2.