(sgml-tag-alist): Doc fix.

[gnu-emacs] / lisp / options.el

diff --git a/lisp/options.el b/lisp/options.el
index ca78256b562c0b8aa691ab54ae209644a2ad7074..b7684034695fca794c44a0ef072d5bf1204d04e2 100644 (file)
--- a/lisp/options.el
+++ b/lisp/options.el
@@ -1,4 +1,4 @@
-;;; options.el --- edit Options command for Emacs.
+;;; options.el --- edit Options command for Emacs
 
 ;; Copyright (C) 1985 Free Software Foundation, Inc.
 
@@ -17,8 +17,9 @@
 ;; GNU General Public License for more details.
 
 ;; You should have received a copy of the GNU General Public License
-;; along with GNU Emacs; see the file COPYING.  If not, write to
-;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
+;; along with GNU Emacs; see the file COPYING.  If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
 
 ;;; Commentary:
 
@@ -28,15 +29,15 @@
 ;; mode specifically for editing option values.  Do `M-x describe-mode' in
 ;; that context for more details.
 
+;; The customization buffer feature is intended to make this obsolete.
+
 ;;; Code:
 
 ;;;###autoload
 (defun list-options ()
-  "Display a list of Emacs user options, with values and documentation."
+  "Display a list of Emacs user options, with values and documentation.
+It is now better to use Customize instead."
   (interactive)
-  (save-excursion
-    (set-buffer (get-buffer-create "*List Options*"))
-    (Edit-options-mode))
   (with-output-to-temp-buffer "*List Options*"
     (let (vars)
       (mapatoms (function (lambda (sym)
@@ -45,22 +46,28 @@
       (setq vars (sort vars 'string-lessp))
       (while vars
        (let ((sym (car vars)))
-         (princ ";; ")
-         (prin1 sym)
-         (princ ":\n\t")
-         (prin1 (symbol-value sym))
-         (terpri)
-         (princ (substitute-command-keys 
-                 (documentation-property sym 'variable-documentation)))
-         (princ "\n;;\n"))
-       (setq vars (cdr vars))))))
+         (when (boundp sym)
+           (princ ";; ")
+           (prin1 sym)
+           (princ ":\n\t")
+           (prin1 (symbol-value sym))
+           (terpri)
+           (princ (substitute-command-keys 
+                   (documentation-property sym 'variable-documentation)))
+           (princ "\n;;\n"))
+         (setq vars (cdr vars))))
+      (with-current-buffer "*List Options*"
+       (Edit-options-mode)
+       (setq buffer-read-only t)))))
 
 ;;;###autoload
 (defun edit-options ()
   "Edit a list of Emacs user option values.
 Selects a buffer containing such a list,
 in which there are commands to set the option values.
-Type \\[describe-mode] in that buffer for a list of commands."
+Type \\[describe-mode] in that buffer for a list of commands.
+
+The Custom feature is intended to make this obsolete."
   (interactive)
   (list-options)
   (pop-to-buffer "*List Options*"))
@@ -98,7 +105,7 @@ For convenience, the characters \\[backward-paragraph] and \\[forward-paragraph]
   (make-local-variable 'paragraph-separate)
   (setq paragraph-separate "[^\^@-\^?]")
   (make-local-variable 'paragraph-start)
-  (setq paragraph-start "^\t")
+  (setq paragraph-start "\t")
   (setq truncate-lines t)
   (setq major-mode 'Edit-options-mode)
   (setq mode-name "Options")
@@ -106,20 +113,20 @@ For convenience, the characters \\[backward-paragraph] and \\[forward-paragraph]
 
 (defun Edit-options-set () (interactive)
   (Edit-options-modify
-   '(lambda (var) (eval-minibuffer (concat "New " (symbol-name var) ": ")))))
+   (lambda (var) (eval-minibuffer (concat "New " (symbol-name var) ": ")))))
 
 (defun Edit-options-toggle () (interactive)
-  (Edit-options-modify '(lambda (var) (not (symbol-value var)))))
+  (Edit-options-modify (lambda (var) (not (symbol-value var)))))
 
 (defun Edit-options-t () (interactive)
-  (Edit-options-modify '(lambda (var) t)))
+  (Edit-options-modify (lambda (var) t)))
 
 (defun Edit-options-nil () (interactive)
-  (Edit-options-modify '(lambda (var) nil)))
+  (Edit-options-modify (lambda (var) nil)))
 
 (defun Edit-options-modify (modfun)
   (save-excursion
-   (let (var pos)
+   (let ((buffer-read-only nil) var pos)
      (re-search-backward "^;; \\|\\`")
      (forward-char 3)
      (setq pos (point))
@@ -135,4 +142,6 @@ For convenience, the characters \\[backward-paragraph] and \\[forward-paragraph]
      (kill-sexp 1)
      (prin1 (symbol-value var) (current-buffer)))))
 
+(provide 'options)
+
 ;;; options.el ends here