home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / demacs-5.arj / DIRED.REA < prev    next >
Lisp/Scheme  |  1991-10-30  |  4KB  |  103 lines
  1. INSTALLATION:
  2. ------------
  3.  
  4.     dired.el
  5.     emacs-19.el
  6.     dired-vms.el
  7.  
  8. Put these files into your own lisp directory - or in the system
  9. .../emacs/lisp/local/ directory if you want to install it site-wide.
  10. Byte compile the files for speed.  (But under VMS 5.0, using a
  11. compiled dired may crash Emacs.  Try it.)
  12.  
  13. If you don't have set up your own lisp directory or cannot install it
  14. in a system directory, the easiest thing is to put the files in a
  15. directory named "emacs" in your home directory and load them at
  16. startup by including the two lines
  17.  
  18.     (load (expand-file-name "~/emacs/emacs-19"))
  19.     (load (expand-file-name "~/emacs/dired"))
  20.  
  21. in your .emacs.  If dired is preloaded in your Emacs, you have to put
  22. the line
  23.  
  24.     (setq dired-mode-map nil)
  25.  
  26. _before_ the load statements, or the preloaded key bindings will not
  27. be overwritten.
  28.  
  29. Old versions of dired used to consider all files starting with `#' as
  30. auto save file.  Now only real auto-save files are flagged.  You can
  31. go back to the old behaviour by including the following line into your
  32. ~/.emacs:
  33.  
  34.   (defun auto-save-file-name-p (str) (string= "#" (substring str 0 1)))
  35.  
  36. CUSTOMIZATION:
  37. -------------
  38.  
  39. dired.el is a drop-in replacement for standard dired.  It should work
  40. without any changes to your .emacs (but dired-mark users see below).
  41.  
  42. If you want you can set some variables in your .emacs.  Here is what I do:
  43.  
  44.     (setq dired-listing-switches "-alt"    ; sort by date
  45.       ;; next 3 if you have csh or bash, see doc on dired `!' cmd.
  46.       dired-mark-prefix "{"
  47.       dired-mark-postfix "}"
  48.       dired-mark-separator ","
  49.       ;; next 2 save minibuffer screen space:
  50.       dired-background-prompt "& on %s: "
  51.       dired-shell-prompt "! on %s: ")
  52.  
  53. DIRED-MARK USERS:
  54. ----------------
  55.  
  56. This dired is based on dired.el for Emacs 19 (as sent to me by RMS to
  57. merge in my enhancements), but of course also works under 18.55 (and
  58. probably most earlier versions).  It incorporates the functionality of
  59. dired-mark.el, which I have previously posted in gnu.emacs.  If you
  60. are using that now, you should remove the dired-mark-startup function
  61. from your dired-mode-hook.  If you used the variable dired-use-more
  62. (which has now vanished), you can instead do
  63.  
  64.     (fset 'view-file 'more-file)
  65.     (fset 'view-buffer 'more-buffer)
  66.  
  67. in your .emacs to use more.el instead of view.el *everywhere* in Emacs
  68. (which is what I do).
  69.  
  70. USAGE:
  71. -----
  72.  
  73. For a start, do describe-mode (C-h m) in a dired buffer.  This
  74. mentions all the important commands.  Try the `i' command on a subdir
  75. line.  Try `l' on the subdir header line to relist the just inserted
  76. subdirectory.  Try `=' and `$' to toggle hiding.  Try `m' to mark some
  77. files and `c' to copy (or `r' to move) them into another directory.
  78. Run the shell command `ls -l' on the marked files using the `!' key.
  79.  
  80. Look into the doc for the `!' command for more info on shell commands.
  81.  
  82. Toggle sorting by name/date with `s'.  To sort on size set the
  83. switches to "-alS" using the dired `S' command.  (At least gnu ls has
  84. a -S switch to sort on size, other ls programs perhaps not.  I can
  85. give you lisp code to sort on size.)
  86.  
  87. Dired buffers know about each other.  That is, copying from DIR1 into
  88. DIR2 will update DIR2's dired buffer(s).
  89.  
  90. The `F' switch is now allowed in dired-listing-switches.  Filenames
  91. may have spaces (but no newlines or ^M's.)
  92.  
  93. BUG REPORTS:
  94. -----------
  95.  
  96. Email bug reports, comments and suggestions to me:
  97.  
  98.      Sebastian Kremer <sk@thp.uni-koeln.de>
  99.  
  100. I would especially like to hear your comments on key bindings,
  101. docstrings, missing features or creeping featurism, and consistency of
  102. user interface.
  103.