File Selector You have been requested to supply the program with a filename. The file selector window is used to make that choice. The actual filename which will be used is a combination of the contents of the Directory text field and the Filename text field. These files are located on the system which is executing this program, which may or may not be the same system on which you are displaying it. You may override the Directory field completely by supplying an absolute pathname in the Filename text field. -- One that begins with a forward slash character. Selecting Accept (or hitting [return] or [Tab] in the Filename text field), OR double-clicking a filename, indicates you are finished making the selection, and it will be used. Selecting Cancel will cancel whatever operation you were performing which asked for a filename. A single click (selection) of a filename entry will make that the currently selected file, which you may then edit before selecting Accept. Selecting a directory entry will open that directory and display a new list of directories and filenames (if any exist). Please note that if the operation which requested this filename is one which "writes" to that file, and you supply a name which already exists on the system, the existing file will be destroyed by the write operation. Generally, you will only select filenames from the list to "read" or insert them. For writing files, you should type in a name which doesn't already exist on the Filename line, unless you intentionally plan to destroy the existing file. In any event, you will be asked to confirm the file destruction before it is actually carried out. Navigating Directories At any time, you may change directories either by typing in a new directory name in the Directory text field and hitting either [return] or [Tab], or by single-clicking in the "Directories" list. Two entries will always be present in the Directories list; your "home directory", and the parent directory of the current one. Selecting either of these will go to the appropriate directory. Patterns The filenames listed are those which match the text in the Pattern text field. This corresponds to a Unix wildcard pattern which you can use to select a subset of the availables files. Generally this will be set to an asterisk "*", or all files. In some functions, such as saving or loading message drafts, it will be set to something else, such as "*.draft", so that only those files are listed which end in ".draft". To filter the directory contents, enter the desired search pattern in the Pattern field, and hit [return]. The file list will be refreshed according to the pattern. Directories are always included in the display regardless of the filter pattern. A detailed explanation of Unix wildcards is rather lengthy. Here are the important details: * Matches any combination of characters with anything ? Matches a single character position with anything [] Matches the characters within the brackets exactly; these may be a range, such as "[a-z]", which will match any lower-case characters in a single text position. [^] If the first character within brackets is "^", negate the match. In this case, any characters EXCEPT those within the brackets will match. Anything else within a pattern is matched exactly. For instance, "*.text" will match anything that ends with ".text". (The quotes are added for illustration only and are not part of the pattern). "*.??t" will match any name which contains a period, has three characters after the period, and which ends in "t". "*.[ao]" will match any name whose filename extension is ".a" or ".o", but it won't match other filename extensions such as ".c". Additionally, under the Options menu, you are given the choice of including so-called "dot files" in the listing. The default is to ignore them, as they are generally hidden. This involves any filename whose first character is a period. You may at any time type in a name on the Filename line without regard to whether or not it is a hidden file.