Mercurial > emacs
annotate lisp/progmodes/cc-vars.el @ 102929:6be674ea734e
* vc-dir.el (vc-dir): Dox fix.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Fri, 10 Apr 2009 14:19:12 +0000 |
parents | 527143cc2cfe |
children | 49b361ba00e8 |
rev | line source |
---|---|
18720 | 1 ;;; cc-vars.el --- user customization variables for CC Mode |
2 | |
74372 | 3 ;; Copyright (C) 1985, 1987, 1992, 1993, 1994, 1995, 1996, 1997, 1998, |
100908 | 4 ;; 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 |
75347 | 5 ;; Free Software Foundation, Inc. |
18720 | 6 |
75307 | 7 ;; Authors: 2002- Alan Mackenzie |
8 ;; 1998- Martin Stjernholm | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
9 ;; 1992-1999 Barry A. Warsaw |
101112
0685234e527d
Comment (minor header format fixes).
Glenn Morris <rgm@gnu.org>
parents:
100908
diff
changeset
|
10 ;; 1987 Dave Detlefs |
0685234e527d
Comment (minor header format fixes).
Glenn Morris <rgm@gnu.org>
parents:
100908
diff
changeset
|
11 ;; 1987 Stewart Clamen |
18720 | 12 ;; 1985 Richard M. Stallman |
24282 | 13 ;; Maintainer: bug-cc-mode@gnu.org |
18720 | 14 ;; Created: 22-Apr-1997 (split from cc-mode.el) |
20144
56d81cc7b4f5
(c-progress-interval): Document new semantics
Karl Heuer <kwzh@gnu.org>
parents:
20140
diff
changeset
|
15 ;; Version: See cc-mode.el |
18720 | 16 ;; Keywords: c languages oop |
17 | |
18 ;; This file is part of GNU Emacs. | |
19 | |
94673
52b7a8c22af5
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
20 ;; GNU Emacs is free software: you can redistribute it and/or modify |
18720 | 21 ;; it under the terms of the GNU General Public License as published by |
94673
52b7a8c22af5
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
22 ;; the Free Software Foundation, either version 3 of the License, or |
52b7a8c22af5
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
23 ;; (at your option) any later version. |
18720 | 24 |
25 ;; GNU Emacs is distributed in the hope that it will be useful, | |
26 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
27 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
28 ;; GNU General Public License for more details. | |
29 | |
30 ;; You should have received a copy of the GNU General Public License | |
94673
52b7a8c22af5
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
31 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
18720 | 32 |
38422
7a94f1c588c4
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
36920
diff
changeset
|
33 ;;; Commentary: |
7a94f1c588c4
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
36920
diff
changeset
|
34 |
7a94f1c588c4
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
36920
diff
changeset
|
35 ;;; Code: |
7a94f1c588c4
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
36920
diff
changeset
|
36 |
24282 | 37 (eval-when-compile |
26817 | 38 (let ((load-path |
36920 | 39 (if (and (boundp 'byte-compile-dest-file) |
40 (stringp byte-compile-dest-file)) | |
41 (cons (file-name-directory byte-compile-dest-file) load-path) | |
26817 | 42 load-path))) |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
43 (load "cc-bytecomp" nil t))) |
36920 | 44 |
45 (cc-require 'cc-defs) | |
46 | |
47 ;; Silence the compiler. | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
48 (cc-bytecomp-defun get-char-table) ; XEmacs |
24282 | 49 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
50 (cc-eval-when-compile |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
51 (require 'custom) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
52 (require 'widget)) |
18720 | 53 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
54 (cc-eval-when-compile |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
55 ;; Need the function form of `backquote', which isn't standardized |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
56 ;; between Emacsen. It's called `bq-process' in XEmacs, and |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
57 ;; `backquote-process' in Emacs. `backquote-process' returns a |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
58 ;; slightly more convoluted form, so let `bq-process' be the norm. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
59 (if (fboundp 'backquote-process) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
60 (cc-bytecomp-defmacro bq-process (form) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
61 `(cdr (backquote-process ,form))))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
62 |
18720 | 63 |
26817 | 64 ;;; Helpers |
18720 | 65 |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
66 ;; This widget exists in newer versions of the Custom library |
24282 | 67 (or (get 'other 'widget-type) |
68 (define-widget 'other 'sexp | |
69 "Matches everything, but doesn't let the user edit the value. | |
70 Useful as last item in a `choice' widget." | |
71 :tag "Other" | |
72 :format "%t%n" | |
73 :value 'other)) | |
74 | |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
75 ;; The next defun will supersede c-const-symbol. |
79860
9f6170e094c3
(c-constant-symbol): Put this defun inside an eval-and-compile, so as to
Alan Mackenzie <acm@muc.de>
parents:
79841
diff
changeset
|
76 (eval-and-compile |
9f6170e094c3
(c-constant-symbol): Put this defun inside an eval-and-compile, so as to
Alan Mackenzie <acm@muc.de>
parents:
79841
diff
changeset
|
77 (defun c-constant-symbol (sym len) |
87756
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
78 "Create an uneditable symbol for customization buffers. |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
79 SYM is the name of the symbol, LEN the length of the field (in |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
80 characters) the symbol will be displayed in. LEN must be big |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
81 enough. |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
82 |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
83 This returns a (const ....) structure, suitable for embedding |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
84 within a customization type." |
87756
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
85 (or (symbolp sym) (error "c-constant-symbol: %s is not a symbol" sym)) |
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
86 (let* ((name (symbol-name sym)) |
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
87 (l (length name)) |
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
88 (disp (concat name ":" (make-string (- len l 1) ?\ )))) |
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
89 `(const |
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
90 :size ,len |
5b0f1e2a7271
* progmodes/cc-vars.el (c-constant-symbol): New function which supersedes
Alan Mackenzie <acm@muc.de>
parents:
87649
diff
changeset
|
91 :format ,disp |
87772
d8143a93113f
(c-constant-symbol): Put this defun inside an eval-and-compile, so as to
Alan Mackenzie <acm@muc.de>
parents:
87756
diff
changeset
|
92 :value ,sym)))) |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
93 |
26817 | 94 (define-widget 'c-const-symbol 'item |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
95 "An uneditable lisp symbol. This is obsolete - |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
96 use c-constant-symbol instead." |
26817 | 97 :value nil |
98 :tag "Symbol" | |
99 :format "%t: %v\n%d" | |
100 :match (lambda (widget value) (symbolp value)) | |
101 :value-to-internal | |
102 (lambda (widget value) | |
103 (let ((s (if (symbolp value) | |
104 (symbol-name value) | |
105 value)) | |
106 (l (widget-get widget :size))) | |
107 (if l | |
108 (setq s (concat s (make-string (- l (length s)) ?\ )))) | |
109 s)) | |
110 :value-to-external | |
111 (lambda (widget value) | |
112 (if (stringp value) | |
113 (intern (progn | |
114 (string-match "\\`[^ ]*" value) | |
115 (match-string 0 value))) | |
116 value))) | |
117 | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
118 (define-widget 'c-integer-or-nil 'sexp |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
119 "An integer or the value nil." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
120 :value nil |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
121 :tag "Optional integer" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
122 :match (lambda (widget value) (or (integerp value) (null value)))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
123 |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
124 (define-widget 'c-symbol-list 'sexp |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
125 "A single symbol or a list of symbols." |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
126 :tag "Symbols separated by spaces" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
127 :validate 'widget-field-validate |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
128 :match |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
129 (lambda (widget value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
130 (or (symbolp value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
131 (catch 'ok |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
132 (while (listp value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
133 (unless (symbolp (car value)) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
134 (throw 'ok nil)) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
135 (setq value (cdr value))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
136 (null value)))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
137 :value-to-internal |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
138 (lambda (widget value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
139 (cond ((null value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
140 "") |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
141 ((symbolp value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
142 (symbol-name value)) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
143 ((consp value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
144 (mapconcat (lambda (symbol) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
145 (symbol-name symbol)) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
146 value |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
147 " ")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
148 (t |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
149 value))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
150 :value-to-external |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
151 (lambda (widget value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
152 (if (stringp value) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
153 (let (list end) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
154 (while (string-match "\\S +" value end) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
155 (setq list (cons (intern (match-string 0 value)) list) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
156 end (match-end 0))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
157 (if (and list (not (cdr list))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
158 (car list) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
159 (nreverse list))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
160 value))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
161 |
26817 | 162 (defvar c-style-variables |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
163 '(c-basic-offset c-comment-only-line-offset c-indent-comment-alist |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
164 c-indent-comments-syntactically-p c-block-comment-prefix |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
165 c-comment-prefix-regexp c-doc-comment-style c-cleanup-list |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
166 c-hanging-braces-alist c-hanging-colons-alist |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
167 c-hanging-semi&comma-criteria c-backslash-column c-backslash-max-column |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
168 c-special-indent-hook c-label-minimum-indentation c-offsets-alist) |
26817 | 169 "List of the style variables.") |
170 | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
171 (defvar c-fallback-style nil) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
172 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
173 (defsubst c-set-stylevar-fallback (name val) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
174 (put name 'c-stylevar-fallback val) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
175 (setq c-fallback-style (cons (cons name val) c-fallback-style))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
176 |
26817 | 177 (defmacro defcustom-c-stylevar (name val doc &rest args) |
87561
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
178 "Define a style variable NAME with VAL and DOC. |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
179 More precisely, convert the given `:type FOO', mined out of ARGS, |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
180 to an aggregate `:type (radio STYLE (PREAMBLE FOO))', append some |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
181 some boilerplate documentation to DOC, arrange for the fallback |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
182 value of NAME to be VAL, and call `custom-declare-variable' to |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
183 do the rest of the work. |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
184 |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
185 STYLE stands for the choice where the value is taken from some |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
186 style setting. PREAMBLE is optionally prepended to FOO; that is, |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
187 if FOO contains :tag or :value, the respective two-element list |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
188 component is ignored." |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
189 (declare (debug (symbolp form stringp &rest))) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
190 (let* ((expanded-doc (concat doc " |
26817 | 191 |
192 This is a style variable. Apart from the valid values described | |
87561
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
193 above, it can be set to the symbol `set-from-style'. In that case, |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
194 it takes its value from the style system (see `c-default-style' and |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
195 `c-style-alist') when a CC Mode buffer is initialized. Otherwise, |
26817 | 196 the value set here overrides the style system (there is a variable |
87561
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
197 `c-old-style-variable-behavior' that changes this, though).")) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
198 (typ (eval (plist-get args :type))) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
199 (type (if (consp typ) typ (list typ))) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
200 (head (car type)) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
201 (tail (cdr type)) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
202 (newt (append (unless (plist-get tail :tag) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
203 '(:tag "Override style settings")) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
204 (unless (plist-get tail :value) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
205 `(:value ,(eval val))) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
206 tail)) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
207 (aggregate `'(radio |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
208 (const :tag "Use style settings" set-from-style) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
209 ,(cons head newt)))) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
210 `(progn |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
211 (c-set-stylevar-fallback ',name ,val) |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
212 (custom-declare-variable |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
213 ',name ''set-from-style |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
214 ,expanded-doc |
5af270d1dbdc
(defcustom-c-stylevar): Revert previous change (merge mistake).
Glenn Morris <rgm@gnu.org>
parents:
87453
diff
changeset
|
215 ,@(plist-put args :type aggregate))))) |
26817 | 216 |
217 (defun c-valid-offset (offset) | |
78487
419c5c316b51
Replace `iff' in doc-strings and comments.
Glenn Morris <rgm@gnu.org>
parents:
78234
diff
changeset
|
218 "Return non-nil if OFFSET is a valid offset for a syntactic symbol. |
26817 | 219 See `c-offsets-alist'." |
220 (or (eq offset '+) | |
221 (eq offset '-) | |
222 (eq offset '++) | |
223 (eq offset '--) | |
224 (eq offset '*) | |
225 (eq offset '/) | |
226 (integerp offset) | |
227 (functionp offset) | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
228 (and (symbolp offset) (boundp offset)) |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
229 (and (vectorp offset) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
230 (= (length offset) 1) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
231 (integerp (elt offset 0))) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
232 (and (consp offset) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
233 (not (eq (car offset) 'quote)) ; Detect misquoted lists. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
234 (progn |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
235 (when (memq (car offset) '(first min max add)) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
236 (setq offset (cdr offset))) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
237 (while (and (consp offset) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
238 (c-valid-offset (car offset))) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
239 (setq offset (cdr offset))) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
240 (null offset))))) |
26817 | 241 |
242 | |
243 | |
244 ;;; User variables | |
245 | |
246 (defcustom c-strict-syntax-p nil | |
247 "*If non-nil, all syntactic symbols must be found in `c-offsets-alist'. | |
248 If the syntactic symbol for a particular line does not match a symbol | |
249 in the offsets alist, or if no non-nil offset value can be determined | |
250 for a symbol, an error is generated, otherwise no error is reported | |
251 and the syntactic symbol is ignored. | |
252 | |
253 This variable is considered obsolete; it doesn't work well with lineup | |
254 functions that return nil to support the feature of using lists on | |
255 syntactic symbols in `c-offsets-alist'. Please keep it set to nil." | |
256 :type 'boolean | |
257 :group 'c) | |
258 | |
259 (defcustom c-echo-syntactic-information-p nil | |
260 "*If non-nil, syntactic info is echoed when the line is indented." | |
261 :type 'boolean | |
262 :group 'c) | |
263 | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
264 (defcustom c-report-syntactic-errors nil |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
265 "*If non-nil, certain syntactic errors are reported with a ding |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
266 and a message, for example when an \"else\" is indented for which |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
267 there's no corresponding \"if\". |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
268 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
269 Note however that CC Mode doesn't make any special effort to check for |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
270 syntactic errors; that's the job of the compiler. The reason it can |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
271 report cases like the one above is that it can't find the correct |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
272 anchoring position to indent the line in that case." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
273 :type 'boolean |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
274 :group 'c) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
275 |
26817 | 276 (defcustom-c-stylevar c-basic-offset 4 |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
277 "*Amount of basic offset used by + and - symbols in `c-offsets-alist'. |
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
278 Also used as the indentation step when `c-syntactic-indentation' is |
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
279 nil." |
26817 | 280 :type 'integer |
281 :group 'c) | |
70590
63b772bfba93
Move `safe-local-variable' declarations to the respective files.
Reiner Steib <Reiner.Steib@gmx.de>
parents:
69140
diff
changeset
|
282 ;;;###autoload(put 'c-basic-offset 'safe-local-variable 'integerp) |
26817 | 283 |
18720 | 284 (defcustom c-tab-always-indent t |
285 "*Controls the operation of the TAB key. | |
56646
b7446b6f097d
Updated CC Mode to 5.30.9.
Martin Stjernholm <mast@lysator.liu.se>
parents:
53073
diff
changeset
|
286 If t, hitting TAB always just indents the current line. If nil, hitting |
b7446b6f097d
Updated CC Mode to 5.30.9.
Martin Stjernholm <mast@lysator.liu.se>
parents:
53073
diff
changeset
|
287 TAB indents the current line if point is at the left margin or in the |
100111
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
288 line's indentation, otherwise it calls `c-insert-tab-function' to |
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
289 insert a `real' tab character. If some other value (neither nil nor t), |
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
290 then inserts a tab only within literals (comments and strings), but |
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
291 always reindents the line. |
18720 | 292 |
100111
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
293 Note: the variable `c-comment-only-line-offset' also controls the |
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
294 indentation of lines containing only comments." |
18720 | 295 :type '(radio |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
296 (const :tag "TAB key always indents, never inserts TAB" t) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
297 (const :tag "TAB key indents in left margin, otherwise inserts TAB" nil) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
298 (other :tag "TAB key inserts TAB in literals, otherwise indents" other)) |
18720 | 299 :group 'c) |
300 | |
301 (defcustom c-insert-tab-function 'insert-tab | |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
302 "*Function used when inserting a tab for \\[c-indent-command]. |
18720 | 303 Only used when `c-tab-always-indent' indicates a `real' tab character |
100111
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
304 should be inserted. Value must be a function taking no arguments. |
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
305 The default, `insert-tab', inserts either a tab or the equivalent |
70331b8d068a
(c-tab-always-indent, c-insert-tab-function): Doc fix. (Bug#1368)
Glenn Morris <rgm@gnu.org>
parents:
94673
diff
changeset
|
306 number of spaces depending on the value of `indent-tabs-mode'." |
18720 | 307 :type 'function |
308 :group 'c) | |
309 | |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
310 (defcustom c-syntactic-indentation t |
36920 | 311 "*Whether the indentation should be controlled by the syntactic context. |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
312 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
313 If t, the indentation functions indent according to the syntactic |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
314 context, using the style settings specified by `c-offsets-alist'. |
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
315 |
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
316 If nil, every line is just indented to the same level as the previous |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
317 one, and the \\[c-indent-command] command adjusts the indentation in |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
318 steps specified by `c-basic-offset'. The indentation style has no |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
319 effect in this mode, nor any of the indentation associated variables, |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
320 e.g. `c-special-indent-hook'." |
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
321 :type 'boolean |
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
322 :group 'c) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
323 (make-variable-buffer-local 'c-syntactic-indentation) |
79885
897a4cc5c95d
* progmodes/sh-script.el (sh-basic-offset):
Dan Nicolaescu <dann@ics.uci.edu>
parents:
79860
diff
changeset
|
324 (put 'c-syntactic-indentation 'safe-local-variable 'booleanp) |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
325 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
326 (defcustom c-syntactic-indentation-in-macros t |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
327 "*Enable syntactic analysis inside macros. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
328 If this is nil, all lines inside macro definitions are analyzed as |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
329 `cpp-macro-cont'. Otherwise they are analyzed syntactically, just |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
330 like normal code, and `cpp-define-intro' is used to create the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
331 additional indentation of the bodies of \"#define\" macros. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
332 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
333 Having this enabled simplifies editing of large multiline macros, but |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
334 it might complicate editing if CC Mode doesn't recognize the context |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
335 of the macro content. The default context inside the macro is the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
336 same as the top level, so if it contains \"bare\" statements they |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
337 might be indented wrongly, although there are special cases that |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
338 handle this in most cases. If this problem occurs, it's usually |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
339 countered easily by surrounding the statements by a block \(or even |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
340 better with the \"do { ... } while \(0)\" trick)." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
341 :type 'boolean |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
342 :group 'c) |
79885
897a4cc5c95d
* progmodes/sh-script.el (sh-basic-offset):
Dan Nicolaescu <dann@ics.uci.edu>
parents:
79860
diff
changeset
|
343 (put 'c-syntactic-indentation-in-macros 'safe-local-variable 'booleanp) |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
344 |
26817 | 345 (defcustom-c-stylevar c-comment-only-line-offset 0 |
18720 | 346 "*Extra offset for line which contains only the start of a comment. |
347 Can contain an integer or a cons cell of the form: | |
348 | |
349 (NON-ANCHORED-OFFSET . ANCHORED-OFFSET) | |
350 | |
351 Where NON-ANCHORED-OFFSET is the amount of offset given to | |
352 non-column-zero anchored comment-only lines, and ANCHORED-OFFSET is | |
353 the amount of offset to give column-zero anchored comment-only lines. | |
26817 | 354 Just an integer as value is equivalent to (<val> . -1000). |
355 | |
356 Note that this variable only has effect when the `c-lineup-comment' | |
357 lineup function is used on the `comment-intro' syntactic symbol (the | |
358 default)." | |
359 :type '(choice (integer :tag "Non-anchored offset" 0) | |
18720 | 360 (cons :tag "Non-anchored & anchored offset" |
361 :value (0 . 0) | |
362 (integer :tag "Non-anchored offset") | |
363 (integer :tag "Anchored offset"))) | |
364 :group 'c) | |
365 | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
366 (defcustom-c-stylevar c-indent-comment-alist |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
367 '((anchored-comment . (column . 0)) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
368 (end-block . (space . 1)) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
369 (cpp-end-block . (space . 2))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
370 "*Specifies how \\[indent-for-comment] calculates the comment start column. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
371 This is an association list that contains entries of the form: |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
372 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
373 (LINE-TYPE . INDENT-SPEC) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
374 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
375 LINE-TYPE specifies a type of line as described below, and INDENT-SPEC |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
376 says what \\[indent-for-comment] should do when used on that type of line. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
377 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
378 The recognized values for LINE-TYPE are: |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
379 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
380 empty-line -- The line is empty. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
381 anchored-comment -- The line contains a comment that starts in column 0. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
382 end-block -- The line contains a solitary block closing brace. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
383 cpp-end-block -- The line contains a preprocessor directive that |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
384 closes a block, i.e. either \"#endif\" or \"#else\". |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
385 other -- The line does not match any other entry |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
386 currently on the list. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
387 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
388 An INDENT-SPEC is a cons cell of the form: |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
389 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
390 (ACTION . VALUE) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
391 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
392 ACTION says how \\[indent-for-comment] should align the comment, and |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
393 VALUE is interpreted depending on ACTION. ACTION can be any of the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
394 following: |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
395 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
396 space -- Put VALUE spaces between the end of the line and the start |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
397 of the comment. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
398 column -- Start the comment at the column VALUE. If the line is |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
399 longer than that, the comment is preceded by a single |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
400 space. If VALUE is nil, `comment-column' is used. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
401 align -- Align the comment with one on the previous line, if there |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
402 is any. If the line is too long, the comment is preceded |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
403 by a single space. If there isn't a comment start on the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
404 previous line, the behavior is specified by VALUE, which |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
405 in turn is interpreted as an INDENT-SPEC. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
406 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
407 If a LINE-TYPE is missing, then \\[indent-for-comment] indents the comment |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
408 according to `comment-column'. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
409 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
410 Note that a non-nil value on `c-indent-comments-syntactically-p' |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
411 overrides this variable, so empty lines are indentented syntactically |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
412 in that case, i.e. as if \\[c-indent-command] was used instead." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
413 :type |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
414 (let ((space '(cons :tag "space" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
415 :format "%v" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
416 :value (space . 1) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
417 (const :format "space " space) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
418 (integer :format "%v"))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
419 (column '(cons :tag "column" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
420 :format "%v" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
421 (const :format "column " column) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
422 (c-integer-or-nil :format "%v")))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
423 `(set ,@(mapcar |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
424 (lambda (elt) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
425 `(cons :format "%v" |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
426 ,(c-constant-symbol elt 20) |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
427 (choice |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
428 :format "%[Choice%] %v" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
429 :value (column . nil) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
430 ,space |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
431 ,column |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
432 (cons :tag "align" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
433 :format "%v" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
434 (const :format "align " align) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
435 (choice |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
436 :format "%[Choice%] %v" |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
437 :value (column . nil) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
438 ,space |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
439 ,column))))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
440 '(empty-line anchored-comment end-block cpp-end-block other)))) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
441 :group 'c) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
442 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
443 (defcustom-c-stylevar c-indent-comments-syntactically-p nil |
26817 | 444 "*Specifies how \\[indent-for-comment] should handle comment-only lines. |
18720 | 445 When this variable is non-nil, comment-only lines are indented |
26817 | 446 according to syntactic analysis via `c-offsets-alist'. Otherwise, the |
447 comment is indented as if it was preceded by code. Note that this | |
448 variable does not affect how the normal line indentation treats | |
449 comment-only lines." | |
18720 | 450 :type 'boolean |
451 :group 'c) | |
452 | |
36920 | 453 (make-obsolete-variable 'c-comment-continuation-stars |
454 'c-block-comment-prefix) | |
455 | |
456 ;; Although c-comment-continuation-stars is obsolete, we look at it in | |
457 ;; some places in CC Mode anyway, so make the compiler ignore it | |
458 ;; during our compilation. | |
87320
80e1a8076c36
* progmodes/cc-vars.el (defcustom-c-stylevar): Eval VAL.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
79580
diff
changeset
|
459 ;; [This is unclean; better to use `symbol-value'. --ttn] |
80e1a8076c36
* progmodes/cc-vars.el (defcustom-c-stylevar): Eval VAL.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
79580
diff
changeset
|
460 ;;(cc-bytecomp-obsolete-var c-comment-continuation-stars) |
80e1a8076c36
* progmodes/cc-vars.el (defcustom-c-stylevar): Eval VAL.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
79580
diff
changeset
|
461 ;;(cc-bytecomp-defvar c-comment-continuation-stars) |
36920 | 462 |
26817 | 463 (defcustom-c-stylevar c-block-comment-prefix |
464 (if (boundp 'c-comment-continuation-stars) | |
87320
80e1a8076c36
* progmodes/cc-vars.el (defcustom-c-stylevar): Eval VAL.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents:
79580
diff
changeset
|
465 (symbol-value 'c-comment-continuation-stars) |
26817 | 466 "* ") |
467 "*Specifies the line prefix of continued C-style block comments. | |
19298
4a99e63dc4a9
(c-buffer-is-cc-mode): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
19255
diff
changeset
|
468 You should set this variable to the literal string that gets inserted |
4a99e63dc4a9
(c-buffer-is-cc-mode): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
19255
diff
changeset
|
469 at the front of continued block style comment lines. This should |
26817 | 470 either be the empty string, or some characters without preceding |
471 spaces. To adjust the alignment under the comment starter, put an | |
472 appropriate value on the `c' syntactic symbol (see the | |
473 `c-offsets-alist' variable). | |
474 | |
475 It's only used when a one-line block comment is broken into two or | |
476 more lines for the first time; otherwise the appropriate prefix is | |
477 adapted from the comment. This variable is not used for C++ line | |
478 style comments." | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
479 :type 'string |
19298
4a99e63dc4a9
(c-buffer-is-cc-mode): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
19255
diff
changeset
|
480 :group 'c) |
4a99e63dc4a9
(c-buffer-is-cc-mode): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
19255
diff
changeset
|
481 |
36920 | 482 (defcustom-c-stylevar c-comment-prefix-regexp |
483 '((pike-mode . "//+!?\\|\\**") | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
484 (awk-mode . "#+") |
36920 | 485 (other . "//+\\|\\**")) |
26817 | 486 "*Regexp to match the line prefix inside comments. |
487 This regexp is used to recognize the fill prefix inside comments for | |
488 correct paragraph filling and other things. | |
489 | |
36920 | 490 If this variable is a string, it will be used in all CC Mode major |
491 modes. It can also be an association list, to associate specific | |
492 regexps to specific major modes. The symbol for the major mode is | |
493 looked up in the association list, and its value is used as the line | |
494 prefix regexp. If it's not found, then the symbol `other' is looked | |
495 up and its value is used instead. | |
496 | |
497 The regexp should match the prefix used in both C++ style line | |
498 comments and C style block comments, but it does not need to match a | |
499 block comment starter. In other words, it should at least match | |
500 \"//\" for line comments and the string in `c-block-comment-prefix', | |
501 which is sometimes inserted by CC Mode inside block comments. It | |
502 should not match any surrounding whitespace. | |
26817 | 503 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
504 Note that CC Mode uses this variable to set many other variables that |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
505 handle the paragraph filling. That's done at mode initialization or |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
506 when you switch to a style which sets this variable. Thus, if you |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
507 change it in some other way, e.g. interactively in a CC Mode buffer, |
52609
ce6cc36ebb7c
(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'
Martin Stjernholm <mast@lysator.liu.se>
parents:
52401
diff
changeset
|
508 you will need to do \\[c-setup-paragraph-variables] afterwards so that |
ce6cc36ebb7c
(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'
Martin Stjernholm <mast@lysator.liu.se>
parents:
52401
diff
changeset
|
509 the other variables are updated with the new value. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
510 |
52609
ce6cc36ebb7c
(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'
Martin Stjernholm <mast@lysator.liu.se>
parents:
52401
diff
changeset
|
511 Note also that when CC Mode starts up, all variables are initialized |
ce6cc36ebb7c
(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'
Martin Stjernholm <mast@lysator.liu.se>
parents:
52401
diff
changeset
|
512 before the mode hooks are run. It's therefore necessary to make a |
ce6cc36ebb7c
(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'
Martin Stjernholm <mast@lysator.liu.se>
parents:
52401
diff
changeset
|
513 call to `c-setup-paragraph-variables' explicitly if you change this |
ce6cc36ebb7c
(c-comment-prefix-regexp): Document that `c-setup-paragraph-variables'
Martin Stjernholm <mast@lysator.liu.se>
parents:
52401
diff
changeset
|
514 variable in a mode hook." |
36920 | 515 :type '(radio |
516 (regexp :tag "Regexp for all modes") | |
517 (list | |
518 :tag "Mode-specific regexps" | |
519 (set | |
520 :inline t :format "%v" | |
521 (cons :format "%v" | |
522 (const :format "C " c-mode) (regexp :format "%v")) | |
523 (cons :format "%v" | |
524 (const :format "C++ " c++-mode) (regexp :format "%v")) | |
525 (cons :format "%v" | |
526 (const :format "ObjC " objc-mode) (regexp :format "%v")) | |
527 (cons :format "%v" | |
528 (const :format "Java " java-mode) (regexp :format "%v")) | |
529 (cons :format "%v" | |
530 (const :format "IDL " idl-mode) (regexp :format "%v")) | |
531 (cons :format "%v" | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
532 (const :format "Pike " pike-mode) (regexp :format "%v")) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
533 (cons :format "%v" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
534 (const :format "AWK " awk-mode) (regexp :format "%v"))) |
36920 | 535 (cons :format " %v" |
536 (const :format "Other " other) (regexp :format "%v")))) | |
26817 | 537 :group 'c) |
538 | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
539 (defcustom-c-stylevar c-doc-comment-style |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
540 '((java-mode . javadoc) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
541 (pike-mode . autodoc) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
542 (c-mode . gtkdoc)) |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
543 "*Specifies documentation comment style(s) to recognize. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
544 This is primarily used to fontify doc comments and the markup within |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
545 them, e.g. Javadoc comments. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
546 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
547 The value can be any of the following symbols for various known doc |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
548 comment styles: |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
549 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
550 javadoc -- Javadoc style for \"/** ... */\" comments (default in Java mode). |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
551 autodoc -- Pike autodoc style for \"//! ...\" comments (default in Pike mode). |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
552 gtkdoc -- GtkDoc style for \"/** ... **/\" comments (default in C mode). |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
553 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
554 The value may also be a list of doc comment styles, in which case all |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
555 of them are recognized simultaneously (presumably with markup cues |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
556 that don't conflict). |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
557 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
558 The value may also be an association list to specify different doc |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
559 comment styles for different languages. The symbol for the major mode |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
560 is then looked up in the alist, and the value of that element is |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
561 interpreted as above if found. If it isn't found then the symbol |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
562 `other' is looked up and its value is used instead. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
563 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
564 Note that CC Mode uses this variable to set other variables that |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
565 handle fontification etc. That's done at mode initialization or when |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
566 you switch to a style which sets this variable. Thus, if you change |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
567 it in some other way, e.g. interactively in a CC Mode buffer, you will |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
568 need to do \\[java-mode] (or whatever mode you're currently using) to |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
569 reinitialize. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
570 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
571 Note also that when CC Mode starts up, the other variables are |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
572 modified before the mode hooks are run. If you change this variable |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
573 in a mode hook, you have to call `c-setup-doc-comment-style' |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
574 afterwards to redo that work." |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
575 ;; Symbols other than those documented above may be used on this |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
576 ;; variable. If a variable exists that has that name with |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
577 ;; "-font-lock-keywords" appended, it's value is prepended to the |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
578 ;; font lock keywords list. If it's a function then it's called and |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
579 ;; the result is prepended. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
580 :type '(radio |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
581 (c-symbol-list :tag "Doc style(s) in all modes") |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
582 (list |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
583 :tag "Mode-specific doc styles" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
584 (set |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
585 :inline t :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
586 (cons :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
587 (const :format "C " c-mode) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
588 (c-symbol-list :format "%v")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
589 (cons :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
590 (const :format "C++ " c++-mode) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
591 (c-symbol-list :format "%v")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
592 (cons :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
593 (const :format "ObjC " objc-mode) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
594 (c-symbol-list :format "%v")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
595 (cons :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
596 (const :format "Java " java-mode) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
597 (c-symbol-list :format "%v")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
598 (cons :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
599 (const :format "IDL " idl-mode) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
600 (c-symbol-list :format "%v")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
601 (cons :format "%v" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
602 (const :format "Pike " pike-mode) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
603 (c-symbol-list :format "%v")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
604 (cons :format "%v" |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
605 (const :format "AWK " awk-mode) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
606 (c-symbol-list :format "%v")) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
607 (cons :format "%v" |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
608 (const :format "Other " other) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
609 (c-symbol-list :format "%v"))))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
610 :group 'c) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
611 |
26817 | 612 (defcustom c-ignore-auto-fill '(string cpp code) |
613 "*List of contexts in which automatic filling never occurs. | |
614 If Auto Fill mode is active, it will be temporarily disabled if point | |
615 is in any context on this list. It's e.g. useful to enable Auto Fill | |
616 in comments only, but not in strings or normal code. The valid | |
617 contexts are: | |
618 | |
619 string -- inside a string or character literal | |
620 c -- inside a C style block comment | |
621 c++ -- inside a C++ style line comment | |
622 cpp -- inside a preprocessor directive | |
623 code -- anywhere else, i.e. in normal code" | |
624 :type '(set | |
625 (const :tag "String literals" string) | |
626 (const :tag "C style block comments" c) | |
627 (const :tag "C++ style line comments" c++) | |
628 (const :tag "Preprocessor directives" cpp) | |
629 (const :tag "Normal code" code)) | |
630 :group 'c) | |
631 | |
632 (defcustom-c-stylevar c-cleanup-list '(scope-operator) | |
18720 | 633 "*List of various C/C++/ObjC constructs to \"clean up\". |
36920 | 634 The following clean ups only take place when the auto-newline feature |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
635 is turned on, as evidenced by the `/la' appearing next to the mode |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
636 name: |
18720 | 637 |
36920 | 638 brace-else-brace -- Clean up \"} else {\" constructs by placing |
639 entire construct on a single line. This clean | |
640 up only takes place when there is nothing but | |
18720 | 641 white space between the braces and the `else'. |
26817 | 642 Clean up occurs when the open brace after the |
18720 | 643 `else' is typed. |
36920 | 644 brace-elseif-brace -- Similar to brace-else-brace, but clean up |
645 \"} else if (...) {\" constructs. Clean up | |
646 occurs after the open parenthesis and the open | |
647 brace. | |
648 brace-catch-brace -- Similar to brace-elseif-brace, but clean up | |
649 \"} catch (...) {\" constructs. | |
650 empty-defun-braces -- Clean up empty defun braces by placing the | |
18720 | 651 braces on the same line. Clean up occurs when |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
652 the defun closing brace is typed. |
75027
9f636bd65206
Update CC Mode to version 5.31.4. The detailed changes are those
Alan Mackenzie <acm@muc.de>
parents:
74372
diff
changeset
|
653 one-liner-defun -- If the code inside a function body can fit in |
9f636bd65206
Update CC Mode to version 5.31.4. The detailed changes are those
Alan Mackenzie <acm@muc.de>
parents:
74372
diff
changeset
|
654 a single line, then remove any newlines |
9f636bd65206
Update CC Mode to version 5.31.4. The detailed changes are those
Alan Mackenzie <acm@muc.de>
parents:
74372
diff
changeset
|
655 between that line and the defun braces so that |
9f636bd65206
Update CC Mode to version 5.31.4. The detailed changes are those
Alan Mackenzie <acm@muc.de>
parents:
74372
diff
changeset
|
656 the whole body becomes a single line. |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
657 `c-max-one-liner-length' gives the maximum |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
658 length allowed for the resulting line. Clean |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
659 up occurs when the closing brace is typed. |
36920 | 660 defun-close-semi -- Clean up the terminating semi-colon on defuns |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
661 by placing the semi-colon on the same line as |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
662 the closing brace. Clean up occurs when the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
663 semi-colon is typed. |
36920 | 664 list-close-comma -- Clean up commas following braces in array |
18720 | 665 and aggregate initializers. Clean up occurs |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
666 when the comma is typed. |
36920 | 667 scope-operator -- Clean up double colons which may designate |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
668 a C++ scope operator split across multiple |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
669 lines. Note that certain C++ constructs can |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
670 generate ambiguous situations. This clean up |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
671 only takes place when there is nothing but |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
672 whitespace between colons. Clean up occurs |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
673 when the second colon is typed. |
36920 | 674 |
675 The following clean ups always take place when they are on this list, | |
676 regardless of the auto-newline feature, since they typically don't | |
677 involve auto-newline inserted newlines: | |
678 | |
679 space-before-funcall -- Insert exactly one space before the opening | |
680 parenthesis of a function call. Clean up | |
681 occurs when the opening parenthesis is typed. | |
682 compact-empty-funcall -- Clean up any space before the function call | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
683 opening parenthesis if and only if the |
36920 | 684 argument list is empty. This is typically |
685 useful together with `space-before-funcall' to | |
686 get the style \"foo (bar)\" and \"foo()\". | |
687 Clean up occurs when the closing parenthesis | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
688 is typed. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
689 comment-close-slash -- When a slash is typed after the comment prefix |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
690 on a bare line in a c-style comment, the comment |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
691 is closed by cleaning up preceding space and |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
692 inserting a star if needed." |
18720 | 693 :type '(set |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
694 (const :tag "Put \"} else {\" on one line (brace-else-brace)" |
36920 | 695 brace-else-brace) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
696 (const :tag "Put \"} else if (...) {\" on one line (brace-elseif-brace)" |
36920 | 697 brace-elseif-brace) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
698 (const :tag "Put \"} catch (...) {\" on one line (brace-catch-brace)" |
36920 | 699 brace-catch-brace) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
700 (const :tag "Put empty defun braces on one line (empty-defun-braces)" |
36920 | 701 empty-defun-braces) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
702 (const :tag "Put short function bodies on one line (one-liner-defun)" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
703 one-liner-defun) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
704 (const :tag "Put \"};\" ending defuns on one line (defun-close-semi)" |
36920 | 705 defun-close-semi) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
706 (const :tag "Put \"},\" in aggregates on one line (list-close-comma)" |
36920 | 707 list-close-comma) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
708 (const :tag "Put C++ style \"::\" on one line (scope-operator)" |
36920 | 709 scope-operator) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
710 (const :tag "Put a space before funcall parens, e.g. \"foo (bar)\" (space-before-funcall)" |
36920 | 711 space-before-funcall) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
712 (const :tag "Remove space before empty funcalls, e.g. \"foo()\" (compact-empty-funcall)" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
713 compact-empty-funcall) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
714 (const :tag "Make / on a bare line of a C-style comment close it (comment-close-slash)" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
715 comment-close-slash)) |
18720 | 716 :group 'c) |
717 | |
26817 | 718 (defcustom-c-stylevar c-hanging-braces-alist '((brace-list-open) |
719 (brace-entry-open) | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
720 (statement-cont) |
26817 | 721 (substatement-open after) |
722 (block-close . c-snug-do-while) | |
723 (extern-lang-open after) | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
724 (namespace-open after) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
725 (module-open after) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
726 (composition-open after) |
26817 | 727 (inexpr-class-open after) |
88022
a31afa284500
Introduce elements for the syntactic symbol arglist-cont-nonempty into
Alan Mackenzie <acm@muc.de>
parents:
87903
diff
changeset
|
728 (inexpr-class-close before) |
a31afa284500
Introduce elements for the syntactic symbol arglist-cont-nonempty into
Alan Mackenzie <acm@muc.de>
parents:
87903
diff
changeset
|
729 (arglist-cont-nonempty)) |
26817 | 730 "*Controls the insertion of newlines before and after braces |
731 when the auto-newline feature is active. This variable contains an | |
732 association list with elements of the following form: | |
733 \(SYNTACTIC-SYMBOL . ACTION). | |
18720 | 734 |
735 When a brace (either opening or closing) is inserted, the syntactic | |
736 context it defines is looked up in this list, and if found, the | |
737 associated ACTION is used to determine where newlines are inserted. | |
738 If the context is not found, the default is to insert a newline both | |
739 before and after the brace. | |
740 | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
741 SYNTACTIC-SYMBOL can be statement-cont, brace-list-intro, |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
742 inexpr-class-open, inexpr-class-close, and any of the *-open and |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
743 *-close symbols. See `c-offsets-alist' for details, except for |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
744 inexpr-class-open and inexpr-class-close, which doesn't have any |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
745 corresponding symbols there. Those two symbols are used for the |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
746 opening and closing braces, respectively, of anonymous inner classes |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
747 in Java. |
18720 | 748 |
749 ACTION can be either a function symbol or a list containing any | |
750 combination of the symbols `before' or `after'. If the list is empty, | |
751 no newlines are inserted either before or after the brace. | |
752 | |
753 When ACTION is a function symbol, the function is called with a two | |
754 arguments: the syntactic symbol for the brace and the buffer position | |
755 at which the brace was inserted. The function must return a list as | |
756 described in the preceding paragraph. Note that during the call to | |
757 the function, the variable `c-syntactic-context' is set to the entire | |
758 syntactic context for the brace line." | |
26817 | 759 :type |
760 `(set ,@(mapcar | |
761 (lambda (elt) | |
762 `(cons :format "%v" | |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
763 ,(c-constant-symbol elt 24) |
26817 | 764 (choice :format "%[Choice%] %v" |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
765 :value (before after) |
26817 | 766 (set :menu-tag "Before/after" |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
767 :format "Newline %v brace\n" |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
768 (const :format "%v, " before) |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
769 (const :format "%v " after)) |
26817 | 770 (function :menu-tag "Function" |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
771 :format "Run function: %v")))) |
26817 | 772 '(defun-open defun-close |
773 class-open class-close | |
774 inline-open inline-close | |
775 block-open block-close | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
776 statement-cont substatement-open statement-case-open |
26817 | 777 brace-list-open brace-list-close |
778 brace-list-intro brace-entry-open | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
779 extern-lang-open extern-lang-close |
26817 | 780 namespace-open namespace-close |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
781 module-open module-close |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
782 composition-open composition-close |
88022
a31afa284500
Introduce elements for the syntactic symbol arglist-cont-nonempty into
Alan Mackenzie <acm@muc.de>
parents:
87903
diff
changeset
|
783 inexpr-class-open inexpr-class-close |
a31afa284500
Introduce elements for the syntactic symbol arglist-cont-nonempty into
Alan Mackenzie <acm@muc.de>
parents:
87903
diff
changeset
|
784 arglist-cont-nonempty))) |
26817 | 785 :group 'c) |
18720 | 786 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
787 (defcustom c-max-one-liner-length 80 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
788 "Maximum length of line that clean-up \"one-liner-defun\" will compact to. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
789 Zero or nil means no limit." |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
790 :type 'integer |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
791 :group 'c) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
792 |
26817 | 793 (defcustom-c-stylevar c-hanging-colons-alist nil |
18720 | 794 "*Controls the insertion of newlines before and after certain colons. |
795 This variable contains an association list with elements of the | |
796 following form: (SYNTACTIC-SYMBOL . ACTION). | |
797 | |
798 SYNTACTIC-SYMBOL can be any of: case-label, label, access-label, | |
799 member-init-intro, or inher-intro. | |
800 | |
801 See the variable `c-hanging-braces-alist' for the semantics of this | |
802 variable. Note however that making ACTION a function symbol is | |
803 currently not supported for this variable." | |
26817 | 804 :type |
805 `(set ,@(mapcar | |
806 (lambda (elt) | |
807 `(cons :format "%v" | |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
808 ,(c-constant-symbol elt 20) |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
809 (set :format "Newline %v colon\n" |
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
810 (const :format "%v, " before) |
26817 | 811 (const :format "%v" after)))) |
812 '(case-label label access-label member-init-intro inher-intro))) | |
18720 | 813 :group 'c) |
814 | |
26817 | 815 (defcustom-c-stylevar c-hanging-semi&comma-criteria |
816 '(c-semi&comma-inside-parenlist) | |
18720 | 817 "*List of functions that decide whether to insert a newline or not. |
818 The functions in this list are called, in order, whenever the | |
819 auto-newline minor mode is activated (as evidenced by a `/a' or `/ah' | |
820 string in the mode line), and a semicolon or comma is typed (see | |
821 `c-electric-semi&comma'). Each function in this list is called with | |
822 no arguments, and should return one of the following values: | |
823 | |
824 nil -- no determination made, continue checking | |
825 'stop -- do not insert a newline, and stop checking | |
826 (anything else) -- insert a newline, and stop checking | |
827 | |
828 If every function in the list is called with no determination made, | |
829 then no newline is inserted." | |
830 :type '(repeat function) | |
831 :group 'c) | |
832 | |
26817 | 833 (defcustom-c-stylevar c-backslash-column 48 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
834 "*Minimum alignment column for line continuation backslashes. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
835 This is used by the functions that automatically insert or align the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
836 line continuation backslashes in multiline macros. If any line in the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
837 macro exceeds this column then the next tab stop from that line is |
74205
b3f1ef7ff72f
(c-backslash-column): Add . at end of sentence.
Jan Djärv <jan.h.d@swipnet.se>
parents:
74179
diff
changeset
|
838 used as alignment column instead. See also `c-backslash-max-column'." |
18720 | 839 :type 'integer |
840 :group 'c) | |
70773
35e35b506682
(c-backslash-column): Mark as safe if its value is an integer.
Eli Zaretskii <eliz@gnu.org>
parents:
70590
diff
changeset
|
841 ;;;###autoload(put 'c-backslash-column 'safe-local-variable 'integerp) |
18720 | 842 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
843 (defcustom-c-stylevar c-backslash-max-column 72 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
844 "*Maximum alignment column for line continuation backslashes. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
845 This is used by the functions that automatically insert or align the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
846 line continuation backslashes in multiline macros. If any line in the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
847 macro exceeds this column then the backslashes for the other lines |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
848 will be aligned at this column." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
849 :type 'integer |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
850 :group 'c) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
851 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
852 (defcustom c-auto-align-backslashes t |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
853 "*Align automatically inserted line continuation backslashes. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
854 When line continuation backslashes are inserted automatically for line |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
855 breaks in multiline macros, e.g. by \\[c-context-line-break], they are |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
856 aligned with the other backslashes in the same macro if this flag is |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
857 set. Otherwise the inserted backslashes are preceded by a single |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
858 space." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
859 :type 'boolean |
18720 | 860 :group 'c) |
861 | |
862 (defcustom c-backspace-function 'backward-delete-char-untabify | |
863 "*Function called by `c-electric-backspace' when deleting backwards." | |
864 :type 'function | |
865 :group 'c) | |
866 | |
867 (defcustom c-delete-function 'delete-char | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
868 "*Function called by `c-electric-delete-forward' when deleting forwards." |
18720 | 869 :type 'function |
870 :group 'c) | |
871 | |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
872 (defcustom c-require-final-newline |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
873 ;; C and C++ mandate that all nonempty files should end with a |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
874 ;; newline. Objective-C refers to C for all things it doesn't |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
875 ;; specify, so the same holds there. The other languages do not |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
876 ;; require it (at least not explicitly in a normative text). |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
877 '((c-mode . t) |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
878 (c++-mode . t) |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
879 (objc-mode . t)) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
880 "*Controls whether a final newline is ensured when the file is saved. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
881 The value is an association list that for each language mode specifies |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
882 the value to give to `require-final-newline' at mode initialization; |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
883 see that variable for details about the value. If a language isn't |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
884 present on the association list, CC Mode won't touch |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
885 `require-final-newline' in buffers for that language." |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
886 :type `(set (cons :format "%v" |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
887 (const :format "C " c-mode) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
888 (symbol :format "%v" :value ,require-final-newline)) |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
889 (cons :format "%v" |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
890 (const :format "C++ " c++-mode) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
891 (symbol :format "%v" :value ,require-final-newline)) |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
892 (cons :format "%v" |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
893 (const :format "ObjC " objc-mode) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
894 (symbol :format "%v" :value ,require-final-newline)) |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
895 (cons :format "%v" |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
896 (const :format "Java " java-mode) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
897 (symbol :format "%v" :value ,require-final-newline)) |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
898 (cons :format "%v" |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
899 (const :format "IDL " idl-mode) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
900 (symbol :format "%v" :value ,require-final-newline)) |
49496
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
901 (cons :format "%v" |
2c05c557df6c
(c-require-final-newline): Made this variable an alist to specify a value
Martin Stjernholm <mast@lysator.liu.se>
parents:
49479
diff
changeset
|
902 (const :format "Pike " pike-mode) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
903 (symbol :format "%v" :value ,require-final-newline)) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
904 (cons :format "%v" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
905 (const :format "AWK " awk-mode) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
906 (symbol :format "%v" :value ,require-final-newline))) |
49470
13365bab7fce
(c-require-final-newline): Added a variable to make the initialization of
Martin Stjernholm <mast@lysator.liu.se>
parents:
48656
diff
changeset
|
907 :group 'c) |
13365bab7fce
(c-require-final-newline): Added a variable to make the initialization of
Martin Stjernholm <mast@lysator.liu.se>
parents:
48656
diff
changeset
|
908 |
18720 | 909 (defcustom c-electric-pound-behavior nil |
910 "*List of behaviors for electric pound insertion. | |
911 Only currently supported behavior is `alignleft'." | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
912 :type '(set (const alignleft)) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
913 :group 'c) |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
914 |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
915 (defcustom c-special-indent-hook nil |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
916 "*Hook for user defined special indentation adjustments. |
76948
7322915e700b
* (c-special-indent-hook): Amend doc-string to mention
Alan Mackenzie <acm@muc.de>
parents:
75516
diff
changeset
|
917 This hook gets called after each line is indented by the mode. It is only |
7322915e700b
* (c-special-indent-hook): Amend doc-string to mention
Alan Mackenzie <acm@muc.de>
parents:
75516
diff
changeset
|
918 called if `c-syntactic-indentation' is non-nil." |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
919 :type 'hook |
18720 | 920 :group 'c) |
921 | |
26817 | 922 (defcustom-c-stylevar c-label-minimum-indentation 1 |
53073
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
923 "*Minimum indentation for lines inside code blocks. |
18720 | 924 This variable typically only affects code using the `gnu' style, which |
53073
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
925 mandates a minimum of one space in front of every line inside code |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
926 blocks. Specifically, the function `c-gnu-impose-minimum' on your |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
927 `c-special-indent-hook' is what enforces this." |
18720 | 928 :type 'integer |
929 :group 'c) | |
930 | |
931 (defcustom c-progress-interval 5 | |
932 "*Interval used to update progress status during long re-indentation. | |
933 If a number, percentage complete gets updated after each interval of | |
20144
56d81cc7b4f5
(c-progress-interval): Document new semantics
Karl Heuer <kwzh@gnu.org>
parents:
20140
diff
changeset
|
934 that many seconds. To inhibit all messages during indentation, set |
56d81cc7b4f5
(c-progress-interval): Document new semantics
Karl Heuer <kwzh@gnu.org>
parents:
20140
diff
changeset
|
935 this variable to nil." |
18720 | 936 :type 'integer |
937 :group 'c) | |
938 | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
939 (defcustom c-default-style '((java-mode . "java") (awk-mode . "awk") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
940 (other . "gnu")) |
24282 | 941 "*Style which gets installed by default when a file is visited. |
20919
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
942 |
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
943 The value of this variable can be any style defined in |
24282 | 944 `c-style-alist', including styles you add. The value can also be an |
945 association list of major mode symbols to style names. | |
946 | |
947 When the value is a string, all CC Mode major modes will install this | |
36920 | 948 style by default. |
20919
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
949 |
26817 | 950 When the value is an alist, the major mode symbol is looked up in it |
951 and the associated style is installed. If the major mode is not | |
952 listed in the alist, then the symbol `other' is looked up in it, and | |
953 if found, the style in that entry is used. If `other' is not found in | |
954 the alist, then \"gnu\" style is used. | |
955 | |
956 The default style gets installed before your mode hooks run, so you | |
957 can always override the use of `c-default-style' by making calls to | |
36920 | 958 `c-set-style' in the appropriate mode hook." |
26817 | 959 :type '(radio |
36920 | 960 (string :tag "Style in all modes") |
961 (set :tag "Mode-specific styles" | |
962 (cons :format "%v" | |
963 (const :format "C " c-mode) (string :format "%v")) | |
964 (cons :format "%v" | |
965 (const :format "C++ " c++-mode) (string :format "%v")) | |
966 (cons :format "%v" | |
967 (const :format "ObjC " objc-mode) (string :format "%v")) | |
968 (cons :format "%v" | |
969 (const :format "Java " java-mode) (string :format "%v")) | |
970 (cons :format "%v" | |
971 (const :format "IDL " idl-mode) (string :format "%v")) | |
972 (cons :format "%v" | |
973 (const :format "Pike " pike-mode) (string :format "%v")) | |
974 (cons :format "%v" | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
975 (const :format "AWK " awk-mode) (string :format "%v")) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
976 (cons :format "%v" |
36920 | 977 (const :format "Other " other) (string :format "%v")))) |
26817 | 978 :group 'c) |
20919
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
979 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
980 ;; *) At the start of a statement or declaration means in more detail: |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
981 ;; At the closest preceding statement/declaration that starts at boi |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
982 ;; and doesn't have a label or comment at that position. If there's |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
983 ;; no such statement within the same block, then back up to the |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
984 ;; surrounding block or statement, add the appropriate |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
985 ;; statement-block-intro, defun-block-intro or substatement syntax |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
986 ;; symbol and continue searching. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
987 (c-set-stylevar-fallback 'c-offsets-alist |
26817 | 988 '((string . c-lineup-dont-change) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
989 ;; Anchor pos: Beg of previous line. |
26817 | 990 (c . c-lineup-C-comments) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
991 ;; Anchor pos: Beg of the comment. |
26817 | 992 (defun-open . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
993 ;; Anchor pos: When inside a class: Boi at the func decl start. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
994 ;; When at top level: Bol at the func decl start. When inside |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
995 ;; a code block (only possible in Pike): At the func decl |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
996 ;; start(*). |
26817 | 997 (defun-close . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
998 ;; Anchor pos: At the defun block open if it's at boi, |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
999 ;; otherwise boi at the func decl start. |
26817 | 1000 (defun-block-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1001 ;; Anchor pos: At the block open(*). |
26817 | 1002 (class-open . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1003 ;; Anchor pos: Boi at the class decl start. |
26817 | 1004 (class-close . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1005 ;; Anchor pos: Boi at the class decl start. |
26817 | 1006 (inline-open . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1007 ;; Anchor pos: None for functions (inclass got the relpos |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1008 ;; then), boi at the lambda start for lambdas. |
26817 | 1009 (inline-close . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1010 ;; Anchor pos: Inexpr functions: At the lambda block open if |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1011 ;; it's at boi, else at the statement(*) at boi of the start of |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1012 ;; the lambda construct. Otherwise: At the inline block open |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1013 ;; if it's at boi, otherwise boi at the func decl start. |
26817 | 1014 (func-decl-cont . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1015 ;; Anchor pos: Boi at the func decl start. |
26817 | 1016 (knr-argdecl-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1017 ;; Anchor pos: Boi at the topmost intro line. |
26817 | 1018 (knr-argdecl . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1019 ;; Anchor pos: At the beginning of the first K&R argdecl. |
26817 | 1020 (topmost-intro . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1021 ;; Anchor pos: Bol at the last line of previous construct. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1022 (topmost-intro-cont . c-lineup-topmost-intro-cont) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1023 ;; Anchor pos: Boi at the topmost intro line. |
26817 | 1024 (member-init-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1025 ;; Anchor pos: Boi at the func decl arglist open. |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
1026 (member-init-cont . c-lineup-multi-inher) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1027 ;; Anchor pos: Beg of the first member init. |
26817 | 1028 (inher-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1029 ;; Anchor pos: Boi at the class decl start. |
26817 | 1030 (inher-cont . c-lineup-multi-inher) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1031 ;; Anchor pos: Java: At the implements/extends keyword start. |
26817 | 1032 ;; Otherwise: At the inher start colon, or boi at the class |
1033 ;; decl start if the first inherit clause hangs and it's not a | |
1034 ;; func-local inherit clause (when does that occur?). | |
1035 (block-open . 0) | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1036 ;; Anchor pos: Inexpr statement: At the statement(*) at boi of |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1037 ;; the start of the inexpr construct. Otherwise: None. |
26817 | 1038 (block-close . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1039 ;; Anchor pos: Inexpr statement: At the inexpr block open if |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1040 ;; it's at boi, else at the statement(*) at boi of the start of |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1041 ;; the inexpr construct. Block hanging on a case/default |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1042 ;; label: At the closest preceding label that starts at boi. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1043 ;; Otherwise: At the block open(*). |
26817 | 1044 (brace-list-open . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1045 ;; Anchor pos: Boi at the brace list decl start, but a starting |
26817 | 1046 ;; "typedef" token is ignored. |
1047 (brace-list-close . 0) | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1048 ;; Anchor pos: At the brace list decl start(*). |
26817 | 1049 (brace-list-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1050 ;; Anchor pos: At the brace list decl start(*). |
26817 | 1051 (brace-list-entry . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1052 ;; Anchor pos: At the first non-ws char after the open paren if |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1053 ;; the first token is on the same line, otherwise boi at that |
26817 | 1054 ;; token. |
1055 (brace-entry-open . 0) | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1056 ;; Anchor pos: Same as brace-list-entry. |
26817 | 1057 (statement . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1058 ;; Anchor pos: After a `;' in the condition clause of a for |
26817 | 1059 ;; statement: At the first token after the starting paren. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1060 ;; Otherwise: At the preceding statement(*). |
26817 | 1061 (statement-cont . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1062 ;; Anchor pos: After the first token in the condition clause of |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1063 ;; a for statement: At the first token after the starting |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1064 ;; paren. Otherwise: At the containing statement(*). |
26817 | 1065 (statement-block-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1066 ;; Anchor pos: In inexpr statement block: At the inexpr block |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1067 ;; open if it's at boi, else at the statement(*) at boi of the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1068 ;; start of the inexpr construct. In a block hanging on a |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1069 ;; case/default label: At the closest preceding label that |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1070 ;; starts at boi. Otherwise: At the start of the containing |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1071 ;; block(*). |
26817 | 1072 (statement-case-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1073 ;; Anchor pos: At the case/default label(*). |
26817 | 1074 (statement-case-open . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1075 ;; Anchor pos: At the case/default label(*). |
26817 | 1076 (substatement . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1077 ;; Anchor pos: At the containing statement(*). |
26817 | 1078 (substatement-open . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1079 ;; Anchor pos: At the containing statement(*). |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1080 (substatement-label . 2) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1081 ;; Anchor pos: At the containing statement(*). |
26817 | 1082 (case-label . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1083 ;; Anchor pos: At the start of the switch block(*). |
26817 | 1084 (access-label . -) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1085 ;; Anchor pos: Same as inclass. |
26817 | 1086 (label . 2) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1087 ;; Anchor pos: At the start of the containing block(*). |
26817 | 1088 (do-while-closure . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1089 ;; Anchor pos: At the corresponding while statement(*). |
26817 | 1090 (else-clause . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1091 ;; Anchor pos: At the corresponding if statement(*). |
26817 | 1092 (catch-clause . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1093 ;; Anchor pos: At the previous try or catch statement clause(*). |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1094 (comment-intro . (c-lineup-knr-region-comment c-lineup-comment)) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1095 ;; Anchor pos: None. |
26817 | 1096 (arglist-intro . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1097 ;; Anchor pos: At the containing statement(*). |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1098 ;; 2nd pos: At the open paren. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1099 (arglist-cont . (c-lineup-gcc-asm-reg 0)) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1100 ;; Anchor pos: At the first token after the open paren. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1101 (arglist-cont-nonempty . (c-lineup-gcc-asm-reg c-lineup-arglist)) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1102 ;; Anchor pos: At the containing statement(*). |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1103 ;; 2nd pos: At the open paren. |
26817 | 1104 (arglist-close . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1105 ;; Anchor pos: At the containing statement(*). |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1106 ;; 2nd pos: At the open paren. |
26817 | 1107 (stream-op . c-lineup-streamop) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1108 ;; Anchor pos: Boi at the first stream op in the statement. |
26817 | 1109 (inclass . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1110 ;; Anchor pos: At the class open brace if it's at boi, |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1111 ;; otherwise boi at the class decl start. |
36920 | 1112 (cpp-macro . [0]) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1113 ;; Anchor pos: None. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1114 (cpp-macro-cont . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1115 ;; Anchor pos: At the macro start (always at boi). |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1116 (cpp-define-intro . (c-lineup-cpp-define +)) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1117 ;; Anchor pos: None. |
26817 | 1118 (friend . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1119 ;; Anchor pos: None. |
36920 | 1120 (objc-method-intro . [0]) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1121 ;; Anchor pos: Boi. |
26817 | 1122 (objc-method-args-cont . c-lineup-ObjC-method-args) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1123 ;; Anchor pos: At the method start (always at boi). |
26817 | 1124 (objc-method-call-cont . c-lineup-ObjC-method-call) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1125 ;; Anchor pos: At the open bracket. |
26817 | 1126 (extern-lang-open . 0) |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1127 (namespace-open . 0) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1128 (module-open . 0) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1129 (composition-open . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1130 ;; Anchor pos: Boi at the extern/namespace/etc keyword. |
26817 | 1131 (extern-lang-close . 0) |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1132 (namespace-close . 0) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1133 (module-close . 0) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1134 (composition-close . 0) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1135 ;; Anchor pos: Boi at the corresponding extern/namespace/etc keyword. |
26817 | 1136 (inextern-lang . +) |
1137 (innamespace . +) | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1138 (inmodule . +) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1139 (incomposition . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1140 ;; Anchor pos: At the extern/namespace/etc block open brace if |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1141 ;; it's at boi, otherwise boi at the keyword. |
26817 | 1142 (template-args-cont . (c-lineup-template-args +)) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1143 ;; Anchor pos: Boi at the decl start. This might be changed; |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1144 ;; the logical position is clearly the opening '<'. |
26817 | 1145 (inlambda . c-lineup-inexpr-block) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1146 ;; Anchor pos: None. |
26817 | 1147 (lambda-intro-cont . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1148 ;; Anchor pos: Boi at the lambda start. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1149 (inexpr-statement . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1150 ;; Anchor pos: None. |
26817 | 1151 (inexpr-class . +) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1152 ;; Anchor pos: None. |
26817 | 1153 )) |
1154 (defcustom c-offsets-alist nil | |
1155 "Association list of syntactic element symbols and indentation offsets. | |
1156 As described below, each cons cell in this list has the form: | |
24282 | 1157 |
26817 | 1158 (SYNTACTIC-SYMBOL . OFFSET) |
1159 | |
1160 When a line is indented, CC Mode first determines the syntactic | |
1161 context of it by generating a list of symbols called syntactic | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1162 elements. The global variable `c-syntactic-context' is bound to the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1163 that list. Each element in the list is in turn a list where the first |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1164 element is a syntactic symbol which tells what kind of construct the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1165 indentation point is located within. More elements in the syntactic |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1166 element lists are optional. If there is one more and it isn't nil, |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1167 then it's the anchor position for that construct. |
26817 | 1168 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1169 After generating the syntactic context for the line, CC Mode |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1170 calculates the absolute indentation: First the base indentation is |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1171 found by using the anchor position for the first syntactic element |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1172 that provides one. If none does, zero is used as base indentation. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1173 Then CC Mode looks at each syntactic element in the context in turn. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1174 It compares the car of the syntactic element against the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1175 SYNTACTIC-SYMBOL's in `c-offsets-alist'. When it finds a match, it |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1176 adds OFFSET to the base indentation. The sum of this calculation is |
26817 | 1177 the absolute offset for line being indented. |
1178 | |
1179 If the syntactic element does not match any in the `c-offsets-alist', | |
36920 | 1180 the element is ignored. |
1181 | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1182 OFFSET can specify an offset in several different ways: |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1183 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1184 If OFFSET is nil then it's ignored. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1185 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1186 If OFFSET is an integer then it's used as relative offset, i.e. it's |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1187 added to the base indentation. |
36920 | 1188 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1189 If OFFSET is one of the symbols `+', `-', `++', `--', `*', or `/' |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1190 then a positive or negative multiple of `c-basic-offset' is added to |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1191 the base indentation; 1, -1, 2, -2, 0.5, and -0.5, respectively. |
36920 | 1192 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1193 If OFFSET is a symbol with a value binding then that value, which |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1194 must be an integer, is used as relative offset. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1195 |
75516
befb5e26b9e7
(c-offsets-alist): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
75347
diff
changeset
|
1196 If OFFSET is a vector then its first element, which must be an |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1197 integer, is used as an absolute indentation column. This overrides |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1198 the previous base indentation and the relative offsets applied to |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1199 it, and it becomes the new base indentation. |
26817 | 1200 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1201 If OFFSET is a function or a lambda expression then it's called with |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1202 a single argument containing the cons of the syntactic symbol and |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1203 the anchor position (or nil if there is none). The return value |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1204 from the function is then reinterpreted as an offset specification. |
26817 | 1205 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1206 If OFFSET is a list then its elements are evaluated recursively as |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1207 offset specifications. If the first element is any of the symbols |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1208 below then it isn't evaluated but instead specifies how the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1209 remaining offsets in the list should be combined. If it's something |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1210 else then the list is combined according the method `first'. The |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1211 valid combination methods are: |
36920 | 1212 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1213 `first' -- Use the first offset (that doesn't evaluate to nil). |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1214 `min' -- Use the minimum of all the offsets. All must be either |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1215 relative or absolute - they can't be mixed. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1216 `max' -- Use the maximum of all the offsets. All must be either |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1217 relative or absolute - they can't be mixed. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1218 `add' -- Add all the evaluated offsets together. Exactly one of |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1219 them may be absolute, in which case the result is |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1220 absolute. Any relative offsets that preceded the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1221 absolute one in the list will be ignored in that case. |
26817 | 1222 |
1223 `c-offsets-alist' is a style variable. This means that the offsets on | |
1224 this variable are normally taken from the style system in CC Mode | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1225 \(see `c-default-style' and `c-style-alist'). However, any offsets |
26817 | 1226 put explicitly on this list will override the style system when a CC |
1227 Mode buffer is initialized \(there is a variable | |
1228 `c-old-style-variable-behavior' that changes this, though). | |
1229 | |
1230 Here is the current list of valid syntactic element symbols: | |
1231 | |
1232 string -- Inside multi-line string. | |
1233 c -- Inside a multi-line C style block comment. | |
1234 defun-open -- Brace that opens a function definition. | |
1235 defun-close -- Brace that closes a function definition. | |
1236 defun-block-intro -- The first line in a top-level defun. | |
1237 class-open -- Brace that opens a class definition. | |
1238 class-close -- Brace that closes a class definition. | |
1239 inline-open -- Brace that opens an in-class inline method. | |
1240 inline-close -- Brace that closes an in-class inline method. | |
1241 func-decl-cont -- The region between a function definition's | |
1242 argument list and the function opening brace | |
1243 (excluding K&R argument declarations). In C, you | |
1244 cannot put anything but whitespace and comments | |
1245 between them; in C++ and Java, throws declarations | |
1246 and other things can appear in this context. | |
1247 knr-argdecl-intro -- First line of a K&R C argument declaration. | |
1248 knr-argdecl -- Subsequent lines in a K&R C argument declaration. | |
1249 topmost-intro -- The first line in a topmost construct definition. | |
1250 topmost-intro-cont -- Topmost definition continuation lines. | |
1251 member-init-intro -- First line in a member initialization list. | |
1252 member-init-cont -- Subsequent member initialization list lines. | |
1253 inher-intro -- First line of a multiple inheritance list. | |
1254 inher-cont -- Subsequent multiple inheritance lines. | |
1255 block-open -- Statement block open brace. | |
1256 block-close -- Statement block close brace. | |
1257 brace-list-open -- Open brace of an enum or static array list. | |
1258 brace-list-close -- Close brace of an enum or static array list. | |
1259 brace-list-intro -- First line in an enum or static array list. | |
1260 brace-list-entry -- Subsequent lines in an enum or static array list. | |
1261 brace-entry-open -- Subsequent lines in an enum or static array | |
1262 list that start with an open brace. | |
1263 statement -- A C (or like) statement. | |
1264 statement-cont -- A continuation of a C (or like) statement. | |
1265 statement-block-intro -- The first line in a new statement block. | |
1266 statement-case-intro -- The first line in a case \"block\". | |
1267 statement-case-open -- The first line in a case block starting with brace. | |
1268 substatement -- The first line after an if/while/for/do/else. | |
1269 substatement-open -- The brace that opens a substatement block. | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1270 substatement-label -- Labelled line after an if/while/for/do/else. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1271 case-label -- A \"case\" or \"default\" label. |
26817 | 1272 access-label -- C++ private/protected/public access label. |
1273 label -- Any ordinary label. | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1274 do-while-closure -- The \"while\" that ends a do/while construct. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1275 else-clause -- The \"else\" of an if/else construct. |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1276 catch-clause -- The \"catch\" or \"finally\" of a try/catch construct. |
26817 | 1277 comment-intro -- A line containing only a comment introduction. |
1278 arglist-intro -- The first line in an argument list. | |
1279 arglist-cont -- Subsequent argument list lines when no | |
1280 arguments follow on the same line as the | |
1281 arglist opening paren. | |
1282 arglist-cont-nonempty -- Subsequent argument list lines when at | |
1283 least one argument follows on the same | |
1284 line as the arglist opening paren. | |
1285 arglist-close -- The solo close paren of an argument list. | |
1286 stream-op -- Lines continuing a stream operator construct. | |
1287 inclass -- The construct is nested inside a class definition. | |
1288 Used together with e.g. `topmost-intro'. | |
1289 cpp-macro -- The start of a C preprocessor macro definition. | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1290 cpp-macro-cont -- Inside a multi-line C preprocessor macro definition. |
26817 | 1291 friend -- A C++ friend declaration. |
1292 objc-method-intro -- The first line of an Objective-C method definition. | |
1293 objc-method-args-cont -- Lines continuing an Objective-C method definition. | |
1294 objc-method-call-cont -- Lines continuing an Objective-C method call. | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1295 extern-lang-open -- Brace that opens an \"extern\" block. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1296 extern-lang-close -- Brace that closes an \"extern\" block. |
26817 | 1297 inextern-lang -- Analogous to the `inclass' syntactic symbol, |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1298 but used inside \"extern\" blocks. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1299 namespace-open, namespace-close, innamespace |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1300 -- Similar to the three `extern-lang' symbols, but for |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1301 C++ \"namespace\" blocks. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1302 module-open, module-close, inmodule |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1303 -- Similar to the three `extern-lang' symbols, but for |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1304 CORBA IDL \"module\" blocks. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1305 composition-open, composition-close, incomposition |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1306 -- Similar to the three `extern-lang' symbols, but for |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1307 CORBA CIDL \"composition\" blocks. |
26817 | 1308 template-args-cont -- C++ template argument list continuations. |
1309 inlambda -- In the header or body of a lambda function. | |
1310 lambda-intro-cont -- Continuation of the header of a lambda function. | |
1311 inexpr-statement -- The statement is inside an expression. | |
1312 inexpr-class -- The class is inside an expression. Used e.g. for | |
1313 Java anonymous classes." | |
1314 :type | |
1315 `(set :format "%{%t%}: | |
1316 Override style setting | |
1317 | Syntax Offset | |
1318 %v" | |
1319 ,@(mapcar | |
1320 (lambda (elt) | |
1321 `(cons :format "%v" | |
1322 :value ,elt | |
79841
3a06f32d85f6
* (c-constant-symbol): New function which supersedes c-const-symbol.
Alan Mackenzie <acm@muc.de>
parents:
79717
diff
changeset
|
1323 ,(c-constant-symbol (car elt) 25) |
26817 | 1324 (sexp :format "%v" |
1325 :validate | |
1326 (lambda (widget) | |
1327 (unless (c-valid-offset (widget-value widget)) | |
1328 (widget-put widget :error "Invalid offset") | |
1329 widget))))) | |
1330 (get 'c-offsets-alist 'c-stylevar-fallback))) | |
18720 | 1331 :group 'c) |
1332 | |
53073
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1333 ;; The syntactic symbols that can occur inside code blocks. Used by |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1334 ;; `c-gnu-impose-minimum'. |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1335 (defconst c-inside-block-syms |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1336 '(defun-block-intro block-open block-close statement statement-cont |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1337 statement-block-intro statement-case-intro statement-case-open |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1338 substatement substatement-open substatement-label case-label label |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1339 do-while-closure else-clause catch-clause inlambda)) |
49f65e04ba8e
CC Mode update (5.30.8).
Martin Stjernholm <mast@lysator.liu.se>
parents:
52609
diff
changeset
|
1340 |
30399
7b0a7b155fe2
(c-style-variables-are-local-p): Incompatible
Gerd Moellmann <gerd@gnu.org>
parents:
26817
diff
changeset
|
1341 (defcustom c-style-variables-are-local-p t |
18720 | 1342 "*Whether style variables should be buffer local by default. |
1343 If non-nil, then all indentation style related variables will be made | |
1344 buffer local by default. If nil, they will remain global. Variables | |
1345 are made buffer local when this file is loaded, and once buffer | |
1346 localized, they cannot be made global again. | |
1347 | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1348 This variable must be set appropriately before CC Mode is loaded. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1349 |
18720 | 1350 The list of variables to buffer localize are: |
1351 c-basic-offset | |
1352 c-comment-only-line-offset | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1353 c-indent-comment-alist |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1354 c-indent-comments-syntactically-p |
26817 | 1355 c-block-comment-prefix |
1356 c-comment-prefix-regexp | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1357 c-doc-comment-style |
18720 | 1358 c-cleanup-list |
1359 c-hanging-braces-alist | |
1360 c-hanging-colons-alist | |
26817 | 1361 c-hanging-semi&comma-criteria |
18720 | 1362 c-backslash-column |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1363 c-backslash-max-column |
18720 | 1364 c-label-minimum-indentation |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1365 c-offsets-alist |
18720 | 1366 c-special-indent-hook |
1367 c-indentation-style" | |
1368 :type 'boolean | |
102278
527143cc2cfe
(c-style-variables-are-local-p): Mark as safe if boolean. (Bug#2197)
Glenn Morris <rgm@gnu.org>
parents:
101112
diff
changeset
|
1369 :safe 'booleanp |
18720 | 1370 :group 'c) |
1371 | |
1372 (defcustom c-mode-hook nil | |
1373 "*Hook called by `c-mode'." | |
26817 | 1374 :type 'hook |
18720 | 1375 :group 'c) |
1376 | |
1377 (defcustom c++-mode-hook nil | |
1378 "*Hook called by `c++-mode'." | |
1379 :type 'hook | |
1380 :group 'c) | |
1381 | |
1382 (defcustom objc-mode-hook nil | |
1383 "*Hook called by `objc-mode'." | |
1384 :type 'hook | |
1385 :group 'c) | |
1386 | |
1387 (defcustom java-mode-hook nil | |
1388 "*Hook called by `java-mode'." | |
1389 :type 'hook | |
1390 :group 'c) | |
1391 | |
19255
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1392 (defcustom idl-mode-hook nil |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1393 "*Hook called by `idl-mode'." |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1394 :type 'hook |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1395 :group 'c) |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1396 |
26817 | 1397 (defcustom pike-mode-hook nil |
1398 "*Hook called by `pike-mode'." | |
1399 :type 'hook | |
1400 :group 'c) | |
1401 | |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1402 (defcustom awk-mode-hook nil |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1403 "*Hook called by `awk-mode'." |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1404 :type 'hook |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1405 :group 'c) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1406 |
18720 | 1407 (defcustom c-mode-common-hook nil |
1408 "*Hook called by all CC Mode modes for common initializations." | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1409 :type 'hook |
18720 | 1410 :group 'c) |
1411 | |
19255
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1412 (defcustom c-initialization-hook nil |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1413 "*Hook called when the CC Mode package gets initialized. |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1414 This hook is only run once per Emacs session and can be used as a |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1415 `load-hook' or in place of using `eval-after-load'." |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1416 :type 'hook |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1417 :group 'c) |
40a9475f22ea
(idl-mode-hook): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
18848
diff
changeset
|
1418 |
24282 | 1419 (defcustom c-enable-xemacs-performance-kludge-p nil |
20919
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
1420 "*Enables a XEmacs only hack that may improve speed for some coding styles. |
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
1421 For styles that hang top-level opening braces (as is common with JDK |
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
1422 Java coding styles) this can improve performance between 3 and 60 |
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
1423 times for core indentation functions (e.g. `c-parse-state'). For |
9cffecf3b1ca
(c-enable-xemacs-performance-kludge-p): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
20144
diff
changeset
|
1424 styles that conform to the Emacs recommendation of putting these |
24282 | 1425 braces in column zero, this can degrade performance about as much. |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1426 This variable only has effect in XEmacs." |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1427 :type 'boolean |
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1428 :group 'c) |
18720 | 1429 |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1430 (defvar c-old-style-variable-behavior nil |
26817 | 1431 "*Enables the old style variable behavior when non-nil. |
1432 | |
1433 Normally the values of the style variables will override the style | |
1434 settings specified by the variables `c-default-style' and | |
44728
7a3ac6c387fe
CC Mode update to version 5.29. This is for testing; it's not a released
Martin Stjernholm <mast@lysator.liu.se>
parents:
44412
diff
changeset
|
1435 `c-style-alist'. However, in CC Mode 5.25 and earlier, it was the |
26817 | 1436 other way around, meaning that changes made to the style variables |
1437 from e.g. Customize would not take effect unless special precautions | |
1438 were taken. That was confusing, especially for novice users. | |
1439 | |
1440 It's believed that despite this change, the new behavior will still | |
1441 produce the same results for most old CC Mode configurations, since | |
1442 all style variables are per default set in a special non-override | |
1443 state. Set this variable only if your configuration has stopped | |
1444 working due to this change.") | |
1445 | |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1446 (define-widget 'c-extra-types-widget 'radio |
52340
600f01b30149
(c-extra-types-widget): The doc string is mandatory in
Martin Stjernholm <mast@lysator.liu.se>
parents:
51949
diff
changeset
|
1447 "Internal CC Mode widget for the `*-font-lock-extra-types' variables." |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1448 :args '((const :tag "none" nil) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1449 (repeat :tag "types" regexp))) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1450 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1451 (defun c-make-font-lock-extra-types-blurb (mode1 mode2 example) |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1452 (concat "\ |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1453 *List of extra types (aside from the type keywords) to recognize in " |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1454 mode1 " mode. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1455 Each list item should be a regexp matching a single identifier. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1456 " example " |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1457 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1458 Note that items on this list that don't include any regexp special |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1459 characters are automatically optimized using `regexp-opt', so you |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1460 should not use `regexp-opt' explicitly to build regexps here. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1461 |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1462 On decoration level 3 (and higher, where applicable), a method is used |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1463 that finds most types and declarations by syntax alone. This variable |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1464 is still used as a first step, but other types are recognized |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1465 correctly anyway in most cases. Therefore this variable should be |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1466 fairly restrictive and not contain patterns that are uncertain. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1467 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1468 Note that this variable is only consulted when the major mode is |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1469 initialized. If you change it later you have to reinitialize CC Mode |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1470 by doing \\[" mode2 "]. |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1471 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1472 Despite the name, this variable is not only used for font locking but |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1473 also elsewhere in CC Mode to tell types from other identifiers.")) |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1474 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1475 ;; Note: Most of the variables below are also defined in font-lock.el |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1476 ;; in older versions of Emacs, so depending on the load order we might |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1477 ;; not install the values below. There's no kludge to cope with this |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1478 ;; (as opposed to the *-font-lock-keywords-* variables) since the old |
52340
600f01b30149
(c-extra-types-widget): The doc string is mandatory in
Martin Stjernholm <mast@lysator.liu.se>
parents:
51949
diff
changeset
|
1479 ;; values work fairly well anyway. |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1480 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1481 (defcustom c-font-lock-extra-types |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1482 '("\\sw+_t" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1483 ;; Defined in C99: |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1484 "bool" "complex" "imaginary" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1485 ;; Standard library types (except those matched by the _t pattern): |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1486 "FILE" "lconv" "tm" "va_list" "jmp_buf" |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1487 ;; I do not appreciate the following very Emacs-specific luggage |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1488 ;; in the default value, but otoh it can hardly get in the way for |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1489 ;; other users, and removing it would cause unnecessary grief for |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1490 ;; the old timers that are used to it. /mast |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1491 "Lisp_Object") |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1492 (c-make-font-lock-extra-types-blurb "C" "c-mode" |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1493 "For example, a value of (\"FILE\" \"\\\\sw+_t\") means the word \"FILE\" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1494 and words ending in \"_t\" are treated as type names.") |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1495 :type 'c-extra-types-widget |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1496 :group 'c) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1497 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1498 (defcustom c++-font-lock-extra-types |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1499 '("\\sw+_t" |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1500 ;; C library types (except those matched by the _t pattern): |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1501 "FILE" "lconv" "tm" "va_list" "jmp_buf" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1502 ;; Some standard C++ types that came from font-lock.el. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1503 ;; Experienced C++ users says there's no clear benefit in |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1504 ;; extending this to all the types in the standard library, at |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1505 ;; least not when they'll be recognized without "std::" too. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1506 "istream" "istreambuf" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1507 "ostream" "ostreambuf" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1508 "ifstream" "ofstream" "fstream" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1509 "strstream" "strstreambuf" "istrstream" "ostrstream" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1510 "ios" |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1511 "string" "rope" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1512 "list" "slist" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1513 "deque" "vector" "bit_vector" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1514 "set" "multiset" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1515 "map" "multimap" |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1516 "hash" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1517 "hash_set" "hash_multiset" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1518 "hash_map" "hash_multimap" |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1519 "stack" "queue" "priority_queue" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1520 "type_info" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1521 "iterator" "const_iterator" "reverse_iterator" "const_reverse_iterator" |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1522 "reference" "const_reference") |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1523 (c-make-font-lock-extra-types-blurb "C++" "c++-mode" |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1524 "For example, a value of (\"string\") means the word \"string\" is treated |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1525 as a type name.") |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1526 :type 'c-extra-types-widget |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1527 :group 'c) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1528 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1529 (defcustom objc-font-lock-extra-types |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1530 (list (concat "[" c-upper "]\\sw*[" c-lower "]\\sw*")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1531 (c-make-font-lock-extra-types-blurb "ObjC" "objc-mode" (concat |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1532 "For example, a value of (\"[" c-upper "]\\\\sw*[" c-lower "]\\\\sw*\") means |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1533 capitalized words are treated as type names (the requirement for a |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1534 lower case char is to avoid recognizing all-caps macro and constant |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1535 names).")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1536 :type 'c-extra-types-widget |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1537 :group 'c) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1538 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1539 (defcustom java-font-lock-extra-types |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1540 (list (concat "[" c-upper "]\\sw*[" c-lower "]\\sw*")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1541 (c-make-font-lock-extra-types-blurb "Java" "java-mode" (concat |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1542 "For example, a value of (\"[" c-upper "]\\\\sw*[" c-lower "]\\\\sw*\") means |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1543 capitalized words are treated as type names (the requirement for a |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1544 lower case char is to avoid recognizing all-caps constant names).")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1545 :type 'c-extra-types-widget |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1546 :group 'c) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1547 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1548 (defcustom idl-font-lock-extra-types nil |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1549 (c-make-font-lock-extra-types-blurb "IDL" "idl-mode" "") |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1550 :type 'c-extra-types-widget |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1551 :group 'c) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1552 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1553 (defcustom pike-font-lock-extra-types |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1554 (list (concat "[" c-upper "]\\sw*[" c-lower "]\\sw*")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1555 (c-make-font-lock-extra-types-blurb "Pike" "pike-mode" (concat |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1556 "For example, a value of (\"[" c-upper "]\\\\sw*[" c-lower "]\\\\sw*\") means |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1557 capitalized words are treated as type names (the requirement for a |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1558 lower case char is to avoid recognizing all-caps macro and constant |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1559 names).")) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1560 :type 'c-extra-types-widget |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1561 :group 'c) |
26817 | 1562 |
18720 | 1563 |
1564 ;; Non-customizable variables, still part of the interface to CC Mode | |
1565 (defvar c-file-style nil | |
1566 "Variable interface for setting style via File Local Variables. | |
1567 In a file's Local Variable section, you can set this variable to a | |
1568 string suitable for `c-set-style'. When the file is visited, CC Mode | |
1569 will set the style of the file to this value automatically. | |
1570 | |
1571 Note that file style settings are applied before file offset settings | |
1572 as designated in the variable `c-file-offsets'.") | |
26817 | 1573 (make-variable-buffer-local 'c-file-style) |
70590
63b772bfba93
Move `safe-local-variable' declarations to the respective files.
Reiner Steib <Reiner.Steib@gmx.de>
parents:
69140
diff
changeset
|
1574 ;;;###autoload(put 'c-file-style 'safe-local-variable 'string-or-null-p) |
18720 | 1575 |
1576 (defvar c-file-offsets nil | |
1577 "Variable interface for setting offsets via File Local Variables. | |
1578 In a file's Local Variable section, you can set this variable to an | |
1579 association list similar to the values allowed in `c-offsets-alist'. | |
1580 When the file is visited, CC Mode will institute these offset settings | |
1581 automatically. | |
1582 | |
1583 Note that file offset settings are applied after file style settings | |
1584 as designated in the variable `c-file-style'.") | |
26817 | 1585 (make-variable-buffer-local 'c-file-offsets) |
18720 | 1586 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1587 ;; It isn't possible to specify a doc-string without specifying an |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1588 ;; initial value with `defvar', so the following two variables have been |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1589 ;; given doc-strings by setting the property `variable-documentation' |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1590 ;; directly. C-h v will read this documentation only for versions of GNU |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1591 ;; Emacs from 22.1. It's really good not to have an initial value for |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1592 ;; variables like these that always should be dynamically bound, so it's |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1593 ;; worth the inconvenience. |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1594 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1595 (cc-bytecomp-defvar c-syntactic-context) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1596 (defvar c-syntactic-context) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1597 (put 'c-syntactic-context 'variable-documentation |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1598 "Variable containing the syntactic analysis list for a line of code. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1599 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1600 It is a list with one element for each syntactic symbol pertinent to the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1601 line, for example \"((defun-block-intro 1) (comment-intro))\". |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1602 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1603 It is dynamically bound when calling \(i) a brace hanging \"action |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1604 function\"; \(ii) a semicolon/comma hanging \"criteria function\"; \(iii) a |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1605 \"line-up function\"; \(iv) a c-special-indent-hook function. It is also |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1606 used internally by CC Mode. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1607 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1608 c-syntactic-context is always bound dynamically. It must NEVER be set |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1609 statically (e.g. with `setq').") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1610 |
51714
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1611 |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1612 (cc-bytecomp-defvar c-syntactic-element) |
bc91cbf50c24
Updated CC Mode to version 5.30.
Martin Stjernholm <mast@lysator.liu.se>
parents:
49857
diff
changeset
|
1613 (defvar c-syntactic-element) |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1614 (put 'c-syntactic-element 'variable-documentation |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1615 "Variable containing the current syntactic element during calls to |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1616 the lineup functions. The value is one of the elements in the list in |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1617 `c-syntactic-context' and is a list with the symbol name in the first |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1618 position, followed by zero or more elements containing any additional |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1619 info associated with the syntactic symbol. There are accessor functions |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1620 `c-langelem-sym', `c-langelem-pos', `c-langelem-col', and |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1621 `c-langelem-2nd-pos' to access the list. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1622 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1623 Specifically, the element returned by `c-langelem-pos' is the anchor |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1624 position, or nil if there isn't any. See the comments in the |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1625 `c-offsets-alist' variable and the CC Mode manual for more detailed info |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1626 about the data each syntactic symbol provides. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1627 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1628 This is always bound dynamically. It should never be set |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1629 statically (e.g. with `setq').") |
18720 | 1630 |
26817 | 1631 (defvar c-indentation-style nil |
36920 | 1632 "Name of the currently installed style. |
75027
9f636bd65206
Update CC Mode to version 5.31.4. The detailed changes are those
Alan Mackenzie <acm@muc.de>
parents:
74372
diff
changeset
|
1633 Don't change this directly; call `c-set-style' instead, or set the variable |
9f636bd65206
Update CC Mode to version 5.31.4. The detailed changes are those
Alan Mackenzie <acm@muc.de>
parents:
74372
diff
changeset
|
1634 `c-file-style' in the file's Local Variable list.") |
18720 | 1635 |
36920 | 1636 (defvar c-current-comment-prefix nil |
1637 "The current comment prefix regexp. | |
1638 Set from `c-comment-prefix-regexp' at mode initialization.") | |
1639 (make-variable-buffer-local 'c-current-comment-prefix) | |
19298
4a99e63dc4a9
(c-buffer-is-cc-mode): New variable.
Richard M. Stallman <rms@gnu.org>
parents:
19255
diff
changeset
|
1640 |
67252
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1641 ;; N.B. The next three variables are initialized in |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1642 ;; c-setup-paragraph-variables. Their initializations here are "just in |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1643 ;; case". ACM, 2004/2/15. They are NOT buffer local (yet?). |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1644 (defvar c-string-par-start |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1645 ;; (concat "\\(" (default-value 'paragraph-start) "\\)\\|[ \t]*\\\\$") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1646 "\f\\|[ \t]*\\\\?$" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1647 "Value of paragraph-start used when scanning strings. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1648 It treats escaped EOLs as whitespace.") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1649 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1650 (defvar c-string-par-separate |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1651 ;; (concat "\\(" (default-value 'paragraph-separate) "\\)\\|[ \t]*\\\\$") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1652 "[ \t\f]*\\\\?$" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1653 "Value of paragraph-separate used when scanning strings. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1654 It treats escaped EOLs as whitespace.") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1655 |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1656 (defvar c-sentence-end-with-esc-eol |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1657 (concat "\\(\\(" (c-default-value-sentence-end) "\\)" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1658 ;; N.B.: "$" would be illegal when not enclosed like "\\($\\)". |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1659 "\\|" "[.?!][]\"')}]* ?\\\\\\($\\)[ \t\n]*" |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1660 "\\)") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1661 "Value used like sentence-end used when scanning strings. |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1662 It treats escaped EOLs as whitespace.") |
04d2abb755d9
Update CC Mode to release 5.31.
Alan Mackenzie <acm@muc.de>
parents:
64699
diff
changeset
|
1663 |
18720 | 1664 |
36920 | 1665 (cc-provide 'cc-vars) |
38422
7a94f1c588c4
Some fixes to follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents:
36920
diff
changeset
|
1666 |
93975
1e3a407766b9
Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
88022
diff
changeset
|
1667 ;; arch-tag: d62e9a55-c9fe-409b-b5b6-050b6aa202c9 |
18720 | 1668 ;;; cc-vars.el ends here |