lisp/progmodes/cc-defs.el

21 ;; the Free Software Foundation; either version 2, or (at your option)
37 ;; must be loaded early both during compilation and at runtime.
99 ;;; Variables also used at compile time.
128     "Like `progn', but evaluates the body at compile time.
136 	;; evaluates its body at macro expansion time if it's nested
154 	 ;; `defsubst', like `defmacro', needs to be evaluated at
409 completely restored again.  Changes in text properties like `face' or
470 	  ;; undo got out of synch we're hosed anyway.
519 comment at the start of cc-engine.el for more info."
535 the point is moved into it past the whitespace at the end.
538 comment at the start of cc-engine.el for more info."
743      ;; if defun-prompt-regexp is non-nil, b-o-d won't leave us at the
746 	  (looking-at defun-prompt-regexp)
761 ;; The indentation engine (or whatever) tests for a VS at a specific position
762 ;; by invoking the macro `c-at-vsemi-p', which in its turn calls the mode
764 ;; `c-at-vsemi-p-fn'.  The actual details of what constitutes a VS in a
766 ;; (e.g. cc-awk.el).  `c-at-vsemi-p' returns non-nil if point (or the optional
767 ;; parameter POS) is at a VS, nil otherwise.
774 ;; at the place shown in the following AWK source line:
781 ;; In addition to `c-at-vsemi-p-fn', a mode may need to supply a function for
785 ;; but `c-at-vsemi-p' might well need to call `c-beginning-of-statement-1' in
789 ;; non-nil at any time; returning nil is a guarantee that an immediate
790 ;; invocation of `c-at-vsemi-p' at point will NOT call
795 ;; scheme used by the `c-at-vsemi-p-fn', hence the name - the status is
799 (defmacro c-at-vsemi-p (&optional pos)
800   ;; Is there a virtual semicolon (not a real one or a }) at POS (defaults to
804   `(if c-at-vsemi-p-fn
805        (funcall c-at-vsemi-p-fn ,@(if pos `(,pos)))))
809   ;; (c-at-vsemi-p) will NOT call c-beginning-of-statement-1.  Otherwise,
906   ;; Constant used at compile time to decide whether or not to use
910   (defconst c-use-extents (and (cc-bytecomp-fboundp 'extent-at)
926 	      (let ((ext (extent-at pos nil property)))
948   ;; Put the given property with the given value on the character at
964     ;; In Emacs 21 we got the `rear-nonsticky' property covered
970   ;; Get the value of the given property on the character at POS if
976       `(let ((ext (extent-at ,pos nil ',property)))
998   ;; Remove the given property on the character at POS if it's been put
1006 	 `(let ((ext (extent-at ,pos nil ',property)))
1009 	 ;; In Emacs 21 we got the `rear-nonsticky' property covered
1043 ;; buffer that got overridden when they were put.
1126   ;; Mark the "<" character at POS as an sexp list opener using the
1135   ;; Mark the ">" character at POS as an sexp list closer using the
1229 (defsubst c-got-face-at (pos faces)
1232   (let ((pos-faces (get-text-property pos 'face)))
1241 (defsubst c-face-name-p (facename)
1242   ;; Return t if FACENAME is the name of a face.  This method is
1244   ;; face objects (while it's only their names that are used just
1246   ;; face names.
1247   (memq facename (face-list)))
1259 If ADORN is t there will be at least one submatch and the first
1511 	      "`parse-partial-sexp' has to return at least 10 elements.")))
1530 'pps-extended-state `parse-partial-sexp' returns a list with at least 10
1580 ;; `c-lang-const' forms are also evaluated at compile time and
1584 ;; the `c-lang-defconst' forms don't need to be loaded at all then.
1601 languages.  It should be used at the top level before any calls to
1607 haven't got a setting in the new language fall back to their values in
1620 ;; `c-lang-const'.  It's mostly used at compile time but it's not
1651 immediately, i.e. at the same time as the `c-lang-defconst' form
1653   ;; Evaluate at macro expansion time, i.e. in the
1682 then that file must be loaded \(at compile time) before it's safe to
1703 	 ;; form that's already evaluated at compile time.  It's
1728     ;; It's reversed at the same time to make it easier to implement
1851 	 "Unknown language %S since it got no `c-mode-prefix' property"
1889 	  ;; we're in an "uncontrolled" context and got no language,
1895 	;; the same we use a value that is evaluated at compile time,
1896 	;; otherwise it's evaluated at runtime.
1982 	     "`%s' got no (prior) value in %s (might be a cyclic reference)"
2000   ;; Find the first assignment entry that applies to MODE at or after
2024 	       ;; there's at least one.