annotate src/macros.h @ 106395:f2b36fb84bf7

Enhance `c-parse-state' to run efficiently in "brace desserts". * progmodes/cc-mode.el (c-basic-common-init): Call c-state-cache-init. (c-neutralize-syntax-in-and-mark-CPP): Renamed from c-extend-and-neutralize-syntax-in-CPP. Mark each CPP construct by placing `category' properties value 'c-cpp-delimiter at its boundaries. * progmodes/cc-langs.el (c-before-font-lock-function): c-extend-and-neutralize-syntax-in-CPP has been renamed c-neutralize-syntax-in-and-mark-CPP. * progmodes/cc-fonts.el (c-cpp-matchers): Mark template brackets with `category' properties now, not `syntax-table' ones. * progmodes/cc-engine.el (c-syntactic-end-of-macro): A new enhanced (but slower) version of c-end-of-macro that won't land inside a literal or on another awkward character. (c-state-cache-too-far, c-state-cache-start) (c-state-nonlit-pos-interval, c-state-nonlit-pos-cache) (c-state-nonlit-pos-cache-limit, c-state-point-min) (c-state-point-min-lit-type, c-state-point-min-lit-start) (c-state-min-scan-pos, c-state-brace-pair-desert) (c-state-old-cpp-beg, c-state-old-cpp-end): New constants and buffer local variables. (c-state-literal-at, c-state-lit-beg) (c-state-cache-non-literal-place, c-state-get-min-scan-pos) (c-state-mark-point-min-literal, c-state-cache-top-lparen) (c-state-cache-top-paren, c-state-cache-after-top-paren) (c-get-cache-scan-pos, c-get-fallback-scan-pos) (c-state-balance-parens-backwards, c-parse-state-get-strategy) (c-renarrow-state-cache) (c-append-lower-brace-pair-to-state-cache) (c-state-push-any-brace-pair, c-append-to-state-cache) (c-remove-stale-state-cache) (c-remove-stale-state-cache-backwards, c-state-cache-init) (c-invalidate-state-cache-1, c-parse-state-1) (c-invalidate-state-cache): New defuns/defmacros/defsubsts. (c-parse-state): Enhanced and refactored. (c-debug-parse-state): Amended to deal with all the new variables. * progmodes/cc-defs.el (c-<-as-paren-syntax, c-mark-<-as-paren) (c->-as-paren-syntax, c-mark->-as-paren, c-unmark-<->-as-paren): modify to use category text properties rather than syntax-table ones. (c-suppress-<->-as-parens, c-restore-<->-as-parens): new defsubsts to switch off/on the syntactic paren property of C++ template delimiters using the category property. (c-with-<->-as-parens-suppressed): Macro to invoke code with template delims suppressed. (c-cpp-delimiter, c-set-cpp-delimiters, c-clear-cpp-delimiters): New constant/macros which apply category properties to the start and end of preprocessor constructs. (c-comment-out-cpps, c-uncomment-out-cpps): defsubsts which "comment out" the syntactic value of characters in preprocessor constructs. (c-with-cpps-commented-out) (c-with-all-but-one-cpps-commented-out): Macros to invoke code with characters in all or all but one preprocessor constructs "commented out".
author Alan Mackenzie <acm@muc.de>
date Thu, 03 Dec 2009 16:02:10 +0000
parents e038c1a8307c
children 1d1d5d9bd884
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1 /* Definitions for keyboard macro interpretation in GNU Emacs.
75227
e90d04cd455a Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents: 68651
diff changeset
2 Copyright (C) 1985, 2001, 2002, 2003, 2004, 2005,
100951
e038c1a8307c Add 2009 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 94994
diff changeset
3 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
4
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
5 This file is part of GNU Emacs.
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
6
94994
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79759
diff changeset
7 GNU Emacs is free software: you can redistribute it and/or modify
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
8 it under the terms of the GNU General Public License as published by
94994
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79759
diff changeset
9 the Free Software Foundation, either version 3 of the License, or
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79759
diff changeset
10 (at your option) any later version.
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
11
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
12 GNU Emacs is distributed in the hope that it will be useful,
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
15 GNU General Public License for more details.
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
16
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
94994
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 79759
diff changeset
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
19
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
20
15970
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
21 /* Kbd macro currently being executed (a string or vector). */
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
22
61981
8131d95ff037 (Vexecuting_kbd_macro): Declare instead of Vexecuting_macro.
Richard M. Stallman <rms@gnu.org>
parents: 52401
diff changeset
23 extern Lisp_Object Vexecuting_kbd_macro;
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
24
15970
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
25 /* Index of next character to fetch from that macro. */
484
3165b2697c78 entered into RCS
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
26
62024
4f7e1a56469e (executing_kbd_macro_index): Rename from executing_macro_index.
Kim F. Storm <storm@cua.dk>
parents: 61981
diff changeset
27 extern EMACS_INT executing_kbd_macro_index;
15970
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
28
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
29 /* Number of successful iterations so far
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
30 for innermost keyboard macro.
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
31 This is not bound at each level,
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
32 so after an error, it describes the innermost interrupted macro. */
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
33
62024
4f7e1a56469e (executing_kbd_macro_index): Rename from executing_macro_index.
Kim F. Storm <storm@cua.dk>
parents: 61981
diff changeset
34 extern int executing_kbd_macro_iterations;
15970
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
35
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
36 /* This is the macro that was executing.
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
37 This is not bound at each level,
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
38 so after an error, it describes the innermost interrupted macro. */
d54ae2343dff (executing_macro_iterations, executing_macro): Declared.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
39
62024
4f7e1a56469e (executing_kbd_macro_index): Rename from executing_macro_index.
Kim F. Storm <storm@cua.dk>
parents: 61981
diff changeset
40 extern Lisp_Object executing_kbd_macro;
20300
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
41
47349
5c37672e24c8 (end_kbd_macro): Declare extern.
Kim F. Storm <storm@cua.dk>
parents: 47308
diff changeset
42 /* Finish defining the current keyboard macro. */
5c37672e24c8 (end_kbd_macro): Declare extern.
Kim F. Storm <storm@cua.dk>
parents: 47308
diff changeset
43
5c37672e24c8 (end_kbd_macro): Declare extern.
Kim F. Storm <storm@cua.dk>
parents: 47308
diff changeset
44 extern void end_kbd_macro P_ ((void));
5c37672e24c8 (end_kbd_macro): Declare extern.
Kim F. Storm <storm@cua.dk>
parents: 47308
diff changeset
45
20300
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
46 /* Declare that all chars stored so far in the kbd macro being defined
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
47 really belong to it. This is done in between editor commands. */
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
48
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
49 extern void finalize_kbd_macro_chars P_ ((void));
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
50
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
51 /* Store a character into kbd macro being defined */
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
52
1030a9fcf001 Declare finalize_kbd_macro_chars and
Andreas Schwab <schwab@suse.de>
parents: 15970
diff changeset
53 extern void store_kbd_macro_char P_ ((Lisp_Object));
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 47349
diff changeset
54
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 47349
diff changeset
55 /* arch-tag: 8edb7088-682f-4d1f-a4d9-0fbb7284234e
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 47349
diff changeset
56 (do not change this comment) */