================================================================================
COST INSTALLATION GUIDE --  Release 2.0a3

        For information about Cost, see

                <URL:http://www.art.com/cost/>

        Please report any problems, questions, bugs, and suggestions
        for enhancements to:

            Joe English
            <joe@trystero.art.com>
            <jenglish@crl.com>

        $Revision: 1.6 $
        $Date: 96/01/20 09:33:42 $

================================================================================
BEFORE YOU START

To build Cost you will need a standard (ISO/ANSI) C compiler,
or something reasonably close.  'gcc' should be fine.

You will need to build and install the following packages:

    o SGMLS:    Version 1.1.91 is recommended, but version 1.1
                will also work.  SP/NSGMLS should work as well.

    o incr tcl: Version 2.0 is required.

        Alternately, you can use:

    o Tcl:      Version 7.4 or higher is required.

        instead of (not in addition to) [incr Tcl].
        However, many of the example scripts still [incr Tcl]
        and it is a very useful extension.

You may also want to get:

    o Tk:       an X Window system user interface toolkit.

    o TclX:     Extended Tcl, which contains many useful enhancements to Tcl.

See below for archive sites where these packages may be obtained.


================================================================================
BUILDING COST

In the 'src' directory, copy the file 'Makefile.distrib' to 'Makefile'
and edit it as described in the comments therein.  Sorry, there's no
autoconfigure script.

You'll need to specify:

    o How to invoke the C compiler on your system
    o Which Tcl extensions to include (incr tcl, tclX, etc.)
    o The location of the Tcl and/or [incr tcl] libraries and header files
    o The directory where the Cost initialization and library
      scripts are to be installed.

Next type 'make'.  Let me know if you encounter any problems.

To try Cost without installing it, set the environment
variable $COSTLIB to point to the directory where you
unpacked the distribution:

        setenv COSTLIB `pwd`


================================================================================
WHERE TO GET STUFF

    Cost is available at
        <URL:ftp://ftp.crl.com:/users/je/jenglish/cost.tar.gz>

    SGMLS 1.1.91 is available at
        <URL:ftp://sgml1.ex.ac.uk/sgmls/sgmls-1.1.91.tar.Z>
    SGMLS 1.1 is available at
        <URL:ftp://sgml1.ex.ac.uk/sgmls/sgmls-1.1.tar.Z>
        <URL:ftp://ftp.ifi.uio.no/pub/SGML/SGMLS/sgmls-1.1.tar.Z>

    [incr tcl] 2.0 is available at
        <URL:ftp://ftp.aud.alcatel.com/tcl/extensions/itcl-2.0.tar.gz>

    Tcl 7.4 is available at
        <URL:ftp://ftp.aud.alcatel.com/tcl/tcl7.4.tar.gz>

    There are many other useful Tcl extensions at the alcatel archive.


Building SGMLS, [incr Tcl] and/or Tcl is fairly simple.  Just unpack the
distributions, './configure',  'make', and (for Tcl) 'make install'.
You'll probably want to install the 'sgmls' executable somewhere
convenient as well like in /usr/local/bin.