|
|
1.1 root 1: .TH DIRED 1
2: .CT 1 dirs
3: .SH NAME
4: dired \- directory editor
5: .SH SYNOPSIS
6: .B dired
7: [
8: .I option ...
9: ]
10: [
11: .I file
12: ]
13: .SH DESCRIPTION
14: .I Dired
15: displays a directory listing like
16: .L ls -l
17: (see
18: .IR ls (1))
19: and allows you to prowl around the listed entries,
20: deleting, editing, and displaying them.
21: It requires a cursor-addressed terminal identified
22: in environment variable
23: .BR TERM ;
24: see
25: .IR term (9.1)
26: to simulate such terminals in
27: .IR mux (9.1).
28: .PP
29: With no
30: .I file
31: argument, the current directory is listed.
32: With only one
33: .I file
34: argument, the argument is interpreted as a directory and it is listed.
35: With multiple arguments, the arguments are interpreted as filenames.
36: The options are:
37: .TP
38: .BR - [ sr ][ nsrw ]
39: Sort the file list by
40: name (default), size, access time, or modification time.
41: Ordering for
42: .B s
43: is increasing if by name, decreasing otherwise.
44: Ordering is opposite for
45: .BR r .
46: .TP
47: .BI -w n
48: If
49: .I n
50: is
51: .BR f,
52: use the full screen; if
53: .BR h ,
54: use half the screen (default); if a number, use
55: .I n
56: lines for the directory listing, reserving the rest
57: of the screen for quick
58: file display.
59: .PP
60: The fields of a
61: .I dired
62: listing are: mode, link count, owner, size, write date and name.
63: A cursor shows the current entry.
64: .PP
65: Commands consist of single characters; arguments are
66: prompted for at the bottom of the screen.
67: To get a complete list, use the help command.
68: Fuller descriptions of less obvious commands are given below.
69: .TP
70: .B !
71: Prompt for a shell command.
72: The command is executed with
73: .L %
74: characters in the command are replaced by the pathname of the current
75: entry, and
76: .L #
77: characters by the basename.
78: .TP
79: .B .
80: Repeat the previous
81: .B !
82: shell command, using the current entry to replace
83: .L %
84: or
85: .LR # .
86: .TP
87: .B d
88: Mark the current entry for deletion.
89: Deletion of a directory is recursive.
90: .TP
91: .B e
92: If the current entry is a file,
93: edit it with the editor
94: .I e,
95: or an editor named by the environment variable
96: .BR EDITOR .
97: If it is a directory,
98: invoke
99: .IR dired
100: recursively for that directory.
101: .TP
102: .B h
103: .br
104: .ns
105: .TP
106: .B ?
107: Display a help file.
108: .TP
109: .B m
110: Display the current file with the pager
111: .IR p (1),
112: or another pager named by the environment variable
113: .BR PAGER .
114: .TP
115: .B q
116: Quit this directory level of
117: .I dired.
118: List the files marked for deletion and request
119: confirmation before deleting them.
120: .TP
121: .B t
122: Type.
123: Display the current file.
124: In two-window mode pause after each screenfull until you type
125: a carriage return.
126: The display may be interrupted.
127: .SH FILES
128: .TF /usr/lib/dired
129: .TP
130: .F /usr/lib/dired
131: help file
132: .SH SEE ALSO
133: .IR ls (1)
134: .SH DIAGNOSTICS
135: While
136: .I dired
137: is preparing a listing it reports `Reading',
138: and types a dot
139: for each 10 files.
140: .SH BUGS
141: Long lines and diagnostics can foul up the
142: display.
143: .br
144: Needs a command to search for a given file.
145: .br
146: The off-line print command
147: .L p
148: is broken.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.