This file contains information for people who want to build Coin
in the MKS environment.

REGARDING THE BUILD SYSTEM
==========================

The build files (configure, Makefile.in, and such) have needed
some changes to work on some MKS systems.  If you want to
bootstrap Coin or another SIM library yourself, you need to be
aware of this, because without patching Autoconf and Libtool
yourself, those changes will disappear and you may run into
some very weird problems.

The patches I have applied to Autoconf 2.57 and Libtool 1.5
can be found in the CVS archive "simacros" in the directory
called "patches".  To bootstrap, you should apply those patches
to the relevant utilities, install them, and then run the
simacros/bin/bootstrap script from the library base dir.

* AUTOCONF/LIBTOOL
------------------

In some versions of the MKS toolkit prior to v8.5 (don't know
which), the Bourne shell (sh) had a bug with regards to the
"case/esac" syntax that caused no switch-case to get triggered
when the shell was in a certain state.  Putting a dummy "true"
command above the case-statement would fix the problem, but this
is a very ad-hoc solution that won't get implemented in the
Autoconf and Libtool packages since we don't know the cause
and the bug will likely reappear when seemlingly unrelated
parts are changed in the future.  If we get the details of the
bug from MKS so we know exactly how to apply permanent fixes,
those will of course go into Autoconf/Libtool.

So, this is just a warning about potential problems with the
"configure" script, "config.status" and "libtool" on MKS.  This
bug would very likely be the cause for most problems.  The best
thing for you is probably to upgrade your MKS installation if
you think this is the case.

* SED
-----

Either MKS sed is not 100% compatible with how it is used in
Autoconf/Libtool, or the MKS sh has some quoting problems wrt
weird strings, typically sed-arguments.

I have tried to rewrite/simplify most problematic sed-commands
to work on MKS too.

* MAKE
------

If you experience warnings like the below list when running "make",
it is because you  are using MKS' make program and not GNU make.
GNU make will be called "gmake" if it is installed on your system.
Try building with gmake instead.  Also try setting the $MAKE
environment variable to "gmake" in case of further problems.

  $ make
  make: makefile: line 771:  Warning -- Duplicate entry [dvi-recursive] in prerequisite list
  make: makefile: line 771:  Warning -- Duplicate entry [info-recursive] in prerequisite list
  make: makefile: line 771:  Warning -- Duplicate entry [install-data-recursive] in prerequisite list
  make: makefile: line 771:  Warning -- Duplicate entry [install-exec-recursive] in prerequisite list
  [...]

