%UIPUTFILE Interactively retrieve a filename by displaying a dialog box.
%	[FILENAME, PATHNAME] = UIPUTFILE('initFile', 'dialogTitle', X, Y)
%	displays a dialog box for the user to fill in, and returns the
%	filename and path strings.  A successful return occurs only if
%	the file does not exist or if the user has given explicit permission
%	to delete the file.
%
%	If the user selects a file that exists,	a prompt is issued asking 
%	whether the user wishes to delete the file.  A 'YES' response 
%	successfully returns but does NOT delete the file (which is the 
%	responsibility of the calling routine).  A 'NO' response will 
%	simply return control back to the dialog box. The user may then 
%	enter another filename, or press the Cancel button. 
%
%	All parameters are optional, but if one is used, all previous 
%	parameters must also be used.
%
%	The initFile parameter determines the initial display of files 
%	in the dialog box.  Full file name specifications as well as wildcards
%	are allowed.  For example, 'newfile.m' initializes the display to
%	that particular file and lists all other existing.m files.  This may
%	be used to provide a default file name.  A wildcard specification such
%	as '*.m' lists all the existing MATLAB M-files.
%
%	Parameter 'dialogTitle' is a string containing the title of the dialog
%	box.
%
%	The X and Y parameters define the initial position of the dialog
%	box in units of pixels.  Not all systems may support this option.
%
%	The output variable FILENAME is a string containing the name of the
%	file selected in the dialog box.  If the user presses the Cancel button
%	or if any error occurs, it is set to 0.
%
%	The output variable PATH is a string containing the name of the path
%	selected in the dialog box.  If the user presses the Cancel button 
%	or if any error occurs, it is set to 0.
%
%	Example:
%		[newmatfile, newpath] = uiputfile('*.mat', 'Save As');
% 
%	See also UIGETFILE.

%	Copyright (c) 1984-93 by The MathWorks, Inc.
%	Built-in function.

