1 ;;; hide-ifdef-mode.el --- hides selected code within ifdef.
3 ;; Copyright (C) 1988, 1994 Free Software Foundation, Inc.
5 ;; Author: Dan LaLiberte <liberte@a.cs.uiuc.edu>
7 ;; Keywords: c, outlines
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation; either version 2, or (at your option)
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
23 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24 ;; Boston, MA 02111-1307, USA.
28 ;; To initialize, toggle the hide-ifdef minor mode with
30 ;; M-x hide-ifdef-mode
32 ;; This will set up key bindings and call hide-ifdef-mode-hook if it
33 ;; has a value. To explicitly hide ifdefs using a buffer-local
34 ;; define list (default empty), type
36 ;; M-x hide-ifdefs or C-c @ h
38 ;; Hide-ifdef suppresses the display of code that the preprocessor wouldn't
39 ;; pass through. The support of constant expressions in #if lines is
40 ;; limited to identifiers, parens, and the operators: &&, ||, !, and
41 ;; "defined". Please extend this.
43 ;; The hidden code is marked by ellipses (...). Be
44 ;; cautious when editing near ellipses, since the hidden text is
45 ;; still in the buffer, and you can move the point into it and modify
46 ;; text unawares. If you don't want to see the ellipses, set
47 ;; selective-display-ellipses to nil. But this can be dangerous.
48 ;; You can make your buffer read-only while hide-ifdef-hiding by setting
49 ;; hide-ifdef-read-only to a non-nil value. You can toggle this
50 ;; variable with hide-ifdef-toggle-read-only (C-c @ C-q).
52 ;; You can undo the effect of hide-ifdefs by typing
54 ;; M-x show-ifdefs or C-c @ s
56 ;; Use M-x hide-ifdef-define (C-c @ d) to define a symbol.
57 ;; Use M-x hide-ifdef-undef (C-c @ u) to undefine a symbol.
59 ;; If you define or undefine a symbol while hide-ifdef-mode is in effect,
60 ;; the display will be updated. Only the define list for the current
61 ;; buffer will be affected. You can save changes to the local define
62 ;; list with hide-ifdef-set-define-alist. This adds entries
63 ;; to hide-ifdef-define-alist.
65 ;; If you have defined a hide-ifdef-mode-hook, you can set
66 ;; up a list of symbols that may be used by hide-ifdefs as in the
69 ;; (setq hide-ifdef-mode-hook
71 ;; (if (not hide-ifdef-define-alist)
72 ;; (setq hide-ifdef-define-alist
76 ;; (hide-ifdef-use-define-alist 'list2) ; use list2 by default
79 ;; You can call hide-ifdef-use-define-alist (C-c @ u) at any time to specify
80 ;; another list to use.
82 ;; To cause ifdefs to be hidden as soon as hide-ifdef-mode is called,
83 ;; set hide-ifdef-initially to non-nil.
85 ;; If you set hide-ifdef-lines to t, hide-ifdefs hides all the #ifdef lines.
86 ;; In the absence of highlighting, that might be a bad idea. If you set
87 ;; hide-ifdef-lines to nil (the default), the surrounding preprocessor
88 ;; lines will be displayed. That can be confusing in its own
89 ;; right. Other variations on display are possible, but not much
92 ;; You can explicitly hide or show individual ifdef blocks irrespective
93 ;; of the define list by using hide-ifdef-block and show-ifdef-block.
95 ;; You can move the point between ifdefs with forward-ifdef, backward-ifdef,
96 ;; up-ifdef, down-ifdef, next-ifdef, and previous-ifdef.
98 ;; If you have minor-mode-alist in your mode line (the default) two labels
99 ;; may appear. "Ifdef" will appear when hide-ifdef-mode is active. "Hiding"
100 ;; will appear when text may be hidden ("hide-ifdef-hiding" is non-nil).
102 ;; Written by Brian Marick, at Gould, Computer Systems Division, Urbana IL.
103 ;; Extensively modified by Daniel LaLiberte (while at Gould).
105 ;; You may freely modify and distribute this, but keep a record
106 ;; of modifications and send comments to:
107 ;; liberte@a.cs.uiuc.edu or ihnp4!uiucdcs!liberte
108 ;; I will continue to upgrade hide-ifdef-mode
109 ;; with your contributions.
115 (defgroup hide-ifdef nil
116 "Hide selected code within `ifdef'."
119 (defvar hide-ifdef-mode-submap nil
120 "Keymap used with Hide-Ifdef mode.")
122 (defvar hide-ifdef-mode-map nil
123 "Keymap used with Hide-Ifdef mode.")
125 (defconst hide-ifdef-mode-prefix-key
"\C-c@"
126 "Prefix key for all Hide-Ifdef mode commands.")
128 ;; Set up the submap that goes after the prefix key.
129 (if hide-ifdef-mode-submap
130 () ; Don't redefine it.
131 (setq hide-ifdef-mode-submap
(make-sparse-keymap))
132 (define-key hide-ifdef-mode-submap
"d" 'hide-ifdef-define
)
133 (define-key hide-ifdef-mode-submap
"u" 'hide-ifdef-undef
)
134 (define-key hide-ifdef-mode-submap
"D" 'hide-ifdef-set-define-alist
)
135 (define-key hide-ifdef-mode-submap
"U" 'hide-ifdef-use-define-alist
)
137 (define-key hide-ifdef-mode-submap
"h" 'hide-ifdefs
)
138 (define-key hide-ifdef-mode-submap
"s" 'show-ifdefs
)
139 (define-key hide-ifdef-mode-submap
"\C-d" 'hide-ifdef-block
)
140 (define-key hide-ifdef-mode-submap
"\C-s" 'show-ifdef-block
)
142 (define-key hide-ifdef-mode-submap
"\C-q" 'hide-ifdef-toggle-read-only
)
143 (let ((where (where-is-internal 'toggle-read-only
'(keymap) t
)))
145 (define-key hide-ifdef-mode-submap
147 'hide-ifdef-toggle-outside-read-only
)))
150 ;; Set up the mode's main map, which leads via the prefix key to the submap.
151 (if hide-ifdef-mode-map
153 (setq hide-ifdef-mode-map
(make-sparse-keymap))
154 (define-key hide-ifdef-mode-map hide-ifdef-mode-prefix-key
155 hide-ifdef-mode-submap
))
157 (defvar hide-ifdef-mode nil
158 "Non-nil when hide-ifdef-mode is activated.")
160 (defvar hide-ifdef-hiding nil
161 "Non-nil when text may be hidden.")
163 ;; Arrange to use the mode's map when the mode is enabled.
164 (or (assq 'hide-ifdef-mode minor-mode-map-alist
)
165 (setq minor-mode-map-alist
166 (cons (cons 'hide-ifdef-mode hide-ifdef-mode-map
)
167 minor-mode-map-alist
)))
169 (or (assq 'hide-ifdef-hiding minor-mode-alist
)
170 (setq minor-mode-alist
171 (cons '(hide-ifdef-hiding " Hiding")
174 (or (assq 'hide-ifdef-mode minor-mode-alist
)
175 (setq minor-mode-alist
176 (cons '(hide-ifdef-mode " Ifdef")
179 ;; fix c-mode syntax table so we can recognize whole symbols.
180 (defvar hide-ifdef-syntax-table
181 (copy-syntax-table c-mode-syntax-table
)
182 "Syntax table used for tokenizing #if expressions.")
184 (modify-syntax-entry ?_
"w" hide-ifdef-syntax-table
)
185 (modify-syntax-entry ?
& "." hide-ifdef-syntax-table
)
186 (modify-syntax-entry ?\|
"." hide-ifdef-syntax-table
)
189 (defun hide-ifdef-mode (arg)
190 "Toggle Hide-Ifdef mode. This is a minor mode, albeit a large one.
191 With ARG, turn Hide-Ifdef mode on if arg is positive, off otherwise.
192 In Hide-Ifdef mode, code within #ifdef constructs that the C preprocessor
193 would eliminate may be hidden from view. Several variables affect
194 how the hiding is done:
197 An association list of defined and undefined symbols for the
198 current buffer. Initially, the global value of `hide-ifdef-env'
201 hide-ifdef-define-alist
202 An association list of defined symbol lists.
203 Use `hide-ifdef-set-define-alist' to save the current `hide-ifdef-env'
204 and `hide-ifdef-use-define-alist' to set the current `hide-ifdef-env'
205 from one of the lists in `hide-ifdef-define-alist'.
208 Set to non-nil to not show #if, #ifdef, #ifndef, #else, and
209 #endif lines when hiding.
212 Indicates whether `hide-ifdefs' should be called when Hide-Ifdef mode
216 Set to non-nil if you want to make buffers read only while hiding.
217 After `show-ifdefs', read-only status is restored to previous value.
219 \\{hide-ifdef-mode-map}"
222 (make-local-variable 'hide-ifdef-mode
)
223 (setq hide-ifdef-mode
225 (not hide-ifdef-mode
)
226 (> (prefix-numeric-value arg
) 0)))
228 (force-mode-line-update)
232 ; inherit global values
233 (make-local-variable 'hide-ifdef-env
)
234 (setq hide-ifdef-env
(default-value 'hide-ifdef-env
))
236 (make-local-variable 'hide-ifdef-hiding
)
237 (setq hide-ifdef-hiding
(default-value 'hide-ifdef-hiding
))
239 (make-local-variable 'hif-outside-read-only
)
240 (setq hif-outside-read-only buffer-read-only
)
242 (run-hooks 'hide-ifdef-mode-hook
)
244 (if hide-ifdef-initially
247 (message "Enter Hide-Ifdef mode")
249 ; else end hide-ifdef-mode
250 (if hide-ifdef-hiding
252 (message "Exit Hide-Ifdef mode")
256 ;; from outline.el with docstring fixed.
257 (defun hif-outline-flag-region (from to flag
)
258 "Hides or shows lines from FROM to TO, according to FLAG.
259 If FLAG is \\n (newline character) then text is shown, while if FLAG is \\^M
260 \(control-M) the text is hidden."
261 (let ((modp (buffer-modified-p)))
262 (unwind-protect (progn
263 (subst-char-in-region from to
264 (if (= flag ?
\n) ?\^M ?
\n)
266 (set-buffer-modified-p modp
))
269 (defun hif-show-all ()
270 "Show all of the text in the current buffer."
272 (hif-outline-flag-region (point-min) (point-max) ?
\n))
274 ;; By putting this on after-revert-hook, we arrange that it only
275 ;; does anything when revert-buffer avoids turning off the mode.
276 ;; (That can happen in VC.)
277 (defun hif-before-revert-function ()
278 (and hide-ifdef-mode hide-ifdef-hiding
280 (add-hook 'after-revert-hook
'hif-before-revert-function
)
282 (defun hide-ifdef-region (start end
)
283 "START is the start of a #if or #else form. END is the ending part.
284 Everything including these lines is made invisible."
285 (hif-outline-flag-region start end ?\^M
)
288 (defun hif-show-ifdef-region (start end
)
289 "Everything between START and END is made visible."
290 (hif-outline-flag-region start end ?
\n)
295 ;===%%SF%% evaluation (Start) ===
297 ;; It is not useful to set this to anything but `eval'.
298 ;; In fact, the variable might as well be eliminated.
299 (defvar hide-ifdef-evaluator
'eval
300 "The function to use to evaluate a form.
301 The evaluator is given a canonical form and returns t if text under
302 that form should be displayed.")
304 (defvar hif-undefined-symbol nil
305 "...is by default considered to be false.")
307 (defvar hide-ifdef-env nil
308 "An alist of defined symbols and their values.")
311 (defun hif-set-var (var value
)
312 "Prepend (var value) pair to hide-ifdef-env."
313 (setq hide-ifdef-env
(cons (cons var value
) hide-ifdef-env
)))
316 (defun hif-lookup (var)
317 ; (message "hif-lookup %s" var)
318 (let ((val (assoc var hide-ifdef-env
)))
321 hif-undefined-symbol
)))
323 (defun hif-defined (var)
325 ; when #if expressions are fully supported, defined result should be 1
326 ; (if (assoc var hide-ifdef-env)
332 ;===%%SF%% evaluation (End) ===
336 ;===%%SF%% parsing (Start) ===
337 ;;; The code that understands what ifs and ifdef in files look like.
339 (defconst hif-cpp-prefix
"\\(^\\|\r\\)[ \t]*#[ \t]*")
340 (defconst hif-ifndef-regexp
(concat hif-cpp-prefix
"ifndef"))
341 (defconst hif-ifx-regexp
(concat hif-cpp-prefix
"if\\(n?def\\)?[ \t]+"))
342 (defconst hif-else-regexp
(concat hif-cpp-prefix
"else"))
343 (defconst hif-endif-regexp
(concat hif-cpp-prefix
"endif"))
344 (defconst hif-ifx-else-endif-regexp
345 (concat hif-ifx-regexp
"\\|" hif-else-regexp
"\\|" hif-endif-regexp
))
348 (defun hif-infix-to-prefix (token-list)
349 "Convert list of tokens in infix into prefix list"
350 ; (message "hif-infix-to-prefix: %s" token-list)
351 (if (= 1 (length token-list
))
352 (` (hif-lookup (quote (, (car token-list
)))))
353 (hif-parse-if-exp token-list
))
356 ; pattern to match initial identifier, !, &&, ||, (, or ).
357 ; Added ==, + and -: garyo@avs.com 8/9/94
358 (defconst hif-token-regexp
"^\\(&&\\|||\\|[!=]=\\|!\\|[()+-]\\|[<>]=?\\|\\w+\\)")
359 (defconst hif-end-of-comment
"\\*/")
362 (defun hif-tokenize (expr-string)
363 "Separate string into a list of tokens"
364 (let ((token-list nil
)
366 (expr-length (length expr-string
))
367 (current-syntax-table (syntax-table)))
370 (set-syntax-table hide-ifdef-syntax-table
)
371 (while (< expr-start expr-length
)
372 ; (message "expr-start = %d" expr-start) (sit-for 1)
374 ((string-match "^[ \t]+" expr-string expr-start
)
376 (setq expr-start
(match-end 0))
377 ;; stick newline in string so ^ matches on the next string-match
378 (aset expr-string
(1- expr-start
) ?
\n))
380 ((string-match "^/\\*" expr-string expr-start
)
381 (setq expr-start
(match-end 0))
382 (aset expr-string
(1- expr-start
) ?
\n)
384 (string-match hif-end-of-comment
385 expr-string expr-start
) ; eat comment
386 (string-match "$" expr-string expr-start
)) ; multi-line comment
387 (setq expr-start
(match-end 0))
388 (aset expr-string
(1- expr-start
) ?
\n))
390 ((string-match "^//" expr-string expr-start
)
391 (string-match "$" expr-string expr-start
)
392 (setq expr-start
(match-end 0)))
394 ((string-match hif-token-regexp expr-string expr-start
)
395 (let ((token (substring expr-string expr-start
(match-end 0))))
396 (setq expr-start
(match-end 0))
397 (aset expr-string
(1- expr-start
) ?
\n)
398 ; (message "token: %s" token) (sit-for 1)
402 ((string-equal token
"||") 'or
)
403 ((string-equal token
"&&") 'and
)
404 ((string-equal token
"==") 'equal
)
405 ((string-equal token
"!=") 'hif-notequal
)
406 ((string-equal token
"!") 'not
)
407 ((string-equal token
"defined") 'hif-defined
)
408 ((string-equal token
"(") 'lparen
)
409 ((string-equal token
")") 'rparen
)
410 ((string-equal token
">") 'hif-greater
)
411 ((string-equal token
"<") 'hif-less
)
412 ((string-equal token
">=") 'hif-greater-equal
)
413 ((string-equal token
"<=") 'hif-less-equal
)
414 ((string-equal token
"+") 'hif-plus
)
415 ((string-equal token
"-") 'hif-minus
)
418 (t (error "Bad #if expression: %s" expr-string
)))))
419 (set-syntax-table current-syntax-table
))
420 (nreverse token-list
)))
422 ;;;-----------------------------------------------------------------
423 ;;; Translate C preprocessor #if expressions using recursive descent.
424 ;;; This parser is limited to the operators &&, ||, !, and "defined".
425 ;;; Added ==, !=, +, and -. Gary Oberbrunner, garyo@avs.com, 8/9/94
427 (defun hif-parse-if-exp (token-list)
428 "Parse the TOKEN-LIST. Return translated list in prefix form."
432 (if token
; is there still a token?
433 (error "Error: unexpected token: %s" token
))))
435 (defun hif-nexttoken ()
436 "Pop the next token from token-list into the let variable \"token\"."
437 (setq token
(car token-list
))
438 (setq token-list
(cdr token-list
))
442 "Parse an expression as found in #if.
443 expr : term | expr '||' term."
444 (let ((result (hif-term)))
445 (while (eq token
'or
)
447 (setq result
(list 'or result
(hif-term))))
451 "Parse a term : eq-expr | term '&&' eq-expr."
452 (let ((result (hif-eq-expr)))
453 (while (eq token
'and
)
455 (setq result
(list 'and result
(hif-eq-expr))))
458 (defun hif-eq-expr ()
459 "Parse an eq-expr : math | eq-expr `=='|`!='|`<'|`>'|`>='|`<=' math."
460 (let ((result (hif-math))
462 (while (memq token
'(equal hif-notequal hif-greater hif-less
463 hif-greater-equal hif-less-equal
))
464 (setq eq-token token
)
466 (setq result
(list eq-token result
(hif-math))))
470 "Parse an expression with + or - and simpler things.
471 math : factor | math '+|-' factor."
472 (let ((result (hif-factor))
474 (while (or (eq token
'hif-plus
) (eq token
'hif-minus
))
477 (setq result
(list math-op result
(hif-factor))))
481 "Parse a factor: '!' factor | '(' expr ')' | 'defined(' id ')' | id."
485 (list 'not
(hif-factor)))
489 (let ((result (hif-expr)))
490 (if (not (eq token
'rparen
))
491 (error "Bad token in parenthesized expression: %s" token
)
495 ((eq token
'hif-defined
)
497 (if (not (eq token
'lparen
))
498 (error "Error: expected \"(\" after \"defined\""))
501 (if (memq token
'(or and not hif-defined lparen rparen
))
502 (error "Error: unexpected token: %s" token
))
504 (if (not (eq token
'rparen
))
505 (error "Error: expected \")\" after identifier"))
507 (` (hif-defined (quote (, ident
))))
512 (if (memq ident
'(or and
))
513 (error "Error: missing identifier"))
515 (` (hif-lookup (quote (, ident
))))
519 (defun hif-mathify (val)
520 "Treat VAL as a number: if it's t or nil, use 1 or 0."
527 (defun hif-plus (a b
)
528 "Like ordinary plus but treat t and nil as 1 and 0."
529 (+ (hif-mathify a
) (hif-mathify b
)))
530 (defun hif-minus (a b
)
531 "Like ordinary minus but treat t and nil as 1 and 0."
532 (- (hif-mathify a
) (hif-mathify b
)))
533 (defun hif-notequal (a b
)
534 "Like (not (equal A B)) but as one symbol."
536 (defun hif-greater (a b
)
538 (> (hif-mathify a
) (hif-mathify b
)))
539 (defun hif-less (a b
)
541 (< (hif-mathify a
) (hif-mathify b
)))
542 (defun hif-greater-equal (a b
)
544 (>= (hif-mathify a
) (hif-mathify b
)))
545 (defun hif-less-equal (a b
)
547 (<= (hif-mathify a
) (hif-mathify b
)))
548 ;;;----------- end of parser -----------------------
551 (defun hif-canonicalize ()
552 "When at beginning of #ifX, returns a Lisp expression for its condition."
554 (let ((negate (looking-at hif-ifndef-regexp
)))
555 (re-search-forward hif-ifx-regexp
)
557 (buffer-substring (point)
558 (progn (skip-chars-forward "^\n\r") (point))))
559 (expr (hif-infix-to-prefix (hif-tokenize expr-string
))))
560 ; (message "hif-canonicalized: %s" expr)
566 (defun hif-find-any-ifX ()
567 "Move to next #if..., or #ifndef, at point or after."
568 ; (message "find ifX at %d" (point))
570 (re-search-forward hif-ifx-regexp
(point-max) t
)
571 (beginning-of-line)))
574 (defun hif-find-next-relevant ()
575 "Move to next #if..., #else, or #endif, after the current line."
576 ; (message "hif-find-next-relevant at %d" (point))
578 ; avoid infinite recursion by only going to beginning of line if match found
579 (if (re-search-forward hif-ifx-else-endif-regexp
(point-max) t
)
580 (beginning-of-line)))
582 (defun hif-find-previous-relevant ()
583 "Move to previous #if..., #else, or #endif, before the current line."
584 ; (message "hif-find-previous-relevant at %d" (point))
586 ; avoid infinite recursion by only going to beginning of line if match found
587 (if (re-search-backward hif-ifx-else-endif-regexp
(point-min) t
)
588 (beginning-of-line)))
591 (defun hif-looking-at-ifX () ;; Should eventually see #if
592 (looking-at hif-ifx-regexp
))
593 (defun hif-looking-at-endif ()
594 (looking-at hif-endif-regexp
))
595 (defun hif-looking-at-else ()
596 (looking-at hif-else-regexp
))
600 (defun hif-ifdef-to-endif ()
601 "If positioned at #ifX or #else form, skip to corresponding #endif."
602 ; (message "hif-ifdef-to-endif at %d" (point)) (sit-for 1)
603 (hif-find-next-relevant)
604 (cond ((hif-looking-at-ifX)
605 (hif-ifdef-to-endif) ; find endif of nested if
606 (hif-ifdef-to-endif)) ; find outer endif or else
607 ((hif-looking-at-else)
608 (hif-ifdef-to-endif)) ; find endif following else
609 ((hif-looking-at-endif)
612 (error "Mismatched #ifdef #endif pair"))))
615 (defun hif-endif-to-ifdef ()
616 "If positioned at #endif form, skip backward to corresponding #ifX."
617 ; (message "hif-endif-to-ifdef at %d" (point))
618 (let ((start (point)))
619 (hif-find-previous-relevant)
620 (if (= start
(point))
621 (error "Mismatched #ifdef #endif pair")))
622 (cond ((hif-looking-at-endif)
623 (hif-endif-to-ifdef) ; find beginning of nested if
624 (hif-endif-to-ifdef)) ; find beginning of outer if or else
625 ((hif-looking-at-else)
626 (hif-endif-to-ifdef))
627 ((hif-looking-at-ifX)
629 (t))) ; never gets here
632 (defun forward-ifdef (&optional arg
)
633 "Move point to beginning of line of the next ifdef-endif.
634 With argument, do this that many times."
636 (or arg
(setq arg
1))
638 (backward-ifdef (- arg
)))
641 (let ((start (point)))
642 (if (not (hif-looking-at-ifX))
643 (hif-find-next-relevant))
644 (if (hif-looking-at-ifX)
647 (error "No following #ifdef")
651 (defun backward-ifdef (&optional arg
)
652 "Move point to beginning of the previous ifdef-endif.
653 With argument, do this that many times."
655 (or arg
(setq arg
1))
657 (forward-ifdef (- arg
)))
661 (let ((start (point)))
662 (if (not (hif-looking-at-endif))
663 (hif-find-previous-relevant))
664 (if (hif-looking-at-endif)
667 (error "No previous #ifdef")))))
671 "Move point to beginning of nested ifdef or else-part."
673 (let ((start (point)))
674 (hif-find-next-relevant)
675 (if (or (hif-looking-at-ifX) (hif-looking-at-else))
678 (error "No following #ifdef"))))
682 "Move point to beginning of enclosing ifdef or else-part."
685 (let ((start (point)))
686 (if (not (hif-looking-at-endif))
687 (hif-find-previous-relevant))
688 (if (hif-looking-at-endif)
689 (hif-endif-to-ifdef))
690 (if (= start
(point))
691 (error "No previous #ifdef"))))
693 (defun next-ifdef (&optional arg
)
694 "Move to the beginning of the next #ifX, #else, or #endif.
695 With argument, do this that many times."
697 (or arg
(setq arg
1))
699 (previous-ifdef (- arg
)))
702 (hif-find-next-relevant)
706 (error "No following #ifdefs, #elses, or #endifs")))))
708 (defun previous-ifdef (&optional arg
)
709 "Move to the beginning of the previous #ifX, #else, or #endif.
710 With argument, do this that many times."
712 (or arg
(setq arg
1))
714 (next-ifdef (- arg
)))
717 (let ((start (point)))
718 (hif-find-previous-relevant)
719 (if (= start
(point))
720 (error "No previous #ifdefs, #elses, or #endifs")
724 ;===%%SF%% parsing (End) ===
727 ;===%%SF%% hide-ifdef-hiding (Start) ===
730 ;;; A range is a structure with four components:
731 ;;; ELSE-P True if there was an else clause for the ifdef.
732 ;;; START The start of the range. (beginning of line)
733 ;;; ELSE The else marker (beginning of line)
734 ;;; Only valid if ELSE-P is true.
735 ;;; END The end of the range. (beginning of line)
737 (defun hif-make-range (else-p start end
&optional else
)
738 (list else-p start else end
))
740 (defun hif-range-else-p (range) (elt range
0))
741 (defun hif-range-start (range) (elt range
1))
742 (defun hif-range-else (range) (elt range
2))
743 (defun hif-range-end (range) (elt range
3))
748 ;;; The workhorse, it delimits the #if region. Reasonably simple:
749 ;;; Skip until an #else or #endif is found, remembering positions. If
750 ;;; an #else was found, skip some more, looking for the true #endif.
752 (defun hif-find-range ()
753 "Returns a Range structure describing the current #if region.
754 Point is left unchanged."
755 ; (message "hif-find-range at %d" (point))
758 (let ((start (point))
762 ;; Part one. Look for either #endif or #else.
763 ;; This loop-and-a-half dedicated to E. Dijkstra.
764 (hif-find-next-relevant)
765 (while (hif-looking-at-ifX) ; Skip nested ifdef
767 (hif-find-next-relevant))
768 ;; Found either a #else or an #endif.
769 (cond ((hif-looking-at-else)
773 (setq end
(point)) ; (save-excursion (end-of-line) (point))
775 ;; If found #else, look for #endif.
778 (hif-find-next-relevant)
779 (while (hif-looking-at-ifX) ; Skip nested ifdef
781 (hif-find-next-relevant))
782 (if (hif-looking-at-else)
783 (error "Found two elses in a row? Broken!"))
784 (setq end
(point)) ; (save-excursion (end-of-line) (point))
786 (hif-make-range else-p start end else
))))
790 ;;; NOTE: If there's an #ifdef at the beginning of the file, we can't
791 ;;; hide it. There's no previous newline to replace. If we added
792 ;;; one, we'd throw off all the counts. Feh.
794 (defun hif-hide-line (point)
795 "Hide the line containing point. Does nothing if `hide-ifdef-lines' is nil."
799 (let ((modp (buffer-modified-p)))
803 (if (not (= (point) 1))
804 (hide-ifdef-region (1- (point)) (point))))
805 (set-buffer-modified-p modp
))
810 ;;; Hif-Possibly-Hide
811 ;;; There are four cases. The #ifX expression is "taken" if it
812 ;;; the hide-ifdef-evaluator returns T. Presumably, this means the code
813 ;;; inside the #ifdef would be included when the program was
816 ;;; Case 1: #ifX taken, and there's an #else.
817 ;;; The #else part must be hidden. The #if (then) part must be
818 ;;; processed for nested #ifX's.
819 ;;; Case 2: #ifX taken, and there's no #else.
820 ;;; The #if part must be processed for nested #ifX's.
821 ;;; Case 3: #ifX not taken, and there's an #else.
822 ;;; The #if part must be hidden. The #else part must be processed
824 ;;; Case 4: #ifX not taken, and there's no #else.
825 ;;; The #ifX part must be hidden.
827 ;;; Further processing is done by narrowing to the relevant region
828 ;;; and just recursively calling hide-ifdef-guts.
830 ;;; When hif-possibly-hide returns, point is at the end of the
831 ;;; possibly-hidden range.
833 (defun hif-recurse-on (start end
)
834 "Call `hide-ifdef-guts' after narrowing to end of START line and END line."
839 (narrow-to-region (point) end
)
842 (defun hif-possibly-hide ()
843 "Called at #ifX expression, this hides those parts that should be hidden.
844 It uses the judgement of `hide-ifdef-evaluator'."
845 ; (message "hif-possibly-hide") (sit-for 1)
846 (let ((test (hif-canonicalize))
847 (range (hif-find-range)))
848 ; (message "test = %s" test) (sit-for 1)
850 (hif-hide-line (hif-range-end range
))
851 (if (funcall hide-ifdef-evaluator test
)
852 (cond ((hif-range-else-p range
) ; case 1
853 (hif-hide-line (hif-range-else range
))
854 (hide-ifdef-region (hif-range-else range
)
855 (1- (hif-range-end range
)))
856 (hif-recurse-on (hif-range-start range
)
857 (hif-range-else range
)))
859 (hif-recurse-on (hif-range-start range
)
860 (hif-range-end range
))))
861 (cond ((hif-range-else-p range
) ; case 3
862 (hif-hide-line (hif-range-else range
))
863 (hide-ifdef-region (hif-range-start range
)
864 (1- (hif-range-else range
)))
865 (hif-recurse-on (hif-range-else range
)
866 (hif-range-end range
)))
868 (hide-ifdef-region (point)
869 (1- (hif-range-end range
))))
871 (hif-hide-line (hif-range-start range
)) ; Always hide start.
872 (goto-char (hif-range-end range
))
878 (defun hide-ifdef-guts ()
879 "Does most of the work of `hide-ifdefs'.
880 It does not do the work that's pointless to redo on a recursive entry."
881 ; (message "hide-ifdef-guts")
883 (goto-char (point-min))
884 (while (hif-find-any-ifX)
885 (hif-possibly-hide))))
887 ;===%%SF%% hide-ifdef-hiding (End) ===
890 ;===%%SF%% exports (Start) ===
893 (defcustom hide-ifdef-initially nil
894 "*Non-nil means call `hide-ifdefs' when Hide-Ifdef mode is first activated."
899 (defcustom hide-ifdef-read-only nil
900 "*Set to non-nil if you want buffer to be read-only while hiding text."
904 (defvar hif-outside-read-only nil
905 "Internal variable. Saves the value of `buffer-read-only' while hiding.")
908 (defcustom hide-ifdef-lines nil
909 "*Non-nil means hide the #ifX, #else, and #endif lines."
913 (defun hide-ifdef-toggle-read-only ()
914 "Toggle hide-ifdef-read-only."
916 (setq hide-ifdef-read-only
(not hide-ifdef-read-only
))
917 (message "Hide-Read-Only %s"
918 (if hide-ifdef-read-only
"ON" "OFF"))
919 (if hide-ifdef-hiding
920 (setq buffer-read-only
(or hide-ifdef-read-only hif-outside-read-only
)))
921 (force-mode-line-update))
923 (defun hide-ifdef-toggle-outside-read-only ()
924 "Replacement for `toggle-read-only' within Hide-Ifdef mode."
926 (setq hif-outside-read-only
(not hif-outside-read-only
))
927 (message "Read only %s"
928 (if hif-outside-read-only
"ON" "OFF"))
929 (setq buffer-read-only
930 (or (and hide-ifdef-hiding hide-ifdef-read-only
)
931 hif-outside-read-only
)
933 (force-mode-line-update))
936 (defun hide-ifdef-define (var)
937 "Define a VAR so that #ifdef VAR would be included."
938 (interactive "SDefine what? ")
940 (if hide-ifdef-hiding
(hide-ifdefs)))
942 (defun hide-ifdef-undef (var)
943 "Undefine a VAR so that #ifdef VAR would not be included."
944 (interactive "SUndefine what? ")
945 (hif-set-var var nil
)
946 (if hide-ifdef-hiding
(hide-ifdefs)))
949 (defun hide-ifdefs (&optional nomsg
)
950 "Hide the contents of some #ifdefs.
951 Assume that defined symbols have been added to `hide-ifdef-env'.
952 The text hidden is the text that would not be included by the C
953 preprocessor if it were given the file with those symbols defined.
955 Turn off hiding by calling `show-ifdefs'."
958 (message "Hiding...")
959 (setq hif-outside-read-only buffer-read-only
)
960 (if (not hide-ifdef-mode
)
961 (hide-ifdef-mode 1)) ; turn on hide-ifdef-mode
962 (if hide-ifdef-hiding
963 (show-ifdefs)) ; Otherwise, deep confusion.
964 (let ((inhibit-read-only t
))
965 (setq selective-display t
)
966 (setq hide-ifdef-hiding t
)
968 (setq buffer-read-only
(or hide-ifdef-read-only hif-outside-read-only
))
970 (message "Hiding done")))
973 (defun show-ifdefs ()
974 "Cancel the effects of `hide-ifdef': show the contents of all #ifdefs."
976 (setq buffer-read-only hif-outside-read-only
)
977 (setq selective-display nil
) ; defaults
978 (let ((inhibit-read-only t
))
980 (setq hide-ifdef-hiding nil
))
983 (defun hif-find-ifdef-block ()
984 "Utility for hide and show `ifdef-block'.
985 Set top and bottom of ifdef block."
989 (if (not (or (hif-looking-at-else) (hif-looking-at-ifX)))
993 (setq max-bottom
(1- (point))))
996 (if (not (hif-looking-at-endif))
997 (hif-find-next-relevant))
998 (while (hif-looking-at-ifX)
1000 (hif-find-next-relevant))
1001 (setq bottom
(min max-bottom
(1- (point))))))
1005 (defun hide-ifdef-block ()
1006 "Hide the ifdef block (true or false part) enclosing or before the cursor."
1008 (if (not hide-ifdef-mode
)
1009 (hide-ifdef-mode 1))
1010 (setq selective-display t
)
1011 (let (top bottom
(inhibit-read-only t
))
1012 (hif-find-ifdef-block) ; set top and bottom - dynamic scoping
1013 (hide-ifdef-region top bottom
)
1014 (if hide-ifdef-lines
1017 (hif-hide-line (1+ bottom
))))
1018 (setq hide-ifdef-hiding t
))
1019 (setq buffer-read-only
(or hide-ifdef-read-only hif-outside-read-only
)))
1022 (defun show-ifdef-block ()
1023 "Show the ifdef block (true or false part) enclosing or before the cursor."
1025 (let ((inhibit-read-only t
))
1026 (if hide-ifdef-lines
1029 (hif-show-ifdef-region (1- (point)) (progn (end-of-line) (point))))
1032 (hif-find-ifdef-block)
1033 (hif-show-ifdef-region (1- top
) bottom
)))))
1036 ;;; definition alist support
1038 (defvar hide-ifdef-define-alist nil
1039 "A global assoc list of pre-defined symbol lists")
1041 (defun hif-compress-define-list (env)
1042 "Compress the define list ENV into a list of defined symbols only."
1043 (let ((defs (mapcar '(lambda (arg)
1044 (if (hif-lookup (car arg
)) (car arg
)))
1049 (setq new-defs
(cons (car defs
) new-defs
)))
1050 (setq defs
(cdr defs
)))
1053 (defun hide-ifdef-set-define-alist (name)
1054 "Set the association for NAME to `hide-ifdef-env'."
1055 (interactive "SSet define list: ")
1056 (setq hide-ifdef-define-alist
1057 (cons (cons name
(hif-compress-define-list hide-ifdef-env
))
1058 hide-ifdef-define-alist
)))
1060 (defun hide-ifdef-use-define-alist (name)
1061 "Set `hide-ifdef-env' to the define list specified by NAME."
1062 (interactive "SUse define list: ")
1063 (let ((define-list (assoc name hide-ifdef-define-alist
)))
1065 (setq hide-ifdef-env
1066 (mapcar '(lambda (arg) (cons arg t
))
1068 (error "No define list for %s" name
))
1069 (if hide-ifdef-hiding
(hide-ifdefs))))
1073 ;;; hideif.el ends here