Directory Editing ||
Commands by Topic ||
Buffer List Editing|
Epsilon User's Manual and Reference >
Commands by Topic >
Buffers and Files >
Directory Editing >
This section lists the subcommands you can use when
editing a dired buffer (see Directory Editing). You run most dired
commands by pressing plain letters. All other keys still invoke the
usual Epsilon commands.
P commands go to the next and previous files,
E, <Space>, and <Enter> keys let you examine the
contents of a file. They invoke the find-file command on the
file, making the current window display this file instead of the dired
buffer. To conveniently return to the dired buffer, use the
select-buffer command (Ctrl-X B). Press <Enter> when
prompted for the buffer name and the previous buffer shown in the
current window (in this case, the dired buffer) will reappear.
When applied to a subdirectory, these keys invoke another
dired on that directory, using the name of the directory for
that dired buffer. If you have marked files for deletion or copying,
and you run a dired on the same directory, the markings go away.
." or "^" keys invoke a dired on the parent
directory of the directory associated with the current dired buffer.
To set Epsilon's current directory to the directory being displayed,
G (for Go). If the current line names a directory, Epsilon
will make that be the current directory. If the current line names a
file, Epsilon will set the current directory to the one containing
D to flag a file that you wish to delete. Epsilon will mark the
file for deletion by placing a "D" before its name. (You may delete
empty directories in the same way.) Press
M to select
files for copying or moving (renaming), respectively. Epsilon will
mark the files by placing
M before their names. The
U command unmarks the file on the current line, removing any marks
before its name.
X command actually deletes, copies, or moves the marked files.
Epsilon will list all the files marked for deletion and ask you to
confirm that you want them deleted. If any files are marked for
copying or moving, Epsilon will ask for the destination directory into
which the files are to be copied or moved. If there is only one file
to copy or move, you can also specify a file name destination, so you
can use the command for renaming files. (In this case, Alt-g will
copy the original file name so you can edit it.) Epsilon prompts for
a single destination for all files to be copied, and another for all
files to be moved.
If you try to delete a read-only file, Epsilon will prompt first; see
the dired-confirmation variable to change this. If you try to
delete a non-empty directory, Epsilon will similarly ask for
confirmation before deleting the entire directory hierarchy. Similar
prompts occur if you try to overwrite an existing local file when
copying or moving a file.
There are a few specialized commands for renaming files. Press
L to mark a file for lowercasing its name, or Shift-
for uppercasing. When you execute with
X, each marked file will
be renamed by changing each uppercase character in its name to
lowercase (or vice versa). (Note that Epsilon for Windows displays
all-uppercase file names in lowercase by default, so Shift-
effect may not be visible within Epsilon. See
R marks a file for a regular-expression replacement on its
name. When you press
X to execute operations on marked files,
Epsilon will ask for a pattern and replacement text. Then, for each
file marked with Shift-
R, Epsilon will take the file name and
perform the indicated regular expression replacement on it, generating
a new name. Then Epsilon will rename the file to the new name. For
instance, to rename a group of files like dir\file1.cxx,
dir\file2.cxx, etc. to dir2\file1.cpp, dir2\file2.cpp, use Shift-
R and specify
dir\(.*).cxx as the
search text and
dir2\#1.cpp as the replacement text. To
rename some .htm files to .html, specify
.* as the search text and
#0l as the replacement text.
By default, most files or directories that start with a period
. will be hidden. Pressing
- toggles whether such
files are hidden. The dired-show-dotfiles variable sets which
files or directories are always shown regardless of this toggle. By
default, dired entries for the current directory (
.) and its
..) are always shown.
! dired subcommand prompts for a command line, then runs the
specified program, adding the name of the current line's file after
it. If the command line you type contains an
substitutes the current file name at that position instead of at the
end. If the command line ends in a
& character, Epsilon runs the
program asynchronously; otherwise it waits for the program to finish.
+ command creates a new subdirectory. It asks for the name
of the subdirectory to create.
R command refreshes the current listing. Epsilon will use the
original file pattern to rebuild the file listing. If you've marked
files for copying, moving, or deleting, the markings will be discarded
if you refresh, so Epsilon will prompt first to confirm that you want
to do this.
S key controls sorting. It prompts you to enter another
letter to change the sorting method. Press
D to select sorting by file name, file extension, size, or time
and date of modification, respectively. Press
U to turn off
sorting the next time Epsilon makes a dired listing, and display the
file names in the same order they come from the operating system.
(You can have Epsilon rebuild the current listing using the
- at the sorting prompt to sort in ascending or
descending order, respectively, or
R to reverse the current
G at the sorting prompt to toggle directory grouping. With
directory grouping, Epsilon puts all subdirectories first in the list,
then all files, and sorts each part individually. Without directory
grouping, it mixes the two together (although it still puts
Under Windows, press
A to display the file's current attributes
(Hidden, System, Read-only and Archive) and specify a new attribute
list. You can set the dired-layout variable under Windows to
include these attributes in the dired listing itself, or customize
dired's format in other ways. Under Unix,
A runs the
command, passing it the mode specification you type, such as
to let group members write to the file. For remote files accessed via
Scp, Epsilon sends the mode specification you provide directly to the
Sftp server. It must be in the form of Unix-style octal permission
V to run the "viewer" for that file; the
program assigned to it according to Windows file associations. For
Windows executable files, this will run the program. For document
files, it typically runs the Windows program assigned to that file
extension. See File Associations for information on associating
Epsilon with particular file extensions.
V uses KDE, Gnome, or Mac
OS X file associations to run the viewer for the file. See the
epsilon-viewer script to change which of these types of viewers
Epsilon uses. For Gnome, run the gnomecc program to select a
different viewer for a specific file type.
P to print the current file. Under Windows, press
T to display the properties of a file or directory. (This is a
convenient way to see the total size of all files in a directory.)
F to search for text in a file name, skipping over matches
in the columns for file size or date, by running
incremental-search with a column restriction.
Several keys provide shortcuts for common operations. The
examines the selected file in a window that occupies the whole screen
(like typing Ctrl-X 1 E). The
2 key splits the current window
horizontally and examines the selected file in the second window,
leaving the dired buffer in the first (like typing Ctrl-X 2 E). The
5 key functions like the 2 key, but splits the window vertically
(like typing Ctrl-X 5 E). The
O key examines the selected file
in the next window on the screen, without splitting windows any
Z key zooms the window to full-screen, then examines
the selected file (like typing Ctrl-X Z E).
Press Shift-E to examine the current file or directory, like
<Enter>, but deleting the current dired buffer if you've moved to
a new one. This runs the dired-examine-deleting function,
while plain E runs dired-examine. You can swap these commands
so plain E deletes old dired buffers while Shift-E doesn't, by adding
these lines to your einit.ecm customization file (see Command Files):
~dired-tab "e": dired-examine-deleting
~dired-tab "E": dired-examine
(Similar lines can attach dired-examine-deleting to keys like
<Space> or <Enter>. See Bindings.)
L to create a live link. First Epsilon creates a
second window, if there's only one window to start with. (Provide a
numeric argument to get vertical, not
horizontal, window splitting.) Then Epsilon displays the file named
on the current dired line in that window, in a special live link
buffer. As you move around in the dired buffer, the live link buffer
will automatically update to display the current file. Files over
dired-live-link-limit bytes in size won't be shown, to avoid
delays. See the wrap-dired-live-link variable to control how
long lines display. Delete the live link buffer or window, or show a
different buffer there, to stop the live linking.
G to mark files by content. This
subcommand prompts for some search text. You can use the keys Ctrl-T,
Ctrl-W and Ctrl-C when typing the search string to toggle regex mode,
word mode, and case folding.
Then the subcommand prompts for a key to indicate what kind of marking
to apply. Press d, m, or c to mark files for deletion, moving or
copying, u to remove markings, U, L, or R to perform the corresponding
renaming function described above, or g to apply a generic marking
that simply indicates which files contained a match for the search
string. A numeric prefix argument to this subcommand reverses the
sense of its test, marking only files that don't contain the specified
[ and Alt-
] move back and forward, respectively, by marks.
They look at the mark on the current line (such as a D for deletion),
then go to the next (or previous) line that has different markings.
The copy-file-name command on Ctrl-C Alt-n copies the full
pathname of the current line's file to the clipboard (just as it
copies the current file's full pathname, in non-dired buffers).
? while in dired displays help on
these dired subcommands.
Directory Editing ||
Commands by Topic ||
Buffer List Editing|
Copyright (C) 1984, 2018 Lugaru Software Ltd. All Rights Reserved.