README for msub
Paul DuBois
12 April 1997

msub is a program that reads a template file for variable references,
then substitutes those references with variable values.  It gets the
values by looking through the Makefile.  This means you can refer to
any variables that are defined in your Makefile.  msub is most useful
with imake, since then you tend to have Makefiles with lots of make
variables defined that you can refer to.  See the file "imake.support"
for some information on using msub with imake.

If you have imake and the X11 configuration files, you can build and
install like this:

	% xmkmf			Generate the Makefile
	% make clean		Remove anything extraneous
	% make			Build msub
	% make install		Install msub
	% make install.man	Install msub manual page

"make test" can be used to run a simple test.  The file "test.out"
contains the expected output.

msub works on UNIX or Windows NT, though to use the command sequence
above under NT, you'll have to have the Perl version of xmkmf installed
and you should use nmake rather than make.  Under NT the executable
will be called msub.exe.

You can also compile msub by hand, perhaps with a command as simple as
this:
	% cc -o msub msub.c

Under Windows NT, make sure to pass -DWIN32 to the compile command, and
to name the executable msub.exe.

