Mercurial > emacs
annotate lisp/font-core.el @ 109692:58882317bf04
* PROBLEMS: Mention problem with Cygwin 1.5.19.
author | Ken Brown <kbrown@cornell.edu> |
---|---|
date | Tue, 27 Jul 2010 15:50:01 -0400 |
parents | 646e914bd0fd |
children | 280c8ae2476d 376148b31b5e |
rev | line source |
---|---|
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
1 ;;; font-core.el --- Core interface to font-lock |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
2 |
59871
83af8894e534
(font-lock-default-function): Handle the rare case where
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
3 ;; Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, |
106815 | 4 ;; 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 |
105609
bdcd73244f19
Convert comments about autoloads into autoload comments.
Glenn Morris <rgm@gnu.org>
parents:
104990
diff
changeset
|
5 ;; Free Software Foundation, Inc. |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
6 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
7 ;; Maintainer: FSF |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
8 ;; Keywords: languages, faces |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
9 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
10 ;; This file is part of GNU Emacs. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
11 |
94678
ee5932bf781d
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94156
diff
changeset
|
12 ;; GNU Emacs is free software: you can redistribute it and/or modify |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
13 ;; it under the terms of the GNU General Public License as published by |
94678
ee5932bf781d
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94156
diff
changeset
|
14 ;; the Free Software Foundation, either version 3 of the License, or |
ee5932bf781d
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94156
diff
changeset
|
15 ;; (at your option) any later version. |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
16 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
17 ;; GNU Emacs is distributed in the hope that it will be useful, |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
20 ;; GNU General Public License for more details. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
21 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
22 ;; You should have received a copy of the GNU General Public License |
94678
ee5932bf781d
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
94156
diff
changeset
|
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
24 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
25 ;;; Code: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
26 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
27 ;; This variable is used by mode packages that support Font Lock mode by |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
28 ;; defining their own keywords to use for `font-lock-keywords'. (The mode |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
29 ;; command should make it buffer-local and set it to provide the set up.) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
30 (defvar font-lock-defaults nil |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
31 "Defaults for Font Lock mode specified by the major mode. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
32 Defaults should be of the form: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
33 |
61825
eb334300d039
(font-lock-defaults): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents:
61270
diff
changeset
|
34 (KEYWORDS [KEYWORDS-ONLY [CASE-FOLD [SYNTAX-ALIST [SYNTAX-BEGIN ...]]]]) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
35 |
100387
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
36 KEYWORDS may be a symbol (a variable or function whose value is the keywords |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
37 to use for fontification) or a list of symbols (specifying different levels |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
38 of fontification). |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
39 |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
40 If KEYWORDS-ONLY is non-nil, syntactic fontification (strings and |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
41 comments) is not performed. |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
42 |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
43 If CASE-FOLD is non-nil, the case of the keywords is ignored when fontifying. |
100387
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
44 |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
45 If SYNTAX-ALIST is non-nil, it should be a list of cons pairs of the form |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
46 \(CHAR-OR-STRING . STRING) used to set the local Font Lock syntax table, for |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
47 keyword and syntactic fontification (see `modify-syntax-entry'). |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
48 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
49 If SYNTAX-BEGIN is non-nil, it should be a function with no args used to move |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
50 backwards outside any enclosing syntactic block, for syntactic fontification. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
51 Typical values are `beginning-of-line' (i.e., the start of the line is known to |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
52 be outside a syntactic block), or `beginning-of-defun' for programming modes or |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
53 `backward-paragraph' for textual modes (i.e., the mode-dependent function is |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
54 known to move outside a syntactic block). If nil, the beginning of the buffer |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
55 is used as a position outside of a syntactic block, in the worst case. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
56 |
100387
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
57 \(See also Info node `(elisp)Font Lock Basics'.) |
35f1ab86f203
(font-lock-defaults): Doc fix: mention levels; refer to elisp manual.
Glenn Morris <rgm@gnu.org>
parents:
100171
diff
changeset
|
58 |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
59 These item elements are used by Font Lock mode to set the variables |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
60 `font-lock-keywords', `font-lock-keywords-only', |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
61 `font-lock-keywords-case-fold-search', `font-lock-syntax-table' and |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
62 `font-lock-beginning-of-syntax-function', respectively. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
63 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
64 Further item elements are alists of the form (VARIABLE . VALUE) and are in no |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
65 particular order. Each VARIABLE is made buffer-local before set to VALUE. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
66 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
67 Currently, appropriate variables include `font-lock-mark-block-function'. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
68 If this is non-nil, it should be a function with no args used to mark any |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
69 enclosing block of text, for fontification via \\[font-lock-fontify-block]. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
70 Typical values are `mark-defun' for programming modes or `mark-paragraph' for |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
71 textual modes (i.e., the mode-dependent function is known to put point and mark |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
72 around a text block relevant to that mode). |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
73 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
74 Other variables include that for syntactic keyword fontification, |
61825
eb334300d039
(font-lock-defaults): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents:
61270
diff
changeset
|
75 `font-lock-syntactic-keywords' and those for buffer-specialized fontification |
eb334300d039
(font-lock-defaults): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents:
61270
diff
changeset
|
76 functions, `font-lock-fontify-buffer-function', |
eb334300d039
(font-lock-defaults): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents:
61270
diff
changeset
|
77 `font-lock-unfontify-buffer-function', `font-lock-fontify-region-function', |
eb334300d039
(font-lock-defaults): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents:
61270
diff
changeset
|
78 `font-lock-unfontify-region-function', and `font-lock-inhibit-thing-lock'.") |
105609
bdcd73244f19
Convert comments about autoloads into autoload comments.
Glenn Morris <rgm@gnu.org>
parents:
104990
diff
changeset
|
79 ;;;###autoload |
104612
c220a29e75fd
Define risky-local-variable property here rather than in files.el.
Glenn Morris <rgm@gnu.org>
parents:
103490
diff
changeset
|
80 (put 'font-lock-defaults 'risky-local-variable t) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
81 (make-variable-buffer-local 'font-lock-defaults) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
82 |
51719
1963828b8333
(font-lock-defaults-alist): Remove obsolete entries.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
50595
diff
changeset
|
83 (defvar font-lock-defaults-alist nil |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
84 "Alist of fall-back Font Lock defaults for major modes. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
85 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
86 Each item should be a list of the form: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
87 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
88 (MAJOR-MODE . FONT-LOCK-DEFAULTS) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
89 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
90 where MAJOR-MODE is a symbol and FONT-LOCK-DEFAULTS is a list of default |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
91 settings. See the variable `font-lock-defaults', which takes precedence.") |
94156
eea76bfceb7c
(font-lock-defaults-alist): Add WHEN to obsolescence declaration.
Juanma Barranquero <lekktu@gmail.com>
parents:
87649
diff
changeset
|
92 (make-obsolete-variable 'font-lock-defaults-alist 'font-lock-defaults "21.1") |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
93 |
45476
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
94 (defvar font-lock-function 'font-lock-default-function |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
95 "A function which is called when `font-lock-mode' is toggled. |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
96 It will be passed one argument, which is the current value of |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
97 `font-lock-mode'.") |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
98 |
63024
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
99 ;; The mode for which font-lock was initialized, or nil if none. |
109008
646e914bd0fd
* lisp/font-lock.el (font-lock-major-mode): Rename from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
106815
diff
changeset
|
100 (defvar font-lock-major-mode) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
101 (define-minor-mode font-lock-mode |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
102 "Toggle Font Lock mode. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
103 With arg, turn Font Lock mode off if and only if arg is a non-positive |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
104 number; if arg is nil, toggle Font Lock mode; anything else turns Font |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
105 Lock on. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
106 \(Font Lock is also known as \"syntax highlighting\".) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
107 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
108 When Font Lock mode is enabled, text is fontified as you type it: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
109 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
110 - Comments are displayed in `font-lock-comment-face'; |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
111 - Strings are displayed in `font-lock-string-face'; |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
112 - Certain other expressions are displayed in other faces according to the |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
113 value of the variable `font-lock-keywords'. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
114 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
115 To customize the faces (colors, fonts, etc.) used by Font Lock for |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
116 fontifying different parts of buffer text, use \\[customize-face]. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
117 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
118 You can enable Font Lock mode in any major mode automatically by turning on in |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
119 the major mode's hook. For example, put in your ~/.emacs: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
120 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
121 (add-hook 'c-mode-hook 'turn-on-font-lock) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
122 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
123 Alternatively, you can use Global Font Lock mode to automagically turn on Font |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
124 Lock mode in buffers whose major mode supports it and whose major mode is one |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
125 of `font-lock-global-modes'. For example, put in your ~/.emacs: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
126 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
127 (global-font-lock-mode t) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
128 |
66213
32398ccbc506
(font-lock-mode): Doc fix.
Romain Francoise <romain@orebokech.com>
parents:
64762
diff
changeset
|
129 Where major modes support different levels of fontification, you can use |
32398ccbc506
(font-lock-mode): Doc fix.
Romain Francoise <romain@orebokech.com>
parents:
64762
diff
changeset
|
130 the variable `font-lock-maximum-decoration' to specify which level you |
32398ccbc506
(font-lock-mode): Doc fix.
Romain Francoise <romain@orebokech.com>
parents:
64762
diff
changeset
|
131 generally prefer. When you turn Font Lock mode on/off the buffer is |
32398ccbc506
(font-lock-mode): Doc fix.
Romain Francoise <romain@orebokech.com>
parents:
64762
diff
changeset
|
132 fontified/defontified, though fontification occurs only if the buffer is |
32398ccbc506
(font-lock-mode): Doc fix.
Romain Francoise <romain@orebokech.com>
parents:
64762
diff
changeset
|
133 less than `font-lock-maximum-size'. |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
134 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
135 To add your own highlighting for some major mode, and modify the highlighting |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
136 selected automatically via the variable `font-lock-maximum-decoration', you can |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
137 use `font-lock-add-keywords'. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
138 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
139 To fontify a buffer, without turning on Font Lock mode and regardless of buffer |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
140 size, you can use \\[font-lock-fontify-buffer]. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
141 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
142 To fontify a block (the function or paragraph containing point, or a number of |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
143 lines around point), perhaps because modification on the current line caused |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
144 syntactic change on other lines, you can use \\[font-lock-fontify-block]. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
145 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
146 See the variable `font-lock-defaults-alist' for the Font Lock mode default |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
147 settings. You can set your own default settings for some mode, by setting a |
45476
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
148 buffer local value for `font-lock-defaults', via its mode hook. |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
149 |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
150 The above is the default behavior of `font-lock-mode'; you may specify |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
151 your own function which is called when `font-lock-mode' is toggled via |
e1671f561407
(font-lock-function): New variable.
Colin Walters <walters@gnu.org>
parents:
45440
diff
changeset
|
152 `font-lock-function'. " |
67306
0ec2c0df96f6
(font-lock-mode): Replace `:group font-lock' with `nil nil nil'.
Juri Linkov <juri@jurta.org>
parents:
67304
diff
changeset
|
153 nil nil nil |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
154 ;; Don't turn on Font Lock mode if we don't have a display (we're running a |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
155 ;; batch job) or if the buffer is invisible (the name starts with a space). |
74228
6081cf49eb34
(font-lock-mode): "?\ " -> "?\s".
Juanma Barranquero <lekktu@gmail.com>
parents:
72233
diff
changeset
|
156 (when (or noninteractive (eq (aref (buffer-name) 0) ?\s)) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
157 (setq font-lock-mode nil)) |
46906
421ce085a3cc
(font-lock-mode): Add font-lock-unfontify-buffer
Richard M. Stallman <rms@gnu.org>
parents:
46899
diff
changeset
|
158 (funcall font-lock-function font-lock-mode) |
421ce085a3cc
(font-lock-mode): Add font-lock-unfontify-buffer
Richard M. Stallman <rms@gnu.org>
parents:
46899
diff
changeset
|
159 ;; Arrange to unfontify this buffer if we change major mode later. |
421ce085a3cc
(font-lock-mode): Add font-lock-unfontify-buffer
Richard M. Stallman <rms@gnu.org>
parents:
46899
diff
changeset
|
160 (if font-lock-mode |
46975
93d9d4da05cd
(font-lock-change-mode): New function.
Richard M. Stallman <rms@gnu.org>
parents:
46932
diff
changeset
|
161 (add-hook 'change-major-mode-hook 'font-lock-change-mode nil t) |
109008
646e914bd0fd
* lisp/font-lock.el (font-lock-major-mode): Rename from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
106815
diff
changeset
|
162 (remove-hook 'change-major-mode-hook 'font-lock-change-mode t))) |
46975
93d9d4da05cd
(font-lock-change-mode): New function.
Richard M. Stallman <rms@gnu.org>
parents:
46932
diff
changeset
|
163 |
93d9d4da05cd
(font-lock-change-mode): New function.
Richard M. Stallman <rms@gnu.org>
parents:
46932
diff
changeset
|
164 ;; Get rid of fontification for the old major mode. |
93d9d4da05cd
(font-lock-change-mode): New function.
Richard M. Stallman <rms@gnu.org>
parents:
46932
diff
changeset
|
165 ;; We do this when changing major modes. |
93d9d4da05cd
(font-lock-change-mode): New function.
Richard M. Stallman <rms@gnu.org>
parents:
46932
diff
changeset
|
166 (defun font-lock-change-mode () |
47359
9da6d2e1b2ee
(font-lock-change-mode): Just turn off font-lock-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
47176
diff
changeset
|
167 (font-lock-mode -1)) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
168 |
47374
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
169 (defun font-lock-defontify () |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
170 "Clear out all `font-lock-face' properties in current buffer. |
50595
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
171 A major mode that uses `font-lock-face' properties might want to put |
47374
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
172 this function onto `change-major-mode-hook'." |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
173 (let ((modp (buffer-modified-p)) |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
174 (inhibit-read-only t)) |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
175 (save-restriction |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
176 (widen) |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
177 (remove-list-of-text-properties (point-min) (point-max) |
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
178 '(font-lock-face))) |
49692
1713a3efdd23
(font-lock-defontify): Use restore-buffer-modified-p.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49588
diff
changeset
|
179 (restore-buffer-modified-p modp))) |
47374
78178028d987
(font-lock-defontify): New function.
Richard M. Stallman <rms@gnu.org>
parents:
47359
diff
changeset
|
180 |
63024
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
181 (defvar font-lock-set-defaults) |
47359
9da6d2e1b2ee
(font-lock-change-mode): Just turn off font-lock-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
47176
diff
changeset
|
182 (defun font-lock-default-function (mode) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
183 ;; Turn on Font Lock mode. |
47359
9da6d2e1b2ee
(font-lock-change-mode): Just turn off font-lock-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
47176
diff
changeset
|
184 (when mode |
45686
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
185 (set (make-local-variable 'char-property-alias-alist) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
186 (copy-tree char-property-alias-alist)) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
187 ;; Add `font-lock-face' as an alias for the `face' property. |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
188 (let ((elt (assq 'face char-property-alias-alist))) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
189 (if elt |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
190 (unless (memq 'font-lock-face (cdr elt)) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
191 (setcdr elt (nconc (cdr elt) (list 'font-lock-face)))) |
50595
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
192 (push (list 'face 'font-lock-face) char-property-alias-alist)))) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
193 ;; Turn off Font Lock mode. |
47359
9da6d2e1b2ee
(font-lock-change-mode): Just turn off font-lock-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
47176
diff
changeset
|
194 (unless mode |
45686
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
195 ;; Remove `font-lock-face' as an alias for the `face' property. |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
196 (set (make-local-variable 'char-property-alias-alist) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
197 (copy-tree char-property-alias-alist)) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
198 (let ((elt (assq 'face char-property-alias-alist))) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
199 (when elt |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
200 (setcdr elt (remq 'font-lock-face (cdr elt))) |
25d73d0e2b98
(font-lock-category-alist): Delete.
Colin Walters <walters@gnu.org>
parents:
45481
diff
changeset
|
201 (when (null (cdr elt)) |
50595
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
202 (setq char-property-alias-alist |
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
203 (delq elt char-property-alias-alist)))))) |
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
204 |
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
205 ;; Only do hard work if the mode has specified stuff in |
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
206 ;; `font-lock-defaults'. |
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
207 (when (or font-lock-defaults |
63024
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
208 (if (boundp 'font-lock-keywords) font-lock-keywords) |
60005
6e156606b5c5
(font-lock-default-function): Use with-no-warnings.
Richard M. Stallman <rms@gnu.org>
parents:
59871
diff
changeset
|
209 (with-no-warnings |
63024
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
210 (cdr (assq major-mode font-lock-defaults-alist))) |
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
211 (and mode |
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
212 (boundp 'font-lock-set-defaults) |
ed96547a88b1
(font-lock-mode-major-mode): Compiler defvar.
Luc Teirlinck <teirllm@auburn.edu>
parents:
62636
diff
changeset
|
213 font-lock-set-defaults |
109008
646e914bd0fd
* lisp/font-lock.el (font-lock-major-mode): Rename from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
106815
diff
changeset
|
214 font-lock-major-mode |
646e914bd0fd
* lisp/font-lock.el (font-lock-major-mode): Rename from
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
106815
diff
changeset
|
215 (not (eq font-lock-major-mode major-mode)))) |
50595
7633f45262ae
(font-lock-maximum-size, font-lock-verbose): Remove.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
49692
diff
changeset
|
216 (font-lock-mode-internal mode))) |
49588
37645a051842
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47374
diff
changeset
|
217 |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
218 (defun turn-on-font-lock () |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
219 "Turn on Font Lock mode (only if the terminal can display it)." |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
220 (unless font-lock-mode |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
221 (font-lock-mode))) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
222 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
223 ;;; Global Font Lock mode. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
224 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
225 ;; A few people have hassled in the past for a way to make it easier to turn on |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
226 ;; Font Lock mode, without the user needing to know for which modes s/he has to |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
227 ;; turn it on, perhaps the same way hilit19.el/hl319.el does. I've always |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
228 ;; balked at that way, as I see it as just re-moulding the same problem in |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
229 ;; another form. That is; some person would still have to keep track of which |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
230 ;; modes (which may not even be distributed with Emacs) support Font Lock mode. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
231 ;; The list would always be out of date. And that person might have to be me. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
232 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
233 ;; Implementation. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
234 ;; |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
235 ;; In a previous discussion the following hack came to mind. It is a gross |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
236 ;; hack, but it generally works. We use the convention that major modes start |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
237 ;; by calling the function `kill-all-local-variables', which in turn runs |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
238 ;; functions on the hook variable `change-major-mode-hook'. We attach our |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
239 ;; function `font-lock-change-major-mode' to that hook. Of course, when this |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
240 ;; hook is run, the major mode is in the process of being changed and we do not |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
241 ;; know what the final major mode will be. So, `font-lock-change-major-mode' |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
242 ;; only (a) notes the name of the current buffer, and (b) adds our function |
85449
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
243 ;; `turn-on-font-lock-if-desired' to the hook variables |
62636 | 244 ;; `after-change-major-mode-hook' and `post-command-hook' (for modes |
245 ;; that do not yet run `after-change-major-mode-hook'). By the time | |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
246 ;; the functions on the first of these hooks to be run are run, the new major |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
247 ;; mode is assumed to be in place. This way we get a Font Lock function run |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
248 ;; when a major mode is turned on, without knowing major modes or their hooks. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
249 ;; |
62636 | 250 ;; Naturally this requires that major modes run `kill-all-local-variables' |
251 ;; and `after-change-major-mode-hook', as they are supposed to. For modes | |
252 ;; that do not run `after-change-major-mode-hook' yet, `post-command-hook' | |
253 ;; takes care of things if the mode is set directly or indirectly by | |
254 ;; an interactive command; however, problems can occur if the mode is | |
255 ;; set by a timer or process: in that case, proper handling of Font Lock mode | |
256 ;; may be delayed until the next interactive command. | |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
257 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
258 ;; User interface. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
259 ;; |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
260 ;; Although Global Font Lock mode is a pseudo-mode, I think that the user |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
261 ;; interface should conform to the usual Emacs convention for modes, i.e., a |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
262 ;; command to toggle the feature (`global-font-lock-mode') with a variable for |
96376
c3309dba6542
American English spelling fix.
Glenn Morris <rgm@gnu.org>
parents:
94678
diff
changeset
|
263 ;; finer control of the mode's behavior (`font-lock-global-modes'). |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
264 ;; |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
265 ;; The feature should not be enabled by loading font-lock.el, since other |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
266 ;; mechanisms for turning on Font Lock mode, such as M-x font-lock-mode RET or |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
267 ;; (add-hook 'c-mode-hook 'turn-on-font-lock), would cause Font Lock mode to be |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
268 ;; turned on everywhere. That would not be intuitive or informative because |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
269 ;; loading a file tells you nothing about the feature or how to control it. It |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
270 ;; would also be contrary to the Principle of Least Surprise. sm. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
271 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
272 (defcustom font-lock-global-modes t |
100171 | 273 "Modes for which Font Lock mode is automagically turned on. |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
274 Global Font Lock mode is controlled by the command `global-font-lock-mode'. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
275 If nil, means no modes have Font Lock mode automatically turned on. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
276 If t, all modes that support Font Lock mode have it automatically turned on. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
277 If a list, it should be a list of `major-mode' symbol names for which Font Lock |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
278 mode should be automatically turned on. The sense of the list is negated if it |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
279 begins with `not'. For example: |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
280 (c-mode c++-mode) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
281 means that Font Lock mode is turned on for buffers in C and C++ modes only." |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
282 :type '(choice (const :tag "none" nil) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
283 (const :tag "all" t) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
284 (set :menu-tag "mode specific" :tag "modes" |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
285 :value (not) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
286 (const :tag "Except" not) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
287 (repeat :inline t (symbol :tag "mode")))) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
288 :group 'font-lock) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
289 |
85449
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
290 (defun turn-on-font-lock-if-desired () |
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
291 (when (cond ((eq font-lock-global-modes t) |
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
292 t) |
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
293 ((eq (car-safe font-lock-global-modes) 'not) |
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
294 (not (memq major-mode (cdr font-lock-global-modes)))) |
103490
63c3de728507
* font-core.el (turn-on-font-lock-if-desired): Correctly handle
Chong Yidong <cyd@stupidchicken.com>
parents:
100908
diff
changeset
|
295 (t (memq major-mode font-lock-global-modes))) |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
296 (let (inhibit-quit) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
297 (turn-on-font-lock)))) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
298 |
75638
a9000bb51801
(global-font-lock-mode): define-global-minor-mode changed to
Chong Yidong <cyd@stupidchicken.com>
parents:
75347
diff
changeset
|
299 (define-globalized-minor-mode global-font-lock-mode |
85449
1cafaf44a9b9
(turn-on-font-lock-if-desired):
Richard M. Stallman <rms@gnu.org>
parents:
78236
diff
changeset
|
300 font-lock-mode turn-on-font-lock-if-desired |
104990
f0794252d960
* mail/sendmail.el (send-mail-function):
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
104612
diff
changeset
|
301 ;; What was this :extra-args thingy for? --Stef |
f0794252d960
* mail/sendmail.el (send-mail-function):
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
104612
diff
changeset
|
302 ;; :extra-args (dummy) |
f0794252d960
* mail/sendmail.el (send-mail-function):
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
104612
diff
changeset
|
303 :initialize 'custom-initialize-delay |
67289
cf2274237464
(global-font-lock-mode): Use define-global-minor-mode
Juri Linkov <juri@jurta.org>
parents:
66912
diff
changeset
|
304 :init-value (not (or noninteractive emacs-basic-display)) |
cf2274237464
(global-font-lock-mode): Use define-global-minor-mode
Juri Linkov <juri@jurta.org>
parents:
66912
diff
changeset
|
305 :group 'font-lock |
cf2274237464
(global-font-lock-mode): Use define-global-minor-mode
Juri Linkov <juri@jurta.org>
parents:
66912
diff
changeset
|
306 :version "22.1") |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
307 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
308 ;;; End of Global Font Lock mode. |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
309 |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
310 (provide 'font-core) |
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
311 |
59871
83af8894e534
(font-lock-default-function): Handle the rare case where
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
52401
diff
changeset
|
312 ;; arch-tag: f8c286e1-02f7-41d9-b89b-1b67780aed71 |
45440
e879dd65b980
New file, broken out from font-lock.el.
Colin Walters <walters@gnu.org>
parents:
diff
changeset
|
313 ;;; font-core.el ends here |