"[BOOK Tricks of the Java Programming Gurus]" has a chapter
that illustrates the concept well.

[RS]: As a simple hint, you do embedding when your C code contains
 #include <tcl.h>
 ...
 Tcl_Interp *interp = Tcl_CreateInterp(interp):
 ...
Then you can create new Tcl commands, link static variables from your C program to Tcl variables, but first of all have the power of Tcl at your fingertips ;-).

----
I thought there was at least one more call - to some sort of locating the
encoding files, etc. function - required?

[MJ] - When embedding a complete Tcl install (e.g. with init.tcl) the following can be used to completely initialize the embedded Tcl interpreter (copied from [TIP] 66).

  Tcl_Interp * interp;

  /* Initialise the Tcl library thoroughly
  */
  Tcl_FindExecutable( argv[0] );

  /* Create the interp, evaluate "init.tcl" for the script
     level initialisation.
  */
  interp = Tcl_CreateInterp();

  if ( Tcl_Init( interp ) != TCL_OK ) {
     ... Report the error
  }

----

!!!!!!
%| [Category Glossary] |%
!!!!!!