#  Copyright (c) 1995-1996 Sun Microsystems, Inc.
#  See the file "license.terms" for information on usage and redistribution
#  of this file, and for a DISCLAIMER OF ALL WARRANTIES.
#
#

=head1 NAME

Tk_Init - add Tk to an interpreter and make a new Tk application.

=for category C Programming

=head1 SYNOPSIS

B<#include E<lt>tk.hE<gt>>

int
B<Tk_Init>(I<interp>)

=head1 ARGUMENTS

=over 4

=item Tcl_Interp *interp (in)

Interpreter in which to load Tk.  Tk should not already be loaded
in this interpreter.

=back

=head1 DESCRIPTION

B<Tk_Init> is the package initialization procedure for Tk.
It is normally invoked by the B<Tcl_AppInit> procedure
for an application or by the B<load> command.
B<Tk_Init> adds all of Tk's commands to I<interp>
and creates a new Tk application, including its main window.
If the initialization is successful B<Tk_Init> returns
B<TCL_OK>;  if there is an error it returns B<TCL_ERROR>.
B<Tk_Init> also leaves a result or error message
in I<interp-E<gt>result>.

If there is a variable B<argv> in I<interp>, B<Tk_Init>
treats the contents of this variable as a list of options for the
new Tk application.
The options may have any of the forms documented for the
B<wish> application (in fact, B<wish> uses Tk_Init to process
its command-line arguments).

=head1 KEYWORDS

application, initialization, load, main window