]> code.delx.au - gnu-emacs/blobdiff - lisp/ls-lisp.el
(help-menu-bar-map): Put the Help item in this map.
[gnu-emacs] / lisp / ls-lisp.el
index 67364ab82ef80560950f3c7e7e112cf23b845a11..e02b668aa716909840c2c32449a98d99416a87a1 100644 (file)
@@ -1,9 +1,7 @@
-;;;; dired-lisp.el - emulate Tree Dired's ls completely in Emacs Lisp
+;;; ls-lisp.el --- emulate insert-directory completely in Emacs Lisp
 
-;;;; READ THE WARNING BELOW BEFORE USING THIS PROGRAM!
-
-(defconst dired-lisp-version (substring "$Revision: 1.6 $" 11 -2)
-  "$Id: dired-lisp.el,v 1.6 1992/04/30 10:29:53 sk Exp sk $")
+;; Author: Sebastian Kremer <sk@thp.uni-koeln.de>
+;; Keywords: unix
 
 ;; Copyright (C) 1992 by Sebastian Kremer <sk@thp.uni-koeln.de>
 
 ;; along with this program; if not, write to the Free Software
 ;; Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
-;; LISPDIR ENTRY for the Elisp Archive ===============================
-;;    LCD Archive Entry:
-;;    dired-lisp|Sebastian Kremer|sk@thp.uni-koeln.de
-;;    |emulate Tree Dired's ls completely in Emacs Lisp 
-;;    |$Date: 1992/04/30 10:29:53 $|$Revision: 1.6 $|
-
 ;; INSTALLATION =======================================================
 ;; 
-;; Put this file into your load-path.  Loading it will result in
-;; redefining function dired-ls to not call ls.
-
-;; You need tree dired from ftp.cs.buffalo.edu:pub/Emacs/diredall.tar.Z,
-;; classic (e.g. 18.57) dired.el will not work.
+;; Put this file into your load-path.  To use it, load it
+;; with (load "ls-lisp").
 
 ;; OVERVIEW ===========================================================
 
-;; This file overloads tree dired so that all fileinfo is retrieved
-;; directly from Emacs lisp, without using an ls subprocess.
+;; This file overloads the function insert-directory to implement it
+;; directly from Emacs lisp, without running `ls' in a subprocess.
 
-;; Useful if you cannot afford to fork Emacs on a real memory UNIX,
+;; It is useful if you cannot afford to fork Emacs on a real memory UNIX,
 ;; under VMS, or if you don't have the ls program, or if you want
 ;; different format from what ls offers.
 
-;; Beware that if you change the output format of dired-ls, you'll
-;; have to change dired-move-to-filename and
-;; dired-move-to-end-of-filename as well.
-
-;; With this package is loaded, dired uses regexps instead of shell
-;; wildcards. If you enter regexps remember to double each $ sign.
-;; For example, to dired all elisp (*.el) files, enter `.*\.el$$',
+;; This function uses regexps instead of shell
+;; wildcards.  If you enter regexps remember to double each $ sign.
+;; For example, to include files *.el, enter `.*\.el$$',
 ;; resulting in the regexp `.*\.el$'.
 
