MS-Hush Installing Makefiles Example results Sim results

MS-Hush Makefiles

What kind of makefiles come with MS-Hush?

There are makefiles for installation , makefiles to be included for macro definitions ( resource.mak ), and several makefiles to build example programs

Makefiles for Installation

Where are they?

The following installation makefiles are part of the MS-Hush package:
\mshush\install.mak
Installation makefile. This makefile will install, build or clean various parts of Hush, like the API, the examples or SIM.
\mshush\general.mak
general makefile, contains many macro definitions and targets to be used by other makefiles
\mshush\resource.mak
defines the location of various sources on your system

What happens?

If you choose install the following diretories will be created and filled:

Why?

At first this might seem a little confusing. Why is this done? Well, this way you only have to adjust the \mshush\resource.mak to change the source of the api, sim or examples. If you want to test your program with a different version of Hush, which may reside in \api.new you can just change \mshush\resource.mak to:
TOOLS=c:\bc45       # compile tools
TCLTK=c:\tcl        # tcl dir

HUSH=\hush      # target dir
API=\api.new        # source dir        this has changed !

MSHUSH=\mshush      # this directory
API_PACKAGE=\api20a.zip

.SILENT
 
and reinstall. All files needed for the new version will be installed at the right place, and you can recompile your program.

How to rebuild the library?

If you need to rebuild the hush.lib , change to the \mshush\mswinsrc directory and type make . This will rebuild the library, and put the new hush.lib into \hush\lib .

The same procedure can be followed for SIM.

What targets can I choose for the makefiles?

The easiest way to run a makefile is choosing one of the batch files in \mshush :
install.bat
calls make -f install.mak install to install Hush into \hush . If SIM is defined in resource.mak the Sim extension will be installed too, just like the examples being installed if EXAMPLES is defined.
build.bat
rebuilds the libraries and the examples
clean.bat
clears the temorarily files used for building, and the example executables.
If your really want to know about the targets inside the makefiles:
\mshush\install.mak
all: install
install: install-api install-sim install-examples
build: build-api build-install build-examples
unpack: unpack-api unpack-install unpack-examples
install-api:
creates Hush directories, installs patches into the source of the API, installs the include, lib and library directories
install-sim:
activates the makefile in \mshush\sim which will install the include files, examples files and patches for Sim.
install-examples
installs the example source files into the Hush directories. unpack-api unpack-install unpack-examples

Makefiles for Examples

One of the makefiles that is very easy to modify to suit your needs is the makefile for the Coffee example. The makefile for the Coffee example is located in the hush\examples\coffee directory, and is called makefile.mak.
All the example makefiles are:
coffee\makefile.mak
drawtool\makefile.mak
hush\makefile.mak
widgets\makefile.mak
graphics\makefile.mak
contrib\makefile.mak
sim\makefile.mak

Click here for information on how to install Hush for MS-Windows.


Jelle Alten, Hush Portmaster
email: jelle@cs.vu.nl
tel: 020-6799484