''' The isthmus-pp Man page ver 1.0
'''
''' Written by Joe Maranda
'''
.TH ISTHMUS-PP N NEW

.SH NAME
Isthmus-pp \- software for Tcl/Tk and Demeter System/C++ interface generation:
integrates the object traversal portion of the Demeter system/C++ in Tcl.

.SH SYNOPSIS
.B isthmus-pp
[ propagation_pattern-file ]

.SH DESCRIPTION
.I Isthmus 
is a set of programming tools developed to reduce the tedium in 
writing C++ and Tck/Tk interface code.  They are designed for use with 
the Demeter system/C++.  
.PP
.I Isthmus-pp 
when used in conjunction with
.I isthmus-cd
automatically generates proxy code to enable use of Demeter 
generated C++ classes and propagation patterns in Tcl.

.SH "OPTIONS AND COMMAND LINE ARGUMENTS"
No options may be given to 
.I isthmus-pp.
.PP
Typically, when the user runs this by hand, they run 
.I isthmus-pp 
with command a line argument specifying the propagation filenames which they
wish to generate the Tcl interface for.
.PP
The standard invocation of
.I isthmus-pp
will be from the Imakefile.  Using this method, all the propagation pattern
files,
.I *.pp,
are sent to 
.I isthmus-pp
for proxy code generation.

.SH USAGE
During standard system development 
.I isthmus-pp
is automatically called from within the Imakefile.  This process is invisible 
to the user.  The Isthmus tools are compiled and executed as part of the
generation of the Demeter environment.

.SH EXAMPLES
The minimum a user must start with is a set of four files:
an Imakefile, a class dictionary, a propagation pattern, and a demeter-input 
file. 
.PP
The directory may look much like this:
.nf

	Imakefile
	cd.cd
	demeter-input
	f.pp

.fi
The only user-defined reference specific for using the Isthmus tool set
is a definition in the Imakefile.
.nf

	/************************************************************

	options 

	USE_TK  for using TK
	USE_TCL for using TCL only
	USE_WCT for using interactive shell (Wish come true)

	ISTHMUS = (option)
	************************************************************/
	ISTHMUS = USE_WCT

.fi
Once these files exist, and they provide the correct
funcionality for your application, then the rest of the environment
can be generated.

From within the directory call:
.nf
	sem-check            # to test class dictionary	  #
	demeter			 # to create the environment	  #
	isthmus-cd		 # to create the cd interface	  #
.fi
Then do some file manipulation:
.nf
	cp Imakefile.sample Imakefile
	cp main.tcl.sample main.tcl
	cp main_tcl.C.sample main.C
.fi
Finish the process:
.nf
	isthmus-pp *.pp 	 # to create the pp interface	  #
	gen-make             # to create the new Makefile	  #
	demeter			 # to create the Full environment #
	./run

.fi
.SH SEE ALSO
demeter(n), isthmus-cd(n)

.SH NOTES
The gen-i-make for auto-compilation of Isthmus is not yet implemented.
Therefore the "normal" method of calling 
.I isthmus-pp
through the Imakefile can not be accomplished at present.