(facemenu-unlisted-faces): Improve doc strings

[bpt/emacs.git] / lisp / cus-dep.el

diff --git a/lisp/cus-dep.el b/lisp/cus-dep.el
index ee18ee5..4cb856c 100644 (file)
--- a/lisp/cus-dep.el
+++ b/lisp/cus-dep.el
@@ -1,4 +1,4 @@
-;;; cus-dep.el --- Find customization dependencies.
+;;; cus-dep.el --- find customization dependencies
 ;;
 ;; Copyright (C) 1997 Free Software Foundation, Inc.
 ;;
@@ -22,11 +22,14 @@
 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 ;; Boston, MA 02111-1307, USA.
 
+;;; Commentary:
+
 ;;; Code:
 
-(require 'cl)
+(eval-when-compile (require 'cl))
 (require 'widget)
 (require 'cus-face)
+(require 'autoload)
 
 (defun custom-make-dependencies ()
   "Batch function to extract custom dependencies from .el files.
@@ -40,13 +43,13 @@ Usage: emacs -batch -l ./cus-dep.el -f custom-make-dependencies DIRS"
       (message "Directory %s" (car all-subdirs))
       (let ((files (directory-files (car all-subdirs) nil "\\`[^=].*\\.el\\'"))
            (default-directory default-directory)
-           file)
+           file
+           is-autoloaded)
        (cd (car all-subdirs))
        (while files
          (setq file (car files)
                files (cdr files))
          (when (file-exists-p file)
-           (message "Checking %s..." file)
            (erase-buffer)
            (insert-file-contents file)
            (goto-char (point-min))
@@ -55,10 +58,19 @@ Usage: emacs -batch -l ./cus-dep.el -f custom-make-dependencies DIRS"
              (condition-case nil
                  (while (re-search-forward "^(defcustom\\|^(defface\\|^(defgroup"
                                            nil t)
+                   (setq is-autoloaded nil)
                    (beginning-of-line)
+                   (save-excursion
+                     (forward-line -1)
+                     (if (looking-at generate-autoload-cookie)
+                         (setq is-autoloaded t)))
                    (let ((expr (read (current-buffer))))
-                     (eval expr)
-                     (put (nth 1 expr) 'custom-where name)))
+                     (condition-case nil
+                         (progn
+                           (eval expr)
+                           (put (nth 1 expr) 'custom-autoloaded is-autoloaded)
+                           (put (nth 1 expr) 'custom-where name))
+                       (error nil))))
                (error nil)))))
        (setq all-subdirs (cdr all-subdirs)))))
   (message "Generating cus-load.el...")
@@ -89,13 +101,79 @@ Usage: emacs -batch -l ./cus-dep.el -f custom-make-dependencies DIRS"
                  (when found
                    (insert "))\n"))))))
   (insert "\
+;;; These are for handling :version.  We need to have a minimum of
+;;; information so `custom-changed-variables' could do its job.  
+;;; For both groups and variables we have to set `custom-version'.
+;;; For variables we also set the `standard-value' and for groups
+;;; `group-documentation' (which is shown in the customize buffer), so
+;;; we don't have to load the file containing the group.
+
+;;; `custom-versions-load-alist' is an alist that has as car a version
+;;; number and as elts the files that have variables that contain that
+;;; version. These files should be loaded before showing the
+;;; customization buffer that `customize-changed-options' generates.
+
+
+;;; This macro is used so we don't modify the information about
+;;; variables and groups if it's already set. (We don't know when
+;;; cus-load.el is going to be loaded and at that time some of the
+;;; files might be loaded and some others might not).
+\(defmacro custom-put-if-not (symbol propname value)
+  `(unless (get ,symbol ,propname)
+     (put ,symbol ,propname ,value)))
+
+")
+  (let ((version-alist nil))
+    (mapatoms (lambda (symbol)
+               (let ((version (get symbol 'custom-version))
+                     where)
+                 (when version 
+                   (setq where (get symbol 'custom-where))
+                   (when (and where 
+                              ;; Don't bother to do anything if it's
+                              ;; autoloaded because we will have all
+                              ;; this info when emacs is running
+                              ;; anyway.
+                              (not (get symbol 'custom-autoloaded)))
+                     (insert "(custom-put-if-not '" (symbol-name symbol) 
+                             " 'custom-version ")
+                     (prin1 version (current-buffer))
+                     (insert ")\n")
+                     (insert "(custom-put-if-not '" (symbol-name symbol))
+                     (if (get symbol 'standard-value)
+                         ;; This means it's a variable
+                         (progn
+                           (insert " 'standard-value t)\n")
+                           (if (assoc version version-alist)
+                               (unless 
+                                   (member where 
+                                           (cdr (assoc version version-alist)))
+                                 (push where (cdr (assoc version version-alist))))
+                             (push (cons version (list where)) version-alist)))
+                       ;; This is a group
+                       (insert " 'group-documentation ")
+                       (prin1 (get symbol 'group-documentation) (current-buffer))
+                       (insert ")\n")))))))
+
+    (insert "\n(defvar custom-versions-load-alist "
+           (if version-alist "'" ""))
+    (prin1 version-alist (current-buffer))
+    (insert "\n \"For internal use by custom.\")\n"))
+    
+  (insert "\
 
 \(provide 'cus-load)
 
+;;; Local Variables:
+;;; version-control: never
+;;; no-byte-compile: t
+;;; no-update-autoloads: t
+;;; End:
 ;;; cus-load.el ends here\n")
   (let ((kept-new-versions 10000000))
     (save-buffer))
   (message "Generating cus-load.el...done")
   (kill-emacs))
 
+\f
 ;;; cus-dep.el ends here