Epsilon User's Manual and Reference > Commands by Topic > Buffers and Files > Files >
File Name PromptsBy default, Epsilon interprets environment variables when you type file names, using the syntax
The list of names Epsilon recognizes between
On all platforms, you can use the name @ecustom as if it were an environment variable name, to refer to Epsilon's customization directory.
You can define your own names to be substituted just like environemnt
variable names, by putting them in a text file named
When such a variable's value is a list of directories, Epsilon
converts it into a file pattern, so a pattern like
Your values can also use extended file patterns directly. For example,
say you frequently need to grep or perform text replacements on all
.c, .h, and .cpp files in the
Epsilon caches the list of variable names and values in the
You can customize many other aspects of Epsilon's behavior when prompting for file names.
By default, many commands in the Windows version of Epsilon use the standard Windows common file dialog, but only when you invoke them from a menu or the tool bar. When you invoke these commands using their keyboard bindings, they use the same kind of dialog as other Epsilon prompts.
Set want-common-file-dialog to
The Windows common file dialog includes a list of common file extensions. You can customize this list by editing the file filter.txt, putting your own version in your customization directory (see The Customization Directory). See the comments in that file for more information. You can also customize which directory this dialog uses, and how Epsilon remembers that choice; see the common-open-use-directory variable.
All the remaining features and variables described in this section have no effect when Epsilon uses the standard Windows dialog; they only modify Epsilon's own file dialogs. Similarly, the standard Windows common file dialog cannot interpret environment variables and other names as described above.
The prompt-with-buffer-directory variable
controls how Epsilon uses the current directory at file prompts.
When this variable is
A setting of
When prompt-with-buffer-directory is
When prompt-with-buffer-directory is
The grep and file-query-replace commands use a
separate variable grep-prompt-with-buffer-directory for their
file patterns, with the same meaning as above. By default it's
During file name completion,
Epsilon can ignore files with certain extensions. The
ignore-file-extensions variable contains a list of extensions
to ignore. By default, this variable has the value
Similarly, the only-file-extensions variable makes
completion look only for files with certain extensions. It
uses the same format as ignore-file-extensions, a list of
extensions surrounded by
Completion also restricts its matches using the ignore-file-basename and ignore-file-pattern variables, which use patterns to match the names of files to be excluded. If the pattern the user types doesn't match any files, due to any of the various exclusion variables, Epsilon temporarily removes all exclusions and lists matching files again.
When Epsilon prompts for a file name, the <Space> key performs
file name completion on what you've typed. To create a new file with
spaces in its name, you must quote the space characters by typing
Ctrl-q before each one, while entering the name, or type
At any Epsilon prompt (not just file prompts), you can type Alt-e to retrieve your previous response to that prompt. Alt-<Up> or Ctrl-Alt-p show a list of previous responses. See Command History for complete details. Alt-<Down> or Ctrl-Alt-n let you easily copy text from the buffer into the prompt (useful when the buffer contains a file name or URL). See Completion & Defaults for more information. At most file name prompts, Alt-g will retrieve the name of the current buffer's file.
When Epsilon for Windows shows a dialog containing a list of previous responses, or files matching a pattern, the list may be too wide for the dialog. You can generally resize the dialog by simply dragging its border. This works for most Epsilon dialogs. Epsilon will automatically remember the size of each dialog from session to session.