Annotation of researchv10dc/man/adm/man1/dired.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.