Mercurial > emacs
comparison lisp/cus-edit.el @ 17334:1effe507ea85
Initial revision
| author | Per Abrahamsen <abraham@dina.kvl.dk> |
|---|---|
| date | Mon, 07 Apr 1997 13:42:59 +0000 |
| parents | |
| children | 30a567b89fb6 |
comparison
equal
deleted
inserted
replaced
| 17333:0cc83e8612f0 | 17334:1effe507ea85 |
|---|---|
| 1 ;;; cus-edit.el --- Tools for customization Emacs. | |
| 2 ;; | |
| 3 ;; Copyright (C) 1996, 1997 Free Software Foundation, Inc. | |
| 4 ;; | |
| 5 ;; Author: Per Abrahamsen <abraham@dina.kvl.dk> | |
| 6 ;; Keywords: help, faces | |
| 7 ;; Version: 1.71 | |
| 8 ;; X-URL: http://www.dina.kvl.dk/~abraham/custom/ | |
| 9 | |
| 10 ;;; Commentary: | |
| 11 ;; | |
| 12 ;; See `custom.el'. | |
| 13 | |
| 14 ;;; Code: | |
| 15 | |
| 16 (require 'cus-face) | |
| 17 (require 'wid-edit) | |
| 18 (require 'easymenu) | |
| 19 | |
| 20 (define-widget-keywords :custom-prefixes :custom-menu :custom-show | |
| 21 :custom-magic :custom-state :custom-level :custom-form | |
| 22 :custom-set :custom-save :custom-reset-current :custom-reset-saved | |
| 23 :custom-reset-factory) | |
| 24 | |
| 25 ;;; Customization Groups. | |
| 26 | |
| 27 (defgroup emacs nil | |
| 28 "Customization of the One True Editor." | |
| 29 :link '(custom-manual "(emacs)Top")) | |
| 30 | |
| 31 ;; Most of these groups are stolen from `finder.el', | |
| 32 (defgroup editing nil | |
| 33 "Basic text editing facilities." | |
| 34 :group 'emacs) | |
| 35 | |
| 36 (defgroup abbrev nil | |
| 37 "Abbreviation handling, typing shortcuts, macros." | |
| 38 :tag "Abbreviations" | |
| 39 :group 'editing) | |
| 40 | |
| 41 (defgroup matching nil | |
| 42 "Various sorts of searching and matching." | |
| 43 :group 'editing) | |
| 44 | |
| 45 (defgroup emulations nil | |
| 46 "Emulations of other editors." | |
| 47 :group 'editing) | |
| 48 | |
| 49 (defgroup mouse nil | |
| 50 "Mouse support." | |
| 51 :group 'editing) | |
| 52 | |
| 53 (defgroup outlines nil | |
| 54 "Support for hierarchical outlining." | |
| 55 :group 'editing) | |
| 56 | |
| 57 (defgroup external nil | |
| 58 "Interfacing to external utilities." | |
| 59 :group 'emacs) | |
| 60 | |
| 61 (defgroup bib nil | |
| 62 "Code related to the `bib' bibliography processor." | |
| 63 :tag "Bibliography" | |
| 64 :group 'external) | |
| 65 | |
| 66 (defgroup processes nil | |
| 67 "Process, subshell, compilation, and job control support." | |
| 68 :group 'external | |
| 69 :group 'development) | |
| 70 | |
| 71 (defgroup programming nil | |
| 72 "Support for programming in other languages." | |
| 73 :group 'emacs) | |
| 74 | |
| 75 (defgroup languages nil | |
| 76 "Specialized modes for editing programming languages." | |
| 77 :group 'programming) | |
| 78 | |
| 79 (defgroup lisp nil | |
| 80 "Lisp support, including Emacs Lisp." | |
| 81 :group 'languages | |
| 82 :group 'development) | |
| 83 | |
| 84 (defgroup c nil | |
| 85 "Support for the C language and related languages." | |
| 86 :group 'languages) | |
| 87 | |
| 88 (defgroup tools nil | |
| 89 "Programming tools." | |
| 90 :group 'programming) | |
| 91 | |
| 92 (defgroup oop nil | |
| 93 "Support for object-oriented programming." | |
| 94 :group 'programming) | |
| 95 | |
| 96 (defgroup applications nil | |
| 97 "Applications written in Emacs." | |
| 98 :group 'emacs) | |
| 99 | |
| 100 (defgroup calendar nil | |
| 101 "Calendar and time management support." | |
| 102 :group 'applications) | |
| 103 | |
| 104 (defgroup mail nil | |
| 105 "Modes for electronic-mail handling." | |
| 106 :group 'applications) | |
| 107 | |
| 108 (defgroup news nil | |
| 109 "Support for netnews reading and posting." | |
| 110 :group 'applications) | |
| 111 | |
| 112 (defgroup games nil | |
| 113 "Games, jokes and amusements." | |
| 114 :group 'applications) | |
| 115 | |
| 116 (defgroup development nil | |
| 117 "Support for further development of Emacs." | |
| 118 :group 'emacs) | |
| 119 | |
| 120 (defgroup docs nil | |
| 121 "Support for Emacs documentation." | |
| 122 :group 'development) | |
| 123 | |
| 124 (defgroup extensions nil | |
| 125 "Emacs Lisp language extensions." | |
| 126 :group 'development) | |
| 127 | |
| 128 (defgroup internal nil | |
| 129 "Code for Emacs internals, build process, defaults." | |
| 130 :group 'development) | |
| 131 | |
| 132 (defgroup maint nil | |
| 133 "Maintenance aids for the Emacs development group." | |
| 134 :tag "Maintenance" | |
| 135 :group 'development) | |
| 136 | |
| 137 (defgroup environment nil | |
| 138 "Fitting Emacs with its environment." | |
| 139 :group 'emacs) | |
| 140 | |
| 141 (defgroup comm nil | |
| 142 "Communications, networking, remote access to files." | |
| 143 :tag "Communication" | |
| 144 :group 'environment) | |
| 145 | |
| 146 (defgroup hardware nil | |
| 147 "Support for interfacing with exotic hardware." | |
| 148 :group 'environment) | |
| 149 | |
| 150 (defgroup terminals nil | |
| 151 "Support for terminal types." | |
| 152 :group 'environment) | |
| 153 | |
| 154 (defgroup unix nil | |
| 155 "Front-ends/assistants for, or emulators of, UNIX features." | |
| 156 :group 'environment) | |
| 157 | |
| 158 (defgroup vms nil | |
| 159 "Support code for vms." | |
| 160 :group 'environment) | |
| 161 | |
| 162 (defgroup i18n nil | |
| 163 "Internationalization and alternate character-set support." | |
| 164 :group 'environment | |
| 165 :group 'editing) | |
| 166 | |
| 167 (defgroup frames nil | |
| 168 "Support for Emacs frames and window systems." | |
| 169 :group 'environment) | |
| 170 | |
| 171 (defgroup data nil | |
| 172 "Support editing files of data." | |
| 173 :group 'emacs) | |
| 174 | |
| 175 (defgroup wp nil | |
| 176 "Word processing." | |
| 177 :group 'emacs) | |
| 178 | |
| 179 (defgroup tex nil | |
| 180 "Code related to the TeX formatter." | |
| 181 :group 'wp) | |
| 182 | |
| 183 (defgroup faces nil | |
| 184 "Support for multiple fonts." | |
| 185 :group 'emacs) | |
| 186 | |
| 187 (defgroup hypermedia nil | |
| 188 "Support for links between text or other media types." | |
| 189 :group 'emacs) | |
| 190 | |
| 191 (defgroup help nil | |
| 192 "Support for on-line help systems." | |
| 193 :group 'emacs) | |
| 194 | |
| 195 (defgroup local nil | |
| 196 "Code local to your site." | |
| 197 :group 'emacs) | |
| 198 | |
| 199 (defgroup customize '((widgets custom-group)) | |
| 200 "Customization of the Customization support." | |
| 201 :link '(custom-manual "(custom)Top") | |
| 202 :link '(url-link :tag "Development Page" | |
| 203 "http://www.dina.kvl.dk/~abraham/custom/") | |
| 204 :prefix "custom-" | |
| 205 :group 'help | |
| 206 :group 'faces) | |
| 207 | |
| 208 ;;; Utilities. | |
| 209 | |
| 210 (defun custom-quote (sexp) | |
| 211 "Quote SEXP iff it is not self quoting." | |
| 212 (if (or (memq sexp '(t nil)) | |
| 213 (and (symbolp sexp) | |
| 214 (eq (aref (symbol-name sexp) 0) ?:)) | |
| 215 (and (listp sexp) | |
| 216 (memq (car sexp) '(lambda))) | |
| 217 (stringp sexp) | |
| 218 (numberp sexp) | |
| 219 (and (fboundp 'characterp) | |
| 220 (characterp sexp))) | |
| 221 sexp | |
| 222 (list 'quote sexp))) | |
| 223 | |
| 224 (defun custom-split-regexp-maybe (regexp) | |
| 225 "If REGEXP is a string, split it to a list at `\\|'. | |
| 226 You can get the original back with from the result with: | |
| 227 (mapconcat 'identity result \"\\|\") | |
| 228 | |
| 229 IF REGEXP is not a string, return it unchanged." | |
| 230 (if (stringp regexp) | |
| 231 (let ((start 0) | |
| 232 all) | |
| 233 (while (string-match "\\\\|" regexp start) | |
| 234 (setq all (cons (substring regexp start (match-beginning 0)) all) | |
| 235 start (match-end 0))) | |
| 236 (nreverse (cons (substring regexp start) all))) | |
| 237 regexp)) | |
| 238 | |
| 239 (defvar custom-prefix-list nil | |
| 240 "List of prefixes that should be ignored by `custom-unlispify'") | |
| 241 | |
| 242 (defcustom custom-unlispify-menu-entries t | |
| 243 "Display menu entries as words instead of symbols if non nil." | |
| 244 :group 'customize | |
| 245 :type 'boolean) | |
| 246 | |
| 247 (defun custom-unlispify-menu-entry (symbol &optional no-suffix) | |
| 248 "Convert symbol into a menu entry." | |
| 249 (cond ((not custom-unlispify-menu-entries) | |
| 250 (symbol-name symbol)) | |
| 251 ((get symbol 'custom-tag) | |
| 252 (if no-suffix | |
| 253 (get symbol 'custom-tag) | |
| 254 (concat (get symbol 'custom-tag) "..."))) | |
| 255 (t | |
| 256 (save-excursion | |
| 257 (set-buffer (get-buffer-create " *Custom-Work*")) | |
| 258 (erase-buffer) | |
| 259 (princ symbol (current-buffer)) | |
| 260 (goto-char (point-min)) | |
| 261 (let ((prefixes custom-prefix-list) | |
| 262 prefix) | |
| 263 (while prefixes | |
| 264 (setq prefix (car prefixes)) | |
| 265 (if (search-forward prefix (+ (point) (length prefix)) t) | |
| 266 (progn | |
| 267 (setq prefixes nil) | |
| 268 (delete-region (point-min) (point))) | |
| 269 (setq prefixes (cdr prefixes))))) | |
| 270 (subst-char-in-region (point-min) (point-max) ?- ?\ t) | |
| 271 (capitalize-region (point-min) (point-max)) | |
| 272 (unless no-suffix | |
| 273 (goto-char (point-max)) | |
| 274 (insert "...")) | |
| 275 (buffer-string))))) | |
| 276 | |
| 277 (defcustom custom-unlispify-tag-names t | |
| 278 "Display tag names as words instead of symbols if non nil." | |
| 279 :group 'customize | |
| 280 :type 'boolean) | |
| 281 | |
| 282 (defun custom-unlispify-tag-name (symbol) | |
| 283 "Convert symbol into a menu entry." | |
| 284 (let ((custom-unlispify-menu-entries custom-unlispify-tag-names)) | |
| 285 (custom-unlispify-menu-entry symbol t))) | |
| 286 | |
| 287 (defun custom-prefix-add (symbol prefixes) | |
| 288 ;; Addd SYMBOL to list of ignored PREFIXES. | |
| 289 (cons (or (get symbol 'custom-prefix) | |
| 290 (concat (symbol-name symbol) "-")) | |
| 291 prefixes)) | |
| 292 | |
| 293 ;;; The Custom Mode. | |
| 294 | |
| 295 (defvar custom-options nil | |
| 296 "Customization widgets in the current buffer.") | |
| 297 | |
| 298 (defvar custom-mode-map nil | |
| 299 "Keymap for `custom-mode'.") | |
| 300 | |
| 301 (unless custom-mode-map | |
| 302 (setq custom-mode-map (make-sparse-keymap)) | |
| 303 (set-keymap-parent custom-mode-map widget-keymap) | |
| 304 (define-key custom-mode-map "q" 'bury-buffer)) | |
| 305 | |
| 306 (easy-menu-define custom-mode-menu | |
| 307 custom-mode-map | |
| 308 "Menu used in customization buffers." | |
| 309 '("Custom" | |
| 310 ["Set" custom-set t] | |
| 311 ["Save" custom-save t] | |
| 312 ["Reset to Current" custom-reset-current t] | |
| 313 ["Reset to Saved" custom-reset-saved t] | |
| 314 ["Reset to Factory Settings" custom-reset-factory t] | |
| 315 ["Info" (Info-goto-node "(custom)The Customization Buffer") t])) | |
| 316 | |
| 317 (defcustom custom-mode-hook nil | |
| 318 "Hook called when entering custom-mode." | |
| 319 :type 'hook | |
| 320 :group 'customize) | |
| 321 | |
| 322 (defun custom-mode () | |
| 323 "Major mode for editing customization buffers. | |
| 324 | |
| 325 The following commands are available: | |
| 326 | |
| 327 \\[widget-forward] Move to next button or editable field. | |
| 328 \\[widget-backward] Move to previous button or editable field. | |
| 329 \\[widget-button-click] Activate button under the mouse pointer. | |
| 330 \\[widget-button-press] Activate button under point. | |
| 331 \\[custom-set] Set all modifications. | |
| 332 \\[custom-save] Make all modifications default. | |
| 333 \\[custom-reset-current] Reset all modified options. | |
| 334 \\[custom-reset-saved] Reset all modified or set options. | |
| 335 \\[custom-reset-factory] Reset all options. | |
| 336 | |
| 337 Entry to this mode calls the value of `custom-mode-hook' | |
| 338 if that value is non-nil." | |
| 339 (kill-all-local-variables) | |
| 340 (setq major-mode 'custom-mode | |
| 341 mode-name "Custom") | |
| 342 (use-local-map custom-mode-map) | |
| 343 (easy-menu-add custom-mode-menu) | |
| 344 (make-local-variable 'custom-options) | |
| 345 (run-hooks 'custom-mode-hook)) | |
| 346 | |
| 347 ;;; Custom Mode Commands. | |
| 348 | |
| 349 (defun custom-set () | |
| 350 "Set changes in all modified options." | |
| 351 (interactive) | |
| 352 (let ((children custom-options)) | |
| 353 (mapcar (lambda (child) | |
| 354 (when (eq (widget-get child :custom-state) 'modified) | |
| 355 (widget-apply child :custom-set))) | |
| 356 children))) | |
| 357 | |
| 358 (defun custom-save () | |
| 359 "Set all modified group members and save them." | |
| 360 (interactive) | |
| 361 (let ((children custom-options)) | |
| 362 (mapcar (lambda (child) | |
| 363 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 364 (widget-apply child :custom-save))) | |
| 365 children)) | |
| 366 (custom-save-all)) | |
| 367 | |
| 368 (defvar custom-reset-menu | |
| 369 '(("Current" . custom-reset-current) | |
| 370 ("Saved" . custom-reset-saved) | |
| 371 ("Factory Settings" . custom-reset-factory)) | |
| 372 "Alist of actions for the `Reset' button. | |
| 373 The key is a string containing the name of the action, the value is a | |
| 374 lisp function taking the widget as an element which will be called | |
| 375 when the action is chosen.") | |
| 376 | |
| 377 (defun custom-reset (event) | |
| 378 "Select item from reset menu." | |
| 379 (let* ((completion-ignore-case t) | |
| 380 (answer (widget-choose "Reset to" | |
| 381 custom-reset-menu | |
| 382 event))) | |
| 383 (if answer | |
| 384 (funcall answer)))) | |
| 385 | |
| 386 (defun custom-reset-current () | |
| 387 "Reset all modified group members to their current value." | |
| 388 (interactive) | |
| 389 (let ((children custom-options)) | |
| 390 (mapcar (lambda (child) | |
| 391 (when (eq (widget-get child :custom-state) 'modified) | |
| 392 (widget-apply child :custom-reset-current))) | |
| 393 children))) | |
| 394 | |
| 395 (defun custom-reset-saved () | |
| 396 "Reset all modified or set group members to their saved value." | |
| 397 (interactive) | |
| 398 (let ((children custom-options)) | |
| 399 (mapcar (lambda (child) | |
| 400 (when (eq (widget-get child :custom-state) 'modified) | |
| 401 (widget-apply child :custom-reset-current))) | |
| 402 children))) | |
| 403 | |
| 404 (defun custom-reset-factory () | |
| 405 "Reset all modified, set, or saved group members to their factory settings." | |
| 406 (interactive) | |
| 407 (let ((children custom-options)) | |
| 408 (mapcar (lambda (child) | |
| 409 (when (eq (widget-get child :custom-state) 'modified) | |
| 410 (widget-apply child :custom-reset-current))) | |
| 411 children))) | |
| 412 | |
| 413 ;;; The Customize Commands | |
| 414 | |
| 415 ;;;###autoload | |
| 416 (defun customize (symbol) | |
| 417 "Customize SYMBOL, which must be a customization group." | |
| 418 (interactive (list (completing-read "Customize group: (default emacs) " | |
| 419 obarray | |
| 420 (lambda (symbol) | |
| 421 (get symbol 'custom-group)) | |
| 422 t))) | |
| 423 | |
| 424 (when (stringp symbol) | |
| 425 (if (string-equal "" symbol) | |
| 426 (setq symbol 'emacs) | |
| 427 (setq symbol (intern symbol)))) | |
| 428 (custom-buffer-create (list (list symbol 'custom-group)))) | |
| 429 | |
| 430 ;;;###autoload | |
| 431 (defun customize-variable (symbol) | |
| 432 "Customize SYMBOL, which must be a variable." | |
| 433 (interactive | |
| 434 ;; Code stolen from `help.el'. | |
| 435 (let ((v (variable-at-point)) | |
| 436 (enable-recursive-minibuffers t) | |
| 437 val) | |
| 438 (setq val (completing-read | |
| 439 (if v | |
| 440 (format "Customize variable (default %s): " v) | |
| 441 "Customize variable: ") | |
| 442 obarray 'boundp t)) | |
| 443 (list (if (equal val "") | |
| 444 v (intern val))))) | |
| 445 (custom-buffer-create (list (list symbol 'custom-variable)))) | |
| 446 | |
| 447 ;;;###autoload | |
| 448 (defun customize-face (&optional symbol) | |
| 449 "Customize SYMBOL, which should be a face name or nil. | |
| 450 If SYMBOL is nil, customize all faces." | |
| 451 (interactive (list (completing-read "Customize face: (default all) " | |
| 452 obarray 'custom-facep))) | |
| 453 (if (or (null symbol) (and (stringp symbol) (zerop (length symbol)))) | |
| 454 (let ((found nil)) | |
| 455 (message "Looking for faces...") | |
| 456 (mapcar (lambda (symbol) | |
| 457 (setq found (cons (list symbol 'custom-face) found))) | |
| 458 (face-list)) | |
| 459 (custom-buffer-create found)) | |
| 460 (if (stringp symbol) | |
| 461 (setq symbol (intern symbol))) | |
| 462 (unless (symbolp symbol) | |
| 463 (error "Should be a symbol %S" symbol)) | |
| 464 (custom-buffer-create (list (list symbol 'custom-face))))) | |
| 465 | |
| 466 ;;;###autoload | |
| 467 (defun customize-customized () | |
| 468 "Customize all already customized user options." | |
| 469 (interactive) | |
| 470 (let ((found nil)) | |
| 471 (mapatoms (lambda (symbol) | |
| 472 (and (get symbol 'saved-face) | |
| 473 (custom-facep symbol) | |
| 474 (setq found (cons (list symbol 'custom-face) found))) | |
| 475 (and (get symbol 'saved-value) | |
| 476 (boundp symbol) | |
| 477 (setq found | |
| 478 (cons (list symbol 'custom-variable) found))))) | |
| 479 (if found | |
| 480 (custom-buffer-create found) | |
| 481 (error "No customized user options")))) | |
| 482 | |
| 483 ;;;###autoload | |
| 484 (defun customize-apropos (regexp &optional all) | |
| 485 "Customize all user options matching REGEXP. | |
| 486 If ALL (e.g., started with a prefix key), include options which are not | |
| 487 user-settable." | |
| 488 (interactive "sCustomize regexp: \nP") | |
| 489 (let ((found nil)) | |
| 490 (mapatoms (lambda (symbol) | |
| 491 (when (string-match regexp (symbol-name symbol)) | |
| 492 (when (get symbol 'custom-group) | |
| 493 (setq found (cons (list symbol 'custom-group) found))) | |
| 494 (when (custom-facep symbol) | |
| 495 (setq found (cons (list symbol 'custom-face) found))) | |
| 496 (when (and (boundp symbol) | |
| 497 (or (get symbol 'saved-value) | |
| 498 (get symbol 'factory-value) | |
| 499 (if all | |
| 500 (get symbol 'variable-documentation) | |
| 501 (user-variable-p symbol)))) | |
| 502 (setq found | |
| 503 (cons (list symbol 'custom-variable) found)))))) | |
| 504 (if found | |
| 505 (custom-buffer-create found) | |
| 506 (error "No matches")))) | |
| 507 | |
| 508 ;;;###autoload | |
| 509 (defun custom-buffer-create (options) | |
| 510 "Create a buffer containing OPTIONS. | |
| 511 OPTIONS should be an alist of the form ((SYMBOL WIDGET)...), where | |
| 512 SYMBOL is a customization option, and WIDGET is a widget for editing | |
| 513 that option." | |
| 514 (message "Creating customization buffer...") | |
| 515 (kill-buffer (get-buffer-create "*Customization*")) | |
| 516 (switch-to-buffer (get-buffer-create "*Customization*")) | |
| 517 (custom-mode) | |
| 518 (widget-insert "This is a customization buffer. | |
| 519 Push RET or click mouse-2 on the word ") | |
| 520 ;; (put-text-property 1 2 'start-open nil) | |
| 521 (widget-create 'info-link | |
| 522 :tag "help" | |
| 523 :help-echo "Read the online help." | |
| 524 "(custom)The Customization Buffer") | |
| 525 (widget-insert " for more information.\n\n") | |
| 526 (setq custom-options | |
| 527 (if (= (length options) 1) | |
| 528 (mapcar (lambda (entry) | |
| 529 (widget-create (nth 1 entry) | |
| 530 :custom-state 'unknown | |
| 531 :tag (custom-unlispify-tag-name | |
| 532 (nth 0 entry)) | |
| 533 :value (nth 0 entry))) | |
| 534 options) | |
| 535 (let ((count 0) | |
| 536 (length (length options))) | |
| 537 (mapcar (lambda (entry) | |
| 538 (prog2 | |
| 539 (message "Creating customization items %2d%%..." | |
| 540 (/ (* 100.0 count) length)) | |
| 541 (widget-create (nth 1 entry) | |
| 542 :tag (custom-unlispify-tag-name | |
| 543 (nth 0 entry)) | |
| 544 :value (nth 0 entry)) | |
| 545 (setq count (1+ count)) | |
| 546 (unless (eq (preceding-char) ?\n) | |
| 547 (widget-insert "\n")) | |
| 548 (widget-insert "\n"))) | |
| 549 options)))) | |
| 550 (unless (eq (preceding-char) ?\n) | |
| 551 (widget-insert "\n")) | |
| 552 (widget-insert "\n") | |
| 553 (message "Creating customization magic...") | |
| 554 (mapcar 'custom-magic-reset custom-options) | |
| 555 (message "Creating customization buttons...") | |
| 556 (widget-create 'push-button | |
| 557 :tag "Set" | |
| 558 :help-echo "Set all modifications for this session." | |
| 559 :action (lambda (widget &optional event) | |
| 560 (custom-set))) | |
| 561 (widget-insert " ") | |
| 562 (widget-create 'push-button | |
| 563 :tag "Save" | |
| 564 :help-echo "\ | |
| 565 Make the modifications default for future sessions." | |
| 566 :action (lambda (widget &optional event) | |
| 567 (custom-save))) | |
| 568 (widget-insert " ") | |
| 569 (widget-create 'push-button | |
| 570 :tag "Reset" | |
| 571 :help-echo "Undo all modifications." | |
| 572 :action (lambda (widget &optional event) | |
| 573 (custom-reset event))) | |
| 574 (widget-insert " ") | |
| 575 (widget-create 'push-button | |
| 576 :tag "Done" | |
| 577 :help-echo "Bury the buffer." | |
| 578 :action (lambda (widget &optional event) | |
| 579 (bury-buffer) | |
| 580 ;; Steal button release event. | |
| 581 (if (and (fboundp 'button-press-event-p) | |
| 582 (fboundp 'next-command-event)) | |
| 583 ;; XEmacs | |
| 584 (and event | |
| 585 (button-press-event-p event) | |
| 586 (next-command-event)) | |
| 587 ;; Emacs | |
| 588 (when (memq 'down (event-modifiers event)) | |
| 589 (read-event))))) | |
| 590 (widget-insert "\n") | |
| 591 (message "Creating customization setup...") | |
| 592 (widget-setup) | |
| 593 (goto-char (point-min)) | |
| 594 (message "Creating customization buffer...done")) | |
| 595 | |
| 596 ;;; Modification of Basic Widgets. | |
| 597 ;; | |
| 598 ;; We add extra properties to the basic widgets needed here. This is | |
| 599 ;; fine, as long as we are careful to stay within out own namespace. | |
| 600 ;; | |
| 601 ;; We want simple widgets to be displayed by default, but complex | |
| 602 ;; widgets to be hidden. | |
| 603 | |
| 604 (widget-put (get 'item 'widget-type) :custom-show t) | |
| 605 (widget-put (get 'editable-field 'widget-type) | |
| 606 :custom-show (lambda (widget value) | |
| 607 (let ((pp (pp-to-string value))) | |
| 608 (cond ((string-match "\n" pp) | |
| 609 nil) | |
| 610 ((> (length pp) 40) | |
| 611 nil) | |
| 612 (t t))))) | |
| 613 (widget-put (get 'menu-choice 'widget-type) :custom-show t) | |
| 614 | |
| 615 ;;; The `custom-manual' Widget. | |
| 616 | |
| 617 (define-widget 'custom-manual 'info-link | |
| 618 "Link to the manual entry for this customization option." | |
| 619 :help-echo "Read the manual entry for this option." | |
| 620 :tag "Manual") | |
| 621 | |
| 622 ;;; The `custom-magic' Widget. | |
| 623 | |
| 624 (defface custom-invalid-face '((((class color)) | |
| 625 (:foreground "yellow" :background "red")) | |
| 626 (t | |
| 627 (:bold t :italic t :underline t))) | |
| 628 "Face used when the customize item is invalid.") | |
| 629 | |
| 630 (defface custom-rogue-face '((((class color)) | |
| 631 (:foreground "pink" :background "black")) | |
| 632 (t | |
| 633 (:underline t))) | |
| 634 "Face used when the customize item is not defined for customization.") | |
| 635 | |
| 636 (defface custom-modified-face '((((class color)) | |
| 637 (:foreground "white" :background "blue")) | |
| 638 (t | |
| 639 (:italic t :bold))) | |
| 640 "Face used when the customize item has been modified.") | |
| 641 | |
| 642 (defface custom-set-face '((((class color)) | |
| 643 (:foreground "blue" :background "white")) | |
| 644 (t | |
| 645 (:italic t))) | |
| 646 "Face used when the customize item has been set.") | |
| 647 | |
| 648 (defface custom-changed-face '((((class color)) | |
| 649 (:foreground "white" :background "blue")) | |
| 650 (t | |
| 651 (:italic t))) | |
| 652 "Face used when the customize item has been changed.") | |
| 653 | |
| 654 (defface custom-saved-face '((t (:underline t))) | |
| 655 "Face used when the customize item has been saved.") | |
| 656 | |
| 657 (defcustom custom-magic-alist '((nil "#" underline "\ | |
| 658 uninitialized, you should not see this.") | |
| 659 (unknown "?" italic "\ | |
| 660 unknown, you should not see this.") | |
| 661 (hidden "-" default "\ | |
| 662 hidden, press the state button to show.") | |
| 663 (invalid "x" custom-invalid-face "\ | |
| 664 the value displayed for this item is invalid and cannot be set.") | |
| 665 (modified "*" custom-modified-face "\ | |
| 666 you have edited the item, and can now set it.") | |
| 667 (set "+" custom-set-face "\ | |
| 668 you have set this item, but not saved it.") | |
| 669 (changed ":" custom-changed-face "\ | |
| 670 this item has been changed outside customize.") | |
| 671 (saved "!" custom-saved-face "\ | |
| 672 this item has been saved.") | |
| 673 (rogue "@" custom-rogue-face "\ | |
| 674 this item is not prepared for customization.") | |
| 675 (factory " " nil "\ | |
| 676 this item is unchanged from its factory setting.")) | |
| 677 "Alist of customize option states. | |
| 678 Each entry is of the form (STATE MAGIC FACE DESCRIPTION), where | |
| 679 | |
| 680 STATE is one of the following symbols: | |
| 681 | |
| 682 `nil' | |
| 683 For internal use, should never occur. | |
| 684 `unknown' | |
| 685 For internal use, should never occur. | |
| 686 `hidden' | |
| 687 This item is not being displayed. | |
| 688 `invalid' | |
| 689 This item is modified, but has an invalid form. | |
| 690 `modified' | |
| 691 This item is modified, and has a valid form. | |
| 692 `set' | |
| 693 This item has been set but not saved. | |
| 694 `changed' | |
| 695 The current value of this item has been changed temporarily. | |
| 696 `saved' | |
| 697 This item is marked for saving. | |
| 698 `rogue' | |
| 699 This item has no customization information. | |
| 700 `factory' | |
| 701 This item is unchanged from the factory default. | |
| 702 | |
| 703 MAGIC is a string used to present that state. | |
| 704 | |
| 705 FACE is a face used to present the state. | |
| 706 | |
| 707 DESCRIPTION is a string describing the state. | |
| 708 | |
| 709 The list should be sorted most significant first." | |
| 710 :type '(list (checklist :inline t | |
| 711 (group (const nil) | |
| 712 (string :tag "Magic") | |
| 713 face | |
| 714 (string :tag "Description")) | |
| 715 (group (const unknown) | |
| 716 (string :tag "Magic") | |
| 717 face | |
| 718 (string :tag "Description")) | |
| 719 (group (const hidden) | |
| 720 (string :tag "Magic") | |
| 721 face | |
| 722 (string :tag "Description")) | |
| 723 (group (const invalid) | |
| 724 (string :tag "Magic") | |
| 725 face | |
| 726 (string :tag "Description")) | |
| 727 (group (const modified) | |
| 728 (string :tag "Magic") | |
| 729 face | |
| 730 (string :tag "Description")) | |
| 731 (group (const set) | |
| 732 (string :tag "Magic") | |
| 733 face | |
| 734 (string :tag "Description")) | |
| 735 (group (const changed) | |
| 736 (string :tag "Magic") | |
| 737 face | |
| 738 (string :tag "Description")) | |
| 739 (group (const saved) | |
| 740 (string :tag "Magic") | |
| 741 face | |
| 742 (string :tag "Description")) | |
| 743 (group (const rogue) | |
| 744 (string :tag "Magic") | |
| 745 face | |
| 746 (string :tag "Description")) | |
| 747 (group (const factory) | |
| 748 (string :tag "Magic") | |
| 749 face | |
| 750 (string :tag "Description"))) | |
| 751 (editable-list :inline t | |
| 752 (group symbol | |
| 753 (string :tag "Magic") | |
| 754 face | |
| 755 (string :tag "Description")))) | |
| 756 :group 'customize) | |
| 757 | |
| 758 (defcustom custom-magic-show 'long | |
| 759 "Show long description of the state of each customization option." | |
| 760 :type '(choice (const :tag "no" nil) | |
| 761 (const short) | |
| 762 (const long)) | |
| 763 :group 'customize) | |
| 764 | |
| 765 (defcustom custom-magic-show-button t | |
| 766 "Show a magic button indicating the state of each customization option." | |
| 767 :type 'boolean | |
| 768 :group 'customize) | |
| 769 | |
| 770 (define-widget 'custom-magic 'default | |
| 771 "Show and manipulate state for a customization option." | |
| 772 :format "%v" | |
| 773 :action 'widget-choice-item-action | |
| 774 :value-get 'ignore | |
| 775 :value-create 'custom-magic-value-create | |
| 776 :value-delete 'widget-children-value-delete) | |
| 777 | |
| 778 (defun custom-magic-value-create (widget) | |
| 779 ;; Create compact status report for WIDGET. | |
| 780 (let* ((parent (widget-get widget :parent)) | |
| 781 (state (widget-get parent :custom-state)) | |
| 782 (entry (assq state custom-magic-alist)) | |
| 783 (magic (nth 1 entry)) | |
| 784 (face (nth 2 entry)) | |
| 785 (text (nth 3 entry)) | |
| 786 (lisp (eq (widget-get parent :custom-form) 'lisp)) | |
| 787 children) | |
| 788 (when custom-magic-show | |
| 789 (push (widget-create-child-and-convert widget 'choice-item | |
| 790 :help-echo "\ | |
| 791 Change the state of this item." | |
| 792 :format "%[%t%]" | |
| 793 :tag "State") | |
| 794 children) | |
| 795 (insert ": ") | |
| 796 (if (eq custom-magic-show 'long) | |
| 797 (insert text) | |
| 798 (insert (symbol-name state))) | |
| 799 (when lisp | |
| 800 (insert " (lisp)")) | |
| 801 (insert "\n")) | |
| 802 (when custom-magic-show-button | |
| 803 (when custom-magic-show | |
| 804 (let ((indent (widget-get parent :indent))) | |
| 805 (when indent | |
| 806 (insert-char ? indent)))) | |
| 807 (push (widget-create-child-and-convert widget 'choice-item | |
| 808 :button-face face | |
| 809 :help-echo "Change the state." | |
| 810 :format "%[%t%]" | |
| 811 :tag (if lisp | |
| 812 (concat "(" magic ")") | |
| 813 (concat "[" magic "]"))) | |
| 814 children) | |
| 815 (insert " ")) | |
| 816 (widget-put widget :children children))) | |
| 817 | |
| 818 (defun custom-magic-reset (widget) | |
| 819 "Redraw the :custom-magic property of WIDGET." | |
| 820 (let ((magic (widget-get widget :custom-magic))) | |
| 821 (widget-value-set magic (widget-value magic)))) | |
| 822 | |
| 823 ;;; The `custom-level' Widget. | |
| 824 | |
| 825 (define-widget 'custom-level 'item | |
| 826 "The custom level buttons." | |
| 827 :format "%[%t%]" | |
| 828 :help-echo "Expand or collapse this item." | |
| 829 :action 'custom-level-action) | |
| 830 | |
| 831 (defun custom-level-action (widget &optional event) | |
| 832 "Toggle visibility for parent to WIDGET." | |
| 833 (let* ((parent (widget-get widget :parent)) | |
| 834 (state (widget-get parent :custom-state))) | |
| 835 (cond ((memq state '(invalid modified)) | |
| 836 (error "There are unset changes")) | |
| 837 ((eq state 'hidden) | |
| 838 (widget-put parent :custom-state 'unknown)) | |
| 839 (t | |
| 840 (widget-put parent :custom-state 'hidden))) | |
| 841 (custom-redraw parent))) | |
| 842 | |
| 843 ;;; The `custom' Widget. | |
| 844 | |
| 845 (define-widget 'custom 'default | |
| 846 "Customize a user option." | |
| 847 :convert-widget 'custom-convert-widget | |
| 848 :format "%l%[%t%]: %v%m%h%a" | |
| 849 :format-handler 'custom-format-handler | |
| 850 :notify 'custom-notify | |
| 851 :custom-level 1 | |
| 852 :custom-state 'hidden | |
| 853 :documentation-property 'widget-subclass-responsibility | |
| 854 :value-create 'widget-subclass-responsibility | |
| 855 :value-delete 'widget-children-value-delete | |
| 856 :value-get 'widget-item-value-get | |
| 857 :validate 'widget-editable-list-validate | |
| 858 :match (lambda (widget value) (symbolp value))) | |
| 859 | |
| 860 (defun custom-convert-widget (widget) | |
| 861 ;; Initialize :value and :tag from :args in WIDGET. | |
| 862 (let ((args (widget-get widget :args))) | |
| 863 (when args | |
| 864 (widget-put widget :value (widget-apply widget | |
| 865 :value-to-internal (car args))) | |
| 866 (widget-put widget :tag (custom-unlispify-tag-name (car args))) | |
| 867 (widget-put widget :args nil))) | |
| 868 widget) | |
| 869 | |
| 870 (defun custom-format-handler (widget escape) | |
| 871 ;; We recognize extra escape sequences. | |
| 872 (let* ((buttons (widget-get widget :buttons)) | |
| 873 (state (widget-get widget :custom-state)) | |
| 874 (level (widget-get widget :custom-level))) | |
| 875 (cond ((eq escape ?l) | |
| 876 (when level | |
| 877 (push (widget-create-child-and-convert | |
| 878 widget 'custom-level (make-string level ?*)) | |
| 879 buttons) | |
| 880 (widget-insert " ") | |
| 881 (widget-put widget :buttons buttons))) | |
| 882 ((eq escape ?L) | |
| 883 (when (eq state 'hidden) | |
| 884 (widget-insert " ..."))) | |
| 885 ((eq escape ?m) | |
| 886 (and (eq (preceding-char) ?\n) | |
| 887 (widget-get widget :indent) | |
| 888 (insert-char ? (widget-get widget :indent))) | |
| 889 (let ((magic (widget-create-child-and-convert | |
| 890 widget 'custom-magic nil))) | |
| 891 (widget-put widget :custom-magic magic) | |
| 892 (push magic buttons) | |
| 893 (widget-put widget :buttons buttons))) | |
| 894 ((eq escape ?a) | |
| 895 (let* ((symbol (widget-get widget :value)) | |
| 896 (links (get symbol 'custom-links)) | |
| 897 (many (> (length links) 2))) | |
| 898 (when links | |
| 899 (and (eq (preceding-char) ?\n) | |
| 900 (widget-get widget :indent) | |
| 901 (insert-char ? (widget-get widget :indent))) | |
| 902 (insert "See also ") | |
| 903 (while links | |
| 904 (push (widget-create-child-and-convert widget (car links)) | |
| 905 buttons) | |
| 906 (setq links (cdr links)) | |
| 907 (cond ((null links) | |
| 908 (insert ".\n")) | |
| 909 ((null (cdr links)) | |
| 910 (if many | |
| 911 (insert ", and ") | |
| 912 (insert " and "))) | |
| 913 (t | |
| 914 (insert ", ")))) | |
| 915 (widget-put widget :buttons buttons)))) | |
| 916 (t | |
| 917 (widget-default-format-handler widget escape))))) | |
| 918 | |
| 919 (defun custom-notify (widget &rest args) | |
| 920 "Keep track of changes." | |
| 921 (unless (memq (widget-get widget :custom-state) '(nil unknown hidden)) | |
| 922 (widget-put widget :custom-state 'modified)) | |
| 923 (let ((buffer-undo-list t)) | |
| 924 (custom-magic-reset widget)) | |
| 925 (apply 'widget-default-notify widget args)) | |
| 926 | |
| 927 (defun custom-redraw (widget) | |
| 928 "Redraw WIDGET with current settings." | |
| 929 (let ((pos (point)) | |
| 930 (from (marker-position (widget-get widget :from))) | |
| 931 (to (marker-position (widget-get widget :to)))) | |
| 932 (save-excursion | |
| 933 (widget-value-set widget (widget-value widget)) | |
| 934 (custom-redraw-magic widget)) | |
| 935 (when (and (>= pos from) (<= pos to)) | |
| 936 (goto-char pos)))) | |
| 937 | |
| 938 (defun custom-redraw-magic (widget) | |
| 939 "Redraw WIDGET state with current settings." | |
| 940 (while widget | |
| 941 (let ((magic (widget-get widget :custom-magic))) | |
| 942 (unless magic | |
| 943 (debug)) | |
| 944 (widget-value-set magic (widget-value magic)) | |
| 945 (when (setq widget (widget-get widget :group)) | |
| 946 (custom-group-state-update widget)))) | |
| 947 (widget-setup)) | |
| 948 | |
| 949 (defun custom-show (widget value) | |
| 950 "Non-nil if WIDGET should be shown with VALUE by default." | |
| 951 (let ((show (widget-get widget :custom-show))) | |
| 952 (cond ((null show) | |
| 953 nil) | |
| 954 ((eq t show) | |
| 955 t) | |
| 956 (t | |
| 957 (funcall show widget value))))) | |
| 958 | |
| 959 (defun custom-load-symbol (symbol) | |
| 960 "Load all dependencies for SYMBOL." | |
| 961 (let ((loads (get symbol 'custom-loads)) | |
| 962 load) | |
| 963 (while loads | |
| 964 (setq load (car loads) | |
| 965 loads (cdr loads)) | |
| 966 (cond ((symbolp load) | |
| 967 (condition-case nil | |
| 968 (require load) | |
| 969 (error nil))) | |
| 970 ((assoc load load-history)) | |
| 971 (t | |
| 972 (condition-case nil | |
| 973 (load-library load) | |
| 974 (error nil))))))) | |
| 975 | |
| 976 (defun custom-load-widget (widget) | |
| 977 "Load all dependencies for WIDGET." | |
| 978 (custom-load-symbol (widget-value widget))) | |
| 979 | |
| 980 ;;; The `custom-variable' Widget. | |
| 981 | |
| 982 (defface custom-variable-sample-face '((t (:underline t))) | |
| 983 "Face used for unpushable variable tags." | |
| 984 :group 'customize) | |
| 985 | |
| 986 (defface custom-variable-button-face '((t (:underline t :bold t))) | |
| 987 "Face used for pushable variable tags." | |
| 988 :group 'customize) | |
| 989 | |
| 990 (define-widget 'custom-variable 'custom | |
| 991 "Customize variable." | |
| 992 :format "%l%v%m%h%a" | |
| 993 :help-echo "Set or reset this variable." | |
| 994 :documentation-property 'variable-documentation | |
| 995 :custom-state nil | |
| 996 :custom-menu 'custom-variable-menu-create | |
| 997 :custom-form 'edit | |
| 998 :value-create 'custom-variable-value-create | |
| 999 :action 'custom-variable-action | |
| 1000 :custom-set 'custom-variable-set | |
| 1001 :custom-save 'custom-variable-save | |
| 1002 :custom-reset-current 'custom-redraw | |
| 1003 :custom-reset-saved 'custom-variable-reset-saved | |
| 1004 :custom-reset-factory 'custom-variable-reset-factory) | |
| 1005 | |
| 1006 (defun custom-variable-value-create (widget) | |
| 1007 "Here is where you edit the variables value." | |
| 1008 (custom-load-widget widget) | |
| 1009 (let* ((buttons (widget-get widget :buttons)) | |
| 1010 (children (widget-get widget :children)) | |
| 1011 (form (widget-get widget :custom-form)) | |
| 1012 (state (widget-get widget :custom-state)) | |
| 1013 (symbol (widget-get widget :value)) | |
| 1014 (options (get symbol 'custom-options)) | |
| 1015 (child-type (or (get symbol 'custom-type) 'sexp)) | |
| 1016 (tag (widget-get widget :tag)) | |
| 1017 (type (let ((tmp (if (listp child-type) | |
| 1018 (copy-list child-type) | |
| 1019 (list child-type)))) | |
| 1020 (when options | |
| 1021 (widget-put tmp :options options)) | |
| 1022 tmp)) | |
| 1023 (conv (widget-convert type)) | |
| 1024 (value (if (default-boundp symbol) | |
| 1025 (default-value symbol) | |
| 1026 (widget-get conv :value)))) | |
| 1027 ;; If the widget is new, the child determine whether it is hidden. | |
| 1028 (cond (state) | |
| 1029 ((custom-show type value) | |
| 1030 (setq state 'unknown)) | |
| 1031 (t | |
| 1032 (setq state 'hidden))) | |
| 1033 ;; If we don't know the state, see if we need to edit it in lisp form. | |
| 1034 (when (eq state 'unknown) | |
| 1035 (unless (widget-apply conv :match value) | |
| 1036 ;; (widget-apply (widget-convert type) :match value) | |
| 1037 (setq form 'lisp))) | |
| 1038 ;; Now we can create the child widget. | |
| 1039 (cond ((eq state 'hidden) | |
| 1040 ;; Indicate hidden value. | |
| 1041 (push (widget-create-child-and-convert | |
| 1042 widget 'item | |
| 1043 :format "%{%t%}: ..." | |
| 1044 :sample-face 'custom-variable-sample-face | |
| 1045 :tag tag | |
| 1046 :parent widget) | |
| 1047 children)) | |
| 1048 ((eq form 'lisp) | |
| 1049 ;; In lisp mode edit the saved value when possible. | |
| 1050 (let* ((value (cond ((get symbol 'saved-value) | |
| 1051 (car (get symbol 'saved-value))) | |
| 1052 ((get symbol 'factory-value) | |
| 1053 (car (get symbol 'factory-value))) | |
| 1054 ((default-boundp symbol) | |
| 1055 (custom-quote (default-value symbol))) | |
| 1056 (t | |
| 1057 (custom-quote (widget-get conv :value)))))) | |
| 1058 (push (widget-create-child-and-convert | |
| 1059 widget 'sexp | |
| 1060 :button-face 'custom-variable-button-face | |
| 1061 :tag (symbol-name symbol) | |
| 1062 :parent widget | |
| 1063 :value value) | |
| 1064 children))) | |
| 1065 (t | |
| 1066 ;; Edit mode. | |
| 1067 (push (widget-create-child-and-convert | |
| 1068 widget type | |
| 1069 :tag tag | |
| 1070 :button-face 'custom-variable-button-face | |
| 1071 :sample-face 'custom-variable-sample-face | |
| 1072 :value value) | |
| 1073 children))) | |
| 1074 ;; Now update the state. | |
| 1075 (unless (eq (preceding-char) ?\n) | |
| 1076 (widget-insert "\n")) | |
| 1077 (if (eq state 'hidden) | |
| 1078 (widget-put widget :custom-state state) | |
| 1079 (custom-variable-state-set widget)) | |
| 1080 (widget-put widget :custom-form form) | |
| 1081 (widget-put widget :buttons buttons) | |
| 1082 (widget-put widget :children children))) | |
| 1083 | |
| 1084 (defun custom-variable-state-set (widget) | |
| 1085 "Set the state of WIDGET." | |
| 1086 (let* ((symbol (widget-value widget)) | |
| 1087 (value (if (default-boundp symbol) | |
| 1088 (default-value symbol) | |
| 1089 (widget-get widget :value))) | |
| 1090 tmp | |
| 1091 (state (cond ((setq tmp (get symbol 'customized-value)) | |
| 1092 (if (condition-case nil | |
| 1093 (equal value (eval (car tmp))) | |
| 1094 (error nil)) | |
| 1095 'set | |
| 1096 'changed)) | |
| 1097 ((setq tmp (get symbol 'saved-value)) | |
| 1098 (if (condition-case nil | |
| 1099 (equal value (eval (car tmp))) | |
| 1100 (error nil)) | |
| 1101 'saved | |
| 1102 'changed)) | |
| 1103 ((setq tmp (get symbol 'factory-value)) | |
| 1104 (if (condition-case nil | |
| 1105 (equal value (eval (car tmp))) | |
| 1106 (error nil)) | |
| 1107 'factory | |
| 1108 'changed)) | |
| 1109 (t 'rogue)))) | |
| 1110 (widget-put widget :custom-state state))) | |
| 1111 | |
| 1112 (defvar custom-variable-menu | |
| 1113 '(("Edit" . custom-variable-edit) | |
| 1114 ("Edit Lisp" . custom-variable-edit-lisp) | |
| 1115 ("Set" . custom-variable-set) | |
| 1116 ("Save" . custom-variable-save) | |
| 1117 ("Reset to Current" . custom-redraw) | |
| 1118 ("Reset to Saved" . custom-variable-reset-saved) | |
| 1119 ("Reset to Factory Settings" . custom-variable-reset-factory)) | |
| 1120 "Alist of actions for the `custom-variable' widget. | |
| 1121 The key is a string containing the name of the action, the value is a | |
| 1122 lisp function taking the widget as an element which will be called | |
| 1123 when the action is chosen.") | |
| 1124 | |
| 1125 (defun custom-variable-action (widget &optional event) | |
| 1126 "Show the menu for `custom-variable' WIDGET. | |
| 1127 Optional EVENT is the location for the menu." | |
| 1128 (if (eq (widget-get widget :custom-state) 'hidden) | |
| 1129 (progn | |
| 1130 (widget-put widget :custom-state 'unknown) | |
| 1131 (custom-redraw widget)) | |
| 1132 (let* ((completion-ignore-case t) | |
| 1133 (answer (widget-choose (custom-unlispify-tag-name | |
| 1134 (widget-get widget :value)) | |
| 1135 custom-variable-menu | |
| 1136 event))) | |
| 1137 (if answer | |
| 1138 (funcall answer widget))))) | |
| 1139 | |
| 1140 (defun custom-variable-edit (widget) | |
| 1141 "Edit value of WIDGET." | |
| 1142 (widget-put widget :custom-state 'unknown) | |
| 1143 (widget-put widget :custom-form 'edit) | |
| 1144 (custom-redraw widget)) | |
| 1145 | |
| 1146 (defun custom-variable-edit-lisp (widget) | |
| 1147 "Edit the lisp representation of the value of WIDGET." | |
| 1148 (widget-put widget :custom-state 'unknown) | |
| 1149 (widget-put widget :custom-form 'lisp) | |
| 1150 (custom-redraw widget)) | |
| 1151 | |
| 1152 (defun custom-variable-set (widget) | |
| 1153 "Set the current value for the variable being edited by WIDGET." | |
| 1154 (let ((form (widget-get widget :custom-form)) | |
| 1155 (state (widget-get widget :custom-state)) | |
| 1156 (child (car (widget-get widget :children))) | |
| 1157 (symbol (widget-value widget)) | |
| 1158 val) | |
| 1159 (cond ((eq state 'hidden) | |
| 1160 (error "Cannot set hidden variable.")) | |
| 1161 ((setq val (widget-apply child :validate)) | |
| 1162 (goto-char (widget-get val :from)) | |
| 1163 (error "%s" (widget-get val :error))) | |
| 1164 ((eq form 'lisp) | |
| 1165 (set symbol (eval (setq val (widget-value child)))) | |
| 1166 (put symbol 'customized-value (list val))) | |
| 1167 (t | |
| 1168 (set symbol (setq val (widget-value child))) | |
| 1169 (put symbol 'customized-value (list (custom-quote val))))) | |
| 1170 (custom-variable-state-set widget) | |
| 1171 (custom-redraw-magic widget))) | |
| 1172 | |
| 1173 (defun custom-variable-save (widget) | |
| 1174 "Set the default value for the variable being edited by WIDGET." | |
| 1175 (let ((form (widget-get widget :custom-form)) | |
| 1176 (state (widget-get widget :custom-state)) | |
| 1177 (child (car (widget-get widget :children))) | |
| 1178 (symbol (widget-value widget)) | |
| 1179 val) | |
| 1180 (cond ((eq state 'hidden) | |
| 1181 (error "Cannot set hidden variable.")) | |
| 1182 ((setq val (widget-apply child :validate)) | |
| 1183 (goto-char (widget-get val :from)) | |
| 1184 (error "%s" (widget-get val :error))) | |
| 1185 ((eq form 'lisp) | |
| 1186 (put symbol 'saved-value (list (widget-value child))) | |
| 1187 (set symbol (eval (widget-value child)))) | |
| 1188 (t | |
| 1189 (put symbol | |
| 1190 'saved-value (list (custom-quote (widget-value | |
| 1191 child)))) | |
| 1192 (set symbol (widget-value child)))) | |
| 1193 (put symbol 'customized-value nil) | |
| 1194 (custom-save-all) | |
| 1195 (custom-variable-state-set widget) | |
| 1196 (custom-redraw-magic widget))) | |
| 1197 | |
| 1198 (defun custom-variable-reset-saved (widget) | |
| 1199 "Restore the saved value for the variable being edited by WIDGET." | |
| 1200 (let ((symbol (widget-value widget))) | |
| 1201 (if (get symbol 'saved-value) | |
| 1202 (condition-case nil | |
| 1203 (set symbol (eval (car (get symbol 'saved-value)))) | |
| 1204 (error nil)) | |
| 1205 (error "No saved value for %s" symbol)) | |
| 1206 (put symbol 'customized-value nil) | |
| 1207 (widget-put widget :custom-state 'unknown) | |
| 1208 (custom-redraw widget))) | |
| 1209 | |
| 1210 (defun custom-variable-reset-factory (widget) | |
| 1211 "Restore the factory setting for the variable being edited by WIDGET." | |
| 1212 (let ((symbol (widget-value widget))) | |
| 1213 (if (get symbol 'factory-value) | |
| 1214 (set symbol (eval (car (get symbol 'factory-value)))) | |
| 1215 (error "No factory default for %S" symbol)) | |
| 1216 (put symbol 'customized-value nil) | |
| 1217 (when (get symbol 'saved-value) | |
| 1218 (put symbol 'saved-value nil) | |
| 1219 (custom-save-all)) | |
| 1220 (widget-put widget :custom-state 'unknown) | |
| 1221 (custom-redraw widget))) | |
| 1222 | |
| 1223 ;;; The `custom-face-edit' Widget. | |
| 1224 | |
| 1225 (define-widget 'custom-face-edit 'checklist | |
| 1226 "Edit face attributes." | |
| 1227 :format "%t: %v" | |
| 1228 :tag "Attributes" | |
| 1229 :extra-offset 12 | |
| 1230 :button-args '(:help-echo "Control whether this attribute have any effect.") | |
| 1231 :args (mapcar (lambda (att) | |
| 1232 (list 'group | |
| 1233 :inline t | |
| 1234 :sibling-args (widget-get (nth 1 att) :sibling-args) | |
| 1235 (list 'const :format "" :value (nth 0 att)) | |
| 1236 (nth 1 att))) | |
| 1237 custom-face-attributes)) | |
| 1238 | |
| 1239 ;;; The `custom-display' Widget. | |
| 1240 | |
| 1241 (define-widget 'custom-display 'menu-choice | |
| 1242 "Select a display type." | |
| 1243 :tag "Display" | |
| 1244 :value t | |
| 1245 :help-echo "Specify frames where the face attributes should be used." | |
| 1246 :args '((const :tag "all" t) | |
| 1247 (checklist | |
| 1248 :offset 0 | |
| 1249 :extra-offset 9 | |
| 1250 :args ((group :sibling-args (:help-echo "\ | |
| 1251 Only match the specified window systems.") | |
| 1252 (const :format "Type: " | |
| 1253 type) | |
| 1254 (checklist :inline t | |
| 1255 :offset 0 | |
| 1256 (const :format "X " | |
| 1257 :sibling-args (:help-echo "\ | |
| 1258 The X11 Window System.") | |
| 1259 x) | |
| 1260 (const :format "PM " | |
| 1261 :sibling-args (:help-echo "\ | |
| 1262 OS/2 Presentation Manager.") | |
| 1263 pm) | |
| 1264 (const :format "Win32 " | |
| 1265 :sibling-args (:help-echo "\ | |
| 1266 Windows NT/95/97.") | |
| 1267 win32) | |
| 1268 (const :format "DOS " | |
| 1269 :sibling-args (:help-echo "\ | |
| 1270 Plain MS-DOS.") | |
| 1271 pc) | |
| 1272 (const :format "TTY%n" | |
| 1273 :sibling-args (:help-echo "\ | |
| 1274 Plain text terminals.") | |
| 1275 tty))) | |
| 1276 (group :sibling-args (:help-echo "\ | |
| 1277 Only match the frames with the specified color support.") | |
| 1278 (const :format "Class: " | |
| 1279 class) | |
| 1280 (checklist :inline t | |
| 1281 :offset 0 | |
| 1282 (const :format "Color " | |
| 1283 :sibling-args (:help-echo "\ | |
| 1284 Match color frames.") | |
| 1285 color) | |
| 1286 (const :format "Grayscale " | |
| 1287 :sibling-args (:help-echo "\ | |
| 1288 Match grayscale frames.") | |
| 1289 grayscale) | |
| 1290 (const :format "Monochrome%n" | |
| 1291 :sibling-args (:help-echo "\ | |
| 1292 Match frames with no color support.") | |
| 1293 mono))) | |
| 1294 (group :sibling-args (:help-echo "\ | |
| 1295 Only match frames with the specified intensity.") | |
| 1296 (const :format "\ | |
| 1297 Background brightness: " | |
| 1298 background) | |
| 1299 (checklist :inline t | |
| 1300 :offset 0 | |
| 1301 (const :format "Light " | |
| 1302 :sibling-args (:help-echo "\ | |
| 1303 Match frames with light backgrounds.") | |
| 1304 light) | |
| 1305 (const :format "Dark\n" | |
| 1306 :sibling-args (:help-echo "\ | |
| 1307 Match frames with dark backgrounds.") | |
| 1308 dark))))))) | |
| 1309 | |
| 1310 ;;; The `custom-face' Widget. | |
| 1311 | |
| 1312 (defface custom-face-tag-face '((t (:underline t))) | |
| 1313 "Face used for face tags." | |
| 1314 :group 'customize) | |
| 1315 | |
| 1316 (define-widget 'custom-face 'custom | |
| 1317 "Customize face." | |
| 1318 :format "%l%{%t%}: %s%m%h%a%v" | |
| 1319 :format-handler 'custom-face-format-handler | |
| 1320 :sample-face 'custom-face-tag-face | |
| 1321 :help-echo "Set or reset this face." | |
| 1322 :documentation-property '(lambda (face) | |
| 1323 (face-doc-string face)) | |
| 1324 :value-create 'custom-face-value-create | |
| 1325 :action 'custom-face-action | |
| 1326 :custom-form 'selected | |
| 1327 :custom-set 'custom-face-set | |
| 1328 :custom-save 'custom-face-save | |
| 1329 :custom-reset-current 'custom-redraw | |
| 1330 :custom-reset-saved 'custom-face-reset-saved | |
| 1331 :custom-reset-factory 'custom-face-reset-factory | |
| 1332 :custom-menu 'custom-face-menu-create) | |
| 1333 | |
| 1334 (defun custom-face-format-handler (widget escape) | |
| 1335 ;; We recognize extra escape sequences. | |
| 1336 (let (child | |
| 1337 (symbol (widget-get widget :value))) | |
| 1338 (cond ((eq escape ?s) | |
| 1339 (and (string-match "XEmacs" emacs-version) | |
| 1340 ;; XEmacs cannot display initialized faces. | |
| 1341 (not (custom-facep symbol)) | |
| 1342 (copy-face 'custom-face-empty symbol)) | |
| 1343 (setq child (widget-create-child-and-convert | |
| 1344 widget 'item | |
| 1345 :format "(%{%t%})\n" | |
| 1346 :sample-face symbol | |
| 1347 :tag "sample"))) | |
| 1348 (t | |
| 1349 (custom-format-handler widget escape))) | |
| 1350 (when child | |
| 1351 (widget-put widget | |
| 1352 :buttons (cons child (widget-get widget :buttons)))))) | |
| 1353 | |
| 1354 (define-widget 'custom-face-all 'editable-list | |
| 1355 "An editable list of display specifications and attributes." | |
| 1356 :entry-format "%i %d %v" | |
| 1357 :insert-button-args '(:help-echo "Insert new display specification here.") | |
| 1358 :append-button-args '(:help-echo "Append new display specification here.") | |
| 1359 :delete-button-args '(:help-echo "Delete this display specification.") | |
| 1360 :args '((group :format "%v" custom-display custom-face-edit))) | |
| 1361 | |
| 1362 (defconst custom-face-all (widget-convert 'custom-face-all) | |
| 1363 "Converted version of the `custom-face-all' widget.") | |
| 1364 | |
| 1365 (define-widget 'custom-display-unselected 'item | |
| 1366 "A display specification that doesn't match the selected display." | |
| 1367 :match 'custom-display-unselected-match) | |
| 1368 | |
| 1369 (defun custom-display-unselected-match (widget value) | |
| 1370 "Non-nil if VALUE is an unselected display specification." | |
| 1371 (and (listp value) | |
| 1372 (eq (length value) 2) | |
| 1373 (not (custom-display-match-frame value (selected-frame))))) | |
| 1374 | |
| 1375 (define-widget 'custom-face-selected 'group | |
| 1376 "Edit the attributes of the selected display in a face specification." | |
| 1377 :args '((repeat :format "" | |
| 1378 :inline t | |
| 1379 (group custom-display-unselected sexp)) | |
| 1380 (group (sexp :format "") custom-face-edit) | |
| 1381 (repeat :format "" | |
| 1382 :inline t | |
| 1383 sexp))) | |
| 1384 | |
| 1385 (defconst custom-face-selected (widget-convert 'custom-face-selected) | |
| 1386 "Converted version of the `custom-face-selected' widget.") | |
| 1387 | |
| 1388 (defun custom-face-value-create (widget) | |
| 1389 ;; Create a list of the display specifications. | |
| 1390 (unless (eq (preceding-char) ?\n) | |
| 1391 (insert "\n")) | |
| 1392 (when (not (eq (widget-get widget :custom-state) 'hidden)) | |
| 1393 (message "Creating face editor...") | |
| 1394 (custom-load-widget widget) | |
| 1395 (let* ((symbol (widget-value widget)) | |
| 1396 (spec (or (get symbol 'saved-face) | |
| 1397 (get symbol 'factory-face) | |
| 1398 ;; Attempt to construct it. | |
| 1399 (list (list t (custom-face-attributes-get | |
| 1400 symbol (selected-frame)))))) | |
| 1401 (form (widget-get widget :custom-form)) | |
| 1402 (indent (widget-get widget :indent)) | |
| 1403 (edit (widget-create-child-and-convert | |
| 1404 widget | |
| 1405 (cond ((and (eq form 'selected) | |
| 1406 (widget-apply custom-face-selected :match spec)) | |
| 1407 (when indent (insert-char ?\ indent)) | |
| 1408 'custom-face-selected) | |
| 1409 ((and (not (eq form 'lisp)) | |
| 1410 (widget-apply custom-face-all :match spec)) | |
| 1411 'custom-face-all) | |
| 1412 (t | |
| 1413 (when indent (insert-char ?\ indent)) | |
| 1414 'sexp)) | |
| 1415 :value spec))) | |
| 1416 (custom-face-state-set widget) | |
| 1417 (widget-put widget :children (list edit))) | |
| 1418 (message "Creating face editor...done"))) | |
| 1419 | |
| 1420 (defvar custom-face-menu | |
| 1421 '(("Edit Selected" . custom-face-edit-selected) | |
| 1422 ("Edit All" . custom-face-edit-all) | |
| 1423 ("Edit Lisp" . custom-face-edit-lisp) | |
| 1424 ("Set" . custom-face-set) | |
| 1425 ("Save" . custom-face-save) | |
| 1426 ("Reset to Saved" . custom-face-reset-saved) | |
| 1427 ("Reset to Factory Setting" . custom-face-reset-factory)) | |
| 1428 "Alist of actions for the `custom-face' widget. | |
| 1429 The key is a string containing the name of the action, the value is a | |
| 1430 lisp function taking the widget as an element which will be called | |
| 1431 when the action is chosen.") | |
| 1432 | |
| 1433 (defun custom-face-edit-selected (widget) | |
| 1434 "Edit selected attributes of the value of WIDGET." | |
| 1435 (widget-put widget :custom-state 'unknown) | |
| 1436 (widget-put widget :custom-form 'selected) | |
| 1437 (custom-redraw widget)) | |
| 1438 | |
| 1439 (defun custom-face-edit-all (widget) | |
| 1440 "Edit all attributes of the value of WIDGET." | |
| 1441 (widget-put widget :custom-state 'unknown) | |
| 1442 (widget-put widget :custom-form 'all) | |
| 1443 (custom-redraw widget)) | |
| 1444 | |
| 1445 (defun custom-face-edit-lisp (widget) | |
| 1446 "Edit the lisp representation of the value of WIDGET." | |
| 1447 (widget-put widget :custom-state 'unknown) | |
| 1448 (widget-put widget :custom-form 'lisp) | |
| 1449 (custom-redraw widget)) | |
| 1450 | |
| 1451 (defun custom-face-state-set (widget) | |
| 1452 "Set the state of WIDGET." | |
| 1453 (let ((symbol (widget-value widget))) | |
| 1454 (widget-put widget :custom-state (cond ((get symbol 'customized-face) | |
| 1455 'set) | |
| 1456 ((get symbol 'saved-face) | |
| 1457 'saved) | |
| 1458 ((get symbol 'factory-face) | |
| 1459 'factory) | |
| 1460 (t | |
| 1461 'rogue))))) | |
| 1462 | |
| 1463 (defun custom-face-action (widget &optional event) | |
| 1464 "Show the menu for `custom-face' WIDGET. | |
| 1465 Optional EVENT is the location for the menu." | |
| 1466 (if (eq (widget-get widget :custom-state) 'hidden) | |
| 1467 (progn | |
| 1468 (widget-put widget :custom-state 'unknown) | |
| 1469 (custom-redraw widget)) | |
| 1470 (let* ((completion-ignore-case t) | |
| 1471 (symbol (widget-get widget :value)) | |
| 1472 (answer (widget-choose (custom-unlispify-tag-name symbol) | |
| 1473 custom-face-menu event))) | |
| 1474 (if answer | |
| 1475 (funcall answer widget))))) | |
| 1476 | |
| 1477 (defun custom-face-set (widget) | |
| 1478 "Make the face attributes in WIDGET take effect." | |
| 1479 (let* ((symbol (widget-value widget)) | |
| 1480 (child (car (widget-get widget :children))) | |
| 1481 (value (widget-value child))) | |
| 1482 (put symbol 'customized-face value) | |
| 1483 (when (fboundp 'copy-face) | |
| 1484 (copy-face 'custom-face-empty symbol)) | |
| 1485 (custom-face-display-set symbol value) | |
| 1486 (custom-face-state-set widget) | |
| 1487 (custom-redraw-magic widget))) | |
| 1488 | |
| 1489 (defun custom-face-save (widget) | |
| 1490 "Make the face attributes in WIDGET default." | |
| 1491 (let* ((symbol (widget-value widget)) | |
| 1492 (child (car (widget-get widget :children))) | |
| 1493 (value (widget-value child))) | |
| 1494 (when (fboundp 'copy-face) | |
| 1495 (copy-face 'custom-face-empty symbol)) | |
| 1496 (custom-face-display-set symbol value) | |
| 1497 (put symbol 'saved-face value) | |
| 1498 (put symbol 'customized-face nil) | |
| 1499 (custom-face-state-set widget) | |
| 1500 (custom-redraw-magic widget))) | |
| 1501 | |
| 1502 (defun custom-face-reset-saved (widget) | |
| 1503 "Restore WIDGET to the face's default attributes." | |
| 1504 (let* ((symbol (widget-value widget)) | |
| 1505 (child (car (widget-get widget :children))) | |
| 1506 (value (get symbol 'saved-face))) | |
| 1507 (unless value | |
| 1508 (error "No saved value for this face")) | |
| 1509 (put symbol 'customized-face nil) | |
| 1510 (when (fboundp 'copy-face) | |
| 1511 (copy-face 'custom-face-empty symbol)) | |
| 1512 (custom-face-display-set symbol value) | |
| 1513 (widget-value-set child value) | |
| 1514 (custom-face-state-set widget) | |
| 1515 (custom-redraw-magic widget))) | |
| 1516 | |
| 1517 (defun custom-face-reset-factory (widget) | |
| 1518 "Restore WIDGET to the face's factory settings." | |
| 1519 (let* ((symbol (widget-value widget)) | |
| 1520 (child (car (widget-get widget :children))) | |
| 1521 (value (get symbol 'factory-face))) | |
| 1522 (unless value | |
| 1523 (error "No factory default for this face")) | |
| 1524 (put symbol 'customized-face nil) | |
| 1525 (when (get symbol 'saved-face) | |
| 1526 (put symbol 'saved-face nil) | |
| 1527 (custom-save-all)) | |
| 1528 (when (fboundp 'copy-face) | |
| 1529 (copy-face 'custom-face-empty symbol)) | |
| 1530 (custom-face-display-set symbol value) | |
| 1531 (widget-value-set child value) | |
| 1532 (custom-face-state-set widget) | |
| 1533 (custom-redraw-magic widget))) | |
| 1534 | |
| 1535 ;;; The `face' Widget. | |
| 1536 | |
| 1537 (define-widget 'face 'default | |
| 1538 "Select and customize a face." | |
| 1539 :convert-widget 'widget-item-convert-widget | |
| 1540 :format "%[%t%]: %v" | |
| 1541 :tag "Face" | |
| 1542 :value 'default | |
| 1543 :value-create 'widget-face-value-create | |
| 1544 :value-delete 'widget-face-value-delete | |
| 1545 :value-get 'widget-item-value-get | |
| 1546 :validate 'widget-editable-list-validate | |
| 1547 :action 'widget-face-action | |
| 1548 :match '(lambda (widget value) (symbolp value))) | |
| 1549 | |
| 1550 (defun widget-face-value-create (widget) | |
| 1551 ;; Create a `custom-face' child. | |
| 1552 (let* ((symbol (widget-value widget)) | |
| 1553 (child (widget-create-child-and-convert | |
| 1554 widget 'custom-face | |
| 1555 :format "%t %s%m%h%v" | |
| 1556 :custom-level nil | |
| 1557 :value symbol))) | |
| 1558 (custom-magic-reset child) | |
| 1559 (setq custom-options (cons child custom-options)) | |
| 1560 (widget-put widget :children (list child)))) | |
| 1561 | |
| 1562 (defun widget-face-value-delete (widget) | |
| 1563 ;; Remove the child from the options. | |
| 1564 (let ((child (car (widget-get widget :children)))) | |
| 1565 (setq custom-options (delq child custom-options)) | |
| 1566 (widget-children-value-delete widget))) | |
| 1567 | |
| 1568 (defvar face-history nil | |
| 1569 "History of entered face names.") | |
| 1570 | |
| 1571 (defun widget-face-action (widget &optional event) | |
| 1572 "Prompt for a face." | |
| 1573 (let ((answer (completing-read "Face: " | |
| 1574 (mapcar (lambda (face) | |
| 1575 (list (symbol-name face))) | |
| 1576 (face-list)) | |
| 1577 nil nil nil | |
| 1578 'face-history))) | |
| 1579 (unless (zerop (length answer)) | |
| 1580 (widget-value-set widget (intern answer)) | |
| 1581 (widget-apply widget :notify widget event) | |
| 1582 (widget-setup)))) | |
| 1583 | |
| 1584 ;;; The `hook' Widget. | |
| 1585 | |
| 1586 (define-widget 'hook 'list | |
| 1587 "A emacs lisp hook" | |
| 1588 :convert-widget 'custom-hook-convert-widget | |
| 1589 :tag "Hook") | |
| 1590 | |
| 1591 (defun custom-hook-convert-widget (widget) | |
| 1592 ;; Handle `:custom-options'. | |
| 1593 (let* ((options (widget-get widget :options)) | |
| 1594 (other `(editable-list :inline t | |
| 1595 :entry-format "%i %d%v" | |
| 1596 (function :format " %v"))) | |
| 1597 (args (if options | |
| 1598 (list `(checklist :inline t | |
| 1599 ,@(mapcar (lambda (entry) | |
| 1600 `(function-item ,entry)) | |
| 1601 options)) | |
| 1602 other) | |
| 1603 (list other)))) | |
| 1604 (widget-put widget :args args) | |
| 1605 widget)) | |
| 1606 | |
| 1607 ;;; The `custom-group' Widget. | |
| 1608 | |
| 1609 (defcustom custom-group-tag-faces '(custom-group-tag-face-1) | |
| 1610 ;; In XEmacs, this ought to play games with font size. | |
| 1611 "Face used for group tags. | |
| 1612 The first member is used for level 1 groups, the second for level 2, | |
| 1613 and so forth. The remaining group tags are shown with | |
| 1614 `custom-group-tag-face'." | |
| 1615 :type '(repeat face) | |
| 1616 :group 'customize) | |
| 1617 | |
| 1618 (defface custom-group-tag-face-1 '((((class color) | |
| 1619 (background dark)) | |
| 1620 (:foreground "pink" :underline t)) | |
| 1621 (((class color) | |
| 1622 (background light)) | |
| 1623 (:foreground "red" :underline t)) | |
| 1624 (t (:underline t))) | |
| 1625 "Face used for group tags.") | |
| 1626 | |
| 1627 (defface custom-group-tag-face '((((class color) | |
| 1628 (background dark)) | |
| 1629 (:foreground "light blue" :underline t)) | |
| 1630 (((class color) | |
| 1631 (background light)) | |
| 1632 (:foreground "blue" :underline t)) | |
| 1633 (t (:underline t))) | |
| 1634 "Face used for low level group tags." | |
| 1635 :group 'customize) | |
| 1636 | |
| 1637 (define-widget 'custom-group 'custom | |
| 1638 "Customize group." | |
| 1639 :format "%l%{%t%}:%L\n%m%h%a%v" | |
| 1640 :sample-face-get 'custom-group-sample-face-get | |
| 1641 :documentation-property 'group-documentation | |
| 1642 :help-echo "Set or reset all members of this group." | |
| 1643 :value-create 'custom-group-value-create | |
| 1644 :action 'custom-group-action | |
| 1645 :custom-set 'custom-group-set | |
| 1646 :custom-save 'custom-group-save | |
| 1647 :custom-reset-current 'custom-group-reset-current | |
| 1648 :custom-reset-saved 'custom-group-reset-saved | |
| 1649 :custom-reset-factory 'custom-group-reset-factory | |
| 1650 :custom-menu 'custom-group-menu-create) | |
| 1651 | |
| 1652 (defun custom-group-sample-face-get (widget) | |
| 1653 ;; Use :sample-face. | |
| 1654 (or (nth (1- (widget-get widget :custom-level)) custom-group-tag-faces) | |
| 1655 'custom-group-tag-face)) | |
| 1656 | |
| 1657 (defun custom-group-value-create (widget) | |
| 1658 (let ((state (widget-get widget :custom-state))) | |
| 1659 (unless (eq state 'hidden) | |
| 1660 (message "Creating group...") | |
| 1661 (custom-load-widget widget) | |
| 1662 (let* ((level (widget-get widget :custom-level)) | |
| 1663 (symbol (widget-value widget)) | |
| 1664 (members (get symbol 'custom-group)) | |
| 1665 (prefixes (widget-get widget :custom-prefixes)) | |
| 1666 (custom-prefix-list (custom-prefix-add symbol prefixes)) | |
| 1667 (length (length members)) | |
| 1668 (count 0) | |
| 1669 (children (mapcar (lambda (entry) | |
| 1670 (widget-insert "\n") | |
| 1671 (message "Creating group members... %2d%%" | |
| 1672 (/ (* 100.0 count) length)) | |
| 1673 (setq count (1+ count)) | |
| 1674 (prog1 | |
| 1675 (widget-create-child-and-convert | |
| 1676 widget (nth 1 entry) | |
| 1677 :group widget | |
| 1678 :tag (custom-unlispify-tag-name | |
| 1679 (nth 0 entry)) | |
| 1680 :custom-prefixes custom-prefix-list | |
| 1681 :custom-level (1+ level) | |
| 1682 :value (nth 0 entry)) | |
| 1683 (unless (eq (preceding-char) ?\n) | |
| 1684 (widget-insert "\n")))) | |
| 1685 members))) | |
| 1686 (message "Creating group magic...") | |
| 1687 (mapcar 'custom-magic-reset children) | |
| 1688 (message "Creating group state...") | |
| 1689 (widget-put widget :children children) | |
| 1690 (custom-group-state-update widget) | |
| 1691 (message "Creating group... done"))))) | |
| 1692 | |
| 1693 (defvar custom-group-menu | |
| 1694 '(("Set" . custom-group-set) | |
| 1695 ("Save" . custom-group-save) | |
| 1696 ("Reset to Current" . custom-group-reset-current) | |
| 1697 ("Reset to Saved" . custom-group-reset-saved) | |
| 1698 ("Reset to Factory" . custom-group-reset-factory)) | |
| 1699 "Alist of actions for the `custom-group' widget. | |
| 1700 The key is a string containing the name of the action, the value is a | |
| 1701 lisp function taking the widget as an element which will be called | |
| 1702 when the action is chosen.") | |
| 1703 | |
| 1704 (defun custom-group-action (widget &optional event) | |
| 1705 "Show the menu for `custom-group' WIDGET. | |
| 1706 Optional EVENT is the location for the menu." | |
| 1707 (if (eq (widget-get widget :custom-state) 'hidden) | |
| 1708 (progn | |
| 1709 (widget-put widget :custom-state 'unknown) | |
| 1710 (custom-redraw widget)) | |
| 1711 (let* ((completion-ignore-case t) | |
| 1712 (answer (widget-choose (custom-unlispify-tag-name | |
| 1713 (widget-get widget :value)) | |
| 1714 custom-group-menu | |
| 1715 event))) | |
| 1716 (if answer | |
| 1717 (funcall answer widget))))) | |
| 1718 | |
| 1719 (defun custom-group-set (widget) | |
| 1720 "Set changes in all modified group members." | |
| 1721 (let ((children (widget-get widget :children))) | |
| 1722 (mapcar (lambda (child) | |
| 1723 (when (eq (widget-get child :custom-state) 'modified) | |
| 1724 (widget-apply child :custom-set))) | |
| 1725 children ))) | |
| 1726 | |
| 1727 (defun custom-group-save (widget) | |
| 1728 "Save all modified group members." | |
| 1729 (let ((children (widget-get widget :children))) | |
| 1730 (mapcar (lambda (child) | |
| 1731 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 1732 (widget-apply child :custom-save))) | |
| 1733 children ))) | |
| 1734 | |
| 1735 (defun custom-group-reset-current (widget) | |
| 1736 "Reset all modified group members." | |
| 1737 (let ((children (widget-get widget :children))) | |
| 1738 (mapcar (lambda (child) | |
| 1739 (when (eq (widget-get child :custom-state) 'modified) | |
| 1740 (widget-apply child :custom-reset-current))) | |
| 1741 children ))) | |
| 1742 | |
| 1743 (defun custom-group-reset-saved (widget) | |
| 1744 "Reset all modified or set group members." | |
| 1745 (let ((children (widget-get widget :children))) | |
| 1746 (mapcar (lambda (child) | |
| 1747 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 1748 (widget-apply child :custom-reset-saved))) | |
| 1749 children ))) | |
| 1750 | |
| 1751 (defun custom-group-reset-factory (widget) | |
| 1752 "Reset all modified, set, or saved group members." | |
| 1753 (let ((children (widget-get widget :children))) | |
| 1754 (mapcar (lambda (child) | |
| 1755 (when (memq (widget-get child :custom-state) | |
| 1756 '(modified set saved)) | |
| 1757 (widget-apply child :custom-reset-factory))) | |
| 1758 children ))) | |
| 1759 | |
| 1760 (defun custom-group-state-update (widget) | |
| 1761 "Update magic." | |
| 1762 (unless (eq (widget-get widget :custom-state) 'hidden) | |
| 1763 (let* ((children (widget-get widget :children)) | |
| 1764 (states (mapcar (lambda (child) | |
| 1765 (widget-get child :custom-state)) | |
| 1766 children)) | |
| 1767 (magics custom-magic-alist) | |
| 1768 (found 'factory)) | |
| 1769 (while magics | |
| 1770 (let ((magic (car (car magics)))) | |
| 1771 (if (and (not (eq magic 'hidden)) | |
| 1772 (memq magic states)) | |
| 1773 (setq found magic | |
| 1774 magics nil) | |
| 1775 (setq magics (cdr magics))))) | |
| 1776 (widget-put widget :custom-state found))) | |
| 1777 (custom-magic-reset widget)) | |
| 1778 | |
| 1779 ;;; The `custom-save-all' Function. | |
| 1780 | |
| 1781 (defcustom custom-file "~/.emacs" | |
| 1782 "File used for storing customization information. | |
| 1783 If you change this from the default \"~/.emacs\" you need to | |
| 1784 explicitly load that file for the settings to take effect." | |
| 1785 :type 'file | |
| 1786 :group 'customize) | |
| 1787 | |
| 1788 (defun custom-save-delete (symbol) | |
| 1789 "Delete the call to SYMBOL form `custom-file'. | |
| 1790 Leave point at the location of the call, or after the last expression." | |
| 1791 (set-buffer (find-file-noselect custom-file)) | |
| 1792 (goto-char (point-min)) | |
| 1793 (catch 'found | |
| 1794 (while t | |
| 1795 (let ((sexp (condition-case nil | |
| 1796 (read (current-buffer)) | |
| 1797 (end-of-file (throw 'found nil))))) | |
| 1798 (when (and (listp sexp) | |
| 1799 (eq (car sexp) symbol)) | |
| 1800 (delete-region (save-excursion | |
| 1801 (backward-sexp) | |
| 1802 (point)) | |
| 1803 (point)) | |
| 1804 (throw 'found nil)))))) | |
| 1805 | |
| 1806 (defun custom-save-variables () | |
| 1807 "Save all customized variables in `custom-file'." | |
| 1808 (save-excursion | |
| 1809 (custom-save-delete 'custom-set-variables) | |
| 1810 (let ((standard-output (current-buffer))) | |
| 1811 (unless (bolp) | |
| 1812 (princ "\n")) | |
| 1813 (princ "(custom-set-variables") | |
| 1814 (mapatoms (lambda (symbol) | |
| 1815 (let ((value (get symbol 'saved-value))) | |
| 1816 (when value | |
| 1817 (princ "\n '(") | |
| 1818 (princ symbol) | |
| 1819 (princ " ") | |
| 1820 (prin1 (car value)) | |
| 1821 (if (or (get symbol 'factory-value) | |
| 1822 (and (not (boundp symbol)) | |
| 1823 (not (get symbol 'force-value)))) | |
| 1824 (princ ")") | |
| 1825 (princ " t)")))))) | |
| 1826 (princ ")") | |
| 1827 (unless (looking-at "\n") | |
| 1828 (princ "\n"))))) | |
| 1829 | |
| 1830 (defun custom-save-faces () | |
| 1831 "Save all customized faces in `custom-file'." | |
| 1832 (save-excursion | |
| 1833 (custom-save-delete 'custom-set-faces) | |
| 1834 (let ((standard-output (current-buffer))) | |
| 1835 (unless (bolp) | |
| 1836 (princ "\n")) | |
| 1837 (princ "(custom-set-faces") | |
| 1838 (mapatoms (lambda (symbol) | |
| 1839 (let ((value (get symbol 'saved-face))) | |
| 1840 (when value | |
| 1841 (princ "\n '(") | |
| 1842 (princ symbol) | |
| 1843 (princ " ") | |
| 1844 (prin1 value) | |
| 1845 (if (or (get symbol 'factory-face) | |
| 1846 (and (not (custom-facep symbol)) | |
| 1847 (not (get symbol 'force-face)))) | |
| 1848 (princ ")") | |
| 1849 (princ " t)")))))) | |
| 1850 (princ ")") | |
| 1851 (unless (looking-at "\n") | |
| 1852 (princ "\n"))))) | |
| 1853 | |
| 1854 ;;;###autoload | |
| 1855 (defun custom-save-all () | |
| 1856 "Save all customizations in `custom-file'." | |
| 1857 (custom-save-variables) | |
| 1858 (custom-save-faces) | |
| 1859 (save-excursion | |
| 1860 (set-buffer (find-file-noselect custom-file)) | |
| 1861 (save-buffer))) | |
| 1862 | |
| 1863 ;;; The Customize Menu. | |
| 1864 | |
| 1865 (defcustom custom-menu-nesting 2 | |
| 1866 "Maximum nesting in custom menus." | |
| 1867 :type 'integer | |
| 1868 :group 'customize) | |
| 1869 | |
| 1870 (defun custom-face-menu-create (widget symbol) | |
| 1871 "Ignoring WIDGET, create a menu entry for customization face SYMBOL." | |
| 1872 (vector (custom-unlispify-menu-entry symbol) | |
| 1873 `(custom-buffer-create '((,symbol custom-face))) | |
| 1874 t)) | |
| 1875 | |
| 1876 (defun custom-variable-menu-create (widget symbol) | |
| 1877 "Ignoring WIDGET, create a menu entry for customization variable SYMBOL." | |
| 1878 (let ((type (get symbol 'custom-type))) | |
| 1879 (unless (listp type) | |
| 1880 (setq type (list type))) | |
| 1881 (if (and type (widget-get type :custom-menu)) | |
| 1882 (widget-apply type :custom-menu symbol) | |
| 1883 (vector (custom-unlispify-menu-entry symbol) | |
| 1884 `(custom-buffer-create '((,symbol custom-variable))) | |
| 1885 t)))) | |
| 1886 | |
| 1887 (widget-put (get 'boolean 'widget-type) | |
| 1888 :custom-menu (lambda (widget symbol) | |
| 1889 (vector (custom-unlispify-menu-entry symbol) | |
| 1890 `(custom-buffer-create | |
| 1891 '((,symbol custom-variable))) | |
| 1892 ':style 'toggle | |
| 1893 ':selected symbol))) | |
| 1894 | |
| 1895 (if (string-match "XEmacs" emacs-version) | |
| 1896 ;; XEmacs can create menus dynamically. | |
| 1897 (defun custom-group-menu-create (widget symbol) | |
| 1898 "Ignoring WIDGET, create a menu entry for customization group SYMBOL." | |
| 1899 `( ,(custom-unlispify-menu-entry symbol t) | |
| 1900 :filter (lambda (&rest junk) | |
| 1901 (cdr (custom-menu-create ',symbol))))) | |
| 1902 ;; But emacs can't. | |
| 1903 (defun custom-group-menu-create (widget symbol) | |
| 1904 "Ignoring WIDGET, create a menu entry for customization group SYMBOL." | |
| 1905 ;; Limit the nesting. | |
| 1906 (let ((custom-menu-nesting (1- custom-menu-nesting))) | |
| 1907 (custom-menu-create symbol)))) | |
| 1908 | |
| 1909 (defun custom-menu-create (symbol &optional name) | |
| 1910 "Create menu for customization group SYMBOL. | |
| 1911 If optional NAME is given, use that as the name of the menu. | |
| 1912 Otherwise make up a name from SYMBOL. | |
| 1913 The menu is in a format applicable to `easy-menu-define'." | |
| 1914 (unless name | |
| 1915 (setq name (custom-unlispify-menu-entry symbol))) | |
| 1916 (let ((item (vector name | |
| 1917 `(custom-buffer-create '((,symbol custom-group))) | |
| 1918 t))) | |
| 1919 (if (and (>= custom-menu-nesting 0) | |
| 1920 (< (length (get symbol 'custom-group)) widget-menu-max-size)) | |
| 1921 (let ((custom-prefix-list (custom-prefix-add symbol | |
| 1922 custom-prefix-list))) | |
| 1923 (custom-load-symbol symbol) | |
| 1924 `(,(custom-unlispify-menu-entry symbol t) | |
| 1925 ,item | |
| 1926 "--" | |
| 1927 ,@(mapcar (lambda (entry) | |
| 1928 (widget-apply (if (listp (nth 1 entry)) | |
| 1929 (nth 1 entry) | |
| 1930 (list (nth 1 entry))) | |
| 1931 :custom-menu (nth 0 entry))) | |
| 1932 (get symbol 'custom-group)))) | |
| 1933 item))) | |
| 1934 | |
| 1935 ;;;###autoload | |
| 1936 (defun custom-menu-update (event) | |
| 1937 "Update customize menu." | |
| 1938 (interactive "e") | |
| 1939 (add-hook 'custom-define-hook 'custom-menu-reset) | |
| 1940 (let* ((emacs (widget-apply '(custom-group) :custom-menu 'emacs)) | |
| 1941 (menu `(,(car custom-help-menu) | |
| 1942 ,emacs | |
| 1943 ,@(cdr (cdr custom-help-menu))))) | |
| 1944 (let ((map (easy-menu-create-keymaps (car menu) (cdr menu)))) | |
| 1945 (define-key global-map [menu-bar help-menu customize-menu] | |
| 1946 (cons (car menu) map))))) | |
| 1947 | |
| 1948 ;;; Dependencies. | |
| 1949 | |
| 1950 ;;;###autoload | |
| 1951 (defun custom-make-dependencies () | |
| 1952 "Batch function to extract custom dependencies from .el files. | |
| 1953 Usage: emacs -batch *.el -f custom-make-dependencies > deps.el" | |
| 1954 (let ((buffers (buffer-list))) | |
| 1955 (while buffers | |
| 1956 (set-buffer (car buffers)) | |
| 1957 (setq buffers (cdr buffers)) | |
| 1958 (let ((file (buffer-file-name))) | |
| 1959 (when (and file (string-match "\\`\\(.*\\)\\.el\\'" file)) | |
| 1960 (goto-char (point-min)) | |
| 1961 (condition-case nil | |
| 1962 (let ((name (file-name-nondirectory (match-string 1 file)))) | |
| 1963 (while t | |
| 1964 (let ((expr (read (current-buffer)))) | |
| 1965 (when (and (listp expr) | |
| 1966 (memq (car expr) '(defcustom defface defgroup))) | |
| 1967 (eval expr) | |
| 1968 (put (nth 1 expr) 'custom-where name))))) | |
| 1969 (error nil)))))) | |
| 1970 (mapatoms (lambda (symbol) | |
| 1971 (let ((members (get symbol 'custom-group)) | |
| 1972 item where found) | |
| 1973 (when members | |
| 1974 (princ "(put '") | |
| 1975 (princ symbol) | |
| 1976 (princ " 'custom-loads '(") | |
| 1977 (while members | |
| 1978 (setq item (car (car members)) | |
| 1979 members (cdr members) | |
| 1980 where (get item 'custom-where)) | |
| 1981 (unless (or (null where) | |
| 1982 (member where found)) | |
| 1983 (when found | |
| 1984 (princ " ")) | |
| 1985 (prin1 where) | |
| 1986 (push where found))) | |
| 1987 (princ "))\n")))))) | |
| 1988 | |
| 1989 ;;; The End. | |
| 1990 | |
| 1991 (provide 'cus-edit) | |
| 1992 | |
| 1993 ;; cus-edit.el ends here |