Mercurial > hg > xemacs-beta
annotate lisp/cus-edit.el @ 5645:5d3bb1100832
Remove some utility functions from the global namespace, lisp/
lisp/ChangeLog addition:
2012-04-07 Aidan Kehoe <kehoea@parhasard.net>
Remove some utility functions from the global namespace, it's more
appropriate to have them as labels (that is, lexically-visible
functions.)
* behavior.el:
* behavior.el (behavior-menu-filter-1): Moved to being a label.
* behavior.el (behavior-menu-filter): Use the label.
* cus-edit.el (custom-load-symbol-1): Moved to being a label.
* cus-edit.el (custom-load-symbol): Use the label.
* menubar.el (find-menu-item-1): Moved to being a label.
* menubar.el (find-menu-item): Use the label.
* window-xemacs.el:
* window-xemacs.el (display-buffer-1): Moved to being a label.
* window-xemacs.el (display-buffer): Use the label; use (block
...) instead of (catch ...), use prog1 instead of needlessly
binding a variable.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Sat, 07 Apr 2012 21:57:31 +0100 |
| parents | 4dee0387b9de |
| children | cc6f0266bc36 |
| rev | line source |
|---|---|
| 428 | 1 ;;; cus-edit.el --- Tools for customizating Emacs and Lisp packages. |
| 2 ;; | |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3 ;; Copyright (C) 2007, 2008 Didier Verna |
| 4178 | 4 ;; Copyright (C) 2003 Ben Wing |
| 438 | 5 ;; Copyright (C) 1996, 1997, 2000 Free Software Foundation, Inc. |
| 428 | 6 ;; |
| 7 ;; Author: Per Abrahamsen <abraham@dina.kvl.dk> | |
| 4178 | 8 ;; Maintainer: Didier Verna <didier@xemacs.org> |
| 428 | 9 ;; Keywords: help, faces |
| 10 ;; Version: 1.9960-x | |
| 11 ;; X-URL: http://www.dina.kvl.dk/~abraham/custom/ | |
| 12 | |
| 13 ;; This file is part of XEmacs. | |
| 14 | |
|
5402
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
15 ;; XEmacs is free software: you can redistribute it and/or modify it |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
16 ;; under the terms of the GNU General Public License as published by the |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
17 ;; Free Software Foundation, either version 3 of the License, or (at your |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
18 ;; option) any later version. |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
19 |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
20 ;; XEmacs is distributed in the hope that it will be useful, but WITHOUT |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
21 ;; ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
22 ;; FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
23 ;; for more details. |
| 428 | 24 |
| 25 ;; You should have received a copy of the GNU General Public License | |
|
5402
308d34e9f07d
Changed bulk of GPLv2 or later files identified by script
Mats Lidell <matsl@xemacs.org>
parents:
4806
diff
changeset
|
26 ;; along with XEmacs. If not, see <http://www.gnu.org/licenses/>. |
| 428 | 27 |
| 28 ;;; Commentary: | |
| 29 ;; | |
| 30 ;; This file implements the code to create and edit customize buffers. | |
| 31 ;; | |
| 32 ;; See `custom.el'. | |
| 33 | |
| 34 ;; No commands should have names starting with `custom-' because | |
| 35 ;; that interferes with completion. Use `customize-' for commands | |
| 36 ;; that the user will run with M-x, and `Custom-' for interactive commands. | |
| 37 | |
| 38 ;; NOTE: In many places within this file we use `mapatoms', which is | |
| 39 ;; very slow in an average XEmacs because of the large number of | |
| 40 ;; symbols requiring a large number of funcalls -- XEmacs with Gnus | |
| 41 ;; can grow to some 17000 symbols without ever doing anything fancy. | |
| 42 ;; It would probably pay off to make a hash table of symbols known to | |
| 43 ;; Custom, similar to custom-group-hash-table. | |
| 44 | |
| 45 ;; This is not top priority, because none of the functions that do | |
| 46 ;; mapatoms are speed-critical (the one that was now uses | |
| 47 ;; custom-group-hash-table), but it would be nice to have. | |
| 48 | |
| 49 | |
| 50 ;;; Code: | |
| 51 | |
| 52 (require 'cus-face) | |
| 53 (require 'wid-edit) | |
| 54 (require 'easymenu) | |
| 55 | |
| 56 (require 'cus-load) | |
| 57 (require 'cus-start) | |
| 442 | 58 (require 'cus-file) |
| 428 | 59 |
| 60 ;; Huh? This looks dirty! | |
| 61 (put 'custom-define-hook 'custom-type 'hook) | |
| 62 (put 'custom-define-hook 'standard-value '(nil)) | |
| 63 (custom-add-to-group 'customize 'custom-define-hook 'custom-variable) | |
| 64 | |
| 65 ;;; Customization Groups. | |
| 66 | |
| 67 (defgroup emacs nil | |
| 68 "Customization of the One True Editor." | |
| 69 :link '(custom-manual "(XEmacs)Top")) | |
| 70 | |
| 71 ;; Most of these groups are stolen from `finder.el', | |
| 72 (defgroup editing nil | |
| 73 "Basic text editing facilities." | |
| 74 :group 'emacs) | |
| 75 | |
| 76 (defgroup matching nil | |
| 77 "Various sorts of searching and matching." | |
| 78 :group 'editing) | |
| 79 | |
| 80 (defgroup emulations nil | |
| 81 "Emulations of other editors." | |
| 82 :group 'editing) | |
| 83 | |
| 84 (defgroup outlines nil | |
| 85 "Support for hierarchical outlining." | |
| 86 :group 'editing) | |
| 87 | |
| 88 (defgroup external nil | |
| 89 "Interfacing to external utilities." | |
| 90 :group 'emacs) | |
| 91 | |
| 92 (defgroup bib nil | |
| 93 "Code related to the `bib' bibliography processor." | |
| 94 :tag "Bibliography" | |
| 95 :group 'external) | |
| 96 | |
| 97 (defgroup programming nil | |
| 98 "Support for programming in other languages." | |
| 99 :group 'emacs) | |
| 100 | |
| 101 (defgroup languages nil | |
| 102 "Specialized modes for editing programming languages." | |
| 103 :group 'programming) | |
| 104 | |
| 105 ;; #### This should be in cc-vars.el | |
| 106 (defgroup c nil | |
| 107 "Support for the C language and related languages." | |
| 108 :group 'languages) | |
| 109 | |
| 110 (defgroup tools nil | |
| 111 "Programming tools." | |
| 112 :group 'programming) | |
| 113 | |
| 114 (defgroup oop nil | |
| 115 "Support for object-oriented programming." | |
| 116 :group 'programming) | |
| 117 | |
| 118 (defgroup applications nil | |
| 119 "Applications written in Emacs." | |
| 120 :group 'emacs) | |
| 121 | |
| 122 ;; #### This should be in calendar.el | |
| 123 (defgroup calendar nil | |
| 124 "Calendar and time management support." | |
| 125 :group 'applications) | |
| 126 | |
| 127 (defgroup mail nil | |
| 128 "Modes for electronic-mail handling." | |
| 129 :group 'applications) | |
| 130 | |
| 131 (defgroup news nil | |
| 132 "Support for netnews reading and posting." | |
| 133 :group 'applications) | |
| 134 | |
| 135 (defgroup games nil | |
| 136 "Games, jokes and amusements." | |
| 137 :group 'applications) | |
| 138 | |
| 139 (defgroup development nil | |
| 140 "Support for further development of Emacs." | |
| 141 :group 'emacs) | |
| 142 | |
| 143 (defgroup docs nil | |
| 144 "Support for Emacs documentation." | |
| 145 :group 'development) | |
| 146 | |
| 147 (defgroup extensions nil | |
| 148 "Emacs Lisp language extensions." | |
| 149 :group 'development) | |
| 150 | |
| 151 (defgroup internal nil | |
| 152 "Code for Emacs internals, build process, defaults." | |
| 153 :group 'development) | |
| 154 | |
| 155 (defgroup maint nil | |
| 156 "Maintenance aids for the Emacs development group." | |
| 157 :tag "Maintenance" | |
| 158 :group 'development) | |
| 159 | |
| 160 (defgroup environment nil | |
| 161 "Fitting Emacs with its environment." | |
| 162 :group 'emacs) | |
| 163 | |
| 164 (defgroup comm nil | |
| 165 "Communications, networking, remote access to files." | |
| 166 :tag "Communication" | |
| 167 :group 'environment) | |
| 168 | |
| 169 (defgroup hardware nil | |
| 170 "Support for interfacing with exotic hardware." | |
| 171 :group 'environment) | |
| 172 | |
| 173 (defgroup terminals nil | |
| 174 "Support for terminal types." | |
| 175 :group 'environment) | |
| 176 | |
| 177 (defgroup unix nil | |
| 178 "Front-ends/assistants for, or emulators of, UNIX features." | |
| 179 :group 'environment) | |
| 180 | |
| 181 (defgroup i18n nil | |
| 182 "Internationalization and alternate character-set support." | |
| 183 :group 'environment | |
| 184 :group 'editing) | |
| 185 | |
| 186 (defgroup data nil | |
| 187 "Support editing files of data." | |
| 188 :group 'emacs) | |
| 189 | |
| 190 (defgroup wp nil | |
| 191 "Word processing." | |
| 192 :group 'emacs) | |
| 193 | |
| 194 (defgroup tex nil | |
| 195 "Code related to the TeX formatter." | |
| 196 :group 'wp) | |
| 197 | |
| 198 (defgroup hypermedia nil | |
| 199 "Support for links between text or other media types." | |
| 200 :group 'emacs) | |
| 201 | |
| 202 (defgroup local nil | |
| 203 "Code local to your site." | |
| 204 :group 'emacs) | |
| 205 | |
| 206 (defgroup customize '((widgets custom-group)) | |
| 207 "Customization of the Customization support." | |
| 208 :link '(custom-manual "(custom)Top") | |
| 209 :link '(url-link :tag "Development Page" | |
| 210 "http://www.dina.kvl.dk/~abraham/custom/") | |
| 211 :prefix "custom-" | |
| 212 :group 'help) | |
| 213 | |
| 214 (defgroup custom-faces nil | |
| 215 "Faces used by customize." | |
| 216 :group 'customize | |
| 217 :group 'faces) | |
| 218 | |
| 219 (defgroup custom-browse nil | |
| 220 "Control customize browser." | |
| 221 :prefix "custom-" | |
| 222 :group 'customize) | |
| 223 | |
| 224 (defgroup custom-buffer nil | |
| 225 "Control customize buffers." | |
| 226 :prefix "custom-" | |
| 227 :group 'customize) | |
| 228 | |
| 229 (defgroup custom-menu nil | |
| 230 "Control customize menus." | |
| 231 :prefix "custom-" | |
| 232 :group 'customize) | |
| 233 | |
| 234 (defgroup alloc nil | |
| 613 | 235 "Storage allocation and gc for XEmacs Lisp interpreter." |
| 428 | 236 :tag "Storage Allocation" |
| 237 :group 'internal) | |
| 238 | |
| 239 (defgroup undo nil | |
| 240 "Undoing changes in buffers." | |
| 241 :group 'editing) | |
| 242 | |
| 243 (defgroup editing-basics nil | |
| 244 "Most basic editing facilities." | |
| 245 :group 'editing) | |
| 246 | |
| 247 (defgroup display nil | |
| 248 "How characters are displayed in buffers." | |
| 249 :group 'environment) | |
| 250 | |
| 251 (defgroup installation nil | |
| 252 "The Emacs installation." | |
| 253 :group 'environment) | |
| 254 | |
| 255 (defgroup limits nil | |
| 256 "Internal Emacs limits." | |
| 257 :group 'internal) | |
| 258 | |
| 259 (defgroup debug nil | |
| 260 "Debugging Emacs itself." | |
| 261 :group 'development) | |
| 262 | |
| 263 (defgroup mule nil | |
| 264 "Mule XEmacs internationalization." | |
| 265 :group 'i18n) | |
| 266 | |
| 267 | |
| 268 ;;; Utilities. | |
| 269 | |
| 270 (defun custom-split-regexp-maybe (regexp) | |
| 271 "If REGEXP is a string, split it to a list at `\\|'. | |
| 272 You can get the original back with from the result with: | |
| 273 (mapconcat #'identity result \"\\|\") | |
| 274 | |
| 275 IF REGEXP is not a string, return it unchanged." | |
| 276 (if (stringp regexp) | |
| 277 (split-string regexp "\\\\|") | |
| 278 regexp)) | |
| 279 | |
| 280 (defun custom-variable-prompt () | |
| 281 ;; Code stolen from `help.el'. | |
| 282 "Prompt for a variable, defaulting to the variable at point. | |
| 283 Return a list suitable for use in `interactive'." | |
| 284 (let ((v (variable-at-point)) | |
| 285 (enable-recursive-minibuffers t) | |
| 286 val) | |
| 287 (setq val (completing-read | |
|
4701
684f0ed6cd4f
Behave better when #'variable-at-point gives nil, #'custom-variable-prompt.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4628
diff
changeset
|
288 (if (and v (symbolp v)) |
| 428 | 289 (format "Customize variable: (default %s) " v) |
| 290 "Customize variable: ") | |
| 291 obarray (lambda (symbol) | |
| 292 (and (boundp symbol) | |
| 293 (or (get symbol 'custom-type) | |
| 476 | 294 (user-variable-p symbol)))) |
| 4178 | 295 t nil nil (and v (symbol-name v)))) |
| 428 | 296 (list (if (equal val "") |
| 297 (if (symbolp v) v nil) | |
| 298 (intern val))))) | |
| 299 | |
| 300 ;; Here we take not only the actual groups, but the loads, too. | |
| 301 (defun custom-group-prompt (prompt) | |
| 302 "Read group from minibuffer." | |
| 303 (let ((completion-ignore-case t)) | |
| 304 (list (completing-read | |
| 305 prompt obarray | |
| 306 (lambda (symbol) | |
| 307 (or (get symbol 'custom-group) | |
| 308 (get symbol 'custom-loads))) | |
| 309 t)))) | |
| 310 | |
| 311 (defun custom-menu-filter (menu widget) | |
| 312 "Convert MENU to the form used by `widget-choose'. | |
| 313 MENU should be in the same format as `custom-variable-menu'. | |
| 314 WIDGET is the widget to apply the filter entries of MENU on." | |
| 315 (let ((result nil) | |
| 316 current name action filter) | |
| 317 (while menu | |
| 318 (setq current (car menu) | |
| 319 name (nth 0 current) | |
| 320 action (nth 1 current) | |
| 321 filter (nth 2 current) | |
| 322 menu (cdr menu)) | |
| 323 (if (or (null filter) (funcall filter widget)) | |
| 324 (push (cons name action) result) | |
| 325 (push name result))) | |
| 326 (nreverse result))) | |
| 327 | |
| 328 | |
| 329 ;;; Unlispify. | |
| 330 | |
| 331 (defvar custom-prefix-list nil | |
| 332 "List of prefixes that should be ignored by `custom-unlispify'") | |
| 333 | |
| 848 | 334 (defcustom custom-save-pretty-print t |
| 335 "Non-nil means pretty-print values of customized variables if available." | |
| 336 :group 'customize | |
| 337 :type 'boolean) | |
| 338 | |
| 339 | |
| 428 | 340 (defcustom custom-unlispify-menu-entries t |
| 341 "Display menu entries as words instead of symbols if non nil." | |
| 342 :group 'custom-menu | |
| 343 :type 'boolean) | |
| 344 | |
| 345 (defcustom custom-unlispify-remove-prefixes t | |
| 346 "Non-nil means remove group prefixes from option names in buffers and menus. | |
| 347 This only has an effect when `custom-unlispify-tag-names' or | |
| 348 `custom-unlispify-menu-entries' is on." | |
| 349 :group 'custom-menu | |
| 350 :type 'boolean) | |
| 351 | |
| 352 (defun custom-unlispify-menu-entry (symbol &optional no-suffix) | |
| 353 "Convert symbol into a menu entry." | |
| 354 (cond ((not custom-unlispify-menu-entries) | |
| 355 (symbol-name symbol)) | |
| 356 ((get symbol 'custom-tag) | |
| 357 (if no-suffix | |
| 358 (get symbol 'custom-tag) | |
| 359 (concat (get symbol 'custom-tag) "..."))) | |
| 360 (t | |
| 361 (with-current-buffer (get-buffer-create " *Custom-Work*") | |
| 362 (erase-buffer) | |
| 363 (princ symbol (current-buffer)) | |
| 364 (goto-char (point-min)) | |
| 365 (when (and (eq (get symbol 'custom-type) 'boolean) | |
| 366 (re-search-forward "-p\\'" nil t)) | |
| 367 (replace-match "" t t) | |
| 368 (goto-char (point-min))) | |
| 369 (when custom-unlispify-remove-prefixes | |
| 370 (let ((prefixes custom-prefix-list) | |
| 371 prefix) | |
| 372 (while prefixes | |
| 373 (setq prefix (car prefixes)) | |
| 374 (if (search-forward prefix (+ (point) (length prefix)) t) | |
| 375 (progn | |
| 376 (setq prefixes nil) | |
| 377 (delete-region (point-min) (point))) | |
| 378 (setq prefixes (cdr prefixes)))))) | |
| 379 (subst-char-in-region (point-min) (point-max) ?- ?\ t) | |
| 380 (capitalize-region (point-min) (point-max)) | |
| 381 (unless no-suffix | |
| 382 (goto-char (point-max)) | |
| 383 (insert "...")) | |
| 384 (buffer-string))))) | |
| 385 | |
| 386 (defcustom custom-unlispify-tag-names t | |
| 387 "Display tag names as words instead of symbols if non nil." | |
| 388 :group 'custom-buffer | |
| 389 :type 'boolean) | |
| 390 | |
| 391 (defun custom-unlispify-tag-name (symbol) | |
| 392 "Convert symbol into a menu entry." | |
| 393 (let ((custom-unlispify-menu-entries custom-unlispify-tag-names)) | |
| 394 (custom-unlispify-menu-entry symbol t))) | |
| 395 | |
| 396 (defun custom-prefix-add (symbol prefixes) | |
| 440 | 397 ;; Add SYMBOL to list of ignored PREFIXES. |
| 428 | 398 (cons (or (get symbol 'custom-prefix) |
| 399 (concat (symbol-name symbol) "-")) | |
| 400 prefixes)) | |
| 401 | |
| 402 | |
| 403 ;;; Guess. | |
| 404 | |
| 405 (defcustom custom-guess-name-alist | |
| 406 '(("-p\\'" boolean) | |
| 407 ("-hooks?\\'" hook) | |
| 408 ("-face\\'" face) | |
| 409 ("-file\\'" file) | |
| 410 ("-function\\'" function) | |
| 411 ("-functions\\'" (repeat function)) | |
| 412 ("-list\\'" (repeat sexp)) | |
| 413 ("-alist\\'" (repeat (cons sexp sexp)))) | |
| 414 "Alist of (MATCH TYPE). | |
| 415 | |
| 416 MATCH should be a regexp matching the name of a symbol, and TYPE should | |
| 417 be a widget suitable for editing the value of that symbol. The TYPE | |
| 418 of the first entry where MATCH matches the name of the symbol will be | |
| 419 used. | |
| 420 | |
| 421 This is used for guessing the type of variables not declared with | |
| 422 customize." | |
| 423 :type '(repeat (group (regexp :tag "Match") (sexp :tag "Type"))) | |
| 424 :group 'customize) | |
| 425 | |
| 426 (defcustom custom-guess-doc-alist | |
| 427 '(("\\`\\*?Non-nil " boolean)) | |
| 428 "Alist of (MATCH TYPE). | |
| 429 | |
| 430 MATCH should be a regexp matching a documentation string, and TYPE | |
| 431 should be a widget suitable for editing the value of a variable with | |
| 432 that documentation string. The TYPE of the first entry where MATCH | |
| 433 matches the name of the symbol will be used. | |
| 434 | |
| 435 This is used for guessing the type of variables not declared with | |
| 436 customize." | |
| 437 :type '(repeat (group (regexp :tag "Match") (sexp :tag "Type"))) | |
| 438 :group 'customize) | |
| 439 | |
| 440 (defun custom-guess-type (symbol) | |
| 441 "Guess a widget suitable for editing the value of SYMBOL. | |
| 442 This is done by matching SYMBOL with `custom-guess-name-alist' and | |
| 443 if that fails, the doc string with `custom-guess-doc-alist'." | |
| 444 (let ((name (symbol-name symbol)) | |
| 445 (names custom-guess-name-alist) | |
| 446 current found) | |
| 447 (while names | |
| 448 (setq current (car names) | |
| 449 names (cdr names)) | |
| 450 (when (string-match (nth 0 current) name) | |
| 451 (setq found (nth 1 current) | |
| 452 names nil))) | |
| 453 (unless found | |
| 454 (let ((doc (documentation-property symbol 'variable-documentation)) | |
| 455 (docs custom-guess-doc-alist)) | |
| 456 (when doc | |
| 457 (while docs | |
| 458 (setq current (car docs) | |
| 459 docs (cdr docs)) | |
| 460 (when (string-match (nth 0 current) doc) | |
| 461 (setq found (nth 1 current) | |
| 462 docs nil)))))) | |
| 463 found)) | |
| 464 | |
| 465 | |
| 466 ;;; Sorting. | |
| 467 | |
| 468 (defcustom custom-browse-sort-alphabetically nil | |
| 469 "If non-nil, sort members of each customization group alphabetically." | |
| 470 :type 'boolean | |
| 471 :group 'custom-browse) | |
| 472 | |
| 473 (defcustom custom-browse-order-groups nil | |
| 474 "If non-nil, order group members within each customization group. | |
| 475 If `first', order groups before non-groups. | |
| 476 If `last', order groups after non-groups." | |
| 477 :type '(choice (const first) | |
| 478 (const last) | |
| 479 (const :tag "none" nil)) | |
| 480 :group 'custom-browse) | |
| 481 | |
| 482 (defcustom custom-browse-only-groups nil | |
| 483 "If non-nil, show group members only within each customization group." | |
| 484 :type 'boolean | |
| 485 :group 'custom-browse) | |
| 486 | |
| 487 (defcustom custom-buffer-sort-alphabetically nil | |
| 488 "If non-nil, sort members of each customization group alphabetically." | |
| 489 :type 'boolean | |
| 490 :group 'custom-buffer) | |
| 491 | |
| 492 (defcustom custom-buffer-order-groups 'last | |
| 493 "If non-nil, order group members within each customization group. | |
| 494 If `first', order groups before non-groups. | |
| 495 If `last', order groups after non-groups." | |
| 496 :type '(choice (const first) | |
| 497 (const last) | |
| 498 (const :tag "none" nil)) | |
| 499 :group 'custom-buffer) | |
| 500 | |
| 501 (defcustom custom-menu-sort-alphabetically nil | |
| 502 "If non-nil, sort members of each customization group alphabetically." | |
| 503 :type 'boolean | |
| 504 :group 'custom-menu) | |
| 505 | |
| 506 (defcustom custom-menu-order-groups 'first | |
| 507 "If non-nil, order group members within each customization group. | |
| 508 If `first', order groups before non-groups. | |
| 509 If `last', order groups after non-groups." | |
| 510 :type '(choice (const first) | |
| 511 (const last) | |
| 512 (const :tag "none" nil)) | |
| 513 :group 'custom-menu) | |
| 514 | |
| 515 (defun custom-sort-items (items sort-alphabetically order-groups) | |
| 516 "Return a sorted copy of ITEMS. | |
| 517 ITEMS should be a `custom-group' property. | |
| 518 If SORT-ALPHABETICALLY non-nil, sort alphabetically. | |
| 519 If ORDER-GROUPS is `first' order groups before non-groups, if `last' order | |
| 520 groups after non-groups, if nil do not order groups at all." | |
| 521 (sort (copy-sequence items) | |
| 522 (lambda (a b) | |
| 523 (let ((typea (nth 1 a)) (typeb (nth 1 b)) | |
| 524 (namea (symbol-name (nth 0 a))) (nameb (symbol-name (nth 0 b)))) | |
| 525 (cond ((not order-groups) | |
| 526 ;; Since we don't care about A and B order, maybe sort. | |
| 527 (when sort-alphabetically | |
| 528 (string-lessp namea nameb))) | |
| 529 ((eq typea 'custom-group) | |
| 530 ;; If B is also a group, maybe sort. Otherwise, order A and B. | |
| 531 (if (eq typeb 'custom-group) | |
| 532 (when sort-alphabetically | |
| 533 (string-lessp namea nameb)) | |
| 534 (eq order-groups 'first))) | |
| 535 ((eq typeb 'custom-group) | |
| 536 ;; Since A cannot be a group, order A and B. | |
| 537 (eq order-groups 'last)) | |
| 538 (sort-alphabetically | |
| 539 ;; Since A and B cannot be groups, sort. | |
| 540 (string-lessp namea nameb))))))) | |
| 541 | |
| 542 | |
| 543 ;;; Custom Mode Commands. | |
| 544 | |
| 545 (defvar custom-options nil | |
| 546 "Customization widgets in the current buffer.") | |
| 547 | |
| 548 (defun Custom-set () | |
| 549 "Set changes in all modified options." | |
| 550 (interactive) | |
| 551 (let ((children custom-options)) | |
| 552 (mapc (lambda (child) | |
| 553 (when (eq (widget-get child :custom-state) 'modified) | |
| 554 (widget-apply child :custom-set))) | |
| 555 children))) | |
| 556 | |
| 557 (defun Custom-save () | |
| 480 | 558 "Set all modified options and save them." |
| 428 | 559 (interactive) |
| 480 | 560 (let ((all-children custom-options) |
| 561 children) | |
| 428 | 562 (mapc (lambda (child) |
| 563 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 480 | 564 (push child children))) |
| 565 all-children) | |
| 566 (let ((the-children children) | |
| 567 child) | |
| 568 (while (setq child (pop the-children)) | |
| 569 (widget-apply child :custom-pre-save))) | |
| 570 (custom-save-all) | |
| 571 (let ((the-children children) | |
| 572 child) | |
| 573 (while (setq child (pop the-children)) | |
| 574 (widget-apply child :custom-post-save))) | |
| 575 )) | |
| 428 | 576 |
| 577 (defvar custom-reset-menu | |
| 578 '(("Current" . Custom-reset-current) | |
| 579 ("Saved" . Custom-reset-saved) | |
| 580 ("Standard Settings" . Custom-reset-standard)) | |
| 581 "Alist of actions for the `Reset' button. | |
| 582 The key is a string containing the name of the action, the value is a | |
| 583 lisp function taking the widget as an element which will be called | |
| 584 when the action is chosen.") | |
| 585 | |
| 586 (defun custom-reset (event) | |
| 587 "Select item from reset menu." | |
| 588 (let* ((completion-ignore-case t) | |
| 589 (answer (widget-choose "Reset to" | |
| 590 custom-reset-menu | |
| 591 event))) | |
| 592 (if answer | |
| 593 (funcall answer)))) | |
| 594 | |
| 595 (defun Custom-reset-current (&rest ignore) | |
| 596 "Reset all modified group members to their current value." | |
| 597 (interactive) | |
| 598 (let ((children custom-options)) | |
| 599 (mapc (lambda (child) | |
| 600 (when (eq (widget-get child :custom-state) 'modified) | |
| 601 (widget-apply child :custom-reset-current))) | |
| 602 children))) | |
| 603 | |
| 604 (defun Custom-reset-saved (&rest ignore) | |
| 605 "Reset all modified or set group members to their saved value." | |
| 606 (interactive) | |
| 607 (let ((children custom-options)) | |
| 608 (mapc (lambda (child) | |
| 609 (when (eq (widget-get child :custom-state) 'modified) | |
| 610 (widget-apply child :custom-reset-saved))) | |
| 611 children))) | |
| 612 | |
| 613 (defun Custom-reset-standard (&rest ignore) | |
| 614 "Reset all modified, set, or saved group members to their standard settings." | |
| 615 (interactive) | |
| 480 | 616 (let ((all-children custom-options) |
| 617 children must-save) | |
| 428 | 618 (mapc (lambda (child) |
| 476 | 619 (when (memq (widget-get child :custom-state) '(modified set saved)) |
| 480 | 620 (push child children))) |
| 621 all-children) | |
| 622 (let ((the-children children) | |
| 623 child) | |
| 624 (while (setq child (pop the-children)) | |
| 625 (and (widget-apply child :custom-pre-reset-standard) | |
| 626 (setq must-save t)))) | |
| 627 (and must-save (custom-save-all)) | |
| 628 (let ((the-children children) | |
| 629 child) | |
| 630 (while (setq child (pop the-children)) | |
| 631 (widget-apply child :custom-post-reset-standard))) | |
| 632 )) | |
| 428 | 633 |
| 634 | |
| 635 ;;; The Customize Commands | |
| 636 | |
| 637 (defun custom-prompt-variable (prompt-var prompt-val &optional comment) | |
| 638 "Prompt for a variable and a value and return them as a list. | |
| 639 PROMPT-VAR is the prompt for the variable, and PROMPT-VAL is the | |
| 4178 | 640 prompt for the value. A %s escape in PROMPT-VAL is replaced with |
| 641 the name of the variable. A final colon is appended to both prompts. | |
| 428 | 642 |
| 643 If the variable has a `variable-interactive' property, that is used as if | |
| 644 it were the arg to `interactive' (which see) to interactively read the value. | |
| 645 | |
| 646 If the variable has a `custom-type' property, it must be a widget and the | |
| 647 `:prompt-value' property of that widget will be used for reading the value. | |
| 648 | |
| 649 If optional COMMENT argument is non nil, also prompt for a comment and return | |
| 650 it as the third element in the list." | |
| 4178 | 651 (let* ((var (read-variable (concat prompt-var ": "))) |
| 428 | 652 (minibuffer-help-form '(describe-variable var)) |
| 653 (val | |
| 654 (let ((prop (get var 'variable-interactive)) | |
| 655 (type (get var 'custom-type)) | |
| 656 (prompt (format prompt-val var))) | |
| 657 (unless (listp type) | |
| 658 (setq type (list type))) | |
| 659 (cond (prop | |
| 660 ;; Use VAR's `variable-interactive' property | |
| 661 ;; as an interactive spec for prompting. | |
| 662 (call-interactively (list 'lambda '(arg) | |
| 663 (list 'interactive prop) | |
| 664 'arg))) | |
| 665 (type | |
| 666 (widget-prompt-value type | |
| 667 prompt | |
| 668 (if (boundp var) | |
| 669 (symbol-value var)) | |
| 670 (not (boundp var)))) | |
| 671 (t | |
| 4178 | 672 (eval-minibuffer (concat prompt ": "))))))) |
| 428 | 673 (if comment |
| 674 (list var val | |
| 675 (read-string "Comment: " (get var 'variable-comment))) | |
| 4178 | 676 (list var val)))) |
| 428 | 677 |
| 678 ;;;###autoload | |
| 679 (defun customize-set-value (var val &optional comment) | |
| 680 "Set VARIABLE to VALUE. VALUE is a Lisp object. | |
| 681 | |
| 682 If VARIABLE has a `variable-interactive' property, that is used as if | |
| 683 it were the arg to `interactive' (which see) to interactively read the value. | |
| 684 | |
| 685 If VARIABLE has a `custom-type' property, it must be a widget and the | |
| 686 `:prompt-value' property of that widget will be used for reading the value. | |
| 687 | |
| 688 If given a prefix (or a COMMENT argument), also prompt for a comment." | |
| 4178 | 689 (interactive (custom-prompt-variable "Set variable" |
| 690 "Set value of %s" | |
| 428 | 691 current-prefix-arg)) |
| 692 | |
| 693 (set var val) | |
| 694 (cond ((string= comment "") | |
| 695 (put var 'variable-comment nil)) | |
| 696 (comment | |
| 697 (put var 'variable-comment comment)))) | |
| 698 | |
| 699 ;;;###autoload | |
| 444 | 700 (defun customize-set-variable (variable value &optional comment) |
| 701 "Set the default for VARIABLE to VALUE. VALUE is any Lisp object. | |
| 428 | 702 |
| 703 If VARIABLE has a `custom-set' property, that is used for setting | |
| 704 VARIABLE, otherwise `set-default' is used. | |
| 705 | |
| 706 The `customized-value' property of the VARIABLE will be set to a list | |
| 707 with a quoted VALUE as its sole list member. | |
| 708 | |
| 709 If VARIABLE has a `variable-interactive' property, that is used as if | |
| 710 it were the arg to `interactive' (which see) to interactively read the value. | |
| 711 | |
| 712 If VARIABLE has a `custom-type' property, it must be a widget and the | |
| 713 `:prompt-value' property of that widget will be used for reading the value. | |
| 714 | |
| 715 If given a prefix (or a COMMENT argument), also prompt for a comment." | |
| 4178 | 716 (interactive (custom-prompt-variable "Set variable" |
| 717 "Set customized value of %s" | |
| 428 | 718 current-prefix-arg)) |
| 444 | 719 (funcall (or (get variable 'custom-set) 'set-default) variable value) |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
720 (put variable 'customized-value (list (quote-maybe value))) |
| 428 | 721 (cond ((string= comment "") |
| 444 | 722 (put variable 'variable-comment nil) |
| 723 (put variable 'customized-variable-comment nil)) | |
| 428 | 724 (comment |
| 444 | 725 (put variable 'variable-comment comment) |
| 726 (put variable 'customized-variable-comment comment)))) | |
| 428 | 727 |
| 728 | |
| 729 ;;;###autoload | |
| 444 | 730 (defun customize-save-variable (variable value &optional comment) |
| 428 | 731 "Set the default for VARIABLE to VALUE, and save it for future sessions. |
| 732 If VARIABLE has a `custom-set' property, that is used for setting | |
| 733 VARIABLE, otherwise `set-default' is used. | |
| 734 | |
| 735 The `customized-value' property of the VARIABLE will be set to a list | |
| 736 with a quoted VALUE as its sole list member. | |
| 737 | |
| 738 If VARIABLE has a `variable-interactive' property, that is used as if | |
| 739 it were the arg to `interactive' (which see) to interactively read the value. | |
| 740 | |
| 741 If VARIABLE has a `custom-type' property, it must be a widget and the | |
| 742 `:prompt-value' property of that widget will be used for reading the value. | |
| 743 | |
| 744 If given a prefix (or a COMMENT argument), also prompt for a comment." | |
| 4178 | 745 (interactive (custom-prompt-variable "Set and save variable" |
| 746 "Set and save value of %s" | |
| 428 | 747 current-prefix-arg)) |
| 444 | 748 (funcall (or (get variable 'custom-set) 'set-default) variable value) |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
749 (put variable 'saved-value (list (quote-maybe value))) |
|
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
750 (custom-push-theme 'theme-value variable 'user 'set (list (quote-maybe value))) |
| 428 | 751 (cond ((string= comment "") |
| 444 | 752 (put variable 'variable-comment nil) |
| 753 (put variable 'saved-variable-comment nil)) | |
| 428 | 754 (comment |
| 444 | 755 (put variable 'variable-comment comment) |
| 756 (put variable 'saved-variable-comment comment))) | |
| 428 | 757 (custom-save-all)) |
| 758 | |
| 759 ;;;###autoload | |
| 760 (defun customize (group) | |
| 761 "Select a customization buffer which you can use to set user options. | |
| 762 User options are structured into \"groups\". | |
| 763 The default group is `Emacs'." | |
| 764 (interactive (custom-group-prompt | |
| 765 "Customize group: (default emacs) ")) | |
| 766 (when (stringp group) | |
| 767 (if (string-equal "" group) | |
| 768 (setq group 'emacs) | |
| 769 (setq group (intern group)))) | |
| 770 (let ((name (format "*Customize Group: %s*" | |
| 771 (custom-unlispify-tag-name group)))) | |
| 772 (if (get-buffer name) | |
| 773 (switch-to-buffer name) | |
| 774 (custom-buffer-create (list (list group 'custom-group)) | |
| 775 name | |
| 776 (concat " for group " | |
| 777 (custom-unlispify-tag-name group)))))) | |
| 778 | |
| 779 ;;;###autoload | |
| 780 (defalias 'customize-group 'customize) | |
| 781 | |
| 782 ;;;###autoload | |
| 783 (defun customize-other-window (symbol) | |
| 784 "Customize SYMBOL, which must be a customization group." | |
| 785 (interactive (custom-group-prompt | |
| 786 "Customize group: (default emacs) ")) | |
| 787 (when (stringp symbol) | |
| 788 (if (string-equal "" symbol) | |
| 789 (setq symbol 'emacs) | |
| 790 (setq symbol (intern symbol)))) | |
| 791 (custom-buffer-create-other-window | |
| 792 (list (list symbol 'custom-group)) | |
| 793 (format "*Customize Group: %s*" (custom-unlispify-tag-name symbol)))) | |
| 794 | |
| 795 ;;;###autoload | |
| 796 (defalias 'customize-group-other-window 'customize-other-window) | |
| 797 | |
| 798 ;;;###autoload | |
| 799 (defalias 'customize-option 'customize-variable) | |
| 800 | |
| 801 ;;;###autoload | |
| 802 (defun customize-variable (symbol) | |
| 803 "Customize SYMBOL, which must be a user option variable." | |
| 804 (interactive (custom-variable-prompt)) | |
| 805 (custom-buffer-create (list (list symbol 'custom-variable)) | |
| 806 (format "*Customize Variable: %s*" | |
| 807 (custom-unlispify-tag-name symbol)))) | |
| 808 | |
| 809 ;;;###autoload | |
| 810 (defun customize-changed-options (since-version) | |
| 811 "Customize all user option variables whose default values changed recently. | |
| 812 This means, in other words, variables defined with a `:version' keyword." | |
| 4289 | 813 (interactive |
| 814 "sCustomize options changed, since version (default all versions): ") | |
| 428 | 815 (if (equal since-version "") |
| 816 (setq since-version nil)) | |
| 817 (let ((found nil)) | |
| 818 (mapatoms (lambda (symbol) | |
| 819 (and (boundp symbol) | |
| 820 (let ((version (get symbol 'custom-version))) | |
| 821 (and version | |
| 822 (or (null since-version) | |
| 4289 | 823 (customize-version-lessp since-version |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
824 version)))) |
| 428 | 825 (push (list symbol 'custom-variable) found)))) |
| 826 (unless found | |
| 827 (error "No user options have changed defaults %s" | |
| 828 (if since-version | |
| 829 (format "since XEmacs %s" since-version) | |
| 830 "in recent Emacs versions"))) | |
| 831 (custom-buffer-create (custom-sort-items found t nil) | |
| 832 "*Customize Changed Options*"))) | |
| 833 | |
| 834 (defun customize-version-lessp (version1 version2) | |
| 835 (let (major1 major2 minor1 minor2) | |
| 836 (string-match "\\([0-9]+\\)[.]\\([0-9]+\\)" version1) | |
| 837 (setq major1 (read (match-string 1 version1))) | |
| 838 (setq minor1 (read (match-string 2 version1))) | |
| 839 (string-match "\\([0-9]+\\)[.]\\([0-9]+\\)" version2) | |
| 840 (setq major2 (read (match-string 1 version2))) | |
| 841 (setq minor2 (read (match-string 2 version2))) | |
| 842 (or (< major1 major2) | |
| 843 (and (= major1 major2) | |
| 844 (< minor1 minor2))))) | |
| 845 | |
| 846 ;;;###autoload | |
| 847 (defalias 'customize-variable-other-window 'customize-option-other-window) | |
| 848 | |
| 849 ;;;###autoload | |
| 850 (defun customize-option-other-window (symbol) | |
| 851 "Customize SYMBOL, which must be a user option variable. | |
| 852 Show the buffer in another window, but don't select it." | |
| 853 (interactive (custom-variable-prompt)) | |
| 854 (custom-buffer-create-other-window | |
| 855 (list (list symbol 'custom-variable)) | |
| 856 (format "*Customize Option: %s*" (custom-unlispify-tag-name symbol)))) | |
| 857 | |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
858 |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
859 (defun custom-face-prompt () |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
860 ;; Interactive call for `customize-face' and `customize-face-other-window'. |
|
4628
877ad4697eea
Fix typo in comment in cus-edit.el. <87vdqk5bqf.fsf@xemacs.org>
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4434
diff
changeset
|
861 ;; See their docstrings for more information. Note that this call returns |
|
877ad4697eea
Fix typo in comment in cus-edit.el. <87vdqk5bqf.fsf@xemacs.org>
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4434
diff
changeset
|
862 ;; a list of only one element. This is because the callers' second arg |
|
877ad4697eea
Fix typo in comment in cus-edit.el. <87vdqk5bqf.fsf@xemacs.org>
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4434
diff
changeset
|
863 ;; AT-POINT is only used in interactive calls. |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
864 (let ((faces (get-char-property (point) 'face))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
865 (if (or (null faces) (not current-prefix-arg)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
866 ;; The default behavior, which is to prompt for all faces, is also |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
867 ;; used as a fall back when a prefix is given but there's no face |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
868 ;; under point: |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
869 (let ((choice (completing-read "Customize face: (default all) " |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
870 obarray 'find-face))) |
|
5366
f00192e1cd49
Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents:
4806
diff
changeset
|
871 (if (eql (length choice) 0) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
872 nil |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
873 (list (intern choice)))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
874 (cond ((symbolp faces) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
875 ;; Customize only this one: |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
876 (list (list faces))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
877 ((listp faces) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
878 ;; Make a choice only amongst the faces under point: |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
879 (let ((choice (completing-read |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
880 "Customize face: (default all faces at point) " |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
881 (mapcar (lambda (face) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
882 (list (symbol-name face) face)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
883 faces) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
884 nil t))) |
|
5366
f00192e1cd49
Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents:
4806
diff
changeset
|
885 (if (eql (length choice) 0) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
886 (list faces) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
887 (list (intern choice))))))))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
888 |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
889 (defun customize-face-1 (face custom-buffer-create-fn) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
890 ;; Customize FACE in a buffer created with BUFFER-CREATE-FN. |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
891 ;; See the docstring of `customize-face' and `customize-face-other-window' |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
892 ;; for more information. |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
893 (cond ((null face) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
894 (funcall custom-buffer-create-fn |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
895 (custom-sort-items |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
896 (mapcar (lambda (symbol) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
897 (list symbol 'custom-face)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
898 (face-list)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
899 t nil) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
900 "*Customize All Faces*")) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
901 ((listp face) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
902 (funcall custom-buffer-create-fn |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
903 (custom-sort-items |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
904 (mapcar (lambda (symbol) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
905 (list symbol 'custom-face)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
906 face) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
907 t nil) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
908 "*Customize Some Faces*")) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
909 ((symbolp face) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
910 (funcall custom-buffer-create-fn |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
911 (list (list face 'custom-face)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
912 (format "*Customize Face: %s*" |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
913 (custom-unlispify-tag-name face)))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
914 (t |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
915 (signal-error 'wrong-type-argument |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
916 '((or null listp symbolp) face))))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
917 |
| 428 | 918 |
| 919 ;;;###autoload | |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
920 (defun customize-face (&optional face at-point) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
921 "Open a customization buffer for FACE. |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
922 FACE should be either: |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
923 - nil, meaning to customize all faces, |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
924 - a list of symbols naming faces, meaning to customize only those, |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
925 - a symbol naming a face, meaning to customize this face only. |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
926 |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
927 When called interactively, use a prefix (the AT-POINT argument) to |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
928 make a choice among the faces found at current position." |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
929 (interactive (custom-face-prompt)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
930 (customize-face-1 face #'custom-buffer-create)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
931 |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
932 ;;;###autoload |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
933 (defun customize-face-other-window (&optional face at-point) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
934 "Like `customize-face', but use another window." |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
935 (interactive (custom-face-prompt)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
936 (customize-face-1 face #'custom-buffer-create-other-window)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
937 |
| 428 | 938 |
| 939 ;;;###autoload | |
| 940 (defun customize-customized () | |
| 941 "Customize all user options set since the last save in this session." | |
| 942 (interactive) | |
| 943 (let ((found nil)) | |
| 944 (mapatoms (lambda (symbol) | |
| 945 (and (or (get symbol 'customized-face) | |
| 946 (get symbol 'customized-face-comment)) | |
| 947 (find-face symbol) | |
| 948 (push (list symbol 'custom-face) found)) | |
| 949 (and (or (get symbol 'customized-value) | |
| 950 (get symbol 'customized-variable-comment)) | |
| 951 (boundp symbol) | |
| 952 (push (list symbol 'custom-variable) found)))) | |
| 953 (if (not found) | |
| 954 (error "No customized user options") | |
| 955 (custom-buffer-create (custom-sort-items found t nil) | |
| 956 "*Customize Customized*")))) | |
| 957 | |
| 958 ;;;###autoload | |
| 959 (defun customize-saved () | |
| 960 "Customize all already saved user options." | |
| 961 (interactive) | |
| 962 (let ((found nil)) | |
| 963 (mapatoms (lambda (symbol) | |
| 964 (and (or (get symbol 'saved-face) | |
| 965 (get symbol 'saved-face-comment)) | |
| 966 (find-face symbol) | |
| 967 (push (list symbol 'custom-face) found)) | |
| 968 (and (or (get symbol 'saved-value) | |
| 969 (get symbol 'saved-variable-comment)) | |
| 970 (boundp symbol) | |
| 971 (push (list symbol 'custom-variable) found)))) | |
| 972 (if (not found ) | |
| 973 (error "No saved user options") | |
| 974 (custom-buffer-create (custom-sort-items found t nil) | |
| 975 "*Customize Saved*")))) | |
| 976 | |
| 977 ;;;###autoload | |
| 1655 | 978 (defalias 'apropos-customize 'customize-apropos) |
| 979 | |
| 980 ;;;###autoload | |
| 428 | 981 (defun customize-apropos (regexp &optional all) |
| 982 "Customize all user options matching REGEXP. | |
| 983 If ALL is `options', include only options. | |
| 984 If ALL is `faces', include only faces. | |
| 985 If ALL is `groups', include only groups. | |
| 986 If ALL is t (interactively, with prefix arg), include options which are not | |
| 987 user-settable, as well as faces and groups." | |
| 988 (interactive "sCustomize regexp: \nP") | |
| 989 (let ((found nil)) | |
| 990 (mapatoms (lambda (symbol) | |
| 991 (when (string-match regexp (symbol-name symbol)) | |
| 992 (when (and (not (memq all '(faces options))) | |
| 993 (get symbol 'custom-group)) | |
| 994 (push (list symbol 'custom-group) found)) | |
| 995 (when (and (not (memq all '(options groups))) | |
| 996 (find-face symbol)) | |
| 997 (push (list symbol 'custom-face) found)) | |
| 998 (when (and (not (memq all '(groups faces))) | |
| 999 (boundp symbol) | |
| 1000 (or (get symbol 'saved-value) | |
| 1001 (get symbol 'standard-value) | |
| 1002 (if (memq all '(nil options)) | |
| 1003 (user-variable-p symbol) | |
| 1004 (get symbol 'variable-documentation)))) | |
| 1005 (push (list symbol 'custom-variable) found))))) | |
| 1006 (if (not found) | |
| 1007 (error "No matches") | |
| 1008 (custom-buffer-create (custom-sort-items found t | |
| 1009 custom-buffer-order-groups) | |
| 1010 "*Customize Apropos*")))) | |
| 1011 | |
| 1012 ;;;###autoload | |
| 1013 (defun customize-apropos-options (regexp &optional arg) | |
| 1014 "Customize all user options matching REGEXP. | |
| 1015 With prefix arg, include options which are not user-settable." | |
| 1016 (interactive "sCustomize regexp: \nP") | |
| 1017 (customize-apropos regexp (or arg 'options))) | |
| 1018 | |
| 1019 ;;;###autoload | |
| 1020 (defun customize-apropos-faces (regexp) | |
| 1021 "Customize all user faces matching REGEXP." | |
| 1022 (interactive "sCustomize regexp: \n") | |
| 1023 (customize-apropos regexp 'faces)) | |
| 1024 | |
| 1025 ;;;###autoload | |
| 1026 (defun customize-apropos-groups (regexp) | |
| 1027 "Customize all user groups matching REGEXP." | |
| 1028 (interactive "sCustomize regexp: \n") | |
| 1029 (customize-apropos regexp 'groups)) | |
| 1030 | |
| 1031 | |
| 1032 ;;; Buffer. | |
| 1033 | |
| 1034 (defcustom custom-buffer-style 'links | |
| 1035 "*Control the presentation style for customization buffers. | |
| 1036 The value should be a symbol, one of: | |
| 1037 | |
| 1038 brackets: groups nest within each other with big horizontal brackets. | |
| 1039 links: groups have links to subgroups." | |
| 1040 :type '(radio (const :tag "brackets: Groups nest within each others" brackets) | |
| 1041 (const :tag "links: Group have links to subgroups" links)) | |
| 1042 :group 'custom-buffer) | |
| 1043 | |
| 1044 (defcustom custom-buffer-done-function 'kill-buffer | |
| 1045 "*Function to be used to remove the buffer when the user is done with it. | |
| 1046 Choices include `kill-buffer' (the default) and `bury-buffer'. | |
| 1047 The function will be called with one argument, the buffer to remove." | |
| 1048 :type '(radio (function-item kill-buffer) | |
| 1049 (function-item bury-buffer) | |
| 1050 (function :tag "Other" nil)) | |
| 1051 :group 'custom-buffer) | |
| 1052 | |
| 1053 (defcustom custom-buffer-indent 3 | |
| 1054 "Number of spaces to indent nested groups." | |
| 1055 :type 'integer | |
| 1056 :group 'custom-buffer) | |
| 1057 | |
| 1058 ;;;###autoload | |
| 1059 (defun custom-buffer-create (options &optional name description) | |
| 1060 "Create a buffer containing OPTIONS. | |
| 1061 Optional NAME is the name of the buffer. | |
| 1062 OPTIONS should be an alist of the form ((SYMBOL WIDGET)...), where | |
| 1063 SYMBOL is a customization option, and WIDGET is a widget for editing | |
| 1064 that option." | |
| 1065 (unless name (setq name "*Customization*")) | |
| 1066 (kill-buffer (get-buffer-create name)) | |
| 1067 (switch-to-buffer (get-buffer-create name)) | |
| 1068 (custom-buffer-create-internal options description)) | |
| 1069 | |
| 1070 ;;;###autoload | |
| 1071 (defun custom-buffer-create-other-window (options &optional name description) | |
| 1072 "Create a buffer containing OPTIONS. | |
| 1073 Optional NAME is the name of the buffer. | |
| 1074 OPTIONS should be an alist of the form ((SYMBOL WIDGET)...), where | |
| 1075 SYMBOL is a customization option, and WIDGET is a widget for editing | |
| 1076 that option." | |
| 1077 (unless name (setq name "*Customization*")) | |
| 1078 (kill-buffer (get-buffer-create name)) | |
| 1079 (let ((window (selected-window))) | |
| 1080 (switch-to-buffer-other-window (get-buffer-create name)) | |
| 1081 (custom-buffer-create-internal options description) | |
| 1082 (select-window window))) | |
| 1083 | |
| 1084 (defcustom custom-reset-button-menu t | |
| 1085 "If non-nil, only show a single reset button in customize buffers. | |
| 1086 This button will have a menu with all three reset operations." | |
| 1087 :type 'boolean | |
| 1088 :group 'custom-buffer) | |
| 1089 | |
| 1090 (defconst custom-skip-messages 5) | |
| 1091 | |
| 1092 (defun Custom-buffer-done () | |
| 1093 "Remove current buffer. | |
| 1094 This works by calling the function specified by | |
| 1095 `custom-buffer-done-function'." | |
| 1096 (interactive) | |
| 1097 (funcall custom-buffer-done-function (current-buffer))) | |
| 1098 | |
| 1099 (defun custom-buffer-create-buttons () | |
| 1100 (message "Creating customization buttons...") | |
| 1101 (widget-insert "\nOperate on everything in this buffer:\n ") | |
| 1102 (widget-create 'push-button | |
| 1103 :tag "Set" | |
| 1104 :help-echo "\ | |
| 1105 Make your editing in this buffer take effect for this session" | |
| 1106 :action (lambda (widget &optional event) | |
| 1107 (Custom-set))) | |
| 1108 (widget-insert " ") | |
| 1109 (widget-create 'push-button | |
| 1110 :tag "Save" | |
| 1111 :help-echo "\ | |
| 1112 Make your editing in this buffer take effect for future Emacs sessions" | |
| 1113 :action (lambda (widget &optional event) | |
| 1114 (Custom-save))) | |
| 1115 (if custom-reset-button-menu | |
| 1116 (progn | |
| 1117 (widget-insert " ") | |
| 1118 (widget-create 'push-button | |
| 1119 :tag "Reset" | |
| 1120 :tag-glyph '("reset-up" "reset-down") | |
| 1121 :help-echo "Show a menu with reset operations" | |
| 1122 :mouse-down-action (lambda (&rest junk) t) | |
| 1123 :action (lambda (widget &optional event) | |
| 1124 (custom-reset event)))) | |
| 1125 (widget-insert " ") | |
| 1126 (widget-create 'push-button | |
| 1127 :tag "Reset" | |
| 1128 :help-echo "\ | |
| 1129 Reset all edited text in this buffer to reflect current values" | |
| 1130 :action 'Custom-reset-current) | |
| 1131 (widget-insert " ") | |
| 1132 (widget-create 'push-button | |
| 1133 :tag "Reset to Saved" | |
| 1134 :help-echo "\ | |
| 1135 Reset all values in this buffer to their saved settings" | |
| 1136 :action 'Custom-reset-saved) | |
| 1137 (widget-insert " ") | |
| 1138 (widget-create 'push-button | |
| 1139 :tag "Reset to Standard" | |
| 1140 :help-echo "\ | |
| 1141 Reset all values in this buffer to their standard settings" | |
| 1142 :action 'Custom-reset-standard)) | |
| 1143 (widget-insert " ") | |
| 1144 (widget-create 'push-button | |
| 1145 :tag "Done" | |
| 1146 :help-echo "Remove the buffer" | |
| 1147 :action (lambda (widget &optional event) | |
| 1148 (Custom-buffer-done))) | |
| 1149 (widget-insert "\n")) | |
| 1150 | |
| 1151 (defcustom custom-novice t | |
| 1152 "If non-nil, show help message at top of customize buffers." | |
| 1153 :type 'boolean | |
| 1154 :group 'custom-buffer) | |
| 1155 | |
| 1156 (defcustom custom-display-global-buttons 'top | |
| 1157 "If `nil' don't display the global buttons. If `top' display at the | |
| 1158 beginning of custom buffers. If `bottom', display at the end." | |
| 1159 :type '(choice (const top) | |
| 1160 (const bottom) | |
| 1161 (const :tag "don't" nil)) | |
| 1162 :group 'custom-buffer) | |
| 1163 | |
| 1164 (defun custom-buffer-create-internal (options &optional description) | |
| 1165 (message "Creating customization buffer...") | |
| 1166 (custom-mode) | |
| 1167 (widget-insert "This is a customization buffer") | |
| 1168 (if description | |
| 1169 (widget-insert description)) | |
| 1170 (when custom-novice | |
| 1171 (widget-insert ".\n\ | |
| 1172 Type RET or click button2 on an active field to invoke its action. | |
| 1173 Invoke ") | |
| 1174 (widget-create 'info-link | |
| 1175 :tag "Help" | |
| 1176 :help-echo "Read the online help" | |
| 1177 "(XEmacs)Easy Customization") | |
| 1178 (widget-insert " for more information.")) | |
| 1179 (widget-insert "\n") | |
| 1180 (if (equal custom-display-global-buttons 'top) | |
| 1181 (custom-buffer-create-buttons)) | |
| 1182 (widget-insert "\n") | |
| 1183 (message "Creating customization items...") | |
| 1184 (setq custom-options | |
|
5366
f00192e1cd49
Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents:
4806
diff
changeset
|
1185 (if (eql (length options) 1) |
| 428 | 1186 (mapcar (lambda (entry) |
| 1187 (widget-create (nth 1 entry) | |
| 1188 :documentation-shown t | |
| 1189 :custom-state 'unknown | |
| 1190 :tag (custom-unlispify-tag-name | |
| 1191 (nth 0 entry)) | |
| 1192 :value (nth 0 entry))) | |
| 1193 options) | |
| 1194 (let ((count 0) | |
| 1195 (length (length options))) | |
| 1196 (mapcar (lambda (entry) | |
| 1197 (prog2 | |
| 1198 (display-message | |
| 1199 'progress | |
| 1200 (format "Creating customization items %2d%%..." | |
| 1201 (/ (* 100.0 count) length))) | |
| 1202 (widget-create (nth 1 entry) | |
| 1203 :tag (custom-unlispify-tag-name | |
| 1204 (nth 0 entry)) | |
| 1205 :value (nth 0 entry)) | |
| 1206 (incf count) | |
| 1207 (unless (eq (preceding-char) ?\n) | |
| 1208 (widget-insert "\n")) | |
| 1209 (widget-insert "\n"))) | |
| 1210 options)))) | |
| 1211 (unless (eq (preceding-char) ?\n) | |
| 1212 (widget-insert "\n")) | |
| 1213 (if (equal custom-display-global-buttons 'bottom) | |
| 1214 (custom-buffer-create-buttons)) | |
| 1215 (display-message 'progress | |
| 1216 (format | |
| 1217 "Creating customization items %2d%%...done" 100)) | |
| 1218 (unless (eq custom-buffer-style 'tree) | |
| 1219 (mapc 'custom-magic-reset custom-options)) | |
| 1220 (message "Creating customization setup...") | |
| 1221 (widget-setup) | |
| 1222 (goto-char (point-min)) | |
| 1223 (message "Creating customization buffer...done")) | |
| 1224 | |
| 1225 | |
| 1226 ;;; The Tree Browser. | |
| 1227 | |
| 1228 ;;;###autoload | |
| 1229 (defun customize-browse (&optional group) | |
| 1230 "Create a tree browser for the customize hierarchy." | |
| 1231 (interactive) | |
| 1232 (unless group | |
| 1233 (setq group 'emacs)) | |
| 1234 (let ((name "*Customize Browser*")) | |
| 1235 (kill-buffer (get-buffer-create name)) | |
| 1236 (switch-to-buffer (get-buffer-create name))) | |
| 1237 (custom-mode) | |
| 1238 (widget-insert "\ | |
| 1239 Square brackets show active fields; type RET or click button2 | |
| 1240 on an active field to invoke its action. | |
| 1241 Invoke [+] below to expand a group, and [-] to collapse an expanded group.\n") | |
| 1242 (if custom-browse-only-groups | |
| 1243 (widget-insert "\ | |
| 1244 Invoke the [Group] button below to edit that item in another window.\n\n") | |
| 1245 (widget-insert "Invoke the ") | |
| 1246 (widget-create 'item | |
| 1247 :format "%t" | |
| 1248 :tag "[Group]" | |
| 1249 :tag-glyph "folder") | |
| 1250 (widget-insert ", ") | |
| 1251 (widget-create 'item | |
| 1252 :format "%t" | |
| 1253 :tag "[Face]" | |
| 1254 :tag-glyph "face") | |
| 1255 (widget-insert ", and ") | |
| 1256 (widget-create 'item | |
| 1257 :format "%t" | |
| 1258 :tag "[Option]" | |
| 1259 :tag-glyph "option") | |
| 1260 (widget-insert " buttons below to edit that | |
| 1261 item in another window.\n\n")) | |
| 1262 (let ((custom-buffer-style 'tree)) | |
| 1263 (widget-create 'custom-group | |
| 1264 :custom-last t | |
| 1265 :custom-state 'unknown | |
| 1266 :tag (custom-unlispify-tag-name group) | |
| 1267 :value group)) | |
| 1268 (widget-add-change) | |
| 1269 (goto-char (point-min))) | |
| 1270 | |
| 1271 (define-widget 'custom-browse-visibility 'item | |
| 2118 | 1272 "Control visibility of items in the customize tree browser." |
| 428 | 1273 :format "%[[%t]%]" |
| 1274 :action 'custom-browse-visibility-action) | |
| 1275 | |
| 1276 (defun custom-browse-visibility-action (widget &rest ignore) | |
| 1277 (let ((custom-buffer-style 'tree)) | |
| 1278 (custom-toggle-parent widget))) | |
| 1279 | |
| 1280 (define-widget 'custom-browse-group-tag 'push-button | |
| 1281 "Show parent in other window when activated." | |
| 1282 :tag "Group" | |
| 1283 :tag-glyph "folder" | |
| 1284 :action 'custom-browse-group-tag-action) | |
| 1285 | |
| 1286 (defun custom-browse-group-tag-action (widget &rest ignore) | |
| 1287 (let ((parent (widget-get widget :parent))) | |
| 1288 (customize-group-other-window (widget-value parent)))) | |
| 1289 | |
| 1290 (define-widget 'custom-browse-variable-tag 'push-button | |
| 1291 "Show parent in other window when activated." | |
| 1292 :tag "Option" | |
| 1293 :tag-glyph "option" | |
| 1294 :action 'custom-browse-variable-tag-action) | |
| 1295 | |
| 1296 (defun custom-browse-variable-tag-action (widget &rest ignore) | |
| 1297 (let ((parent (widget-get widget :parent))) | |
| 1298 (customize-variable-other-window (widget-value parent)))) | |
| 1299 | |
| 1300 (define-widget 'custom-browse-face-tag 'push-button | |
| 1301 "Show parent in other window when activated." | |
| 1302 :tag "Face" | |
| 1303 :tag-glyph "face" | |
| 1304 :action 'custom-browse-face-tag-action) | |
| 1305 | |
| 1306 (defun custom-browse-face-tag-action (widget &rest ignore) | |
| 1307 (let ((parent (widget-get widget :parent))) | |
| 1308 (customize-face-other-window (widget-value parent)))) | |
| 1309 | |
| 1310 (defconst custom-browse-alist '((" " "space") | |
| 1311 (" | " "vertical") | |
| 1312 ("-\\ " "top") | |
| 1313 (" |-" "middle") | |
| 1314 (" `-" "bottom"))) | |
| 1315 | |
| 1316 (defun custom-browse-insert-prefix (prefix) | |
| 1317 "Insert PREFIX. On XEmacs convert it to line graphics." | |
| 440 | 1318 ;; #### Unfinished. |
| 428 | 1319 (if nil ; (string-match "XEmacs" emacs-version) |
| 1320 (progn | |
| 1321 (insert "*") | |
| 1322 (while (not (string-equal prefix "")) | |
| 1323 (let ((entry (substring prefix 0 3))) | |
| 1324 (setq prefix (substring prefix 3)) | |
| 1325 (let ((overlay (make-overlay (1- (point)) (point) nil t nil)) | |
| 1326 (name (nth 1 (assoc entry custom-browse-alist)))) | |
| 1327 (overlay-put overlay 'end-glyph (widget-glyph-find name entry)) | |
| 1328 (overlay-put overlay 'start-open t) | |
| 1329 (overlay-put overlay 'end-open t))))) | |
| 1330 (insert prefix))) | |
| 1331 | |
| 1332 | |
| 1333 ;;; Modification of Basic Widgets. | |
| 1334 ;; | |
| 1335 ;; We add extra properties to the basic widgets needed here. This is | |
| 1336 ;; fine, as long as we are careful to stay within out own namespace. | |
| 1337 ;; | |
| 1338 ;; We want simple widgets to be displayed by default, but complex | |
| 1339 ;; widgets to be hidden. | |
| 1340 | |
| 1341 (widget-put (get 'item 'widget-type) :custom-show t) | |
| 1342 (widget-put (get 'editable-field 'widget-type) | |
| 1343 :custom-show (lambda (widget value) | |
| 1344 ;; This used to call pp-to-string | |
| 1345 (let ((pp (widget-prettyprint-to-string value))) | |
| 1346 (cond ((string-match "\n" pp) | |
| 1347 nil) | |
| 1348 ((> (length pp) 40) | |
| 1349 nil) | |
| 1350 (t t))))) | |
| 1351 (widget-put (get 'menu-choice 'widget-type) :custom-show t) | |
| 1352 | |
| 1353 ;;; The `custom-manual' Widget. | |
| 1354 | |
| 1355 (define-widget 'custom-manual 'info-link | |
| 1356 "Link to the manual entry for this customization option." | |
| 1357 :tag "Manual") | |
| 1358 | |
| 1359 ;;; The `custom-magic' Widget. | |
| 1360 | |
| 1361 (defgroup custom-magic-faces nil | |
| 1362 "Faces used by the magic button." | |
| 1363 :group 'custom-faces | |
| 1364 :group 'custom-buffer) | |
| 1365 | |
| 1366 (defface custom-invalid-face '((((class color)) | |
| 1367 (:foreground "yellow" :background "red")) | |
| 1368 (t | |
| 1369 (:bold t :italic t :underline t))) | |
| 1370 "Face used when the customize item is invalid." | |
| 1371 :group 'custom-magic-faces) | |
| 1372 | |
| 1373 (defface custom-rogue-face '((((class color)) | |
| 1374 (:foreground "pink" :background "black")) | |
| 1375 (t | |
| 1376 (:underline t))) | |
| 1377 "Face used when the customize item is not defined for customization." | |
| 1378 :group 'custom-magic-faces) | |
| 1379 | |
| 1380 (defface custom-modified-face '((((class color)) | |
| 1381 (:foreground "white" :background "blue")) | |
| 1382 (t | |
| 1383 (:italic t :bold))) | |
| 1384 "Face used when the customize item has been modified." | |
| 1385 :group 'custom-magic-faces) | |
| 1386 | |
| 1387 (defface custom-set-face '((((class color)) | |
| 1388 (:foreground "blue" :background "white")) | |
| 1389 (t | |
| 1390 (:italic t))) | |
| 1391 "Face used when the customize item has been set." | |
| 1392 :group 'custom-magic-faces) | |
| 1393 | |
| 1394 (defface custom-changed-face '((((class color)) | |
| 1395 (:foreground "white" :background "blue")) | |
| 1396 (t | |
| 1397 (:italic t))) | |
| 1398 "Face used when the customize item has been changed." | |
| 1399 :group 'custom-magic-faces) | |
| 1400 | |
| 1401 (defface custom-saved-face '((t (:underline t))) | |
| 1402 "Face used when the customize item has been saved." | |
| 1403 :group 'custom-magic-faces) | |
| 1404 | |
| 1405 (defconst custom-magic-alist '((nil "#" underline "\ | |
| 1406 uninitialized, you should not see this.") | |
| 1407 (unknown "?" italic "\ | |
| 1408 unknown, you should not see this.") | |
| 1409 (hidden "-" default "\ | |
| 1410 hidden, invoke \"Show\" button in the previous line to show." "\ | |
| 1411 group now hidden, invoke the above \"Show\" button to show contents.") | |
| 1412 (invalid "x" custom-invalid-face "\ | |
| 1413 the value displayed for this %c is invalid and cannot be set.") | |
| 1414 (modified "*" custom-modified-face "\ | |
| 1415 you have edited the value as text, but you have not set the %c." "\ | |
| 1416 you have edited something in this group, but not set it.") | |
| 1417 (set "+" custom-set-face "\ | |
| 1418 you have set this %c, but not saved it for future sessions." "\ | |
| 1419 something in this group has been set, but not saved.") | |
| 1420 (changed ":" custom-changed-face "\ | |
| 1421 this %c has been changed outside the customize buffer." "\ | |
| 1422 something in this group has been changed outside customize.") | |
| 1423 (saved "!" custom-saved-face "\ | |
| 1424 this %c has been set and saved." "\ | |
| 1425 something in this group has been set and saved.") | |
| 1426 (rogue "@" custom-rogue-face "\ | |
| 1427 this %c has not been changed with customize." "\ | |
| 1428 something in this group is not prepared for customization.") | |
| 1429 (standard " " nil "\ | |
| 1430 this %c is unchanged from its standard setting." "\ | |
| 1431 visible group members are all at standard settings.")) | |
| 1432 "Alist of customize option states. | |
| 1433 Each entry is of the form (STATE MAGIC FACE ITEM-DESC [ GROUP-DESC ]), where | |
| 1434 | |
| 1435 STATE is one of the following symbols: | |
| 1436 | |
| 1437 `nil' | |
| 1438 For internal use, should never occur. | |
| 1439 `unknown' | |
| 1440 For internal use, should never occur. | |
| 1441 `hidden' | |
| 1442 This item is not being displayed. | |
| 1443 `invalid' | |
| 1444 This item is modified, but has an invalid form. | |
| 1445 `modified' | |
| 1446 This item is modified, and has a valid form. | |
| 1447 `set' | |
| 1448 This item has been set but not saved. | |
| 1449 `changed' | |
| 1450 The current value of this item has been changed temporarily. | |
| 1451 `saved' | |
| 1452 This item is marked for saving. | |
| 1453 `rogue' | |
| 1454 This item has no customization information. | |
| 1455 `standard' | |
| 1456 This item is unchanged from the standard setting. | |
| 1457 | |
| 1458 MAGIC is a string used to present that state. | |
| 1459 | |
| 1460 FACE is a face used to present the state. | |
| 1461 | |
| 1462 ITEM-DESC is a string describing the state for options. | |
| 1463 | |
| 1464 GROUP-DESC is a string describing the state for groups. If this is | |
| 1465 left out, ITEM-DESC will be used. | |
| 1466 | |
| 1467 The string %c in either description will be replaced with the | |
| 1468 category of the item. These are `group'. `option', and `face'. | |
| 1469 | |
| 1470 The list should be sorted most significant first.") | |
| 1471 | |
| 1472 (defcustom custom-magic-show 'long | |
| 1473 "If non-nil, show textual description of the state. | |
| 1474 If `long', show a full-line description, not just one word." | |
| 1475 :type '(choice (const :tag "no" nil) | |
| 1476 (const short) | |
| 1477 (const long)) | |
| 1478 :group 'custom-buffer) | |
| 1479 | |
| 1480 (defcustom custom-magic-show-hidden '(option face) | |
| 1481 "Control whether the State button is shown for hidden items. | |
| 1482 The value should be a list with the custom categories where the State | |
| 1483 button should be visible. Possible categories are `group', `option', | |
| 1484 and `face'." | |
| 1485 :type '(set (const group) (const option) (const face)) | |
| 1486 :group 'custom-buffer) | |
| 1487 | |
| 1488 (defcustom custom-magic-show-button nil | |
| 1489 "Show a \"magic\" button indicating the state of each customization option." | |
| 1490 :type 'boolean | |
| 1491 :group 'custom-buffer) | |
| 1492 | |
| 1493 (define-widget 'custom-magic 'default | |
| 1494 "Show and manipulate state for a customization option." | |
| 1495 :format "%v" | |
| 1496 :action 'widget-parent-action | |
| 1497 :notify 'ignore | |
| 1498 :value-get 'ignore | |
| 1499 :value-create 'custom-magic-value-create | |
| 1500 :value-delete 'widget-children-value-delete) | |
| 1501 | |
| 1502 (defun widget-magic-mouse-down-action (widget &optional event) | |
| 1503 ;; Non-nil unless hidden. | |
| 1504 (not (eq (widget-get (widget-get (widget-get widget :parent) :parent) | |
| 1505 :custom-state) | |
| 1506 'hidden))) | |
| 1507 | |
| 1508 (defun custom-magic-value-create (widget) | |
| 1509 ;; Create compact status report for WIDGET. | |
| 1510 (let* ((parent (widget-get widget :parent)) | |
| 1511 (state (widget-get parent :custom-state)) | |
| 1512 (hidden (eq state 'hidden)) | |
| 1513 (entry (assq state custom-magic-alist)) | |
| 1514 (magic (nth 1 entry)) | |
| 1515 (face (nth 2 entry)) | |
| 1516 (category (widget-get parent :custom-category)) | |
| 1517 (text (or (and (eq category 'group) | |
| 1518 (nth 4 entry)) | |
| 1519 (nth 3 entry))) | |
| 1520 (form (widget-get parent :custom-form)) | |
| 1521 children) | |
| 1522 (while (string-match "\\`\\(.*\\)%c\\(.*\\)\\'" text) | |
| 1523 (setq text (concat (match-string 1 text) | |
| 1524 (symbol-name category) | |
| 1525 (match-string 2 text)))) | |
| 1526 (when (and custom-magic-show | |
| 1527 (or (not hidden) | |
| 1528 (memq category custom-magic-show-hidden))) | |
| 1529 (insert " ") | |
| 1530 (when (and (eq category 'group) | |
| 1531 (not (and (eq custom-buffer-style 'links) | |
| 1532 (> (widget-get parent :custom-level) 1)))) | |
| 1533 (insert-char ?\ (* custom-buffer-indent | |
| 1534 (widget-get parent :custom-level)))) | |
| 1535 (push (widget-create-child-and-convert | |
| 1536 widget 'choice-item | |
| 1537 :help-echo "Change the state of this item" | |
| 1538 :format (if hidden "%t" "%[%t%]") | |
| 1539 :button-prefix 'widget-push-button-prefix | |
| 1540 :button-suffix 'widget-push-button-suffix | |
| 1541 :mouse-down-action 'widget-magic-mouse-down-action | |
| 1542 :tag "State" | |
| 1543 ;;:tag-glyph (or hidden '("state-up" "state-down")) | |
| 1544 ) | |
| 1545 children) | |
| 1546 (insert ": ") | |
| 1547 (let ((start (point))) | |
| 1548 (if (eq custom-magic-show 'long) | |
| 1549 (insert text) | |
| 1550 (insert (symbol-name state))) | |
| 1551 (cond ((eq form 'lisp) | |
| 1552 (insert " (lisp)")) | |
| 1553 ((eq form 'mismatch) | |
| 1554 (insert " (mismatch)"))) | |
| 1555 (put-text-property start (point) 'face 'custom-state-face)) | |
| 1556 (insert "\n")) | |
| 1557 (when (and (eq category 'group) | |
| 1558 (not (and (eq custom-buffer-style 'links) | |
| 1559 (> (widget-get parent :custom-level) 1)))) | |
| 1560 (insert-char ?\ (* custom-buffer-indent | |
| 1561 (widget-get parent :custom-level)))) | |
| 1562 (when custom-magic-show-button | |
| 1563 (when custom-magic-show | |
| 1564 (let ((indent (widget-get parent :indent))) | |
| 1565 (when indent | |
| 1566 (insert-char ?\ indent)))) | |
| 1567 (push (widget-create-child-and-convert | |
| 1568 widget 'choice-item | |
| 1569 :mouse-down-action 'widget-magic-mouse-down-action | |
| 1570 :button-face face | |
| 1571 :button-prefix "" | |
| 1572 :button-suffix "" | |
| 1573 :help-echo "Change the state" | |
| 1574 :format (if hidden "%t" "%[%t%]") | |
| 1575 :tag (if (memq form '(lisp mismatch)) | |
| 1576 (concat "(" magic ")") | |
| 1577 (concat "[" magic "]"))) | |
| 1578 children) | |
| 1579 (insert " ")) | |
| 1580 (widget-put widget :children children))) | |
| 1581 | |
| 1582 (defun custom-magic-reset (widget) | |
| 1583 "Redraw the :custom-magic property of WIDGET." | |
| 1584 (let ((magic (widget-get widget :custom-magic))) | |
| 1585 (widget-value-set magic (widget-value magic)))) | |
| 1586 | |
| 1587 ;;; The `custom' Widget. | |
| 1588 | |
| 1589 (defface custom-button-face '((t (:bold t))) | |
| 1590 "Face used for buttons in customization buffers." | |
| 1591 :group 'custom-faces) | |
| 1592 | |
| 1593 (defface custom-documentation-face nil | |
| 1594 "Face used for documentation strings in customization buffers." | |
| 1595 :group 'custom-faces) | |
| 1596 | |
| 1597 (defface custom-state-face '((((class color) | |
| 1598 (background dark)) | |
| 1599 (:foreground "lime green")) | |
| 1600 (((class color) | |
| 1601 (background light)) | |
| 1602 (:foreground "dark green")) | |
| 1603 (t nil)) | |
| 1604 "Face used for State descriptions in the customize buffer." | |
| 1605 :group 'custom-faces) | |
| 1606 | |
| 1607 (define-widget 'custom 'default | |
| 1608 "Customize a user option." | |
| 1609 :format "%v" | |
| 1610 :convert-widget 'custom-convert-widget | |
| 1611 :notify 'custom-notify | |
| 1612 :custom-prefix "" | |
| 1613 :custom-level 1 | |
| 1614 :custom-state 'hidden | |
| 1615 :documentation-property 'widget-subclass-responsibility | |
| 1616 :value-create 'widget-subclass-responsibility | |
| 1617 :value-delete 'widget-children-value-delete | |
| 1618 :value-get 'widget-value-value-get | |
| 1619 :validate 'widget-children-validate | |
| 1620 :match (lambda (widget value) (symbolp value))) | |
| 1621 | |
| 1622 (defun custom-convert-widget (widget) | |
| 1623 ;; Initialize :value and :tag from :args in WIDGET. | |
| 1624 (let ((args (widget-get widget :args))) | |
| 1625 (when args | |
| 1626 (widget-put widget :value (widget-apply widget | |
| 1627 :value-to-internal (car args))) | |
| 1628 (widget-put widget :tag (custom-unlispify-tag-name (car args))) | |
| 1629 (widget-put widget :args nil))) | |
| 1630 widget) | |
| 1631 | |
| 1632 (defun custom-notify (widget &rest args) | |
| 1633 "Keep track of changes." | |
| 1634 (let ((state (widget-get widget :custom-state))) | |
| 1635 (unless (eq state 'modified) | |
| 1636 (unless (memq state '(nil unknown hidden)) | |
| 1637 (widget-put widget :custom-state 'modified)) | |
| 1638 (custom-magic-reset widget) | |
| 1639 (apply 'widget-default-notify widget args)))) | |
| 1640 | |
| 1641 (defun custom-redraw (widget) | |
| 1642 "Redraw WIDGET with current settings." | |
| 1643 (let ((line (count-lines (point-min) (point))) | |
| 1644 (column (current-column)) | |
| 1645 (pos (point)) | |
| 1646 (from (marker-position (widget-get widget :from))) | |
| 1647 (to (marker-position (widget-get widget :to)))) | |
| 1648 (save-excursion | |
| 1649 (widget-value-set widget (widget-value widget)) | |
| 1650 (custom-redraw-magic widget)) | |
| 1651 (when (and (>= pos from) (<= pos to)) | |
| 1652 (condition-case nil | |
| 1653 (progn | |
| 1654 (if (> column 0) | |
| 1655 (goto-line line) | |
| 1656 (goto-line (1+ line))) | |
| 1657 (move-to-column column)) | |
| 1658 (error nil))))) | |
| 1659 | |
| 1660 (defun custom-redraw-magic (widget) | |
| 1661 "Redraw WIDGET state with current settings." | |
| 1662 (while widget | |
| 1663 (let ((magic (widget-get widget :custom-magic))) | |
| 1664 (cond (magic | |
| 1665 (widget-value-set magic (widget-value magic)) | |
| 1666 (when (setq widget (widget-get widget :group)) | |
| 1667 (custom-group-state-update widget))) | |
| 1668 (t | |
| 1669 (setq widget nil))))) | |
| 1670 (widget-setup)) | |
| 1671 | |
| 1672 (defun custom-show (widget value) | |
| 1673 "Non-nil if WIDGET should be shown with VALUE by default." | |
| 1674 (let ((show (widget-get widget :custom-show))) | |
| 1675 (cond ((null show) | |
| 1676 nil) | |
| 1677 ((eq t show) | |
| 1678 t) | |
| 1679 (t | |
| 1680 (funcall show widget value))))) | |
| 1681 | |
| 1682 (defvar custom-load-recursion nil | |
| 1683 "Hack to avoid recursive dependencies.") | |
| 1684 | |
| 1685 (defun custom-load-symbol (symbol) | |
| 1686 "Load all dependencies for SYMBOL." | |
|
5645
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1687 (labels |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1688 ((custom-load-symbol-1 (load) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1689 (cond ((symbolp load) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1690 (condition-case nil |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1691 (require load) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1692 (error nil))) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1693 ;; Don't reload a file already loaded. |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1694 ((and (boundp 'preloaded-file-list) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1695 (member load preloaded-file-list))) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1696 ((assoc load load-history)) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1697 ((assoc (locate-library load) load-history)) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1698 (t |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1699 (condition-case nil |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1700 ;; Without this, we would load cus-edit recursively. |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1701 ;; We are still loading it when we call this, |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1702 ;; and it is not in load-history yet. |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1703 (or (equal load "cus-edit") |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1704 (load-library load)) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1705 (error nil)))))) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1706 (unless custom-load-recursion |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1707 (let ((custom-load-recursion t)) |
|
5d3bb1100832
Remove some utility functions from the global namespace, lisp/
Aidan Kehoe <kehoea@parhasard.net>
parents:
5474
diff
changeset
|
1708 (map nil #'custom-load-symbol-1 (get symbol 'custom-loads)))))) |
| 2544 | 1709 |
| 1710 (defvar custom-already-loaded-custom-defines nil | |
| 1711 "List of already-loaded `custom-defines' files.") | |
| 1712 (defvar custom-define-current-source-file nil) | |
| 1713 (defvar custom-warn-when-reloading-necessary nil | |
| 1714 "For package-debugging purposes: Warn when an error hit in custom-defines.el. | |
| 1715 When this happens, the file from which the defcustom or defgroup was taken | |
| 1716 is loaded, and custom-defines.el is then reloaded. This works in most | |
| 1717 cases, but may not be completely safe. It's better if the package itself | |
| 1718 arranges for the necessary functions and variables to be available, using | |
| 1719 \;;;###autoload declarations. When this variable is non-nil, warnings are | |
| 1720 issued (with backtrace), to aid in tracking down the problems.") | |
| 1721 | |
| 1722 (defun custom-load-custom-defines (symbol) | |
| 1723 "Load custom-defines for SYMBOL." | |
| 1724 (unless custom-load-recursion | |
| 1725 (let ((custom-load-recursion t) | |
| 1726 (loads (get symbol 'custom-loads)) | |
| 1727 load) | |
| 1728 (while loads | |
| 1729 (setq load (car loads) | |
| 1730 loads (cdr loads)) | |
| 1731 (let* ((found (locate-library | |
| 1732 (if (symbolp load) (symbol-name load) load))) | |
| 1733 (dir (and found (file-name-directory found)))) | |
| 1734 ;; If we find a custom-defines file, assume the package is smart | |
| 1735 ;; enough to have put all its defcustoms and defgroups here, and | |
| 1736 ;; load it instead of the file itself. Otherwise, do it the | |
| 1737 ;; hard way. | |
| 1738 (if (and found (or (file-exists-p | |
| 1739 (expand-file-name "custom-defines.elc" dir)) | |
| 1740 (file-exists-p | |
| 1741 (expand-file-name "custom-defines.el" dir)))) | |
| 1742 (when (not (member dir custom-already-loaded-custom-defines)) | |
| 1743 (push dir custom-already-loaded-custom-defines) | |
| 1744 (custom-load-custom-defines-1 dir)))))))) | |
| 1745 | |
| 1746 (defun custom-load-custom-defines-1 (dir) | |
| 1747 ;; Actually load the custom-defines.el file in DIR. | |
| 1748 | |
| 1749 ;; If we get an error loading the custom-defines, it may be because of a | |
| 1750 ;; reference to something (e.g. a constant) that hasn't yet been defined | |
| 1751 ;; yet. Properly, these should have been marked, so they either go into | |
| 1752 ;; the custom-defines.el file or are autoloaded. But not everyone is so | |
| 1753 ;; careful, so for the moment we try to load the file that the | |
| 1754 ;; error-generating defcustom came from, and then reload the | |
| 1755 ;; custom-defines.el file. We might loop a number of times if we have | |
| 1756 ;; various files that need loading. If at any point we get an error that | |
| 1757 ;; can't be solved just by loading the appropriate file (e.g. we hit the | |
| 1758 ;; same error as before, the file is already loaded, etc.) then we signal | |
| 1759 ;; it as a real error. | |
| 1760 (let (source) | |
| 1761 ;; here's how this works: if we get an error loading custom-defines, | |
| 1762 ;; the condition handler is called; if we need to reload, we | |
| 1763 ;; `return-from', which throws out of the handler and returns nil from | |
| 1764 ;; the `block', which continues the while statement, executing the | |
| 1765 ;; `load' at the bottom of this function and then entering the block | |
| 1766 ;; again. if the condition handler doesn't throw, but instead returns | |
| 1767 ;; normally, `signal' will continue as if nothing happened, and end up | |
| 1768 ;; signalling the error normally. | |
| 1769 (while | |
| 1770 (not | |
| 1771 (block custom-load | |
| 1772 ;; Use call-with-condition-handler so the error can be seen | |
| 1773 ;; with the stack intact. | |
| 1774 (call-with-condition-handler | |
|
4806
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1775 ((macro |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1776 . (lambda (lambda-expression) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1777 ;; Be more serious about information hiding here: |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1778 (nsublis |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1779 '((custom-load-handler-arg . #:custom-load-g9JBHiZHD)) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1780 lambda-expression))) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1781 #'(lambda (custom-load-handler-arg) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1782 (when (and |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1783 custom-define-current-source-file |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1784 (progn |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1785 (setq source (expand-file-name |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1786 custom-define-current-source-file |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1787 dir)) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1788 (let ((nondir (file-name-nondirectory source))) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1789 (and (file-exists-p source) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1790 (not (assoc source load-history)) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1791 (not (assoc nondir load-history)) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1792 (not (and (boundp 'preloaded-file-list) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1793 (member nondir |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1794 preloaded-file-list))))))) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1795 (if custom-warn-when-reloading-necessary |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1796 (lwarn 'custom-defines 'warning |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1797 "Error while loading custom-defines, fetching \ |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1798 source and reloading ...\n |
| 2544 | 1799 Error: %s\n |
| 1800 Source file: %s\n\n | |
| 1801 Backtrace follows:\n\n%s" | |
|
4806
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1802 (error-message-string custom-load-handler-arg) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1803 source |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1804 (backtrace-in-condition-handler-eliminating-handler |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1805 'custom-load-handler-arg |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1806 ))) |
|
fd36a980d701
Use uninterned symbols in various information-hiding contexts.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4744
diff
changeset
|
1807 (return-from custom-load nil)))) |
| 2544 | 1808 #'(lambda () |
| 1809 (load (expand-file-name "custom-defines" dir)))))) | |
| 4178 | 1810 ;; we get here only from the `return-from'; see above |
| 2544 | 1811 (load source)))) |
| 428 | 1812 |
| 1813 (defun custom-load-widget (widget) | |
| 1814 "Load all dependencies for WIDGET." | |
| 1815 (custom-load-symbol (widget-value widget))) | |
| 1816 | |
| 1817 (defun custom-unloaded-symbol-p (symbol) | |
| 1818 "Return non-nil if the dependencies of SYMBOL has not yet been loaded." | |
| 1819 (let ((found nil) | |
| 1820 (loads (get symbol 'custom-loads)) | |
| 1821 load) | |
| 1822 (while loads | |
| 1823 (setq load (car loads) | |
| 1824 loads (cdr loads)) | |
| 1825 (cond ((symbolp load) | |
| 1826 (unless (featurep load) | |
| 1827 (setq found t))) | |
| 1828 ((assoc load load-history)) | |
| 1829 ((assoc (locate-library load) load-history) | |
| 1830 ;; #### WTF??? | |
| 1831 (message nil)) | |
| 1832 (t | |
| 1833 (setq found t)))) | |
| 1834 found)) | |
| 1835 | |
| 1836 (defun custom-unloaded-widget-p (widget) | |
| 1837 "Return non-nil if the dependencies of WIDGET has not yet been loaded." | |
| 1838 (custom-unloaded-symbol-p (widget-value widget))) | |
| 1839 | |
| 1840 (defun custom-toggle-hide (widget) | |
| 1841 "Toggle visibility of WIDGET." | |
| 1842 (custom-load-widget widget) | |
| 1843 (let ((state (widget-get widget :custom-state))) | |
| 1844 (cond ((memq state '(invalid modified)) | |
| 1845 (error "There are unset changes")) | |
| 1846 ((eq state 'hidden) | |
| 1847 (widget-put widget :custom-state 'unknown)) | |
| 1848 (t | |
| 1849 (widget-put widget :documentation-shown nil) | |
| 1850 (widget-put widget :custom-state 'hidden))) | |
| 1851 (custom-redraw widget) | |
| 1852 (widget-setup))) | |
| 1853 | |
| 1854 (defun custom-toggle-parent (widget &rest ignore) | |
| 1855 "Toggle visibility of parent of WIDGET." | |
| 1856 (custom-toggle-hide (widget-get widget :parent))) | |
| 1857 | |
| 1858 (defun custom-add-see-also (widget &optional prefix) | |
| 1859 "Add `See also ...' to WIDGET if there are any links. | |
| 1860 Insert PREFIX first if non-nil." | |
| 1861 (let* ((symbol (widget-get widget :value)) | |
| 1862 (links (get symbol 'custom-links)) | |
| 1863 (many (> (length links) 2)) | |
| 1864 (buttons (widget-get widget :buttons)) | |
| 1865 (indent (widget-get widget :indent))) | |
| 1866 (when links | |
| 1867 (when indent | |
| 1868 (insert-char ?\ indent)) | |
| 1869 (when prefix | |
| 1870 (insert prefix)) | |
| 1871 (insert "See also ") | |
| 1872 (while links | |
| 1873 (push (widget-create-child-and-convert widget (car links)) | |
| 1874 buttons) | |
| 1875 (setq links (cdr links)) | |
| 1876 (cond ((null links) | |
| 1877 (insert ".\n")) | |
| 1878 ((null (cdr links)) | |
| 1879 (if many | |
| 1880 (insert ", and ") | |
| 1881 (insert " and "))) | |
| 1882 (t | |
| 1883 (insert ", ")))) | |
| 1884 (widget-put widget :buttons buttons)))) | |
| 1885 | |
| 1886 (defun custom-add-parent-links (widget &optional initial-string) | |
| 1887 "Add \"Parent groups: ...\" to WIDGET if the group has parents. | |
| 1888 The value if non-nil if any parents were found. | |
| 1889 If INITIAL-STRING is non-nil, use that rather than \"Parent groups:\"." | |
| 1890 (let ((name (widget-value widget)) | |
| 1891 (type (widget-type widget)) | |
| 1892 (buttons (widget-get widget :buttons)) | |
| 1893 (start (point)) | |
| 1894 found) | |
| 1895 (insert (or initial-string "Parent groups:")) | |
| 1896 (maphash (lambda (group ignore) | |
| 1897 (let ((entry (assq name (get group 'custom-group)))) | |
| 1898 (when (eq (nth 1 entry) type) | |
| 1899 (insert " ") | |
| 1900 (push (widget-create-child-and-convert | |
| 1901 widget 'custom-group-link | |
| 1902 :tag (custom-unlispify-tag-name group) | |
| 1903 group) | |
| 1904 buttons) | |
| 1905 (setq found t)))) | |
| 1906 custom-group-hash-table) | |
| 1907 (widget-put widget :buttons buttons) | |
| 1908 (if found | |
| 1909 (insert "\n") | |
| 1910 (delete-region start (point))) | |
| 1911 found)) | |
| 1912 | |
| 1913 ;;; The `custom-comment' Widget. | |
| 1914 | |
| 1915 ;; like the editable field | |
| 1916 (defface custom-comment-face '((((class grayscale color) | |
| 1917 (background light)) | |
| 1918 (:background "gray85")) | |
| 1919 (((class grayscale color) | |
| 1920 (background dark)) | |
| 1921 (:background "dim gray")) | |
| 1922 (t | |
| 1923 (:italic t))) | |
| 1924 "Face used for comments on variables or faces" | |
| 1925 :group 'custom-faces) | |
| 1926 | |
| 1927 ;; like font-lock-comment-face | |
| 1928 (defface custom-comment-tag-face | |
| 1929 '((((class color) (background dark)) (:foreground "gray80")) | |
| 1930 (((class color) (background light)) (:foreground "blue4")) | |
| 1931 (((class grayscale) (background light)) | |
| 1932 (:foreground "DimGray" :bold t :italic t)) | |
| 1933 (((class grayscale) (background dark)) | |
| 1934 (:foreground "LightGray" :bold t :italic t)) | |
| 1935 (t (:bold t))) | |
| 1936 "Face used for variables or faces comment tags" | |
| 1937 :group 'custom-faces) | |
| 1938 | |
| 1939 (define-widget 'custom-comment 'string | |
| 1940 "User comment" | |
| 1941 :tag "Comment" | |
| 1942 :help-echo "Edit a comment here" | |
| 1943 :sample-face 'custom-comment-tag-face | |
| 1944 :value-face 'custom-comment-face | |
| 1945 :value-set 'custom-comment-value-set | |
| 1946 :create 'custom-comment-create | |
| 1947 :delete 'custom-comment-delete) | |
| 1948 | |
| 1949 (defun custom-comment-create (widget) | |
| 1950 (let (ext) | |
| 1951 (widget-default-create widget) | |
| 1952 (widget-put widget :comment-extent | |
| 1953 (setq ext (make-extent (widget-get widget :from) | |
| 1954 (widget-get widget :to)))) | |
| 1955 (set-extent-property ext 'start-open t) | |
| 1956 (when (equal (widget-get widget :value) "") | |
| 1957 (set-extent-property ext 'invisible t)) | |
| 1958 )) | |
| 1959 | |
| 1960 (defun custom-comment-delete (widget) | |
| 1961 (widget-default-delete widget) | |
| 1962 (delete-extent (widget-get widget :comment-extent))) | |
| 1963 | |
| 1964 (defun custom-comment-value-set (widget value) | |
| 1965 (widget-default-value-set widget value) | |
| 1966 (if (equal value "") | |
| 1967 (set-extent-property (widget-get widget :comment-extent) | |
| 1968 'invisible t) | |
| 1969 (set-extent-property (widget-get widget :comment-extent) | |
| 1970 'invisible nil))) | |
| 1971 | |
| 1972 ;; Those functions are for the menu. WIDGET is NOT the comment widget. It's | |
| 1973 ;; the global custom one | |
| 1974 (defun custom-comment-show (widget) | |
| 1975 (set-extent-property | |
| 1976 (widget-get (widget-get widget :comment-widget) :comment-extent) | |
| 1977 'invisible nil)) | |
| 1978 | |
| 1979 (defun custom-comment-invisible-p (widget) | |
| 1980 (extent-property | |
| 1981 (widget-get (widget-get widget :comment-widget) :comment-extent) | |
| 1982 'invisible)) | |
| 1983 | |
| 1984 ;;; The `custom-variable' Widget. | |
| 1985 | |
| 1986 (defface custom-variable-tag-face '((((class color) | |
| 1987 (background dark)) | |
| 1988 (:foreground "light blue" :underline t)) | |
| 1989 (((class color) | |
| 1990 (background light)) | |
| 1991 (:foreground "blue" :underline t)) | |
| 1992 (t (:underline t))) | |
| 1993 "Face used for unpushable variable tags." | |
| 1994 :group 'custom-faces) | |
| 1995 | |
| 1996 (defface custom-variable-button-face '((t (:underline t :bold t))) | |
| 1997 "Face used for pushable variable tags." | |
| 1998 :group 'custom-faces) | |
| 1999 | |
| 2000 (defcustom custom-variable-default-form 'edit | |
| 2001 "Default form of displaying variable values." | |
| 2002 :type '(choice (const edit) | |
| 2003 (const lisp)) | |
| 2004 :group 'custom-buffer) | |
| 2005 | |
| 2006 (define-widget 'custom-variable 'custom | |
| 2007 "Customize variable." | |
| 2008 :format "%v" | |
| 2009 :help-echo "Set or reset this variable" | |
| 2010 :documentation-property 'variable-documentation | |
| 2011 :custom-category 'option | |
| 2012 :custom-state nil | |
| 2013 :custom-menu 'custom-variable-menu-create | |
| 2014 :custom-form nil ; defaults to value of `custom-variable-default-form' | |
| 2015 :value-create 'custom-variable-value-create | |
| 2016 :action 'custom-variable-action | |
| 2017 :custom-set 'custom-variable-set | |
| 480 | 2018 :custom-pre-save 'custom-variable-pre-save |
| 428 | 2019 :custom-save 'custom-variable-save |
| 480 | 2020 :custom-post-save 'custom-variable-post-save |
| 428 | 2021 :custom-reset-current 'custom-redraw |
| 2022 :custom-reset-saved 'custom-variable-reset-saved | |
| 480 | 2023 :custom-pre-reset-standard 'custom-variable-pre-reset-standard |
| 2024 :custom-reset-standard 'custom-variable-reset-standard | |
| 2025 :custom-post-reset-standard 'custom-variable-post-reset-standard) | |
| 428 | 2026 |
| 2027 (defun custom-variable-type (symbol) | |
| 2028 "Return a widget suitable for editing the value of SYMBOL. | |
| 2029 If SYMBOL has a `custom-type' property, use that. | |
| 2030 Otherwise, look up symbol in `custom-guess-type-alist'." | |
| 2031 (let* ((type (or (get symbol 'custom-type) | |
| 2032 (and (not (get symbol 'standard-value)) | |
| 2033 (custom-guess-type symbol)) | |
| 2034 'sexp)) | |
| 2035 (options (get symbol 'custom-options)) | |
| 2036 (tmp (if (listp type) | |
| 2037 (copy-sequence type) | |
| 2038 (list type)))) | |
| 2039 (when options | |
| 2040 (widget-put tmp :options options)) | |
| 2041 tmp)) | |
| 2042 | |
| 2043 (defun custom-variable-value-create (widget) | |
| 2044 "Here is where you edit the variables value." | |
| 2045 (custom-load-widget widget) | |
| 2046 (unless (widget-get widget :custom-form) | |
| 2047 (widget-put widget :custom-form custom-variable-default-form)) | |
| 2048 (let* ((buttons (widget-get widget :buttons)) | |
| 2049 (children (widget-get widget :children)) | |
| 2050 (form (widget-get widget :custom-form)) | |
| 2051 (state (widget-get widget :custom-state)) | |
| 2052 (symbol (widget-get widget :value)) | |
| 2053 (tag (widget-get widget :tag)) | |
| 2054 (type (custom-variable-type symbol)) | |
| 2055 (conv (widget-convert type)) | |
| 2056 (get (or (get symbol 'custom-get) 'default-value)) | |
| 2057 (prefix (widget-get widget :custom-prefix)) | |
| 2058 (last (widget-get widget :custom-last)) | |
| 2059 (value (if (default-boundp symbol) | |
| 2060 (funcall get symbol) | |
| 2061 (widget-get conv :value)))) | |
| 2062 ;; If the widget is new, the child determine whether it is hidden. | |
| 2063 (cond (state) | |
| 2064 ((custom-show type value) | |
| 2065 (setq state 'unknown)) | |
| 2066 (t | |
| 2067 (setq state 'hidden))) | |
| 2068 ;; If we don't know the state, see if we need to edit it in lisp form. | |
| 2069 (when (eq state 'unknown) | |
| 2070 (unless (widget-apply conv :match value) | |
| 2071 ;; (widget-apply (widget-convert type) :match value) | |
| 2072 (setq form 'mismatch))) | |
| 2073 ;; Now we can create the child widget. | |
| 2074 (cond ((eq custom-buffer-style 'tree) | |
| 2075 (insert prefix (if last " `--- " " |--- ")) | |
| 2076 (push (widget-create-child-and-convert | |
| 2077 widget 'custom-browse-variable-tag) | |
| 2078 buttons) | |
| 2079 (insert " " tag "\n") | |
| 2080 (widget-put widget :buttons buttons)) | |
| 2081 ((eq state 'hidden) | |
| 2082 ;; Indicate hidden value. | |
| 2083 (push (widget-create-child-and-convert | |
| 2084 widget 'item | |
| 2085 :format "%{%t%}: " | |
| 2086 :sample-face 'custom-variable-tag-face | |
| 2087 :tag tag | |
| 2088 :parent widget) | |
| 2089 buttons) | |
| 2090 (push (widget-create-child-and-convert | |
| 2091 widget 'visibility | |
| 2092 :help-echo "Show the value of this option" | |
| 2093 :action 'custom-toggle-parent | |
| 2094 nil) | |
| 2095 buttons)) | |
| 2096 ((memq form '(lisp mismatch)) | |
| 2097 ;; In lisp mode edit the saved value when possible. | |
| 2098 (let* ((value (cond ((get symbol 'saved-value) | |
| 2099 (car (get symbol 'saved-value))) | |
| 2100 ((get symbol 'standard-value) | |
| 2101 (car (get symbol 'standard-value))) | |
| 2102 ((default-boundp symbol) | |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2103 (quote-maybe (funcall get symbol))) |
| 428 | 2104 (t |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2105 (quote-maybe (widget-get conv :value)))))) |
| 428 | 2106 (insert (symbol-name symbol) ": ") |
| 2107 (push (widget-create-child-and-convert | |
| 2108 widget 'visibility | |
| 2109 :help-echo "Hide the value of this option" | |
| 2110 :action 'custom-toggle-parent | |
| 2111 t) | |
| 2112 buttons) | |
| 2113 (insert " ") | |
| 2114 (push (widget-create-child-and-convert | |
| 2115 widget 'sexp | |
| 2116 :button-face 'custom-variable-button-face | |
| 2117 :format "%v" | |
| 2118 :tag (symbol-name symbol) | |
| 2119 :parent widget | |
| 2120 :value value) | |
| 2121 children))) | |
| 2122 (t | |
| 2123 ;; Edit mode. | |
| 2124 (let* ((format (widget-get type :format)) | |
| 2125 tag-format value-format) | |
| 2126 (while (not (string-match ":" format)) | |
| 2127 (setq format (signal 'error (list "Bad format" format)))) | |
| 2128 (setq tag-format (substring format 0 (match-end 0))) | |
| 2129 (setq value-format (substring format (match-end 0))) | |
| 2130 (push (widget-create-child-and-convert | |
| 2131 widget 'item | |
| 2132 :format tag-format | |
| 2133 :action 'custom-tag-action | |
| 2134 :help-echo "Change value of this option" | |
| 2135 :mouse-down-action 'custom-tag-mouse-down-action | |
| 2136 :button-face 'custom-variable-button-face | |
| 2137 :sample-face 'custom-variable-tag-face | |
| 2138 tag) | |
| 2139 buttons) | |
| 2140 (insert " ") | |
| 2141 (push (widget-create-child-and-convert | |
| 2142 widget 'visibility | |
| 2143 :help-echo "Hide the value of this option" | |
| 2144 :action 'custom-toggle-parent | |
| 2145 t) | |
| 2146 buttons) | |
| 2147 (push (widget-create-child-and-convert | |
| 2148 widget type | |
| 2149 :format value-format | |
| 2150 :value value) | |
| 2151 children)))) | |
| 2152 (unless (eq custom-buffer-style 'tree) | |
| 2153 (unless (eq (preceding-char) ?\n) | |
| 2154 (widget-insert "\n")) | |
| 2155 ;; Create the magic button. | |
| 2156 (let ((magic (widget-create-child-and-convert | |
| 2157 widget 'custom-magic nil))) | |
| 2158 (widget-put widget :custom-magic magic) | |
| 2159 (push magic buttons)) | |
| 2160 ;; Insert documentation. | |
| 440 | 2161 ;; #### NOTE: this is ugly!!!! I need to do update the :buttons property |
| 428 | 2162 ;; before the call to `widget-default-format-handler'. Otherwise, I |
| 444 | 2163 ;; lose my current `buttons'. This function shouldn't be called like |
| 428 | 2164 ;; this anyway. The doc string widget should be added like the others. |
| 2165 ;; --dv | |
| 2166 (widget-put widget :buttons buttons) | |
| 2167 (widget-default-format-handler widget ?h) | |
| 2168 ;; The comment field | |
| 2169 (unless (eq state 'hidden) | |
| 2170 (let* ((comment (get symbol 'variable-comment)) | |
| 2171 (comment-widget | |
| 2172 (widget-create-child-and-convert | |
| 2173 widget 'custom-comment | |
| 2174 :parent widget | |
| 2175 :value (or comment "")))) | |
| 2176 (widget-put widget :comment-widget comment-widget) | |
| 2177 ;; Don't push it !!! Custom assumes that the first child is the | |
| 2178 ;; value one. | |
| 2179 (setq children (append children (list comment-widget))))) | |
| 2118 | 2180 ;; Update the rest of the properties. |
| 428 | 2181 (widget-put widget :custom-form form) |
| 2182 (widget-put widget :children children) | |
| 2183 ;; Now update the state. | |
| 2184 (if (eq state 'hidden) | |
| 2185 (widget-put widget :custom-state state) | |
| 2186 (custom-variable-state-set widget)) | |
| 2187 ;; See also. | |
| 2188 (unless (eq state 'hidden) | |
| 2189 (when (eq (widget-get widget :custom-level) 1) | |
| 2190 (custom-add-parent-links widget)) | |
| 2191 (custom-add-see-also widget))))) | |
| 2192 | |
| 2193 (defun custom-tag-action (widget &rest args) | |
| 2194 "Pass :action to first child of WIDGET's parent." | |
| 2195 (apply 'widget-apply (car (widget-get (widget-get widget :parent) :children)) | |
| 2196 :action args)) | |
| 2197 | |
| 2198 (defun custom-tag-mouse-down-action (widget &rest args) | |
| 2199 "Pass :mouse-down-action to first child of WIDGET's parent." | |
| 2200 (apply 'widget-apply (car (widget-get (widget-get widget :parent) :children)) | |
| 2201 :mouse-down-action args)) | |
| 2202 | |
| 2203 (defun custom-variable-state-set (widget) | |
| 2204 "Set the state of WIDGET." | |
| 2205 (let* ((symbol (widget-value widget)) | |
| 2206 (get (or (get symbol 'custom-get) 'default-value)) | |
| 2207 (value (if (default-boundp symbol) | |
| 2208 (funcall get symbol) | |
| 2209 (widget-get widget :value))) | |
| 2210 (comment (get symbol 'variable-comment)) | |
| 2211 tmp | |
| 2212 temp | |
| 2213 (state (cond ((progn (setq tmp (get symbol 'customized-value)) | |
| 2214 (setq temp | |
| 2215 (get symbol 'customized-variable-comment)) | |
| 2216 (or tmp temp)) | |
| 2217 (if (condition-case nil | |
| 2218 (and (equal value (eval (car tmp))) | |
| 2219 (equal comment temp)) | |
| 2220 (error nil)) | |
| 2221 'set | |
| 2222 'changed)) | |
| 2223 ((progn (setq tmp (get symbol 'saved-value)) | |
| 2224 (setq temp (get symbol 'saved-variable-comment)) | |
| 2225 (or tmp temp)) | |
| 2226 (if (condition-case nil | |
| 2227 (and (equal value (eval (car tmp))) | |
| 2228 (equal comment temp)) | |
| 2229 (error nil)) | |
| 2230 'saved | |
| 2231 'changed)) | |
| 2232 ((setq tmp (get symbol 'standard-value)) | |
| 2233 (if (condition-case nil | |
| 2234 (and (equal value (eval (car tmp))) | |
| 2235 (equal comment nil)) | |
| 2236 (error nil)) | |
| 2237 'standard | |
| 2238 'changed)) | |
| 2239 (t 'rogue)))) | |
| 2240 (widget-put widget :custom-state state))) | |
| 2241 | |
| 2242 (defvar custom-variable-menu | |
| 4289 | 2243 `(("Set for Current Session" custom-variable-set |
| 2244 ,#'(lambda (widget) | |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2245 (eq (widget-get widget :custom-state) 'modified))) |
| 428 | 2246 ("Save for Future Sessions" custom-variable-save |
| 4289 | 2247 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2248 (memq (widget-get widget :custom-state) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2249 '(modified set changed rogue)))) |
| 428 | 2250 ("Reset to Current" custom-redraw |
| 4289 | 2251 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2252 (and (default-boundp (widget-value widget)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2253 (memq (widget-get widget :custom-state) '(modified changed))))) |
| 428 | 2254 ("Reset to Saved" custom-variable-reset-saved |
| 4289 | 2255 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2256 (and (or (get (widget-value widget) 'saved-value) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2257 (get (widget-value widget) 'saved-variable-comment)) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2258 (memq (widget-get widget :custom-state) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2259 '(modified set changed rogue))))) |
| 428 | 2260 ("Reset to Standard Settings" custom-variable-reset-standard |
| 4289 | 2261 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2262 (and (get (widget-value widget) 'standard-value) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2263 (memq (widget-get widget :custom-state) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2264 '(modified set changed saved rogue))))) |
| 428 | 2265 ("---" ignore ignore) |
| 2266 ("Add Comment" custom-comment-show custom-comment-invisible-p) | |
| 2267 ("---" ignore ignore) | |
| 2268 ("Don't show as Lisp expression" custom-variable-edit | |
| 4289 | 2269 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2270 (eq (widget-get widget :custom-form) 'lisp))) |
| 428 | 2271 ("Show as Lisp expression" custom-variable-edit-lisp |
| 4289 | 2272 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2273 (eq (widget-get widget :custom-form) 'edit)))) |
| 428 | 2274 "Alist of actions for the `custom-variable' widget. |
| 2275 Each entry has the form (NAME ACTION FILTER) where NAME is the name of | |
| 2276 the menu entry, ACTION is the function to call on the widget when the | |
| 2277 menu is selected, and FILTER is a predicate which takes a `custom-variable' | |
| 2278 widget as an argument, and returns non-nil if ACTION is valid on that | |
| 2279 widget. If FILTER is nil, ACTION is always valid.") | |
| 2280 | |
| 2281 (defun custom-variable-action (widget &optional event) | |
| 2282 "Show the menu for `custom-variable' WIDGET. | |
| 2283 Optional EVENT is the location for the menu." | |
| 2284 (if (eq (widget-get widget :custom-state) 'hidden) | |
| 2285 (custom-toggle-hide widget) | |
| 2286 (unless (eq (widget-get widget :custom-state) 'modified) | |
| 2287 (custom-variable-state-set widget)) | |
| 2288 ;; Redrawing magic also depresses the state glyph. | |
| 2289 ;(custom-redraw-magic widget) | |
| 2290 (let* ((completion-ignore-case t) | |
| 2291 (answer (widget-choose (concat "Operation on " | |
| 2292 (custom-unlispify-tag-name | |
| 2293 (widget-get widget :value))) | |
| 2294 (custom-menu-filter custom-variable-menu | |
| 2295 widget) | |
| 2296 event))) | |
| 2297 (if answer | |
| 2298 (funcall answer widget))))) | |
| 2299 | |
| 2300 (defun custom-variable-edit (widget) | |
| 2301 "Edit value of WIDGET." | |
| 2302 (widget-put widget :custom-state 'unknown) | |
| 2303 (widget-put widget :custom-form 'edit) | |
| 2304 (custom-redraw widget)) | |
| 2305 | |
| 2306 (defun custom-variable-edit-lisp (widget) | |
| 2307 "Edit the lisp representation of the value of WIDGET." | |
| 2308 (widget-put widget :custom-state 'unknown) | |
| 2309 (widget-put widget :custom-form 'lisp) | |
| 2310 (custom-redraw widget)) | |
| 2311 | |
| 2312 (defun custom-variable-set (widget) | |
| 2313 "Set the current value for the variable being edited by WIDGET." | |
| 2314 (let* ((form (widget-get widget :custom-form)) | |
| 2315 (state (widget-get widget :custom-state)) | |
| 2316 (child (car (widget-get widget :children))) | |
| 2317 (symbol (widget-value widget)) | |
| 2318 (set (or (get symbol 'custom-set) 'set-default)) | |
| 2319 (comment-widget (widget-get widget :comment-widget)) | |
| 2320 (comment (widget-value comment-widget)) | |
| 2321 val) | |
| 2322 (cond ((eq state 'hidden) | |
| 2323 (error "Cannot set hidden variable")) | |
| 2324 ((setq val (widget-apply child :validate)) | |
| 2325 (goto-char (widget-get val :from)) | |
| 2326 (error "%s" (widget-get val :error))) | |
| 2327 ((memq form '(lisp mismatch)) | |
| 2328 (when (equal comment "") | |
| 2329 (setq comment nil) | |
| 2330 ;; Make the comment invisible by hand if it's empty | |
| 2331 (set-extent-property (widget-get comment-widget :comment-extent) | |
| 2332 'invisible t)) | |
| 2333 (funcall set symbol (eval (setq val (widget-value child)))) | |
| 2334 (put symbol 'customized-value (list val)) | |
| 2335 (put symbol 'variable-comment comment) | |
| 2336 (put symbol 'customized-variable-comment comment)) | |
| 2337 (t | |
| 2338 (when (equal comment "") | |
| 2339 (setq comment nil) | |
| 2340 ;; Make the comment invisible by hand if it's empty | |
| 2341 (set-extent-property (widget-get comment-widget :comment-extent) | |
| 2342 'invisible t)) | |
| 2343 (funcall set symbol (setq val (widget-value child))) | |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2344 (put symbol 'customized-value (list (quote-maybe val))) |
| 428 | 2345 (put symbol 'variable-comment comment) |
| 2346 (put symbol 'customized-variable-comment comment))) | |
| 2347 (custom-variable-state-set widget) | |
| 2348 (custom-redraw-magic widget))) | |
| 2349 | |
| 480 | 2350 (defun custom-variable-pre-save (widget) |
| 2351 "Prepare for saving the value for the variable being edited by WIDGET." | |
| 428 | 2352 (let* ((form (widget-get widget :custom-form)) |
| 2353 (state (widget-get widget :custom-state)) | |
| 2354 (child (car (widget-get widget :children))) | |
| 2355 (symbol (widget-value widget)) | |
| 2356 (set (or (get symbol 'custom-set) 'set-default)) | |
| 2357 (comment-widget (widget-get widget :comment-widget)) | |
| 2358 (comment (widget-value comment-widget)) | |
| 2359 val) | |
| 2360 (cond ((eq state 'hidden) | |
| 2361 (error "Cannot set hidden variable")) | |
| 2362 ((setq val (widget-apply child :validate)) | |
| 2363 (goto-char (widget-get val :from)) | |
| 2364 (error "%s" (widget-get val :error))) | |
| 2365 ((memq form '(lisp mismatch)) | |
| 2366 (when (equal comment "") | |
| 2367 (setq comment nil) | |
| 2368 ;; Make the comment invisible by hand if it's empty | |
| 2369 (set-extent-property (widget-get comment-widget :comment-extent) | |
| 2370 'invisible t)) | |
| 2371 (put symbol 'saved-value (list (widget-value child))) | |
| 2372 (custom-push-theme 'theme-value symbol 'user | |
| 2373 'set (list (widget-value child))) | |
| 2374 (funcall set symbol (eval (widget-value child))) | |
| 2375 (put symbol 'variable-comment comment) | |
| 2376 (put symbol 'saved-variable-comment comment)) | |
| 2377 (t | |
| 2378 (when (equal comment "") | |
| 2379 (setq comment nil) | |
| 2380 ;; Make the comment invisible by hand if it's empty | |
| 2381 (set-extent-property (widget-get comment-widget :comment-extent) | |
| 2382 'invisible t)) | |
| 2383 (put symbol | |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2384 'saved-value (list (quote-maybe (widget-value |
|
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2385 child)))) |
| 428 | 2386 (custom-push-theme 'theme-value symbol 'user |
|
4744
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2387 'set (list (quote-maybe (widget-value |
|
17f7e9191c0b
Rationalise duplicated functionality, #'custom-quote, #'quote-maybe.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4701
diff
changeset
|
2388 child)))) |
| 428 | 2389 (funcall set symbol (widget-value child)) |
| 2390 (put symbol 'variable-comment comment) | |
| 2391 (put symbol 'saved-variable-comment comment))) | |
| 2392 (put symbol 'customized-value nil) | |
| 2393 (put symbol 'customized-variable-comment nil) | |
| 480 | 2394 )) |
| 2395 | |
| 2396 (defun custom-variable-post-save (widget) | |
| 2397 "Finish saving the variable being edited by WIDGET." | |
| 2398 (custom-variable-state-set widget) | |
| 2399 (custom-redraw-magic widget)) | |
| 2400 | |
| 2401 (defun custom-variable-save (widget) | |
| 2402 "Set and save the value for the variable being edited by WIDGET." | |
| 2403 (custom-variable-pre-save widget) | |
| 2404 (custom-save-all) | |
| 2405 (custom-variable-post-save widget)) | |
| 428 | 2406 |
| 2407 (defun custom-variable-reset-saved (widget) | |
| 2408 "Restore the saved value for the variable being edited by WIDGET." | |
| 2409 (let* ((symbol (widget-value widget)) | |
| 2410 (set (or (get symbol 'custom-set) 'set-default)) | |
| 2411 (value (get symbol 'saved-value)) | |
| 2412 (comment (get symbol 'saved-variable-comment))) | |
| 2413 (cond ((or value comment) | |
| 2414 (put symbol 'variable-comment comment) | |
| 2415 (condition-case nil | |
| 2416 (funcall set symbol (eval (car value))) | |
| 2417 (error nil))) | |
| 2418 (t | |
| 2419 (signal 'error (list "No saved value for variable" symbol)))) | |
| 2420 (put symbol 'customized-value nil) | |
| 2421 (put symbol 'customized-variable-comment nil) | |
| 2422 (widget-put widget :custom-state 'unknown) | |
| 2423 ;; This call will possibly make the comment invisible | |
| 2424 (custom-redraw widget))) | |
| 2425 | |
| 480 | 2426 ;; This function returns non nil if we need to re-save the options --dv. |
| 2427 (defun custom-variable-pre-reset-standard (widget) | |
| 2428 "Prepare for restoring the variable being edited by WIDGET to its | |
| 2429 standard setting." | |
| 428 | 2430 (let* ((symbol (widget-value widget)) |
| 442 | 2431 (set (or (get symbol 'custom-set) 'set-default))) |
| 428 | 2432 (if (get symbol 'standard-value) |
| 2433 (funcall set symbol (eval (car (get symbol 'standard-value)))) | |
| 2434 (signal 'error (list "No standard setting known for variable" symbol))) | |
| 2435 (put symbol 'variable-comment nil) | |
| 2436 (put symbol 'customized-value nil) | |
| 2437 (put symbol 'customized-variable-comment nil) | |
| 2438 (when (or (get symbol 'saved-value) (get symbol 'saved-variable-comment)) | |
| 2439 (put symbol 'saved-value nil) | |
| 2440 (custom-push-theme 'theme-value symbol 'user 'reset 'standard) | |
|
5384
3889ef128488
Fix misspelled words, and some grammar, across the entire source tree.
Jerry James <james@xemacs.org>
parents:
5366
diff
changeset
|
2441 ;; As a special optimization we do not (explicitly) |
| 480 | 2442 ;; save resets to standard when no theme sets the value. |
| 428 | 2443 (if (null (cdr (get symbol 'theme-value))) |
| 2444 (put symbol 'theme-value nil)) | |
| 2445 (put symbol 'saved-variable-comment nil) | |
| 480 | 2446 widget) |
| 2447 )) | |
| 2448 | |
| 2449 (defun custom-variable-post-reset-standard (widget) | |
| 2450 "Finish resetting the variable being edited by WIDGET to its standard | |
| 2451 value." | |
| 2452 (widget-put widget :custom-state 'unknown) | |
| 2453 ;; This call will possibly make the comment invisible | |
| 2454 (custom-redraw widget)) | |
| 2455 | |
| 2456 (defun custom-variable-reset-standard (widget) | |
| 2457 "Restore the standard setting for the variable being edited by WIDGET." | |
| 2458 (when (custom-variable-pre-reset-standard widget) | |
| 2459 (custom-save-all)) | |
| 2460 (custom-variable-post-reset-standard widget)) | |
| 2461 | |
| 428 | 2462 |
| 2463 ;;; The `custom-face-edit' Widget. | |
| 2464 | |
| 2465 (define-widget 'custom-face-edit 'checklist | |
| 2466 "Edit face attributes." | |
| 2467 :format "%t: %v" | |
| 2468 :tag "Attributes" | |
| 2469 :extra-offset 12 | |
| 438 | 2470 :button-args '(:help-echo "Control whether this attribute has any effect") |
| 428 | 2471 :args (mapcar (lambda (att) |
| 2472 (list 'group | |
| 2473 :inline t | |
| 2474 :sibling-args (widget-get (nth 1 att) :sibling-args) | |
| 2475 (list 'const :format "" :value (nth 0 att)) | |
| 2476 (nth 1 att))) | |
| 2477 custom-face-attributes)) | |
| 2478 | |
| 2479 ;;; The `custom-display' Widget. | |
| 2480 | |
| 2481 (define-widget 'custom-display 'menu-choice | |
| 2482 "Select a display type." | |
| 2483 :tag "Display" | |
| 2484 :value t | |
| 2485 :help-echo "Specify frames where the face attributes should be used" | |
| 2486 :args '((const :tag "all" t) | |
| 2487 (checklist | |
| 2488 :offset 0 | |
| 2489 :extra-offset 9 | |
| 2490 :args ((group :sibling-args (:help-echo "\ | |
| 2491 Only match the specified window systems") | |
| 2492 (const :format "Type: " | |
| 2493 type) | |
| 2494 (checklist :inline t | |
| 2495 :offset 0 | |
| 2496 (const :format "X " | |
| 2497 :sibling-args (:help-echo "\ | |
| 2498 The X11 Window System") | |
| 2499 x) | |
| 555 | 2500 (const :format "GTK " |
| 2501 :sibling-args (:help-echo "\ | |
| 2502 The GTK Window System") | |
| 2503 gtk) | |
| 428 | 2504 (const :format "PM " |
| 2505 :sibling-args (:help-echo "\ | |
| 2506 OS/2 Presentation Manager") | |
| 2507 pm) | |
| 2508 (const :format "MSWindows " | |
| 2509 :sibling-args (:help-echo "\ | |
| 440 | 2510 Microsoft Windows, displays") |
| 428 | 2511 mswindows) |
| 440 | 2512 (const :format "MSPrinter " |
| 428 | 2513 :sibling-args (:help-echo "\ |
| 440 | 2514 Microsoft Windows, printers") |
| 2515 msprinter) | |
| 428 | 2516 (const :format "TTY%n" |
| 2517 :sibling-args (:help-echo "\ | |
| 2518 Plain text terminals") | |
| 2519 tty))) | |
| 2520 (group :sibling-args (:help-echo "\ | |
| 440 | 2521 Only match display or printer devices") |
| 2522 (const :format "Output: " | |
| 2523 class) | |
| 2524 (checklist :inline t | |
| 2525 :offset 0 | |
| 2526 (const :format "Display " | |
| 2527 :sibling-args (:help-echo "\ | |
| 2528 Match display devices") | |
| 2529 display) | |
| 2530 (const :format "Printer%n" | |
| 2531 :sibling-args (:help-echo "\ | |
| 2532 Match printer devices") | |
| 2533 printer))) | |
| 2534 (group :sibling-args (:help-echo "\ | |
| 428 | 2535 Only match the frames with the specified color support") |
| 440 | 2536 (const :format "Color support: " |
| 428 | 2537 class) |
| 2538 (checklist :inline t | |
| 2539 :offset 0 | |
| 2540 (const :format "Color " | |
| 2541 :sibling-args (:help-echo "\ | |
| 2542 Match color frames") | |
| 2543 color) | |
| 2544 (const :format "Grayscale " | |
| 2545 :sibling-args (:help-echo "\ | |
| 2546 Match grayscale frames") | |
| 2547 grayscale) | |
| 2548 (const :format "Monochrome%n" | |
| 2549 :sibling-args (:help-echo "\ | |
| 2550 Match frames with no color support") | |
| 2551 mono))) | |
| 2552 (group :sibling-args (:help-echo "\ | |
| 2553 Only match frames with the specified intensity") | |
| 2554 (const :format "\ | |
| 2555 Background brightness: " | |
| 2556 background) | |
| 2557 (checklist :inline t | |
| 2558 :offset 0 | |
| 2559 (const :format "Light " | |
| 2560 :sibling-args (:help-echo "\ | |
| 2561 Match frames with light backgrounds") | |
| 2562 light) | |
| 2563 (const :format "Dark\n" | |
| 2564 :sibling-args (:help-echo "\ | |
| 2565 Match frames with dark backgrounds") | |
| 2566 dark))))))) | |
| 2567 | |
| 2568 ;;; The `custom-face' Widget. | |
| 2569 | |
| 2570 (defface custom-face-tag-face '((t (:underline t))) | |
| 2571 "Face used for face tags." | |
| 2572 :group 'custom-faces) | |
| 2573 | |
| 2574 (defcustom custom-face-default-form 'selected | |
| 2575 "Default form of displaying face definition." | |
| 2576 :type '(choice (const all) | |
| 2577 (const selected) | |
| 2578 (const lisp)) | |
| 2579 :group 'custom-buffer) | |
| 2580 | |
| 2581 (define-widget 'custom-face 'custom | |
| 2582 "Customize face." | |
| 2583 :sample-face 'custom-face-tag-face | |
| 2584 :help-echo "Set or reset this face" | |
| 4021 | 2585 :documentation-property #'(lambda (face) |
| 4178 | 2586 (face-doc-string face)) |
| 428 | 2587 :value-create 'custom-face-value-create |
| 2588 :action 'custom-face-action | |
| 2589 :custom-category 'face | |
| 2590 :custom-form nil ; defaults to value of `custom-face-default-form' | |
| 2591 :custom-set 'custom-face-set | |
| 480 | 2592 :custom-pre-save 'custom-face-pre-save |
| 428 | 2593 :custom-save 'custom-face-save |
| 480 | 2594 :custom-post-save 'custom-face-post-save |
| 428 | 2595 :custom-reset-current 'custom-redraw |
| 2596 :custom-reset-saved 'custom-face-reset-saved | |
| 480 | 2597 :custom-pre-reset-standard 'custom-face-pre-reset-standard |
| 428 | 2598 :custom-reset-standard 'custom-face-reset-standard |
| 480 | 2599 :custom-post-reset-standard 'custom-face-post-reset-standard |
| 428 | 2600 :custom-menu 'custom-face-menu-create) |
| 2601 | |
| 2602 (define-widget 'custom-face-all 'editable-list | |
| 2603 "An editable list of display specifications and attributes." | |
| 2604 :entry-format "%i %d %v" | |
| 2605 :insert-button-args '(:help-echo "Insert new display specification here") | |
| 2606 :append-button-args '(:help-echo "Append new display specification here") | |
| 2607 :delete-button-args '(:help-echo "Delete this display specification") | |
| 2608 :args '((group :format "%v" custom-display custom-face-edit))) | |
| 2609 | |
| 2610 (defconst custom-face-all (widget-convert 'custom-face-all) | |
| 2611 "Converted version of the `custom-face-all' widget.") | |
| 2612 | |
| 2613 (define-widget 'custom-display-unselected 'item | |
| 2614 "A display specification that doesn't match the selected display." | |
| 2615 :match 'custom-display-unselected-match) | |
| 2616 | |
| 2617 (defun custom-display-unselected-match (widget value) | |
| 2618 "Non-nil if VALUE is an unselected display specification." | |
| 2619 (not (face-spec-set-match-display value (selected-frame)))) | |
| 2620 | |
| 2621 (define-widget 'custom-face-selected 'group | |
| 2622 "Edit the attributes of the selected display in a face specification." | |
| 2623 :args '((repeat :format "" | |
| 2624 :inline t | |
| 2625 (group custom-display-unselected sexp)) | |
| 2626 (group (sexp :format "") custom-face-edit) | |
| 2627 (repeat :format "" | |
| 2628 :inline t | |
| 2629 sexp))) | |
| 2630 | |
| 2631 (defconst custom-face-selected (widget-convert 'custom-face-selected) | |
| 2632 "Converted version of the `custom-face-selected' widget.") | |
| 2633 | |
| 2634 (defun custom-face-value-create (widget) | |
| 2635 "Create a list of the display specifications for WIDGET." | |
| 2636 (let ((buttons (widget-get widget :buttons)) | |
| 2637 children | |
| 2638 (symbol (widget-get widget :value)) | |
| 2639 (tag (widget-get widget :tag)) | |
| 2640 (state (widget-get widget :custom-state)) | |
| 2641 (begin (point)) | |
| 2642 (is-last (widget-get widget :custom-last)) | |
| 2643 (prefix (widget-get widget :custom-prefix))) | |
| 2644 (unless tag | |
| 2645 (setq tag (prin1-to-string symbol))) | |
| 2646 (cond ((eq custom-buffer-style 'tree) | |
| 2647 (insert prefix (if is-last " `--- " " |--- ")) | |
| 2648 (push (widget-create-child-and-convert | |
| 2649 widget 'custom-browse-face-tag) | |
| 2650 buttons) | |
| 2651 (insert " " tag "\n") | |
| 2652 (widget-put widget :buttons buttons)) | |
| 2653 (t | |
| 2654 ;; Create tag. | |
| 2655 (insert tag) | |
| 2656 (if (eq custom-buffer-style 'face) | |
| 2657 (insert " ") | |
| 2658 (widget-specify-sample widget begin (point)) | |
| 2659 (insert ": ")) | |
| 2660 ;; Sample. | |
| 2661 (and (not (find-face symbol)) | |
| 2662 ;; XEmacs cannot display uninitialized faces. | |
| 2663 (make-face symbol)) | |
| 2664 (push (widget-create-child-and-convert widget 'item | |
| 2665 :format "(%{%t%})" | |
| 2666 :sample-face symbol | |
| 2667 :tag "sample") | |
| 2668 buttons) | |
| 2669 ;; Visibility. | |
| 2670 (insert " ") | |
| 2671 (push (widget-create-child-and-convert | |
| 2672 widget 'visibility | |
| 2673 :help-echo "Hide or show this face" | |
| 2674 :action 'custom-toggle-parent | |
| 2675 (not (eq state 'hidden))) | |
| 2676 buttons) | |
| 2677 ;; Magic. | |
| 2678 (insert "\n") | |
| 2679 (let ((magic (widget-create-child-and-convert | |
| 2680 widget 'custom-magic nil))) | |
| 2681 (widget-put widget :custom-magic magic) | |
| 2682 (push magic buttons)) | |
| 2683 ;; Update buttons. | |
| 2684 (widget-put widget :buttons buttons) | |
| 2685 ;; Insert documentation. | |
| 2686 (widget-default-format-handler widget ?h) | |
| 2687 ;; The comment field | |
| 2688 (unless (eq state 'hidden) | |
| 2689 (let* ((comment (get symbol 'face-comment)) | |
| 2690 (comment-widget | |
| 2691 (widget-create-child-and-convert | |
| 2692 widget 'custom-comment | |
| 2693 :parent widget | |
| 2694 :value (or comment "")))) | |
| 2695 (widget-put widget :comment-widget comment-widget) | |
| 2696 (push comment-widget children))) | |
| 2697 ;; See also. | |
| 2698 (unless (eq state 'hidden) | |
| 2699 (when (eq (widget-get widget :custom-level) 1) | |
| 2700 (custom-add-parent-links widget)) | |
| 2701 (custom-add-see-also widget)) | |
| 2702 ;; Editor. | |
| 2703 (unless (eq (preceding-char) ?\n) | |
| 2704 (insert "\n")) | |
| 2705 (unless (eq state 'hidden) | |
| 2706 (message "Creating face editor...") | |
| 2707 (custom-load-widget widget) | |
| 2708 (unless (widget-get widget :custom-form) | |
| 2709 (widget-put widget :custom-form custom-face-default-form)) | |
| 2710 (let* ((symbol (widget-value widget)) | |
| 2711 (spec (custom-face-get-spec symbol)) | |
| 2712 (form (widget-get widget :custom-form)) | |
| 2713 (indent (widget-get widget :indent)) | |
| 2714 (edit (widget-create-child-and-convert | |
| 2715 widget | |
| 2716 (cond ((and (eq form 'selected) | |
| 2717 (widget-apply custom-face-selected | |
| 2718 :match spec)) | |
| 2719 (when indent (insert-char ?\ indent)) | |
| 2720 'custom-face-selected) | |
| 2721 ((and (not (eq form 'lisp)) | |
| 2722 (widget-apply custom-face-all | |
| 2723 :match spec)) | |
| 2724 'custom-face-all) | |
| 2725 (t | |
| 2726 (when indent (insert-char ?\ indent)) | |
| 2727 'sexp)) | |
| 2728 :value spec))) | |
| 2729 (custom-face-state-set widget) | |
| 2730 (push edit children) | |
| 2731 (widget-put widget :children children)) | |
| 2732 (message "Creating face editor...done")))))) | |
| 2733 | |
| 2734 (defvar custom-face-menu | |
| 4289 | 2735 `(("Set for Current Session" custom-face-set) |
| 428 | 2736 ("Save for Future Sessions" custom-face-save) |
| 2737 ("Reset to Saved" custom-face-reset-saved | |
| 4289 | 2738 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2739 (or (get (widget-value widget) 'saved-face) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2740 (get (widget-value widget) 'saved-face-comment)))) |
| 428 | 2741 ("Reset to Standard Setting" custom-face-reset-standard |
| 4289 | 2742 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2743 (get (widget-value widget) 'face-defface-spec))) |
| 428 | 2744 ("---" ignore ignore) |
| 2745 ("Add Comment" custom-comment-show custom-comment-invisible-p) | |
| 2746 ("---" ignore ignore) | |
| 2747 ("Show all display specs" custom-face-edit-all | |
| 4289 | 2748 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2749 (not (eq (widget-get widget :custom-form) 'all)))) |
| 428 | 2750 ("Just current attributes" custom-face-edit-selected |
| 4289 | 2751 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2752 (not (eq (widget-get widget :custom-form) 'selected)))) |
| 428 | 2753 ("Show as Lisp expression" custom-face-edit-lisp |
| 4289 | 2754 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
2755 (not (eq (widget-get widget :custom-form) 'lisp))))) |
| 428 | 2756 "Alist of actions for the `custom-face' widget. |
| 2757 Each entry has the form (NAME ACTION FILTER) where NAME is the name of | |
| 2758 the menu entry, ACTION is the function to call on the widget when the | |
| 2759 menu is selected, and FILTER is a predicate which takes a `custom-face' | |
| 2760 widget as an argument, and returns non-nil if ACTION is valid on that | |
| 2761 widget. If FILTER is nil, ACTION is always valid.") | |
| 2762 | |
| 2763 (defun custom-face-edit-selected (widget) | |
| 2764 "Edit selected attributes of the value of WIDGET." | |
| 2765 (widget-put widget :custom-state 'unknown) | |
| 2766 (widget-put widget :custom-form 'selected) | |
| 2767 (custom-redraw widget)) | |
| 2768 | |
| 2769 (defun custom-face-edit-all (widget) | |
| 2770 "Edit all attributes of the value of WIDGET." | |
| 2771 (widget-put widget :custom-state 'unknown) | |
| 2772 (widget-put widget :custom-form 'all) | |
| 2773 (custom-redraw widget)) | |
| 2774 | |
| 2775 (defun custom-face-edit-lisp (widget) | |
| 2776 "Edit the lisp representation of the value of WIDGET." | |
| 2777 (widget-put widget :custom-state 'unknown) | |
| 2778 (widget-put widget :custom-form 'lisp) | |
| 2779 (custom-redraw widget)) | |
| 2780 | |
| 2781 (defun custom-face-state-set (widget) | |
| 2782 "Set the state of WIDGET." | |
| 2783 (let* ((symbol (widget-value widget)) | |
| 2784 (comment (get symbol 'face-comment)) | |
| 2785 tmp temp) | |
| 2786 (widget-put widget :custom-state | |
| 2787 (cond ((progn | |
| 2788 (setq tmp (get symbol 'customized-face)) | |
| 2789 (setq temp (get symbol 'customized-face-comment)) | |
| 2790 (or tmp temp)) | |
| 2791 (if (equal temp comment) | |
| 2792 'set | |
| 2793 'changed)) | |
| 2794 ((progn | |
| 2795 (setq tmp (get symbol 'saved-face)) | |
| 2796 (setq temp (get symbol 'saved-face-comment)) | |
| 2797 (or tmp temp)) | |
| 2798 (if (equal temp comment) | |
| 2799 'saved | |
| 2800 'changed)) | |
| 2801 ((get symbol 'face-defface-spec) | |
| 2802 (if (equal comment nil) | |
| 2803 'standard | |
| 2804 'changed)) | |
| 2805 (t | |
| 2806 'rogue))))) | |
| 2807 | |
| 2808 (defun custom-face-action (widget &optional event) | |
| 2809 "Show the menu for `custom-face' WIDGET. | |
| 2810 Optional EVENT is the location for the menu." | |
| 2811 (if (eq (widget-get widget :custom-state) 'hidden) | |
| 2812 (custom-toggle-hide widget) | |
| 2813 (let* ((completion-ignore-case t) | |
| 2814 (symbol (widget-get widget :value)) | |
| 2815 (answer (widget-choose (concat "Operation on " | |
| 2816 (custom-unlispify-tag-name symbol)) | |
| 2817 (custom-menu-filter custom-face-menu | |
| 2818 widget) | |
| 2819 event))) | |
| 2820 (if answer | |
| 2821 (funcall answer widget))))) | |
| 2822 | |
| 2823 (defun custom-face-set (widget) | |
| 2824 "Make the face attributes in WIDGET take effect." | |
| 2825 (let* ((symbol (widget-value widget)) | |
| 2826 (child (car (widget-get widget :children))) | |
| 2827 (value (widget-value child)) | |
| 2828 (comment-widget (widget-get widget :comment-widget)) | |
| 2829 (comment (widget-value comment-widget))) | |
| 2830 (when (equal comment "") | |
| 2831 (setq comment nil) | |
| 2832 ;; Make the comment invisible by hand if it's empty | |
| 2833 (set-extent-property (widget-get comment-widget :comment-extent) | |
| 2834 'invisible t)) | |
| 2835 (put symbol 'customized-face value) | |
| 2836 (face-spec-set symbol value nil '(custom)) | |
| 2837 (put symbol 'customized-face-comment comment) | |
| 2838 (put symbol 'face-comment comment) | |
| 2839 (custom-face-state-set widget) | |
| 2840 (custom-redraw-magic widget))) | |
| 2841 | |
| 480 | 2842 (defun custom-face-pre-save (widget) |
| 2843 "Prepare for saving the face being edited by WIDGET." | |
| 428 | 2844 (let* ((symbol (widget-value widget)) |
| 2845 (child (car (widget-get widget :children))) | |
| 2846 (value (widget-value child)) | |
| 2847 (comment-widget (widget-get widget :comment-widget)) | |
| 2848 (comment (widget-value comment-widget))) | |
| 2849 (when (equal comment "") | |
| 2850 (setq comment nil) | |
| 2851 ;; Make the comment invisible by hand if it's empty | |
| 2852 (set-extent-property (widget-get comment-widget :comment-extent) | |
| 2853 'invisible t)) | |
| 2854 (face-spec-set symbol value nil '(custom)) | |
| 2855 (put symbol 'saved-face value) | |
| 2856 (custom-push-theme 'theme-face symbol 'user 'set value) | |
| 2857 (put symbol 'customized-face nil) | |
| 2858 (put symbol 'face-comment comment) | |
| 2859 (put symbol 'customized-face-comment nil) | |
| 2860 (put symbol 'saved-face-comment comment) | |
| 480 | 2861 )) |
| 2862 | |
| 2863 (defun custom-face-post-save (widget) | |
| 2864 "Finish saving the face being edited by WIDGET." | |
| 2865 (custom-face-state-set widget) | |
| 2866 (custom-redraw-magic widget)) | |
| 2867 | |
| 2868 (defun custom-face-save (widget) | |
| 2869 "Save the face being edited by WIDGET." | |
| 2870 (custom-face-pre-save widget) | |
| 2871 (custom-save-all) | |
| 2872 (custom-face-post-save widget)) | |
| 428 | 2873 |
| 2874 (defun custom-face-reset-saved (widget) | |
| 480 | 2875 "Reset the face being edited by WIDGET to its saved value." |
| 428 | 2876 (let* ((symbol (widget-value widget)) |
| 2877 (child (car (widget-get widget :children))) | |
| 2878 (value (get symbol 'saved-face)) | |
| 2879 (comment (get symbol 'saved-face-comment)) | |
| 2880 (comment-widget (widget-get widget :comment-widget))) | |
| 2881 (unless (or value comment) | |
| 2882 (signal 'error (list "No saved value for this face" symbol))) | |
| 2883 (put symbol 'customized-face nil) | |
| 2884 (put symbol 'customized-face-comment nil) | |
| 2885 (face-spec-set symbol value nil '(custom)) | |
| 2886 (put symbol 'face-comment comment) | |
| 2887 (widget-value-set child value) | |
| 2888 ;; This call manages the comment visibility | |
| 2889 (widget-value-set comment-widget (or comment "")) | |
| 2890 (custom-face-state-set widget) | |
| 2891 (custom-redraw-magic widget))) | |
| 2892 | |
| 480 | 2893 ;; This function returns non nil if we need to re-save the options --dv. |
| 2894 (defun custom-face-pre-reset-standard (widget) | |
| 2895 "Prepare for restoring the face edited by WIDGET to its standard | |
| 2896 settings." | |
| 428 | 2897 (let* ((symbol (widget-value widget)) |
| 480 | 2898 (value (get symbol 'face-defface-spec))) |
| 428 | 2899 (unless value |
| 2900 (signal 'error (list "No standard setting for this face" symbol))) | |
| 2901 (put symbol 'customized-face nil) | |
| 2902 (put symbol 'customized-face-comment nil) | |
| 2903 (when (or (get symbol 'saved-face) (get symbol 'saved-face-comment)) | |
| 2904 (put symbol 'saved-face nil) | |
| 2905 (custom-push-theme 'theme-face symbol 'user 'reset 'standard) | |
|
5384
3889ef128488
Fix misspelled words, and some grammar, across the entire source tree.
Jerry James <james@xemacs.org>
parents:
5366
diff
changeset
|
2906 ;; Do not explicitly save resets to standards without themes. |
| 428 | 2907 (if (null (cdr (get symbol 'theme-face))) |
| 2908 (put symbol 'theme-face nil)) | |
| 2909 (put symbol 'saved-face-comment nil) | |
| 480 | 2910 widget) |
| 2911 )) | |
| 2912 | |
| 2913 (defun custom-face-post-reset-standard (widget) | |
| 2914 "Finish restoring the face edited by WIDGET to its standard settings." | |
| 2915 (let* ((symbol (widget-value widget)) | |
| 2916 (child (car (widget-get widget :children))) | |
| 2917 (value (get symbol 'face-defface-spec)) | |
| 2918 (comment-widget (widget-get widget :comment-widget))) | |
| 428 | 2919 (face-spec-set symbol value nil '(custom)) |
| 2920 (put symbol 'face-comment nil) | |
| 2921 (widget-value-set child value) | |
| 2922 ;; This call manages the comment visibility | |
| 2923 (widget-value-set comment-widget "") | |
| 2924 (custom-face-state-set widget) | |
| 480 | 2925 (custom-redraw-magic widget) |
| 2926 )) | |
| 2927 | |
| 2928 (defun custom-face-reset-standard (widget) | |
| 2929 "Restore the face edited by WIDGET to its standard settings." | |
| 2930 (when (custom-face-pre-reset-standard widget) | |
| 2931 (custom-save-all)) | |
| 2932 (custom-face-post-reset-standard widget)) | |
| 2933 | |
| 428 | 2934 |
| 2935 ;;; The `face' Widget. | |
| 2936 | |
| 2937 (define-widget 'face 'default | |
| 2938 "Select and customize a face." | |
| 2939 :convert-widget 'widget-value-convert-widget | |
| 2940 :button-prefix 'widget-push-button-prefix | |
| 2941 :button-suffix 'widget-push-button-suffix | |
| 2942 :format "%t: %[select face%] %v" | |
| 2943 :tag "Face" | |
| 2944 :value 'default | |
| 2945 :value-create 'widget-face-value-create | |
| 2946 :value-delete 'widget-face-value-delete | |
| 2947 :value-get 'widget-value-value-get | |
| 2948 :validate 'widget-children-validate | |
| 2949 :action 'widget-face-action | |
| 2950 :match (lambda (widget value) (symbolp value))) | |
| 2951 | |
| 2952 (defun widget-face-value-create (widget) | |
| 2953 ;; Create a `custom-face' child. | |
| 2954 (let* ((symbol (widget-value widget)) | |
| 2955 (custom-buffer-style 'face) | |
| 2956 (child (widget-create-child-and-convert | |
| 2957 widget 'custom-face | |
| 2958 :custom-level nil | |
| 2959 :value symbol))) | |
| 2960 (custom-magic-reset child) | |
| 2961 (setq custom-options (cons child custom-options)) | |
| 2962 (widget-put widget :children (list child)))) | |
| 2963 | |
| 2964 (defun widget-face-value-delete (widget) | |
| 2965 ;; Remove the child from the options. | |
| 2966 (let ((child (car (widget-get widget :children)))) | |
| 2967 (setq custom-options (delq child custom-options)) | |
| 2968 (widget-children-value-delete widget))) | |
| 2969 | |
| 2970 (defvar face-history nil | |
| 2971 "History of entered face names.") | |
| 2972 | |
| 2973 (defun widget-face-action (widget &optional event) | |
| 2974 "Prompt for a face." | |
| 2975 (let ((answer (completing-read "Face: " | |
| 2976 (mapcar (lambda (face) | |
| 2977 (list (symbol-name face))) | |
| 2978 (face-list)) | |
| 2979 nil nil nil | |
| 2980 'face-history))) | |
|
5366
f00192e1cd49
Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents:
4806
diff
changeset
|
2981 (unless (eql (length answer) 0) |
| 428 | 2982 (widget-value-set widget (intern answer)) |
| 2983 (widget-apply widget :notify widget event) | |
| 2984 (widget-setup)))) | |
| 2985 | |
| 2986 ;;; The `hook' Widget. | |
| 2987 | |
| 2988 (define-widget 'hook 'list | |
| 2989 "A emacs lisp hook" | |
| 2990 :value-to-internal (lambda (widget value) | |
| 2991 (if (symbolp value) | |
| 2992 (list value) | |
| 2993 value)) | |
| 2994 :match (lambda (widget value) | |
| 2995 (or (symbolp value) | |
| 2996 (widget-group-match widget value))) | |
| 2997 :convert-widget 'custom-hook-convert-widget | |
| 2998 :tag "Hook") | |
| 2999 | |
| 3000 (defun custom-hook-convert-widget (widget) | |
| 438 | 3001 ;; Handle `:options'. |
| 428 | 3002 (let* ((options (widget-get widget :options)) |
| 3003 (other `(editable-list :inline t | |
| 3004 :entry-format "%i %d%v" | |
| 3005 (function :format " %v"))) | |
| 3006 (args (if options | |
| 3007 (list `(checklist :inline t | |
| 3008 ,@(mapcar (lambda (entry) | |
| 3009 `(function-item ,entry)) | |
| 3010 options)) | |
| 3011 other) | |
| 3012 (list other)))) | |
| 3013 (widget-put widget :args args) | |
| 3014 widget)) | |
| 3015 | |
| 3016 ;;; The `plist' Widget. | |
| 3017 | |
| 3018 (define-widget 'plist 'list | |
| 3019 "A property list." | |
| 3020 :match (lambda (widget value) | |
| 3021 (valid-plist-p value)) | |
| 3022 :convert-widget 'custom-plist-convert-widget | |
| 3023 :tag "Property List") | |
| 3024 | |
| 3025 ;; #### Should handle options better. | |
| 3026 (defun custom-plist-convert-widget (widget) | |
| 3027 (let* ((options (widget-get widget :options)) | |
| 3028 (other `(editable-list :inline t | |
| 3029 (group :inline t | |
| 3030 (symbol :format "%t: %v " | |
| 3031 :size 10 | |
| 3032 :tag "Property") | |
| 3033 (sexp :tag "Value")))) | |
| 3034 (args | |
| 3035 (if options | |
| 3036 `((checklist :inline t | |
| 3037 ,@(mapcar 'custom-plist-process-option options)) | |
| 3038 ,other) | |
| 3039 (list other)))) | |
| 3040 (widget-put widget :args args) | |
| 3041 widget)) | |
| 3042 | |
| 3043 (defun custom-plist-process-option (entry) | |
| 3044 `(group :inline t | |
| 3045 (const :tag "Property" | |
| 3046 :format "%t: %v " | |
| 3047 :size 10 | |
| 3048 ,entry) | |
| 3049 (sexp :tag "Value"))) | |
| 3050 | |
| 3051 ;;; The `custom-group-link' Widget. | |
| 3052 | |
| 3053 (define-widget 'custom-group-link 'link | |
| 3054 "Show parent in other window when activated." | |
| 3055 :help-echo 'custom-group-link-help-echo | |
| 3056 :action 'custom-group-link-action) | |
| 3057 | |
| 3058 (defun custom-group-link-help-echo (widget) | |
| 3059 (concat "Create customization buffer for the `" | |
| 3060 (custom-unlispify-tag-name (widget-value widget)) | |
| 3061 "' group")) | |
| 3062 | |
| 3063 (defun custom-group-link-action (widget &rest ignore) | |
| 3064 (customize-group (widget-value widget))) | |
| 3065 | |
| 3066 ;;; The `custom-group' Widget. | |
| 3067 | |
| 3068 (defcustom custom-group-tag-faces nil | |
| 3069 ;; In XEmacs, this ought to play games with font size. | |
| 3070 "Face used for group tags. | |
| 3071 The first member is used for level 1 groups, the second for level 2, | |
| 3072 and so forth. The remaining group tags are shown with | |
| 3073 `custom-group-tag-face'." | |
| 3074 :type '(repeat face) | |
| 3075 :group 'custom-faces) | |
| 3076 | |
| 3077 (defface custom-group-tag-face-1 '((((class color) | |
| 3078 (background dark)) | |
| 3079 (:foreground "pink" :underline t)) | |
| 3080 (((class color) | |
| 3081 (background light)) | |
| 3082 (:foreground "red" :underline t)) | |
| 3083 (t (:underline t))) | |
| 3084 "Face used for group tags.") | |
| 3085 | |
| 3086 (defface custom-group-tag-face '((((class color) | |
| 3087 (background dark)) | |
| 3088 (:foreground "light blue" :underline t)) | |
| 3089 (((class color) | |
| 3090 (background light)) | |
| 3091 (:foreground "blue" :underline t)) | |
| 3092 (t (:underline t))) | |
| 3093 "Face used for low level group tags." | |
| 3094 :group 'custom-faces) | |
| 3095 | |
| 3096 (define-widget 'custom-group 'custom | |
| 3097 "Customize group." | |
| 3098 :format "%v" | |
| 3099 :sample-face-get 'custom-group-sample-face-get | |
| 3100 :documentation-property 'group-documentation | |
| 3101 :help-echo "Set or reset all members of this group" | |
| 3102 :value-create 'custom-group-value-create | |
| 3103 :action 'custom-group-action | |
| 3104 :custom-category 'group | |
| 3105 :custom-set 'custom-group-set | |
| 480 | 3106 :custom-pre-save 'custom-group-pre-save |
| 428 | 3107 :custom-save 'custom-group-save |
| 480 | 3108 :custom-post-save 'custom-group-post-save |
| 428 | 3109 :custom-reset-current 'custom-group-reset-current |
| 3110 :custom-reset-saved 'custom-group-reset-saved | |
| 480 | 3111 :custom-pre-reset-standard 'custom-group-pre-reset-standard |
| 428 | 3112 :custom-reset-standard 'custom-group-reset-standard |
| 480 | 3113 :custom-post-reset-standard 'custom-group-post-reset-standard |
| 428 | 3114 :custom-menu 'custom-group-menu-create) |
| 3115 | |
| 3116 (defun custom-group-sample-face-get (widget) | |
| 3117 ;; Use :sample-face. | |
| 3118 (or (nth (1- (widget-get widget :custom-level)) custom-group-tag-faces) | |
| 3119 'custom-group-tag-face)) | |
| 3120 | |
| 3121 (define-widget 'custom-group-visibility 'visibility | |
| 3122 "An indicator and manipulator for hidden group contents." | |
| 3123 :create 'custom-group-visibility-create) | |
| 3124 | |
| 3125 (defun custom-group-visibility-create (widget) | |
| 3126 (let ((visible (widget-value widget))) | |
| 3127 (if visible | |
| 3128 (insert "--------"))) | |
| 3129 (widget-default-create widget)) | |
| 3130 | |
| 3131 (defun custom-group-members (symbol groups-only) | |
| 3132 "Return SYMBOL's custom group members. | |
| 3133 If GROUPS-ONLY non-nil, return only those members that are groups." | |
| 3134 (if (not groups-only) | |
| 3135 (get symbol 'custom-group) | |
| 3136 (let (members) | |
| 3137 (dolist (entry (get symbol 'custom-group) (nreverse members)) | |
| 3138 (when (eq (nth 1 entry) 'custom-group) | |
| 3139 (push entry members)))))) | |
| 3140 | |
| 3141 (defun custom-group-value-create (widget) | |
| 3142 "Insert a customize group for WIDGET in the current buffer." | |
| 3143 (let* ((state (widget-get widget :custom-state)) | |
| 3144 (level (widget-get widget :custom-level)) | |
| 3145 ;; (indent (widget-get widget :indent)) | |
| 3146 (prefix (widget-get widget :custom-prefix)) | |
| 3147 (buttons (widget-get widget :buttons)) | |
| 3148 (tag (widget-get widget :tag)) | |
| 3149 (symbol (widget-value widget)) | |
| 3150 (members (custom-group-members symbol | |
| 3151 (and (eq custom-buffer-style 'tree) | |
| 3152 custom-browse-only-groups)))) | |
| 3153 (cond ((and (eq custom-buffer-style 'tree) | |
| 3154 (eq state 'hidden) | |
| 3155 (or members (custom-unloaded-widget-p widget))) | |
| 3156 (custom-browse-insert-prefix prefix) | |
| 3157 (push (widget-create-child-and-convert | |
| 3158 widget 'custom-browse-visibility | |
| 3159 ;; :tag-glyph "plus" | |
| 3160 :tag "+") | |
| 3161 buttons) | |
| 3162 (insert "-- ") | |
| 3163 ;; (widget-glyph-insert nil "-- " "horizontal") | |
| 3164 (push (widget-create-child-and-convert | |
| 3165 widget 'custom-browse-group-tag) | |
| 3166 buttons) | |
| 3167 (insert " " tag "\n") | |
| 3168 (widget-put widget :buttons buttons)) | |
| 3169 ((and (eq custom-buffer-style 'tree) | |
|
5366
f00192e1cd49
Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents:
4806
diff
changeset
|
3170 (eql (length members) 0)) |
| 428 | 3171 (custom-browse-insert-prefix prefix) |
| 3172 (insert "[ ]-- ") | |
| 3173 ;; (widget-glyph-insert nil "[ ]" "empty") | |
| 3174 ;; (widget-glyph-insert nil "-- " "horizontal") | |
| 3175 (push (widget-create-child-and-convert | |
| 3176 widget 'custom-browse-group-tag) | |
| 3177 buttons) | |
| 3178 (insert " " tag "\n") | |
| 3179 (widget-put widget :buttons buttons)) | |
| 3180 ((eq custom-buffer-style 'tree) | |
| 3181 (custom-browse-insert-prefix prefix) | |
| 3182 (custom-load-widget widget) | |
|
5366
f00192e1cd49
Examining the result of #'length: `eql', not `=', it's better style & cheaper
Aidan Kehoe <kehoea@parhasard.net>
parents:
4806
diff
changeset
|
3183 (if (eql (length members) 0) |
| 428 | 3184 (progn |
| 3185 (custom-browse-insert-prefix prefix) | |
| 3186 (insert "[ ]-- ") | |
| 3187 ;; (widget-glyph-insert nil "[ ]" "empty") | |
| 3188 ;; (widget-glyph-insert nil "-- " "horizontal") | |
| 3189 (push (widget-create-child-and-convert | |
| 3190 widget 'custom-browse-group-tag) | |
| 3191 buttons) | |
| 3192 (insert " " tag "\n") | |
| 3193 (widget-put widget :buttons buttons)) | |
| 3194 (push (widget-create-child-and-convert | |
| 3195 widget 'custom-browse-visibility | |
| 3196 ;; :tag-glyph "minus" | |
| 3197 :tag "-") | |
| 3198 buttons) | |
| 3199 (insert "-\\ ") | |
| 3200 ;; (widget-glyph-insert nil "-\\ " "top") | |
| 3201 (push (widget-create-child-and-convert | |
| 3202 widget 'custom-browse-group-tag) | |
| 3203 buttons) | |
| 3204 (insert " " tag "\n") | |
| 3205 (widget-put widget :buttons buttons) | |
| 3206 (message "Creating group...") | |
| 3207 (let* ((members (custom-sort-items members | |
| 3208 custom-browse-sort-alphabetically | |
| 3209 custom-browse-order-groups)) | |
| 3210 (prefixes (widget-get widget :custom-prefixes)) | |
| 3211 (custom-prefix-list (custom-prefix-add symbol prefixes)) | |
| 3212 (extra-prefix (if (widget-get widget :custom-last) | |
| 3213 " " | |
| 3214 " | ")) | |
| 3215 (prefix (concat prefix extra-prefix)) | |
| 3216 children entry) | |
| 3217 (while members | |
| 3218 (setq entry (car members) | |
| 3219 members (cdr members)) | |
| 3220 (push (widget-create-child-and-convert | |
| 3221 widget (nth 1 entry) | |
| 3222 :group widget | |
| 3223 :tag (custom-unlispify-tag-name (nth 0 entry)) | |
| 3224 :custom-prefixes custom-prefix-list | |
| 3225 :custom-level (1+ level) | |
| 3226 :custom-last (null members) | |
| 3227 :value (nth 0 entry) | |
| 3228 :custom-prefix prefix) | |
| 3229 children)) | |
| 3230 (widget-put widget :children (reverse children))) | |
| 3231 (message "Creating group...done"))) | |
| 3232 ;; Nested style. | |
| 3233 ((eq state 'hidden) | |
| 3234 ;; Create level indicator. | |
| 3235 (unless (eq custom-buffer-style 'links) | |
| 3236 (insert-char ?\ (* custom-buffer-indent (1- level))) | |
| 3237 (insert "-- ")) | |
| 3238 ;; Create link indicator. | |
| 3239 (when (eq custom-buffer-style 'links) | |
| 3240 (insert " ") | |
| 3241 (push (widget-create-child-and-convert | |
| 3242 widget 'custom-group-link | |
| 3243 :tag "Open" | |
| 3244 :tag-glyph '("open-up" "open-down") | |
| 3245 symbol) | |
| 3246 buttons) | |
| 3247 (insert " ")) | |
| 3248 ;; Create tag. | |
| 3249 (let ((begin (point))) | |
| 3250 (insert tag) | |
| 3251 (widget-specify-sample widget begin (point))) | |
| 3252 (insert " group") | |
| 3253 ;; Create visibility indicator. | |
| 3254 (unless (eq custom-buffer-style 'links) | |
| 3255 (insert ": ") | |
| 3256 (push (widget-create-child-and-convert | |
| 3257 widget 'custom-group-visibility | |
| 3258 :help-echo "Show members of this group" | |
| 3259 :action 'custom-toggle-parent | |
| 3260 (not (eq state 'hidden))) | |
| 3261 buttons)) | |
| 3262 (insert " \n") | |
| 3263 ;; Create magic button. | |
| 3264 (let ((magic (widget-create-child-and-convert | |
| 3265 widget 'custom-magic nil))) | |
| 3266 (widget-put widget :custom-magic magic) | |
| 3267 (push magic buttons)) | |
| 3268 ;; Update buttons. | |
| 3269 (widget-put widget :buttons buttons) | |
| 3270 ;; Insert documentation. | |
| 3271 (if (and (eq custom-buffer-style 'links) (> level 1)) | |
| 3272 (widget-put widget :documentation-indent 0)) | |
| 3273 (widget-default-format-handler widget ?h)) | |
| 3274 ;; Nested style. | |
| 3275 (t ;Visible. | |
| 3276 (custom-load-widget widget) | |
| 3277 ;; Update members | |
| 3278 (setq members (custom-group-members | |
| 3279 symbol (and (eq custom-buffer-style 'tree) | |
| 3280 custom-browse-only-groups))) | |
| 3281 ;; Add parent groups references above the group. | |
| 3282 (if t ;;; This should test that the buffer | |
| 3283 ;;; was made to display a group. | |
| 3284 (when (eq level 1) | |
| 3285 (if (custom-add-parent-links widget | |
| 3286 "Go to parent group:") | |
| 3287 (insert "\n")))) | |
| 3288 ;; Create level indicator. | |
| 3289 (insert-char ?\ (* custom-buffer-indent (1- level))) | |
| 3290 (insert "/- ") | |
| 3291 ;; Create tag. | |
| 3292 (let ((start (point))) | |
| 3293 (insert tag) | |
| 3294 (widget-specify-sample widget start (point))) | |
| 3295 (insert " group: ") | |
| 3296 ;; Create visibility indicator. | |
| 3297 (unless (eq custom-buffer-style 'links) | |
| 3298 (insert "--------") | |
| 3299 (push (widget-create-child-and-convert | |
| 3300 widget 'visibility | |
| 3301 :help-echo "Hide members of this group" | |
| 3302 :action 'custom-toggle-parent | |
| 3303 (not (eq state 'hidden))) | |
| 3304 buttons) | |
| 3305 (insert " ")) | |
| 3306 ;; Create more dashes. | |
| 3307 ;; Use 76 instead of 75 to compensate for the temporary "<" | |
| 3308 ;; added by `widget-insert'. | |
| 3309 (insert-char ?- (- 76 (current-column) | |
| 3310 (* custom-buffer-indent level))) | |
| 3311 (insert "\\\n") | |
| 3312 ;; Create magic button. | |
| 3313 (let ((magic (widget-create-child-and-convert | |
| 3314 widget 'custom-magic | |
| 3315 :indent 0 | |
| 3316 nil))) | |
| 3317 (widget-put widget :custom-magic magic) | |
| 3318 (push magic buttons)) | |
| 3319 ;; Update buttons. | |
| 3320 (widget-put widget :buttons buttons) | |
| 3321 ;; Insert documentation. | |
| 3322 (widget-default-format-handler widget ?h) | |
| 3323 ;; Parent groups. | |
| 3324 (if nil ;;; This should test that the buffer | |
| 3325 ;;; was not made to display a group. | |
| 3326 (when (eq level 1) | |
| 3327 (insert-char ?\ custom-buffer-indent) | |
| 3328 (custom-add-parent-links widget))) | |
| 3329 (custom-add-see-also widget | |
| 3330 (make-string (* custom-buffer-indent level) | |
| 3331 ?\ )) | |
| 3332 ;; Members. | |
| 3333 (message "Creating group...") | |
| 3334 (let* ((members (custom-sort-items members | |
| 3335 custom-buffer-sort-alphabetically | |
| 3336 custom-buffer-order-groups)) | |
| 3337 (prefixes (widget-get widget :custom-prefixes)) | |
| 3338 (custom-prefix-list (custom-prefix-add symbol prefixes)) | |
| 3339 (length (length members)) | |
| 3340 (count 0) | |
| 3341 (children (mapcar | |
| 3342 (lambda (entry) | |
| 3343 (widget-insert "\n") | |
| 3344 (when (zerop (% count custom-skip-messages)) | |
| 3345 (display-message | |
| 3346 'progress | |
| 3347 (format "\ | |
| 3348 Creating group members... %2d%%" | |
| 3349 (/ (* 100.0 count) length)))) | |
| 3350 (incf count) | |
| 3351 (prog1 | |
| 3352 (widget-create-child-and-convert | |
| 3353 widget (nth 1 entry) | |
| 3354 :group widget | |
| 3355 :tag (custom-unlispify-tag-name | |
| 3356 (nth 0 entry)) | |
| 3357 :custom-prefixes custom-prefix-list | |
| 3358 :custom-level (1+ level) | |
| 3359 :value (nth 0 entry)) | |
| 3360 (unless (eq (preceding-char) ?\n) | |
| 3361 (widget-insert "\n")))) | |
| 3362 members))) | |
| 3363 (message "Creating group magic...") | |
| 3364 (mapc 'custom-magic-reset children) | |
| 3365 (message "Creating group state...") | |
| 3366 (widget-put widget :children children) | |
| 3367 (custom-group-state-update widget) | |
| 3368 (message "Creating group... done")) | |
| 3369 ;; End line | |
| 3370 (insert "\n") | |
| 3371 (insert-char ?\ (* custom-buffer-indent (1- level))) | |
| 3372 (insert "\\- " (widget-get widget :tag) " group end ") | |
| 3373 (insert-char ?- (- 75 (current-column) (* custom-buffer-indent level))) | |
| 3374 (insert "/\n"))))) | |
| 3375 | |
| 3376 (defvar custom-group-menu | |
| 4289 | 3377 `(("Set for Current Session" custom-group-set |
| 3378 ,#'(lambda (widget) | |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3379 (eq (widget-get widget :custom-state) 'modified))) |
| 428 | 3380 ("Save for Future Sessions" custom-group-save |
| 4289 | 3381 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3382 (memq (widget-get widget :custom-state) '(modified set)))) |
| 428 | 3383 ("Reset to Current" custom-group-reset-current |
| 4289 | 3384 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3385 (memq (widget-get widget :custom-state) '(modified)))) |
| 428 | 3386 ("Reset to Saved" custom-group-reset-saved |
| 4289 | 3387 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3388 (memq (widget-get widget :custom-state) '(modified set)))) |
| 428 | 3389 ("Reset to standard setting" custom-group-reset-standard |
| 4289 | 3390 ,#'(lambda (widget) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3391 (memq (widget-get widget :custom-state) '(modified set saved))))) |
| 428 | 3392 "Alist of actions for the `custom-group' widget. |
| 3393 Each entry has the form (NAME ACTION FILTER) where NAME is the name of | |
| 3394 the menu entry, ACTION is the function to call on the widget when the | |
| 3395 menu is selected, and FILTER is a predicate which takes a `custom-group' | |
| 3396 widget as an argument, and returns non-nil if ACTION is valid on that | |
| 3397 widget. If FILTER is nil, ACTION is always valid.") | |
| 3398 | |
| 3399 (defun custom-group-action (widget &optional event) | |
| 3400 "Show the menu for `custom-group' WIDGET. | |
| 3401 Optional EVENT is the location for the menu." | |
| 3402 (if (eq (widget-get widget :custom-state) 'hidden) | |
| 3403 (custom-toggle-hide widget) | |
| 3404 (let* ((completion-ignore-case t) | |
| 3405 (answer (widget-choose (concat "Operation on " | |
| 3406 (custom-unlispify-tag-name | |
| 3407 (widget-get widget :value))) | |
| 3408 (custom-menu-filter custom-group-menu | |
| 3409 widget) | |
| 3410 event))) | |
| 3411 (if answer | |
| 3412 (funcall answer widget))))) | |
| 3413 | |
| 3414 (defun custom-group-set (widget) | |
| 3415 "Set changes in all modified group members." | |
| 3416 (let ((children (widget-get widget :children))) | |
| 3417 (mapc (lambda (child) | |
| 3418 (when (eq (widget-get child :custom-state) 'modified) | |
| 3419 (widget-apply child :custom-set))) | |
| 3420 children))) | |
| 3421 | |
| 480 | 3422 (defun custom-group-pre-save (widget) |
| 3423 "Prepare for saving all modified group members." | |
| 3424 (let ((children (widget-get widget :children))) | |
| 3425 (mapc (lambda (child) | |
| 3426 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 3427 (widget-apply child :custom-pre-save))) | |
| 3428 children))) | |
| 3429 | |
| 3430 (defun custom-group-post-save (widget) | |
| 428 | 3431 "Save all modified group members." |
| 3432 (let ((children (widget-get widget :children))) | |
| 3433 (mapc (lambda (child) | |
| 3434 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 480 | 3435 (widget-apply child :custom-post-save))) |
| 428 | 3436 children))) |
| 3437 | |
| 480 | 3438 (defun custom-group-save (widget) |
| 3439 "Save all modified group members." | |
| 3440 (custom-group-pre-save widget) | |
| 3441 (custom-save-all) | |
| 3442 (custom-group-post-save widget)) | |
| 3443 | |
| 428 | 3444 (defun custom-group-reset-current (widget) |
| 3445 "Reset all modified group members." | |
| 3446 (let ((children (widget-get widget :children))) | |
| 3447 (mapc (lambda (child) | |
| 3448 (when (eq (widget-get child :custom-state) 'modified) | |
| 3449 (widget-apply child :custom-reset-current))) | |
| 3450 children))) | |
| 3451 | |
| 3452 (defun custom-group-reset-saved (widget) | |
| 3453 "Reset all modified or set group members." | |
| 3454 (let ((children (widget-get widget :children))) | |
| 3455 (mapc (lambda (child) | |
| 3456 (when (memq (widget-get child :custom-state) '(modified set)) | |
| 3457 (widget-apply child :custom-reset-saved))) | |
| 3458 children))) | |
| 3459 | |
| 480 | 3460 ;; This function returns non nil when we need to re-save the options --dv. |
| 3461 (defun custom-group-pre-reset-standard (widget) | |
| 3462 "Prepare for resetting all modified, set, or saved group members." | |
| 3463 (let ((children (widget-get widget :children)) | |
| 3464 must-save) | |
| 3465 (mapc (lambda (child) | |
| 3466 (when (memq (widget-get child :custom-state) | |
| 3467 '(modified set saved)) | |
| 3468 (and (widget-apply child :custom-pre-reset-standard) | |
| 3469 (setq must-save t)))) | |
| 3470 children) | |
| 3471 must-save | |
| 3472 )) | |
| 3473 | |
| 3474 (defun custom-group-post-reset-standard (widget) | |
| 3475 "Finish resetting all modified, set, or saved group members." | |
| 428 | 3476 (let ((children (widget-get widget :children))) |
| 3477 (mapc (lambda (child) | |
| 3478 (when (memq (widget-get child :custom-state) | |
| 3479 '(modified set saved)) | |
| 480 | 3480 (widget-apply child :custom-post-reset-standard))) |
| 428 | 3481 children))) |
| 3482 | |
| 480 | 3483 (defun custom-group-reset-standard (widget) |
| 3484 "Reset all modified, set, or saved group members." | |
| 3485 (when (custom-group-pre-reset-standard widget) | |
| 3486 (custom-save-all)) | |
| 3487 (custom-group-post-reset-standard widget)) | |
| 3488 | |
| 428 | 3489 (defun custom-group-state-update (widget) |
| 3490 "Update magic." | |
| 3491 (unless (eq (widget-get widget :custom-state) 'hidden) | |
| 3492 (let* ((children (widget-get widget :children)) | |
| 3493 (states (mapcar (lambda (child) | |
| 3494 (widget-get child :custom-state)) | |
| 3495 children)) | |
| 3496 (magics custom-magic-alist) | |
| 3497 (found 'standard)) | |
| 3498 (while magics | |
| 3499 (let ((magic (car (car magics)))) | |
| 3500 (if (and (not (eq magic 'hidden)) | |
| 3501 (memq magic states)) | |
| 3502 (setq found magic | |
| 3503 magics nil) | |
| 3504 (setq magics (cdr magics))))) | |
| 3505 (widget-put widget :custom-state found))) | |
| 3506 (custom-magic-reset widget)) | |
| 3507 | |
| 3508 (defun custom-save-delete (symbol) | |
| 3509 "Delete the call to SYMBOL form in `custom-file'. | |
| 3510 Leave point at the location of the call, or after the last expression." | |
| 3511 (let ((find-file-hooks nil) | |
| 3512 (auto-mode-alist nil)) | |
| 3513 (set-buffer (find-file-noselect custom-file))) | |
| 3514 (goto-char (point-min)) | |
| 3515 (catch 'found | |
| 3516 (while t | |
| 3517 (let ((sexp (condition-case nil | |
| 3518 (read (current-buffer)) | |
| 3519 (end-of-file (throw 'found nil))))) | |
| 3520 (when (and (listp sexp) | |
| 3521 (eq (car sexp) symbol)) | |
| 3522 (delete-region (save-excursion | |
| 3523 (backward-sexp) | |
| 3524 (point)) | |
| 3525 (point)) | |
| 3526 (throw 'found nil)))))) | |
| 3527 | |
| 848 | 3528 (defun custom-save-delete-any (&rest symbols) |
| 3529 "Delete the call to any symbol among SYMBOLS in `custom-file'. | |
| 3530 Leave the point at the end of the file." | |
| 3531 (let ((find-file-hooks nil) | |
| 3532 (auto-mode-alist nil)) | |
| 3533 (set-buffer (find-file-noselect custom-file))) | |
| 3534 (goto-char (point-min)) | |
| 3535 (condition-case nil | |
| 3536 (while (not (eobp)) | |
| 4178 | 3537 (let ((sexp (read (current-buffer)))) |
| 3538 (when (and (listp sexp) | |
| 3539 (memq (car sexp) symbols)) | |
| 3540 (delete-region (save-excursion | |
| 3541 (backward-sexp) | |
| 3542 (point)) | |
| 3543 (point)) | |
| 3544 (while (and (eolp) (not (eobp))) | |
| 3545 (delete-region (point) (prog2 (forward-line 1) (point)))) | |
| 3546 ))) | |
| 848 | 3547 (end-of-file nil))) |
| 3548 | |
| 3549 (defsubst custom-save-variable-p (symbol) | |
| 3550 "Return non-nil if symbol SYMBOL is a customized variable." | |
| 3551 (and (symbolp symbol) | |
| 3552 (let ((spec (car-safe (get symbol 'theme-value)))) | |
| 4178 | 3553 (or (and spec (eq (car spec) 'user) |
| 3554 (eq (second spec) 'set)) | |
| 3555 (get symbol 'saved-variable-comment) | |
| 3556 ;; support non-themed vars | |
| 3557 (and (null spec) (get symbol 'saved-value)))))) | |
| 848 | 3558 |
| 3559 (defun custom-save-variable-internal (symbol) | |
| 3560 "Print variable SYMBOL to the standard output. | |
| 3561 SYMBOL must be a customized variable." | |
| 3562 (let ((requests (get symbol 'custom-requests)) | |
| 4178 | 3563 (now (not (or (get symbol 'standard-value) |
| 3564 (and (not (boundp symbol)) | |
| 3565 (not (eq (get symbol 'force-value) | |
| 3566 'rogue)))))) | |
| 3567 (comment (get symbol 'saved-variable-comment)) | |
| 3568 ;; Print everything, no placeholders `...' | |
| 3569 (print-level nil) | |
| 3570 (print-length nil)) | |
| 848 | 3571 (unless (custom-save-variable-p symbol) |
| 3572 (error 'wrong-type-argument "Not a customized variable" symbol)) | |
| 3573 (princ "\n '(") | |
| 3574 (prin1 symbol) | |
| 3575 (princ " ") | |
| 3576 ;; This comment stuff is in the way #### | |
| 3577 ;; Is (eq (third spec) (car saved-value)) ???? | |
| 3578 ;; (prin1 (third spec)) | |
| 3579 ;; XEmacs -- pretty-print value if available | |
| 3580 (if (and custom-save-pretty-print | |
| 4178 | 3581 (fboundp 'pp)) |
| 3582 ;; To suppress bytecompiler warning | |
| 3583 (with-fboundp 'pp | |
| 3584 (pp (car (get symbol 'saved-value)))) | |
| 848 | 3585 (prin1 (car (get symbol 'saved-value)))) |
| 3586 (when (or now requests comment) | |
| 3587 (princ (if now " t" " nil"))) | |
| 3588 (when (or comment requests) | |
| 3589 (princ " ") | |
| 3590 (prin1 requests)) | |
| 3591 (when comment | |
| 3592 (princ " ") | |
| 3593 (prin1 comment)) | |
| 3594 (princ ")"))) | |
| 3595 | |
| 428 | 3596 (defun custom-save-variables () |
| 3597 "Save all customized variables in `custom-file'." | |
| 3598 (save-excursion | |
| 3599 (custom-save-delete 'custom-load-themes) | |
| 3600 (custom-save-delete 'custom-reset-variables) | |
| 3601 (custom-save-delete 'custom-set-variables) | |
| 848 | 3602 ;; This leaves point at the end of file. |
| 3603 ;; Adrian Aichner <adrian@xemacs.org> stated it is | |
| 3604 ;; a bad behavior <npak@ispras.ru> | |
| 3605 ;;(custom-save-delete-any 'custom-load-themes | |
| 3606 ;; 'custom-reset-variables | |
| 3607 ;; 'custom-set-variables) | |
| 428 | 3608 (custom-save-loaded-themes) |
| 3609 (custom-save-resets 'theme-value 'custom-reset-variables nil) | |
| 848 | 3610 (let ((standard-output (current-buffer)) |
| 4178 | 3611 (sorted-list ())) |
| 848 | 3612 ;; First create a sorted list of saved variables. |
| 3613 (mapatoms | |
| 4178 | 3614 (lambda (symbol) |
| 3615 (when (custom-save-variable-p symbol) | |
| 3616 (push symbol sorted-list)))) | |
| 2122 | 3617 (setq sorted-list (sort sorted-list 'string<)) |
| 428 | 3618 (unless (bolp) |
| 4178 | 3619 (princ "\n")) |
| 428 | 3620 (princ "(custom-set-variables") |
| 848 | 3621 (mapc 'custom-save-variable-internal |
| 4178 | 3622 sorted-list) |
| 848 | 3623 (princ ")") |
| 3624 (unless (looking-at "\n") | |
| 4178 | 3625 (princ "\n"))))) |
| 428 | 3626 |
| 3627 (defvar custom-save-face-ignoring nil) | |
| 3628 | |
| 848 | 3629 (defsubst custom-save-face-p (symbol) |
| 3630 "Return non-nil if SYMBOL is a customized face." | |
| 428 | 3631 (let ((theme-spec (car-safe (get symbol 'theme-face))) |
| 848 | 3632 (comment (get symbol 'saved-face-comment))) |
| 3633 (or (and (not (memq symbol custom-save-face-ignoring)) | |
| 4178 | 3634 ;; Don't print default face here. |
| 3635 (or (and theme-spec | |
| 3636 (eq (car theme-spec) 'user) | |
| 3637 (eq (second theme-spec) 'set)) | |
| 3638 ;; cope with non-themed faces | |
| 3639 (and (null theme-spec) | |
| 3640 (get symbol 'saved-face)))) | |
| 3641 comment))) | |
| 848 | 3642 |
| 3643 (defun custom-save-face-internal (symbol) | |
| 3644 "Print face SYMBOL to the standard output. | |
| 3645 SYMBOL must be a customized face." | |
| 3646 (let ((comment (get symbol 'saved-face-comment)) | |
| 428 | 3647 (now (not (or (get symbol 'face-defface-spec) |
| 3648 (and (not (find-face symbol)) | |
| 848 | 3649 (not (eq (get symbol 'force-face) 'rogue)))))) |
| 4178 | 3650 ;; Print everything, no placeholders `...' |
| 3651 (print-level nil) | |
| 3652 (print-length nil)) | |
| 848 | 3653 (if (memq symbol custom-save-face-ignoring) |
| 4178 | 3654 ;; Do nothing |
| 3655 nil | |
| 848 | 3656 ;; Print face |
| 3657 (unless (custom-save-face-p symbol) | |
| 4178 | 3658 (error 'wrong-type-argument "Not a customized face" symbol)) |
| 428 | 3659 (princ "\n '(") |
| 3660 (prin1 symbol) | |
| 3661 (princ " ") | |
| 3662 (prin1 (get symbol 'saved-face)) | |
| 3663 (if (or comment now) | |
| 4178 | 3664 (princ (if now " t" " nil"))) |
| 428 | 3665 (when comment |
| 4178 | 3666 (princ " ") |
| 3667 (prin1 comment)) | |
| 428 | 3668 (princ ")")))) |
| 3669 | |
| 3670 (defun custom-save-faces () | |
| 3671 "Save all customized faces in `custom-file'." | |
| 3672 (save-excursion | |
| 3673 (custom-save-delete 'custom-reset-faces) | |
| 3674 (custom-save-delete 'custom-set-faces) | |
| 848 | 3675 ;; This leaves point at the end of file. |
| 3676 ;; Adrian Aichner <adrian@xemacs.org> stated it is | |
| 3677 ;; a bad behavior <npak@ispras.ru> | |
| 3678 ;;(custom-save-delete-any 'custom-reset-faces | |
| 3679 ;; 'custom-set-faces) | |
| 428 | 3680 (custom-save-resets 'theme-face 'custom-reset-faces '(default)) |
| 848 | 3681 (let ((standard-output (current-buffer)) |
| 4178 | 3682 (sorted-list ())) |
| 848 | 3683 ;; Create a sorted list of faces |
| 3684 (mapatoms | |
| 3685 (lambda (symbol) | |
| 4178 | 3686 (when (custom-save-face-p symbol) |
| 3687 (push symbol sorted-list)))) | |
| 2122 | 3688 (setq sorted-list (sort sorted-list 'string<)) |
| 428 | 3689 (unless (bolp) |
| 3690 (princ "\n")) | |
| 3691 (princ "(custom-set-faces") | |
| 3692 ;; The default face must be first, since it affects the others. | |
| 848 | 3693 (when (custom-save-face-p 'default) |
| 4178 | 3694 (custom-save-face-internal 'default)) |
| 428 | 3695 (let ((custom-save-face-ignoring '(default))) |
| 848 | 3696 (mapc 'custom-save-face-internal |
| 4178 | 3697 sorted-list)) |
| 428 | 3698 (princ ")") |
| 3699 (unless (looking-at "\n") | |
| 3700 (princ "\n"))))) | |
| 3701 | |
| 848 | 3702 (defmacro make-custom-save-resets-mapper (property setter) |
| 3703 "Create a mapper for `custom-save-resets'." | |
| 3704 `(lambda (object) | |
| 3705 (let ((spec (car-safe (get object (quote ,property)))) | |
| 4178 | 3706 (print-level nil) |
| 3707 (print-length nil)) | |
| 848 | 3708 (with-boundp '(ignored-special started-writing) |
| 4178 | 3709 (when (and (not (memq object ignored-special)) |
| 3710 (eq (car spec) 'user) | |
| 3711 (eq (second spec) 'reset)) | |
| 3712 ;; Do not write reset statements unless necessary. | |
| 3713 (unless started-writing | |
| 3714 (setq started-writing t) | |
| 3715 (unless (bolp) | |
| 3716 (princ "\n")) | |
| 3717 (princ "(") | |
| 3718 (princ (quote ,setter)) | |
| 3719 (princ "\n '(") | |
| 3720 (prin1 object) | |
| 3721 (princ " ") | |
| 3722 (prin1 (third spec)) | |
| 3723 (princ ")"))))))) | |
| 848 | 3724 |
| 3725 (defconst custom-save-resets-mapper-alist | |
| 3726 (eval-when-compile | |
| 3727 (list (list 'theme-value 'custom-reset-variables | |
| 4178 | 3728 (byte-compile |
| 3729 (make-custom-save-resets-mapper | |
| 3730 'theme-value 'custom-reset-variables))) | |
| 3731 (list 'theme-face 'custom-reset-faces | |
| 3732 (byte-compile | |
| 3733 (make-custom-save-resets-mapper | |
| 3734 'theme-face 'custom-reset-faces))))) | |
| 848 | 3735 "Never use it. |
| 3736 Hashes several heavily used functions for `custom-save-resets'") | |
| 3737 | |
| 428 | 3738 (defun custom-save-resets (property setter special) |
| 848 | 3739 (declare (special ignored-special)) |
| 428 | 3740 (let (started-writing ignored-special) |
| 444 | 3741 ;; (custom-save-delete setter) Done by caller |
| 428 | 3742 (let ((standard-output (current-buffer)) |
| 848 | 3743 (mapper (let ((triple (assq property custom-save-resets-mapper-alist))) |
| 4178 | 3744 (if (and triple (eq (second triple) setter)) |
| 3745 (third triple) | |
| 3746 (make-custom-save-resets-mapper property setter))))) | |
| 428 | 3747 (mapc mapper special) |
| 3748 (setq ignored-special special) | |
| 3749 (mapatoms mapper) | |
| 3750 (when started-writing | |
| 848 | 3751 (princ ")\n"))))) |
| 444 | 3752 |
| 428 | 3753 |
| 3754 (defun custom-save-loaded-themes () | |
| 3755 (let ((themes (reverse (get 'user 'theme-loads-themes))) | |
| 848 | 3756 (standard-output (current-buffer)) |
| 4178 | 3757 (print-level nil) |
| 3758 (print-length nil)) | |
| 428 | 3759 (when themes |
| 3760 (unless (bolp) (princ "\n")) | |
| 3761 (princ "(custom-load-themes") | |
| 3762 (mapc (lambda (theme) | |
| 3763 (princ "\n '") | |
| 3764 (prin1 theme)) themes) | |
| 444 | 3765 (princ " )\n")))) |
| 428 | 3766 |
| 3767 ;;;###autoload | |
| 3768 (defun customize-save-customized () | |
| 3769 "Save all user options which have been set in this session." | |
| 3770 (interactive) | |
| 3771 (mapatoms (lambda (symbol) | |
| 3772 (let ((face (get symbol 'customized-face)) | |
| 3773 (value (get symbol 'customized-value)) | |
| 3774 (face-comment (get symbol 'customized-face-comment)) | |
| 3775 (variable-comment | |
| 3776 (get symbol 'customized-variable-comment))) | |
| 3777 (when face | |
| 3778 (put symbol 'saved-face face) | |
| 3779 (custom-push-theme 'theme-face symbol 'user 'set value) | |
| 3780 (put symbol 'customized-face nil)) | |
| 3781 (when value | |
| 3782 (put symbol 'saved-value value) | |
| 3783 (custom-push-theme 'theme-value symbol 'user 'set value) | |
| 3784 (put symbol 'customized-value nil)) | |
| 3785 (when variable-comment | |
| 3786 (put symbol 'saved-variable-comment variable-comment) | |
| 3787 (put symbol 'customized-variable-comment nil)) | |
| 3788 (when face-comment | |
| 3789 (put symbol 'saved-face-comment face-comment) | |
| 3790 (put symbol 'customized-face-comment nil))))) | |
| 3791 ;; We really should update all custom buffers here. | |
| 3792 (custom-save-all)) | |
| 3793 | |
| 3794 ;;;###autoload | |
| 3795 (defun custom-save-all () | |
| 3796 "Save all customizations in `custom-file'." | |
| 4257 | 3797 (when init-file-had-error |
| 3798 (error 'invalid-change | |
| 3799 "Cannot save customizations; init file was not fully loaded")) | |
| 428 | 3800 (let ((inhibit-read-only t)) |
| 3801 (custom-save-variables) | |
| 3802 (custom-save-faces) | |
| 3803 (let ((find-file-hooks nil) | |
|
4382
12ff8dc2b57e
Create the containing directory for the custom and init files if necessary.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4289
diff
changeset
|
3804 (auto-mode-alist) |
|
4434
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3805 custom-file-directory) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3806 (unless (file-directory-p (setq custom-file-directory |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3807 (file-name-directory custom-file))) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3808 (message "Creating %s... " custom-file-directory) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3809 (make-directory custom-file-directory t) |
|
7f3d065a56a1
Ease customization of faces under point...
Didier Verna <didier@xemacs.org>
parents:
4382
diff
changeset
|
3810 (message "Creating %s... done." custom-file-directory)) |
| 428 | 3811 (with-current-buffer (find-file-noselect custom-file) |
| 3812 (save-buffer))))) | |
| 3813 | |
| 3814 | |
| 3815 ;;; The Customize Menu. | |
| 3816 | |
| 3817 ;;; Menu support | |
| 3818 | |
| 3819 (defun custom-face-menu-create (widget symbol) | |
| 3820 "Ignoring WIDGET, create a menu entry for customization face SYMBOL." | |
| 3821 (vector (custom-unlispify-menu-entry symbol) | |
| 3822 `(customize-face ',symbol) | |
| 3823 t)) | |
| 3824 | |
| 3825 (defun custom-variable-menu-create (widget symbol) | |
| 3826 "Ignoring WIDGET, create a menu entry for customization variable SYMBOL." | |
| 3827 (let ((type (get symbol 'custom-type))) | |
| 3828 (unless (listp type) | |
| 3829 (setq type (list type))) | |
| 3830 (if (and type (widget-get type :custom-menu)) | |
| 3831 (widget-apply type :custom-menu symbol) | |
| 3832 (vector (custom-unlispify-menu-entry symbol) | |
| 3833 `(customize-variable ',symbol) | |
| 3834 t)))) | |
| 3835 | |
| 3836 ;; Add checkboxes to boolean variable entries. | |
| 3837 (widget-put (get 'boolean 'widget-type) | |
| 3838 :custom-menu (lambda (widget symbol) | |
| 3839 `[,(custom-unlispify-menu-entry symbol) | |
| 3840 (customize-variable ',symbol) | |
| 3841 :style toggle | |
| 3842 :selected ,symbol])) | |
| 3843 | |
| 3844 ;; XEmacs can create menus dynamically. | |
| 3845 (defun custom-group-menu-create (widget symbol) | |
| 3846 "Ignoring WIDGET, create a menu entry for customization group SYMBOL." | |
| 3847 `( ,(custom-unlispify-menu-entry symbol t) | |
| 3848 :filter (lambda (&rest junk) | |
| 3849 (let ((item (custom-menu-create ',symbol))) | |
| 3850 (if (listp item) | |
| 3851 (cdr item) | |
| 3852 (list item)))))) | |
| 3853 | |
| 3854 ;;;###autoload | |
| 3855 (defun custom-menu-create (symbol) | |
| 3856 "Create menu for customization group SYMBOL. | |
| 3857 The menu is in a format applicable to `easy-menu-define'." | |
| 2544 | 3858 (menu-split-long-menu |
| 3859 (let* ((item (vector (custom-unlispify-menu-entry symbol) | |
| 3860 `(customize-group ',symbol) | |
| 3861 t))) | |
| 3862 ;; Item is the entry for creating a menu buffer for SYMBOL. | |
| 3863 ;; We may nest, if the menu is not too big. | |
| 3864 (custom-load-custom-defines symbol) | |
| 3865 (if t ;(< (length (get symbol 'custom-group)) widget-menu-max-size) | |
| 3866 ;; The menu is not too big. | |
| 3867 (let ((custom-prefix-list (custom-prefix-add symbol | |
| 3868 custom-prefix-list)) | |
| 3869 (members (custom-sort-items (get symbol 'custom-group) | |
| 3870 custom-menu-sort-alphabetically | |
| 3871 custom-menu-order-groups))) | |
| 3872 ;; Create the menu. | |
| 3873 `(,(custom-unlispify-menu-entry symbol t) | |
| 3874 ,item | |
| 3875 "--" | |
| 3876 ,@(mapcar (lambda (entry) | |
| 3877 (widget-apply (if (listp (nth 1 entry)) | |
| 3878 (nth 1 entry) | |
| 3879 (list (nth 1 entry))) | |
| 3880 :custom-menu (nth 0 entry))) | |
| 3881 members))) | |
| 3882 ; else ;; The menu was too big. | |
| 3883 item | |
| 3884 )))) | |
| 428 | 3885 |
| 3886 ;;;###autoload | |
| 3887 (defun customize-menu-create (symbol &optional name) | |
| 3888 "Return a customize menu for customization group SYMBOL. | |
| 3889 If optional NAME is given, use that as the name of the menu. | |
| 3890 Otherwise the menu will be named `Customize'. | |
| 3891 The format is suitable for use with `easy-menu-define'." | |
| 3892 (unless name | |
| 3893 (setq name "Customize")) | |
| 3894 `(,name | |
| 3895 :filter (lambda (&rest junk) | |
| 3896 (cdr (custom-menu-create ',symbol))))) | |
| 3897 | |
| 3898 ;;; The Custom Mode. | |
| 3899 | |
| 3900 (defvar custom-mode-map nil | |
| 3901 "Keymap for `custom-mode'.") | |
| 3902 | |
| 3903 (unless custom-mode-map | |
| 3904 (setq custom-mode-map (make-sparse-keymap)) | |
| 3905 (set-keymap-parents custom-mode-map widget-keymap) | |
| 3906 (suppress-keymap custom-mode-map) | |
| 3907 (define-key custom-mode-map " " 'scroll-up) | |
| 3908 (define-key custom-mode-map [delete] 'scroll-down) | |
| 3909 (define-key custom-mode-map "q" 'Custom-buffer-done) | |
| 3910 (define-key custom-mode-map "u" 'Custom-goto-parent) | |
| 3911 (define-key custom-mode-map "n" 'widget-forward) | |
| 3912 (define-key custom-mode-map "p" 'widget-backward)) | |
| 3913 | |
| 3914 (easy-menu-define Custom-mode-menu | |
| 3915 custom-mode-map | |
| 3916 "Menu used in customization buffers." | |
| 3917 `("Custom" | |
| 3918 ,(customize-menu-create 'customize) | |
| 3919 ["Set" Custom-set t] | |
| 3920 ["Save" Custom-save t] | |
| 3921 ["Reset to Current" Custom-reset-current t] | |
| 3922 ["Reset to Saved" Custom-reset-saved t] | |
| 3923 ["Reset to Standard Settings" Custom-reset-standard t] | |
| 3924 ["Info" (Info-goto-node "(xemacs)Easy Customization") t])) | |
| 3925 | |
| 3926 (defun Custom-goto-parent () | |
| 3927 "Go to the parent group listed at the top of this buffer. | |
| 3928 If several parents are listed, go to the first of them." | |
| 3929 (interactive) | |
| 3930 (save-excursion | |
| 3931 (goto-char (point-min)) | |
| 3932 (if (search-forward "\nGo to parent group: " nil t) | |
| 3933 (let* ((button (get-char-property (point) 'button)) | |
| 3934 (parent (downcase (widget-get button :tag)))) | |
| 3935 (customize-group parent))))) | |
| 3936 | |
| 3937 (defcustom custom-mode-hook nil | |
| 3938 "Hook called when entering custom-mode." | |
| 3939 :type 'hook | |
| 3940 :group 'custom-buffer ) | |
| 3941 | |
| 3942 (defun custom-state-buffer-message (widget) | |
| 3943 (if (eq (widget-get (widget-get widget :parent) :custom-state) 'modified) | |
| 3944 (message | |
| 3945 "To install your edits, invoke [State] and choose the Set operation"))) | |
| 3946 | |
| 3947 (defun custom-mode () | |
| 3948 "Major mode for editing customization buffers. | |
| 3949 | |
| 3950 The following commands are available: | |
| 3951 | |
| 3952 Move to next button or editable field. \\[widget-forward] | |
| 3953 Move to previous button or editable field. \\[widget-backward] | |
| 3954 \\<widget-field-keymap>\ | |
| 3955 Complete content of editable text field. \\[widget-complete] | |
| 3956 \\<custom-mode-map>\ | |
| 3957 Invoke button under point. \\[widget-button-press] | |
| 3958 Set all modifications. \\[Custom-set] | |
| 3959 Make all modifications default. \\[Custom-save] | |
| 4178 | 3960 Reset all modified options. \\[Custom-reset-current] |
| 428 | 3961 Reset all modified or set options. \\[Custom-reset-saved] |
| 3962 Reset all options. \\[Custom-reset-standard] | |
| 3963 | |
| 3964 Entry to this mode calls the value of `custom-mode-hook' | |
| 3965 if that value is non-nil." | |
| 3966 (kill-all-local-variables) | |
| 3967 (setq major-mode 'custom-mode | |
| 3968 mode-name "Custom") | |
| 3969 (use-local-map custom-mode-map) | |
| 3970 (easy-menu-add Custom-mode-menu) | |
| 3971 (make-local-variable 'custom-options) | |
| 3972 (make-local-variable 'widget-documentation-face) | |
| 3973 (setq widget-documentation-face 'custom-documentation-face) | |
| 3974 (make-local-variable 'widget-button-face) | |
| 3975 (setq widget-button-face 'custom-button-face) | |
| 3976 (make-local-hook 'widget-edit-functions) | |
| 3977 (add-hook 'widget-edit-functions 'custom-state-buffer-message nil t) | |
| 3978 (run-hooks 'custom-mode-hook)) | |
| 3979 | |
| 3980 | |
| 442 | 3981 ;;;###autoload |
| 3982 (defun custom-migrate-custom-file (new-custom-file-name) | |
| 3983 "Migrate custom file from home directory." | |
| 3984 (mapc 'custom-save-delete | |
| 3985 '(custom-load-themes custom-reset-variables | |
| 3986 custom-set-variables | |
| 3987 custom-set-faces | |
| 3988 custom-reset-faces)) | |
| 3989 (with-current-buffer (find-file-noselect custom-file) | |
| 3990 (save-buffer)) | |
| 3991 (setq custom-file new-custom-file-name) | |
| 3992 (custom-save-all)) | |
| 3993 | |
| 428 | 3994 ;;; The End. |
| 3995 | |
| 3996 (provide 'cus-edit) | |
| 3997 | |
| 3998 ;; cus-edit.el ends here |