  COCOM tool set is written with the usage of GNU configuration
utilities.  Therefore the installation of the tool set is analagous to
the instalation of many GNU software packages.

Installation in the same directory as one with sources files.
*************************************************************


  1. Run command file `configure' without arguments.  In the case of
     successful work `configure' in current directory generates files
     Makefile (from files `Makefile.in') in current directories and
     subdirectories, file `AMMUNITION/cocom-config.h'.  At the end of
     successful work `configure' write to standard output and file
     `config.status' configuration options were specified.

  2. Install the tool set, by the following command:

          make install

     This command create all object files and copies the tool set
     components into the directory /usr/local/bin and file the
     component man files into /usr/local/man/man1.  It also copies
     library files (libcocom.a and standard SRUT description files),
     into directory /usr/local/lib/ and include files (AMMUNITION)
     into directory  /usr/local/include.

     If you wish to copy the files into other directories change
     values of Makefile variables `bindir', `libdir', `man1dir' and
     `prefix'. Use only full path name for the directories! For
     example, if you wish to copy the files into directories
     `/usr/local/COCOM/bin', `/usr/local/COCOM/lib', ,
     `/usr/local/COCOM/include' and `/usr/local/COCOM/man/man1'
     specify

           make install prefix=/usr/local/COCOM
     
                           or

           make install bindir=/usr/local/COCOM/bin\
                libdir=/usr/local/COCOM/lib\
                includedir=/usr/local/COCOM/include\
                man1dir=/usr/local/COCOM/man/man1


Makefile contains following useful entries other than install:

  all       -- creation of all object and executable files;
  
  dist      -- unconditional creation of compressed distribution tar
	       file;

  clean     -- deletion of object files of the translator and executables;

  realclean -- Deletion all which can be built up automatically;
               
  TAGS      -- updating TAGS table for all COCOM;

  uninstall -- delete the installed files and the empty installation
	       directories.



Installation in directory other than one with sources files.
************************************************************

  If you wish to build the object and executable files in a
subdirectory of the source directory make the same as in previous
sections. `configure' itself find out the sources.


In other case do follows:

  1. Go to that directory before running `configure':

          mkdir temp; cd temp

  2. Specify where to find `configure' when you run it:

          ../cocom-0.996/configure ...

  3. Specify where to find the sources, as an argument `--srcdir' to
     `configure':

          ../cocom-0.996/configure --srcdir=../cocom-0.996

  4. It is better to use full directory path for --srcdir if you use
     EMACS compile command.


Other `configure' options and environment variables
***************************************************

  GNU `configure' has many ways to control configuration -- see
configure documentaion for details.  There are some environment
variables worth for mention.  These are environment variables:

  CC       - used compiler for compilation of COCOM C sources
  CFLAGS   - C compiler options for compilation of COCOM C sources
  CXX      - C++ compiler options for compilation of COCOM C++ sources
  CXXFLAGS - used compiler for compilation of COCOM C++ sources
  no_shlib - if it is an unempty string, it means for DINO that
             dynamic loading of foreign functions will be not
             supported (but packages mpi and ieee will be still
             available).
  cocom_debug - Use for thorough debugging COCOM and DINO.  It means
             also no_shlib.

For example

      CC=gcc CXX=gcc no_shlib=yes configure

 
Vladimir Makarov 	(vmakarov@users.sourceforge.net) 

