Proper fix for CC mode Bug#7722.
[emacs.git] / lisp / progmodes / cc-fonts.el
blobc7bb93f73e70035e2665845cbfd500c53a30f320
1 ;;; cc-fonts.el --- font lock support for CC Mode
3 ;; Copyright (C) 2002-2011 Free Software Foundation, Inc.
5 ;; Authors: 2003- Alan Mackenzie
6 ;; 2002- Martin Stjernholm
7 ;; Maintainer: bug-cc-mode@gnu.org
8 ;; Created: 07-Jan-2002
9 ;; Keywords: c languages
10 ;; Package: cc-mode
12 ;; This file is part of GNU Emacs.
14 ;; GNU Emacs is free software: you can redistribute it and/or modify
15 ;; it under the terms of the GNU General Public License as published by
16 ;; the Free Software Foundation, either version 3 of the License, or
17 ;; (at your option) any later version.
19 ;; GNU Emacs is distributed in the hope that it will be useful,
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 ;; GNU General Public License for more details.
24 ;; You should have received a copy of the GNU General Public License
25 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
27 ;;; Commentary:
29 ;; Some comments on the use of faces:
31 ;; o `c-label-face-name' is either `font-lock-constant-face' (in
32 ;; Emacs), or `font-lock-reference-face'.
34 ;; o `c-constant-face-name', `c-reference-face-name' and
35 ;; `c-doc-markup-face-name' are essentially set up like
36 ;; `c-label-face-name'.
38 ;; o `c-preprocessor-face-name' is `font-lock-preprocessor-face' in
39 ;; XEmacs and - in lack of a closer equivalent -
40 ;; `font-lock-builtin-face' or `font-lock-reference-face' in Emacs.
42 ;; o `c-doc-face-name' is `font-lock-doc-string-face' in XEmacs,
43 ;; `font-lock-doc-face' in Emacs 21 and later, or
44 ;; `font-lock-comment-face' in older Emacs (that since source
45 ;; documentation are actually comments in these languages, as opposed
46 ;; to elisp).
48 ;; TBD: We should probably provide real faces for the above uses and
49 ;; instead initialize them from the standard faces.
51 ;;; Code:
53 ;; The faces that already have been put onto the text is tested in
54 ;; various places to direct further fontifications. For this to work,
55 ;; the following assumptions regarding the faces must hold (apart from
56 ;; the dependencies on the font locking order):
58 ;; o `font-lock-comment-face' and the face in `c-doc-face-name' is
59 ;; not used in anything but comments.
60 ;; o If any face (e.g. `c-doc-markup-face-name') but those above is
61 ;; used in comments, it doesn't replace them.
62 ;; o `font-lock-string-face' is not used in anything but string
63 ;; literals (single or double quoted).
64 ;; o `font-lock-keyword-face' and the face in `c-label-face-name' are
65 ;; never overlaid with other faces.
67 (eval-when-compile
68 (let ((load-path
69 (if (and (boundp 'byte-compile-dest-file)
70 (stringp byte-compile-dest-file))
71 (cons (file-name-directory byte-compile-dest-file) load-path)
72 load-path)))
73 (load "cc-bytecomp" nil t)))
75 (cc-require 'cc-defs)
76 (cc-require-when-compile 'cc-langs)
77 (cc-require 'cc-vars)
78 (cc-require 'cc-engine)
79 (cc-require-when-compile 'cc-awk) ; Change from cc-require, 2003/6/18 to
80 ;; prevent cc-awk being loaded when it's not needed. There is now a (require
81 ;; 'cc-awk) in (defun awk-mode ..).
83 ;; Avoid repeated loading through the eval-after-load directive in
84 ;; cc-mode.el.
85 (provide 'cc-fonts)
87 (cc-external-require 'font-lock)
89 (cc-bytecomp-defvar parse-sexp-lookup-properties) ; Emacs only.
91 ;; Need to declare these local symbols during compilation since
92 ;; they're referenced from lambdas in `byte-compile' calls that are
93 ;; executed at compile time. They don't need to have the proper
94 ;; definitions, though, since the generated functions aren't called
95 ;; during compilation.
96 (cc-bytecomp-defvar c-preprocessor-face-name)
97 (cc-bytecomp-defvar c-reference-face-name)
98 (cc-bytecomp-defun c-fontify-recorded-types-and-refs)
99 (cc-bytecomp-defun c-font-lock-declarators)
100 (cc-bytecomp-defun c-font-lock-objc-method)
101 (cc-bytecomp-defun c-font-lock-invalid-string)
104 ;; Note that font-lock in XEmacs doesn't expand face names as
105 ;; variables, so we have to use the (eval . FORM) in the font lock
106 ;; matchers wherever we use these alias variables.
108 (defconst c-preprocessor-face-name
109 (cond ((c-face-name-p 'font-lock-preprocessor-face)
110 ;; XEmacs has a font-lock-preprocessor-face.
111 'font-lock-preprocessor-face)
112 ((c-face-name-p 'font-lock-builtin-face)
113 ;; In Emacs font-lock-builtin-face has traditionally been
114 ;; used for preprocessor directives.
115 'font-lock-builtin-face)
117 'font-lock-reference-face)))
119 (cc-bytecomp-defvar font-lock-constant-face)
121 (defconst c-label-face-name
122 (cond ((c-face-name-p 'font-lock-label-face)
123 ;; If it happens to occur in the future. (Well, the more
124 ;; pragmatic reason is to get unique faces for the test
125 ;; suite.)
126 'font-lock-label-face)
127 ((and (c-face-name-p 'font-lock-constant-face)
128 (eq font-lock-constant-face 'font-lock-constant-face))
129 ;; Test both if font-lock-constant-face exists and that it's
130 ;; not an alias for something else. This is important since
131 ;; we compare already set faces in various places.
132 'font-lock-constant-face)
134 'font-lock-reference-face)))
136 (defconst c-constant-face-name
137 (if (and (c-face-name-p 'font-lock-constant-face)
138 (eq font-lock-constant-face 'font-lock-constant-face))
139 ;; This doesn't exist in some earlier versions of XEmacs 21.
140 'font-lock-constant-face
141 c-label-face-name))
143 (defconst c-reference-face-name
144 (with-no-warnings
145 (if (and (c-face-name-p 'font-lock-reference-face)
146 (eq font-lock-reference-face 'font-lock-reference-face))
147 ;; This is considered obsolete in Emacs, but it still maps well
148 ;; to this use. (Another reason to do this is to get unique
149 ;; faces for the test suite.)
150 'font-lock-reference-face
151 c-label-face-name)))
153 ;; This should not mapped to a face that also is used to fontify things
154 ;; that aren't comments or string literals.
155 (defconst c-doc-face-name
156 (cond ((c-face-name-p 'font-lock-doc-string-face)
157 ;; XEmacs.
158 'font-lock-doc-string-face)
159 ((c-face-name-p 'font-lock-doc-face)
160 ;; Emacs 21 and later.
161 'font-lock-doc-face)
163 'font-lock-comment-face)))
165 (defconst c-doc-markup-face-name
166 (if (c-face-name-p 'font-lock-doc-markup-face)
167 ;; If it happens to occur in the future. (Well, the more
168 ;; pragmatic reason is to get unique faces for the test
169 ;; suite.)
170 'font-lock-doc-markup-face
171 c-label-face-name))
173 (defconst c-negation-char-face-name
174 (if (c-face-name-p 'font-lock-negation-char-face)
175 ;; Emacs 22 has a special face for negation chars.
176 'font-lock-negation-char-face))
178 (cc-bytecomp-defun face-inverse-video-p) ; Only in Emacs.
179 (cc-bytecomp-defun face-property-instance) ; Only in XEmacs.
181 (defun c-make-inverse-face (oldface newface)
182 ;; Emacs and XEmacs have completely different face manipulation
183 ;; routines. :P
184 (copy-face oldface newface)
185 (cond ((fboundp 'face-inverse-video-p)
186 ;; Emacs. This only looks at the inverse flag in the current
187 ;; frame. Other display configurations might be different,
188 ;; but it can only show if the same Emacs has frames on
189 ;; e.g. a color and a monochrome display simultaneously.
190 (unless (face-inverse-video-p oldface)
191 (invert-face newface)))
192 ((fboundp 'face-property-instance)
193 ;; XEmacs. Same pitfall here.
194 (unless (face-property-instance oldface 'reverse)
195 (invert-face newface)))))
197 (defvar c-annotation-face (make-face 'c-annotation-face)
198 "Face used to highlight annotations in java-mode and other modes that may wish to use it.")
199 (set-face-foreground 'c-annotation-face "blue")
201 (eval-and-compile
202 ;; We need the following functions during compilation since they're
203 ;; called when the `c-lang-defconst' initializers are evaluated.
204 ;; Define them at runtime too for the sake of derived modes.
206 (defmacro c-put-font-lock-face (from to face)
207 ;; Put a face on a region (overriding any existing face) in the way
208 ;; font-lock would do it. In XEmacs that means putting an
209 ;; additional font-lock property, or else the font-lock package
210 ;; won't recognize it as fontified and might override it
211 ;; incorrectly.
213 ;; This function does a hidden buffer change.
214 (if (fboundp 'font-lock-set-face)
215 ;; Note: This function has no docstring in XEmacs so it might be
216 ;; considered internal.
217 `(font-lock-set-face ,from ,to ,face)
218 `(put-text-property ,from ,to 'face ,face)))
220 (defmacro c-remove-font-lock-face (from to)
221 ;; This is the inverse of `c-put-font-lock-face'.
223 ;; This function does a hidden buffer change.
224 (if (fboundp 'font-lock-remove-face)
225 `(font-lock-remove-face ,from ,to)
226 `(remove-text-properties ,from ,to '(face nil))))
228 (defmacro c-put-font-lock-string-face (from to)
229 ;; Put `font-lock-string-face' on a string. The surrounding
230 ;; quotes are included in Emacs but not in XEmacs. The passed
231 ;; region should include them.
233 ;; This function does a hidden buffer change.
234 (if (featurep 'xemacs)
235 `(c-put-font-lock-face (1+ ,from) (1- ,to) 'font-lock-string-face)
236 `(c-put-font-lock-face ,from ,to 'font-lock-string-face)))
238 (defmacro c-fontify-types-and-refs (varlist &rest body)
239 ;; Like `let', but additionally activates `c-record-type-identifiers'
240 ;; and `c-record-ref-identifiers', and fontifies the recorded ranges
241 ;; accordingly on exit.
243 ;; This function does hidden buffer changes.
244 `(let ((c-record-type-identifiers t)
245 c-record-ref-identifiers
246 ,@varlist)
247 (prog1 (progn ,@body)
248 (c-fontify-recorded-types-and-refs))))
249 (put 'c-fontify-types-and-refs 'lisp-indent-function 1)
251 (defun c-skip-comments-and-strings (limit)
252 ;; If the point is within a region fontified as a comment or
253 ;; string literal skip to the end of it or to LIMIT, whichever
254 ;; comes first, and return t. Otherwise return nil. The match
255 ;; data is not clobbered.
257 ;; This function might do hidden buffer changes.
258 (when (c-got-face-at (point) c-literal-faces)
259 (while (progn
260 (goto-char (next-single-property-change
261 (point) 'face nil limit))
262 (and (< (point) limit)
263 (c-got-face-at (point) c-literal-faces))))
266 (defun c-make-syntactic-matcher (regexp)
267 ;; Returns a byte compiled function suitable for use in place of a
268 ;; regexp string in a `font-lock-keywords' matcher, except that
269 ;; only matches outside comments and string literals count.
271 ;; This function does not do any hidden buffer changes, but the
272 ;; generated functions will. (They are however used in places
273 ;; covered by the font-lock context.)
274 (byte-compile
275 `(lambda (limit)
276 (let (res)
277 (while (and (setq res (re-search-forward ,regexp limit t))
278 (progn
279 (goto-char (match-beginning 0))
280 (or (c-skip-comments-and-strings limit)
281 (progn
282 (goto-char (match-end 0))
283 nil)))))
284 res))))
286 (defun c-make-font-lock-search-function (regexp &rest highlights)
287 ;; This function makes a byte compiled function that works much like
288 ;; a matcher element in `font-lock-keywords'. It cuts out a little
289 ;; bit of the overhead compared to a real matcher. The main reason
290 ;; is however to pass the real search limit to the anchored
291 ;; matcher(s), since most (if not all) font-lock implementations
292 ;; arbitrarily limit anchored matchers to the same line, and also
293 ;; to insulate against various other irritating differences between
294 ;; the different (X)Emacs font-lock packages.
296 ;; REGEXP is the matcher, which must be a regexp. Only matches
297 ;; where the beginning is outside any comment or string literal are
298 ;; significant.
300 ;; HIGHLIGHTS is a list of highlight specs, just like in
301 ;; `font-lock-keywords', with these limitations: The face is always
302 ;; overridden (no big disadvantage, since hits in comments etc are
303 ;; filtered anyway), there is no "laxmatch", and an anchored matcher
304 ;; is always a form which must do all the fontification directly.
305 ;; `limit' is a variable bound to the real limit in the context of
306 ;; the anchored matcher forms.
308 ;; This function does not do any hidden buffer changes, but the
309 ;; generated functions will. (They are however used in places
310 ;; covered by the font-lock context.)
312 ;; Note: Replace `byte-compile' with `eval' to debug the generated
313 ;; lambda more easily.
314 (byte-compile
315 `(lambda (limit)
316 (let (;; The font-lock package in Emacs is known to clobber
317 ;; `parse-sexp-lookup-properties' (when it exists).
318 (parse-sexp-lookup-properties
319 (cc-eval-when-compile
320 (boundp 'parse-sexp-lookup-properties))))
321 (while (re-search-forward ,regexp limit t)
322 (unless (progn
323 (goto-char (match-beginning 0))
324 (c-skip-comments-and-strings limit))
325 (goto-char (match-end 0))
326 ,@(mapcar
327 (lambda (highlight)
328 (if (integerp (car highlight))
329 (progn
330 (unless (eq (nth 2 highlight) t)
331 (error
332 "The override flag must currently be t in %s"
333 highlight))
334 (when (nth 3 highlight)
335 (error
336 "The laxmatch flag may currently not be set in %s"
337 highlight))
338 `(save-match-data
339 (c-put-font-lock-face
340 (match-beginning ,(car highlight))
341 (match-end ,(car highlight))
342 ,(elt highlight 1))))
343 (when (nth 3 highlight)
344 (error "Match highlights currently not supported in %s"
345 highlight))
346 `(progn
347 ,(nth 1 highlight)
348 (save-match-data ,(car highlight))
349 ,(nth 2 highlight))))
350 highlights))))
351 nil)))
353 ; (eval-after-load "edebug" ; 2006-07-09: def-edebug-spec is now in subr.el.
354 ; '(progn
355 (def-edebug-spec c-fontify-types-and-refs let*)
356 (def-edebug-spec c-make-syntactic-matcher t)
357 ;; If there are literal quoted or backquoted highlight specs in
358 ;; the call to `c-make-font-lock-search-function' then let's
359 ;; instrument the forms in them.
360 (def-edebug-spec c-make-font-lock-search-function
361 (form &rest &or ("quote" (&rest form)) ("`" (&rest form)) form)));))
363 (defun c-fontify-recorded-types-and-refs ()
364 ;; Convert the ranges recorded on `c-record-type-identifiers' and
365 ;; `c-record-ref-identifiers' to fontification.
367 ;; This function does hidden buffer changes.
368 (let (elem)
369 (while (consp c-record-type-identifiers)
370 (setq elem (car c-record-type-identifiers)
371 c-record-type-identifiers (cdr c-record-type-identifiers))
372 (c-put-font-lock-face (car elem) (cdr elem)
373 'font-lock-type-face))
374 (while c-record-ref-identifiers
375 (setq elem (car c-record-ref-identifiers)
376 c-record-ref-identifiers (cdr c-record-ref-identifiers))
377 ;; Note that the reference face is a variable that is
378 ;; dereferenced, since it's an alias in Emacs.
379 (c-put-font-lock-face (car elem) (cdr elem)
380 c-reference-face-name))))
382 (c-lang-defconst c-cpp-matchers
383 "Font lock matchers for preprocessor directives and purely lexical
384 stuff. Used on level 1 and higher."
386 ;; Note: `c-font-lock-declarations' assumes that no matcher here
387 ;; sets `font-lock-type-face' in languages where
388 ;; `c-recognize-<>-arglists' is set.
390 t `(,@(when (c-lang-const c-opt-cpp-prefix)
391 (let* ((noncontinued-line-end "\\(\\=\\|\\(\\=\\|[^\\]\\)[\n\r]\\)")
392 (ncle-depth (regexp-opt-depth noncontinued-line-end))
393 (sws-depth (c-lang-const c-syntactic-ws-depth))
394 (nsws-depth (c-lang-const c-nonempty-syntactic-ws-depth)))
396 `(;; The stuff after #error and #warning is a message, so
397 ;; fontify it as a string.
398 ,@(when (c-lang-const c-cpp-message-directives)
399 (let* ((re (c-make-keywords-re 'appendable ; nil
400 (c-lang-const c-cpp-message-directives)))
401 (re-depth (regexp-opt-depth re)))
402 `((,(concat noncontinued-line-end
403 (c-lang-const c-opt-cpp-prefix)
405 "\\s +\\(.*\\)$")
406 ,(+ ncle-depth re-depth 1) font-lock-string-face t))))
408 ;; Fontify filenames in #include <...> as strings.
409 ,@(when (c-lang-const c-cpp-include-directives)
410 (let* ((re (c-make-keywords-re nil
411 (c-lang-const c-cpp-include-directives)))
412 (re-depth (regexp-opt-depth re)))
413 `((,(concat noncontinued-line-end
414 (c-lang-const c-opt-cpp-prefix)
416 (c-lang-const c-syntactic-ws)
417 "\\(<[^>\n\r]*>?\\)")
418 (,(+ ncle-depth re-depth sws-depth 1)
419 font-lock-string-face)
421 ;; Use an anchored matcher to put paren syntax
422 ;; on the brackets.
423 (,(byte-compile
424 `(lambda (limit)
425 (let ((beg (match-beginning
426 ,(+ ncle-depth re-depth sws-depth 1)))
427 (end (1- (match-end ,(+ ncle-depth re-depth
428 sws-depth 1)))))
429 (if (eq (char-after end) ?>)
430 (progn
431 (c-mark-<-as-paren beg)
432 (c-mark->-as-paren end))
433 ;; (c-clear-char-property beg 'syntax-table)
434 (c-clear-char-property beg 'category)))
435 nil)))))))
437 ;; #define.
438 ,@(when (c-lang-const c-opt-cpp-macro-define)
439 `((,(c-make-font-lock-search-function
440 (concat
441 noncontinued-line-end
442 (c-lang-const c-opt-cpp-prefix)
443 (c-lang-const c-opt-cpp-macro-define)
444 (c-lang-const c-nonempty-syntactic-ws)
445 "\\(" (c-lang-const ; 1 + ncle + nsws
446 c-symbol-key) "\\)"
447 (concat "\\(" ; 2 + ncle + nsws + c-sym-key
448 ;; Macro with arguments - a "function".
449 "\\(\(\\)" ; 3 + ncle + nsws + c-sym-key
450 "\\|"
451 ;; Macro without arguments - a "variable".
452 "\\([^\(]\\|$\\)"
453 "\\)"))
454 `((if (match-beginning
455 ,(+ 3 ncle-depth nsws-depth
456 (c-lang-const c-symbol-key-depth)))
458 ;; "Function". Fontify the name and the arguments.
459 (save-restriction
460 (c-put-font-lock-face
461 (match-beginning ,(+ 1 ncle-depth nsws-depth))
462 (match-end ,(+ 1 ncle-depth nsws-depth))
463 'font-lock-function-name-face)
464 (goto-char
465 (match-end
466 ,(+ 3 ncle-depth nsws-depth
467 (c-lang-const c-symbol-key-depth))))
469 (narrow-to-region (point-min) limit)
470 (while (and
471 (progn
472 (c-forward-syntactic-ws)
473 (looking-at c-symbol-key))
474 (progn
475 (c-put-font-lock-face
476 (match-beginning 0) (match-end 0)
477 'font-lock-variable-name-face)
478 (goto-char (match-end 0))
479 (c-forward-syntactic-ws)
480 (eq (char-after) ?,)))
481 (forward-char)))
483 ;; "Variable".
484 (c-put-font-lock-face
485 (match-beginning ,(+ 1 ncle-depth nsws-depth))
486 (match-end ,(+ 1 ncle-depth nsws-depth))
487 'font-lock-variable-name-face)))))))
489 ;; Fontify cpp function names in preprocessor
490 ;; expressions in #if and #elif.
491 ,@(when (and (c-lang-const c-cpp-expr-directives)
492 (c-lang-const c-cpp-expr-functions))
493 (let ((ced-re (c-make-keywords-re t
494 (c-lang-const c-cpp-expr-directives)))
495 (cef-re (c-make-keywords-re t
496 (c-lang-const c-cpp-expr-functions))))
497 `((,(c-make-font-lock-search-function
498 (concat noncontinued-line-end
499 (c-lang-const c-opt-cpp-prefix)
500 ced-re ; 1 + ncle-depth
501 ;; Match the whole logical line to look
502 ;; for the functions in.
503 "\\(\\\\\\(.\\|[\n\r]\\)\\|[^\n\r]\\)*")
504 `((let ((limit (match-end 0)))
505 (while (re-search-forward ,cef-re limit 'move)
506 (c-put-font-lock-face (match-beginning 1)
507 (match-end 1)
508 c-preprocessor-face-name)))
509 (goto-char (match-end ,(1+ ncle-depth)))))))))
511 ;; Fontify the directive names.
512 (,(c-make-font-lock-search-function
513 (concat noncontinued-line-end
514 "\\("
515 (c-lang-const c-opt-cpp-prefix)
516 "[" (c-lang-const c-symbol-chars) "]+"
517 "\\)")
518 `(,(1+ ncle-depth) c-preprocessor-face-name t)))
520 (eval . (list ,(c-make-syntactic-matcher
521 (concat noncontinued-line-end
522 (c-lang-const c-opt-cpp-prefix)
523 "if\\(n\\)def\\>"))
524 ,(+ ncle-depth 1)
525 c-negation-char-face-name
526 'append))
529 ,@(when (c-major-mode-is 'pike-mode)
530 ;; Recognize hashbangs in Pike.
531 `((eval . (list "\\`#![^\n\r]*"
532 0 c-preprocessor-face-name))))
534 ;; Make hard spaces visible through an inverted `font-lock-warning-face'.
535 (eval . (list
536 "\240"
537 0 (progn
538 (unless (c-face-name-p 'c-nonbreakable-space-face)
539 (c-make-inverse-face 'font-lock-warning-face
540 'c-nonbreakable-space-face))
541 ''c-nonbreakable-space-face)))
544 (defun c-font-lock-invalid-string ()
545 ;; Assuming the point is after the opening character of a string,
546 ;; fontify that char with `font-lock-warning-face' if the string
547 ;; decidedly isn't terminated properly.
549 ;; This function does hidden buffer changes.
550 (let ((start (1- (point))))
551 (save-excursion
552 (and (eq (elt (parse-partial-sexp start (c-point 'eol)) 8) start)
553 (if (integerp c-multiline-string-start-char)
554 ;; There's no multiline string start char before the
555 ;; string, so newlines aren't allowed.
556 (not (eq (char-before start) c-multiline-string-start-char))
557 ;; Multiline strings are allowed anywhere if
558 ;; c-multiline-string-start-char is t.
559 (not c-multiline-string-start-char))
560 (if c-string-escaped-newlines
561 ;; There's no \ before the newline.
562 (not (eq (char-before (point)) ?\\))
563 ;; Escaped newlines aren't supported.
565 (c-put-font-lock-face start (1+ start) 'font-lock-warning-face)))))
567 (c-lang-defconst c-basic-matchers-before
568 "Font lock matchers for basic keywords, labels, references and various
569 other easily recognizable things that should be fontified before generic
570 casts and declarations are fontified. Used on level 2 and higher."
572 ;; Note: `c-font-lock-declarations' assumes that no matcher here
573 ;; sets `font-lock-type-face' in languages where
574 ;; `c-recognize-<>-arglists' is set.
576 t `(;; Put a warning face on the opener of unclosed strings that
577 ;; can't span lines. Later font
578 ;; lock packages have a `font-lock-syntactic-face-function' for
579 ;; this, but it doesn't give the control we want since any
580 ;; fontification done inside the function will be
581 ;; unconditionally overridden.
582 ,(c-make-font-lock-search-function
583 ;; Match a char before the string starter to make
584 ;; `c-skip-comments-and-strings' work correctly.
585 (concat ".\\(" c-string-limit-regexp "\\)")
586 '((c-font-lock-invalid-string)))
588 ;; Fontify keyword constants.
589 ,@(when (c-lang-const c-constant-kwds)
590 (let ((re (c-make-keywords-re nil (c-lang-const c-constant-kwds))))
591 (if (c-major-mode-is 'pike-mode)
592 ;; No symbol is a keyword after "->" in Pike.
593 `((eval . (list ,(concat "\\(\\=.?\\|[^>]\\|[^-]>\\)"
594 "\\<\\(" re "\\)\\>")
595 2 c-constant-face-name)))
596 `((eval . (list ,(concat "\\<\\(" re "\\)\\>")
597 1 c-constant-face-name))))))
599 ;; Fontify all keywords except the primitive types.
600 ,(if (c-major-mode-is 'pike-mode)
601 ;; No symbol is a keyword after "->" in Pike.
602 `(,(concat "\\(\\=.?\\|[^>]\\|[^-]>\\)"
603 "\\<" (c-lang-const c-regular-keywords-regexp))
604 2 font-lock-keyword-face)
605 `(,(concat "\\<" (c-lang-const c-regular-keywords-regexp))
606 1 font-lock-keyword-face))
608 ;; Fontify leading identifiers in fully qualified names like
609 ;; "foo::bar" in languages that supports such things.
610 ,@(when (c-lang-const c-opt-identifier-concat-key)
611 (if (c-major-mode-is 'java-mode)
612 ;; Java needs special treatment since "." is used both to
613 ;; qualify names and in normal indexing. Here we look for
614 ;; capital characters at the beginning of an identifier to
615 ;; recognize the class. "*" is also recognized to cover
616 ;; wildcard import declarations. All preceding dot separated
617 ;; identifiers are taken as package names and therefore
618 ;; fontified as references.
619 `(,(c-make-font-lock-search-function
620 ;; Search for class identifiers preceded by ".". The
621 ;; anchored matcher takes it from there.
622 (concat (c-lang-const c-opt-identifier-concat-key)
623 (c-lang-const c-simple-ws) "*"
624 (concat "\\("
625 "[" c-upper "]"
626 "[" (c-lang-const c-symbol-chars) "]*"
627 "\\|"
628 "\\*"
629 "\\)"))
630 `((let (id-end)
631 (goto-char (1+ (match-beginning 0)))
632 (while (and (eq (char-before) ?.)
633 (progn
634 (backward-char)
635 (c-backward-syntactic-ws)
636 (setq id-end (point))
637 (< (skip-chars-backward
638 ,(c-lang-const c-symbol-chars)) 0))
639 (not (get-text-property (point) 'face)))
640 (c-put-font-lock-face (point) id-end
641 c-reference-face-name)
642 (c-backward-syntactic-ws)))
644 (goto-char (match-end 0)))))
646 `((,(byte-compile
647 ;; Must use a function here since we match longer than
648 ;; we want to move before doing a new search. This is
649 ;; not necessary for XEmacs since it restarts the
650 ;; search from the end of the first highlighted
651 ;; submatch (something that causes problems in other
652 ;; places).
653 `(lambda (limit)
654 (while (re-search-forward
655 ,(concat "\\(\\<" ; 1
656 "\\(" (c-lang-const c-symbol-key) "\\)" ; 2
657 (c-lang-const c-simple-ws) "*"
658 (c-lang-const c-opt-identifier-concat-key)
659 (c-lang-const c-simple-ws) "*"
660 "\\)"
661 "\\("
662 (c-lang-const c-opt-after-id-concat-key)
663 "\\)")
664 limit t)
665 (unless (progn
666 (goto-char (match-beginning 0))
667 (c-skip-comments-and-strings limit))
668 (or (get-text-property (match-beginning 2) 'face)
669 (c-put-font-lock-face (match-beginning 2)
670 (match-end 2)
671 c-reference-face-name))
672 (goto-char (match-end 1))))))))))
674 ;; Fontify the special declarations in Objective-C.
675 ,@(when (c-major-mode-is 'objc-mode)
676 `(;; Fontify class names in the beginning of message expressions.
677 ,(c-make-font-lock-search-function
678 "\\["
679 '((c-fontify-types-and-refs ()
680 (c-forward-syntactic-ws limit)
681 (let ((start (point)))
682 ;; In this case we accept both primitive and known types.
683 (when (eq (c-forward-type) 'known)
684 (goto-char start)
685 (let ((c-promote-possible-types t))
686 (c-forward-type))))
687 (if (> (point) limit) (goto-char limit)))))
689 ;; The @interface/@implementation/@protocol directives.
690 ,(c-make-font-lock-search-function
691 (concat "\\<"
692 (regexp-opt
693 '("@interface" "@implementation" "@protocol")
695 "\\>")
696 '((c-fontify-types-and-refs
697 (;; The font-lock package in Emacs is known to clobber
698 ;; `parse-sexp-lookup-properties' (when it exists).
699 (parse-sexp-lookup-properties
700 (cc-eval-when-compile
701 (boundp 'parse-sexp-lookup-properties))))
702 (c-forward-objc-directive)
703 nil)
704 (goto-char (match-beginning 0))))))
706 (eval . (list "\\(!\\)[^=]" 1 c-negation-char-face-name))
709 (defun c-font-lock-complex-decl-prepare (limit)
710 ;; This function will be called from font-lock for a region bounded by POINT
711 ;; and LIMIT, as though it were to identify a keyword for
712 ;; font-lock-keyword-face. It always returns NIL to inhibit this and
713 ;; prevent a repeat invocation. See elisp/lispref page "Search-based
714 ;; Fontification".
716 ;; Called before any of the matchers in `c-complex-decl-matchers'.
718 ;; This function does hidden buffer changes.
720 ;;(message "c-font-lock-complex-decl-prepare %s %s" (point) limit)
722 ;; Clear the list of found types if we start from the start of the
723 ;; buffer, to make it easier to get rid of misspelled types and
724 ;; variables that have gotten recognized as types in malformed code.
725 (when (bobp)
726 (c-clear-found-types))
728 ;; Clear the c-type char properties which mark the region, to recalculate
729 ;; them properly. The most interesting properties are those put on the
730 ;; closest token before the region.
731 (save-excursion
732 (let ((pos (point)))
733 (c-backward-syntactic-ws)
734 (c-clear-char-properties
735 (if (and (not (bobp))
736 (memq (c-get-char-property (1- (point)) 'c-type)
737 '(c-decl-arg-start
738 c-decl-end
739 c-decl-id-start
740 c-decl-type-start)))
741 (1- (point))
742 pos)
743 limit 'c-type)))
745 ;; Update `c-state-cache' to the beginning of the region. This will
746 ;; make `c-beginning-of-syntax' go faster when it's used later on,
747 ;; and it's near the point most of the time.
748 (c-parse-state)
750 ;; Check if the fontified region starts inside a declarator list so
751 ;; that `c-font-lock-declarators' should be called at the start.
752 ;; The declared identifiers are font-locked correctly as types, if
753 ;; that is what they are.
754 (let ((prop (save-excursion
755 (c-backward-syntactic-ws)
756 (unless (bobp)
757 (c-get-char-property (1- (point)) 'c-type)))))
758 (when (memq prop '(c-decl-id-start c-decl-type-start))
759 (c-forward-syntactic-ws limit)
760 (c-font-lock-declarators limit t (eq prop 'c-decl-type-start))))
762 nil)
764 (defun c-font-lock-<>-arglists (limit)
765 ;; This function will be called from font-lock for a region bounded by POINT
766 ;; and LIMIT, as though it were to identify a keyword for
767 ;; font-lock-keyword-face. It always returns NIL to inhibit this and
768 ;; prevent a repeat invocation. See elisp/lispref page "Search-based
769 ;; Fontification".
771 ;; Fontify types and references in names containing angle bracket
772 ;; arglists from the point to LIMIT. Note that
773 ;; `c-font-lock-declarations' already has handled many of them.
775 ;; This function might do hidden buffer changes.
777 (let (;; The font-lock package in Emacs is known to clobber
778 ;; `parse-sexp-lookup-properties' (when it exists).
779 (parse-sexp-lookup-properties
780 (cc-eval-when-compile
781 (boundp 'parse-sexp-lookup-properties)))
782 (c-parse-and-markup-<>-arglists t)
783 c-restricted-<>-arglists
784 id-start id-end id-face pos kwd-sym)
786 (while (and (< (point) limit)
787 (re-search-forward c-opt-<>-arglist-start limit t))
789 (setq id-start (match-beginning 1)
790 id-end (match-end 1)
791 pos (point))
793 (goto-char id-start)
794 (unless (c-skip-comments-and-strings limit)
795 (setq kwd-sym nil
796 c-restricted-<>-arglists nil
797 id-face (get-text-property id-start 'face))
799 (if (cond
800 ((eq id-face 'font-lock-type-face)
801 ;; The identifier got the type face so it has already been
802 ;; handled in `c-font-lock-declarations'.
803 nil)
805 ((eq id-face 'font-lock-keyword-face)
806 (when (looking-at c-opt-<>-sexp-key)
807 ;; There's a special keyword before the "<" that tells
808 ;; that it's an angle bracket arglist.
809 (setq kwd-sym (c-keyword-sym (match-string 1)))))
812 ;; There's a normal identifier before the "<". If we're not in
813 ;; a declaration context then we set `c-restricted-<>-arglists'
814 ;; to avoid recognizing templates in function calls like "foo (a
815 ;; < b, c > d)".
816 (c-backward-syntactic-ws)
817 (when (and (memq (char-before) '(?\( ?,))
818 (not (eq (get-text-property (1- (point)) 'c-type)
819 'c-decl-arg-start)))
820 (setq c-restricted-<>-arglists t))
823 (progn
824 (goto-char (1- pos))
825 ;; Check for comment/string both at the identifier and
826 ;; at the "<".
827 (unless (c-skip-comments-and-strings limit)
829 (c-fontify-types-and-refs ()
830 (when (c-forward-<>-arglist (c-keyword-member
831 kwd-sym 'c-<>-type-kwds))
832 (when (and c-opt-identifier-concat-key
833 (not (get-text-property id-start 'face)))
834 (c-forward-syntactic-ws)
835 (if (looking-at c-opt-identifier-concat-key)
836 (c-put-font-lock-face id-start id-end
837 c-reference-face-name)
838 (c-put-font-lock-face id-start id-end
839 'font-lock-type-face)))))
841 (goto-char pos)))
842 (goto-char pos)))))
843 nil)
845 (defun c-font-lock-declarators (limit list types)
846 ;; Assuming the point is at the start of a declarator in a declaration,
847 ;; fontify the identifier it declares. (If TYPES is set, it does this via
848 ;; the macro `c-fontify-types-and-refs'.)
850 ;; If LIST is non-nil, also fontify the ids in any following declarators in
851 ;; a comma separated list (e.g. "foo" and "*bar" in "int foo = 17, *bar;");
852 ;; additionally, mark the commas with c-type property 'c-decl-id-start or
853 ;; 'c-decl-type-start (according to TYPES). Stop at LIMIT.
855 ;; If TYPES is non-nil, fontify all identifiers as types.
857 ;; Nil is always returned. The function leaves point at the delimiter after
858 ;; the last declarator it processes.
860 ;; This function might do hidden buffer changes.
862 ;;(message "c-font-lock-declarators from %s to %s" (point) limit)
863 (c-fontify-types-and-refs
864 ((pos (point)) next-pos id-start id-end
865 paren-depth
866 id-face got-init
867 c-last-identifier-range
868 (separator-prop (if types 'c-decl-type-start 'c-decl-id-start)))
870 ;; The following `while' fontifies a single declarator id each time round.
871 ;; It loops only when LIST is non-nil.
872 (while
873 ;; Inside the following "condition form", we move forward over the
874 ;; declarator's identifier up as far as any opening bracket (for array
875 ;; size) or paren (for parameters of function-type) or brace (for
876 ;; array/struct initialisation) or "=" or terminating delimiter
877 ;; (e.g. "," or ";" or "}").
878 (and
880 (< (point) limit)
882 ;; The following form moves forward over the declarator's
883 ;; identifier (and what precedes it), returning t. If there
884 ;; wasn't one, it returns nil, terminating the `while'.
885 (let (got-identifier)
886 (setq paren-depth 0)
887 ;; Skip over type decl prefix operators, one for each iteration
888 ;; of the while. These are, e.g. "*" in "int *foo" or "(" and
889 ;; "*" in "int (*foo) (void)" (Note similar code in
890 ;; `c-forward-decl-or-cast-1'.)
891 (while (and (looking-at c-type-decl-prefix-key)
892 (if (and (c-major-mode-is 'c++-mode)
893 (match-beginning 3))
894 ;; If the third submatch matches in C++ then
895 ;; we're looking at an identifier that's a
896 ;; prefix only if it specifies a member pointer.
897 (progn
898 (setq id-start (point))
899 (c-forward-name)
900 (if (looking-at "\\(::\\)")
901 ;; We only check for a trailing "::" and
902 ;; let the "*" that should follow be
903 ;; matched in the next round.
905 ;; It turned out to be the real identifier,
906 ;; so flag that and stop.
907 (setq got-identifier t)
908 nil))
910 (if (eq (char-after) ?\()
911 (progn
912 (setq paren-depth (1+ paren-depth))
913 (forward-char))
914 (goto-char (match-end 1)))
915 (c-forward-syntactic-ws))
917 ;; If we haven't passed the identifier already, do it now.
918 (unless got-identifier
919 (setq id-start (point))
920 (c-forward-name))
921 (setq id-end (point))
923 (/= id-end pos))
925 ;; Skip out of the parens surrounding the identifier. If closing
926 ;; parens are missing, this form returns nil.
927 (or (= paren-depth 0)
928 (c-safe (goto-char (scan-lists (point) 1 paren-depth))))
930 (<= (point) limit)
932 ;; Skip over any trailing bit, such as "__attribute__".
933 (progn
934 (when (looking-at c-decl-hangon-key)
935 (c-forward-keyword-clause 1))
936 (<= (point) limit))
938 ;; Search syntactically to the end of the declarator (";",
939 ;; ",", a closen paren, eob etc) or to the beginning of an
940 ;; initializer or function prototype ("=" or "\\s\(").
941 ;; Note that the open paren will match array specs in
942 ;; square brackets, and we treat them as initializers too.
943 (c-syntactic-re-search-forward
944 "[;,]\\|\\s)\\|\\'\\|\\(=\\|\\s(\\)" limit t t))
946 (setq next-pos (match-beginning 0)
947 id-face (if (and (eq (char-after next-pos) ?\()
948 (let (c-last-identifier-range)
949 (save-excursion
950 (goto-char next-pos)
951 (c-at-toplevel-p))))
952 'font-lock-function-name-face
953 'font-lock-variable-name-face)
954 got-init (and (match-beginning 1)
955 (char-after (match-beginning 1))))
957 (if types
958 ;; Register and fontify the identifer as a type.
959 (let ((c-promote-possible-types t))
960 (goto-char id-start)
961 (c-forward-type))
962 ;; Fontify the last symbol in the identifier if it isn't fontified
963 ;; already. The check is necessary only in certain cases where this
964 ;; function is used "sloppily", e.g. in `c-simple-decl-matchers'.
965 (when (and c-last-identifier-range
966 (not (get-text-property (car c-last-identifier-range)
967 'face)))
968 (c-put-font-lock-face (car c-last-identifier-range)
969 (cdr c-last-identifier-range)
970 id-face)))
972 (goto-char next-pos)
973 (setq pos nil) ; So as to terminate the enclosing `while' form.
974 (when list
975 ;; Jump past any initializer or function prototype to see if
976 ;; there's a ',' to continue at.
978 (cond ((eq id-face 'font-lock-function-name-face)
979 ;; Skip a parenthesized initializer (C++) or a function
980 ;; prototype.
981 (if (c-safe (c-forward-sexp 1) t) ; over the parameter list.
982 (c-forward-syntactic-ws limit)
983 (goto-char limit))) ; unbalanced parens
985 (got-init ; "=" sign OR opening "(", "[", or "{"
986 ;; Skip an initializer expression. If we're at a '='
987 ;; then accept a brace list directly after it to cope
988 ;; with array initializers. Otherwise stop at braces
989 ;; to avoid going past full function and class blocks.
990 (and (if (and (eq got-init ?=)
991 (= (c-forward-token-2 1 nil limit) 0)
992 (looking-at "{"))
993 (c-safe (c-forward-sexp) t) ; over { .... }
995 ;; FIXME: Should look for c-decl-end markers here;
996 ;; we might go far into the following declarations
997 ;; in e.g. ObjC mode (see e.g. methods-4.m).
998 (c-syntactic-re-search-forward "[;,{]" limit 'move t)
999 (backward-char)))
1001 (t (c-forward-syntactic-ws limit)))
1003 ;; If a ',' is found we set pos to the next declarator and iterate.
1004 (when (and (< (point) limit) (looking-at ","))
1005 (c-put-char-property (point) 'c-type separator-prop)
1006 (forward-char)
1007 (c-forward-syntactic-ws limit)
1008 (setq pos (point)))))) ; acts to make the `while' form continue.
1009 nil)
1011 (defconst c-font-lock-maybe-decl-faces
1012 ;; List of faces that might be put at the start of a type when
1013 ;; `c-font-lock-declarations' runs. This needs to be evaluated to
1014 ;; ensure that face name aliases in Emacs are resolved.
1015 (list nil
1016 font-lock-type-face
1017 c-reference-face-name
1018 font-lock-keyword-face))
1020 (defun c-font-lock-declarations (limit)
1021 ;; Fontify all the declarations, casts and labels from the point to LIMIT.
1022 ;; Assumes that strings and comments have been fontified already.
1024 ;; This function will be called from font-lock for a region bounded by POINT
1025 ;; and LIMIT, as though it were to identify a keyword for
1026 ;; font-lock-keyword-face. It always returns NIL to inhibit this and
1027 ;; prevent a repeat invocation. See elisp/lispref page "Search-based
1028 ;; Fontification".
1030 ;; This function might do hidden buffer changes.
1032 ;;(message "c-font-lock-declarations search from %s to %s" (point) limit)
1034 (save-restriction
1035 (let (;; The position where `c-find-decl-spots' last stopped.
1036 start-pos
1037 ;; o - 'decl if we're in an arglist containing declarations
1038 ;; (but if `c-recognize-paren-inits' is set it might also be
1039 ;; an initializer arglist);
1040 ;; o - '<> if the arglist is of angle bracket type;
1041 ;; o - 'arglist if it's some other arglist;
1042 ;; o - nil, if not in an arglist at all. This includes the
1043 ;; parenthesised condition which follows "if", "while", etc.
1044 context
1045 ;; The position of the next token after the closing paren of
1046 ;; the last detected cast.
1047 last-cast-end
1048 ;; Start of containing declaration (if any); limit for searching
1049 ;; backwards for it.
1050 decl-start decl-search-lim
1051 ;; Start of containing declaration (if any); limit for searching
1052 ;; backwards for it.
1053 decl-start decl-search-lim
1054 ;; The result from `c-forward-decl-or-cast-1'.
1055 decl-or-cast
1056 ;; The maximum of the end positions of all the checked type
1057 ;; decl expressions in the successfully identified
1058 ;; declarations. The position might be either before or
1059 ;; after the syntactic whitespace following the last token
1060 ;; in the type decl expression.
1061 (max-type-decl-end 0)
1062 ;; Same as `max-type-decl-*', but used when we're before
1063 ;; `token-pos'.
1064 (max-type-decl-end-before-token 0)
1065 ;; Set according to the context to direct the heuristics for
1066 ;; recognizing C++ templates.
1067 c-restricted-<>-arglists
1068 ;; Turn on recording of identifier ranges in
1069 ;; `c-forward-decl-or-cast-1' and `c-forward-label' for
1070 ;; later fontification.
1071 (c-record-type-identifiers t)
1072 label-type
1073 c-record-ref-identifiers
1074 ;; Make `c-forward-type' calls mark up template arglists if
1075 ;; it finds any. That's necessary so that we later will
1076 ;; stop inside them to fontify types there.
1077 (c-parse-and-markup-<>-arglists t)
1078 ;; The font-lock package in Emacs is known to clobber
1079 ;; `parse-sexp-lookup-properties' (when it exists).
1080 (parse-sexp-lookup-properties
1081 (cc-eval-when-compile
1082 (boundp 'parse-sexp-lookup-properties))))
1084 ;; Below we fontify a whole declaration even when it crosses the limit,
1085 ;; to avoid gaps when jit/lazy-lock fontifies the file a block at a
1086 ;; time. That is however annoying during editing, e.g. the following is
1087 ;; a common situation while the first line is being written:
1089 ;; my_variable
1090 ;; some_other_variable = 0;
1092 ;; font-lock will put the limit at the beginning of the second line
1093 ;; here, and if we go past it we'll fontify "my_variable" as a type and
1094 ;; "some_other_variable" as an identifier, and the latter will not
1095 ;; correct itself until the second line is changed. To avoid that we
1096 ;; narrow to the limit if the region to fontify is a single line.
1097 (if (<= limit (c-point 'bonl))
1098 (narrow-to-region
1099 (point-min)
1100 (save-excursion
1101 ;; Narrow after any operator chars following the limit though,
1102 ;; since those characters can be useful in recognizing a
1103 ;; declaration (in particular the '{' that opens a function body
1104 ;; after the header).
1105 (goto-char limit)
1106 (skip-chars-forward c-nonsymbol-chars)
1107 (point))))
1109 (c-find-decl-spots
1110 limit
1111 c-decl-start-re
1112 c-font-lock-maybe-decl-faces
1114 (lambda (match-pos inside-macro)
1115 (setq start-pos (point))
1116 (when
1117 ;; The result of the form below is true when we don't recognize a
1118 ;; declaration or cast.
1119 (if (and (eq (get-text-property (point) 'face)
1120 'font-lock-keyword-face)
1121 (looking-at c-not-decl-init-keywords))
1122 ;; Don't do anything more if we're looking at a keyword that
1123 ;; can't start a declaration.
1126 ;; Set `context' and `c-restricted-<>-arglists'. Look for
1127 ;; "<" for the sake of C++-style template arglists.
1128 ;; Ignore "(" when it's part of a control flow construct
1129 ;; (e.g. "for (").
1130 (let ((type (and (> match-pos (point-min))
1131 (c-get-char-property (1- match-pos) 'c-type))))
1132 (cond ((not (memq (char-before match-pos) '(?\( ?, ?\[ ?<)))
1133 (setq context nil
1134 c-restricted-<>-arglists nil))
1135 ;; A control flow expression
1136 ((and (eq (char-before match-pos) ?\()
1137 (save-excursion
1138 (goto-char match-pos)
1139 (backward-char)
1140 (c-backward-token-2)
1141 (looking-at c-block-stmt-2-key)))
1142 (setq context nil
1143 c-restricted-<>-arglists t))
1144 ;; Near BOB.
1145 ((<= match-pos (point-min))
1146 (setq context 'arglist
1147 c-restricted-<>-arglists t))
1148 ;; Got a cached hit in a declaration arglist.
1149 ((eq type 'c-decl-arg-start)
1150 (setq context 'decl
1151 c-restricted-<>-arglists nil))
1152 ;; Inside an angle bracket arglist.
1153 ((or (eq type 'c-<>-arg-sep)
1154 (eq (char-before match-pos) ?<))
1155 (setq context '<>
1156 c-restricted-<>-arglists nil))
1157 ;; Got a cached hit in some other type of arglist.
1158 (type
1159 (setq context 'arglist
1160 c-restricted-<>-arglists t))
1161 ((if inside-macro
1162 (< match-pos max-type-decl-end-before-token)
1163 (< match-pos max-type-decl-end))
1164 ;; The point is within the range of a previously
1165 ;; encountered type decl expression, so the arglist
1166 ;; is probably one that contains declarations.
1167 ;; However, if `c-recognize-paren-inits' is set it
1168 ;; might also be an initializer arglist.
1169 (setq context 'decl
1170 c-restricted-<>-arglists nil)
1171 ;; The result of this check is cached with a char
1172 ;; property on the match token, so that we can look
1173 ;; it up again when refontifying single lines in a
1174 ;; multiline declaration.
1175 (c-put-char-property (1- match-pos)
1176 'c-type 'c-decl-arg-start))
1177 (t (setq context 'arglist
1178 c-restricted-<>-arglists t))))
1180 ;; Check we haven't missed a preceding "typedef".
1181 (when (not (looking-at c-typedef-key))
1182 (c-backward-syntactic-ws)
1183 (c-backward-token-2)
1184 (or (looking-at c-typedef-key)
1185 (goto-char start-pos)))
1187 ;; Now analyze the construct.
1188 (setq decl-or-cast (c-forward-decl-or-cast-1
1189 match-pos context last-cast-end))
1191 (if (not decl-or-cast)
1192 ;; Are we at a declarator? Try to go back to the declaration
1193 ;; to check this. Note that `c-beginning-of-decl-1' is slow,
1194 ;; so we cache its result between calls.
1195 (let (paren-state bod-res encl-pos is-typedef)
1196 (goto-char start-pos)
1197 (save-excursion
1198 (unless (and decl-search-lim
1199 (eq decl-search-lim
1200 (save-excursion
1201 (c-syntactic-skip-backward "^;" nil t)
1202 (point))))
1203 (setq decl-search-lim
1204 (and (c-syntactic-skip-backward "^;" nil t) (point)))
1205 (setq bod-res (car (c-beginning-of-decl-1 decl-search-lim)))
1206 (if (and (eq bod-res 'same)
1207 (progn
1208 (c-backward-syntactic-ws)
1209 (eq (char-before) ?\})))
1210 (c-beginning-of-decl-1 decl-search-lim))
1211 (setq decl-start (point))))
1213 (save-excursion
1214 (goto-char decl-start)
1215 ;; We're now putatively at the declaration.
1216 (setq paren-state (c-parse-state))
1217 ;; At top level or inside a "{"?
1218 (if (or (not (setq encl-pos
1219 (c-most-enclosing-brace paren-state)))
1220 (eq (char-after encl-pos) ?\{))
1221 (progn
1222 (when (looking-at c-typedef-key) ; "typedef"
1223 (setq is-typedef t)
1224 (goto-char (match-end 0))
1225 (c-forward-syntactic-ws))
1226 ;; At a real declaration?
1227 (if (memq (c-forward-type t) '(t known found))
1228 (progn
1229 (c-font-lock-declarators limit t is-typedef)
1230 nil)
1231 ;; False alarm. Return t to go on to the next check.
1232 (goto-char start-pos)
1234 t)))
1236 (if (eq decl-or-cast 'cast)
1237 ;; Save the position after the previous cast so we can feed
1238 ;; it to `c-forward-decl-or-cast-1' in the next round. That
1239 ;; helps it discover cast chains like "(a) (b) c".
1240 (setq last-cast-end (point))
1242 ;; Set `max-type-decl-end' or `max-type-decl-end-before-token'
1243 ;; under the assumption that we're after the first type decl
1244 ;; expression in the declaration now. That's not really true;
1245 ;; we could also be after a parenthesized initializer
1246 ;; expression in C++, but this is only used as a last resort
1247 ;; to slant ambiguous expression/declarations, and overall
1248 ;; it's worth the risk to occasionally fontify an expression
1249 ;; as a declaration in an initializer expression compared to
1250 ;; getting ambiguous things in normal function prototypes
1251 ;; fontified as expressions.
1252 (if inside-macro
1253 (when (> (point) max-type-decl-end-before-token)
1254 (setq max-type-decl-end-before-token (point)))
1255 (when (> (point) max-type-decl-end)
1256 (setq max-type-decl-end (point))))
1258 ;; Back up to the type to fontify the declarator(s).
1259 (goto-char (car decl-or-cast))
1261 (let ((decl-list
1262 (if context
1263 ;; Should normally not fontify a list of
1264 ;; declarators inside an arglist, but the first
1265 ;; argument in the ';' separated list of a "for"
1266 ;; statement is an exception.
1267 (when (eq (char-before match-pos) ?\()
1268 (save-excursion
1269 (goto-char (1- match-pos))
1270 (c-backward-syntactic-ws)
1271 (and (c-simple-skip-symbol-backward)
1272 (looking-at c-paren-stmt-key))))
1273 t)))
1275 ;; Fix the `c-decl-id-start' or `c-decl-type-start' property
1276 ;; before the first declarator if it's a list.
1277 ;; `c-font-lock-declarators' handles the rest.
1278 (when decl-list
1279 (save-excursion
1280 (c-backward-syntactic-ws)
1281 (unless (bobp)
1282 (c-put-char-property (1- (point)) 'c-type
1283 (if (cdr decl-or-cast)
1284 'c-decl-type-start
1285 'c-decl-id-start)))))
1287 (c-font-lock-declarators
1288 (point-max) decl-list (cdr decl-or-cast))))
1290 ;; A cast or declaration has been successfully identified, so do
1291 ;; all the fontification of types and refs that's been recorded.
1292 (c-fontify-recorded-types-and-refs)
1293 nil))
1295 ;; It was a false alarm. Check if we're in a label (or other
1296 ;; construct with `:' except bitfield) instead.
1297 (goto-char start-pos)
1298 (when (setq label-type (c-forward-label t match-pos nil))
1299 ;; Can't use `c-fontify-types-and-refs' here since we
1300 ;; use the label face at times.
1301 (cond ((eq label-type 'goto-target)
1302 (c-put-font-lock-face (caar c-record-ref-identifiers)
1303 (cdar c-record-ref-identifiers)
1304 c-label-face-name))
1305 ((eq label-type 'qt-1kwd-colon)
1306 (c-put-font-lock-face (caar c-record-ref-identifiers)
1307 (cdar c-record-ref-identifiers)
1308 'font-lock-keyword-face))
1309 ((eq label-type 'qt-2kwds-colon)
1310 (mapc
1311 (lambda (kwd)
1312 (c-put-font-lock-face (car kwd) (cdr kwd)
1313 'font-lock-keyword-face))
1314 c-record-ref-identifiers)))
1315 (setq c-record-ref-identifiers nil)
1316 ;; `c-forward-label' has probably added a `c-decl-end'
1317 ;; marker, so return t to `c-find-decl-spots' to signal
1318 ;; that.
1319 t))))
1321 nil)))
1323 (defun c-font-lock-enum-tail (limit)
1324 ;; Fontify an enum's identifiers when POINT is within the enum's brace
1325 ;; block.
1327 ;; This function will be called from font-lock for a region bounded by POINT
1328 ;; and LIMIT, as though it were to identify a keyword for
1329 ;; font-lock-keyword-face. It always returns NIL to inhibit this and
1330 ;; prevent a repeat invocation. See elisp/lispref page "Search-based
1331 ;; Fontification".
1333 ;; Note that this function won't attempt to fontify beyond the end of the
1334 ;; current enum block, if any.
1335 (let* ((paren-state (c-parse-state))
1336 (encl-pos (c-most-enclosing-brace paren-state))
1337 (start (point))
1339 (when (and
1340 encl-pos
1341 (eq (char-after encl-pos) ?\{)
1342 (save-excursion
1343 (goto-char encl-pos)
1344 (c-backward-syntactic-ws)
1345 (c-simple-skip-symbol-backward)
1346 (or (looking-at c-brace-list-key) ; "enum"
1347 (progn (c-backward-syntactic-ws)
1348 (c-simple-skip-symbol-backward)
1349 (looking-at c-brace-list-key)))))
1350 (c-syntactic-skip-backward "^{," nil t)
1351 (c-put-char-property (1- (point)) 'c-type 'c-decl-id-start)
1353 (c-forward-syntactic-ws)
1354 (c-font-lock-declarators limit t nil)))
1355 nil)
1357 (c-lang-defconst c-simple-decl-matchers
1358 "Simple font lock matchers for types and declarations. These are used
1359 on level 2 only and so aren't combined with `c-complex-decl-matchers'."
1361 t `(;; Objective-C methods.
1362 ,@(when (c-major-mode-is 'objc-mode)
1363 `((,(c-lang-const c-opt-method-key)
1364 (,(byte-compile
1365 (lambda (limit)
1366 (let (;; The font-lock package in Emacs is known to clobber
1367 ;; `parse-sexp-lookup-properties' (when it exists).
1368 (parse-sexp-lookup-properties
1369 (cc-eval-when-compile
1370 (boundp 'parse-sexp-lookup-properties))))
1371 (save-restriction
1372 (narrow-to-region (point-min) limit)
1373 (c-font-lock-objc-method)))
1374 nil))
1375 (goto-char (match-end 1))))))
1377 ;; Fontify all type names and the identifiers in the
1378 ;; declarations they might start. Use eval here since
1379 ;; `c-known-type-key' gets its value from
1380 ;; `*-font-lock-extra-types' on mode init.
1381 (eval . (list ,(c-make-font-lock-search-function
1382 'c-known-type-key
1383 '(1 'font-lock-type-face t)
1384 '((c-font-lock-declarators limit t nil)
1385 (save-match-data
1386 (goto-char (match-end 1))
1387 (c-forward-syntactic-ws))
1388 (goto-char (match-end 1))))))
1390 ;; Fontify types preceded by `c-type-prefix-kwds' and the
1391 ;; identifiers in the declarations they might start.
1392 ,@(when (c-lang-const c-type-prefix-kwds)
1393 (let* ((prefix-re (c-make-keywords-re nil
1394 (c-lang-const c-type-prefix-kwds)))
1395 (type-match (+ 2
1396 (regexp-opt-depth prefix-re)
1397 (c-lang-const c-simple-ws-depth))))
1398 `((,(c-make-font-lock-search-function
1399 (concat "\\<\\(" prefix-re "\\)" ; 1
1400 (c-lang-const c-simple-ws) "+"
1401 (concat "\\(" ; 2 + prefix-re + c-simple-ws
1402 (c-lang-const c-symbol-key)
1403 "\\)"))
1404 `(,type-match
1405 'font-lock-type-face t)
1406 `((c-font-lock-declarators limit t nil)
1407 (save-match-data
1408 (goto-char (match-end ,type-match))
1409 (c-forward-syntactic-ws))
1410 (goto-char (match-end ,type-match))))))))
1412 ;; Fontify special declarations that lacks a type.
1413 ,@(when (c-lang-const c-typeless-decl-kwds)
1414 `((,(c-make-font-lock-search-function
1415 (concat "\\<\\("
1416 (regexp-opt (c-lang-const c-typeless-decl-kwds))
1417 "\\)\\>")
1418 '((c-font-lock-declarators limit t nil)
1419 (save-match-data
1420 (goto-char (match-end 1))
1421 (c-forward-syntactic-ws))
1422 (goto-char (match-end 1)))))))
1424 ;; Fontify generic colon labels in languages that support them.
1425 ,@(when (c-lang-const c-recognize-colon-labels)
1426 `(c-font-lock-labels))))
1428 (c-lang-defconst c-complex-decl-matchers
1429 "Complex font lock matchers for types and declarations. Used on level
1430 3 and higher."
1432 ;; Note: This code in this form dumps a number of functions into the
1433 ;; resulting constant, `c-matchers-3'. At run time, font lock will call
1434 ;; each of them as a "FUNCTION" (see Elisp page "Search-based
1435 ;; Fontification"). The font lock region is delimited by POINT and the
1436 ;; single parameter, LIMIT. Each of these functions returns NIL (thus
1437 ;; inhibiting spurious font-lock-keyword-face highlighting and another
1438 ;; call).
1440 t `(;; Initialize some things before the search functions below.
1441 c-font-lock-complex-decl-prepare
1443 ,@(if (c-major-mode-is 'objc-mode)
1444 ;; Fontify method declarations in Objective-C, but first
1445 ;; we have to put the `c-decl-end' `c-type' property on
1446 ;; all the @-style directives that haven't been handled in
1447 ;; `c-basic-matchers-before'.
1448 `(,(c-make-font-lock-search-function
1449 (c-make-keywords-re t
1450 ;; Exclude "@class" since that directive ends with a
1451 ;; semicolon anyway.
1452 (delete "@class"
1453 (append (c-lang-const c-protection-kwds)
1454 (c-lang-const c-other-decl-kwds)
1455 nil)))
1456 '((c-put-char-property (1- (match-end 1))
1457 'c-type 'c-decl-end)))
1458 c-font-lock-objc-methods))
1460 ;; Fontify all declarations, casts and normal labels.
1461 c-font-lock-declarations
1463 ;; Fontify angle bracket arglists like templates in C++.
1464 ,@(when (c-lang-const c-recognize-<>-arglists)
1465 `(c-font-lock-<>-arglists))
1467 ;; The first two rules here mostly find occurrences that
1468 ;; `c-font-lock-declarations' has found already, but not
1469 ;; declarations containing blocks in the type (see note below).
1470 ;; It's also useful to fontify these everywhere to show e.g. when
1471 ;; a type keyword is accidentally used as an identifier.
1473 ;; Fontify basic types.
1474 ,(let ((re (c-make-keywords-re nil
1475 (c-lang-const c-primitive-type-kwds))))
1476 (if (c-major-mode-is 'pike-mode)
1477 ;; No symbol is a keyword after "->" in Pike.
1478 `(,(concat "\\(\\=.?\\|[^>]\\|[^-]>\\)"
1479 "\\<\\(" re "\\)\\>")
1480 2 font-lock-type-face)
1481 `(,(concat "\\<\\(" re "\\)\\>")
1482 1 'font-lock-type-face)))
1484 ;; Fontify types preceded by `c-type-prefix-kwds' (e.g. "struct").
1485 ,@(when (c-lang-const c-type-prefix-kwds)
1486 `((,(byte-compile
1487 `(lambda (limit)
1488 (c-fontify-types-and-refs
1489 ((c-promote-possible-types t)
1490 ;; The font-lock package in Emacs is known to clobber
1491 ;; `parse-sexp-lookup-properties' (when it exists).
1492 (parse-sexp-lookup-properties
1493 (cc-eval-when-compile
1494 (boundp 'parse-sexp-lookup-properties))))
1495 (save-restriction
1496 ;; Narrow to avoid going past the limit in
1497 ;; `c-forward-type'.
1498 (narrow-to-region (point) limit)
1499 (while (re-search-forward
1500 ,(concat "\\<\\("
1501 (c-make-keywords-re nil
1502 (c-lang-const c-type-prefix-kwds))
1503 "\\)\\>")
1504 limit t)
1505 (unless (c-skip-comments-and-strings limit)
1506 (c-forward-syntactic-ws)
1507 ;; Handle prefix declaration specifiers.
1508 (when (looking-at c-prefix-spec-kwds-re)
1509 (c-forward-keyword-clause 1))
1510 ,(if (c-major-mode-is 'c++-mode)
1511 `(when (and (c-forward-type)
1512 (eq (char-after) ?=))
1513 ;; In C++ we additionally check for a "class
1514 ;; X = Y" construct which is used in
1515 ;; templates, to fontify Y as a type.
1516 (forward-char)
1517 (c-forward-syntactic-ws)
1518 (c-forward-type))
1519 `(c-forward-type))
1520 )))))))))
1522 ;; Fontify symbols after closing braces as declaration
1523 ;; identifiers under the assumption that they are part of
1524 ;; declarations like "class Foo { ... } foo;". It's too
1525 ;; expensive to check this accurately by skipping past the
1526 ;; brace block, so we use the heuristic that it's such a
1527 ;; declaration if the first identifier is on the same line as
1528 ;; the closing brace. `c-font-lock-declarations' will later
1529 ;; override it if it turns out to be an new declaration, but
1530 ;; it will be wrong if it's an expression (see the test
1531 ;; decls-8.cc).
1532 ;; ,@(when (c-lang-const c-opt-block-decls-with-vars-key)
1533 ;; `((,(c-make-font-lock-search-function
1534 ;; (concat "}"
1535 ;; (c-lang-const c-single-line-syntactic-ws)
1536 ;; "\\(" ; 1 + c-single-line-syntactic-ws-depth
1537 ;; (c-lang-const c-type-decl-prefix-key)
1538 ;; "\\|"
1539 ;; (c-lang-const c-symbol-key)
1540 ;; "\\)")
1541 ;; `((c-font-lock-declarators limit t nil) ; That `nil' says use `font-lock-variable-name-face';
1542 ;; ; `t' would mean `font-lock-function-name-face'.
1543 ;; (progn
1544 ;; (c-put-char-property (match-beginning 0) 'c-type
1545 ;; 'c-decl-id-start)
1546 ;; ; 'c-decl-type-start)
1547 ;; (goto-char (match-beginning
1548 ;; ,(1+ (c-lang-const
1549 ;; c-single-line-syntactic-ws-depth)))))
1550 ;; (goto-char (match-end 0)))))))
1552 ;; Fontify the type in C++ "new" expressions.
1553 ,@(when (c-major-mode-is 'c++-mode)
1554 ;; This pattern is a probably a "(MATCHER . ANCHORED-HIGHLIGHTER)"
1555 ;; (see Elisp page "Search-based Fontification").
1556 `(("\\<new\\>"
1557 (c-font-lock-c++-new))))
1560 (defun c-font-lock-labels (limit)
1561 ;; Fontify all statement labels from the point to LIMIT. Assumes
1562 ;; that strings and comments have been fontified already. Nil is
1563 ;; always returned.
1565 ;; Note: This function is only used on decoration level 2; this is
1566 ;; taken care of directly by the gargantuan
1567 ;; `c-font-lock-declarations' on higher levels.
1569 ;; This function might do hidden buffer changes.
1571 (let (continue-pos id-start
1572 ;; The font-lock package in Emacs is known to clobber
1573 ;; `parse-sexp-lookup-properties' (when it exists).
1574 (parse-sexp-lookup-properties
1575 (cc-eval-when-compile
1576 (boundp 'parse-sexp-lookup-properties))))
1578 (while (re-search-forward ":[^:]" limit t)
1579 (setq continue-pos (point))
1580 (goto-char (match-beginning 0))
1581 (unless (c-skip-comments-and-strings limit)
1583 (c-backward-syntactic-ws)
1584 (and (setq id-start (c-on-identifier))
1586 (not (get-text-property id-start 'face))
1588 (progn
1589 (goto-char id-start)
1590 (c-backward-syntactic-ws)
1592 ;; Check for a char that precedes a statement.
1593 (memq (char-before) '(?\} ?\{ ?\;))
1594 ;; Check for a preceding label. We exploit the font
1595 ;; locking made earlier by this function.
1596 (and (eq (char-before) ?:)
1597 (progn
1598 (backward-char)
1599 (c-backward-syntactic-ws)
1600 (not (bobp)))
1601 (eq (get-text-property (1- (point)) 'face)
1602 c-label-face-name))
1603 ;; Check for a keyword that precedes a statement.
1604 (c-after-conditional)))
1606 (progn
1607 ;; Got a label.
1608 (goto-char id-start)
1609 (looking-at c-symbol-key)
1610 (c-put-font-lock-face (match-beginning 0) (match-end 0)
1611 c-label-face-name)))
1613 (goto-char continue-pos))))
1614 nil)
1616 (c-lang-defconst c-basic-matchers-after
1617 "Font lock matchers for various things that should be fontified after
1618 generic casts and declarations are fontified. Used on level 2 and
1619 higher."
1621 t `(,@(when (c-lang-const c-brace-id-list-kwds)
1622 ;; Fontify the remaining identifiers inside an enum list when we start
1623 ;; inside it.
1624 `(c-font-lock-enum-tail
1625 ;; Fontify the identifiers inside enum lists. (The enum type
1626 ;; name is handled by `c-simple-decl-matchers' or
1627 ;; `c-complex-decl-matchers' below.
1628 (,(c-make-font-lock-search-function
1629 (concat
1630 "\\<\\("
1631 (c-make-keywords-re nil (c-lang-const c-brace-id-list-kwds))
1632 "\\)\\>"
1633 ;; Disallow various common punctuation chars that can't come
1634 ;; before the '{' of the enum list, to avoid searching too far.
1635 "[^\]\[{}();,/#=]*"
1636 "{")
1637 '((c-font-lock-declarators limit t nil)
1638 (save-match-data
1639 (goto-char (match-end 0))
1640 (c-put-char-property (1- (point)) 'c-type
1641 'c-decl-id-start)
1642 (c-forward-syntactic-ws))
1643 (goto-char (match-end 0)))))))
1645 ;; Fontify labels after goto etc.
1646 ,@(when (c-lang-const c-before-label-kwds)
1647 `(;; (Got three different interpretation levels here,
1648 ;; which makes it a bit complicated: 1) The backquote
1649 ;; stuff is expanded when compiled or loaded, 2) the
1650 ;; eval form is evaluated at font-lock setup (to
1651 ;; substitute c-label-face-name correctly), and 3) the
1652 ;; resulting structure is interpreted during
1653 ;; fontification.)
1654 (eval
1655 . ,(let* ((c-before-label-re
1656 (c-make-keywords-re nil
1657 (c-lang-const c-before-label-kwds))))
1658 `(list
1659 ,(concat "\\<\\(" c-before-label-re "\\)\\>"
1660 "\\s *"
1661 "\\(" ; identifier-offset
1662 (c-lang-const c-symbol-key)
1663 "\\)")
1664 (list ,(+ (regexp-opt-depth c-before-label-re) 2)
1665 c-label-face-name nil t))))))
1667 ;; Fontify the clauses after various keywords.
1668 ,@(when (or (c-lang-const c-type-list-kwds)
1669 (c-lang-const c-ref-list-kwds)
1670 (c-lang-const c-colon-type-list-kwds)
1671 (c-lang-const c-paren-type-kwds))
1672 `((,(c-make-font-lock-search-function
1673 (concat "\\<\\("
1674 (c-make-keywords-re nil
1675 (append (c-lang-const c-type-list-kwds)
1676 (c-lang-const c-ref-list-kwds)
1677 (c-lang-const c-colon-type-list-kwds)
1678 (c-lang-const c-paren-type-kwds)))
1679 "\\)\\>")
1680 '((c-fontify-types-and-refs ((c-promote-possible-types t))
1681 (c-forward-keyword-clause 1)
1682 (if (> (point) limit) (goto-char limit))))))))
1684 ,@(when (c-major-mode-is 'java-mode)
1685 `((eval . (list "\\<\\(@[a-zA-Z0-9]+\\)\\>" 1 c-annotation-face))))
1688 (c-lang-defconst c-matchers-1
1689 t (c-lang-const c-cpp-matchers))
1691 (c-lang-defconst c-matchers-2
1692 t (append (c-lang-const c-matchers-1)
1693 (c-lang-const c-basic-matchers-before)
1694 (c-lang-const c-simple-decl-matchers)
1695 (c-lang-const c-basic-matchers-after)))
1697 (c-lang-defconst c-matchers-3
1698 t (append (c-lang-const c-matchers-1)
1699 (c-lang-const c-basic-matchers-before)
1700 (c-lang-const c-complex-decl-matchers)
1701 (c-lang-const c-basic-matchers-after)))
1703 (defun c-compose-keywords-list (base-list)
1704 ;; Incorporate the font lock keyword lists according to
1705 ;; `c-doc-comment-style' on the given keyword list and return it.
1706 ;; This is used in the function bindings of the
1707 ;; `*-font-lock-keywords-*' symbols since we have to build the list
1708 ;; when font-lock is initialized.
1710 (unless (memq c-doc-face-name c-literal-faces)
1711 (setq c-literal-faces (cons c-doc-face-name c-literal-faces)))
1713 (let* ((doc-keywords
1714 (if (consp (car-safe c-doc-comment-style))
1715 (cdr-safe (or (assq c-buffer-is-cc-mode c-doc-comment-style)
1716 (assq 'other c-doc-comment-style)))
1717 c-doc-comment-style))
1718 (list (nconc (apply 'nconc
1719 (mapcar
1720 (lambda (doc-style)
1721 (let ((sym (intern
1722 (concat (symbol-name doc-style)
1723 "-font-lock-keywords"))))
1724 (cond ((fboundp sym)
1725 (funcall sym))
1726 ((boundp sym)
1727 (append (eval sym) nil)))))
1728 (if (listp doc-keywords)
1729 doc-keywords
1730 (list doc-keywords))))
1731 base-list)))
1733 ;; Kludge: If `c-font-lock-complex-decl-prepare' is on the list we
1734 ;; move it first since the doc comment font lockers might add
1735 ;; `c-type' text properties, so they have to be cleared before that.
1736 (when (memq 'c-font-lock-complex-decl-prepare list)
1737 (setq list (cons 'c-font-lock-complex-decl-prepare
1738 (delq 'c-font-lock-complex-decl-prepare
1739 (append list nil)))))
1741 list))
1743 (defun c-override-default-keywords (def-var)
1744 ;; This is used to override the value on a `*-font-lock-keywords'
1745 ;; variable only if it's nil or has the same value as one of the
1746 ;; `*-font-lock-keywords-*' variables. Older font-lock packages
1747 ;; define a default value for `*-font-lock-keywords' which we want
1748 ;; to override, but we should otoh avoid clobbering a user setting.
1749 ;; This heuristic for that isn't perfect, but I can't think of any
1750 ;; better. /mast
1751 (when (and (boundp def-var)
1752 (memq (symbol-value def-var)
1753 (cons nil
1754 (mapcar
1755 (lambda (suffix)
1756 (let ((sym (intern (concat (symbol-name def-var)
1757 suffix))))
1758 (and (boundp sym) (symbol-value sym))))
1759 '("-1" "-2" "-3")))))
1760 ;; The overriding is done by unbinding the variable so that the normal
1761 ;; defvar will install its default value later on.
1762 (makunbound def-var)))
1765 ;;; C.
1767 (c-override-default-keywords 'c-font-lock-keywords)
1769 (defconst c-font-lock-keywords-1 (c-lang-const c-matchers-1 c)
1770 "Minimal font locking for C mode.
1771 Fontifies only preprocessor directives (in addition to the syntactic
1772 fontification of strings and comments).")
1774 (defconst c-font-lock-keywords-2 (c-lang-const c-matchers-2 c)
1775 "Fast normal font locking for C mode.
1776 In addition to `c-font-lock-keywords-1', this adds fontification of
1777 keywords, simple types, declarations that are easy to recognize, the
1778 user defined types on `c-font-lock-extra-types', and the doc comment
1779 styles specified by `c-doc-comment-style'.")
1781 (defconst c-font-lock-keywords-3 (c-lang-const c-matchers-3 c)
1782 "Accurate normal font locking for C mode.
1783 Like `c-font-lock-keywords-2' but detects declarations in a more
1784 accurate way that works in most cases for arbitrary types without the
1785 need for `c-font-lock-extra-types'.")
1787 (defvar c-font-lock-keywords c-font-lock-keywords-3
1788 "Default expressions to highlight in C mode.")
1790 (defun c-font-lock-keywords-2 ()
1791 (c-compose-keywords-list c-font-lock-keywords-2))
1792 (defun c-font-lock-keywords-3 ()
1793 (c-compose-keywords-list c-font-lock-keywords-3))
1794 (defun c-font-lock-keywords ()
1795 (c-compose-keywords-list c-font-lock-keywords))
1798 ;;; C++.
1800 (defun c-font-lock-c++-new (limit)
1801 ;; FIXME!!! Put in a comment about the context of this function's
1802 ;; invocation. I think it's called as an ANCHORED-MATCHER within an
1803 ;; ANCHORED-HIGHLIGHTER. (2007/2/10).
1805 ;; Assuming point is after a "new" word, check that it isn't inside
1806 ;; a string or comment, and if so try to fontify the type in the
1807 ;; allocation expression. Nil is always returned.
1809 ;; As usual, C++ takes the prize in coming up with a hard to parse
1810 ;; syntax. :P
1812 ;; This function might do hidden buffer changes.
1814 (unless (c-skip-comments-and-strings limit)
1815 (save-excursion
1816 (catch 'false-alarm
1817 ;; A "new" keyword is followed by one to three expressions, where
1818 ;; the type is the middle one, and the only required part.
1819 (let (expr1-pos expr2-pos
1820 ;; Enable recording of identifier ranges in `c-forward-type'
1821 ;; etc for later fontification. Not using
1822 ;; `c-fontify-types-and-refs' here since the ranges should
1823 ;; be fontified selectively only when an allocation
1824 ;; expression is successfully recognized.
1825 (c-record-type-identifiers t)
1826 c-record-ref-identifiers
1827 ;; The font-lock package in Emacs is known to clobber
1828 ;; `parse-sexp-lookup-properties' (when it exists).
1829 (parse-sexp-lookup-properties
1830 (cc-eval-when-compile
1831 (boundp 'parse-sexp-lookup-properties))))
1832 (c-forward-syntactic-ws)
1834 ;; The first placement arglist is always parenthesized, if it
1835 ;; exists.
1836 (when (eq (char-after) ?\()
1837 (setq expr1-pos (1+ (point)))
1838 (condition-case nil
1839 (c-forward-sexp)
1840 (scan-error (throw 'false-alarm t)))
1841 (c-forward-syntactic-ws))
1843 ;; The second expression is either a type followed by some "*" or
1844 ;; "[...]" or similar, or a parenthesized type followed by a full
1845 ;; identifierless declarator.
1846 (setq expr2-pos (1+ (point)))
1847 (cond ((eq (char-after) ?\())
1848 ((let ((c-promote-possible-types t))
1849 (c-forward-type)))
1850 (t (setq expr2-pos nil)))
1852 (when expr1-pos
1853 (cond
1854 ((not expr2-pos)
1855 ;; No second expression, so the first has to be a
1856 ;; parenthesized type.
1857 (goto-char expr1-pos)
1858 (let ((c-promote-possible-types t))
1859 (c-forward-type)))
1861 ((eq (char-before expr2-pos) ?\()
1862 ;; Got two parenthesized expressions, so we have to look
1863 ;; closer at them to decide which is the type. No need to
1864 ;; handle `c-record-ref-identifiers' since all references
1865 ;; has already been handled by other fontification rules.
1866 (let (expr1-res expr2-res)
1868 (goto-char expr1-pos)
1869 (when (setq expr1-res (c-forward-type))
1870 (unless (looking-at
1871 (cc-eval-when-compile
1872 (concat (c-lang-const c-symbol-start c++)
1873 "\\|[*:\)\[]")))
1874 ;; There's something after the would-be type that
1875 ;; can't be there, so this is a placement arglist.
1876 (setq expr1-res nil)))
1878 (goto-char expr2-pos)
1879 (when (setq expr2-res (c-forward-type))
1880 (unless (looking-at
1881 (cc-eval-when-compile
1882 (concat (c-lang-const c-symbol-start c++)
1883 "\\|[*:\)\[]")))
1884 ;; There's something after the would-be type that can't
1885 ;; be there, so this is an initialization expression.
1886 (setq expr2-res nil))
1887 (when (and (c-go-up-list-forward)
1888 (progn (c-forward-syntactic-ws)
1889 (eq (char-after) ?\()))
1890 ;; If there's a third initialization expression
1891 ;; then the second one is the type, so demote the
1892 ;; first match.
1893 (setq expr1-res nil)))
1895 ;; We fontify the most likely type, with a preference for
1896 ;; the first argument since a placement arglist is more
1897 ;; unusual than an initializer.
1898 (cond ((memq expr1-res '(t known prefix)))
1899 ((memq expr2-res '(t known prefix)))
1900 ((eq expr1-res 'found)
1901 (let ((c-promote-possible-types t))
1902 (goto-char expr1-pos)
1903 (c-forward-type)))
1904 ((eq expr2-res 'found)
1905 (let ((c-promote-possible-types t))
1906 (goto-char expr2-pos)
1907 (c-forward-type)))
1908 ((and (eq expr1-res 'maybe) (not expr2-res))
1909 (let ((c-promote-possible-types t))
1910 (goto-char expr1-pos)
1911 (c-forward-type)))
1912 ((and (not expr1-res) (eq expr2-res 'maybe))
1913 (let ((c-promote-possible-types t))
1914 (goto-char expr2-pos)
1915 (c-forward-type)))
1916 ;; If both type matches are 'maybe then we're
1917 ;; too uncertain to promote either of them.
1918 )))))
1920 ;; Fontify the type that now is recorded in
1921 ;; `c-record-type-identifiers', if any.
1922 (c-fontify-recorded-types-and-refs)))))
1923 nil)
1925 (c-override-default-keywords 'c++-font-lock-keywords)
1927 (defconst c++-font-lock-keywords-1 (c-lang-const c-matchers-1 c++)
1928 "Minimal font locking for C++ mode.
1929 Fontifies only preprocessor directives (in addition to the syntactic
1930 fontification of strings and comments).")
1932 (defconst c++-font-lock-keywords-2 (c-lang-const c-matchers-2 c++)
1933 "Fast normal font locking for C++ mode.
1934 In addition to `c++-font-lock-keywords-1', this adds fontification of
1935 keywords, simple types, declarations that are easy to recognize, the
1936 user defined types on `c++-font-lock-extra-types', and the doc comment
1937 styles specified by `c-doc-comment-style'.")
1939 (defconst c++-font-lock-keywords-3 (c-lang-const c-matchers-3 c++)
1940 "Accurate normal font locking for C++ mode.
1941 Like `c++-font-lock-keywords-2' but detects declarations in a more
1942 accurate way that works in most cases for arbitrary types without the
1943 need for `c++-font-lock-extra-types'.")
1945 (defvar c++-font-lock-keywords c++-font-lock-keywords-3
1946 "Default expressions to highlight in C++ mode.")
1948 (defun c++-font-lock-keywords-2 ()
1949 (c-compose-keywords-list c++-font-lock-keywords-2))
1950 (defun c++-font-lock-keywords-3 ()
1951 (c-compose-keywords-list c++-font-lock-keywords-3))
1952 (defun c++-font-lock-keywords ()
1953 (c-compose-keywords-list c++-font-lock-keywords))
1956 ;;; Objective-C.
1958 (defun c-font-lock-objc-method ()
1959 ;; Assuming the point is after the + or - that starts an Objective-C
1960 ;; method declaration, fontify it. This must be done before normal
1961 ;; casts, declarations and labels are fontified since they will get
1962 ;; false matches in these things.
1964 ;; This function might do hidden buffer changes.
1966 (c-fontify-types-and-refs
1967 ((first t)
1968 (c-promote-possible-types t))
1970 (while (and
1971 (progn
1972 (c-forward-syntactic-ws)
1974 ;; An optional method type.
1975 (if (eq (char-after) ?\()
1976 (progn
1977 (forward-char)
1978 (c-forward-syntactic-ws)
1979 (c-forward-type)
1980 (prog1 (c-go-up-list-forward)
1981 (c-forward-syntactic-ws)))
1984 ;; The name. The first time it's the first part of
1985 ;; the function name, the rest of the time it's an
1986 ;; argument name.
1987 (looking-at c-symbol-key)
1988 (progn
1989 (goto-char (match-end 0))
1990 (c-put-font-lock-face (match-beginning 0)
1991 (point)
1992 (if first
1993 'font-lock-function-name-face
1994 'font-lock-variable-name-face))
1995 (c-forward-syntactic-ws)
1997 ;; Another optional part of the function name.
1998 (when (looking-at c-symbol-key)
1999 (goto-char (match-end 0))
2000 (c-put-font-lock-face (match-beginning 0)
2001 (point)
2002 'font-lock-function-name-face)
2003 (c-forward-syntactic-ws))
2005 ;; There's another argument if a colon follows.
2006 (eq (char-after) ?:)))
2007 (forward-char)
2008 (setq first nil))))
2010 (defun c-font-lock-objc-methods (limit)
2011 ;; Fontify method declarations in Objective-C. Nil is always
2012 ;; returned.
2014 ;; This function might do hidden buffer changes.
2016 (let (;; The font-lock package in Emacs is known to clobber
2017 ;; `parse-sexp-lookup-properties' (when it exists).
2018 (parse-sexp-lookup-properties
2019 (cc-eval-when-compile
2020 (boundp 'parse-sexp-lookup-properties))))
2022 (c-find-decl-spots
2023 limit
2024 "[-+]"
2026 (lambda (match-pos inside-macro)
2027 (forward-char)
2028 (c-font-lock-objc-method))))
2029 nil)
2031 (c-override-default-keywords 'objc-font-lock-keywords)
2033 (defconst objc-font-lock-keywords-1 (c-lang-const c-matchers-1 objc)
2034 "Minimal font locking for Objective-C mode.
2035 Fontifies only compiler directives (in addition to the syntactic
2036 fontification of strings and comments).")
2038 (defconst objc-font-lock-keywords-2 (c-lang-const c-matchers-2 objc)
2039 "Fast normal font locking for Objective-C mode.
2040 In addition to `objc-font-lock-keywords-1', this adds fontification of
2041 keywords, simple types, declarations that are easy to recognize, the
2042 user defined types on `objc-font-lock-extra-types', and the doc
2043 comment styles specified by `c-doc-comment-style'.")
2045 (defconst objc-font-lock-keywords-3 (c-lang-const c-matchers-3 objc)
2046 "Accurate normal font locking for Objective-C mode.
2047 Like `objc-font-lock-keywords-2' but detects declarations in a more
2048 accurate way that works in most cases for arbitrary types without the
2049 need for `objc-font-lock-extra-types'.")
2051 (defvar objc-font-lock-keywords objc-font-lock-keywords-3
2052 "Default expressions to highlight in Objective-C mode.")
2054 (defun objc-font-lock-keywords-2 ()
2055 (c-compose-keywords-list objc-font-lock-keywords-2))
2056 (defun objc-font-lock-keywords-3 ()
2057 (c-compose-keywords-list objc-font-lock-keywords-3))
2058 (defun objc-font-lock-keywords ()
2059 (c-compose-keywords-list objc-font-lock-keywords))
2061 ;; Kludge to override the default value that
2062 ;; `objc-font-lock-extra-types' might have gotten from the font-lock
2063 ;; package. The value replaced here isn't relevant now anyway since
2064 ;; those types are builtin and therefore listed directly in
2065 ;; `c-primitive-type-kwds'.
2066 (when (equal (sort (append objc-font-lock-extra-types nil) 'string-lessp)
2067 '("BOOL" "Class" "IMP" "SEL"))
2068 (setq objc-font-lock-extra-types
2069 (cc-eval-when-compile (list (concat "[" c-upper "]\\sw*")))))
2072 ;;; Java.
2074 (c-override-default-keywords 'java-font-lock-keywords)
2076 (defconst java-font-lock-keywords-1 (c-lang-const c-matchers-1 java)
2077 "Minimal font locking for Java mode.
2078 Fontifies nothing except the syntactic fontification of strings and
2079 comments.")
2081 (defconst java-font-lock-keywords-2 (c-lang-const c-matchers-2 java)
2082 "Fast normal font locking for Java mode.
2083 In addition to `java-font-lock-keywords-1', this adds fontification of
2084 keywords, simple types, declarations that are easy to recognize, the
2085 user defined types on `java-font-lock-extra-types', and the doc
2086 comment styles specified by `c-doc-comment-style'.")
2088 (defconst java-font-lock-keywords-3 (c-lang-const c-matchers-3 java)
2089 "Accurate normal font locking for Java mode.
2090 Like `java-font-lock-keywords-2' but detects declarations in a more
2091 accurate way that works in most cases for arbitrary types without the
2092 need for `java-font-lock-extra-types'.")
2094 (defvar java-font-lock-keywords java-font-lock-keywords-3
2095 "Default expressions to highlight in Java mode.")
2097 (defun java-font-lock-keywords-2 ()
2098 (c-compose-keywords-list java-font-lock-keywords-2))
2099 (defun java-font-lock-keywords-3 ()
2100 (c-compose-keywords-list java-font-lock-keywords-3))
2101 (defun java-font-lock-keywords ()
2102 (c-compose-keywords-list java-font-lock-keywords))
2105 ;;; CORBA IDL.
2107 (c-override-default-keywords 'idl-font-lock-keywords)
2109 (defconst idl-font-lock-keywords-1 (c-lang-const c-matchers-1 idl)
2110 "Minimal font locking for CORBA IDL mode.
2111 Fontifies nothing except the syntactic fontification of strings and
2112 comments.")
2114 (defconst idl-font-lock-keywords-2 (c-lang-const c-matchers-2 idl)
2115 "Fast normal font locking for CORBA IDL mode.
2116 In addition to `idl-font-lock-keywords-1', this adds fontification of
2117 keywords, simple types, declarations that are easy to recognize, the
2118 user defined types on `idl-font-lock-extra-types', and the doc comment
2119 styles specified by `c-doc-comment-style'.")
2121 (defconst idl-font-lock-keywords-3 (c-lang-const c-matchers-3 idl)
2122 "Accurate normal font locking for CORBA IDL mode.
2123 Like `idl-font-lock-keywords-2' but detects declarations in a more
2124 accurate way that works in most cases for arbitrary types without the
2125 need for `idl-font-lock-extra-types'.")
2127 (defvar idl-font-lock-keywords idl-font-lock-keywords-3
2128 "Default expressions to highlight in CORBA IDL mode.")
2130 (defun idl-font-lock-keywords-2 ()
2131 (c-compose-keywords-list idl-font-lock-keywords-2))
2132 (defun idl-font-lock-keywords-3 ()
2133 (c-compose-keywords-list idl-font-lock-keywords-3))
2134 (defun idl-font-lock-keywords ()
2135 (c-compose-keywords-list idl-font-lock-keywords))
2138 ;;; Pike.
2140 (c-override-default-keywords 'pike-font-lock-keywords)
2142 (defconst pike-font-lock-keywords-1 (c-lang-const c-matchers-1 pike)
2143 "Minimal font locking for Pike mode.
2144 Fontifies only preprocessor directives (in addition to the syntactic
2145 fontification of strings and comments).")
2147 (defconst pike-font-lock-keywords-2 (c-lang-const c-matchers-2 pike)
2148 "Fast normal font locking for Pike mode.
2149 In addition to `pike-font-lock-keywords-1', this adds fontification of
2150 keywords, simple types, declarations that are easy to recognize, the
2151 user defined types on `pike-font-lock-extra-types', and the doc
2152 comment styles specified by `c-doc-comment-style'.")
2154 (defconst pike-font-lock-keywords-3 (c-lang-const c-matchers-3 pike)
2155 "Accurate normal font locking for Pike mode.
2156 Like `pike-font-lock-keywords-2' but detects declarations in a more
2157 accurate way that works in most cases for arbitrary types without the
2158 need for `pike-font-lock-extra-types'.")
2160 (defvar pike-font-lock-keywords pike-font-lock-keywords-3
2161 "Default expressions to highlight in Pike mode.")
2163 (defun pike-font-lock-keywords-2 ()
2164 (c-compose-keywords-list pike-font-lock-keywords-2))
2165 (defun pike-font-lock-keywords-3 ()
2166 (c-compose-keywords-list pike-font-lock-keywords-3))
2167 (defun pike-font-lock-keywords ()
2168 (c-compose-keywords-list pike-font-lock-keywords))
2171 ;;; Doc comments.
2173 (defun c-font-lock-doc-comments (prefix limit keywords)
2174 ;; Fontify the comments between the point and LIMIT whose start
2175 ;; matches PREFIX with `c-doc-face-name'. Assumes comments have been
2176 ;; fontified with `font-lock-comment-face' already. nil is always
2177 ;; returned.
2179 ;; After the fontification of a matching comment, fontification
2180 ;; according to KEYWORDS is applied inside it. It's a list like
2181 ;; `font-lock-keywords' except that anchored matches and eval
2182 ;; clauses aren't supported and that some abbreviated forms can't be
2183 ;; used. The buffer is narrowed to the comment while KEYWORDS is
2184 ;; applied; leading comment starters are included but trailing
2185 ;; comment enders for block comment are not.
2187 ;; Note that faces added through KEYWORDS should never replace the
2188 ;; existing `c-doc-face-name' face since the existence of that face
2189 ;; is used as a flag in other code to skip comments.
2191 ;; This function might do hidden buffer changes.
2193 (let (comment-beg region-beg)
2194 (if (eq (get-text-property (point) 'face)
2195 'font-lock-comment-face)
2196 ;; Handle the case when the fontified region starts inside a
2197 ;; comment.
2198 (let ((range (c-literal-limits)))
2199 (setq region-beg (point))
2200 (when range
2201 (goto-char (car range)))
2202 (when (looking-at prefix)
2203 (setq comment-beg (point)))))
2205 (while (or
2206 comment-beg
2208 ;; Search for the prefix until a match is found at the start
2209 ;; of a comment.
2210 (while (when (re-search-forward prefix limit t)
2211 (setq comment-beg (match-beginning 0))
2212 (or (not (c-got-face-at comment-beg
2213 c-literal-faces))
2214 (and (/= comment-beg (point-min))
2215 (c-got-face-at (1- comment-beg)
2216 c-literal-faces))))
2217 (setq comment-beg nil))
2218 (setq region-beg comment-beg))
2220 (if (eq (elt (parse-partial-sexp comment-beg (+ comment-beg 2)) 7) t)
2221 ;; Collect a sequence of doc style line comments.
2222 (progn
2223 (goto-char comment-beg)
2224 (while (and (progn
2225 (c-forward-single-comment)
2226 (skip-syntax-forward " ")
2227 (< (point) limit))
2228 (looking-at prefix))))
2229 (goto-char comment-beg)
2230 (c-forward-single-comment))
2231 (if (> (point) limit) (goto-char limit))
2232 (setq comment-beg nil)
2234 (let ((region-end (point))
2235 (keylist keywords) keyword matcher highlights)
2236 (c-put-font-lock-face region-beg region-end c-doc-face-name)
2237 (save-restriction
2238 ;; Narrow to the doc comment. Among other things, this
2239 ;; helps by making "^" match at the start of the comment.
2240 ;; Do not include a trailing block comment ender, though.
2241 (and (> region-end (1+ region-beg))
2242 (progn (goto-char region-end)
2243 (backward-char 2)
2244 (looking-at "\\*/"))
2245 (setq region-end (point)))
2246 (narrow-to-region region-beg region-end)
2248 (while keylist
2249 (setq keyword (car keylist)
2250 keylist (cdr keylist)
2251 matcher (car keyword))
2252 (goto-char region-beg)
2253 (while (if (stringp matcher)
2254 (re-search-forward matcher region-end t)
2255 (funcall matcher region-end))
2256 (setq highlights (cdr keyword))
2257 (if (consp (car highlights))
2258 (while highlights
2259 (font-lock-apply-highlight (car highlights))
2260 (setq highlights (cdr highlights)))
2261 (font-lock-apply-highlight highlights))))
2263 (goto-char region-end)))))
2264 nil)
2265 (put 'c-font-lock-doc-comments 'lisp-indent-function 2)
2267 (defun c-find-invalid-doc-markup (regexp limit)
2268 ;; Used to fontify invalid markup in doc comments after the correct
2269 ;; ones have been fontified: Find the first occurrence of REGEXP
2270 ;; between the point and LIMIT that only is fontified with
2271 ;; `c-doc-face-name'. If a match is found then submatch 0 surrounds
2272 ;; the first char and t is returned, otherwise nil is returned.
2274 ;; This function might do hidden buffer changes.
2275 (let (start)
2276 (while (if (re-search-forward regexp limit t)
2277 (not (eq (get-text-property
2278 (setq start (match-beginning 0)) 'face)
2279 c-doc-face-name))
2280 (setq start nil)))
2281 (when start
2282 (store-match-data (list (copy-marker start)
2283 (copy-marker (1+ start))))
2284 t)))
2286 ;; GtkDoc patterns contributed by Masatake YAMATO <jet@gyve.org>.
2288 (defconst gtkdoc-font-lock-doc-comments
2289 (let ((symbol "[a-zA-Z0-9_]+")
2290 (header "^ \\* "))
2291 `((,(concat header "\\(" symbol "\\):[ \t]*$")
2292 1 ,c-doc-markup-face-name prepend nil)
2293 (,(concat symbol "()")
2294 0 ,c-doc-markup-face-name prepend nil)
2295 (,(concat header "\\(" "@" symbol "\\):")
2296 1 ,c-doc-markup-face-name prepend nil)
2297 (,(concat "[#%@]" symbol)
2298 0 ,c-doc-markup-face-name prepend nil))
2301 (defconst gtkdoc-font-lock-doc-protection
2302 `(("< \\(public\\|private\\|protected\\) >"
2303 1 ,c-doc-markup-face-name prepend nil)))
2305 (defconst gtkdoc-font-lock-keywords
2306 `((,(lambda (limit)
2307 (c-font-lock-doc-comments "/\\*\\*$" limit
2308 gtkdoc-font-lock-doc-comments)
2309 (c-font-lock-doc-comments "/\\*< " limit
2310 gtkdoc-font-lock-doc-protection)
2311 ))))
2313 ;; Javadoc.
2315 (defconst javadoc-font-lock-doc-comments
2316 `(("{@[a-z]+[^}\n\r]*}" ; "{@foo ...}" markup.
2317 0 ,c-doc-markup-face-name prepend nil)
2318 ("^\\(/\\*\\)?\\(\\s \\|\\*\\)*\\(@[a-z]+\\)" ; "@foo ..." markup.
2319 3 ,c-doc-markup-face-name prepend nil)
2320 (,(concat "</?\\sw" ; HTML tags.
2321 "\\("
2322 (concat "\\sw\\|\\s \\|[=\n\r*.:]\\|"
2323 "\"[^\"]*\"\\|'[^']*'")
2324 "\\)*>")
2325 0 ,c-doc-markup-face-name prepend nil)
2326 ("&\\(\\sw\\|[.:]\\)+;" ; HTML entities.
2327 0 ,c-doc-markup-face-name prepend nil)
2328 ;; Fontify remaining markup characters as invalid. Note
2329 ;; that the Javadoc spec is hazy about when "@" is
2330 ;; allowed in non-markup use.
2331 (,(lambda (limit)
2332 (c-find-invalid-doc-markup "[<>&]\\|{@" limit))
2333 0 'font-lock-warning-face prepend nil)))
2335 (defconst javadoc-font-lock-keywords
2336 `((,(lambda (limit)
2337 (c-font-lock-doc-comments "/\\*\\*" limit
2338 javadoc-font-lock-doc-comments)))))
2340 ;; Pike autodoc.
2342 (defconst autodoc-decl-keywords
2343 ;; Adorned regexp matching the keywords that introduce declarations
2344 ;; in Pike Autodoc.
2345 (cc-eval-when-compile
2346 (c-make-keywords-re t '("@decl" "@elem" "@index" "@member") 'pike-mode)))
2348 (defconst autodoc-decl-type-keywords
2349 ;; Adorned regexp matching the keywords that are followed by a type.
2350 (cc-eval-when-compile
2351 (c-make-keywords-re t '("@elem" "@member") 'pike-mode)))
2353 (defun autodoc-font-lock-line-markup (limit)
2354 ;; Fontify all line oriented keywords between the point and LIMIT.
2355 ;; Nil is always returned.
2357 ;; This function might do hidden buffer changes.
2359 (let ((line-re (concat "^\\(\\(/\\*!\\|\\s *\\("
2360 c-current-comment-prefix
2361 "\\)\\)\\s *\\)@[A-Za-z_-]+\\(\\s \\|$\\)"))
2362 (markup-faces (list c-doc-markup-face-name c-doc-face-name)))
2364 (while (re-search-forward line-re limit t)
2365 (goto-char (match-end 1))
2367 (if (looking-at autodoc-decl-keywords)
2368 (let* ((kwd-pos (point))
2369 (start (match-end 1))
2370 (pos start)
2371 end)
2373 (c-put-font-lock-face (point) pos markup-faces)
2375 ;; Put a declaration end mark at the markup keyword and
2376 ;; remove the faces from the rest of the line so that it
2377 ;; gets refontified as a declaration later on by
2378 ;; `c-font-lock-declarations'.
2379 (c-put-char-property (1- pos) 'c-type 'c-decl-end)
2380 (goto-char pos)
2381 (while (progn
2382 (end-of-line)
2383 (setq end (point))
2384 (and (eq (char-before) ?@)
2385 (not (eobp))
2386 (progn (forward-char)
2387 (skip-syntax-forward " ")
2388 (looking-at c-current-comment-prefix))))
2389 (goto-char (match-end 0))
2390 (c-remove-font-lock-face pos (1- end))
2391 (c-put-font-lock-face (1- end) end markup-faces)
2392 (setq pos (point)))
2394 ;; Include the final newline in the removed area. This
2395 ;; has no visual effect but it avoids some tricky special
2396 ;; cases in the testsuite wrt the differences in string
2397 ;; fontification in Emacs vs XEmacs.
2398 (c-remove-font-lock-face pos (min (1+ (point)) (point-max)))
2400 ;; Must handle string literals explicitly inside the declaration.
2401 (goto-char start)
2402 (while (re-search-forward
2403 "\"\\([^\\\"]\\|\\\\.\\)*\"\\|'\\([^\\']\\|\\\\.\\)*'"
2404 end 'move)
2405 (c-put-font-lock-string-face (match-beginning 0)
2406 (point)))
2408 ;; Fontify types after keywords that always are followed
2409 ;; by them.
2410 (goto-char kwd-pos)
2411 (when (looking-at autodoc-decl-type-keywords)
2412 (c-fontify-types-and-refs ((c-promote-possible-types t))
2413 (goto-char start)
2414 (c-forward-syntactic-ws)
2415 (c-forward-type))))
2417 ;; Mark each whole line as markup, as long as the logical line
2418 ;; continues.
2419 (while (progn
2420 (c-put-font-lock-face (point)
2421 (progn (end-of-line) (point))
2422 markup-faces)
2423 (and (eq (char-before) ?@)
2424 (not (eobp))
2425 (progn (forward-char)
2426 (skip-syntax-forward " ")
2427 (looking-at c-current-comment-prefix))))
2428 (goto-char (match-end 0))))))
2430 nil)
2432 (defconst autodoc-font-lock-doc-comments
2433 `(("@\\(\\w+{\\|\\[\\([^\]@\n\r]\\|@@\\)*\\]\\|[@}]\\|$\\)"
2434 ;; In-text markup.
2435 0 ,c-doc-markup-face-name prepend nil)
2436 (autodoc-font-lock-line-markup)
2437 ;; Fontify remaining markup characters as invalid.
2438 (,(lambda (limit)
2439 (c-find-invalid-doc-markup "@" limit))
2440 0 'font-lock-warning-face prepend nil)
2443 (defun autodoc-font-lock-keywords ()
2444 ;; Note that we depend on that `c-current-comment-prefix' has got
2445 ;; its proper value here.
2447 ;; This function might do hidden buffer changes.
2449 ;; The `c-type' text property with `c-decl-end' is used to mark the
2450 ;; end of the `autodoc-decl-keywords' occurrences to fontify the
2451 ;; following declarations.
2452 (setq c-type-decl-end-used t)
2454 `((,(lambda (limit)
2455 (c-font-lock-doc-comments "/[*/]!" limit
2456 autodoc-font-lock-doc-comments)))))
2459 ;; 2006-07-10: awk-font-lock-keywords has been moved back to cc-awk.el.
2460 (cc-provide 'cc-fonts)
2462 ;;; cc-fonts.el ends here