status.i4.v = acl_file_read_title_c(file_name.i1a.r, file_type.i4.v,
					    title.i1p.r [,options.u4.v])

	This routine reads the title of an Accelerator Command Language
	(ACL) script from a file or database table.  A value of NULL can be
	passed for any of the returned arguments whose values are not needed.

	file_name	null terminated file name
	file_type	type of file
			(ACL_FLAT_FILE -> ASCII text file,
			 ACL_DB_FILE -> "file_name" should be the database
					table name from ACL_DB_TABLE)
	title		returned title  (The memory for this buffer
			is allocated by this routine and must not be freed
			by the caller.  It will be freed by the next call
			to this routine.)
	[options]	read options
			(ACL_OPT_NONE -> no options selected,
			 ACL_OPT_DONT_CLOSE -> leave database connection
					       open upon exit (close later
					       with db_close))

	This function returns ACNET status values as follows:

	OK			success
	CLIB_MEMFAIL		failed in allocating dynamic memory
	CLIB_NOTOPN		failed to open file
	CLIB_NO_SUCH		no title found
	otherwise		other ACNET format error code

	This function requires the following include files:

	ul_acl_h:acl_h, acnet_errors_h

	Related functions:

	intro_acl, acl_file_read_description_c, acl_file_read_author_c,
	acl_file_read_keeper_c, acl_file_read_version_c,
	acl_file_read_c, acl_file_write_c, acl_file_exists_c,
	acl_db_file_exists_c, acl_file_execute_c, acl_execute_c, acl_compile_c,
	acl_free_c, acl_free_arg_info_c, acl_read_symbol_c,
	acl_read_symbol_as_string_c, acl_read_symbol_info_c,
	acl_read_symbol_dynamic_info_c, acl_read_symbol_names,
	acl_read_intrinsic_symbol_names, acl_parse_symbol_name,
	acl_script_argument_info_c, acl_script_has_symbol_list_c,
	acl_script_has_setting_c, acl_delete_symbol, acl_reinit_symbol,
	acl_info_c, acl_cancel_requests_c, acl_set_symbol_c,
	acl_create_symbol_c, acl_default_data_source_c, acl_log_file_c,
	acl_default_script_path_c, db_close, acl_script_is_executing,
	acl_register_host_request_func, acl_unregister_host_request_func,
	acl_translate_command_string, acl_search_db_files_c,
	acl_file_is_in_repository_c, acl_parse_script_argument_string_c,
	acl_expand_file_name_c, acl_get_user_execution_privilege,
	acl_get_user_db_edit_permission, acl_script_to_command_lines_c,

	C/C++ usage:

	static const char	file_name[] = "acl_file.acl";
	char	*title;
	int	status;
	int	file_type = ACL_FLAT_FILE;
	unsigned int	options = ACL_OPT_NONE;

	status = acl_file_read_title_c(file_name,file_type,&title,options);