osx man page for tk_main

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 elements in argv.

       char *argv[] (in)			  Array of strings containing command-line arguments.

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

DESCRIPTION
       Tk_Main acts as the main program for most Tk-based applications.  Starting with Tk 4.0 it is not called main anymore 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 application.

       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 initialization, 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);
       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 arguments, main program

Tk									4.0								Tk_Main(3)