Everything you always wanted to know about the Term Processor Kimwitu
  --- or at least: how to handle this distribution

How is this distribution structured?

  Binaries:
	kc-distr/bin/kc.sun3
	kc-distr/bin/kc.sparc
	kc-distr/bin/kc.hp9000s300

    The bin directory may be empty.

  Manual:
	kc-distr/man/kc.1

    Tells you all you need to know to invoke kc (Kimwitu).

  Documentation:
	kc-distr/doc/*

    The documentation is in latex format. To print it, go (cd) to 
    the kc-distr/doc directory and execute `make'.
    NOTE: the documentation may be distributed separately.
    
    NOTE: the most recent kimwitu changes and kimwitu language extension
    may not yet be covered in the documentation.
    The CHANGES file in the src directory always contains information
    about the most recent changes/extensions. However, extensions
    documented only in the CHANGES file may be experimental, and therefore
    may be changed. We try to limit the amount of such (incompatible)
    changes to as few as possible, and, if they are necessary, clearly
    document them, at least in the CHANGES file.
    

  Sources:
	kc-distr/src/*
	kc-distr/src/Gen/*

    The Term Processor was made using itself.
    The kc-distr/src directory contains the `real' *.k (Kimwitu input)
    sources and the *.[ch] kc-generated files that you need to
    bootstrap it.
    The kc-distr/src/Gen directory will be created while kc is being
    made. It will contain (links to) the kc-generated files used
    for boot-strapping, the compiled .o files and the linked binary
    executable kc.


How do I install Kimwitu?

  If the kc-distr/bin directory contains the binary you need,
  rename it `kc' and put it somewhere in your path.
  If not, go (cd) to kc-distr/src. Then execute `make'. If everything
  is ok, you will find a new binary `kc-distr/src/Gen/kc'. Put this
  somewhere in your path.


Which architectures are supported?

  Well, supported... You should be able to compile Kimwitu
  on any UN*X machine.
  So far we have been able to compile Kimwitu on sun3
  under SunOs 3.5 and 4.0.3, sun4 under SunOs 4.0.3 and 4.1.1,
  and hp9000s300 under HP-UX 6.5 and 7.0.
  The code generated by Kimwitu should compile on any
  UN*X machine, no matter on which architecture it was generated.
  We have been able to compile it on the machines/operation systems
  mentioned above.


Do I need a running Kimwitu to install Kimwitu?

  No, you don't. The kc-distr/src directory contains everything
  needed to bootstrap Kimwitu.


Why do you bother me with all this non-sense about bootstrapping and all?

  If you ever need to apply a patch, you will need to know how to
  change Kimwitu, and you will need the `real' *.k sources of
  Kimwitu, not the generated *.[ch] stuff in kc-distr/src/.


How do I make changes in Kimwitu?

  You don't want to. You ask us to change Kimwitu if you find
  anything that needs to be changed.

  But, if you need to change anything in the sources of Kimwitu,
  you should make your change in the kc-distr/src directory, *not* in the
  kc-distr/src/Gen directory, because the contents of that directory
  will be overwritten during the making of the new Kimwitu.
  Note that in this case you will *need* a running Kimwitu to build
  the new one. After making your changes, execute `make new' in the
  kc-distr/src directory. If everything is ok, you will find a new
  binary kc-distr/src/Gen/kc.new.


Who should I contact if I find anything that needs to be changed?
(Or have other questions related to Kimwitu.)

  Axel Belinfante <belinfan@cs.utwente.nl> tel.  +31/53 4893774
  You can contact me for any question related to Kimwitu.

  Tele Informatics and Open Systems
  Dept. of Computer Science
  University of Twente
  P.O.Box 217
  NL-7500 AE ENSCHEDE
  The NETHERLANDS

For the `future proof' addresses see the LICENSE file in this directory.
