annotate lisp/emacs-lisp/easy-mmode.el @ 111918:e71e87e08d5f

* doc/lispref/modes.texi (Auto-Indentation): New section to document SMIE. (Major Mode Conventions): * doc/lispref/text.texi (Mode-Specific Indent): Refer to it.
author Stefan Monnier <monnier@iro.umontreal.ca>
date Tue, 07 Dec 2010 14:44:38 -0500
parents c66428d4b9ed
children 53205019b195 376148b31b5e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38436
b174db545cfd Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 38324
diff changeset
1 ;;; easy-mmode.el --- easy definition for major and minor modes
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
2
104912
ad1f780103d9 (easy-mmode-defmap): Add doc-string.
Glenn Morris <rgm@gnu.org>
parents: 104732
diff changeset
3 ;; Copyright (C) 1997, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 106708
diff changeset
4 ;; 2008, 2009, 2010 Free Software Foundation, Inc.
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
5
38455
802c948ddb3a *** empty log message ***
Pavel Janík <Pavel@Janik.cz>
parents: 38436
diff changeset
6 ;; Author: Georges Brun-Cottan <Georges.Brun-Cottan@inria.fr>
802c948ddb3a *** empty log message ***
Pavel Janík <Pavel@Janik.cz>
parents: 38436
diff changeset
7 ;; Maintainer: Stefan Monnier <monnier@gnu.org>
802c948ddb3a *** empty log message ***
Pavel Janík <Pavel@Janik.cz>
parents: 38436
diff changeset
8
802c948ddb3a *** empty log message ***
Pavel Janík <Pavel@Janik.cz>
parents: 38436
diff changeset
9 ;; Keywords: extensions lisp
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
10
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
11 ;; This file is part of GNU Emacs.
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
12
94655
90a2847062be Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94317
diff changeset
13 ;; GNU Emacs is free software: you can redistribute it and/or modify
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
14 ;; it under the terms of the GNU General Public License as published by
94655
90a2847062be Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94317
diff changeset
15 ;; the Free Software Foundation, either version 3 of the License, or
90a2847062be Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94317
diff changeset
16 ;; (at your option) any later version.
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
17
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
18 ;; GNU Emacs is distributed in the hope that it will be useful,
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
21 ;; GNU General Public License for more details.
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
22
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
23 ;; You should have received a copy of the GNU General Public License
94655
90a2847062be Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 94317
diff changeset
24 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
25
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
26 ;;; Commentary:
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
27
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
28 ;; Minor modes are useful and common. This package makes defining a
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
29 ;; minor mode easy, by focusing on the writing of the minor mode
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
30 ;; functionalities themselves. Moreover, this package enforces a
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
31 ;; conventional naming of user interface primitives, making things
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
32 ;; natural for the minor-mode end-users.
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
33
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
34 ;; For each mode, easy-mmode defines the following:
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
35 ;; <mode> : The minor mode predicate. A buffer-local variable.
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
36 ;; <mode>-map : The keymap possibly associated to <mode>.
29039
d8bafae6beb2 Update copyright and commentary.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28239
diff changeset
37 ;; see `define-minor-mode' documentation
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
38 ;;
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
39 ;; eval
29039
d8bafae6beb2 Update copyright and commentary.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28239
diff changeset
40 ;; (pp (macroexpand '(define-minor-mode <your-mode> <doc>)))
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
41 ;; to check the result before using it.
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
42
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
43 ;; The order in which minor modes are installed is important. Keymap
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44 ;; lookup proceeds down minor-mode-map-alist, and the order there
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
45 ;; tends to be the reverse of the order in which the modes were
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
46 ;; installed. Perhaps there should be a feature to let you specify
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
47 ;; orderings.
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
48
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
49 ;; Additionally to `define-minor-mode', the package provides convenient
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
50 ;; ways to define keymaps, and other helper functions for major and minor modes.
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
51
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
52 ;;; Code:
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
53
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
54 (eval-when-compile (require 'cl))
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
55
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
56 (defun easy-mmode-pretty-mode-name (mode &optional lighter)
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
57 "Turn the symbol MODE into a string intended for the user.
62149
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
58 If provided, LIGHTER will be used to help choose capitalization by,
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
59 replacing its case-insensitive matches with the literal string in LIGHTER."
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
60 (let* ((case-fold-search t)
62181
14a20ce36638 (easy-mmode-pretty-mode-name): Improve commentary.
Eli Zaretskii <eliz@gnu.org>
parents: 62149
diff changeset
61 ;; Produce "Foo-Bar minor mode" from foo-bar-minor-mode.
32048
39617f078b9d (easy-mmode-pretty-mode-name): Prettier.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 31981
diff changeset
62 (name (concat (replace-regexp-in-string
62181
14a20ce36638 (easy-mmode-pretty-mode-name): Improve commentary.
Eli Zaretskii <eliz@gnu.org>
parents: 62149
diff changeset
63 ;; If the original mode name included "-minor" (some
14a20ce36638 (easy-mmode-pretty-mode-name): Improve commentary.
Eli Zaretskii <eliz@gnu.org>
parents: 62149
diff changeset
64 ;; of them don't, e.g. auto-revert-mode), then
14a20ce36638 (easy-mmode-pretty-mode-name): Improve commentary.
Eli Zaretskii <eliz@gnu.org>
parents: 62149
diff changeset
65 ;; replace it with " minor".
32048
39617f078b9d (easy-mmode-pretty-mode-name): Prettier.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 31981
diff changeset
66 "-Minor" " minor"
62149
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
67 ;; "foo-bar-minor" -> "Foo-Bar-Minor"
32048
39617f078b9d (easy-mmode-pretty-mode-name): Prettier.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 31981
diff changeset
68 (capitalize (replace-regexp-in-string
62149
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
69 ;; "foo-bar-minor-mode" -> "foo-bar-minor"
32048
39617f078b9d (easy-mmode-pretty-mode-name): Prettier.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 31981
diff changeset
70 "-mode\\'" "" (symbol-name mode))))
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
71 " mode")))
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
72 (if (not (stringp lighter)) name
62149
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
73 ;; Strip leading and trailing whitespace from LIGHTER.
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
74 (setq lighter (replace-regexp-in-string "\\`\\s-+\\|\\s-+\\'" ""
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
75 lighter))
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
76 ;; Replace any (case-insensitive) matches for LIGHTER in NAME
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
77 ;; with a literal LIGHTER. E.g., if NAME is "Iimage mode" and
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
78 ;; LIGHTER is " iImag", then this will produce "iImage mode".
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
79 ;; (LIGHTER normally comes from the mode-line string passed to
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
80 ;; define-minor-mode, and normally includes at least one leading
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
81 ;; space.)
e64f1e2ecec2 (easy-mmode-pretty-mode-name): Explain
Eli Zaretskii <eliz@gnu.org>
parents: 61861
diff changeset
82 (replace-regexp-in-string (regexp-quote lighter) lighter name t t))))
29399
addeae19bf96 (easy-mmode-derive-name): New function.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29039
diff changeset
83
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
84 ;;;###autoload
26551
271f77895660 Changed maintainer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 25408
diff changeset
85 (defalias 'easy-mmode-define-minor-mode 'define-minor-mode)
271f77895660 Changed maintainer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 25408
diff changeset
86 ;;;###autoload
271f77895660 Changed maintainer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 25408
diff changeset
87 (defmacro define-minor-mode (mode doc &optional init-value lighter keymap &rest body)
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
88 "Define a new minor mode MODE.
109948
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
89 This defines the control variable MODE and the toggle command MODE.
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
90 DOC is the documentation for the mode toggle command.
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
91
26551
271f77895660 Changed maintainer.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 25408
diff changeset
92 Optional INIT-VALUE is the initial value of the mode's variable.
29039
d8bafae6beb2 Update copyright and commentary.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28239
diff changeset
93 Optional LIGHTER is displayed in the modeline when the mode is on.
109948
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
94 Optional KEYMAP is the default keymap bound to the mode keymap.
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
95 If non-nil, it should be a variable name (whose value is a keymap),
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
96 a keymap, or a list of arguments for `easy-mmode-define-keymap'.
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
97 If KEYMAP is a keymap or list, this also defines the variable MODE-map.
33131
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
98
109948
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
99 BODY contains code to execute each time the mode is enabled or disabled.
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
100 It is executed after toggling the mode, and before running MODE-hook.
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
101 Before the actual body code, you can write keyword arguments, i.e.
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
102 alternating keywords and values. These following special keywords
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
103 are supported (other keywords are passed to `defcustom' if the minor
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
104 mode is global):
c66428d4b9ed Doc fix for define-minor-mode (Bug#6880).
Chong Yidong <cyd@stupidchicken.com>
parents: 106815
diff changeset
105
47788
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
106 :group GROUP Custom group name to use in all generated `defcustom' forms.
61318
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
107 Defaults to MODE without the possible trailing \"-mode\".
61861
d60a6aee7c8d (define-minor-mode): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 61318
diff changeset
108 Don't use this default group name unless you have written a
d60a6aee7c8d (define-minor-mode): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 61318
diff changeset
109 `defgroup' to define that group properly.
47463
2b213bd55695 (define-minor-mode): Add a :require arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47043
diff changeset
110 :global GLOBAL If non-nil specifies that the minor mode is not meant to be
61318
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
111 buffer-local, so don't make the variable MODE buffer-local.
47788
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
112 By default, the mode is buffer-local.
47463
2b213bd55695 (define-minor-mode): Add a :require arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47043
diff changeset
113 :init-value VAL Same as the INIT-VALUE argument.
2b213bd55695 (define-minor-mode): Add a :require arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47043
diff changeset
114 :lighter SPEC Same as the LIGHTER argument.
51320
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
115 :keymap MAP Same as the KEYMAP argument.
47788
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
116 :require SYM Same as in `defcustom'.
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
117
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
118 For example, you could write
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
119 (define-minor-mode foo-mode \"If enabled, foo on you!\"
50300
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
120 :lighter \" Foo\" :require 'foo :global t :group 'hassle :version \"27.5\"
47788
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
121 ...BODY CODE...)"
51320
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
122 (declare (debug (&define name stringp
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
123 [&optional [&not keywordp] sexp
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
124 &optional [&not keywordp] sexp
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
125 &optional [&not keywordp] sexp]
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
126 [&rest [keywordp sexp]]
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
127 def-body)))
47788
1174e4c84d58 (define-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 47657
diff changeset
128
33131
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
129 ;; Allow skipping the first three args.
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
130 (cond
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
131 ((keywordp init-value)
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
132 (setq body (list* init-value lighter keymap body)
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
133 init-value nil lighter nil keymap nil))
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
134 ((keywordp lighter)
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
135 (setq body (list* lighter keymap body) lighter nil keymap nil))
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
136 ((keywordp keymap) (push keymap body) (setq keymap nil)))
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
137
78860
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
138 (let* ((last-message (make-symbol "last-message"))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
139 (mode-name (symbol-name mode))
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
140 (pretty-name (easy-mmode-pretty-mode-name mode lighter))
29039
d8bafae6beb2 Update copyright and commentary.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28239
diff changeset
141 (globalp nil)
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
142 (set nil)
64295
f2e16ba201e0 (define-minor-mode): Do not override explicitly specified :initialize keyword.
Luc Teirlinck <teirllm@auburn.edu>
parents: 64085
diff changeset
143 (initialize nil)
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
144 (group nil)
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
145 (type nil)
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
146 (extra-args nil)
50300
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
147 (extra-keywords nil)
47463
2b213bd55695 (define-minor-mode): Add a :require arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47043
diff changeset
148 (require t)
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
149 (hook (intern (concat mode-name "-hook")))
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
150 (hook-on (intern (concat mode-name "-on-hook")))
50300
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
151 (hook-off (intern (concat mode-name "-off-hook")))
51320
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
152 keyw keymap-sym)
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
153
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
154 ;; Check keys.
50300
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
155 (while (keywordp (setq keyw (car body)))
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
156 (setq body (cdr body))
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
157 (case keyw
33131
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
158 (:init-value (setq init-value (pop body)))
105945
503b88c15efc (define-minor-mode): Purecopy :lighter.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 105372
diff changeset
159 (:lighter (setq lighter (purecopy (pop body))))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
160 (:global (setq globalp (pop body)))
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
161 (:extra-args (setq extra-args (pop body)))
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
162 (:set (setq set (list :set (pop body))))
64295
f2e16ba201e0 (define-minor-mode): Do not override explicitly specified :initialize keyword.
Luc Teirlinck <teirllm@auburn.edu>
parents: 64085
diff changeset
163 (:initialize (setq initialize (list :initialize (pop body))))
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
164 (:group (setq group (nconc group (list :group (pop body)))))
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
165 (:type (setq type (list :type (pop body))))
47463
2b213bd55695 (define-minor-mode): Add a :require arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47043
diff changeset
166 (:require (setq require (pop body)))
51320
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
167 (:keymap (setq keymap (pop body)))
50300
7e4e15b857f3 (define-minor-mode): Use custom-set-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 49598
diff changeset
168 (t (push keyw extra-keywords) (push (pop body) extra-keywords))))
32999
6bc392d6aef3 (define-minor-mode): Generate `turn-on-MODE' and `turn-off-MODE'
Miles Bader <miles@gnu.org>
parents: 32491
diff changeset
169
51320
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
170 (setq keymap-sym (if (and keymap (symbolp keymap)) keymap
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
171 (intern (concat mode-name "-map"))))
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
172
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
173 (unless set (setq set '(:set 'custom-set-minor-mode)))
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
174
64295
f2e16ba201e0 (define-minor-mode): Do not override explicitly specified :initialize keyword.
Luc Teirlinck <teirllm@auburn.edu>
parents: 64085
diff changeset
175 (unless initialize
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
176 (setq initialize '(:initialize 'custom-initialize-default)))
64295
f2e16ba201e0 (define-minor-mode): Do not override explicitly specified :initialize keyword.
Luc Teirlinck <teirllm@auburn.edu>
parents: 64085
diff changeset
177
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
178 (unless group
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
179 ;; We might as well provide a best-guess default group.
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
180 (setq group
61318
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
181 `(:group ',(intern (replace-regexp-in-string
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
182 "-mode\\'" "" mode-name)))))
62635
a33f6ed6e52e (define-global-minor-mode): Use `after-change-major-mode-hook' instead
Luc Teirlinck <teirllm@auburn.edu>
parents: 62433
diff changeset
183
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
184 (unless type (setq type '(:type 'boolean)))
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
185
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
186 `(progn
25408
68c51b1a537f (easy-mmode-define-minor-mode):
Karl Heuer <kwzh@gnu.org>
parents: 24935
diff changeset
187 ;; Define the variable to enable or disable the mode.
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
188 ,(if (not globalp)
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
189 `(progn
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
190 (defvar ,mode ,init-value ,(format "Non-nil if %s is enabled.
35562
6b8b7796f28b (define-minor-mode): Docstring fix.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 34149
diff changeset
191 Use the command `%s' to change this variable." pretty-name mode))
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
192 (make-variable-buffer-local ',mode))
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
193
65094
e1fcf3783add (define-minor-mode): Simplify.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 64586
diff changeset
194 (let ((base-doc-string
e1fcf3783add (define-minor-mode): Simplify.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 64586
diff changeset
195 (concat "Non-nil if %s is enabled.
77672
6e620a52f54b (define-minor-mode): Fix generated doc string.
Richard M. Stallman <rms@gnu.org>
parents: 77424
diff changeset
196 See the command `%s' for a description of this minor mode."
65094
e1fcf3783add (define-minor-mode): Simplify.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 64586
diff changeset
197 (if body "
29039
d8bafae6beb2 Update copyright and commentary.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28239
diff changeset
198 Setting this variable directly does not take effect;
72587
e2ff121d30ca (define-minor-mode): Reference manual about customization, rather than
Richard M. Stallman <rms@gnu.org>
parents: 71728
diff changeset
199 either customize it (see the info node `Easy Customization')
e2ff121d30ca (define-minor-mode): Reference manual about customization, rather than
Richard M. Stallman <rms@gnu.org>
parents: 71728
diff changeset
200 or call the function `%s'."))))
63141
c531a8daedc6 (define-minor-mode): If BODY is empty, give the variable a doc string
Richard M. Stallman <rms@gnu.org>
parents: 63023
diff changeset
201 `(defcustom ,mode ,init-value
c531a8daedc6 (define-minor-mode): If BODY is empty, give the variable a doc string
Richard M. Stallman <rms@gnu.org>
parents: 63023
diff changeset
202 ,(format base-doc-string pretty-name mode mode)
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
203 ,@set
64295
f2e16ba201e0 (define-minor-mode): Do not override explicitly specified :initialize keyword.
Luc Teirlinck <teirllm@auburn.edu>
parents: 64085
diff changeset
204 ,@initialize
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
205 ,@group
64357
25d7b8b15748 (define-minor-mode): Avoid constructing a defcustom with two :set or
Luc Teirlinck <teirllm@auburn.edu>
parents: 64295
diff changeset
206 ,@type
65094
e1fcf3783add (define-minor-mode): Simplify.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 64586
diff changeset
207 ,@(unless (eq require t) `(:require ,require))
e1fcf3783add (define-minor-mode): Simplify.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 64586
diff changeset
208 ,@(nreverse extra-keywords))))
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
209
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
210 ;; The actual function.
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
211 (defun ,mode (&optional arg ,@extra-args)
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
212 ,(or doc
33131
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
213 (format (concat "Toggle %s on or off.
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
214 Interactively, with no prefix argument, toggle the mode.
46900
3c3d686b25fa (easy-mmode-define-global-mode): Use find-file-hook instead of find-file-hooks.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46873
diff changeset
215 With universal prefix ARG turn mode on.
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
216 With zero or negative ARG turn mode off.
33131
8d1ed5c84809 (define-minor-mode):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33001
diff changeset
217 \\{%s}") pretty-name keymap-sym))
46900
3c3d686b25fa (easy-mmode-define-global-mode): Use find-file-hook instead of find-file-hooks.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46873
diff changeset
218 ;; Use `toggle' rather than (if ,mode 0 1) so that using
3c3d686b25fa (easy-mmode-define-global-mode): Use find-file-hook instead of find-file-hooks.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46873
diff changeset
219 ;; repeat-command still does the toggling correctly.
3c3d686b25fa (easy-mmode-define-global-mode): Use find-file-hook instead of find-file-hooks.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46873
diff changeset
220 (interactive (list (or current-prefix-arg 'toggle)))
78860
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
221 (let ((,last-message (current-message)))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
222 (setq ,mode
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
223 (cond
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
224 ((eq arg 'toggle) (not ,mode))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
225 (arg (> (prefix-numeric-value arg) 0))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
226 (t
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
227 (if (null ,mode) t
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
228 (message
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
229 "Toggling %s off; better pass an explicit argument."
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
230 ',mode)
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
231 nil))))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
232 ,@body
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
233 ;; The on/off hooks are here for backward compatibility only.
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
234 (run-hooks ',hook (if ,mode ',hook-on ',hook-off))
105371
0769a73f1d18 * image-mode.el (image-toggle-display):
Juanma Barranquero <lekktu@gmail.com>
parents: 104912
diff changeset
235 (if (called-interactively-p 'any)
78860
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
236 (progn
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
237 ,(if globalp `(customize-mark-as-set ',mode))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
238 ;; Avoid overwriting a message shown by the body,
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
239 ;; but do overwrite previous messages.
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
240 (unless (and (current-message)
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
241 (not (equal ,last-message
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
242 (current-message))))
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
243 (message ,(format "%s %%sabled" pretty-name)
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
244 (if ,mode "en" "dis"))))))
47043
360c6fcdde04 (define-minor-mode): Use customize-mark-as-set for global minor modes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46900
diff changeset
245 (force-mode-line-update)
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
246 ;; Return the new setting.
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
247 ,mode)
51320
418f1ce2a14e (define-minor-mode): Add edebug spec.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 50635
diff changeset
248
61318
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
249 ;; Autoloading a define-minor-mode autoloads everything
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
250 ;; up-to-here.
29548
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
251 :autoload-end
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
252
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
253 ;; Define the minor-mode keymap.
29548
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
254 ,(unless (symbolp keymap) ;nil is also a symbol.
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
255 `(defvar ,keymap-sym
29548
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
256 (let ((m ,keymap))
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
257 (cond ((keymapp m) m)
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
258 ((listp m) (easy-mmode-define-keymap m))
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
259 (t (error "Invalid keymap %S" ,keymap))))
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
260 ,(format "Keymap for `%s'." mode-name)))
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
261
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
262 (add-minor-mode ',mode ',lighter
29548
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
263 ,(if keymap keymap-sym
104732
9792b61a3641 (define-minor-mode): Don't use symbol-value with constant argument.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 100908
diff changeset
264 `(if (boundp ',keymap-sym) ,keymap-sym))))))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
265
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
266 ;;;
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
267 ;;; make global minor mode
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
268 ;;;
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
269
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
270 ;;;###autoload
75643
39dd9f1dfbb0 (define-globalized-minor-mode): Rename from define-global-minor-mode.
Chong Yidong <cyd@stupidchicken.com>
parents: 75346
diff changeset
271 (defalias 'easy-mmode-define-global-mode 'define-globalized-minor-mode)
61175
ef26a481327e (define-global-minor-mode): Renamed from easy-mmode-define-global-mode.
Richard M. Stallman <rms@gnu.org>
parents: 61168
diff changeset
272 ;;;###autoload
75643
39dd9f1dfbb0 (define-globalized-minor-mode): Rename from define-global-minor-mode.
Chong Yidong <cyd@stupidchicken.com>
parents: 75346
diff changeset
273 (defalias 'define-global-minor-mode 'define-globalized-minor-mode)
39dd9f1dfbb0 (define-globalized-minor-mode): Rename from define-global-minor-mode.
Chong Yidong <cyd@stupidchicken.com>
parents: 75346
diff changeset
274 ;;;###autoload
39dd9f1dfbb0 (define-globalized-minor-mode): Rename from define-global-minor-mode.
Chong Yidong <cyd@stupidchicken.com>
parents: 75346
diff changeset
275 (defmacro define-globalized-minor-mode (global-mode mode turn-on &rest keys)
74995
5faab2f9dd46 (define-global-minor-mode): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 74306
diff changeset
276 "Make a global mode GLOBAL-MODE corresponding to buffer-local minor MODE.
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
277 TURN-ON is a function that will be called with no args in every buffer
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
278 and that should try to turn MODE on if applicable for that buffer.
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
279 KEYS is a list of CL-style keyword arguments. As the minor mode
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
280 defined by this function is always global, any :global keyword is
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
281 ignored. Other keywords have the same meaning as in `define-minor-mode',
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
282 which see. In particular, :group specifies the custom group.
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
283 The most useful keywords are those that are passed on to the
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
284 `defcustom'. It normally makes no sense to pass the :lighter
75643
39dd9f1dfbb0 (define-globalized-minor-mode): Rename from define-global-minor-mode.
Chong Yidong <cyd@stupidchicken.com>
parents: 75346
diff changeset
285 or :keymap keywords to `define-globalized-minor-mode', since these
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
286 are usually passed to the buffer-local version of the minor mode.
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
287
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
288 If MODE's set-up depends on the major mode in effect when it was
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
289 enabled, then disabling and reenabling MODE should make MODE work
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
290 correctly with the current major mode. This is important to
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
291 prevent problems with derived modes, that is, major modes that
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
292 call another major mode in their body."
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
293
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
294 (let* ((global-mode-name (symbol-name global-mode))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
295 (pretty-name (easy-mmode-pretty-mode-name mode))
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
296 (pretty-global-name (easy-mmode-pretty-mode-name global-mode))
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
297 (group nil)
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
298 (extra-keywords nil)
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
299 (MODE-buffers (intern (concat global-mode-name "-buffers")))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
300 (MODE-enable-in-buffers
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
301 (intern (concat global-mode-name "-enable-in-buffers")))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
302 (MODE-check-buffers
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
303 (intern (concat global-mode-name "-check-buffers")))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
304 (MODE-cmhh (intern (concat global-mode-name "-cmhh")))
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
305 (MODE-major-mode (intern (concat (symbol-name mode) "-major-mode")))
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
306 keyw)
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
307
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
308 ;; Check keys.
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
309 (while (keywordp (setq keyw (car keys)))
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
310 (setq keys (cdr keys))
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
311 (case keyw
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
312 (:group (setq group (nconc group (list :group (pop keys)))))
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
313 (:global (setq keys (cdr keys)))
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
314 (t (push keyw extra-keywords) (push (pop keys) extra-keywords))))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
315
33162
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
316 (unless group
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
317 ;; We might as well provide a best-guess default group.
ccf6cd7d4512 (define-minor-mode): Remove :toggle arg.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33131
diff changeset
318 (setq group
61318
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
319 `(:group ',(intern (replace-regexp-in-string
8c8c06fad8d3 (define-global-minor-mode): Don't use custom-current-group.
Lute Kamstra <lute@gnu.org>
parents: 61175
diff changeset
320 "-mode\\'" "" (symbol-name mode))))))
48838
e0689be193e2 (define-minor-mode): Use `custom-current-group'.
Markus Rost <rost@math.uni-bielefeld.de>
parents: 47788
diff changeset
321
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
322 `(progn
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
323 (defvar ,MODE-major-mode nil)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
324 (make-variable-buffer-local ',MODE-major-mode)
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
325 ;; The actual global minor-mode
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
326 (define-minor-mode ,global-mode
106708
fecbb2b5a355 emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Make
Eli Zaretskii <eliz@gnu.org>
parents: 105945
diff changeset
327 ;; Very short lines to avoid too long lines in the generated
fecbb2b5a355 emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Make
Eli Zaretskii <eliz@gnu.org>
parents: 105945
diff changeset
328 ;; doc string.
77424
d3f723361ea3 (define-globalized-minor-mode): Improve doc string of generated command.
Richard M. Stallman <rms@gnu.org>
parents: 75643
diff changeset
329 ,(format "Toggle %s in every possible buffer.
106708
fecbb2b5a355 emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Make
Eli Zaretskii <eliz@gnu.org>
parents: 105945
diff changeset
330 With prefix ARG, turn %s on if and only if
fecbb2b5a355 emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Make
Eli Zaretskii <eliz@gnu.org>
parents: 105945
diff changeset
331 ARG is positive.
fecbb2b5a355 emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Make
Eli Zaretskii <eliz@gnu.org>
parents: 105945
diff changeset
332 %s is enabled in all buffers where
fecbb2b5a355 emacs-lisp/easy-mmode.el (define-globalized-minor-mode): Make
Eli Zaretskii <eliz@gnu.org>
parents: 105945
diff changeset
333 \`%s' would do it.
77424
d3f723361ea3 (define-globalized-minor-mode): Improve doc string of generated command.
Richard M. Stallman <rms@gnu.org>
parents: 75643
diff changeset
334 See `%s' for more information on %s."
d3f723361ea3 (define-globalized-minor-mode): Improve doc string of generated command.
Richard M. Stallman <rms@gnu.org>
parents: 75643
diff changeset
335 pretty-name pretty-global-name pretty-name turn-on
d3f723361ea3 (define-globalized-minor-mode): Improve doc string of generated command.
Richard M. Stallman <rms@gnu.org>
parents: 75643
diff changeset
336 mode pretty-name)
66721
67170e911864 (define-global-minor-mode): Pass all specified keyword args on to
Luc Teirlinck <teirllm@auburn.edu>
parents: 65094
diff changeset
337 :global t ,@group ,@(nreverse extra-keywords)
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
338
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
339 ;; Setup hook to handle future mode changes and new buffers.
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
340 (if ,global-mode
29414
b18a17d5d9c6 (easy-mmode-define-global-mode): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29411
diff changeset
341 (progn
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
342 (add-hook 'after-change-major-mode-hook
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
343 ',MODE-enable-in-buffers)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
344 (add-hook 'find-file-hook ',MODE-check-buffers)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
345 (add-hook 'change-major-mode-hook ',MODE-cmhh))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
346 (remove-hook 'after-change-major-mode-hook ',MODE-enable-in-buffers)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
347 (remove-hook 'find-file-hook ',MODE-check-buffers)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
348 (remove-hook 'change-major-mode-hook ',MODE-cmhh))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
349
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
350 ;; Go through existing buffers.
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
351 (dolist (buf (buffer-list))
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
352 (with-current-buffer buf
33165
8b3f1e99c11a (easy-mmode-define-global-mode): Only turn mode off if it's on.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33162
diff changeset
353 (if ,global-mode (,turn-on) (when ,mode (,mode -1))))))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
354
75643
39dd9f1dfbb0 (define-globalized-minor-mode): Rename from define-global-minor-mode.
Chong Yidong <cyd@stupidchicken.com>
parents: 75346
diff changeset
355 ;; Autoloading define-globalized-minor-mode autoloads everything
62433
50ff61f0f99d (define-minor-mode): Don't generate a defcustom for the mode hook variable.
Lute Kamstra <lute@gnu.org>
parents: 62181
diff changeset
356 ;; up-to-here.
29548
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
357 :autoload-end
71b284c55162 (define-minor-mode): If KEYMAP is a symbol, just use it.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29414
diff changeset
358
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
359 ;; List of buffers left to process.
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
360 (defvar ,MODE-buffers nil)
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
361
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
362 ;; The function that calls TURN-ON in each buffer.
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
363 (defun ,MODE-enable-in-buffers ()
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
364 (dolist (buf ,MODE-buffers)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
365 (when (buffer-live-p buf)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
366 (with-current-buffer buf
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
367 (if ,mode
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
368 (unless (eq ,MODE-major-mode major-mode)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
369 (,mode -1)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
370 (,turn-on)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
371 (setq ,MODE-major-mode major-mode))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
372 (,turn-on)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
373 (setq ,MODE-major-mode major-mode))))))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
374 (put ',MODE-enable-in-buffers 'definition-name ',global-mode)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
375
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
376 (defun ,MODE-check-buffers ()
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
377 (,MODE-enable-in-buffers)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
378 (setq ,MODE-buffers nil)
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
379 (remove-hook 'post-command-hook ',MODE-check-buffers))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
380 (put ',MODE-check-buffers 'definition-name ',global-mode)
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
381
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
382 ;; The function that catches kill-all-local-variables.
63023
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
383 (defun ,MODE-cmhh ()
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
384 (add-to-list ',MODE-buffers (current-buffer))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
385 (add-hook 'post-command-hook ',MODE-check-buffers))
cc9dd228e2e6 (define-global-minor-mode): Make it keep track of which major mode it
Luc Teirlinck <teirllm@auburn.edu>
parents: 62635
diff changeset
386 (put ',MODE-cmhh 'definition-name ',global-mode))))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
387
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
388 ;;;
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
389 ;;; easy-mmode-defmap
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
390 ;;;
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
391
96187
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
392 (eval-and-compile
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
393 (if (fboundp 'set-keymap-parents)
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
394 (defalias 'easy-mmode-set-keymap-parents 'set-keymap-parents)
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
395 (defun easy-mmode-set-keymap-parents (m parents)
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
396 (set-keymap-parent
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
397 m
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
398 (cond
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
399 ((not (consp parents)) parents)
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
400 ((not (cdr parents)) (car parents))
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
401 (t (let ((m (copy-keymap (pop parents))))
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
402 (easy-mmode-set-keymap-parents m parents)
c8bbd45f39e0 (easy-mmode-set-keymap-parents): Evaluate definition when compiling.
Glenn Morris <rgm@gnu.org>
parents: 94655
diff changeset
403 m)))))))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
404
31981
533a4e5f06e2 (easy-mmode-define-keymap): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 30876
diff changeset
405 ;;;###autoload
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
406 (defun easy-mmode-define-keymap (bs &optional name m args)
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
407 "Return a keymap built from bindings BS.
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
408 BS must be a list of (KEY . BINDING) where
29399
addeae19bf96 (easy-mmode-derive-name): New function.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29039
diff changeset
409 KEY and BINDINGS are suitable for `define-key'.
addeae19bf96 (easy-mmode-derive-name): New function.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29039
diff changeset
410 Optional NAME is passed to `make-sparse-keymap'.
addeae19bf96 (easy-mmode-derive-name): New function.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29039
diff changeset
411 Optional map M can be used to modify an existing map.
94317
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
412 ARGS is a list of additional keyword arguments.
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
413
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
414 Valid keywords and arguments are:
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
415
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
416 :name Name of the keymap; overrides NAME argument.
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
417 :dense Non-nil for a dense keymap.
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
418 :inherit Parent keymap.
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
419 :group Ignored.
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
420 :suppress Non-nil to call `suppress-keymap' on keymap,
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
421 'nodigits to suppress digits as prefix arguments."
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
422 (let (inherit dense suppress)
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
423 (while args
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
424 (let ((key (pop args))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
425 (val (pop args)))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
426 (case key
33433
e8794ae4f856 (easy-mmode-define-keymap):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33358
diff changeset
427 (:name (setq name val))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
428 (:dense (setq dense val))
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
429 (:inherit (setq inherit val))
94317
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
430 (:suppress (setq suppress val))
29411
232f7e558a38 Require CL during compilation.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29406
diff changeset
431 (:group)
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
432 (t (message "Unknown argument %s in defmap" key)))))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
433 (unless (keymapp m)
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
434 (setq bs (append m bs))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
435 (setq m (if dense (make-keymap name) (make-sparse-keymap name))))
94317
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
436 (when suppress
8f25e59015ea Tom Tromey <tromey at redhat.com>
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
437 (suppress-keymap m (eq suppress 'nodigits)))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
438 (dolist (b bs)
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
439 (let ((keys (car b))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
440 (binding (cdr b)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
441 (dolist (key (if (consp keys) keys (list keys)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
442 (cond
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
443 ((symbolp key)
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
444 (substitute-key-definition key binding m global-map))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
445 ((null binding)
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
446 (unless (keymapp (lookup-key m key)) (define-key m key binding)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
447 ((let ((o (lookup-key m key)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
448 (or (null o) (numberp o) (eq o 'undefined)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
449 (define-key m key binding))))))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
450 (cond
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
451 ((keymapp inherit) (set-keymap-parent m inherit))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
452 ((consp inherit) (easy-mmode-set-keymap-parents m inherit)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
453 m))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
454
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
455 ;;;###autoload
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
456 (defmacro easy-mmode-defmap (m bs doc &rest args)
104912
ad1f780103d9 (easy-mmode-defmap): Add doc-string.
Glenn Morris <rgm@gnu.org>
parents: 104732
diff changeset
457 "Define a constant M whose value is the result of `easy-mmode-define-keymap'.
ad1f780103d9 (easy-mmode-defmap): Add doc-string.
Glenn Morris <rgm@gnu.org>
parents: 104732
diff changeset
458 The M, BS, and ARGS arguments are as per that function. DOC is
ad1f780103d9 (easy-mmode-defmap): Add doc-string.
Glenn Morris <rgm@gnu.org>
parents: 104732
diff changeset
459 the constant's documentation."
31981
533a4e5f06e2 (easy-mmode-define-keymap): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 30876
diff changeset
460 `(defconst ,m
533a4e5f06e2 (easy-mmode-define-keymap): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 30876
diff changeset
461 (easy-mmode-define-keymap ,bs nil (if (boundp ',m) ,m) ,(cons 'list args))
533a4e5f06e2 (easy-mmode-define-keymap): Autoload.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 30876
diff changeset
462 ,doc))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
463
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
464
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
465 ;;;
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
466 ;;; easy-mmode-defsyntax
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
467 ;;;
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
468
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
469 (defun easy-mmode-define-syntax (css args)
32491
2fc546f941df (easy-mmode-define-syntax): Use plist-get and allow :inherit.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32199
diff changeset
470 (let ((st (make-syntax-table (plist-get args :copy)))
2fc546f941df (easy-mmode-define-syntax): Use plist-get and allow :inherit.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32199
diff changeset
471 (parent (plist-get args :inherit)))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
472 (dolist (cs css)
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
473 (let ((char (car cs))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
474 (syntax (cdr cs)))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
475 (if (sequencep char)
84897
992e87082552 (easy-mmode-define-syntax): Use `mapc' rather than `mapcar'.
Juanma Barranquero <lekktu@gmail.com>
parents: 78217
diff changeset
476 (mapc (lambda (c) (modify-syntax-entry c syntax st)) char)
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
477 (modify-syntax-entry char syntax st))))
32491
2fc546f941df (easy-mmode-define-syntax): Use plist-get and allow :inherit.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32199
diff changeset
478 (if parent (set-char-table-parent
2fc546f941df (easy-mmode-define-syntax): Use plist-get and allow :inherit.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32199
diff changeset
479 st (if (symbolp parent) (symbol-value parent) parent)))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
480 st))
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
481
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
482 ;;;###autoload
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
483 (defmacro easy-mmode-defsyntax (st css doc &rest args)
32491
2fc546f941df (easy-mmode-define-syntax): Use plist-get and allow :inherit.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32199
diff changeset
484 "Define variable ST as a syntax-table.
37406
3886350a8826 (easy-mmode-defsyntax): Unquote `doc'.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 35562
diff changeset
485 CSS contains a list of syntax specifications of the form (CHAR . SYNTAX)."
28086
9ff6e6a6c6b5 (easy-mmode-defmap, easy-mmode-defsyntax): Autoload the functions used.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28081
diff changeset
486 `(progn
9ff6e6a6c6b5 (easy-mmode-defmap, easy-mmode-defsyntax): Autoload the functions used.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28081
diff changeset
487 (autoload 'easy-mmode-define-syntax "easy-mmode")
37406
3886350a8826 (easy-mmode-defsyntax): Unquote `doc'.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 35562
diff changeset
488 (defconst ,st (easy-mmode-define-syntax ,css ,(cons 'list args)) ,doc)))
28081
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
489
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
490
6360842e5962 (easy-mmode-define-keymap): Extend to allow more flexibility.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 26551
diff changeset
491
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
492 ;;;
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
493 ;;; easy-mmode-define-navigation
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
494 ;;;
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
495
85463
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
496 (defmacro easy-mmode-define-navigation (base re &optional name endfun narrowfun
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
497 &rest body)
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
498 "Define BASE-next and BASE-prev to navigate in the buffer.
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
499 RE determines the places the commands should move point to.
33358
a86c95343fa5 (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 33165
diff changeset
500 NAME should describe the entities matched by RE. It is used to build
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
501 the docstrings of the two functions.
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
502 BASE-next also tries to make sure that the whole entry is visible by
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
503 searching for its end (by calling ENDFUN if provided or by looking for
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
504 the next entry) and recentering if necessary.
53056
a9d324df91c7 (easy-mmode-define-navigation): Take additional
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 52881
diff changeset
505 ENDFUN should return the end position (with or without moving point).
a9d324df91c7 (easy-mmode-define-navigation): Take additional
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 52881
diff changeset
506 NARROWFUN non-nil means to check for narrowing before moving, and if
85463
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
507 found, do `widen' first and then call NARROWFUN with no args after moving.
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
508 BODY is executed after moving to the destination location."
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
509 (declare (indent 5) (debug (exp exp exp def-form def-form &rest def-body)))
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
510 (let* ((base-name (symbol-name base))
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
511 (prev-sym (intern (concat base-name "-prev")))
53056
a9d324df91c7 (easy-mmode-define-navigation): Take additional
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 52881
diff changeset
512 (next-sym (intern (concat base-name "-next")))
85463
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
513 (when-narrowed
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
514 (lambda (body)
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
515 (if (null narrowfun) body
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
516 `(let ((was-narrowed
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
517 (prog1 (or (< (- (point-max) (point-min)) (buffer-size)))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
518 (widen))))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
519 ,body
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
520 (when was-narrowed (,narrowfun)))))))
51643
3161ec452b93 (easy-mmode-define-navigation): Avoid
Andreas Schwab <schwab@suse.de>
parents: 51320
diff changeset
521 (unless name (setq name base-name))
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
522 `(progn
29406
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
523 (add-to-list 'debug-ignored-errors
f4b12c3efee8 (easy-mmode-define-toggle): Remove (inline into define-minor-mode).
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29399
diff changeset
524 ,(concat "^No \\(previous\\|next\\) " (regexp-quote name)))
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
525 (defun ,next-sym (&optional count)
28239
21cd65af5197 (easy-mmode-define-navigation): Only use `ding' for interactive use
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28235
diff changeset
526 ,(format "Go to the next COUNT'th %s." name)
74306
e6443f563ae7 (easy-mmode-define-navigation): Fix interactive spec of the functions
Chong Yidong <cyd@stupidchicken.com>
parents: 72587
diff changeset
527 (interactive "p")
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
528 (unless count (setq count 1))
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
529 (if (< count 0) (,prev-sym (- count))
52881
a2ef3d8f83d4 (easy-mmode-define-navigation): Avoid
Dave Love <fx@gnu.org>
parents: 52401
diff changeset
530 (if (looking-at ,re) (setq count (1+ count)))
85463
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
531 ,(funcall when-narrowed
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
532 `(if (not (re-search-forward ,re nil t count))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
533 (if (looking-at ,re)
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
534 (goto-char (or ,(if endfun `(,endfun)) (point-max)))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
535 (error "No next %s" ,name))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
536 (goto-char (match-beginning 0))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
537 (when (and (eq (current-buffer) (window-buffer (selected-window)))
105372
bd2966850aac Use `called-interactively-p' instead of `interactive-p'.
Juanma Barranquero <lekktu@gmail.com>
parents: 105371
diff changeset
538 (called-interactively-p 'interactive))
85463
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
539 (let ((endpt (or (save-excursion
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
540 ,(if endfun `(,endfun)
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
541 `(re-search-forward ,re nil t 2)))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
542 (point-max))))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
543 (unless (pos-visible-in-window-p endpt nil t)
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
544 (recenter '(0)))))))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
545 ,@body))
67293
32fa638322e0 (easy-mmode-define-navigation): Put `definition-name' properties on the
Juri Linkov <juri@jurta.org>
parents: 66721
diff changeset
546 (put ',next-sym 'definition-name ',base)
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
547 (defun ,prev-sym (&optional count)
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
548 ,(format "Go to the previous COUNT'th %s" (or name base-name))
74306
e6443f563ae7 (easy-mmode-define-navigation): Fix interactive spec of the functions
Chong Yidong <cyd@stupidchicken.com>
parents: 72587
diff changeset
549 (interactive "p")
28235
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
550 (unless count (setq count 1))
963f1d516e92 * derived.el (define-derived-mode): Don't autoload anymore.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28086
diff changeset
551 (if (< count 0) (,next-sym (- count))
85463
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
552 ,(funcall when-narrowed
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
553 `(unless (re-search-backward ,re nil t count)
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
554 (error "No previous %s" ,name)))
771c063a16df (easy-mmode-define-navigation):
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 85114
diff changeset
555 ,@body))
67293
32fa638322e0 (easy-mmode-define-navigation): Put `definition-name' properties on the
Juri Linkov <juri@jurta.org>
parents: 66721
diff changeset
556 (put ',prev-sym 'definition-name ',base))))
53056
a9d324df91c7 (easy-mmode-define-navigation): Take additional
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 52881
diff changeset
557
28086
9ff6e6a6c6b5 (easy-mmode-defmap, easy-mmode-defsyntax): Autoload the functions used.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 28081
diff changeset
558
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
559 (provide 'easy-mmode)
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
560
78860
03a3e0a6776c (define-minor-mode): Fix staging brain damage.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 78217
diff changeset
561 ;; arch-tag: d48a5250-6961-4528-9cb0-3c9ea042a66a
18388
7e14277c51f3 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
562 ;;; easy-mmode.el ends here