perm filename DIRED.SGK[UP,DOC]1 blob
sn#117008 filedate 1974-08-30 generic text, type C, neo UTF8
COMMENT ⊗ VALID 00005 PAGES
C REC PAGE DESCRIPTION
C00001 00001
C00002 00002 Description
C00007 00003 Switches
C00012 00004 The commands
C00017 00005 Monitor Command Line and Temp Core files
C00019 ENDMK
C⊗;
Description
No claim is made for spelling. If you don't like it, fix it
Dired is a "Directory Editor". It is operationally similar
to E. It displays a list of the files in a given directory, and
permits you to modify this display to modify the state of your files.
By deleting a line of display, you delete the file described on it.
Giving a negative argument to the delete command "undeletes" the
specifed number of files, thus delete is a non-dangerous thing to do
in Dired, since it can always be undone. By editing a line (as you
would with E) you rename it. This allows you to change the file's
names, PPN, protection, date, and time. Files which are in use, or
protected against you are not displayed.
The files are displayed in alphabetic order by file name.
They can be displayed in order of date last written by using the
/DATE SORT switch. The /REVERSE SORT switch (sticky) causes the
files to be displayed in reverse order.
A mask facility is provided. The mask can be specified while
running, or in the monitor command line, in the form of a file name.
* matches any file name as in COPY (i.e. DEL, DIR, REN, COPY). ∀
matches any character in a file name. The mask FUBAR∀.* causes only
files whose first 5 letters are FUBAR to be displayed.
A similar mask facility exists for PPN's as for file names. ∀
or ? matches any character, and as in COPY * matches any name. The
PPN [* implies all of your areas, as in COPY. The PPN [? implies all
of your areas with a single character project name.
A word about deleteing: when a line of text is deleted from
the display, the delete does not actually take place. All the
deletes done are added to a "delete list" which is run when exiting,
switching PPN's, or switching devices (UDP/DSK). The delete list can
be edited using the /SHOW command. (see /SHOW switch) The delete list
can be cleared with the command /ABORT, which appears to the user to
have the effect of undoing all the deletes done since the last time
the delete list was run. Giving a negative argument to the delete
command "undeletes" files. This is done by revmoing |ARG| files from
the bottom of the delete list. The delete list can be run by using
the extended command /DELETE.
The following is a list of the descriptions of the enties in
each line of directory information displayed by Dired:
First File Name
Extension
PPN
File Size
Date Last Written
Time " "
Protection
Date Last Dumped followed by a P or T indicating dump class
Number of times file on a permanent class dump tape.
Switches
No claim is made for spelling. If you don't like it, fix it
The following are the available switches. They can be typed
at the monitor command line, or while running the program unless
otherwise noted. Only enough of the command to make it non ambiguous
need be typed.
/ABORT
Clears the delete list. Like giving an argument of -∞ to
the delete command (not switch).
/ALPHA SORT
Causes the files to be displayed in alphabetic order.
/DATE SORT
Causes the files to be displayed in order of date last
written.
/DELETE
Runs the delete list. This of course is only meaningful while
running Dired.
/DSK MODE
Edits a directory on the DSK. This is the default setting.
The device (UDP or DSK) selection is sticky.
/EXTENSION SORT
This switch controls the extension sort mode. When you are
in extension sort mode, files are sorted by extension, and then by
file name. Otherwise files are sorted by file name, then extension.
When this switch is typed, if you are already in alpha sort
mode the extension sort mode bit is complemented. If you are sorting
by date when this switch is typed, you are placed in alpha sort mode,
and extension sort mode both. Simply put, it does all the right
things for getting in and out of extension sort mode. The alpha sort
switch resets extension sort. i.e. typing /ALPHA SORT will place you
in the normal sort by alpha file names mode, as you are in by default
when you start Dired.
/K MODE
Complements the mode in which file sizes are printed. File
sizes are printed in words unless this switch is thrown, in which
case files larger than 1024 are printed in the form "69 K", where
1024. is 1 K.
/READ ONLY or /R ;THIS IS NOT UP YET
Prevents you from modifying anything. If you do a delete,
the text will disappear, but the delete list is never run.
/REVERSE SORT
Causes the sort direction to be complemented. Displaying your
files in reverse /DATE SORT mode shows the most recent files first.
/SHOW DELETE LIST
This command switches your display mode between the normal,
and Delete List mode. In delete list mode instead of displaying your
files, your delete list is shown. Your delete list contains the
files you have deleted. These files will be delete when you exit
Dired, unless you undelete them first. While in delete list mode, you
may delete entries from the delete list by using the αβD command.
This has the effect of "undeleting" files. (i.e. you can edit your
editions by going into delete list mode and "deleteing deletes" done
in the past)
/UDP MODE
Edits a directory on the UDP assigned as device UDP. If
typed while running and files have been deleted from the current
display, the delete list is run first.
The commands
No claim is made for spelling. If you don't like it, fix it
The following commands are the same or close to the same as they are
in E.
αβE αβL αβW αβV CR VT αβ> αβ<
αβ≤ αβ≥ FORM αβT αβB αβJ
Dired commands accepts arguments in a simlar way to E (<Control>
<Meta><digit>). This includes αβ- and αβ∞.
The following are descriptions of other commands to Dired. Below ARG
is used to mean the value of the argument given to the command.
Unless otherwise mentioned, commands given no argument will act as if
an argument of one had been given.
? HELP
Will display a screenful of information about the commands.
αβD DELETE
This command when given a positive argument, deletes ARG
files from your directory. It behaves in a manner similar to αβD in
E. Deleteing a line of directory information has the effect of
deleteing the file described on it.
When given a negative argument it "Undeletes" ARG files,
undeleteing the files most recently flushed first. The way this is
accomplished is by removing files from the delete list. When a
delete command is typed the information about which files to delete
is added to the delete list, and this list is ran when doing such
things as exiting the program, or switching PPN's
αβ|α|βE THE EXITS
These are the various ways of exiting Dired gracefully. αβE
simply deletes all the files you have asked it to during your stay,
writes a TMPCOR file, and exits.
αE and βE edit the current file, after exiting gracefully as
above. They both start editing on page |ARG| of the file. They
differ in that βE edits the file in /R mode. (suitable for pawing
thru a directory to see what's what)
You can return to Dired from E by typing the extended command
DIRED. "DI" is non-ambiguous at this time.
αβM SET MASK
This command reads a mask in the form of a file name.
Anything that may have been specified in a command line may be
specified here, such as a PPN, and Switches. αβMFOO*.*/DATE[69,105
sets the mask to display only the files that begin with "FOO", sort
them by date, and get all of this from [69,105].
This is the best command to use when you are changing your
PPN, device, or mask. The "[" command is useful for changing your
PPN without changing your mask.
[ READ PPN
Accepts a PPN without changing the mask. A ] or a CR will
terminate reading of a PPN.
/ SWITCHES AND EXTENDED COMMANDS
Typing a / will leave you in the line editor and allow you to
type one or more switches. Of course a PPN may be specified in this
line also.
αβ≡ DDT
This enters the DDT in your core image after clearing the
screen for you. It sets up .JBOPC so you can return from RAID by
using the proceed commannd. You should not do this unless you know
what you are doing.
Monitor Command Line and Temp Core files
No claim is made for spelling. If you don't like it, fix it
When you exit Dired, it creates a TMPCOR file containing
information about what you were doing, such as the PPN, where you
were in the display, the sort mode, etc. When a Dired is started, if
this file exists it is read, and sets these things back to the state
described. Information given in the command line is used over TMPCOR
information. The only exception to this is that if you specify a
device in the command line the old PPN (from the TMPCOR file) is
replaced by your current alias (unless you specify another)
Here are some sample Montior Command Lines:
R DIRED;[105,69
Edits the directory [105,69]
R DIRED;UDP1:
Edits your directory (or alias'd directory) on device UDP1:
R DIRED;/EX
Edits the last directory edited (or your DSKPPN's directory
if you have no TMPCOR file) displaying files sorted by file
extension.