hpux man page for xtinitialia

XtInitialize()															    XtInitialize()

Name
  XtInitialize - initialize toolkit and display.

Synopsis
  Widget XtInitialize(shell_name, application_class, options, num_options, argc, argv)
	 String shell_name;    /* unused */
	 String application_class;
	 XrmOptionDescRec options[];
	 Cardinal num_options;
	 Cardinal *argc;
	 char *argv[];

Inputs
  shell_name
	    This parameter is ignored; you can specify NULL.

  application_class
	    Specifies the class name of this application.

  options   Specifies how to parse the command line for any application-specific resources.  The options argument is passed as a parameter to
	    XtDisplayInitialize().

  num_options
	    Specifies the number of entries in options list.

  argc	    Specifies a pointer to the number of command line parameters.

  argv	    Specifies the command line parameters.

Outputs
  argc	    Returns the number of command line arguments remaining after the command line is parsed with XtDisplayInitialize()

  argv	    Returns the command line as modified by XtDisplayInitialize().

Returns
  A toplevel applicationShell widget.

Availability
  XtInitialize() has been superseded by XtAppInitialize().

Description
  XtInitialize() is a convenience function for initializing an Xt application.	It calls  XtToolkitInitialize()  to  initialize  the  toolkit
  internals,  creates a default application context for use by other superseded functions, calls XtOpenDisplay() with display_string NULL and
  application_name NULL, and finally calls XtAppCreateShell() with application_name NULL and returns the created  shell.   The	semantics  of
  calling XtInitialize() more than once are undefined.

Usage
  XtInitialize() has been superseded in Release 4 by XtAppInitialize(), which is a more general initialization function which supports multi-
  ple application contexts and fallback resources, among other things.	There are a number of Xt  functions  that  have  been  superseded  by
  "XtApp"  versions that take an application context as an argument.  If you want to use these superseded functions, you must initialize your
  application with XtInitialize() which creates the default application context that these functions all use.

  If you do not want to use multiple application contexts, multiple displays, or fallback resources, you can continue to use  XtInitialize().
  We recommend, however, that you use XtAppInitialize() and the other XtApp*() application context specific functions.

  See XtAppInitialize() for more information.

See Also
  XtAppCreateShell(1), XtAppInitialize(1), XtOpenDisplay(1), XtToolkitInitialize(1).

Xt - Initialization														    XtInitialize()