home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
3
/
3dired11.zip
/
READ.ME
< prev
next >
Wrap
Text File
|
1992-08-23
|
20KB
|
499 lines
-\|/- Dired [1.1] for MicroEMACS === 1992 (c) J. E. Hetrick
__________________________________________________________________
This is a package of Dired.cmd files for use with MicroEMACS
3.11. Dired is a GNUEmacs function which allows you to load
a directory listing into a buffer and then manipulate the
files by keystroke and mouse actions. It's handy for cleaning
up directories, compressing, and uncompressing, and archiving.
In some sense it is a menu-like interface to your directory tree.
Note too that some functions here are modeled after Sebastian
Kramer's, now classic, "Tree Dired" extension of GNU Dired.
The package contains 3 files:
dosdired.cmd --- for use with MicroEMACS under DOS
unxdired.cmd --- for MicroEMACS under Unix
read.me --- this file
Most functions are the same in each version, however I found that
the function key interface was faster in the DOS version, ie entering
commands via the Shifted F-keys. Whereas, there is no uniform behavior
of these keys on Unix systems, so the commands are entered via letter
keys, like in GNUEmacs Dired.
Since the functioning of the two versions is sufficiently different
I won't try to outline them here, but have included commented
documentation in the header of each version. You can chop this out
and make a manual page if you like. The function section of each
is reproduced here.
A couple points to note:
************************************************************
As this program has the capability to DELETE YOUR FILES!
please put some test files in a subdirectory and try it
out on them. After you're convinced of its integrity, put it
herever your .cmd files live and fire at will.
************************************************************
* DOS * version:
================
The DOS version relies on a function called "mv" to
move files from one directory to another. There are several
ShareWare and Public Domain versions which do this. Just
check the archive where you got jdired11.zip and see what
they have. Please familiarize yourself with the functioning
of "mv" so that you will be sure what action is taking place
when you "move" a file with S-F3. Note too, that the name of
the move function must be set in the statement:
set %mvfunc "mv ".
The archiving functions depend on PKzip and PKUnZip being in
your path. This can be easily rewritten if you prefer another
archiver (but you have to do it :-)
In the section of code which handles command processing,
D-process, I've left in the Unix style letter command
processing in case you prefer to switch back. If you use
MicroEMACS both under DOS and Unix, it's much nicer to
have the same functionality. Just follow the directions in
the source if you want to change over to letters.
A code page for DOS Dired is included in the header of
that version.
DOS Functions:
=============
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
; Movement: = Usual: Up, Down, PgUp, PgDn, etc., and left mouse
; button
;
; <ENTER> = Load File (on files)
; or right = Load Subdir into Dired window (on subdirs)
; mouse button (with mouse hit the left button first to move the
; point to the current line, then click the right one)
;
; C-<ENTER> = Split screen, load File/Subdir in second window
;
; C-x C-f = Open new file: A single name gets the currently
; viewed directory prepended. If the entered name
; contains directory names, ie. has a "\" in it,
; it is opened as is.)
;
; C-x e = Execute File, works on some cmd files, like CAL1.CMD
;
; C-c = Exit the Dired command processor. This just leaves
; you in the Directory listing as an ordinary file.
;
; When entering filenames, for copy, move, etc., a single name gets
; the currently viewed diredctory prepended. Names which contain "\"
; are taken as is. Names ending in ":", ie. "A:" get a "\" postfixed.
; Below, --- is the action on a single file,
; -*- is the action if files are marked.
;
; S-F1 = Copy --- you are prompted for a name/destination.
; -*- prompt for dest; copy all marked files
;
; S-F2 = Delete --- delete file. (you're prompted)
; -*- or all marked files. (prompted)
; >>>[prompting can be turned off for the brave]
;
; S-F3 = Move --- you are prompted for a destination.
; -*- prompt for dest; move all marked files
; (exact behavior depends on your "mv" function)
;
; S-F4 = Rename --- rename file
;
; S-F5 = Mark --- Mark file with %markstr ( * ) and move to next
; line.
;
; S-F6 = Un-Mark --- Unmarks file.
;
; S-F7 = Revert --- Updates Dired buffer by re-reading
; directory from disk.
;
; S-F8 = Make Subdir --- Make a new subdirectory
;
; S-F9 = PK-Zip --- PKzips file.
; -*- PKzips marked files into one zipfile.
; file.zip If pressed on an file ending in .ZIP,
; ie. trying to zip a zipped file,
; invokes PKzip -v, to view contents
; of file in another window.
;
; S-F10 = PK-UnZip --- Un-zip file
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
* Unix * version:
=================
The Unix version has a new "META"-type key. To enter
commands such as C-x x (^XX) to change to a new buffer, you
first type "q", which prompts you for a "Command Sequence".
You then type whatever set of control characters you like
and Dired will process them (as best it can).
Unix Functions:
==============
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
; Movement:
;
; arrow keys: up and down (seem to work for me)
; P, N: up, down respectively
; k, j: up, down respectively
; q-PgUpKey, V: Page-up
; q-PgDnKey, B: Page-down
;
; A note about movement keys: the V and B above are delivered on some
; machines as the *key* entered when hitting PgUp and PgDn. The
; *cmd* is still (previous/next-page). Hence, your PgUp/Dn keys
; may work just as keys, or you may have to prefix them with the
; Dired-META "q" ie. q-PgUp... Failing that you can just enter "V"
; or "B". The same applies to the arrow keys. Mine seem to work with
; P and N, however k and j (like vi) are supplied in case yours don't.
;
; (If you feel like recompiling, Richard Meitzler, Stratus Computer,
; Marlboro, MA, [rgm@hw.stratus.com] has had some success fixing
; unix.c in the memacs source to interpret the Sun/Sparc function
; keys.)
;
; Commands:
;
; f --- load file/directory into current window
;
; o --- load file/directory into another window
;
; m,d -- mark file (with %markstr)
;
; u --- unmark file
;
; c --- copy (marked) file(s)
;
; r --- rename or move (marked) file(s)
;
; x --- delete (marked) file(s) [you're prompted; prompting can
; be turned off]
;
; C --- compress ...
;
; U --- uncompress ...
;
; e --- extract tar file
;
; t --- on a .tar archive, view contents in other window
; --- or tar (marrked) file(s) into an archive
; (must be viewing directory from which MicroEMACS
; was invoked, ie. default directory at startup
; so that files in tar file are portable---with no paths)
;
; a --- execute file (useful for .cmd files; doesn't always work)
;
; z --- leave dired processor (Dired-buffer becomes like any other)
;
; Note that file or directory inputs to Dired are globbed
; so that ~/filename is expanded using you $HOME variable
; (only ~/ is expanded though).
;
; Filenames and directories entered for copy, move, etc., are
; processed as follows: a single name gets the currently viewed
; directory prepended to it. If the filename/dir is entered with
; "/"'s in it, it's assumed that it represents a full pathname
; and left alone. ".." is a valid directory and will be expanded
; relative to the viewed directory.
;
; C-x C-f (find-file) while in a some directory, opens a (new) file
; in that directory.
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
* Other Operating Systems *
I haven't done any work with other systems than DOS and
Unix on a Sparc, Sun 3, and an RISC 6000. Dired should
work fine though with perhaps a small bit of modification.
If you do this please write me about it, so I can credit
you and add your changes to new versions.
PLEASE REPORT BUGS! (or delights). These projects work because
of a worldwide network of users who contribute their ideas and
time. If something goes wrong, please let me know so I can fix it.
On the other hand if you find you like this little piece of code,
don't hesitate to drop me a note saying so; it'll make my day a
bit more pleasant.
Thanks very much to Richard Meitzler for the 4DOS fix and for
beta testing this 1.1 version.
That's about it. The above notes are also mentioned in the
headers of each dired file.
Enjoy your time,
Jim
==============================================================
James E. Hetrick Institute for Theoretical Physics
hetrick@phys.uva.nl -\|/-
University of Amsterdam
Valckenierstraat 65, 1018 XE Amsterdam
Telephone: +31 20 525 5663 Fax: +31 20 525 5788
===============================================================
-\|/- Dired [1.1] for MicroEMACS === 1992 (c) J. E. Hetrick
__________________________________________________________________
This is a package of Dired.cmd files for use with MicroEMACS
3.11. Dired is a GNUEmacs function which allows you to load
a directory listing into a buffer and then manipulate the
files by keystroke and mouse actions. It's handy for cleaning
up directories, compressing, and uncompressing, and archiving.
In some sense it is a menu-like interface to your directory tree.
Note too that some functions here are modeled after Sebastian
Kramer's, now classic, "Tree Dired" extension of GNU Dired.
The package contains 3 files:
dosdired.cmd --- for use with MicroEMACS under DOS
unxdired.cmd --- for MicroEMACS under Unix
read.me --- this file
Most functions are the same in each version, however I found that
the function key interface was faster in the DOS version, ie entering
commands via the Shifted F-keys. Whereas, there is no uniform behavior
of these keys on Unix systems, so the commands are entered via letter
keys, like in GNUEmacs Dired.
Since the functioning of the two versions is sufficiently different
I won't try to outline them here, but have included commented
documentation in the header of each version. You can chop this out
and make a manual page if you like. The function section of each
is reproduced here.
A couple points to note:
************************************************************
As this program has the capability to DELETE YOUR FILES!
please put some test files in a subdirectory and try it
out on them. After you're convinced of its integrity, put it
herever your .cmd files live and fire at will.
************************************************************
* DOS * version:
================
The DOS version relies on a function called "mv" to
move files from one directory to another. There are several
ShareWare and Public Domain versions which do this. Just
check the archive where you got jdired11.zip and see what
they have. Please familiarize yourself with the functioning
of "mv" so that you will be sure what action is taking place
when you "move" a file with S-F3. Note too, that the name of
the move function must be set in the statement:
set %mvfunc "mv ".
The archiving functions depend on PKzip and PKUnZip being in
your path. This can be easily rewritten if you prefer another
archiver (but you have to do it :-)
In the section of code which handles command processing,
D-process, I've left in the Unix style letter command
processing in case you prefer to switch back. If you use
MicroEMACS both under DOS and Unix, it's much nicer to
have the same functionality. Just follow the directions in
the source if you want to change over to letters.
A code page for DOS Dired is included in the header of
that version.
DOS Functions:
=============
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
; Movement: = Usual: Up, Down, PgUp, PgDn, etc., and left mouse
; button
;
; <ENTER> = Load File (on files)
; or right = Load Subdir into Dired window (on subdirs)
; mouse button (with mouse hit the left button first to move the
; point to the current line, then click the right one)
;
; C-<ENTER> = Split screen, load File/Subdir in second window
;
; C-x C-f = Open new file: A single name gets the currently
; viewed directory prepended. If the entered name
; contains directory names, ie. has a "\" in it,
; it is opened as is.)
;
; C-x e = Execute File, works on some cmd files, like CAL1.CMD
;
; C-c = Exit the Dired command processor. This just leaves
; you in the Directory listing as an ordinary file.
;
; When entering filenames, for copy, move, etc., a single name gets
; the currently viewed diredctory prepended. Names which contain "\"
; are taken as is. Names ending in ":", ie. "A:" get a "\" postfixed.
; Below, --- is the action on a single file,
; -*- is the action if files are marked.
;
; S-F1 = Copy --- you are prompted for a name/destination.
; -*- prompt for dest; copy all marked files
;
; S-F2 = Delete --- delete file. (you're prompted)
; -*- or all marked files. (prompted)
; >>>[prompting can be turned off for the brave]
;
; S-F3 = Move --- you are prompted for a destination.
; -*- prompt for dest; move all marked files
; (exact behavior depends on your "mv" function)
;
; S-F4 = Rename --- rename file
;
; S-F5 = Mark --- Mark file with %markstr ( * ) and move to next
; line.
;
; S-F6 = Un-Mark --- Unmarks file.
;
; S-F7 = Revert --- Updates Dired buffer by re-reading
; directory from disk.
;
; S-F8 = Make Subdir --- Make a new subdirectory
;
; S-F9 = PK-Zip --- PKzips file.
; -*- PKzips marked files into one zipfile.
; file.zip If pressed on an file ending in .ZIP,
; ie. trying to zip a zipped file,
; invokes PKzip -v, to view contents
; of file in another window.
;
; S-F10 = PK-UnZip --- Un-zip file
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
* Unix * version:
=================
The Unix version has a new "META"-type key. To enter
commands such as C-x x (^XX) to change to a new buffer, you
first type "q", which prompts you for a "Command Sequence".
You then type whatever set of control characters you like
and Dired will process them (as best it can).
Unix Functions:
==============
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
; Movement:
;
; arrow keys: up and down (seem to work for me)
; P, N: up, down respectively
; k, j: up, down respectively
; q-PgUpKey, V: Page-up
; q-PgDnKey, B: Page-down
;
; A note about movement keys: the V and B above are delivered on some
; machines as the *key* entered when hitting PgUp and PgDn. The
; *cmd* is still (previous/next-page). Hence, your PgUp/Dn keys
; may work just as keys, or you may have to prefix them with the
; Dired-META "q" ie. q-PgUp... Failing that you can just enter "V"
; or "B". The same applies to the arrow keys. Mine seem to work with
; P and N, however k and j (like vi) are supplied in case yours don't.
;
; (If you feel like recompiling, Richard Meitzler, Stratus Computer,
; Marlboro, MA, [rgm@hw.stratus.com] has had some success fixing
; unix.c in the memacs source to interpret the Sun/Sparc function
; keys.)
;
; Commands:
;
; f --- load file/directory into current window
;
; o --- load file/directory into another window
;
; m,d -- mark file (with %markstr)
;
; u --- unmark file
;
; c --- copy (marked) file(s)
;
; r --- rename or move (marked) file(s)
;
; x --- delete (marked) file(s) [you're prompted; prompting can
; be turned off]
;
; C --- compress ...
;
; U --- uncompress ...
;
; e --- extract tar file
;
; t --- on a .tar archive, view contents in other window
; --- or tar (marrked) file(s) into an archive
; (must be viewing directory from which MicroEMACS
; was invoked, ie. default directory at startup
; so that files in tar file are portable---with no paths)
;
; a --- execute file (useful for .cmd files; doesn't always work)
;
; z --- leave dired processor (Dired-buffer becomes like any other)
;
; Note that file or directory inputs to Dired are globbed
; so that ~/filename is expanded using you $HOME variable
; (only ~/ is expanded though).
;
; Filenames and directories entered for copy, move, etc., are
; processed as follows: a single name gets the currently viewed
; directory prepended to it. If the filename/dir is entered with
; "/"'s in it, it's assumed that it represents a full pathname
; and left alone. ".." is a valid directory and will be expanded
; relative to the viewed directory.
;
; C-x C-f (find-file) while in a some directory, opens a (new) file
; in that directory.
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
* Other Operating Systems *
I haven't done any work with other systems than DOS and
Unix on a Sparc, Sun 3, and an RISC 6000. Dired should
work fine though with perhaps a small bit of modification.
If you do this please write me about it, so I can credit
you and add your changes to new versions.
PLEASE REPORT BUGS! (or delights). These projects work because
of a worldwide network of users who contribute their ideas and
time. If something goes wrong, please let me know so I can fix it.
On the other hand if you find you like this little piece of code,
don't hesitate to drop me a note saying so; it'll make my day a
bit more pleasant.
Thanks very much to Richard Meitzler for the 4DOS fix and for
beta testing this 1.1 version.
That's about it. The above notes are also mentioned in the
headers of each dired file.
Enjoy your time,
Jim
==============================================================
James E. Hetrick Institute for Theoretical Physics
hetrick@phys.uva.nl -\|/-
University of Amsterdam
Valckenierstraat 65, 1018 XE Amsterdam
Telephone: +31 20 525 5663 Fax: +31 20 525 5788
===============================================================