DIRED(1) DIRED(1)
NAME
dired - directory editor
SYNOPSIS
dired [ option ... ] [ file ]
DESCRIPTION
Dired displays a directory listing like `ls -l' (see ls(1))
and allows you to prowl around the listed entries, deleting,
editing, and displaying them. It requires a cursor-
addressed terminal identified in environment variable TERM;
see term(9.1) to simulate such terminals in mux(9.1).
With no file argument, the current directory is listed.
With only one file argument, the argument is interpreted as
a directory and it is listed. With multiple arguments, the
arguments are interpreted as filenames. The options are:
-[sr][nsrw]
Sort the file list by name (default), size, access
time, or modification time. Ordering for s is increas-
ing if by name, decreasing otherwise. Ordering is
opposite for r.
-wn If n is f, use the full screen; if h, use half the
screen (default); if a number, use n lines for the
directory listing, reserving the rest of the screen for
quick file display.
The fields of a dired listing are: mode, link count, owner,
size, write date and name. A cursor shows the current
entry.
Commands consist of single characters; arguments are
prompted for at the bottom of the screen. To get a complete
list, use the help command. Fuller descriptions of less
obvious commands are given below.
! Prompt for a shell command. The command is executed
with `%' characters in the command are replaced by the
pathname of the current entry, and `#' characters by
the basename.
. Repeat the previous ! shell command, using the current
entry to replace `%' or `#'.
d Mark the current entry for deletion. Deletion of a
directory is recursive.
e If the current entry is a file, edit it with the editor
DIRED(1) DIRED(1)
e, or an editor named by the environment variable
EDITOR. If it is a directory, invoke dired recursively
for that directory.
h
? Display a help file.
m Display the current file with the pager p(1), or
another pager named by the environment variable PAGER.
q Quit this directory level of dired. List the files
marked for deletion and request confirmation before
deleting them.
t Type. Display the current file. In two-window mode
pause after each screenfull until you type a carriage
return. The display may be interrupted.
FILES
help file
SEE ALSO
ls(1)
DIAGNOSTICS
While dired is preparing a listing it reports `Reading', and
types a dot for each 10 files.
BUGS
Long lines and diagnostics can foul up the display.
Needs a command to search for a given file.
The off-line print command `p' is broken.