Tk_Main(3)	      Tk Library Procedures	       Tk_Main(3)

_________________________________________________________________

NAME
       Tk_Main - main program for Tk-based applications

SYNOPSIS
       #include <tk.h>

       Tk_Main(argc, argv, appInitProc)

ARGUMENTS
       int		 argc		(in)	  Number  of ele-
						  ments in  argv.

       char		 *argv[]	(in)	  Array	       of
						  strings    con-
						  taining    com-
						  mand-line argu-
						  ments.

       Tcl_AppInitProc	 *appInitProc	(in)	  Address  of  an
						  application-
						  specific   ini-
						  tialization
						  procedure.  The
						  value for  this
						  argument     is
						  usually
						  Tcl_AppInit.
_________________________________________________________________

DESCRIPTION
       Tk_Main	acts as the main program for most Tk-based appli-
       cations.	 Starting with Tk 4.0 it is not called main  any-
       more  because  it  is  part of the Tk library and having a
       function main in a library (particularly a shared library)
       causes  problems	 on  many systems.  Having main in the Tk
       library would also make it hard to use Tk in C++ programs,
       since C++ programs must have special C++ main functions.

       Normally	 each  application contains a small main function
       that does nothing but invoke Tk_Main.  Tk_Main  then  does
       all  the work of creating and running a wish-like applica-
       tion.

       When it is has finished its own initialization, but before
       it  processes  commands, Tk_Main calls the procedure given
       by the appInitProc argument.  This  procedure  provides	a
       ``hook''	 for  the application to perform its own initial-
       ization, such as defining  application-specific	commands.
       The procedure must have an interface that matches the type
       Tcl_AppInitProc:
	      typedef int Tcl_AppInitProc(Tcl_Interp *interp);

Tk			       4.0				1

Tk_Main(3)	      Tk Library Procedures	       Tk_Main(3)

       AppInitProc is almost always a pointer to Tcl_AppInit; for
       more  details on this procedure, see the documentation for
       Tcl_AppInit.

KEYWORDS
       application-specific  initialization,  command-line  argu-
       ments, main program

Tk			       4.0				2

Vote for polarhome