-;; WARNING ===========================================================
-
-;; With earlier version of this program I sometimes got an internal
-;; Emacs error:
-
-;;   Signalling: (wrong-type-argument natnump #<EMACS BUG: ILLEGAL
-;;   DATATYPE (#o37777777727) Save your buffers immediately and please
-;;   report this bug>)
-
-;; The datatype differs (I also got #o67 once).
-
-;; Sometimes emacs just crashed with a fatal error.
-
-;; After I've avoided using directory-files and file-attributes
-;; together inside a mapcar, the bug didn't surface any longer.
-
 ;;  RESTRICTIONS =====================================================
 
-;; * ls switches are mostly ignored, see docstring of `dired-ls'.
-
-;; * In Emacs 18: cannot display date of file, displays a fake date
-;;   "Jan 00 00:00" instead (dates do work in Emacs 19)
+;; * many ls switches are ignored, see docstring of `insert-directory'.
 
 ;; * Only numeric uid/gid
 
-;; * if you load dired-lisp after ange-ftp, remote listings look
-;;   really strange: 
-;;
-;;   total 1
-;;   d?????????  -1 -1       -1             -1 Jan  1  1970 .
-;;   d?????????  -1 -1       -1             -1 Jan  1  1970 ..
-;;
-;;   This is because ange-ftp's file-attributes does not return much
-;;   useful information.
-;;
-;;   If you load dired-lisp first, there seem to be no problems.
-
 ;; TODO ==============================================================
 
 ;; Recognize some more ls switches: R F
 \f
+;;; Code:
 
-(require 'dired)                       ; we will redefine dired-ls:
-(or (fboundp 'dired-lisp-unix-ls)
-    (fset 'dired-lisp-unix-ls (symbol-function 'dired-ls)))
-
-(fset 'dired-ls 'dired-lisp-ls)
-
-(defun dired-lisp-ls (file &optional switches wildcard full-directory-p)
-  "dired-lisp.el's version of dired-ls.
-Known switches: A a S r i s
-In Emacs 19, additional known switches are: c u
-Others are ignored.
-
-  Insert ls output of FILE, optionally formatted with SWITCHES.
-Optional third arg WILDCARD means treat non-directory part of FILE as
-emacs regexp (_not_ a shell wildcard).  If you enter regexps remember
-to double each $ sign.
-
+(defun insert-directory (file &optional switches wildcard full-directory-p)
+  "Insert directory listing for of FILE, formatted according to SWITCHES.
+Leaves point after the inserted text.
+Optional third arg WILDCARD means treat FILE as shell wildcard.
 Optional fourth arg FULL-DIRECTORY-P means file is a directory and
-switches do not contain `d'.
-
-SWITCHES default to dired-listing-switches."
-  (or switches (setq switches dired-listing-switches))
-  (or (consp switches)                 ; convert to list of chars
-      (setq switches (mapcar 'identity switches))) 
-  (if wildcard
-      (setq wildcard (file-name-nondirectory file) ; actually emacs regexp
-           ;; perhaps convert it from shell to emacs syntax?
-           file (file-name-directory file)))
-  (if (or wildcard
-         full-directory-p)
-      (let* ((dir (file-name-as-directory file))
-            (default-directory dir);; so that file-attributes works
-            (sum 0)
-            elt
-            (file-list (directory-files dir nil wildcard))
-            file-alist 
-            ;; do all bindings here for speed
-            fil attr)
-       (cond ((memq ?A switches)
-              (setq file-list
-                    (dired-lisp-delete-matching "^\\.\\.?$" file-list)))
-             ((not (memq ?a switches))
-              ;; if neither -A  nor -a, flush . files
-              (setq file-list
-                    (dired-lisp-delete-matching "^\\." file-list))))
-       (setq file-alist
-             (mapcar
-              (function
-               (lambda (x)
-                 ;; file-attributes("~bogus") bombs
-                 (cons x (file-attributes (expand-file-name x)))))
-              ;; inserting the call to directory-files right here
-              ;; seems to stimulate an Emacs bug
-              ;; ILLEGAL DATATYPE (#o37777777727) or #o67
-              file-list))
-       (insert "total \007\n")         ; filled in afterwards
-       (setq file-alist
-             (dired-lisp-handle-switches file-alist switches))
-       (while file-alist
-         (setq elt (car file-alist)
-               short (car elt)
-               attr  (cdr elt)
-               file-alist (cdr file-alist)
-               fil (concat dir short)
-               sum (+ sum (nth 7 attr)))
-         (insert (dired-lisp-format short attr switches)))
-       ;; Fill in total size of all files:
-       (save-excursion
-         (search-backward "total \007")
-         (goto-char (match-end 0))
-         (delete-char -1)
-         (insert (format "%d" (1+ (/ sum 1024))))))
-    ;; if not full-directory-p, FILE *must not* end in /, as
-    ;; file-attributes will not recognize a symlink to a directory
-    ;; must make it a relative filename as ls does:
-    (setq file (file-name-nondirectory file))
-    (insert (dired-lisp-format file (file-attributes file) switches))))
-
-(defun dired-lisp-delete-matching (regexp list)
+switches do not contain `d', so that a full listing is expected.
+
+This version of the function comes from `ls-lisp.el'.
+It does not support ordinary shell wildcards; instead, it allows
+regular expressions to match file names.
+
+The switches that work are: A a c i r S s t u"
+  (let ((handler (find-file-name-handler file)))
+    (if handler
+       (funcall handler 'insert-directory file switches
+                wildcard full-directory-p)
+      ;; Convert SWITCHES to a list of characters.
+      (setq switches (append switches nil))
+      (if wildcard
+         (setq wildcard (file-name-nondirectory file) ; actually emacs regexp
+               ;; perhaps convert it from shell to emacs syntax?
+               file (file-name-directory file)))
+      (if (or wildcard
+             full-directory-p)
+         (let* ((dir (file-name-as-directory file))
+                (default-directory dir);; so that file-attributes works
+                (sum 0)
+                elt
+                short
+                (file-list (directory-files dir nil wildcard))
+                file-alist 
+                ;; do all bindings here for speed
+                fil attr)
+           (cond ((memq ?A switches)
+                  (setq file-list
+                        (ls-lisp-delete-matching "^\\.\\.?$" file-list)))
+                 ((not (memq ?a switches))
+                  ;; if neither -A  nor -a, flush . files
+                  (setq file-list
+                        (ls-lisp-delete-matching "^\\." file-list))))
+           (setq file-alist
+                 (mapcar
+                  (function
+                   (lambda (x)
+                     ;; file-attributes("~bogus") bombs
+                     (cons x (file-attributes (expand-file-name x)))))
+                  ;; inserting the call to directory-files right here
+                  ;; seems to stimulate an Emacs bug
+                  ;; ILLEGAL DATATYPE (#o37777777727) or #o67
+                  file-list))
+           (insert "total \007\n")     ; filled in afterwards
+           (setq file-alist
+                 (ls-lisp-handle-switches file-alist switches))
+           (while file-alist
+             (setq elt (car file-alist)
+                   short (car elt)
+                   attr  (cdr elt)
+                   file-alist (cdr file-alist)
+                   fil (concat dir short)
+                   sum (+ sum (nth 7 attr)))
+             (insert (ls-lisp-format short attr switches)))
+           ;; Fill in total size of all files:
+           (save-excursion
+             (search-backward "total \007")
+             (goto-char (match-end 0))
+             (delete-char -1)
+             (insert (format "%d" (1+ (/ sum 1024))))))
+       ;; if not full-directory-p, FILE *must not* end in /, as
+       ;; file-attributes will not recognize a symlink to a directory
+       ;; must make it a relative filename as ls does:
+       (setq file (file-name-nondirectory file))
+       (insert (ls-lisp-format file (file-attributes file) switches))))))
+
+(defun ls-lisp-delete-matching (regexp list)
   ;; Delete all elements matching REGEXP from LIST, return new list.
   ;; Should perhaps use setcdr for efficiency.
   (let (result)
@@ -183,28 +133,47 @@ SWITCHES default to dired-listing-switches."
       (setq list (cdr list)))
     result))
 
-(defun dired-lisp-handle-switches (file-alist switches)
+(defun ls-lisp-handle-switches (file-alist switches)
   ;; FILE-ALIST's elements are (FILE . FILE-ATTRIBUTES).
   ;; Return new alist sorted according to SWITCHES which is a list of
   ;; characters.  Default sorting is alphabetically.
-  (setq file-alist
-       (sort file-alist
-             (cond ((memq ?S switches)
-                    (function
-                     (lambda (x y)
-                       ;; 7th file attribute is file size
-                       ;; Make largest file come first
-                       (< (nth 7 (cdr y)) (nth 7 (cdr x))))))
-                   ;; does Emacs 19 have a way to compare times?
-                   (t                  ; sorted alphabetically
-                    (function
-                     (lambda (x y)
-                       (string-lessp (car x) (car y))))))))
+  (let (index)
+    (setq file-alist
+         (sort file-alist
+               (cond ((memq ?S switches) ; sorted on size
+                      (function
+                       (lambda (x y)
+                         ;; 7th file attribute is file size
+                         ;; Make largest file come first
+                         (< (nth 7 (cdr y))
+                            (nth 7 (cdr x))))))
+                     ((memq ?t switches) ; sorted on time
+                      (setq index (ls-lisp-time-index switches))
+                      (function
+                       (lambda (x y)
+                         (ls-lisp-time-lessp (nth index (cdr y))
+                                             (nth index (cdr x))))))
+                     (t                ; sorted alphabetically
+                      (function
+                       (lambda (x y)
+                         (string-lessp (car x)
+                                       (car y)))))))))
   (if (memq ?r switches)               ; reverse sort order
       (setq file-alist (nreverse file-alist)))
   file-alist)
 
-(defun dired-lisp-format (file-name file-attr &optional switches)
+;; From Roland McGrath.  Can use this to sort on time.
+(defun ls-lisp-time-lessp (time0 time1)
+  (let ((hi0 (car time0))
+       (hi1 (car time1))
+       (lo0 (car (cdr time0)))
+       (lo1 (car (cdr time1))))
+    (or (< hi0 hi1)
+       (and (= hi0 hi1)
+            (< lo0 lo1)))))
+
+
+(defun ls-lisp-format (file-name file-attr &optional switches)
   (let ((file-type (nth 0 file-attr)))
     (concat (if (memq ?i switches)     ; inode number
                (format "%6d " (nth 10 file-attr)))
@@ -218,11 +187,15 @@ SWITCHES default to dired-listing-switches."
            ;; optional arg.
            (format " %3d %-8d %-8d %8d "
                    (nth 1 file-attr)   ; no. of links
-                   (nth 2 file-attr)   ; uid
-                   (nth 3 file-attr)   ; gid
+                   (if (= (user-uid) (nth 2 file-attr))
+                       (user-login-name)
+                     (nth 2 file-attr))        ; uid
+                   (if (eq system-type 'ms-dos)
+                       "root"          ; everything is root on MSDOS.
+                     (nth 3 file-attr))        ; gid
                    (nth 7 file-attr)   ; size in bytes
                    )
-           (dired-lisp-format-time file-attr switches)
+           (ls-lisp-format-time file-attr switches)
            " "
            file-name
            (if (stringp file-type)     ; is a symbolic link
@@ -231,7 +204,15 @@ SWITCHES default to dired-listing-switches."
            "\n"
            )))
 
-(defun dired-lisp-format-time (file-attr switches)
+(defun ls-lisp-time-index (switches)
+  ;; Return index into file-attributes according to ls SWITCHES.
+  (cond
+   ((memq ?c switches) 6)              ; last mode change
+   ((memq ?u switches) 4)              ; last access
+   ;; default is last modtime
+   (t 5)))
+
+(defun ls-lisp-format-time (file-attr switches)
   ;; Format time string for file with attributes FILE-ATTR according
   ;; to SWITCHES (a list of ls option letters of which c and u are recognized).
   ;; file-attributes's time is in a braindead format
@@ -240,12 +221,7 @@ SWITCHES default to dired-listing-switches."
   ;; date "Jan 00 00:00 ".
   (condition-case error-data
       (let* ((time (current-time-string
-                   (nth (cond
-                         ((memq ?c switches) 6) ; last mode change
-                         ((memq ?u switches) 4) ; last access
-                         ;; default is last modtime
-                         (t 5))
-                        file-attr)))
+                   (nth (ls-lisp-time-index switches) file-attr)))
             (date (substring time 4 11)) ; "Apr 30 "
             (clock (substring time 11 16)) ; "11:27"
             (year (substring time 19 24)) ; " 1992"
@@ -260,6 +236,6 @@ SWITCHES default to dired-listing-switches."
     (error
      "Jan 00 00:00")))
 
-(provide 'dired-lisp)
+(provide 'ls-lisp)
 
-; eof
+;;; ls-lisp.el ends here