''' The isthmus-cd Man page ver 1.0
'''
''' Written by joe Maranda
'''
.TH ISTHMUS-CD N NEW

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

.SH SYNOPSIS
.B isthmus-cd
[ intermediate_cd-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-cd 
automatically generates proxy code to enable use of Demeter 
generated C++ classes in Tcl. This proxy code  generator is necessary 
because C++ objects have no external linkage in  the Tcl language.

.SH "OPTIONS AND COMMAND LINE ARGUMENTS"
No options may be given to 
.I isthmus-cd.
.PP
Typically you run 
.I isthmus-cd 
without any command line arguments, and use the default file 
.I notmod/cds/cd-inter,
however the use may specify a different file for 
.I isthmus-cd
to parse as a command line argument.
.PP
The standard invocation of
.I isthmus-cd
will be from the Imakefile.  Using this method, only the default file will be 
parsed, no other arguments will be allowed.

.SH USAGE
During standard system development 
.I isthmus-cd 
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 three files:
an Imakefile, a class dictionary, and a demeter-input file. 
.PP
The directory may look much like this:
.nf

	Imakefile
	cd.cd
	demeter-input

.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 are 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 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
	gen-make             # to create the new Makefile	  #
	demeter			 # to create the Full environment #
	./run

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

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