Installation ------------ 1. You need GNU Make version 3.76.1 or above. An older version might work, but was never tested. 2. Run ./configure Options: --prefix=PREFIX : Installs the script in PREFIX/bin, default is /usr/local (See Note). --datadir=DATADIR : DATADIR/prototype will keep all the shared Makefiles and Makefile templates. Default is PREFIX/share (See Note). Note: If (an older version of) prototype is already installed, then you don't need to give these options: the defaults will be what you used the last time (you will be told what configure uses before the actual install). HACKERs info: If you think you will tune and extend the Makefile rules a lot for your own personal needs; Then you might want to install the Makefiles as a `project' on its own, with you as owner (instead of root). For instance, ./configure --prefix=$HOME --datadir=$HOME/projects You do NOT want this if you just need this package to compile another package, like libcw. 3. Run make install Make sure you use GNU make! If you are using FreeBSD then likely you will have to type: gmake install 4. The environment variable PROTODIR should point to the 'prototype' installation directory (DATADIR/prototype). Secondly, the environment variable CPPEXT should contain your prefered C++ source file extension (including dot). As an example, if you use `bash' as your shell, you could add to your ~/.profile the following line, export PROTODIR=/usr/local/share/prototype export CPPEXT=".cc" 5. Edit $PROTODIR/Makedefs.h and edit it to make it work for your environment. 6. Optionally, test the installation by running make test [And again, for FreeBSD: gmake test] Creating a new project ---------------------- Change directory into the projects directory where you want to add a new Makefile and type: makeproto This script will try to find out *) which of the five Makefiles you want and copy it to the current directory. After copying it, edit it for your needs (often no editing is needed). *) The script will create a `base' Makefile when you start a new project, or a `test' Makefile when the current directory contains the word "test" in it. Otherwise you will have to specify which of the five Makefile types you want (it will tell you).