Mercurial > emacs
annotate lisp/generic.el @ 61169:e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
mode hook.
(generic-mode-internal): Use run-mode-hooks.
author | Lute Kamstra <lute@gnu.org> |
---|---|
date | Thu, 31 Mar 2005 14:54:00 +0000 |
parents | 7160fe3a7ef1 |
children | 20df42e1599e |
rev | line source |
---|---|
38436
b174db545cfd
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
37058
diff
changeset
|
1 ;;; generic.el --- defining simple major modes with comment and font-lock |
18254 | 2 ;; |
60595
b392b963c10b
(define-generic-mode): Let generic-mode-list be a list of strings;
Lute Kamstra <lute@gnu.org>
parents:
58587
diff
changeset
|
3 ;; Copyright (C) 1997, 1999, 2004, 2005 Free Software Foundation, Inc. |
18254 | 4 ;; |
21182 | 5 ;; Author: Peter Breton <pbreton@cs.umb.edu> |
18254 | 6 ;; Created: Fri Sep 27 1996 |
7 ;; Keywords: generic, comment, font-lock | |
8 | |
9 ;; This file is part of GNU Emacs. | |
10 | |
11 ;; GNU Emacs is free software; you can redistribute it and/or modify | |
12 ;; it under the terms of the GNU General Public License as published by | |
13 ;; the Free Software Foundation; either version 2, or (at your option) | |
14 ;; any later version. | |
15 | |
16 ;; GNU Emacs is distributed in the hope that it will be useful, | |
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 ;; GNU General Public License for more details. | |
20 | |
21 ;; You should have received a copy of the GNU General Public License | |
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the | |
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
24 ;; Boston, MA 02111-1307, USA. | |
25 | |
26 ;; Purpose: | |
27 | |
28 ;; Meta-mode to create simple major modes | |
29 ;; with basic comment and font-lock support | |
30 | |
31 ;;; Commentary: | |
32 | |
33 ;; INTRODUCTION: | |
34 | |
35 ;; Generic-mode is a meta-mode which can be used to define small modes | |
21014 | 36 ;; which provide basic comment and font-lock support. These modes are |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
37 ;; intended for the many configuration files and such which are too |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
38 ;; small for a "real" mode, but still have a regular syntax, comment |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
39 ;; characters and the like. |
18254 | 40 ;; |
41 ;; Each generic mode can define the following: | |
42 ;; | |
21014 | 43 ;; * List of comment-characters. The entries in this list should be |
18254 | 44 ;; either a character, a one or two character string or a cons pair. |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
45 ;; If the entry is a character or a string, it is added to the |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
46 ;; mode's syntax table with `comment-start' syntax. If the entry is |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
47 ;; a cons pair, the elements of the pair are considered to be |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
48 ;; `comment-start' and `comment-end' respectively. (The latter |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
49 ;; should be nil if you want comments to end at end of line.) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
50 ;; LIMITATIONS: Emacs does not support comment strings of more than |
18254 | 51 ;; two characters in length. |
52 ;; | |
21014 | 53 ;; * List of keywords to font-lock. Each keyword should be a string. |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
54 ;; If you have additional keywords which should be highlighted in a |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
55 ;; face different from `font-lock-keyword-face', you can use the |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
56 ;; convenience function `generic-make-keywords-list' (which see), |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
57 ;; and add the result to the following list: |
32120 | 58 ;; |
21014 | 59 ;; * Additional expressions to font-lock. This should be a list of |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
60 ;; expressions, each of which should be of the same form as those in |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
61 ;; `font-lock-keywords'. |
32120 | 62 ;; |
18254 | 63 ;; * List of regular expressions to be placed in auto-mode-alist. |
64 ;; | |
65 ;; * List of functions to call to do some additional setup | |
66 ;; | |
67 ;; This should pretty much cover basic functionality; if you need much | |
68 ;; more than this, or you find yourself writing extensive customizations, | |
69 ;; perhaps you should be writing a major mode instead! | |
70 ;; | |
71 ;; LOCAL VARIABLES: | |
72 ;; | |
73 ;; To put a file into generic mode using local variables, use a line | |
74 ;; like this in a Local Variables block: | |
75 ;; | |
76 ;; mode: default-generic | |
77 ;; | |
78 ;; Do NOT use "mode: generic"! | |
79 ;; See also "AUTOMATICALLY ENTERING GENERIC MODE" below. | |
32120 | 80 ;; |
18254 | 81 ;; DEFINING NEW GENERIC MODES: |
82 ;; | |
21182 | 83 ;; Use the `define-generic-mode' function to define new modes. |
18254 | 84 ;; For example: |
85 ;; | |
86 ;; (define-generic-mode 'foo-generic-mode | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
87 ;; (list ?%) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
88 ;; (list "keyword") |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
89 ;; nil |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
90 ;; (list "\\.FOO\\'") |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
91 ;; (list 'foo-setup-function)) |
18254 | 92 ;; |
21182 | 93 ;; defines a new generic-mode `foo-generic-mode', which has '%' as a |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
94 ;; comment character, and "keyword" as a keyword. When files which |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
95 ;; end in '.FOO' are loaded, Emacs will go into foo-generic-mode and |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
96 ;; call foo-setup-function. You can also use the function |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
97 ;; `foo-generic-mode' (which is interactive) to put a buffer into |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
98 ;; foo-generic-mode. |
18254 | 99 ;; |
100 ;; AUTOMATICALLY ENTERING GENERIC MODE: | |
101 ;; | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
102 ;; Generic-mode provides a hook which automatically puts a file into |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
103 ;; default-generic-mode if the first few lines of a file in |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
104 ;; fundamental mode start with a hash comment character. To disable |
21182 | 105 ;; this functionality, set the variable `generic-use-find-file-hook' |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
106 ;; to nil BEFORE loading generic-mode. See the variables |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
107 ;; `generic-lines-to-scan' and `generic-find-file-regexp' for |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
108 ;; customization options. |
32120 | 109 ;; |
18254 | 110 ;; GOTCHAS: |
111 ;; | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
112 ;; Be careful that your font-lock definitions are correct. Getting |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
113 ;; them wrong can cause Emacs to continually attempt to fontify! This |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
114 ;; problem is not specific to generic-mode. |
32120 | 115 ;; |
18254 | 116 |
21057 | 117 ;; Credit for suggestions, brainstorming, help with debugging: |
18254 | 118 ;; ACorreir@pervasive-sw.com (Alfred Correira) |
32120 | 119 ;; Extensive cleanup by: |
120 ;; Stefan Monnier (monnier+gnu/emacs@flint.cs.yale.edu) | |
121 ;; | |
122 ;;; Code: | |
18254 | 123 |
124 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
125 ;; Internal Variables |
18254 | 126 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; |
127 | |
60870
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
128 (defvar generic-font-lock-keywords nil |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
129 "Keywords for `font-lock-defaults' in a generic mode.") |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
130 (make-variable-buffer-local 'generic-font-lock-keywords) |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
131 (defvaralias 'generic-font-lock-defaults 'generic-font-lock-keywords) |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
132 (make-obsolete-variable 'generic-font-lock-defaults 'generic-font-lock-keywords "22.1") |
18254 | 133 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
134 ;;;###autoload |
32120 | 135 (defvar generic-mode-list nil |
136 "A list of mode names for `generic-mode'. | |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
137 Do not add entries to this list directly; use `define-generic-mode' |
18254 | 138 instead (which see).") |
139 | |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
140 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
141 ;; Customization Variables |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
142 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
143 |
21879
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
144 (defgroup generic nil |
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
145 "Define simple major modes with comment and font-lock support." |
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
146 :prefix "generic-" |
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
147 :group 'extensions) |
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
148 |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
149 (defcustom generic-use-find-file-hook t |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
150 "*If non-nil, add a hook to enter `default-generic-mode' automatically. |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
151 This is done if the first few lines of a file in fundamental mode |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
152 start with a hash comment character." |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
153 :group 'generic |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
154 :type 'boolean) |
18254 | 155 |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
156 (defcustom generic-lines-to-scan 3 |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
157 "*Number of lines that `generic-mode-find-file-hook' looks at. |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
158 Relevant when deciding whether to enter Default-Generic mode automatically. |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
159 This variable should be set to a small positive number." |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
160 :group 'generic |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
161 :type 'integer) |
18254 | 162 |
32120 | 163 (defcustom generic-find-file-regexp "^#" |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
164 "*Regular expression used by `generic-mode-find-file-hook'. |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
165 Files in fundamental mode whose first few lines contain a match |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
166 for this regexp, should be put into Default-Generic mode instead. |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
167 The number of lines tested for the matches is specified by the |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
168 value of the variable `generic-lines-to-scan', which see." |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
169 :group 'generic |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
170 :type 'regexp) |
18254 | 171 |
36124
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
172 (defcustom generic-ignore-files-regexp "[Tt][Aa][Gg][Ss]\\'" |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
173 "*Regular expression used by `generic-mode-find-file-hook'. |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
174 Files whose names match this regular expression should not be put |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
175 into Default-Generic mode, even if they have lines which match |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
176 the regexp in `generic-find-file-regexp'. If the value is nil, |
36124
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
177 `generic-mode-find-file-hook' does not check the file names." |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
178 :group 'generic |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
179 :type '(choice (const :tag "Don't check file names" nil) regexp)) |
36124
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
180 |
18254 | 181 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; |
182 ;; Functions | |
183 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | |
184 | |
22347
f53740d7d40d
*** empty log message ***
Dan Nicolaescu <done@ece.arizona.edu>
parents:
21928
diff
changeset
|
185 ;;;###autoload |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
186 (defmacro define-generic-mode (mode comment-list keyword-list |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
187 font-lock-list auto-mode-list |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
188 function-list &optional docstring) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
189 "Create a new generic mode MODE. |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
190 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
191 MODE is the name of the command for the generic mode; it need not |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
192 be quoted. The optional DOCSTRING is the documentation for the |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
193 mode command. If you do not supply it, a default documentation |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
194 string will be used instead. |
18254 | 195 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
196 COMMENT-LIST is a list, whose entries are either a single |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
197 character, a one or two character string or a cons pair. If the |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
198 entry is a character or a string, it is added to the mode's |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
199 syntax table with `comment-start' syntax. If the entry is a cons |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
200 pair, the elements of the pair are considered to be |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
201 `comment-start' and `comment-end' respectively. (The latter |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
202 should be nil if you want comments to end at end of line.) Note |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
203 that Emacs has limitations regarding comment characters. |
18254 | 204 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
205 KEYWORD-LIST is a list of keywords to highlight with |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
206 `font-lock-keyword-face'. Each keyword should be a string. |
18254 | 207 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
208 FONT-LOCK-LIST is a list of additional expressions to highlight. |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
209 Each entry in the list should have the same form as an entry in |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
210 `font-lock-keywords'. |
18254 | 211 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
212 AUTO-MODE-LIST is a list of regular expressions to add to |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
213 `auto-mode-alist'. These regexps are added to `auto-mode-alist' |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
214 as soon as `define-generic-mode' is called. |
18254 | 215 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
216 FUNCTION-LIST is a list of functions to call to do some |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
217 additional setup. |
18254 | 218 |
21014 | 219 See the file generic-x.el for some examples of `define-generic-mode'." |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
220 (declare (debug (sexp def-form def-form def-form form def-form &optional stringp))) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
221 |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
222 ;; Backward compatibility. |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
223 (when (eq (car-safe mode) 'quote) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
224 (setq mode (eval mode))) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
225 (let* ((mode-name (symbol-name mode)) |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
226 (pretty-name (capitalize (replace-regexp-in-string |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
227 "-mode\\'" "" mode-name))) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
228 (mode-hook (intern (concat mode-name "-hook")))) |
18254 | 229 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
230 `(progn |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
231 ;; Add a new entry. |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
232 (add-to-list 'generic-mode-list ,mode-name) |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
233 |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
234 ;; Add it to auto-mode-alist |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
235 (dolist (re ,auto-mode-list) |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
236 (add-to-list 'auto-mode-alist (cons re ',mode))) |
32120 | 237 |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
238 (defcustom ,mode-hook nil |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
239 ,(concat "Hook run when entering " pretty-name " mode.") |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
240 :type 'hook |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
241 :group (or (custom-current-group) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
242 ',(intern (replace-regexp-in-string |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
243 "-mode\\'" "" mode-name)))) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
244 |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
245 (defun ,mode () |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
246 ,(or docstring |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
247 (concat pretty-name " mode.\n" |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
248 "This a generic mode defined with `define-generic-mode'.")) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
249 (interactive) |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
250 (generic-mode-internal ',mode ,comment-list ,keyword-list |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
251 ,font-lock-list ,function-list))))) |
18254 | 252 |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
253 ;;;###autoload |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
254 (defun generic-mode-internal (mode comment-list keyword-list |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
255 font-lock-list function-list) |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
256 "Go into the generic mode MODE." |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
257 (let* ((mode-name (symbol-name mode)) |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
258 (pretty-name (capitalize (replace-regexp-in-string |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
259 "-mode\\'" "" mode-name))) |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
260 (mode-hook (intern (concat mode-name "-hook")))) |
18254 | 261 |
262 (kill-all-local-variables) | |
263 | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
264 (setq major-mode mode |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
265 mode-name pretty-name) |
18254 | 266 |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
267 (generic-mode-set-comments comment-list) |
18254 | 268 |
60870
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
269 ;; Font-lock functionality. |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
270 ;; Font-lock-defaults is always set even if there are no keywords |
18254 | 271 ;; or font-lock expressions, so comments can be highlighted. |
60870
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
272 (setq generic-font-lock-keywords |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
273 (append |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
274 (when keyword-list |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
275 (list (generic-make-keywords-list keyword-list |
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
276 font-lock-keyword-face))) |
60870
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
277 font-lock-list)) |
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
278 (setq font-lock-defaults '(generic-font-lock-keywords nil)) |
18254 | 279 |
280 ;; Call a list of functions | |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
281 (mapcar 'funcall function-list) |
23392
d86ad410d285
(generic-mode-with-type): Added hooks for generic-modes.
Karl Heuer <kwzh@gnu.org>
parents:
22402
diff
changeset
|
282 |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
283 (run-mode-hooks mode-hook))) |
18254 | 284 |
285 ;;;###autoload | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
286 (defun generic-mode (mode) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
287 "Enter generic mode MODE. |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
288 |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
289 Generic modes provide basic comment and font-lock functionality |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
290 for \"generic\" files. (Files which are too small to warrant their |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
291 own mode, but have comment characters, keywords, and the like.) |
18254 | 292 |
293 To define a generic-mode, use the function `define-generic-mode'. | |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
294 Some generic modes are defined in `generic-x.el'." |
18254 | 295 (interactive |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
296 (list (completing-read "Generic mode: " generic-mode-list nil t))) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
297 (funcall (intern mode))) |
18254 | 298 |
299 ;;; Comment Functionality | |
300 (defun generic-mode-set-comments (comment-list) | |
301 "Set up comment functionality for generic mode." | |
32120 | 302 (let ((st (make-syntax-table)) |
303 (chars nil) | |
304 (comstyles)) | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
305 (make-local-variable 'comment-start) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
306 (make-local-variable 'comment-start-skip) |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
307 (make-local-variable 'comment-end) |
18254 | 308 |
32120 | 309 ;; Go through all the comments |
310 (dolist (start comment-list) | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
311 (let (end (comstyle "")) |
32120 | 312 ;; Normalize |
313 (when (consp start) | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
314 (setq end (cdr start)) |
32120 | 315 (setq start (car start))) |
316 (when (char-valid-p start) (setq start (char-to-string start))) | |
58473
9aacf8e5ae58
(generic-mode-set-comments): Accept an empty comment-end.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
57113
diff
changeset
|
317 (cond |
9aacf8e5ae58
(generic-mode-set-comments): Accept an empty comment-end.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
57113
diff
changeset
|
318 ((char-valid-p end) (setq end (char-to-string end))) |
9aacf8e5ae58
(generic-mode-set-comments): Accept an empty comment-end.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
57113
diff
changeset
|
319 ((zerop (length end)) (setq end "\n"))) |
18254 | 320 |
32120 | 321 ;; Setup the vars for `comment-region' |
322 (if comment-start | |
323 ;; We have already setup a comment-style, so use style b | |
324 (progn | |
325 (setq comstyle "b") | |
326 (setq comment-start-skip | |
327 (concat comment-start-skip "\\|" (regexp-quote start) "+\\s-*"))) | |
328 ;; First comment-style | |
329 (setq comment-start start) | |
37058
a2e5f00c1254
(generic-mode-set-comments): Use "" rather than nil for comment-end.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
36124
diff
changeset
|
330 (setq comment-end (if (string-equal end "\n") "" end)) |
32120 | 331 (setq comment-start-skip (concat (regexp-quote start) "+\\s-*"))) |
18254 | 332 |
32120 | 333 ;; Reuse comstyles if necessary |
334 (setq comstyle | |
335 (or (cdr (assoc start comstyles)) | |
336 (cdr (assoc end comstyles)) | |
337 comstyle)) | |
338 (push (cons start comstyle) comstyles) | |
339 (push (cons end comstyle) comstyles) | |
18254 | 340 |
32120 | 341 ;; Setup the syntax table |
342 (if (= (length start) 1) | |
343 (modify-syntax-entry (string-to-char start) | |
344 (concat "< " comstyle) st) | |
345 (let ((c0 (elt start 0)) (c1 (elt start 1))) | |
346 ;; Store the relevant info but don't update yet | |
347 (push (cons c0 (concat (cdr (assoc c0 chars)) "1")) chars) | |
348 (push (cons c1 (concat (cdr (assoc c1 chars)) | |
349 (concat "2" comstyle))) chars))) | |
350 (if (= (length end) 1) | |
351 (modify-syntax-entry (string-to-char end) | |
352 (concat ">" comstyle) st) | |
353 (let ((c0 (elt end 0)) (c1 (elt end 1))) | |
354 ;; Store the relevant info but don't update yet | |
355 (push (cons c0 (concat (cdr (assoc c0 chars)) | |
356 (concat "3" comstyle))) chars) | |
357 (push (cons c1 (concat (cdr (assoc c1 chars)) "4")) chars))))) | |
18254 | 358 |
32120 | 359 ;; Process the chars that were part of a 2-char comment marker |
360 (dolist (cs (nreverse chars)) | |
361 (modify-syntax-entry (car cs) | |
362 (concat (char-to-string (char-syntax (car cs))) | |
363 " " (cdr cs)) | |
364 st)) | |
365 (set-syntax-table st))) | |
18254 | 366 |
367 (defun generic-bracket-support () | |
60870
92071f8a7671
(generic-font-lock-defaults): Make it obsolete.
Lute Kamstra <lute@gnu.org>
parents:
60849
diff
changeset
|
368 "Imenu support for [KEYWORD] constructs found in INF, INI and Samba files." |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
369 (setq imenu-generic-expression |
20459 | 370 '((nil "^\\[\\(.*\\)\\]" 1)) |
371 imenu-case-fold-search t)) | |
18254 | 372 |
373 ;; This generic mode is always defined | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
374 (define-generic-mode default-generic-mode (list ?#) nil nil nil nil) |
18254 | 375 |
376 ;; A more general solution would allow us to enter generic-mode for | |
377 ;; *any* comment character, but would require us to synthesize a new | |
378 ;; generic-mode on the fly. I think this gives us most of what we | |
379 ;; want. | |
380 (defun generic-mode-find-file-hook () | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
381 "Hook function to enter Default-Generic mode automatically. |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
382 |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
383 Done if the first few lines of a file in Fundamental mode start |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
384 with a match for the regexp in `generic-find-file-regexp', unless |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
385 the file's name matches the regexp which is the value of the |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
386 variable `generic-ignore-files-regexp'. |
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
387 |
36124
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
388 This hook will be installed if the variable |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
389 `generic-use-find-file-hook' is non-nil. The variable |
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
390 `generic-lines-to-scan' determines the number of lines to look at." |
36124
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
391 (when (and (eq major-mode 'fundamental-mode) |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
392 (or (null generic-ignore-files-regexp) |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
393 (not (string-match |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
394 generic-ignore-files-regexp |
5eb6597319ec
(generic-find-file-regexp): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents:
34814
diff
changeset
|
395 (file-name-sans-versions buffer-file-name))))) |
32120 | 396 (save-excursion |
397 (goto-char (point-min)) | |
398 (when (re-search-forward generic-find-file-regexp | |
399 (save-excursion | |
400 (forward-line generic-lines-to-scan) | |
401 (point)) t) | |
18254 | 402 (goto-char (point-min)) |
32120 | 403 (default-generic-mode))))) |
18254 | 404 |
405 (defun generic-mode-ini-file-find-file-hook () | |
60773
1771db839aa6
Fix commentary section. Don't require cl for compilation.
Lute Kamstra <lute@gnu.org>
parents:
60595
diff
changeset
|
406 "Hook function to enter Default-Generic mode automatically for INI files. |
61169
e2b959792f0f
(define-generic-mode): Add debug declaration. Add defcustom for the
Lute Kamstra <lute@gnu.org>
parents:
60902
diff
changeset
|
407 Done if the first few lines of a file in Fundamental mode look like an |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
408 INI file. This hook is NOT installed by default." |
21077
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
409 (and (eq major-mode 'fundamental-mode) |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
410 (save-excursion |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
411 (goto-char (point-min)) |
4b5c8a2ce0b2
(generic-mode-ini-file-find-file-hook): Use and-s instead of if-s.
Richard M. Stallman <rms@gnu.org>
parents:
21057
diff
changeset
|
412 (and (looking-at "^\\s-*\\[.*\\]") |
32120 | 413 (ini-generic-mode))))) |
18254 | 414 |
415 (and generic-use-find-file-hook | |
60902
7160fe3a7ef1
find-file-hooks -> find-file-hook.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
60870
diff
changeset
|
416 (add-hook 'find-file-hook 'generic-mode-find-file-hook)) |
18254 | 417 |
60849
cb4033032773
(generic-make-keywords-list): Add autoload cookie.
Lute Kamstra <lute@gnu.org>
parents:
60773
diff
changeset
|
418 ;;;###autoload |
18254 | 419 (defun generic-make-keywords-list (keywords-list face &optional prefix suffix) |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
420 "Return a regular expression matching the specified KEYWORDS-LIST. |
18254 | 421 The regexp is highlighted with FACE." |
32120 | 422 (unless (listp keywords-list) |
423 (error "Keywords argument must be a list of strings")) | |
57113
5bd3a1e1dfe5
Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-549
Miles Bader <miles@gnu.org>
parents:
55555
diff
changeset
|
424 (list (concat prefix "\\_<" |
21879
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
425 ;; Use an optimized regexp. |
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
426 (regexp-opt keywords-list t) |
57113
5bd3a1e1dfe5
Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-549
Miles Bader <miles@gnu.org>
parents:
55555
diff
changeset
|
427 "\\_>" suffix) |
21879
14316c9ecdac
(generic): Added defgroup declaration.
Richard M. Stallman <rms@gnu.org>
parents:
21182
diff
changeset
|
428 1 |
21928
42fa0da05721
(generic-make-keywords-list): Delete spurious paren.
Richard M. Stallman <rms@gnu.org>
parents:
21879
diff
changeset
|
429 face)) |
18254 | 430 |
21013
adb28ace7f33
Provide generic, not generic-mode.
Richard M. Stallman <rms@gnu.org>
parents:
20459
diff
changeset
|
431 (provide 'generic) |
18254 | 432 |
58473
9aacf8e5ae58
(generic-mode-set-comments): Accept an empty comment-end.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
57113
diff
changeset
|
433 ;; arch-tag: 239c1fc4-1303-48d9-9ac0-657d655669ea |
24022
218b7edb9baf
Re-write `(make-variable-buffer-local (defvar ...'
Dave Love <fx@gnu.org>
parents:
23392
diff
changeset
|
434 ;;; generic.el ends here |