Quick Reference for Mktclapp

To create a new Tcl command named abcdef in C code, do this:

int ET_COMMAND_abcdef(ET_TCLARGS){
   ...
}

The ET_TCLARGS macro declares four parameters:

clientData. Always NULL for commands generated by mktclapp.
interp. A pointer to the Tcl interpreter.
argc. Number of arguments to the Tcl command.
argv. Value of each argument.

The C implementation of Tcl commands must return one of the following integer values: TCL_OK, TCL_ERROR, TCL_CONTINUE, TCL_BREAK, or TCL_RETURN.

To create a new Obj_Tcl command named ghijkl in C code, do this:

int ET_OBJCOMMAND_ghijkl(ET_OBJARGS){
   ...
}

The following extra C functions are available:

int Et_EvalF(Tcl_Interp *interp, const char *zFormat, ...);
int Et_GlobalEvalF(Tcl_Interp *interp, const char *zFormat, ...);
int Et_ResultF(Tcl_Interp *interp, const char *zFormat, ...);
int Et_DStringAppendF(Tcl_DString *, const char *zFormat, ...);
char *mprintf(const char *zFormat, ...);
char *vmprintf(const char *zFormat, va_list);

Global C variables:

Tcl_Interp *Et_Interp;

Global Tcl variables:

Et_EvalTrace;

Mktclapp will create suitable implementations of the following functions if you fail to do so yourself:

int main(int argc, char **argv);
int Et_PreInit(Tcl_Interp *interp);
int Et_AppInit(Tcl_Interp *interp);

If you make your own main, but sure it calls the routine Et_Init(argc,argv) at some point in order to create and initialize the Tcl interpreter.

To run the graphical application builder, type

wish xmktclapp.tcl

To run from the command line (or from within a Makefile) enter "mktclapp options..." For information on available options, type "mktclapp -help".

See complete documentation on mktclapp at http://www.hwaci.com/sw/mktclapp/mktclapp.html.