1 ;;; font-lock.el --- decorating source files with fonts/colors based on syntax
3 ;; Copyright (C) 1992-1995, 1997 Free Software Foundation, Inc.
4 ;; Copyright (C) 1995 Amdahl Corporation.
5 ;; Copyright (C) 1996, 2000 Ben Wing.
7 ;; Author: Jamie Zawinski <jwz@jwz.org>, for the LISPM Preservation Society.
8 ;; Minimally merged with FSF 19.34 by Barry Warsaw <bwarsaw@python.org>
9 ;; Then (partially) synched with FSF 19.30, leading to:
11 ;; Next Author: Simon Marshall <simon@gnu.ai.mit.edu>
12 ;; Latest XEmacs Author: Ben Wing
13 ;; Maintainer: XEmacs Development Team
14 ;; Keywords: languages, faces
16 ;; This file is part of XEmacs.
18 ;; XEmacs is free software; you can redistribute it and/or modify it
19 ;; under the terms of the GNU General Public License as published by
20 ;; the Free Software Foundation; either version 2, or (at your option)
23 ;; XEmacs is distributed in the hope that it will be useful, but
24 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
25 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
26 ;; General Public License for more details.
28 ;; You should have received a copy of the GNU General Public License
29 ;; along with XEmacs; see the file COPYING. If not, write to the
30 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
31 ;; Boston, MA 02111-1307, USA.
33 ;;; Synched up with: FSF 19.30 except for the code to initialize the faces.
37 ;; Font-lock-mode is a minor mode that causes your comments to be
38 ;; displayed in one face, strings in another, reserved words in another,
39 ;; documentation strings in another, and so on.
41 ;; Comments will be displayed in `font-lock-comment-face'.
42 ;; Strings will be displayed in `font-lock-string-face'.
43 ;; Doc strings will be displayed in `font-lock-doc-string-face'.
44 ;; Function and variable names (in their defining forms) will be
45 ;; displayed in `font-lock-function-name-face'.
46 ;; Reserved words will be displayed in `font-lock-keyword-face'.
48 ;; Don't let the name fool you: you can highlight things using different
49 ;; colors or background stipples instead of fonts, though that is not the
50 ;; default. See the variables `font-lock-use-colors' and
51 ;; `font-lock-use-fonts' for broad control over this, or see the
52 ;; documentation on faces and how to change their attributes for
53 ;; fine-grained control.
55 ;; To make the text you type be fontified, use M-x font-lock-mode. When
56 ;; this minor mode is on, the fonts of the current line will be updated
57 ;; with every insertion or deletion.
59 ;; By default, font-lock will automatically put newly loaded files
60 ;; into font-lock-mode if it knows about the file's mode. See the
61 ;; variables `font-lock-auto-fontify', `font-lock-mode-enable-list',
62 ;; and `font-lock-mode-disable-list' for control over this.
64 ;; The `font-lock-keywords' variable defines other patterns to highlight.
65 ;; The default font-lock-mode-hook sets it to the value of the variables
66 ;; lisp-font-lock-keywords, c-font-lock-keywords, etc, as appropriate.
67 ;; The easiest way to change the highlighting patterns is to change the
68 ;; values of c-font-lock-keywords and related variables. See the doc
69 ;; string of the variable `font-lock-keywords' for the appropriate syntax.
71 ;; The default value for `lisp-font-lock-keywords' is the value of the variable
72 ;; `lisp-font-lock-keywords-1'. You may like `lisp-font-lock-keywords-2'
73 ;; better; it highlights many more words, but is slower and makes your buffers
74 ;; be very visually noisy.
76 ;; The same is true of `c-font-lock-keywords-1' and `c-font-lock-keywords-2';
77 ;; the former is subdued, the latter is loud.
79 ;; You can make font-lock default to the gaudier variety of keyword
80 ;; highlighting by setting the variable `font-lock-maximum-decoration'
81 ;; before loading font-lock, or by calling the functions
82 ;; `font-lock-use-default-maximal-decoration' or
83 ;; `font-lock-use-default-minimal-decoration'.
85 ;; On a Sparc10, the initial fontification takes about 6 seconds for a typical
86 ;; 140k file of C code, using the default configuration. The actual speed
87 ;; depends heavily on the type of code in the file, and how many non-syntactic
88 ;; patterns match; for example, Xlib.h takes 23 seconds for 101k, because many
89 ;; patterns match in it. You can speed this up substantially by removing some
90 ;; of the patterns that are highlighted by default. Fontifying lisp code is
91 ;; significantly faster, because lisp has a more regular syntax than C, so the
92 ;; regular expressions don't have to be as complicated.
94 ;; It's called font-lock-mode here because on the Lispms it was called
95 ;; "Electric Font Lock Mode." It was called that because there was an older
96 ;; mode called "Electric Caps Lock Mode" which had the function of causing all
97 ;; of your source code to be in upper case except for strings and comments,
98 ;; without you having to blip the caps lock key by hand all the time (thus the
99 ;; "electric", as in `electric-c-brace'.)
101 ;; See also the related packages `fast-lock' and `lazy-lock'. Both
102 ;; attempt to speed up the initial fontification. `fast-lock' saves
103 ;; the fontification info when you exit Emacs and reloads it next time
104 ;; you load the file, so that the file doesn't have to be fontified
105 ;; again. `lazy-lock' does "lazy" fontification -- i.e. it only
106 ;; fontifies the text as it becomes visible rather than fontifying
107 ;; the whole file when it's first loaded in.
109 ;; Further comments from the FSF:
111 ;; Nasty regexps of the form "bar\\(\\|lo\\)\\|f\\(oo\\|u\\(\\|bar\\)\\)\\|lo"
112 ;; are made thusly: (regexp-opt '("foo" "fu" "fubar" "bar" "barlo" "lo")) for
115 ;; What is fontification for? You might say, "It's to make my code look nice."
116 ;; I think it should be for adding information in the form of cues. These cues
117 ;; should provide you with enough information to both (a) distinguish between
118 ;; different items, and (b) identify the item meanings, without having to read
119 ;; the items and think about it. Therefore, fontification allows you to think
120 ;; less about, say, the structure of code, and more about, say, why the code
121 ;; doesn't work. Or maybe it allows you to think less and drift off to sleep.
123 ;; So, here are my opinions/advice/guidelines:
125 ;; - Use the same face for the same conceptual object, across all modes.
126 ;; i.e., (b) above, all modes that have items that can be thought of as, say,
127 ;; keywords, should be highlighted with the same face, etc.
128 ;; - Keep the faces distinct from each other as far as possible.
130 ;; - Make the face attributes fit the concept as far as possible.
131 ;; i.e., function names might be a bold color such as blue, comments might
132 ;; be a bright color such as red, character strings might be brown, because,
133 ;; err, strings are brown (that was not the reason, please believe me).
134 ;; - Don't use a non-nil OVERRIDE unless you have a good reason.
135 ;; Only use OVERRIDE for special things that are easy to define, such as the
136 ;; way `...' quotes are treated in strings and comments in Emacs Lisp mode.
137 ;; Don't use it to, say, highlight keywords in commented out code or strings.
143 (require 'fontl-hooks)
145 ;;;;;;;;;;;;;;;;;;;;;; user variables ;;;;;;;;;;;;;;;;;;;;;;
147 (defgroup font-lock nil
148 "Decorate source files with fonts/colors based on syntax.
149 Font-lock-mode is a minor mode that causes your comments to be
150 displayed in one face, strings in another, reserved words in another,
151 documentation strings in another, and so on.
153 Comments will be displayed in `font-lock-comment-face'.
154 Strings will be displayed in `font-lock-string-face'.
155 Doc strings will be displayed in `font-lock-doc-string-face'.
156 Function and variable names (in their defining forms) will be displayed
157 in `font-lock-function-name-face'.
158 Reserved words will be displayed in `font-lock-keyword-face'.
159 Preprocessor conditionals will be displayed in `font-lock-preprocessor-face'."
162 (defgroup font-lock-faces nil
163 "Faces used by the font-lock package."
168 (defcustom font-lock-verbose t
169 "*If non-nil, means show status messages when fontifying.
170 See also `font-lock-message-threshold'."
174 (defcustom font-lock-message-threshold 6000
175 "*Minimum size of region being fontified for status messages to appear.
177 The size is measured in characters. This affects `font-lock-fontify-region'
178 but not `font-lock-fontify-buffer'. (In other words, when you first visit
179 a file and it gets fontified, you will see status messages no matter what
180 size the file is. However, if you do something else like paste a
181 chunk of text, you will see status messages only if the changed region is
184 Note that setting `font-lock-verbose' to nil disables the status
190 (defcustom font-lock-auto-fontify t
191 "*Whether font-lock should automatically fontify files as they're loaded.
192 This will only happen if font-lock has fontifying keywords for the major
193 mode of the file. You can get finer-grained control over auto-fontification
194 by using this variable in combination with `font-lock-mode-enable-list' or
195 `font-lock-mode-disable-list'."
200 (defcustom font-lock-mode-enable-list nil
201 "*List of modes to auto-fontify, if `font-lock-auto-fontify' is nil."
202 :type '(repeat (symbol :tag "Mode"))
206 (defcustom font-lock-mode-disable-list nil
207 "*List of modes not to auto-fontify, if `font-lock-auto-fontify' is t."
208 :type '(repeat (symbol :tag "Mode"))
212 (defcustom font-lock-use-colors '(color)
213 "*Specification for when Font Lock will set up color defaults.
214 Normally this should be '(color), meaning that Font Lock will set up
215 color defaults that are only used on color displays. Set this to nil
216 if you don't want Font Lock to set up color defaults at all. This
219 -- a list of valid tags, meaning that the color defaults will be used
220 when all of the tags apply. (e.g. '(color x))
221 -- a list whose first element is 'or and whose remaining elements are
222 lists of valid tags, meaning that the defaults will be used when
223 any of the tag lists apply.
224 -- nil, meaning that the defaults should not be set up at all.
226 \(If you specify face values in your init file, they will override any
227 that Font Lock specifies, regardless of whether you specify the face
228 values before or after loading Font Lock.)
230 See also `font-lock-use-fonts'. If you want more control over the faces
231 used for fontification, see the documentation of `font-lock-mode' for
238 (defcustom font-lock-use-fonts '(or (mono) (grayscale))
239 "*Specification for when Font Lock will set up non-color defaults.
241 Normally this should be '(or (mono) (grayscale)), meaning that Font
242 Lock will set up non-color defaults that are only used on either mono
243 or grayscale displays. Set this to nil if you don't want Font Lock to
244 set up non-color defaults at all. This should be one of
246 -- a list of valid tags, meaning that the non-color defaults will be used
247 when all of the tags apply. (e.g. '(grayscale x))
248 -- a list whose first element is 'or and whose remaining elements are
249 lists of valid tags, meaning that the defaults will be used when
250 any of the tag lists apply.
251 -- nil, meaning that the defaults should not be set up at all.
253 \(If you specify face values in your init file, they will override any
254 that Font Lock specifies, regardless of whether you specify the face
255 values before or after loading Font Lock.)
257 See also `font-lock-use-colors'. If you want more control over the faces
258 used for fontification, see the documentation of `font-lock-mode' for
264 (defcustom font-lock-maximum-decoration t
265 "*If non-nil, the maximum decoration level for fontifying.
266 If nil, use the minimum decoration (equivalent to level 0).
267 If t, use the maximum decoration available.
268 If a number, use that level of decoration (or if not available the maximum).
269 If a list, each element should be a cons pair of the form (MAJOR-MODE . LEVEL),
270 where MAJOR-MODE is a symbol or t (meaning the default). For example:
271 ((c++-mode . 2) (c-mode . t) (t . 1))
272 means use level 2 decoration for buffers in `c++-mode', the maximum decoration
273 available for buffers in `c-mode', and level 1 decoration otherwise."
274 :type '(choice (const :tag "default" nil)
275 (const :tag "maximum" t)
276 (integer :tag "level" 1)
277 (repeat :menu-tag "mode specific" :tag "mode specific"
279 (cons :tag "Instance"
282 (symbol :tag "name"))
283 (radio :tag "Decoration"
284 (const :tag "default" nil)
285 (const :tag "maximum" t)
286 (integer :tag "level" 1)))))
290 (define-obsolete-variable-alias 'font-lock-use-maximal-decoration
291 'font-lock-maximum-decoration)
294 (defcustom font-lock-maximum-size (* 250 1024)
295 "*If non-nil, the maximum size for buffers for fontifying.
296 Only buffers less than this can be fontified when Font Lock mode is turned on.
297 If nil, means size is irrelevant.
298 If a list, each element should be a cons pair of the form (MAJOR-MODE . SIZE),
299 where MAJOR-MODE is a symbol or t (meaning the default). For example:
300 ((c++-mode . 256000) (c-mode . 256000) (rmail-mode . 1048576))
301 means that the maximum size is 250K for buffers in `c++-mode' or `c-mode', one
302 megabyte for buffers in `rmail-mode', and size is irrelevant otherwise."
303 :type '(choice (const :tag "none" nil)
304 (integer :tag "size")
305 (repeat :menu-tag "mode specific" :tag "mode specific"
307 (cons :tag "Instance"
310 (symbol :tag "name"))
312 (const :tag "none" nil)
313 (integer :tag "size")))))
317 ;; Fontification variables:
320 (defvar font-lock-keywords nil
321 "A list defining the keywords for `font-lock-mode' to highlight.
323 FONT-LOCK-KEYWORDS := List of FONT-LOCK-FORM's.
325 FONT-LOCK-FORM :== MATCHER
327 | (MATCHER . FACE-FORM)
328 | (MATCHER . HIGHLIGHT)
329 | (MATCHER HIGHLIGHT ...)
332 MATCHER :== A string containing a regexp.
333 | A variable containing a regexp to search for.
334 | A function to call to make the search.
335 It is called with one arg, the limit of the search,
336 and should leave MATCH results in the XEmacs global
339 MATCH :== An integer match subexpression number from MATCHER.
341 FACE-FORM :== The symbol naming a defined face.
342 | Expression whos value is the face name to use. If you
343 want FACE-FORM to be a symbol that evaluates to a face,
344 use a form like \"(progn sym)\".
346 HIGHLIGHT :== MATCH-HIGHLIGHT
349 FORM :== Expression returning a FONT-LOCK-FORM, evaluated when
350 the FONT-LOCK-FORM is first used in a buffer. This
351 feature can be used to provide a FONT-LOCK-FORM that
352 can only be generated when Font Lock mode is actually
355 MATCH-HIGHLIGHT :== (MATCH FACE-FORM OVERRIDE LAXMATCH)
357 OVERRIDE :== t - overwrite existing fontification
358 | 'keep - only parts not already fontified are
360 | 'prepend - merge faces, this fontification has
361 precedence over existing
362 | 'append - merge faces, existing fontification has
366 LAXMATCH :== If non-nil, no error is signalled if there is no MATCH
369 MATCH-ANCHORED :== (ANCHOR-MATCHER PRE-MATCH-FORM \\
370 POST-MATCH-FORM MATCH-HIGHLIGHT ...)
372 ANCHOR-MATCHER :== Like a MATCHER, except that the limit of the search
373 defaults to the end of the line after PRE-MATCH-FORM
374 is evaluated. However, if PRE-MATCH-FORM returns a
375 position greater than the end of the line, that
376 position is used as the limit of the search. It is
377 generally a bad idea to return a position greater than
378 the end of the line, i.e., cause the ANCHOR-MATCHER
379 search to span lines.
381 PRE-MATCH-FORM :== Evaluated before the ANCHOR-MATCHER is used, therefore
382 can be used to initialize before, ANCHOR-MATCHER is
383 used. Typically, PRE-MATCH-FORM is used to move to
384 some position relative to the original MATCHER, before
385 starting with the ANCHOR-MATCHER.
387 POST-MATCH-FORM :== Like PRE-MATCH-FORM, but used to clean up after the
388 ANCHOR-MATCHER. It might be used to move, before
389 resuming with MATCH-ANCHORED's parent's MATCHER.
391 For example, an element of the first form highlights (if not already highlighted):
393 \"\\\\<foo\\\\>\" Discrete occurrences of \"foo\" in the value
394 of the variable `font-lock-keyword-face'.
396 (\"fu\\\\(bar\\\\)\" . 1) Substring \"bar\" within all occurrences of
397 \"fubar\" in the value of
398 `font-lock-keyword-face'.
400 (\"fubar\" . fubar-face) Occurrences of \"fubar\" in the value of
403 (\"foo\\\\|bar\" 0 foo-bar-face t) Occurrences of either \"foo\" or \"bar\" in the
404 value of `foo-bar-face', even if already
407 (fubar-match 1 fubar-face) The first subexpression within all
408 occurrences of whatever the function
409 `fubar-match' finds and matches in the value
412 (\"\\\\<anchor\\\\>\" (0 anchor-face) (\"\\\\<item\\\\>\" nil nil (0 item-face)))
413 -------------- --------------- ------------ --- --- -------------
415 MATCHER | ANCHOR-MATCHER | +------+ MATCH-HIGHLIGHT
416 MATCH-HIGHLIGHT PRE-MATCH-FORM |
419 Discrete occurrences of \"anchor\" in the value of `anchor-face', and
420 subsequent discrete occurrences of \"item\" (on the same line) in the value
421 of `item-face'. (Here PRE-MATCH-FORM and POST-MATCH-FORM are nil.
422 Therefore \"item\" is initially searched for starting from the end of the
423 match of \"anchor\", and searching for subsequent instance of \"anchor\"
424 resumes from where searching for \"item\" concluded.)
426 For highlighting single items, typically only MATCH-HIGHLIGHT is required.
427 However, if an item or (typically) several items are to be highlighted
428 following the instance of another item (the anchor) then MATCH-ANCHORED may be
431 These regular expressions should not match text which spans lines. While
432 \\[font-lock-fontify-buffer] handles multi-line patterns correctly, updating when you
433 edit the buffer does not, since it considers text one line at a time.
435 Be very careful composing regexps for this list; the wrong pattern can
436 dramatically slow things down!
439 (make-variable-buffer-local 'font-lock-keywords)
441 (defvar font-lock-defaults nil
442 "The defaults font Font Lock mode for the current buffer.
443 Normally, do not set this directly. If you are writing a major mode,
444 put a property of `font-lock-defaults' on the major-mode symbol with
449 \(KEYWORDS KEYWORDS-ONLY CASE-FOLD SYNTAX-ALIST SYNTAX-BEGIN)
451 KEYWORDS may be a symbol (a variable or function whose value is the keywords
452 to use for fontification) or a list of symbols. If KEYWORDS-ONLY is non-nil,
453 syntactic fontification (strings and comments) is not performed. If CASE-FOLD
454 is non-nil, the case of the keywords is ignored when fontifying. If
455 SYNTAX-ALIST is non-nil, it should be a list of cons pairs of the form (CHAR
456 . STRING) used to set the local Font Lock syntax table, for keyword and
457 syntactic fontification (see `modify-syntax-entry').
459 If SYNTAX-BEGIN is non-nil, it should be a function with no args used to move
460 backwards outside any enclosing syntactic block, for syntactic fontification.
461 Typical values are `beginning-of-line' (i.e., the start of the line is known to
462 be outside a syntactic block), or `beginning-of-defun' for programming modes or
463 `backward-paragraph' for textual modes (i.e., the mode-dependent function is
464 known to move outside a syntactic block). If nil, the beginning of the buffer
465 is used as a position outside of a syntactic block, in the worst case.
467 These item elements are used by Font Lock mode to set the variables
468 `font-lock-keywords', `font-lock-keywords-only',
469 `font-lock-keywords-case-fold-search', `font-lock-syntax-table' and
470 `font-lock-beginning-of-syntax-function', respectively.
472 Alternatively, if the value is a symbol, it should name a major mode,
473 and the defaults for that mode will apply.")
474 (make-variable-buffer-local 'font-lock-defaults)
476 ;; FSF uses `font-lock-defaults-alist' and expects the major mode to
477 ;; set a value for `font-lock-defaults', but I don't like either of
478 ;; these -- requiring the mode to set `font-lock-defaults' makes it
479 ;; impossible to have defaults for a minor mode, and using an alist is
480 ;; generally a bad idea for information that really should be
481 ;; decentralized. (Who knows what strange modes might want
484 (defvar font-lock-keywords-only nil
485 "Non-nil means Font Lock should not do syntactic fontification.
486 This is normally set via `font-lock-defaults'.
488 This should be nil for all ``language'' modes, but other modes, like
489 dired, do not have anything useful in the syntax tables (no comment
490 or string delimiters, etc) and so there is no need to use them and
491 this variable should have a value of t.
493 You should not set this variable directly; its value is computed
494 from `font-lock-defaults', or (if that does not specify anything)
495 by examining the syntax table to see whether it appears to contain
497 (make-variable-buffer-local 'font-lock-keywords-only)
499 (defvar font-lock-keywords-case-fold-search nil
500 "Whether the strings in `font-lock-keywords' should be case-folded.
501 This variable is automatically buffer-local, as the correct value depends
502 on the language in use.")
503 (make-variable-buffer-local 'font-lock-keywords-case-fold-search)
505 (defvar font-lock-after-fontify-buffer-hook nil
506 "Function or functions to run after completion of font-lock-fontify-buffer.")
508 (defvar font-lock-syntax-table nil
509 "Non-nil means use this syntax table for fontifying.
510 If this is nil, the major mode's syntax table is used.
511 This is normally set via `font-lock-defaults'.")
512 (make-variable-buffer-local 'font-lock-syntax-table)
514 ;; These are used in the FSF version in syntactic font-locking.
515 ;; We do this all in C.
516 ;;; These record the parse state at a particular position, always the
517 ;;; start of a line. Used to make
518 ;;; `font-lock-fontify-syntactically-region' faster.
519 ;(defvar font-lock-cache-position nil)
520 ;(defvar font-lock-cache-state nil)
521 ;(make-variable-buffer-local 'font-lock-cache-position)
522 ;(make-variable-buffer-local 'font-lock-cache-state)
524 ;; If this is nil, we only use the beginning of the buffer if we can't use
525 ;; `font-lock-cache-position' and `font-lock-cache-state'.
526 (defvar font-lock-beginning-of-syntax-function nil
527 "Non-nil means use this function to move back outside of a syntactic block.
528 If this is nil, the beginning of the buffer is used (in the worst case).
529 This is normally set via `font-lock-defaults'.")
530 (make-variable-buffer-local 'font-lock-beginning-of-syntax-function)
532 (defvar font-lock-fontify-buffer-function 'font-lock-default-fontify-buffer
533 "Function to use for fontifying the buffer.
534 This is normally set via `font-lock-defaults'.")
536 (defvar font-lock-unfontify-buffer-function 'font-lock-default-unfontify-buffer
537 "Function to use for unfontifying the buffer.
538 This is used when turning off Font Lock mode.
539 This is normally set via `font-lock-defaults'.")
541 (defvar font-lock-fontify-region-function 'font-lock-default-fontify-region
542 "Function to use for fontifying a region.
543 It should take two args, the beginning and end of the region, and an optional
544 third arg VERBOSE. If non-nil, the function should print status messages.
545 This is normally set via `font-lock-defaults'.")
547 (defvar font-lock-unfontify-region-function 'font-lock-default-unfontify-region
548 "Function to use for unfontifying a region.
549 It should take two args, the beginning and end of the region.
550 This is normally set via `font-lock-defaults'.")
552 (defvar font-lock-inhibit-thing-lock nil
553 "List of Font Lock mode related modes that should not be turned on.
554 Currently, valid mode names as `fast-lock-mode' and `lazy-lock-mode'.
555 This is normally set via `font-lock-defaults'.")
558 (defcustom font-lock-mode nil ;; customized for the option menu. dverna
559 "Non nil means `font-lock-mode' is on"
562 :initialize 'custom-initialize-default
564 :set #'(lambda (var val) (font-lock-mode (or val 0)))
567 (defvar font-lock-fontified nil) ; whether we have hacked this buffer
568 (put 'font-lock-fontified 'permanent-local t)
571 (defvar font-lock-mode-hook nil
572 "Function or functions to run on entry to font-lock-mode.")
574 ; whether font-lock-set-defaults has already been run.
575 (defvar font-lock-defaults-computed nil)
576 (make-variable-buffer-local 'font-lock-defaults-computed)
579 ;;; Initialization of faces.
581 ;; #### barf gag retch. Horrid FSF lossage that we need to
582 ;; keep around for compatibility with font-lock-keywords that
583 ;; forget to properly quote their faces. I tried just let-binding
584 ;; them when we eval the face expression, but that failes because
585 ;; some files actually use the variables directly in their init code
586 ;; without quoting them. --ben
587 (defvar font-lock-comment-face 'font-lock-comment-face
588 "This variable should not be set.
589 It is present only for horrid FSF compatibility reasons.
590 The corresponding face should be set using `edit-faces' or the
591 `set-face-*' functions.")
592 (defvar font-lock-doc-string-face 'font-lock-doc-string-face
593 "This variable should not be set.
594 It is present only for horrid FSF compatibility reasons.
595 The corresponding face should be set using `edit-faces' or the
596 `set-face-*' functions.")
597 (defvar font-lock-string-face 'font-lock-string-face
598 "This variable should not be set.
599 It is present only for horrid FSF compatibility reasons.
600 The corresponding face should be set using `edit-faces' or the
601 `set-face-*' functions.")
602 (defvar font-lock-keyword-face 'font-lock-keyword-face
603 "This variable should not be set.
604 It is present only for horrid FSF compatibility reasons.
605 The corresponding face should be set using `edit-faces' or the
606 `set-face-*' functions.")
607 (defvar font-lock-function-name-face 'font-lock-function-name-face
608 "This variable should not be set.
609 It is present only for horrid FSF compatibility reasons.
610 The corresponding face should be set using `edit-faces' or the
611 `set-face-*' functions.")
612 (defvar font-lock-variable-name-face 'font-lock-variable-name-face
613 "This variable should not be set.
614 It is present only for horrid FSF compatibility reasons.
615 The corresponding face should be set using `edit-faces' or the
616 `set-face-*' functions.")
617 (defvar font-lock-type-face 'font-lock-type-face
618 "This variable should not be set.
619 It is present only for horrid FSF compatibility reasons.
620 The corresponding face should be set using `edit-faces' or the
621 `set-face-*' functions.")
622 (defvar font-lock-reference-face 'font-lock-reference-face
623 "This variable should not be set.
624 It is present only for horrid FSF compatibility reasons.
625 The corresponding face should be set using `edit-faces' or the
626 `set-face-*' functions.")
627 (defvar font-lock-preprocessor-face 'font-lock-preprocessor-face
628 "This variable should not be set.
629 It is present only for horrid FSF compatibility reasons.
630 The corresponding face should be set using `edit-faces' or the
631 `set-face-*' functions.")
633 (defconst font-lock-face-list
634 '(font-lock-comment-face
635 font-lock-string-face
636 font-lock-doc-string-face
637 font-lock-keyword-face
638 font-lock-function-name-face
639 font-lock-variable-name-face
641 font-lock-reference-face
642 font-lock-preprocessor-face
643 font-lock-warning-face))
645 (defface font-lock-comment-face
646 '((((class color) (background dark)) (:foreground "gray80"))
647 ;; blue4 is hardly different from black on windows.
648 (((class color) (background light) (type mswindows)) (:foreground "blue"))
649 (((class color) (background light)) (:foreground "blue4"))
650 (((class grayscale) (background light))
651 (:foreground "DimGray" :bold t :italic t))
652 (((class grayscale) (background dark))
653 (:foreground "LightGray" :bold t :italic t))
655 "Font Lock mode face used to highlight comments."
656 :group 'font-lock-faces)
658 (defface font-lock-string-face
659 '((((class color) (background dark)) (:foreground "tan"))
660 (((class color) (background light)) (:foreground "green4"))
661 (((class grayscale) (background light)) (:foreground "DimGray" :italic t))
662 (((class grayscale) (background dark)) (:foreground "LightGray" :italic t))
664 "Font Lock mode face used to highlight strings."
665 :group 'font-lock-faces)
667 (defface font-lock-doc-string-face
668 '((((class color) (background dark)) (:foreground "light coral"))
669 (((class color) (background light)) (:foreground "green4"))
671 "Font Lock mode face used to highlight documentation strings.
672 This is currently supported only in Lisp-like modes, which are those
673 with \"lisp\" or \"scheme\" in their name. You can explicitly make
674 a mode Lisp-like by putting a non-nil `font-lock-lisp-like' property
675 on the major mode's symbol."
676 :group 'font-lock-faces)
678 (defface font-lock-keyword-face
679 '((((class color) (background dark)) (:foreground "cyan"))
680 ;; red4 is hardly different from black on windows.
681 (((class color) (background light) (type mswindows)) (:foreground "red"))
682 (((class color) (background light)) (:foreground "red4"))
683 (((class grayscale) (background light)) (:foreground "LightGray" :bold t))
684 (((class grayscale) (background dark)) (:foreground "DimGray" :bold t))
686 "Font Lock mode face used to highlight keywords."
687 :group 'font-lock-faces)
689 (defface font-lock-function-name-face
690 '((((class color) (background dark)) (:foreground "aquamarine"))
691 ;; brown4 is hardly different from black on windows.
692 ;; I changed it to red because IMO it's pointless and ugly to
693 ;; use a million slightly different colors for niggly syntactic
694 ;; differences. --ben
695 (((class color) (background light) (type mswindows)) (:foreground "red"))
696 (((class color) (background light)) (:foreground "brown4"))
697 (t (:bold t :underline t)))
698 "Font Lock mode face used to highlight function names."
699 :group 'font-lock-faces)
701 (defface font-lock-variable-name-face
702 '((((class color) (background dark)) (:foreground "cyan3"))
703 (((class color) (background light)) (:foreground "magenta4"))
704 (((class grayscale) (background light))
705 (:foreground "Gray90" :bold t :italic t))
706 (((class grayscale) (background dark))
707 (:foreground "DimGray" :bold t :italic t))
709 "Font Lock mode face used to highlight variable names."
710 :group 'font-lock-faces)
712 (defface font-lock-type-face
713 '((((class color) (background dark)) (:foreground "wheat"))
714 (((class color) (background light)) (:foreground "steelblue"))
715 (((class grayscale) (background light)) (:foreground "Gray90" :bold t))
716 (((class grayscale) (background dark)) (:foreground "DimGray" :bold t))
718 "Font Lock mode face used to highlight types."
719 :group 'font-lock-faces)
721 (defface font-lock-reference-face
722 '((((class color) (background dark)) (:foreground "cadetblue2"))
723 (((class color) (background light)) (:foreground "red3"))
724 (((class grayscale) (background light))
725 (:foreground "LightGray" :bold t :underline t))
726 (((class grayscale) (background dark))
727 (:foreground "Gray50" :bold t :underline t)))
728 "Font Lock mode face used to highlight references."
729 :group 'font-lock-faces)
731 ;; #### FSF has font-lock-builtin-face.
733 (defface font-lock-preprocessor-face
734 '((((class color) (background dark)) (:foreground "steelblue1"))
735 (((class color) (background light)) (:foreground "blue3"))
737 "Font Lock Mode face used to highlight preprocessor conditionals."
738 :group 'font-lock-faces)
740 ;; #### Currently unused
741 (defface font-lock-warning-face
742 '((((class color) (background light)) (:foreground "Red" :bold t))
743 (((class color) (background dark)) (:foreground "Pink" :bold t))
744 (t (:inverse-video t :bold t)))
745 "Font Lock mode face used to highlight warnings."
746 :group 'font-lock-faces)
748 (defun font-lock-recompute-variables ()
749 ;; Is this a Draconian thing to do?
750 (mapc #'(lambda (buffer)
751 (with-current-buffer buffer
753 (font-lock-set-defaults t)))
756 ;; Backwards-compatible crud.
758 (defun font-lock-reset-all-faces ()
759 (dolist (face font-lock-face-list)
760 (face-spec-set face (get face 'face-defface-spec))))
762 (defun font-lock-use-default-fonts ()
763 "Reset the font-lock faces to a default set of fonts."
766 (font-lock-reset-all-faces))
768 (defun font-lock-use-default-colors ()
769 "Reset the font-lock faces to a default set of colors."
772 (font-lock-reset-all-faces))
774 (defun font-lock-use-default-minimal-decoration ()
775 "Reset the font-lock patterns to a fast, minimal set of decorations."
776 (and font-lock-maximum-decoration
777 (setq font-lock-maximum-decoration nil)
778 (font-lock-recompute-variables)))
780 (defun font-lock-use-default-maximal-decoration ()
781 "Reset the font-lock patterns to a larger set of decorations."
782 (and (not (eq t font-lock-maximum-decoration))
783 (setq font-lock-maximum-decoration t)
784 (font-lock-recompute-variables)))
787 ;;;;;;;;;;;;;;;;;;;;;; actual code ;;;;;;;;;;;;;;;;;;;;;;
789 ;;; To fontify the whole buffer by language syntax, we go through it a
790 ;;; character at a time, creating extents on the boundary of each syntactic
791 ;;; unit (that is, one extent for each block comment, one for each line
792 ;;; comment, one for each string, etc.) This is done with the C function
793 ;;; syntactically-sectionize. It's in C for speed (the speed of lisp function
794 ;;; calls was a real bottleneck for this task since it involves examining each
795 ;;; character in turn.)
797 ;;; Then we make a second pass, to fontify the buffer based on other patterns
798 ;;; specified by regexp. When we find a match for a region of text, we need
799 ;;; to change the fonts on those characters. This is done with the
800 ;;; put-text-property function, which knows how to efficiently share extents.
801 ;;; Conceptually, we are attaching some particular face to each of the
802 ;;; characters in a range, but the implementation of this involves creating
803 ;;; extents, or resizing existing ones.
805 ;;; Each time a modification happens to a line, we re-fontify the entire line.
806 ;;; We do this by first removing the extents (text properties) on the line,
807 ;;; and then doing the syntactic and keyword passes again on that line. (More
808 ;;; generally, each modified region is extended to include the preceding and
809 ;;; following BOL or EOL.)
811 ;;; This means that, as the user types, we repeatedly go back to the beginning
812 ;;; of the line, doing more work the longer the line gets. This doesn't cost
813 ;;; much in practice, and if we don't, then we incorrectly fontify things when,
814 ;;; for example, inserting spaces into `intfoo () {}'.
818 ;; The user level functions
821 (defun font-lock-mode (&optional arg)
822 "Toggle Font Lock Mode.
823 With arg, turn font-lock mode on if and only if arg is positive.
825 When Font Lock mode is enabled, text is fontified as you type it:
827 - Comments are displayed in `font-lock-comment-face';
828 - Strings are displayed in `font-lock-string-face';
829 - Documentation strings (in Lisp-like languages) are displayed in
830 `font-lock-doc-string-face';
831 - Language keywords (\"reserved words\") are displayed in
832 `font-lock-keyword-face';
833 - Function names in their defining form are displayed in
834 `font-lock-function-name-face';
835 - Variable names in their defining form are displayed in
836 `font-lock-variable-name-face';
837 - Type names are displayed in `font-lock-type-face';
838 - References appearing in help files and the like are displayed
839 in `font-lock-reference-face';
840 - Preprocessor declarations are displayed in
841 `font-lock-preprocessor-face';
845 - Certain other expressions are displayed in other faces according
846 to the value of the variable `font-lock-keywords'.
848 Where modes support different levels of fontification, you can use the variable
849 `font-lock-maximum-decoration' to specify which level you generally prefer.
850 When you turn Font Lock mode on/off the buffer is fontified/defontified, though
851 fontification occurs only if the buffer is less than `font-lock-maximum-size'.
852 To fontify a buffer without turning on Font Lock mode, and regardless of buffer
853 size, you can use \\[font-lock-fontify-buffer].
855 See the variable `font-lock-keywords' for customization."
857 (let ((on-p (if arg (> (prefix-numeric-value arg) 0) (not font-lock-mode)))
858 (maximum-size (if (not (consp font-lock-maximum-size))
859 font-lock-maximum-size
860 (cdr (or (assq major-mode font-lock-maximum-size)
861 (assq t font-lock-maximum-size))))))
862 ;; Font-lock mode will refuse to turn itself on if in batch mode, or if
863 ;; the current buffer is "invisible". The latter is because packages
864 ;; sometimes put their temporary buffers into some particular major mode
865 ;; to get syntax tables and variables and whatnot, but we don't want the
866 ;; fact that the user has font-lock-mode on a mode hook to slow these
868 (if (or noninteractive (eq (aref (buffer-name) 0) ?\ ))
870 (if (equal (buffer-name) " *Compiler Input*") ; hack for bytecomp...
873 (make-local-hook 'after-change-functions)
874 (add-hook 'after-change-functions
875 'font-lock-after-change-function nil t)
876 (add-hook 'pre-idle-hook 'font-lock-pre-idle-hook))
878 (remove-hook 'after-change-functions
879 'font-lock-after-change-function t)
880 (setq font-lock-defaults-computed nil
881 font-lock-keywords nil)
882 ;; We have no business doing this here, since
883 ;; pre-idle-hook is global. Other buffers may
884 ;; still be in font-lock mode. -dkindred@cs.cmu.edu
885 ;; (remove-hook 'pre-idle-hook 'font-lock-pre-idle-hook)
887 (set (make-local-variable 'font-lock-mode) on-p)
889 (font-lock-set-defaults-1)
890 (run-hooks 'font-lock-mode-hook)
891 (cond (font-lock-fontified
893 ((or (null maximum-size) (<= (buffer-size) maximum-size))
894 (font-lock-fontify-buffer))
896 (progress-feedback-with-label
898 "Fontifying %s... buffer too big." 'abort
901 (setq font-lock-fontified nil)
902 (font-lock-unfontify-region (point-min) (point-max))
903 (font-lock-thing-lock-cleanup))
905 (font-lock-thing-lock-cleanup)))
908 ;; For init-file hooks
910 (defun turn-on-font-lock ()
911 "Unconditionally turn on Font Lock mode."
915 (defun turn-off-font-lock ()
916 "Unconditionally turn off Font Lock mode."
921 ;; support for add-keywords, global-font-lock-mode and
922 ;; font-lock-support-mode (unified support for various *-lock modes).
925 ;; Fontification functions.
927 ;; We first define some defsubsts to encapsulate the way we add
928 ;; faces to a region of text. I am planning on modifying the
929 ;; text-property mechanism so that multiple independent classes
930 ;; of text properties can exist. That way, for example, ediff's
931 ;; face text properties don't interfere with font lock's face
932 ;; text properties. Due to the XEmacs implementation of text
933 ;; properties in terms of extents, doing this is fairly trivial:
934 ;; instead of using the `text-prop' property, you just use a
935 ;; specified property.
937 (defsubst font-lock-set-face (start end face)
938 ;; Set the face on the characters in the range.
939 (put-nonduplicable-text-property start end 'face face)
940 (put-nonduplicable-text-property start end 'font-lock t))
942 (defsubst font-lock-remove-face (start end)
943 ;; Remove any syntax highlighting on the characters in the range.
944 (put-nonduplicable-text-property start end 'face nil)
945 (put-nonduplicable-text-property start end 'font-lock nil))
947 (defsubst font-lock-any-faces-p (start end)
948 ;; Return non-nil if we've put any syntax highlighting on
949 ;; the characters in the range.
951 ;; used to look for 'text-prop property, but this has problems if
952 ;; you put any other text properties in the vicinity. Simon
953 ;; Marshall suggested looking for the 'face property (this is what
954 ;; FSF Emacs does) but that's equally bogus. Only reliable way is
955 ;; for font-lock to specially mark its extents.
957 ;; FSF's (equivalent) definition of this defsubst would be
958 ;; (text-property-not-all start end 'font-lock nil)
960 ;; Perhaps our `map-extents' is faster than our definition
961 ;; of `text-property-not-all'. #### If so, `text-property-not-all'
962 ;; should be fixed ...
964 (map-extents 'extent-property (current-buffer) start (1- end) 'font-lock))
967 ;; Fontification functions.
969 ;; Rather than the function, e.g., `font-lock-fontify-region' containing the
970 ;; code to fontify a region, the function runs the function whose name is the
971 ;; value of the variable, e.g., `font-lock-fontify-region-function'. Normally,
972 ;; the value of this variable is, e.g., `font-lock-default-fontify-region'
973 ;; which does contain the code to fontify a region. However, the value of the
974 ;; variable could be anything and thus, e.g., `font-lock-fontify-region' could
975 ;; do anything. The indirection of the fontification functions gives major
976 ;; modes the capability of modifying the way font-lock.el fontifies. Major
977 ;; modes can modify the values of, e.g., `font-lock-fontify-region-function',
978 ;; via the variable `font-lock-defaults'.
980 ;; For example, Rmail mode sets the variable `font-lock-defaults' so that
981 ;; font-lock.el uses its own function for buffer fontification. This function
982 ;; makes fontification be on a message-by-message basis and so visiting an
983 ;; RMAIL file is much faster. A clever implementation of the function might
984 ;; fontify the headers differently than the message body. (It should, and
985 ;; correspondingly for Mail mode, but I can't be bothered to do the work. Can
986 ;; you?) This hints at a more interesting use...
988 ;; Languages that contain text normally contained in different major modes
989 ;; could define their own fontification functions that treat text differently
990 ;; depending on its context. For example, Perl mode could arrange that here
991 ;; docs are fontified differently than Perl code. Or Yacc mode could fontify
992 ;; rules one way and C code another. Neat!
994 ;; A further reason to use the fontification indirection feature is when the
995 ;; default syntactual fontification, or the default fontification in general,
996 ;; is not flexible enough for a particular major mode. For example, perhaps
997 ;; comments are just too hairy for `font-lock-fontify-syntactically-region' to
998 ;; cope with. You need to write your own version of that function, e.g.,
999 ;; `hairy-fontify-syntactically-region', and make your own version of
1000 ;; `hairy-fontify-region' call that function before calling
1001 ;; `font-lock-fontify-keywords-region' for the normal regexp fontification
1002 ;; pass. And Hairy mode would set `font-lock-defaults' so that font-lock.el
1003 ;; would call your region fontification function instead of its own. For
1004 ;; example, TeX modes could fontify {\foo ...} and \bar{...} etc. multi-line
1005 ;; directives correctly and cleanly. (It is the same problem as fontifying
1006 ;; multi-line strings and comments; regexps are not appropriate for the job.)
1009 (defun font-lock-fontify-buffer ()
1010 "Fontify the current buffer the way `font-lock-mode' would.
1011 See `font-lock-mode' for details.
1013 This can take a while for large buffers."
1015 (let ((font-lock-verbose (or font-lock-verbose (interactive-p))))
1016 (funcall font-lock-fontify-buffer-function)))
1018 (defun font-lock-unfontify-buffer ()
1019 (funcall font-lock-unfontify-buffer-function))
1021 (defun font-lock-fontify-region (beg end &optional loudly)
1022 (funcall font-lock-fontify-region-function beg end loudly))
1024 (defun font-lock-unfontify-region (beg end &optional loudly)
1025 (funcall font-lock-unfontify-region-function beg end loudly))
1027 (defun font-lock-default-fontify-buffer ()
1029 ;; if we don't widen, then the C code will fail to
1030 ;; realize that we're inside a comment.
1033 (let ((was-on font-lock-mode)
1034 (font-lock-verbose (or font-lock-verbose (interactive-p)))
1035 (font-lock-message-threshold 0)
1037 ;; Turn it on to run hooks and get the right font-lock-keywords.
1038 (or was-on (font-lock-mode 1))
1039 (font-lock-unfontify-region (point-min) (point-max) t)
1040 ;; (buffer-syntactic-context-flush-cache)
1042 ;; If a ^G is typed during fontification, abort the fontification, but
1043 ;; return normally (do not signal.) This is to make it easy to abort
1044 ;; fontification if it's taking a long time, without also causing the
1045 ;; buffer not to pop up. If a real abort is desired, the user can ^G
1048 ;; Possibly this should happen down in font-lock-fontify-region instead
1049 ;; of here, but since that happens from the after-change-hook (meaning
1050 ;; much more frequently) I'm afraid of the bad consequences of stealing
1051 ;; the interrupt character at inopportune times.
1055 (font-lock-fontify-region (point-min) (point-max)))
1059 (or was-on ; turn it off if it was off.
1060 (let ((font-lock-fontified nil)) ; kludge to prevent defontification
1061 (font-lock-mode 0)))
1062 (set (make-local-variable 'font-lock-fontified) t)
1063 (when (and aborted font-lock-verbose)
1064 (progress-feedback-with-label 'font-lock "Fontifying %s... aborted."
1065 'abort (buffer-name))))
1066 (run-hooks 'font-lock-after-fontify-buffer-hook)))
1068 (defun font-lock-default-unfontify-buffer ()
1069 (font-lock-unfontify-region (point-min) (point-max))
1070 (set (make-local-variable 'font-lock-fontified) nil))
1072 ;; This used to be `font-lock-fontify-region', and before that,
1073 ;; `font-lock-fontify-region' used to be the name used for what is now
1074 ;; `font-lock-fontify-syntactically-region'.
1075 (defun font-lock-default-fontify-region (beg end &optional loudly)
1076 (let ((modified (buffer-modified-p))
1077 (buffer-undo-list t) (inhibit-read-only t)
1078 (old-syntax-table (syntax-table))
1079 buffer-file-name buffer-file-truename)
1082 ;; Use the fontification syntax table, if any.
1083 (if font-lock-syntax-table (set-syntax-table font-lock-syntax-table))
1084 ;; Now do the fontification.
1085 (if font-lock-keywords-only
1086 (font-lock-unfontify-region beg end)
1087 (font-lock-fontify-syntactically-region beg end loudly))
1088 (font-lock-fontify-keywords-region beg end loudly))
1090 (set-syntax-table old-syntax-table)
1091 (and (not modified) (buffer-modified-p) (set-buffer-modified-p nil)))))
1093 ;; The following must be rethought, since keywords can override fontification.
1094 ; ;; Now scan for keywords, but not if we are inside a comment now.
1095 ; (or (and (not font-lock-keywords-only)
1096 ; (let ((state (parse-partial-sexp beg end nil nil
1097 ; font-lock-cache-state)))
1098 ; (or (nth 4 state) (nth 7 state))))
1099 ; (font-lock-fontify-keywords-region beg end))
1101 (defun font-lock-default-unfontify-region (beg end &optional maybe-loudly)
1102 (when (and maybe-loudly font-lock-verbose
1103 (>= (- end beg) font-lock-message-threshold))
1104 (progress-feedback-with-label 'font-lock "Fontifying %s..." 0
1106 (let ((modified (buffer-modified-p))
1107 (buffer-undo-list t) (inhibit-read-only t)
1108 buffer-file-name buffer-file-truename)
1109 (font-lock-remove-face beg end)
1110 (and (not modified) (buffer-modified-p) (set-buffer-modified-p nil))))
1112 ;; Following is the original FSF version (similar to our original
1113 ;; version, before the deferred stuff was added).
1115 ;; I think that lazy-lock v2 tries to do something similar.
1116 ;; Those efforts should be merged.
1118 ;; Called when any modification is made to buffer text.
1119 ;(defun font-lock-after-change-function (beg end old-len)
1122 ; ;; Rescan between start of line from `beg' and start of line after `end'.
1123 ; (font-lock-fontify-region
1124 ; (progn (goto-char beg) (beginning-of-line) (point))
1125 ; (progn (goto-char end) (forward-line 1) (point))))))
1127 (defvar font-lock-always-fontify-immediately nil
1128 "Set this to non-nil to disable font-lock deferral.
1129 Otherwise, changes to existing text will not be processed until the
1130 next redisplay cycle, avoiding excessive fontification when many
1131 buffer modifications are performed or a buffer is reverted.")
1133 (defvar font-lock-pending-extent-table (make-hash-table :weakness 'key))
1134 (defvar font-lock-range-table (make-range-table))
1136 (defun font-lock-pre-idle-hook ()
1137 (condition-case font-lock-error
1138 (if (> (hash-table-count font-lock-pending-extent-table) 0)
1139 (font-lock-fontify-pending-extents))
1140 (error (warn "Error caught in `font-lock-pre-idle-hook': %s"
1143 ;;; called when any modification is made to buffer text. This function
1144 ;;; remembers the changed ranges until the next redisplay, at which point
1145 ;;; the extents are merged and pruned, and the resulting ranges fontified.
1146 ;;; This function could easily be adapted to other after-change-functions.
1148 (defun font-lock-after-change-function (beg end old-len)
1149 (when font-lock-mode
1150 (let ((ex (make-extent beg end)))
1151 (set-extent-property ex 'detachable nil)
1152 (set-extent-property ex 'end-open nil)
1153 (let ((exs (gethash (current-buffer) font-lock-pending-extent-table)))
1155 (puthash (current-buffer) exs font-lock-pending-extent-table)))
1156 (if font-lock-always-fontify-immediately
1157 (font-lock-fontify-pending-extents))))
1159 (defun font-lock-fontify-pending-extents ()
1160 ;; ah, the beauty of mapping functions.
1161 ;; this function is actually shorter than the old version, which handled
1162 ;; only one buffer and one contiguous region!
1165 #'(lambda (buffer exs)
1166 ;; remove first, to avoid infinite reprocessing if error
1167 (remhash buffer font-lock-pending-extent-table)
1168 (when (buffer-live-p buffer)
1169 (clear-range-table font-lock-range-table)
1170 (with-current-buffer buffer
1173 ;; if we don't widen, then the C code will fail to
1174 ;; realize that we're inside a comment.
1176 (let ((zmacs-region-stays
1177 zmacs-region-stays)) ; protect from change!
1181 (when (and (extent-live-p ex)
1182 (not (extent-detached-p ex)))
1183 ;; first expand the ranges to full lines, because
1184 ;; that is what will be fontified; then use a
1185 ;; range table to merge the ranges.
1186 (let* ((beg (extent-start-position ex))
1187 (end (extent-end-position ex))
1188 (beg (progn (goto-char beg)
1191 (end (progn (goto-char end)
1195 (put-range-table beg end t
1196 font-lock-range-table))))
1199 #'(lambda (beg end val)
1200 ;; Maybe flush the internal cache used by
1201 ;; syntactically-sectionize. (It'd be nice if this
1202 ;; was more automatic.) Any deletions mean the
1203 ;; cache is invalid, and insertions at beginning or
1204 ;; end of line mean that the bol cache might be
1206 ;; #### This code has been commented out for some time
1207 ;; now and is bit-rotting. Someone should look into
1209 ;; (if (or change-was-deletion (bobp)
1210 ;; (= (preceding-char) ?\n))
1211 ;; (buffer-syntactic-context-flush-cache))
1212 ;; #### This creates some unnecessary progress gauges.
1213 ;; (if (and (= beg (point-min))
1214 ;; (= end (point-max)))
1215 ;; (font-lock-fontify-buffer)
1216 ;; (font-lock-fontify-region beg end)))
1217 (font-lock-fontify-region beg end))
1218 font-lock-range-table)))))))
1219 font-lock-pending-extent-table)))
1221 ;; Syntactic fontification functions.
1223 ;; Note: Here is the FSF version. Our version is much faster because
1224 ;; of the C support we provide. This may be useful for reference,
1225 ;; however, and perhaps there is something useful here that should
1226 ;; be merged into our version.
1228 ;(defun font-lock-fontify-syntactically-region (start end &optional loudly)
1229 ; "Put proper face on each string and comment between START and END.
1230 ;START should be at the beginning of a line."
1231 ; (let ((synstart (if comment-start-skip
1232 ; (concat "\\s\"\\|" comment-start-skip)
1234 ; (comstart (if comment-start-skip
1235 ; (concat "\\s<\\|" comment-start-skip)
1237 ; state prev prevstate)
1238 ; (if loudly (message "Fontifying %s... (syntactically...)" (buffer-name)))
1243 ; ;; Find the state at the `beginning-of-line' before `start'.
1244 ; (if (eq start font-lock-cache-position)
1245 ; ;; Use the cache for the state of `start'.
1246 ; (setq state font-lock-cache-state)
1247 ; ;; Find the state of `start'.
1248 ; (if (null font-lock-beginning-of-syntax-function)
1249 ; ;; Use the state at the previous cache position, if any, or
1250 ; ;; otherwise calculate from `point-min'.
1251 ; (if (or (null font-lock-cache-position)
1252 ; (< start font-lock-cache-position))
1253 ; (setq state (parse-partial-sexp (point-min) start))
1254 ; (setq state (parse-partial-sexp font-lock-cache-position start
1255 ; nil nil font-lock-cache-state)))
1256 ; ;; Call the function to move outside any syntactic block.
1257 ; (funcall font-lock-beginning-of-syntax-function)
1258 ; (setq state (parse-partial-sexp (point) start)))
1259 ; ;; Cache the state and position of `start'.
1260 ; (setq font-lock-cache-state state
1261 ; font-lock-cache-position start))
1263 ; ;; If the region starts inside a string, show the extent of it.
1265 ; (let ((beg (point)))
1266 ; (while (and (re-search-forward "\\s\"" end 'move)
1267 ; (nth 3 (parse-partial-sexp beg (point)
1269 ; (put-text-property beg (point) 'face font-lock-string-face)
1270 ; (setq state (parse-partial-sexp beg (point) nil nil state))))
1272 ; ;; Likewise for a comment.
1273 ; (if (or (nth 4 state) (nth 7 state))
1274 ; (let ((beg (point)))
1276 ; (narrow-to-region (point-min) end)
1277 ; (condition-case nil
1279 ; (re-search-backward comstart (point-min) 'move)
1280 ; (forward-comment 1)
1281 ; ;; forward-comment skips all whitespace,
1282 ; ;; so go back to the real end of the comment.
1283 ; (skip-chars-backward " \t"))
1284 ; (error (goto-char end))))
1285 ; (put-text-property beg (point) 'face font-lock-comment-face)
1286 ; (setq state (parse-partial-sexp beg (point) nil nil state))))
1288 ; ;; Find each interesting place between here and `end'.
1289 ; (while (and (< (point) end)
1290 ; (setq prev (point) prevstate state)
1291 ; (re-search-forward synstart end t)
1293 ; ;; Clear out the fonts of what we skip over.
1294 ; (remove-text-properties prev (point) '(face nil))
1295 ; ;; Verify the state at that place
1296 ; ;; so we don't get fooled by \" or \;.
1297 ; (setq state (parse-partial-sexp prev (point)
1299 ; (let ((here (point)))
1300 ; (if (or (nth 4 state) (nth 7 state))
1302 ; ;; We found a real comment start.
1303 ; (let ((beg (match-beginning 0)))
1306 ; (narrow-to-region (point-min) end)
1307 ; (condition-case nil
1309 ; (forward-comment 1)
1310 ; ;; forward-comment skips all whitespace,
1311 ; ;; so go back to the real end of the comment.
1312 ; (skip-chars-backward " \t"))
1313 ; (error (goto-char end))))
1314 ; (put-text-property beg (point) 'face
1315 ; font-lock-comment-face)
1316 ; (setq state (parse-partial-sexp here (point) nil nil state)))
1319 ; ;; We found a real string start.
1320 ; (let ((beg (match-beginning 0)))
1321 ; (while (and (re-search-forward "\\s\"" end 'move)
1322 ; (nth 3 (parse-partial-sexp here (point)
1324 ; (put-text-property beg (point) 'face font-lock-string-face)
1325 ; (setq state (parse-partial-sexp here (point)
1326 ; nil nil state))))))
1328 ; ;; Make sure `prev' is non-nil after the loop
1329 ; ;; only if it was set on the very last iteration.
1333 ; (and prev (remove-text-properties prev end '(face nil)))))
1335 (defun font-lock-lisp-like (mode)
1336 ;; Note: (or (get mode 'font-lock-lisp-like) (string-match ...)) is
1337 ;; not enough because the property needs to be able to specify a nil
1339 (if (plist-member (symbol-plist mode) 'font-lock-lisp-like)
1340 (get mode 'font-lock-lisp-like)
1341 ;; If the property is not specified, guess. Similar logic exists
1342 ;; in add-log, but I think this encompasses more modes.
1343 (string-match "lisp\\|scheme" (symbol-name mode))))
1345 (defun font-lock-fontify-syntactically-region (start end &optional loudly)
1346 "Put proper face on each string and comment between START and END.
1347 START should be at the beginning of a line."
1348 (if font-lock-keywords-only
1350 (when (and font-lock-verbose
1351 (>= (- end start) font-lock-message-threshold))
1352 (progress-feedback-with-label 'font-lock
1353 "Fontifying %s... (syntactically)" 5
1355 (font-lock-unfontify-region start end loudly)
1357 (if (> end (point-max)) (setq end (point-max)))
1358 (let ((lisp-like (font-lock-lisp-like major-mode)))
1359 (syntactically-sectionize
1360 #'(lambda (s e context depth)
1362 (cond ((eq context 'string)
1364 ;; #### It would be nice if we handled
1365 ;; Python and other non-Lisp languages with
1366 ;; docstrings correctly.
1367 (if (and lisp-like (= depth 1))
1368 ;; really we should only use this if
1369 ;; in position 3 depth 1, but that's
1370 ;; too expensive to compute.
1371 'font-lock-doc-string-face
1372 'font-lock-string-face)))
1373 ((or (eq context 'comment)
1374 (eq context 'block-comment))
1375 (setq face 'font-lock-comment-face)
1376 ; ;; Don't fontify whitespace at the beginning of lines;
1377 ; ;; otherwise comment blocks may not line up with code.
1378 ; ;; (This is sometimes a good idea, sometimes not; in any
1379 ; ;; event it should be in C for speed --jwz)
1382 ; (while (prog1 (search-forward "\n" (1- e) 'move)
1383 ; (setq face 'font-lock-comment-face)
1385 ; (skip-chars-forward " \t\n")
1388 (font-lock-set-face s e face)))
1392 ;;; Additional text property functions.
1394 ;; The following three text property functions are not generally available (and
1395 ;; it's not certain that they should be) so they are inlined for speed.
1396 ;; The case for `fillin-text-property' is simple; it may or not be generally
1397 ;; useful. (Since it is used here, it is useful in at least one place.;-)
1398 ;; However, the case for `append-text-property' and `prepend-text-property' is
1399 ;; more complicated. Should they remove duplicate property values or not? If
1400 ;; so, should the first or last duplicate item remain? Or the one that was
1401 ;; added? In our implementation, the first duplicate remains.
1403 ;; XEmacs: modified all these functions to use
1404 ;; `put-nonduplicable-text-property' instead of `put-text-property', and
1405 ;; the first one to take both SETPROP and MARKPROP, in accordance with the
1406 ;; changed definitions of `font-lock-any-faces-p' and `font-lock-set-face'.
1408 (defsubst font-lock-fillin-text-property (start end setprop markprop value &optional object)
1409 "Fill in one property of the text from START to END.
1410 Arguments PROP and VALUE specify the property and value to put where none are
1411 already in place. Therefore existing property values are not overwritten.
1412 Optional argument OBJECT is the string or buffer containing the text."
1413 (let ((start (text-property-any start end markprop nil object)) next)
1415 (setq next (next-single-property-change start markprop object end))
1416 (put-nonduplicable-text-property start next setprop value object)
1417 (put-nonduplicable-text-property start next markprop value object)
1418 (setq start (text-property-any next end markprop nil object)))))
1420 ;; This function (from simon's unique.el) is rewritten and inlined for speed.
1421 ;(defun unique (list function)
1422 ; "Uniquify LIST, deleting elements using FUNCTION.
1423 ;Return the list with subsequent duplicate items removed by side effects.
1424 ;FUNCTION is called with an element of LIST and a list of elements from LIST,
1425 ;and should return the list of elements with occurrences of the element removed,
1426 ;i.e., a function such as `delete' or `delq'.
1427 ;This function will work even if LIST is unsorted. See also `uniq'."
1428 ; (let ((list list))
1430 ; (setq list (setcdr list (funcall function (car list) (cdr list))))))
1433 (defsubst font-lock-unique (list)
1434 "Uniquify LIST, deleting elements using `delq'.
1435 Return the list with subsequent duplicate items removed by side effects."
1438 (setq list (setcdr list (delq (car list) (cdr list))))))
1441 ;; A generalisation of `facemenu-add-face' for any property, but without the
1442 ;; removal of inactive faces via `facemenu-discard-redundant-faces' and special
1443 ;; treatment of `default'. Uses `unique' to remove duplicate property values.
1444 (defsubst font-lock-prepend-text-property (start end prop value &optional object)
1445 "Prepend to one property of the text from START to END.
1446 Arguments PROP and VALUE specify the property and value to prepend to the value
1447 already in place. The resulting property values are always lists, and unique.
1448 Optional argument OBJECT is the string or buffer containing the text."
1449 (let ((val (if (listp value) value (list value))) next prev)
1450 (while (/= start end)
1451 (setq next (next-single-property-change start prop object end)
1452 prev (get-text-property start prop object))
1455 (font-lock-unique (append val (if (listp prev) prev (list prev))))
1457 (setq start next))))
1459 (defsubst font-lock-append-text-property (start end prop value &optional object)
1460 "Append to one property of the text from START to END.
1461 Arguments PROP and VALUE specify the property and value to append to the value
1462 already in place. The resulting property values are always lists, and unique.
1463 Optional argument OBJECT is the string or buffer containing the text."
1464 (let ((val (if (listp value) value (list value))) next prev)
1465 (while (/= start end)
1466 (setq next (next-single-property-change start prop object end)
1467 prev (get-text-property start prop object))
1470 (font-lock-unique (append (if (listp prev) prev (list prev)) val))
1472 (setq start next))))
1474 ;;; Regexp fontification functions.
1476 (defsubst font-lock-apply-highlight (highlight)
1477 "Apply HIGHLIGHT following a match.
1478 HIGHLIGHT should be of the form MATCH-HIGHLIGHT, see `font-lock-keywords'."
1479 (let* ((match (nth 0 highlight))
1480 (start (match-beginning match)) (end (match-end match))
1481 (override (nth 2 highlight)))
1482 (let ((newface (nth 1 highlight)))
1483 (or (symbolp newface)
1484 (setq newface (eval newface)))
1486 ;; No match but we might not signal an error.
1487 (or (nth 3 highlight)
1488 (error "No match %d in highlight %S" match highlight)))
1491 ;; Cannot override existing fontification.
1492 (or (font-lock-any-faces-p start end)
1493 (font-lock-set-face start end newface)))
1495 ;; Override existing fontification.
1496 (font-lock-set-face start end newface))
1497 ((eq override 'keep)
1498 ;; Keep existing fontification.
1499 (font-lock-fillin-text-property start end 'face 'font-lock
1501 ((eq override 'prepend)
1502 ;; Prepend to existing fontification.
1503 (font-lock-prepend-text-property start end 'face newface))
1504 ((eq override 'append)
1505 ;; Append to existing fontification.
1506 (font-lock-append-text-property start end 'face newface))))))
1508 (defsubst font-lock-fontify-anchored-keywords (keywords limit)
1509 "Fontify according to KEYWORDS until LIMIT.
1510 KEYWORDS should be of the form MATCH-ANCHORED, see `font-lock-keywords',
1511 LIMIT can be modified by the value of its PRE-MATCH-FORM."
1512 (let ((matcher (nth 0 keywords)) (lowdarks (nthcdr 3 keywords)) highlights
1513 ;; Evaluate PRE-MATCH-FORM.
1514 (pre-match-value (eval (nth 1 keywords))))
1515 ;; Set LIMIT to value of PRE-MATCH-FORM or the end of line.
1516 (if (and (numberp pre-match-value) (> pre-match-value (point)))
1517 (setq limit pre-match-value)
1518 (save-excursion (end-of-line) (setq limit (point))))
1520 ;; Find an occurrence of `matcher' before `limit'.
1521 (while (if (stringp matcher)
1522 (re-search-forward matcher limit t)
1523 (funcall matcher limit))
1524 ;; Apply each highlight to this instance of `matcher'.
1525 (setq highlights lowdarks)
1527 (font-lock-apply-highlight (car highlights))
1528 (setq highlights (cdr highlights)))))
1529 ;; Evaluate POST-MATCH-FORM.
1530 (eval (nth 2 keywords))))
1532 (defun font-lock-fontify-keywords-region (start end &optional loudvar)
1533 "Fontify according to `font-lock-keywords' between START and END.
1534 START should be at the beginning of a line."
1535 (let ((loudly (and font-lock-verbose
1536 (>= (- end start) font-lock-message-threshold))))
1537 (let* ((case-fold-search font-lock-keywords-case-fold-search)
1538 (keywords (cdr (if (eq (car-safe font-lock-keywords) t)
1540 (font-lock-compile-keywords))))
1541 (bufname (buffer-name))
1542 (progress 5) (old-progress 5)
1544 (nkeywords (length keywords))
1545 keyword matcher highlights)
1547 ;; Fontify each item in `font-lock-keywords' from `start' to `end'.
1548 ;; In order to measure progress accurately we need to know how
1549 ;; many keywords we have and how big the region is. Then progress
1550 ;; is ((pos - start)/ (end - start) * nkeywords
1551 ;; + iteration / nkeywords) * 100
1554 ;; Find an occurrence of `matcher' from `start' to `end'.
1555 (setq keyword (car keywords) matcher (car keyword))
1557 (while (and (< (point) end)
1558 (if (stringp matcher)
1559 (re-search-forward matcher end t)
1560 (funcall matcher end)))
1561 ;; calculate progress
1563 (+ (/ (* (- (point) start) 95) (* (- end start) nkeywords))
1564 (/ (* iter 95) nkeywords) 5))
1565 (when (and loudly (> progress old-progress))
1566 (progress-feedback-with-label 'font-lock
1567 "Fontifying %s... (regexps)"
1569 (setq old-progress progress)
1570 ;; Apply each highlight to this instance of `matcher', which may be
1571 ;; specific highlights or more keywords anchored to `matcher'.
1572 (setq highlights (cdr keyword))
1574 (if (numberp (car (car highlights)))
1575 (let ((end (match-end (car (car highlights)))))
1576 (font-lock-apply-highlight (car highlights))
1577 ;; restart search just after the end of the
1578 ;; keyword so keywords can share bracketing
1580 (and end (goto-char end)))
1581 (font-lock-fontify-anchored-keywords (car highlights) end))
1582 (setq highlights (cdr highlights))))
1583 (setq iter (1+ iter))
1584 (setq keywords (cdr keywords))))
1586 (progress-feedback-with-label 'font-lock "Fontifying %s... " 100
1590 ;; Various functions.
1592 ;; Turn off other related packages if they're on. I prefer a hook. --sm.
1593 ;; These explicit calls are easier to understand
1594 ;; because people know what they will do.
1595 ;; A hook is a mystery because it might do anything whatever. --rms.
1596 (defun font-lock-thing-lock-cleanup ()
1597 (cond ((and (boundp 'fast-lock-mode) fast-lock-mode)
1598 (fast-lock-mode -1))
1599 ((and (boundp 'lazy-lock-mode) lazy-lock-mode)
1600 (lazy-lock-mode -1))
1601 ((and (boundp 'lazy-shot-mode) lazy-shot-mode)
1602 (lazy-shot-mode -1))))
1604 ;; Do something special for these packages after fontifying. I prefer a hook.
1605 (defun font-lock-after-fontify-buffer ()
1606 (cond ((and (boundp 'fast-lock-mode) fast-lock-mode)
1607 (fast-lock-after-fontify-buffer))
1608 ((and (boundp 'lazy-lock-mode) lazy-lock-mode)
1609 (lazy-lock-after-fontify-buffer))))
1612 ;; Various functions.
1614 (defun font-lock-compile-keywords (&optional keywords)
1615 ;; Compile `font-lock-keywords' into the form (t KEYWORD ...) where KEYWORD
1616 ;; is the (MATCHER HIGHLIGHT ...) shown in the variable's doc string.
1617 (let ((keywords (or keywords font-lock-keywords)))
1618 (setq font-lock-keywords
1619 (if (eq (car-safe keywords) t)
1621 (cons t (mapcar 'font-lock-compile-keyword keywords))))))
1623 (defun font-lock-compile-keyword (keyword)
1624 (cond ((nlistp keyword) ; Just MATCHER
1625 (list keyword '(0 font-lock-keyword-face)))
1626 ((eq (car keyword) 'eval) ; Specified (eval . FORM)
1627 (font-lock-compile-keyword (eval (cdr keyword))))
1628 ((numberp (cdr keyword)) ; Specified (MATCHER . MATCH)
1629 (list (car keyword) (list (cdr keyword) 'font-lock-keyword-face)))
1630 ((symbolp (cdr keyword)) ; Specified (MATCHER . FACENAME)
1631 (list (car keyword) (list 0 (cdr keyword))))
1632 ((nlistp (nth 1 keyword)) ; Specified (MATCHER . HIGHLIGHT)
1633 (list (car keyword) (cdr keyword)))
1634 (t ; Hopefully (MATCHER HIGHLIGHT ...)
1637 (defun font-lock-choose-keywords (keywords level)
1638 ;; Return LEVELth element of KEYWORDS. A LEVEL of nil is equal to a
1639 ;; LEVEL of 0, a LEVEL of t is equal to (1- (length KEYWORDS)).
1640 (let ((level (if (not (consp level))
1642 (cdr (or (assq major-mode level) (assq t level))))))
1643 (cond ((symbolp keywords)
1646 (or (nth level keywords) (car (reverse keywords))))
1648 (car (reverse keywords)))
1653 ;;; Determining which set of font-lock keywords to use.
1655 (defun font-lock-find-font-lock-defaults (modesym)
1656 ;; Get the defaults based on the major mode.
1658 ;; I want a do-while loop!
1660 (setq raw-defaults (get modesym 'font-lock-defaults))
1661 (and raw-defaults (symbolp raw-defaults)
1662 (setq modesym raw-defaults)))
1666 (defun font-lock-examine-syntax-table ()
1667 ; Computes the value of font-lock-keywords-only for this buffer.
1668 (if (eq (syntax-table) (standard-syntax-table))
1669 ;; Assume that modes which haven't bothered to install their own
1670 ;; syntax table don't do anything syntactically interesting.
1671 ;; Really, the standard-syntax-table shouldn't have comments and
1672 ;; strings in it, but changing that now might break things.
1674 ;; else map over the syntax table looking for strings or comments.
1677 (if (fboundp 'map-syntax-table)
1680 #'(lambda (key value)
1681 (memq (char-syntax-from-code value)
1682 '(?\" ?\< ?\> ?\$)))
1685 (let ((i (1- (length (syntax-table)))))
1687 (if (memq (char-syntax i) '(?\" ?\< ?\> ?\$))
1688 (setq got-one t i 0))
1690 (set (make-local-variable 'font-lock-keywords-only) (not got-one)))))
1692 ;; font-lock-set-defaults is in fontl-hooks.el.
1695 (defun font-lock-set-defaults-1 (&optional explicit-defaults)
1696 ;; does everything that font-lock-set-defaults does except
1697 ;; enable font-lock-mode. This is called by `font-lock-mode'.
1698 ;; Note that the return value is used!
1700 (if (and font-lock-defaults-computed (not explicit-defaults))
1704 (or font-lock-keywords
1705 (let* ((defaults (or (and (not (eq t explicit-defaults))
1707 ;; in case modes decide to set
1708 ;; `font-lock-defaults' themselves,
1711 (font-lock-find-font-lock-defaults major-mode)))
1712 (keywords (font-lock-choose-keywords
1713 (nth 0 defaults) font-lock-maximum-decoration)))
1716 (setq font-lock-keywords (if (fboundp keywords)
1719 (or font-lock-keywords
1721 ;; try to look for a variable `foo-mode-font-lock-keywords',
1723 (let ((major (symbol-name major-mode))
1725 (if (stringp n) (setq n (intern-soft n)))
1730 (setq font-lock-keywords
1732 (or (funcall try (get major-mode 'font-lock-keywords))
1733 (funcall try (concat major "-font-lock-keywords"))
1734 (funcall try (and (string-match "-mode\\'" major)
1737 (match-beginning 0))
1738 "-font-lock-keywords")))
1739 'font-lock-keywords)))))
1742 (if (>= (length defaults) 3)
1743 (setq font-lock-keywords-case-fold-search (nth 2 defaults))
1745 ;; look for a property 'font-lock-keywords-case-fold-search on
1746 ;; the major-mode symbol.
1747 (let* ((nonexist (make-symbol ""))
1748 (value (get major-mode 'font-lock-keywords-case-fold-search
1750 (if (not (eq nonexist value))
1751 (setq font-lock-keywords-case-fold-search value))))
1754 (if (>= (length defaults) 2)
1755 (setq font-lock-keywords-only (nth 1 defaults))
1757 ;; cleverly examine the syntax table.
1758 (font-lock-examine-syntax-table))
1761 (if (nth 3 defaults)
1762 (let ((slist (nth 3 defaults)))
1763 (setq font-lock-syntax-table
1764 (copy-syntax-table (syntax-table)))
1766 (modify-syntax-entry (car (car slist)) (cdr (car slist))
1767 font-lock-syntax-table)
1768 (setq slist (cdr slist)))))
1772 (setq font-lock-beginning-of-syntax-function
1776 ;; defaults not specified at all, so use `beginning-of-defun'.
1777 (setq font-lock-beginning-of-syntax-function
1778 'beginning-of-defun)))))
1780 (setq font-lock-defaults-computed t)))
1783 ;;;;;;;;;;;;;;;;;;;;;; keywords ;;;;;;;;;;;;;;;;;;;;;;
1785 ;;; Various major-mode interfaces.
1786 ;;; Probably these should go in with the source of the respective major modes.
1788 ;; The defaults and keywords listed here should perhaps be moved into
1789 ;; mode-specific files.
1791 ;; For C and Lisp modes we use `beginning-of-defun', rather than nil,
1792 ;; for SYNTAX-BEGIN. Thus the calculation of the cache is usually
1793 ;; faster but not infallible, so we risk mis-fontification. --sm.
1795 (put 'c-mode 'font-lock-defaults
1796 '((c-font-lock-keywords
1797 c-font-lock-keywords-1 c-font-lock-keywords-2 c-font-lock-keywords-3)
1798 nil nil ((?_ . "w")) beginning-of-defun))
1799 (put 'c++-c-mode 'font-lock-defaults 'c-mode)
1800 (put 'elec-c-mode 'font-lock-defaults 'c-mode)
1802 (put 'c++-mode 'font-lock-defaults
1803 '((c++-font-lock-keywords
1804 c++-font-lock-keywords-1 c++-font-lock-keywords-2
1805 c++-font-lock-keywords-3)
1806 nil nil ((?_ . "w") (?~ . "w")) beginning-of-defun))
1808 (put 'java-mode 'font-lock-defaults
1809 '((java-font-lock-keywords
1810 java-font-lock-keywords-1 java-font-lock-keywords-2
1811 java-font-lock-keywords-3)
1812 nil nil ((?_ . "w")) beginning-of-defun
1813 (font-lock-mark-block-function . mark-defun)))
1815 (put 'lisp-mode 'font-lock-defaults
1816 '((lisp-font-lock-keywords
1817 lisp-font-lock-keywords-1 lisp-font-lock-keywords-2)
1819 ((?: . "w") (?- . "w") (?* . "w") (?+ . "w") (?. . "w") (?< . "w")
1820 (?> . "w") (?= . "w") (?! . "w") (?? . "w") (?$ . "w") (?% . "w")
1821 (?_ . "w") (?& . "w") (?~ . "w") (?^ . "w") (?/ . "w"))
1822 beginning-of-defun))
1823 (put 'emacs-lisp-mode 'font-lock-defaults 'lisp-mode)
1824 (put 'lisp-interaction-mode 'font-lock-defaults 'lisp-mode)
1826 (put 'scheme-mode 'font-lock-defaults
1827 '(scheme-font-lock-keywords
1829 ((?: . "w") (?- . "w") (?* . "w") (?+ . "w") (?. . "w") (?< . "w")
1830 (?> . "w") (?= . "w") (?! . "w") (?? . "w") (?$ . "w") (?% . "w")
1831 (?_ . "w") (?& . "w") (?~ . "w") (?^ . "w") (?/ . "w"))
1832 beginning-of-defun))
1833 (put 'inferior-scheme-mode 'font-lock-defaults 'scheme-mode)
1834 (put 'scheme-interaction-mode 'font-lock-defaults 'scheme-mode)
1836 (put 'tex-mode 'font-lock-defaults
1837 ;; For TeX modes we could use `backward-paragraph' for the same reason.
1838 '(tex-font-lock-keywords nil nil ((?$ . "\""))))
1839 ;; the nine billion names of TeX mode...
1840 (put 'bibtex-mode 'font-lock-defaults 'tex-mode)
1841 (put 'plain-tex-mode 'font-lock-defaults 'tex-mode)
1842 (put 'slitex-tex-mode 'font-lock-defaults 'tex-mode)
1843 (put 'SliTeX-mode 'font-lock-defaults 'tex-mode)
1844 (put 'slitex-mode 'font-lock-defaults 'tex-mode)
1845 (put 'latex-tex-mode 'font-lock-defaults 'tex-mode)
1846 (put 'LaTex-tex-mode 'font-lock-defaults 'tex-mode)
1847 (put 'latex-mode 'font-lock-defaults 'tex-mode)
1848 (put 'LaTeX-mode 'font-lock-defaults 'tex-mode)
1849 (put 'japanese-LaTeX-mode 'font-lock-defaults 'tex-mode)
1850 (put 'japanese-SliTeX-mode 'font-lock-defaults 'tex-mode)
1851 (put 'FoilTeX-mode 'font-lock-defaults 'tex-mode)
1852 (put 'LATeX-MoDe 'font-lock-defaults 'tex-mode)
1853 (put 'lATEx-mODe 'font-lock-defaults 'tex-mode)
1854 ;; ok, this is getting a bit silly ...
1855 (put 'eDOm-xETAl 'font-lock-defaults 'tex-mode)
1857 ;;; Various regexp information shared by several modes.
1858 ;;; Information specific to a single mode should go in its load library.
1860 (defconst lisp-font-lock-keywords-1
1862 ;; Anything not a variable or type declaration is fontified as a function.
1863 ;; It would be cleaner to allow preceding whitespace, but it would also be
1864 ;; about five times slower.
1865 (list (concat "^(\\(def\\("
1866 ;; Variable declarations.
1867 "\\(const\\(\\|ant\\)\\|ine-key\\(\\|-after\\)\\|var\\|custom\\)\\|"
1868 ;; Structure declarations.
1869 "\\(class\\|struct\\|type\\)\\|"
1870 ;; Everything else is a function declaration.
1871 "\\([^ \t\n\(\)]+\\)"
1873 ;; Any whitespace and declared object.
1875 "\\([^ \t\n\)]+\\)?")
1876 '(1 font-lock-keyword-face)
1877 '(8 (cond ((match-beginning 3) 'font-lock-variable-name-face)
1878 ((match-beginning 6) 'font-lock-type-face)
1879 (t 'font-lock-function-name-face))
1882 "Subdued level highlighting Lisp modes.")
1884 (defconst lisp-font-lock-keywords-2
1885 (append lisp-font-lock-keywords-1
1888 ;; Control structures. ELisp and CLisp combined.
1893 ;; beginning of generated stuff
1894 ;; to regenerate, use the regexp-opt below, then delete the outermost
1895 ;; grouping, then use the macro below to break up the string.
1897 ;; '("cond" "if" "while" "let" "let*" "prog" "progn" "prog1"
1898 ;; "prog2" "progv" "catch" "throw" "save-restriction"
1899 ;; "save-excursion" "save-window-excursion"
1900 ;; "save-current-buffer" "with-current-buffer"
1901 ;; "save-selected-window" "with-selected-window"
1902 ;; "save-selected-frame" "with-selected-frame"
1903 ;; "with-temp-file" "with-temp-buffer" "with-output-to-string"
1904 ;; "with-string-as-buffer-contents"
1905 ;; "save-match-data" "unwind-protect" "call-with-condition-handler"
1906 ;; "condition-case" "track-mouse" "autoload"
1907 ;; "eval-after-load" "eval-and-compile" "eval-when-compile"
1908 ;; "when" "unless" "do" "dolist" "dotimes" "flet" "labels"
1909 ;; "lambda" "block" "return" "return-from" "loop") t)
1910 ;; (setq last-kbd-macro
1911 ;; (read-kbd-macro "\" C-7 C-1 <right> C-r \\\\| 3*<right> \" RET"))
1912 "autoload\\|block\\|c\\(?:a\\(?:ll-with-condition-handler\\|tch\\)\\|"
1913 "ond\\(?:ition-case\\)?\\)\\|do\\(?:list\\|times\\)?\\|"
1914 "eval-\\(?:a\\(?:fter-load\\|nd-compile\\)\\|when-compile\\)\\|flet\\|"
1915 "if\\|l\\(?:a\\(?:bels\\|mbda\\)\\|et\\*?\\|oop\\)\\|prog[12nv]?\\|"
1916 "return\\(?:-from\\)?\\|save-\\(?:current-buffer\\|excursion\\|"
1917 "match-data\\|restriction\\|selected-\\(?:frame\\|window\\)\\|"
1918 "window-excursion\\)\\|t\\(?:hrow\\|rack-mouse\\)\\|un\\(?:less\\|"
1919 "wind-protect\\)\\|w\\(?:h\\(?:en\\|ile\\)\\|ith-\\(?:current-buffer\\|"
1920 "output-to-string\\|s\\(?:elected-\\(?:frame\\|window\\)\\|"
1921 "tring-as-buffer-contents\\)\\|temp-\\(?:buffer\\|file\\)\\)\\)"
1922 ;; end of generated stuff
1925 ;; Feature symbols as references.
1926 '("(\\(featurep\\|provide\\|require\\)\\>[ \t']*\\(\\sw+\\)?"
1927 (1 font-lock-keyword-face) (2 font-lock-reference-face nil t))
1929 ;; Words inside \\[] tend to be for `substitute-command-keys'.
1930 '("\\\\\\\\\\[\\(\\sw+\\)]" 1 font-lock-reference-face prepend)
1932 ;; Words inside `' tend to be symbol names.
1933 '("`\\(\\sw\\sw+\\)'" 1 font-lock-reference-face prepend)
1935 ;; CLisp `:' keywords as references.
1936 '("\\<:\\sw+\\>" 0 font-lock-reference-face prepend)
1938 ;; ELisp and CLisp `&' keywords as types.
1939 '("\\<\\&\\(optional\\|rest\\|whole\\)\\>" . font-lock-type-face)
1941 "Gaudy level highlighting for Lisp modes.")
1943 (defvar lisp-font-lock-keywords lisp-font-lock-keywords-1
1944 "Default expressions to highlight in Lisp modes.")
1946 ;; The previous version, before replacing it with the FSF version.
1947 ;(defconst lisp-font-lock-keywords-1 (purecopy
1949 ; ;; highlight defining forms. This doesn't work too nicely for
1950 ; ;; (defun (setf foo) ...) but it does work for (defvar foo) which
1951 ; ;; is more important.
1952 ; ("^(def[-a-z]+\\s +\\([^ \t\n\)]+\\)" 1 font-lock-function-name-face)
1954 ; ;; highlight CL keywords (three clauses seems faster than one)
1955 ; ("\\s :\\(\\(\\sw\\|\\s_\\)+\\)\\>" . 1)
1956 ; ("(:\\(\\(\\sw\\|\\s_\\)+\\)\\>" . 1)
1957 ; ("':\\(\\(\\sw\\|\\s_\\)+\\)\\>" . 1)
1959 ; ;; this is highlights things like (def* (setf foo) (bar baz)), but may
1960 ; ;; be slower (I haven't really thought about it)
1961 ;; ("^(def[-a-z]+\\s +\\(\\s(\\S)*\\s)\\|\\S(\\S *\\)"
1962 ;; 1 font-lock-function-name-face)
1964 ; "For consideration as a value of `lisp-font-lock-keywords'.
1965 ;This does fairly subdued highlighting.")
1967 ;(defconst lisp-font-lock-keywords-2 (purecopy
1968 ; (append lisp-font-lock-keywords-1
1970 ; ;; Highlight control structures
1971 ; ("(\\(cond\\|if\\|when\\|unless\\|[ec]?\\(type\\)?case\\)[ \t\n]" . 1)
1972 ; ("(\\(while\\|do\\|let\\*?\\|flet\\|labels\\|prog[nv12*]?\\)[ \t\n]" . 1)
1973 ; ("(\\(do\\*\\|dotimes\\|dolist\\|loop\\)[ \t\n]" . 1)
1974 ; ("(\\(catch\\|\\throw\\|block\\|return\\|return-from\\)[ \t\n]" . 1)
1975 ; ("(\\(save-restriction\\|save-window-restriction\\)[ \t\n]" . 1)
1976 ; ("(\\(save-excursion\\|unwind-protect\\|condition-case\\)[ \t\n]" . 1)
1978 ; ;; highlight function names in emacs-lisp docstrings (in the syntax
1979 ; ;; that substitute-command-keys understands.)
1980 ; ("\\\\\\\\\\[\\([^]\\\n]+\\)]" 1 font-lock-keyword-face t)
1982 ; ;; highlight words inside `' which tend to be function names
1983 ; ("`\\([-a-zA-Z0-9_][-a-zA-Z0-9_][-a-zA-Z0-9_.]+\\)'"
1984 ; 1 font-lock-keyword-face t)
1986 ; "For consideration as a value of `lisp-font-lock-keywords'.
1988 ;This does a lot more highlighting.")
1990 (defvar scheme-font-lock-keywords
1994 ;; Declarations. Hannes Haug <hannes.haug@student.uni-tuebingen.de> says
1995 ;; this works for SOS, STklos, SCOOPS, Meroon and Tiny CLOS.
1996 (list (concat "(\\(define\\("
1998 "\\(\\|-\\(generic\\(\\|-procedure\\)\\|method\\)\\)\\|"
1999 ;; Macro names, as variable names. A bit dubious, this.
2004 ;; Any whitespace and declared object.
2007 '(1 font-lock-keyword-face)
2008 '(8 (cond ((match-beginning 3) 'font-lock-function-name-face)
2009 ((match-beginning 6) 'font-lock-variable-name-face)
2010 (t 'font-lock-type-face))
2013 ;; Control structures.
2014 ;(regexp-opt '("begin" "call-with-current-continuation" "call/cc"
2015 ; "call-with-input-file" "call-with-output-file" "case" "cond"
2016 ; "do" "else" "for-each" "if" "lambda"
2017 ; "let\\*?" "let-syntax" "letrec" "letrec-syntax"
2018 ; ;; Hannes Haug <hannes.haug@student.uni-tuebingen.de> wants:
2019 ; "and" "or" "delay"
2020 ; ;; Stefan Monnier <stefan.monnier@epfl.ch> says don't bother:
2021 ; ;;"quasiquote" "quote" "unquote" "unquote-splicing"
2022 ; "map" "syntax" "syntax-rules"))
2025 "and\\|begin\\|c\\(a\\(ll\\(-with-\\(current-continuation\\|"
2026 "input-file\\|output-file\\)\\|/cc\\)\\|se\\)\\|ond\\)\\|"
2027 "d\\(elay\\|o\\)\\|else\\|for-each\\|if\\|"
2028 "l\\(ambda\\|et\\(-syntax\\|\\*?\\|rec\\(\\|-syntax\\)\\)\\)\\|"
2029 "map\\|or\\|syntax\\(\\|-rules\\)"
2032 ;; David Fox <fox@graphics.cs.nyu.edu> for SOS/STklos class specifiers.
2033 '("\\<<\\sw+>\\>" . font-lock-type-face)
2035 ;; Scheme `:' keywords as references.
2036 '("\\<:\\sw+\\>" . font-lock-reference-face)
2038 "Default expressions to highlight in Scheme modes.")
2040 ;; The previous version, before replacing it with the FSF version.
2041 ;(defconst scheme-font-lock-keywords (purecopy
2042 ; '(("(define[ \t]+(?\\([^ \t\n\)]+\\)" 1 font-lock-function-name-face)
2043 ; ("(\\(cond\\|lambda\\|begin\\|if\\|else\\|case\\|do\\)[ \t\n]" . 1)
2044 ; ("(\\(\\|letrec\\|let\\*?\\|set!\\|and\\|or\\)[ \t\n]" . 1)
2045 ; ("(\\(quote\\|unquote\\|quasiquote\\|unquote-splicing\\)[ \t\n]" . 1)
2046 ; ("(\\(syntax\\|syntax-rules\\|define-syntax\\|let-syntax\\|letrec-syntax\\)[ \t\n]" . 1)))
2047 ; "Expressions to highlight in Scheme buffers.")
2049 (defconst c-font-lock-keywords-1 nil
2050 "Subdued level highlighting for C modes.")
2052 (defconst c-font-lock-keywords-2 nil
2053 "Medium level highlighting for C modes.")
2055 (defconst c-font-lock-keywords-3 nil
2056 "Gaudy level highlighting for C modes.")
2058 (defconst c++-font-lock-keywords-1 nil
2059 "Subdued level highlighting for C++ modes.")
2061 (defconst c++-font-lock-keywords-2 nil
2062 "Medium level highlighting for C++ modes.")
2064 (defconst c++-font-lock-keywords-3 nil
2065 "Gaudy level highlighting for C++ modes.")
2067 (defun font-lock-match-c++-style-declaration-item-and-skip-to-next (limit)
2068 ;; Match, and move over, any declaration/definition item after point.
2069 ;; The expect syntax of an item is "word" or "word::word", possibly ending
2070 ;; with optional whitespace and a "(". Everything following the item (but
2071 ;; belonging to it) is expected to by skip-able by `forward-sexp', and items
2072 ;; are expected to be separated with a "," or ";".
2073 (if (looking-at "[ \t*&]*\\(\\(?:\\sw\\|\\s_\\)+\\)\\(::\\(\\(?:\\sw\\|\\s_\\)+\\)\\)?[ \t]*\\((\\)?")
2077 ;; Restrict to the end of line, currently guaranteed to be LIMIT.
2078 (narrow-to-region (point-min) limit)
2079 (goto-char (match-end 1))
2080 ;; Move over any item value, etc., to the next item.
2081 (while (not (looking-at "[ \t]*\\([,;]\\|$\\)"))
2082 (goto-char (or (scan-sexps (point) 1) (point-max))))
2083 (goto-char (match-end 0)))
2087 ; ("break" "continue" "do" "else" "for" "if" "return" "switch" "while")
2088 "break\\|continue\\|do\\|else\\|for\\|if\\|return\\|switch\\|while")
2090 ; ("auto" "extern" "register" "static" "typedef" "struct" "union" "enum"
2091 ; "signed" "unsigned" "short" "long" "int" "char" "float" "double"
2092 ; "void" "volatile" "const")
2093 (concat "auto\\|c\\(har\\|onst\\)\\|double\\|e\\(num\\|xtern\\)\\|"
2094 "float\\|int\\|long\\|register\\|"
2095 "s\\(hort\\|igned\\|t\\(atic\\|ruct\\)\\)\\|typedef\\|"
2096 "un\\(ion\\|signed\\)\\|vo\\(id\\|latile\\)")) ; 6 ()s deep.
2098 ; ("break" "continue" "do" "else" "for" "if" "return" "switch" "while"
2099 ; "asm" "catch" "delete" "new" "operator" "sizeof" "this" "throw" "try"
2100 ; "protected" "private" "public")
2101 (concat "asm\\|break\\|c\\(atch\\|ontinue\\)\\|d\\(elete\\|o\\)\\|"
2102 "else\\|for\\|if\\|new\\|"
2103 "p\\(r\\(ivate\\|otected\\)\\|ublic\\)\\|return\\|"
2104 "s\\(izeof\\|witch\\)\\|t\\(h\\(is\\|row\\)\\|ry\\)\\|while"))
2106 ; ("auto" "extern" "register" "static" "typedef" "struct" "union" "enum"
2107 ; "signed" "unsigned" "short" "long" "int" "char" "float" "double"
2108 ; "void" "volatile" "const" "class" "inline" "friend" "bool"
2109 ; "virtual" "complex" "template")
2110 (concat "auto\\|bool\\|c\\(har\\|lass\\|o\\(mplex\\|nst\\)\\)\\|"
2111 "double\\|e\\(num\\|xtern\\)\\|f\\(loat\\|riend\\)\\|"
2112 "in\\(line\\|t\\)\\|long\\|register\\|"
2113 "s\\(hort\\|igned\\|t\\(atic\\|ruct\\)\\)\\|"
2114 "t\\(emplate\\|ypedef\\)\\|un\\(ion\\|signed\\)\\|"
2115 "v\\(irtual\\|o\\(id\\|latile\\)\\)")) ; 11 ()s deep.
2116 (ctoken "\\(\\sw\\|\\s_\\|[:~*&]\\)+")
2118 (setq c-font-lock-keywords-1
2121 ;; These are all anchored at the beginning of line for speed.
2123 ;; Fontify function name definitions (GNU style; without type on line).
2125 ;; In FSF this has the simpler definition of "\\sw+" for ctoken.
2126 ;; I'm not sure if ours is more correct.
2127 ;; This is a subset of the next rule, and is slower when present. --dmoore
2128 ;; (list (concat "^\\(" ctoken "\\)[ \t]*(") 1 'font-lock-function-name-face)
2130 ;; fontify the names of functions being defined.
2131 ;; FSF doesn't have this but I think it should be fast for us because
2132 ;; our regexp routines are more intelligent than FSF's about handling
2133 ;; anchored-at-newline. (When I added this hack in regex.c, it halved
2134 ;; the time to do the regexp phase of font-lock for a C file!) Not
2135 ;; including this discriminates against those who don't follow the
2136 ;; GNU coding style. --ben
2137 ;; x?x?x?y?z should always be: (x(xx?)?)?y?z --dmoore
2140 "\\(" ctoken "[ \t]+\\)" ; type specs; there can be no
2142 "\\(" ctoken "[ \t]+\\)" ; more than 3 tokens, right?
2143 "\\(" ctoken "[ \t]+\\)"
2145 "\\([*&]+[ \t]*\\)?" ; pointer
2146 "\\(" ctoken "\\)[ \t]*(") ; name
2147 10 'font-lock-function-name-face)
2149 ;; This is faster but not by much. I don't see why not.
2150 ;(list (concat "^\\(" ctoken "\\)[ \t]*(") 1 'font-lock-function-name-face)
2152 ;; Added next two; they're both jolly-good fastmatch candidates so
2153 ;; should be fast. --ben
2155 ;; Fontify structure names (in structure definition form).
2156 (list (concat "^\\(typedef[ \t]+struct\\|struct\\|static[ \t]+struct\\)"
2157 "[ \t]+\\(" ctoken "\\)[ \t]*\\(\{\\|$\\)")
2158 2 'font-lock-function-name-face)
2160 ;; Fontify case clauses. This is fast because its anchored on the left.
2161 '("case[ \t]+\\(\\(\\sw\\|\\s_\\)+\\)[ \t]+:". 1)
2163 '("\\<\\(default\\):". 1)
2164 ;; Fontify filenames in #include <...> preprocessor directives as strings.
2165 '("^#[ \t]*include[ \t]+\\(<[^>\"\n]+>\\)" 1 font-lock-string-face)
2167 ;; Fontify function macro names.
2168 '("^#[ \t]*define[ \t]+\\(\\(\\sw+\\)(\\)" 2 font-lock-function-name-face)
2170 ;; Fontify symbol names in #if ... defined preprocessor directives.
2172 ("\\<\\(defined\\)\\>[ \t]*(?\\(\\sw+\\)?" nil nil
2173 (1 font-lock-preprocessor-face) (2 font-lock-variable-name-face nil t)))
2175 ;; Fontify symbol names in #elif ... defined preprocessor directives.
2177 ("\\<\\(defined\\)\\>[ \t]*(?\\(\\sw+\\)?" nil nil
2178 (1 font-lock-preprocessor-face) (2 font-lock-variable-name-face nil t)))
2180 ;; Fontify otherwise as symbol names, and the preprocessor directive names.
2181 '("^\\(#[ \t]*[a-z]+\\)\\>[ \t]*\\(\\sw+\\)?"
2182 (1 font-lock-preprocessor-face) (2 font-lock-variable-name-face nil t))
2185 (setq c-font-lock-keywords-2
2186 (append c-font-lock-keywords-1
2189 ;; Simple regexps for speed.
2191 ;; Fontify all type specifiers.
2192 (cons (concat "\\<\\(" c-type-types "\\)\\>") 'font-lock-type-face)
2194 ;; Fontify all builtin keywords (except case, default and goto; see below).
2195 (cons (concat "\\<\\(" c-keywords "\\)\\>") 'font-lock-keyword-face)
2197 ;; Fontify case/goto keywords and targets, and case default/goto tags.
2198 '("\\<\\(case\\|goto\\)\\>[ \t]*\\([^ \t\n:;]+\\)?"
2199 (1 font-lock-keyword-face) (2 font-lock-reference-face nil t))
2200 '("^[ \t]*\\(\\sw+\\)[ \t]*:" 1 font-lock-reference-face)
2203 (setq c-font-lock-keywords-3
2204 (append c-font-lock-keywords-2
2206 ;; More complicated regexps for more complete highlighting for types.
2207 ;; We still have to fontify type specifiers individually, as C is so hairy.
2210 ;; Fontify all storage classes and type specifiers, plus their items.
2211 (list (concat "\\<\\(" c-type-types "\\)\\>"
2212 "\\([ \t*&]+\\sw+\\>\\)*")
2213 ;; Fontify each declaration item.
2214 '(font-lock-match-c++-style-declaration-item-and-skip-to-next
2215 ;; Start with point after all type specifiers.
2216 (goto-char (or (match-beginning 8) (match-end 1)))
2217 ;; Finish with point after first type specifier.
2218 (goto-char (match-end 1))
2219 ;; Fontify as a variable or function name.
2220 (1 (if (match-beginning 4)
2221 font-lock-function-name-face
2222 font-lock-variable-name-face))))
2224 ;; Fontify structures, or typedef names, plus their items.
2225 '("\\(}\\)[ \t*]*\\sw"
2226 (font-lock-match-c++-style-declaration-item-and-skip-to-next
2227 (goto-char (match-end 1)) nil
2228 (1 (if (match-beginning 4)
2229 font-lock-function-name-face
2230 font-lock-variable-name-face))))
2232 ;; Fontify anything at beginning of line as a declaration or definition.
2233 '("^\\(\\sw+\\)\\>\\([ \t*]+\\sw+\\>\\)*"
2234 (1 font-lock-type-face)
2235 (font-lock-match-c++-style-declaration-item-and-skip-to-next
2236 (goto-char (or (match-beginning 2) (match-end 1))) nil
2237 (1 (if (match-beginning 4)
2238 font-lock-function-name-face
2239 font-lock-variable-name-face))))
2242 (setq c++-font-lock-keywords-1
2245 ;; The list `c-font-lock-keywords-1' less that for function names.
2246 ;; the simple function form regexp has been removed. --dmoore
2247 ;;(cdr c-font-lock-keywords-1)
2248 c-font-lock-keywords-1
2250 ;; Fontify function name definitions, possibly incorporating class name.
2252 '("^\\(\\sw+\\)\\(::\\(\\sw+\\)\\)?[ \t]*("
2253 (1 (if (match-beginning 2)
2255 font-lock-function-name-face))
2256 (3 (if (match-beginning 2) font-lock-function-name-face) nil t))
2259 (setq c++-font-lock-keywords-2
2260 (append c++-font-lock-keywords-1
2263 ;; The list `c-font-lock-keywords-2' for C++ plus operator overloading.
2264 (cons (concat "\\<\\(" c++-type-types "\\)\\>") 'font-lock-type-face)
2266 ;; Fontify operator function name overloading.
2267 '("\\<\\(operator\\)\\>[ \t]*\\([][)(><!=+-][][)(><!=+-]?\\)?"
2268 (1 font-lock-keyword-face) (2 font-lock-function-name-face nil t))
2270 ;; Fontify case/goto keywords and targets, and case default/goto tags.
2271 '("\\<\\(case\\|goto\\)\\>[ \t]*\\([^ \t\n:;]+\\)?"
2272 (1 font-lock-keyword-face) (2 font-lock-reference-face nil t))
2273 '("^[ \t]*\\(\\sw+\\)[ \t]*:[^:]" 1 font-lock-reference-face)
2275 ;; Fontify other builtin keywords.
2276 (cons (concat "\\<\\(" c++-keywords "\\)\\>") 'font-lock-keyword-face)
2279 (setq c++-font-lock-keywords-3
2280 (append c++-font-lock-keywords-2
2282 ;; More complicated regexps for more complete highlighting for types.
2285 ;; Fontify all storage classes and type specifiers, plus their items.
2286 (list (concat "\\<\\(" c++-type-types "\\)\\>"
2287 "\\([ \t*&]+\\sw+\\>\\)*")
2288 ;; Fontify each declaration item.
2289 '(font-lock-match-c++-style-declaration-item-and-skip-to-next
2290 ;; Start with point after all type specifiers.
2291 (goto-char (or (match-beginning 13) (match-end 1)))
2292 ;; Finish with point after first type specifier.
2293 (goto-char (match-end 1))
2294 ;; Fontify as a variable or function name.
2295 (1 (cond ((match-beginning 2) 'font-lock-type-face)
2296 ((match-beginning 4) 'font-lock-function-name-face)
2297 (t 'font-lock-variable-name-face)))
2298 (3 (if (match-beginning 4)
2299 'font-lock-function-name-face
2300 'font-lock-variable-name-face) nil t)))
2302 ;; Fontify structures, or typedef names, plus their items.
2303 '("\\(}\\)[ \t*]*\\sw"
2304 (font-lock-match-c++-style-declaration-item-and-skip-to-next
2305 (goto-char (match-end 1)) nil
2306 (1 (if (match-beginning 4)
2307 font-lock-function-name-face
2308 font-lock-variable-name-face))))
2310 ;; Fontify anything at beginning of line as a declaration or definition.
2311 '("^\\(\\sw+\\)\\>\\([ \t*]+\\sw+\\>\\)*"
2312 (1 font-lock-type-face)
2313 (font-lock-match-c++-style-declaration-item-and-skip-to-next
2314 (goto-char (or (match-beginning 2) (match-end 1))) nil
2315 (1 (cond ((match-beginning 2) 'font-lock-type-face)
2316 ((match-beginning 4) 'font-lock-function-name-face)
2317 (t 'font-lock-variable-name-face)))
2318 (3 (if (match-beginning 4)
2319 'font-lock-function-name-face
2320 'font-lock-variable-name-face) nil t)))
2324 (defvar c-font-lock-keywords c-font-lock-keywords-1
2325 "Default expressions to highlight in C mode.")
2327 (defvar c++-font-lock-keywords c++-font-lock-keywords-1
2328 "Default expressions to highlight in C++ mode.")
2332 ;; Java support has been written by XEmacs people, and it's apparently
2333 ;; totally divergent from the FSF. I don't know if it's better or
2334 ;; worse, so I'm leaving it in until someone convinces me the FSF
2335 ;; version is better. --hniksic
2337 (defconst java-font-lock-keywords-1 nil
2338 "For consideration as a value of `java-font-lock-keywords'.
2339 This does fairly subdued highlighting.")
2341 (defconst java-font-lock-keywords-2 nil
2342 "For consideration as a value of `java-font-lock-keywords'.
2343 This adds highlighting of types and identifier names.")
2345 (defconst java-font-lock-keywords-3 nil
2346 "For consideration as a value of `java-font-lock-keywords'.
2347 This adds highlighting of Java documentation tags, such as @see.")
2349 (defvar java-font-lock-type-regexp
2350 (concat "\\<\\(boolean\\|byte\\|char\\|double\\|float\\|int"
2351 "\\|long\\|short\\|void\\)\\>")
2352 "Regexp which should match a primitive type.")
2354 (defvar java-font-lock-identifier-regexp
2355 (let ((letter "a-zA-Z_$\300-\326\330-\366\370-\377")
2357 (concat "\\<\\([" letter "][" letter digit "]*\\)\\>"))
2358 "Regexp which should match all Java identifiers.")
2360 (defvar java-font-lock-class-name-regexp
2361 (let ((capital-letter "A-Z\300-\326\330-\337")
2362 (letter "a-zA-Z_$\300-\326\330-\366\370-\377")
2364 (concat "\\<\\([" capital-letter "][" letter digit "]*\\)\\>"))
2365 "Regexp which should match a class or an interface name.
2366 The name is assumed to begin with a capital letter.")
2368 (let ((java-modifier-regexp
2369 (concat "\\<\\(abstract\\|const\\|final\\|native\\|"
2370 "private\\|protected\\|public\\|"
2371 "static\\|synchronized\\|transient\\|volatile\\)\\>")))
2373 ;; Basic font-lock support:
2374 (setq java-font-lock-keywords-1
2380 "break\\|byvalue\\|"
2381 "case\\|cast\\|catch\\|class\\|continue\\|"
2382 "do\\|else\\|extends\\|"
2383 "finally\\|for\\|future\\|"
2385 "if\\|implements\\|import\\|"
2386 "instanceof\\|interface\\|"
2387 "new\\|package\\|return\\|switch\\|"
2388 "throws?\\|try\\|while\\)\\>")
2389 1 'font-lock-keyword-face)
2392 (list java-modifier-regexp 1 font-lock-type-face)
2394 ;; Special constants:
2395 '("\\<\\(this\\|super\\)\\>" (1 font-lock-reference-face))
2396 '("\\<\\(false\\|null\\|true\\)\\>" (1 font-lock-keyword-face))
2399 (list (concat "\\<\\(class\\|interface\\)\\>\\s *"
2400 java-font-lock-identifier-regexp)
2401 2 'font-lock-function-name-face)
2403 ;; Package declarations:
2404 (list (concat "\\<\\(package\\|import\\)\\>\\s *"
2405 java-font-lock-identifier-regexp)
2406 '(2 font-lock-reference-face)
2408 "\\=\\.\\(" java-font-lock-identifier-regexp "\\)")
2409 nil nil '(1 (if (equal (char-after (match-end 0)) ?.)
2410 'font-lock-reference-face
2411 'font-lock-type-face))))
2415 "^\\s *\\(" java-modifier-regexp "\\s +\\)*"
2416 java-font-lock-class-name-regexp "\\s *\(")
2418 '(condition-case nil
2420 (goto-char (scan-sexps (- (match-end 0) 1) 1))
2421 (parse-partial-sexp (point) (point-max) nil t)
2422 (and (looking-at "\\($\\|\\<throws\\>\\|{\\)")
2423 'font-lock-function-name-face))
2424 (error 'font-lock-function-name-face))))
2427 (list (concat "\\(" java-font-lock-type-regexp "\\|"
2428 java-font-lock-class-name-regexp "\\)"
2429 "\\s *\\(\\[\\s *\\]\\s *\\)*"
2430 java-font-lock-identifier-regexp "\\s *\(")
2432 'font-lock-function-name-face)
2437 (concat "^\\s *" java-font-lock-identifier-regexp "\\s *:")
2438 '(beginning-of-line) '(end-of-line)
2439 '(1 font-lock-reference-face)))
2441 ;; `break' and continue' destination labels:
2442 (list (concat "\\<\\(break\\|continue\\)\\>\\s *"
2443 java-font-lock-identifier-regexp)
2444 2 'font-lock-reference-face)
2447 ;; In Java, any constant expression is allowed.
2448 '("\\<case\\>\\s *\\(.*\\):" 1 font-lock-reference-face)))
2450 ;; Types and declared variable names:
2451 (setq java-font-lock-keywords-2
2454 java-font-lock-keywords-1
2456 ;; Keywords followed by a type:
2457 (list (concat "\\<\\(extends\\|instanceof\\|new\\)\\>\\s *"
2458 java-font-lock-identifier-regexp)
2459 '(2 (if (equal (char-after (match-end 0)) ?.)
2460 'font-lock-reference-face 'font-lock-type-face))
2461 (list (concat "\\=\\." java-font-lock-identifier-regexp)
2462 '(goto-char (match-end 0)) nil
2463 '(1 (if (equal (char-after (match-end 0)) ?.)
2464 'font-lock-reference-face 'font-lock-type-face))))
2466 ;; Keywords followed by a type list:
2467 (list (concat "\\<\\(implements\\|throws\\)\\>\\ s*"
2468 java-font-lock-identifier-regexp)
2469 '(2 (if (equal (char-after (match-end 0)) ?.)
2470 font-lock-reference-face font-lock-type-face))
2471 (list (concat "\\=\\(\\.\\|\\s *\\(,\\)\\s *\\)"
2472 java-font-lock-identifier-regexp)
2473 '(goto-char (match-end 0)) nil
2474 '(3 (if (equal (char-after (match-end 0)) ?.)
2475 font-lock-reference-face font-lock-type-face))))
2477 ;; primitive types, can't be confused with anything else.
2478 (list java-font-lock-type-regexp
2479 '(1 font-lock-type-face)
2480 '(font-lock-match-java-declarations
2481 (goto-char (match-end 0))
2482 (goto-char (match-end 0))
2483 (0 font-lock-variable-name-face)))
2485 ;; Declarations, class types and capitalized variables:
2487 ;; Declarations are easy to recognize. Capitalized words
2488 ;; followed by a closing parenthesis are treated as casts if they
2489 ;; also are followed by an expression. Expressions beginning with
2490 ;; a unary numerical operator, e.g. +, can't be cast to an object
2493 ;; The path of a fully qualified type, e.g. java.lang.Foo, is
2494 ;; fontified in the reference face.
2496 ;; An access to a static field, e.g. System.out.println, is
2497 ;; not fontified since it can't be distinguished from the
2498 ;; usage of a capitalized variable, e.g. Foo.out.println.
2500 (list (concat java-font-lock-class-name-regexp
2501 "\\s *\\(\\[\\s *\\]\\s *\\)*"
2502 "\\(\\<\\|$\\|)\\s *\\([\(\"]\\|\\<\\)\\)")
2503 '(1 (save-match-data
2506 (match-beginning 3))
2507 (if (not (looking-at "\\<instanceof\\>"))
2508 'font-lock-type-face))))
2509 (list (concat "\\=" java-font-lock-identifier-regexp "\\.")
2511 (goto-char (match-beginning 0))
2512 (while (or (= (preceding-char) ?.)
2513 (= (char-syntax (preceding-char)) ?w))
2515 '(goto-char (match-end 0))
2516 '(1 font-lock-reference-face)
2517 '(0 nil)) ; Workaround for bug in XEmacs.
2518 '(font-lock-match-java-declarations
2519 (goto-char (match-end 1))
2520 (goto-char (match-end 0))
2521 (1 font-lock-variable-name-face))))))
2523 ;; Modifier keywords and Java doc tags
2524 (setq java-font-lock-keywords-3
2529 ;; These must come first or the Modifiers from keywords-1 will
2530 ;; catch them. We don't want to use override fontification here
2531 ;; because then these terms will be fontified within comments.
2532 ("\\<private\\>" 0 font-lock-string-face)
2533 ("\\<protected\\>" 0 font-lock-preprocessor-face)
2534 ("\\<public\\>" 0 font-lock-reference-face))
2535 java-font-lock-keywords-2
2540 '("@\\(author\\|deprecated\\|exception\\|throws\\|param\\|return\\|see\\|since\\|version\\|serial\\|serialData\\|serialField\\)\\s "
2541 0 font-lock-keyword-face t)
2543 ;; Doc tag - Parameter identifiers
2544 (list (concat "@param\\s +" java-font-lock-identifier-regexp)
2545 1 'font-lock-variable-name-face t)
2547 ;; Doc tag - Exception types
2548 (list (concat "@\\(exception\\|throws\\)\\s +"
2549 java-font-lock-identifier-regexp)
2550 '(2 (if (equal (char-after (match-end 0)) ?.)
2551 font-lock-reference-face font-lock-type-face) t)
2552 (list (concat "\\=\\." java-font-lock-identifier-regexp)
2553 '(goto-char (match-end 0)) nil
2554 '(1 (if (equal (char-after (match-end 0)) ?.)
2555 'font-lock-reference-face 'font-lock-type-face) t)))
2557 ;; Doc tag - Cross-references, usually to methods
2558 '("@see\\s +\\(\\S *[^][ \t\n\r\f(){},.;:]\\)"
2559 1 font-lock-function-name-face t)
2561 ;; Doc tag - docRoot (1.3)
2562 '("\\({ *@docRoot *}\\)"
2563 0 font-lock-keyword-face t)
2564 ;; Doc tag - beaninfo, unofficial but widely used, even by Sun
2566 0 font-lock-keyword-face t)
2568 '("{ *@link\\s +\\([^}]+\\)}"
2569 0 font-lock-keyword-face t)
2571 '("{ *@link\\s +\\(\\(\\S +\\)\\|\\(\\S +\\s +\\S +\\)\\) *}"
2572 1 font-lock-function-name-face t)
2577 (defvar java-font-lock-keywords java-font-lock-keywords-1
2578 "Additional expressions to highlight in Java mode.")
2580 ;; Match and move over any declaration/definition item after
2581 ;; point. Does not match items which look like a type declaration
2582 ;; (primitive types and class names, i.e. capitalized words.)
2583 ;; Should the variable name be followed by a comma, we reposition
2584 ;; the cursor to fontify more identifiers.
2585 (defun font-lock-match-java-declarations (limit)
2586 "Match and skip over variable definitions."
2587 (if (looking-at "\\s *\\(\\[\\s *\\]\\s *\\)*")
2588 (goto-char (match-end 0)))
2590 (looking-at java-font-lock-identifier-regexp)
2592 (not (string-match java-font-lock-type-regexp
2593 (buffer-substring (match-beginning 1)
2597 (goto-char (match-beginning 1))
2599 (concat java-font-lock-class-name-regexp
2600 "\\s *\\(\\[\\s *\\]\\s *\\)*\\<")))))
2604 (narrow-to-region (point-min) limit)
2605 (goto-char (match-end 0))
2606 ;; Note: Both `scan-sexps' and the second goto-char can
2607 ;; generate an error which is caught by the
2608 ;; `condition-case' expression.
2609 (while (not (looking-at "\\s *\\(\\(,\\)\\|;\\|$\\)"))
2610 (goto-char (or (scan-sexps (point) 1) (point-max))))
2611 (goto-char (match-end 2))) ; non-nil
2615 (defvar tex-font-lock-keywords
2616 ; ;; Regexps updated with help from Ulrik Dickow <dickow@nbi.dk>.
2617 ; '(("\\\\\\(begin\\|end\\|newcommand\\){\\([a-zA-Z0-9\\*]+\\)}"
2618 ; 2 font-lock-function-name-face)
2619 ; ("\\\\\\(cite\\|label\\|pageref\\|ref\\){\\([^} \t\n]+\\)}"
2620 ; 2 font-lock-reference-face)
2621 ; ;; It seems a bit dubious to use `bold' and `italic' faces since we might
2622 ; ;; not be able to display those fonts.
2623 ; ("{\\\\bf\\([^}]+\\)}" 1 'bold keep)
2624 ; ("{\\\\\\(em\\|it\\|sl\\)\\([^}]+\\)}" 2 'italic keep)
2625 ; ("\\\\\\([a-zA-Z@]+\\|.\\)" . font-lock-keyword-face)
2626 ; ("^[ \t\n]*\\\\def[\\\\@]\\(\\w+\\)" 1 font-lock-function-name-face keep))
2627 ;; Rewritten and extended for LaTeX2e by Ulrik Dickow <dickow@nbi.dk>.
2628 '(("\\\\\\(begin\\|end\\|newcommand\\){\\([a-zA-Z0-9\\*]+\\)}"
2629 2 font-lock-function-name-face)
2630 ("\\\\\\(cite\\|label\\|pageref\\|ref\\){\\([^} \t\n]+\\)}"
2631 2 font-lock-reference-face)
2632 ("^[ \t]*\\\\def\\\\\\(\\(\\w\\|@\\)+\\)" 1 font-lock-function-name-face)
2633 "\\\\\\([a-zA-Z@]+\\|.\\)"
2634 ;; It seems a bit dubious to use `bold' and `italic' faces since we might
2635 ;; not be able to display those fonts.
2636 ;; LaTeX2e: \emph{This is emphasized}.
2637 ("\\\\emph{\\([^}]+\\)}" 1 'italic keep)
2638 ;; LaTeX2e: \textbf{This is bold}, \textit{...}, \textsl{...}
2639 ("\\\\text\\(\\(bf\\)\\|it\\|sl\\){\\([^}]+\\)}"
2640 3 (if (match-beginning 2) 'bold 'italic) keep)
2641 ;; Old-style bf/em/it/sl. Stop at `\\' and un-escaped `&', for good tables.
2642 ("\\\\\\(\\(bf\\)\\|em\\|it\\|sl\\)\\>\\(\\([^}&\\]\\|\\\\[^\\]\\)+\\)"
2643 3 (if (match-beginning 2) 'bold 'italic) keep))
2644 "Default expressions to highlight in TeX modes.")
2646 (defconst ksh-font-lock-keywords (purecopy
2648 '("\\(^\\|[^\$\\\]\\)#.*" . font-lock-comment-face)
2649 '("\\<\\(if\\|then\\|else\\|elif\\|fi\\|case\\|esac\\|for\\|do\\|done\\|foreach\\|in\\|end\\|select\\|while\\|repeat\\|time\\|function\\|until\\|exec\\|command\\|coproc\\|noglob\\|nohup\\|nocorrect\\|source\\|autoload\\|alias\\|unalias\\|export\\|set\\|echo\\|eval\\|cd\\|log\\|compctl\\)\\>" . font-lock-keyword-face)
2650 '("\\<\\[\\[.*\\]\\]\\>" . font-lock-type-face)
2651 '("\$\(.*\)" . font-lock-type-face)
2653 "Additional expressions to highlight in ksh-mode.")
2655 (defconst sh-font-lock-keywords (purecopy
2657 '("\\(^\\|[^\$\\\]\\)#.*" . font-lock-comment-face)
2658 '("\\<\\(if\\|then\\|else\\|elif\\|fi\\|case\\|esac\\|for\\|do\\|done\\|in\\|while\\|exec\\|export\\|set\\|echo\\|eval\\|cd\\)\\>" . font-lock-keyword-face)
2659 '("\\[.*\\]" . font-lock-type-face)
2660 '("`.*`" . font-lock-type-face)
2662 "Additional expressions to highlight in sh-mode.")
2665 ;; Install ourselves:
2667 (add-hook 'find-file-hooks 'font-lock-set-defaults t)
2670 (add-minor-mode 'font-lock-mode " Font")
2672 ;; Provide ourselves:
2674 (provide 'font-lock)
2676 ;;; font-lock.el ends here
projects / chise / xemacs-chise.git.1 / blob