bubble_help_callback_init_c

	status.i4.v = bubble_help_callback_init_c(select_arg.g.v,
						  select_type.i4.v,
						  row.i4.v, column.i4.v,
						  height.i4.v, width.i4.v,
						  help_arg_1.g.v,
						  help_arg_2.g.v,
						  help_type.i4.v,
						  help_id.i4.r [,handle.i1a.r])

	This routine will create a bubble help callback for a window.
	All bubble help fields in a window are automatically deleted
	when the window is deleted.

	select_arg	window selection value which depends on "select_type"
	select_type	type of window selection value
			(WMNGR_BY_WINDOW_ID -> window ID (use WMNGR_BACKGROUND
					       for the background window or
					       WMNGR_NEXT_WINDOW_CREATED for
					       the next window to be created),
			 WMNGR_BY_WINDOW_HANDLE -> null terminated window
						   handle)
	row		top row of the help region
			Special values are:
			(WMNGR_CENTER -> center the help region top to bottom,
			 WMNGR_ENTIRE_WINDOW -> help region will cover the
					       entire window)
	column		left column of the help region
			(WMNGR_CENTER -> center the help region left to right
					 in the window,
			 WMNGR_ENTIRE_LINE -> help region will fill the
					      entire line)
	height		height of help region in rows
	width		width of help region in columns
	help_arg_1	help specification value whose interpretation depends
			on the value of "help_type"
			(WMNGR_BY_FILE_NAME -> "help_arg_1" specifies a null
					       terminated compressed help
					       text file name or a simple
					       ASCII text file name,
			 WMNGR_BY_FUNCTION -> "help_arg_1" specifies a function
					      to be called,
			 WMNGR_BY_CONSOLE_HELP -> "help_arg_1" specifies the
						  desired help level (1-3),
			 WMNGR_BY_TEXT_STRING -> "help_arg_1" specifies
						 a simple help text string,
			 WMNGR_BY_XCHAR_STRING -> "help_arg_1" specifies
						  an XCHAR help text string)
			(Note: The preferred extension for ASCII file names
			 is ".cshlp".  If no path is specified for a file
			 with this extension, it is assumed to be in the
			 MECCA directory of the calling program.)
	help_arg_2	help specification value whose interpretation depends
			on the value of "help_type"
			(WMNGR_BY_FILE_NAME -> "help_arg_2" specifies a record
					       number (If this argument has a
					       value of zero or is defaulted
					       by passing a null pointer,
					       "help_arg_1" is a simple ASCII
					       text file.),
			 WMNGR_BY_FUNCTION -> "help_arg_2" specifies a data
					      pointer to be passed to function
					      "help_arg_1",
			 WMNGR_BY_CONSOLE_HELP -> "help_arg_2" specifies the
						  desired help entry
						  (1-30 for level 2 and
						   1-600 for level 3),
			 WMNGR_BY_TEXT_STRING -> "help_arg_2" specifies the
						 length of the help text string
						 (If this argument has a value
						  of zero or a null pointer is
						  passed, the help string will
						  be assumed to be null
						  terminated.),
			 WMNGR_BY_XCHAR_STRING -> "help_arg_2" specifies the
						  length of the help text string
						  (If this argument has a value
						   of zero or a null pointer is
						   passed, the help string will
						   be assumed to be null
						   terminated.))
	help_type	type of help specification values
			(WMNGR_BY_FILE_NAME -> "help_arg_1" specifies a null
					       terminated compressed help
					       text file name and "help_arg_2"
					       specifies a record number,
			 WMNGR_BY_FUNCTION -> "help_arg_1" specifies a function
					      to be called and "help_arg_2"
					      specifies a data pointer to
					      be passed to that function
			(function called as follows:
			 help_func(wid.i2.v, func_data.g.v, help_data.s.r,
				   text_data.s.r)
			 ("help_data" is a structure of type
			  HELP_FUNCTION_DATA (row and column fields are in
			  physical coordinates), "text_data" is the returned
			  text and is a structure of type TEXT_BLOCK_DATA),
			 WMNGR_BY_CONSOLE_HELP -> "help_arg_1" specifies a
						  console help level and
						  "help_arg_2" specifies a
						  help entry on that level,
			 WMNGR_BY_TEXT_STRING -> "help_arg_1" specifies
						 a simple help text string and
						 "help_arg_2" specifies its
						 length  (Note: Line feed
						 characters can be embedded
						 in the text to format a
						 multiple line message.))
			 WMNGR_BY_XCHAR_STRING -> "help_arg_1" specifies
						  an XCHAR help text string and
						  "help_arg_2" specifies its
						  length)
	help_id		returned help region ID
			(can be passed to bubble_help_callback_term_c)
			(Note: If this argument is not needed, a value of
			 NULL can be passed for it.)
	[handle]	null terminated ASCII handle to be used as an
			alternate means of identifying this help field
			(Note: If this argument is not needed, a value of
			 NULL can be passed for it.) (default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid select type, help type, width, or height
	CBS_NO_WINDOW		window doesn't exist
	CBS_INVSIZ		help region is too big to fit in the window
	CBS_NOT_IN_WINDOW	help region is not entirely in the
				requested window
	CBS_DUPREQ		help region overlaps an existing help region
	CBS_MEMFAIL		failed in allocating dynamic memory

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	bubble_help_callback_term_c, bubble_help_window_delete_c,
	bubble_help_setup_c, bubble_help_enable_disable_c

	C/C++ usage:

	static const char	help_file[] = "help_file.cshlp";
	static const char	handle[] = "my_help_field";
	short	window_id = WMNGR_BACKGROUND;
	int	status;
	int	select_type = WMNGR_BY_WINDOW_ID;
	int	row = 5;
	int	column = 1;
	int	height = 1;
	int	width = 10;
	int	help_type = WMNGR_BY_FILE_NAME;
	int	help_id;
	void	*help_arg_2 = (void *) NULL;

	status = bubble_help_callback_init_c((void *) &window_id,select_type,
					     row,column,height,width,
					     (void *) help_file,help_arg_2,
					     help_type,&help_id,handle);