\section{The Files window}\index{Files window}\index{window, Files}\label{window, files}
%
%
%
\begin{figure}[H]
%\vspace{1.0in}
\centerline{\psfig{figure=ps/filesl.ps,height=191pt}}
\caption{\label{fileswin}
The Files window.
}
\end{figure}
 
%
%
%
\begin{description}

\item[Window title:] DsTool: File: (Action)
\item[Function:] The File window is used to control the exchange of data between DsTool and
	outside files.
\item[Description:] The File window is opened by selecting any button which requires
	interaction with outside files.  Specifically, these buttons are the
	Load and Save window buttons located in the C Code and Parser windows, 
	the File option from the Help menu button located in the Command window, the Load window
        button in
	the Load window, the Save window button in the Save window, the Go window button 
	in the Print window when the exclusive setting is ``File'', and the Go window
	button in the Snapshot window.   In each case, the Files
	window provides the user with a convenient way to save or load a file.
\item[Panel items:]\mbox{}
	\begin{itemize}
	\item Filter read-write text field:
		Displays a string which is used to control the display of files in 
		the Files listbox.  Only those files which match the string will be displayed.
		The string should use the usual UNIX wildcards: asterisk, question mark, etc.
	  	If the field is blank, no files will be
                displayed.  If the field contains only an asterisk, then all of the files
                in the specified directory will be displayed.
		Pressing \unix{Return} or pressing the Filter command button will apply the filter
		to the Files listbox.  The default value for this text field depends upon which
                button caused the creation of the Files window.
	\item Directory listbox:
		Allows the user to choose a directory from which to select a file.
		The listbox contains the current directory, the parent directory, and 
		a list of the subdirectories of the current 
		directory.  Double
%		directory, as well as the ``.'' and ``..'' directories which correspond to 
%		the current directory and the parent directory, respectively.   Double
		clicking on a directory name in the listbox changes the current directory to the
		selected one.
		The entries in the Files listbox change accordingly. 
	\item Files listbox:
		Allows the user to choose a file in the given directory.
		The listbox contains a list of the files contained in the current 
		directory which match the filter string.   Double clicking on a file
		causes it to be selected for the action of the window.   If the action
		is saving to a file, DsTool will ask for confirmation before overwriting the file.
%		try to overwrite the given file, causing a notifier\index{notifier} to pop up.  
		If the action is loading a file, DsTool will load the file.  
	\item Directory read-write text field:
		Displays the current working directory.  Pressing \unix{Return} while the cursor is in 
		this field updates the Directory and Files listboxes.  The 
		default value of this text field depends upon which button caused the 
		creation of the Files window.
	\item Filename read-write text field:
		Displays the current filename, which will be used for the 
		specified action if the OK button is pressed.  The default
		value of this field depends upon which button caused the creation of 
		the Files window. 
	\item OK command button:
		Causes the specified action (save or load) to be performed,
		using the current filename and directory.   If the action is ``Save''
		and the file doesn't exist, DsTool will create and write to the file.
		If the file does exist, DsTool will ask for confirmation before overwriting the file.
		If the action is ``Load'' and the file doesn't exist, an error message will
		be printed.  If the file does exist, DsTool will load the file. 
	\item Filter command button:
		Causes the specified filter to be applied to the files which 
		appear in the Files listbox.
% causing only those files which match the filter to be displayed.  
	\item Dismiss command button:
		Closes the Files window.   
%The current options revert to their defaults.
\end{itemize}
\end{description}
