lisp/options.el

   1 ;;; options.el --- edit Options command for Emacs.
   2
   3 ;; Copyright (C) 1985 Free Software Foundation, Inc.
   4
   5 ;; Maintainer: FSF
   6
   7 ;; This file is part of GNU Emacs.
   8
   9 ;; GNU Emacs is free software; you can redistribute it and/or modify
  10 ;; it under the terms of the GNU General Public License as published by
  11 ;; the Free Software Foundation; either version 2, or (at your option)
  12 ;; any later version.
  13
  14 ;; GNU Emacs is distributed in the hope that it will be useful,
  15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 ;; GNU General Public License for more details.
  18
  19 ;; You should have received a copy of the GNU General Public License
  20 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
  21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  22 ;; Boston, MA 02111-1307, USA.
  23
  24 ;;; Commentary:
  25
  26 ;; This code provides functions to list and edit the values of all global
  27 ;; option variables known to loaded Emacs Lisp code.  There are two entry
  28 ;; points, `list-options' and `edit' options'.  The latter enters a major
  29 ;; mode specifically for editing option values.  Do `M-x describe-mode' in
  30 ;; that context for more details.
  31
  32 ;;; Code:
  33
  34 ;;;###autoload
  35 (defun list-options ()
  36   "Display a list of Emacs user options, with values and documentation."
  37   (interactive)
  38   (save-excursion
  39     (set-buffer (get-buffer-create "*List Options*"))
  40     (Edit-options-mode))
  41   (with-output-to-temp-buffer "*List Options*"
  42     (let (vars)
  43       (mapatoms (function (lambda (sym)
  44                             (if (user-variable-p sym)
  45                                 (setq vars (cons sym vars))))))
  46       (setq vars (sort vars 'string-lessp))
  47       (while vars
  48         (let ((sym (car vars)))
  49           (princ ";; ")
  50           (prin1 sym)
  51           (princ ":\n\t")
  52           (prin1 (symbol-value sym))
  53           (terpri)
  54           (princ (substitute-command-keys
  55                   (documentation-property sym 'variable-documentation)))
  56           (princ "\n;;\n"))
  57         (setq vars (cdr vars)))))
  58   (save-excursion
  59     (set-buffer "*List Options*")
  60     (setq buffer-read-only t)))
  61
  62 ;;;###autoload
  63 (defun edit-options ()
  64   "Edit a list of Emacs user option values.
  65 Selects a buffer containing such a list,
  66 in which there are commands to set the option values.
  67 Type \\[describe-mode] in that buffer for a list of commands."
  68   (interactive)
  69   (list-options)
  70   (pop-to-buffer "*List Options*"))
  71
  72 (defvar Edit-options-mode-map
  73   (let ((map (make-keymap)))
  74     (define-key map "s" 'Edit-options-set)
  75     (define-key map "x" 'Edit-options-toggle)
  76     (define-key map "1" 'Edit-options-t)
  77     (define-key map "0" 'Edit-options-nil)
  78     (define-key map "p" 'backward-paragraph)
  79     (define-key map " " 'forward-paragraph)
  80     (define-key map "n" 'forward-paragraph)
  81     map)
  82   "")
  83
  84 ;; Edit Options mode is suitable only for specially formatted data.
  85 (put 'Edit-options-mode 'mode-class 'special)
  86
  87 (defun Edit-options-mode ()
  88   "\\<Edit-options-mode-map>\
  89 Major mode for editing Emacs user option settings.
  90 Special commands are:
  91 \\[Edit-options-set] -- set variable point points at.  New value read using minibuffer.
  92 \\[Edit-options-toggle] -- toggle variable, t -> nil, nil -> t.
  93 \\[Edit-options-t] -- set variable to t.
  94 \\[Edit-options-nil] -- set variable to nil.
  95 Changed values made by these commands take effect immediately.
  96
  97 Each variable description is a paragraph.
  98 For convenience, the characters \\[backward-paragraph] and \\[forward-paragraph] move back and forward by paragraphs."
  99   (kill-all-local-variables)
 100   (set-syntax-table emacs-lisp-mode-syntax-table)
 101   (use-local-map Edit-options-mode-map)
 102   (make-local-variable 'paragraph-separate)
 103   (setq paragraph-separate "[^\^@-\^?]")
 104   (make-local-variable 'paragraph-start)
 105   (setq paragraph-start "\t")
 106   (setq truncate-lines t)
 107   (setq major-mode 'Edit-options-mode)
 108   (setq mode-name "Options")
 109   (run-hooks 'Edit-options-mode-hook))
 110
 111 (defun Edit-options-set () (interactive)
 112   (Edit-options-modify
 113    '(lambda (var) (eval-minibuffer (concat "New " (symbol-name var) ": ")))))
 114
 115 (defun Edit-options-toggle () (interactive)
 116   (Edit-options-modify '(lambda (var) (not (symbol-value var)))))
 117
 118 (defun Edit-options-t () (interactive)
 119   (Edit-options-modify '(lambda (var) t)))
 120
 121 (defun Edit-options-nil () (interactive)
 122   (Edit-options-modify '(lambda (var) nil)))
 123
 124 (defun Edit-options-modify (modfun)
 125   (save-excursion
 126    (let ((buffer-read-only nil) var pos)
 127      (re-search-backward "^;; \\|\\`")
 128      (forward-char 3)
 129      (setq pos (point))
 130      (save-restriction
 131        (narrow-to-region pos (progn (end-of-line) (1- (point))))
 132        (goto-char pos)
 133        (setq var (read (current-buffer))))
 134      (goto-char pos)
 135      (forward-line 1)
 136      (forward-char 1)
 137      (save-excursion
 138        (set var (funcall modfun var)))
 139      (kill-sexp 1)
 140      (prin1 (symbol-value var) (current-buffer)))))
 141
 142 ;;; options.el ends here