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'. 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 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.