This is the binary release with single processor scheduler of the
Aberdeen port of KRoC version 0.7beta for the Parsytec PowerXplorer.


What is in the bin directory?
-----------------------------

  kroc:   the driver programm to produce Parix executables from occam
          source files.

  occ21:  INMOS' occam compiler version 2.1. Used by kroc.

  octran: translates the tranputer assembler code to PowerPC assembler code.
	  Used by kroc.


Options for kroc are:
---------------------
  -c                                      Separately compile (no link).
                                          This will output an object
                                          file (.o) and a transputer
                                          interface descriptor file (.tco).
                                          The latter has to be included with
                                          '#USE file.tco'.
                                          For an example have a look into
                                          examples/sc.
  -lname                                  Link in library libname.a.
                                          An example can be found in
					  examples/exlib.
  -Ldirectory                             Search this directory for libraries
  -oname, -o name                         Output to this executable / object.
                                          Otherwise the base name of your
                                          occam file will be taken.
  -n --dryrun                             Just show commands to run
     --octran_opts=option,
     --octran_opts options                Options passed to 'octran'
     --oc_opts=option, --oc_opts options  Options passed to 'oc'
     --cc_opts=option, --cc_opts options  Options passed to C compiler
  -v --verbose                            Show commands being run
  -k --keep_temp                          Keep temporary files like
                                          the transputer interface descriptor
                                          (.tco), transputer assembler (.t),
                                          and GNU assembler (.s) files
     --version                            Print version. In this case
                                          it is 0.7beta.
  -h --help                               Print this message and exit


Notes on kroc:
--------------
  o  The main KRoC interface needs to have three channels defined to
     communicate with the outside world like Unix/C's stdin, stdout, stderr.
       PROC main (CHAN OF BYTE key, screen, error)

  o  To flush the output buffer for stdout and errout print '255'.
       CHAN OF BYTE out:
       out ! 255

  o  The TIMER runs always in the high priority mode with 1us
     rather than with 64us in the low priority mode.

  o  Because of limitations of the GNU asssembler (version 2.5) you cannot
     use procedure names with more than 19 characters. Therefore in the
     file examples/exlib/filein_utils.occ the following procedure names
     had to be truncated:
       file.check.num.chars    ->  file.check.num.char
       file.convert.num.chars  ->  file.convert.num.ch

  o  The GNU assembler might print the following warning that can
     be ignored:
       nm: p is not a recognized flag.

  o  Several examples of how to use KRoC are given in the directory
     examples.

  o  Sometimes it is necessary to increase the stack size for the
     Parix environment to run a program. But this depends on
     your configuration. You should try if your program terminates
     with the following message:
       KROC: Error flag set

On-line WWW Documentation
-------------------------
  The full occam2.1 language reference manual at:
    o <URL:http://www.hensa.ac.uk/parallel/occam/documentation/>
    o <URL:ftp://unix.hensa.ac.uk/pub/parallel/occam/documentation/>

  The complete occam library documentation is available at:
    o <URL:http://www.hensa.ac.uk/parallel/occam/documentation/inmos/>
    o <URL:ftp://unix.hensa.ac.uk/pub/parallel/occam/documentation/inmos/>


Whom to ask?
------------
  {eng407,eng509}@eng.abdn.ac.uk


What is to come?
----------------
  o  multiprocessor binary release version 0.7beta
  o  source release version 1.0
