yacht - Yet Another Code Harness Tool
=====================================

Richard Beton
(C) Roke Manor Research Limited 1995.

{{{  COPYRIGHT AND DISCLAIMER
     ------------------------

    All the files in this distribution (except those explicitly given
    other Copyrights) are Copyright 1995 Roke Manor Research Limited
    and are not to be re-distributed without explicit written permission.

    This release is for personal or research use only and not to be sold
    in any form.

    This software is provided by Roke Manor Research Limited ``as is''
    and any express or implied warranties, including, but not limited to,
    the implied warranties of merchantability and fitness for a
    particular purpose are disclaimed.  In no event shall the
    regents or contributors be liable for any direct, indirect,
    incidental, special, exemplary, or consequential damages
    (including, but not limited to, procurement of substitute
    goods or services; loss of use, data, or profits; or business
    interruption) however caused and on any theory of liability,
    whether in contract, strict liability, or tort (including
    negligence or otherwise) arising in any way out of the use of
    this software, even if advised of the possibility of such
    damage.

}}}  

{{{  INSTALLATION
     ------------

{{{  For the Binary Distribution:

   1) Type './configure'

   2) Either: (a) put the current directory on your PATH, or
              (b) copy 'yacht' to a directory on your PATH and
                  set environment variable YACHT using

                    YACHT=`pwd`; export YACHT
                  or
                    setenv YACHT `pwd`


}}}  
{{{  For the Source/Assembler Distribution:

   1) Ensure the kroc compiler is installed.
      Ensure the KROC environment variable is set correctly.
      Ensure that your PATH includes $KROC/bin.

   2) Define OS environment variable. The correct value is given
      by the script ./os included in this distribution, e.g. you can

        export OS; OS=`./os`
      or
        setenv OS `./os`

   3) Type 'make'

   4) Either: (a) put the current directory on your PATH, or
              (b) copy 'yacht' to a directory on your PATH and
                  set environment variable YACHT using

                    YACHT=`pwd`; export YACHT
                  or
                    setenv YACHT `pwd`

The assembler distribution includes yacht.t (generic assembly file) but
not the occam source code. This is portable to all architectures for which
a kroc compiler exists and yacht's cstring and posix libraries exist.

The kroc assembler 'octran' is able to generate native assembler (yacht.s),
from which the yacht executable can be created.

}}}  
}}}  

{{{  NEWS
     ----

22nd May 1996: Release of yacht v1.0

   * occam implementation of yacht is complete.

   * increased suite of examples is provided.

   * binary, assembler, and source distribution options exist.

   * new configure script added which inserts a suitable execution path
     as the first line of yacht.

   * liblist tool allows the gleaning of PROC interfaces from libraries.

   * nroff manual page included.


29th March 1996: Release of yacht v0.1.11

}}}  

{{{  KNOWN BUGS
     ----------

}}}  

{{{  WISH LIST

}}}  

Please email bugs and comments to: Richard_Beton@roke.co.uk

For updates to yacht, and the 'kroc' Kent Retargettable Occam Compiler,
see http://www.hensa.ac.uk/parallel/occam/

Last updated: 96/05/22 (v1.4)
