|
0
|
1 ;;!emacs
|
|
|
2 ;;
|
|
|
3 ;; FILE: br-lib.el
|
|
|
4 ;; SUMMARY: OO-Browser support functions.
|
|
|
5 ;; USAGE: GNU Emacs Lisp Library
|
|
|
6 ;; KEYWORDS: oop, tools
|
|
|
7 ;;
|
|
|
8 ;; AUTHOR: Bob Weiner
|
|
100
|
9 ;; ORG: InfoDock Associates
|
|
0
|
10 ;;
|
|
|
11 ;; ORIG-DATE: 22-Mar-90
|
|
100
|
12 ;; LAST-MOD: 20-Feb-97 at 10:55:11 by Bob Weiner
|
|
0
|
13 ;;
|
|
100
|
14 ;; Copyright (C) 1990-1997 Free Software Foundation, Inc.
|
|
0
|
15 ;; See the file BR-COPY for license information.
|
|
|
16 ;;
|
|
|
17 ;; This file is part of the OO-Browser.
|
|
|
18
|
|
|
19 ;;; ************************************************************************
|
|
|
20 ;;; Other required Elisp libraries
|
|
|
21 ;;; ************************************************************************
|
|
|
22
|
|
|
23 (mapcar 'require '(br-env br-ftr br-compl set))
|
|
|
24
|
|
|
25 ;;; ************************************************************************
|
|
|
26 ;;; Public variables
|
|
|
27 ;;; ************************************************************************
|
|
|
28
|
|
|
29 (defvar br-null-path "<none>"
|
|
|
30 "Pathname associated with OO-Browser entities which have no source file.
|
|
|
31 That is, virtual entities, such as categories.")
|
|
|
32
|
|
|
33 ;;; ************************************************************************
|
|
|
34 ;;; General public functions
|
|
|
35 ;;; ************************************************************************
|
|
|
36
|
|
|
37 (defun br-buffer-replace (regexp to-str)
|
|
|
38 "In current buffer, replace all occurrences of REGEXP with TO-STR."
|
|
|
39 (goto-char (point-min))
|
|
|
40 (while (re-search-forward regexp nil t)
|
|
|
41 (replace-match to-str 'fixedcase nil)
|
|
|
42 (backward-char 1)))
|
|
|
43
|
|
|
44 (defun br-delete-space (string)
|
|
|
45 "Delete any leading and trailing space from STRING and return the STRING. "
|
|
|
46 (if (string-match "\\`\\s *\\(\\(.\\|\n\\)*\\S \\)\\s *\\'" string)
|
|
|
47 (setq string (substring string (match-beginning 1)
|
|
|
48 (match-end 1)))
|
|
|
49 string))
|
|
|
50
|
|
|
51 (defun br-first-match (regexp list)
|
|
|
52 "Return non-nil if REGEXP matches to an element of LIST.
|
|
|
53 All elements of LIST must be strings.
|
|
|
54 The value returned is the first matched element."
|
|
|
55 (while (and list (not (string-match regexp (car list))))
|
|
|
56 (setq list (cdr list)))
|
|
|
57 (car list))
|
|
|
58
|
|
|
59 (defun br-filename-head (path)
|
|
|
60 (setq path (file-name-nondirectory path))
|
|
|
61 (if (string-match "\\(.+\\)\\." path)
|
|
|
62 (substring path 0 (match-end 1))
|
|
|
63 path))
|
|
|
64
|
|
|
65 (defun br-duplicate-and-unique-strings (sorted-strings)
|
|
|
66 "Return SORTED-STRINGS list with a list of duplicate entries consed onto the front of the list."
|
|
|
67 (let ((elt1) (elt2) (lst sorted-strings)
|
|
|
68 (count 0) (repeat) (duplicates))
|
|
|
69 (while (setq elt1 (car lst) elt2 (car (cdr lst)))
|
|
|
70 (cond ((not (string-equal elt1 elt2))
|
|
|
71 (setq lst (cdr lst)))
|
|
|
72 ((equal elt1 repeat)
|
|
|
73 ;; Already recorded this duplicate.
|
|
|
74 (setcdr lst (cdr (cdr lst))))
|
|
|
75 (t ;; new duplicate
|
|
|
76 (setq count (1+ count)
|
|
|
77 duplicates (cons elt1 duplicates)
|
|
|
78 repeat elt1)
|
|
|
79 (setcdr lst (cdr (cdr lst))))))
|
|
|
80 (cons (sort duplicates 'string-lessp) sorted-strings)))
|
|
|
81
|
|
|
82 (defun br-set-of-strings (sorted-strings &optional count)
|
|
|
83 "Return SORTED-STRINGS list with any duplicate entries removed.
|
|
|
84 Optional COUNT conses number of duplicates on to front of list before return."
|
|
|
85 (and count (setq count 0))
|
|
|
86 (let ((elt1) (elt2) (lst sorted-strings)
|
|
|
87 (test (if count
|
|
|
88 (function
|
|
|
89 (lambda (a b) (if (string-equal a b)
|
|
|
90 (setq count (1+ count)))))
|
|
|
91 (function (lambda (a b) (string-equal a b))))))
|
|
|
92 (while (setq elt1 (car lst) elt2 (car (cdr lst)))
|
|
|
93 (if (funcall test elt1 elt2)
|
|
|
94 (setcdr lst (cdr (cdr lst)))
|
|
|
95 (setq lst (cdr lst)))))
|
|
|
96 (if count (cons count sorted-strings) sorted-strings))
|
|
|
97
|
|
|
98 (defun br-member-sorted-strings (elt list)
|
|
100
|
99 "Return non-nil if ELT is an element of LIST. Comparison done with `string-equal'.
|
|
0
|
100 All ELTs must be strings and the list must be sorted in ascending order.
|
|
|
101 The value returned is actually the tail of LIST whose car is ELT."
|
|
|
102 (while (and list (not (string-equal (car list) elt)))
|
|
|
103 (setq list (and (string-lessp (car list) elt)
|
|
|
104 (cdr list))))
|
|
|
105 list)
|
|
|
106
|
|
|
107 (defun br-pathname-head (path)
|
|
|
108 (if (string-match "\\(.+\\)\\." path)
|
|
|
109 (substring path 0 (match-end 1))
|
|
|
110 path))
|
|
|
111
|
|
|
112 (defun br-quote-match (match-num)
|
|
|
113 "Quote special symbols in last matched expression MATCH-NUM."
|
|
|
114 (br-regexp-quote (buffer-substring (match-beginning match-num)
|
|
|
115 (match-end match-num))))
|
|
|
116
|
|
|
117 (defun br-rassoc (elt list)
|
|
|
118 "Return non-nil if ELT is the cdr of an element of LIST.
|
|
100
|
119 Comparison done with `equal'. The value is actually the tail of LIST
|
|
0
|
120 starting at the element whose cdr is ELT."
|
|
|
121 (while (and list (not (equal (cdr (car list)) elt)))
|
|
|
122 (setq list (cdr list)))
|
|
|
123 list)
|
|
|
124
|
|
|
125 (defun br-regexp-quote (obj)
|
|
|
126 "If OBJ is a string, quote and return it for use in a regular expression."
|
|
|
127 ;; Don't use (stringp obj) here since we want to signal an error if some
|
|
|
128 ;; caller ever passes in a non-nil, non-string object, to aid in debugging.
|
|
|
129 (if obj (regexp-quote obj)))
|
|
|
130
|
|
|
131 (defun br-relative-path (filename &optional directory)
|
|
|
132 "Convert FILENAME to be relative to DIRECTORY or default-directory.
|
|
|
133 The shorter of the absolute and relative paths is returned."
|
|
|
134 (let ((relative-path (file-relative-name filename directory)))
|
|
|
135 (if (< (length relative-path) (length filename))
|
|
|
136 relative-path
|
|
|
137 filename)))
|
|
|
138
|
|
|
139 (defmacro br-set-cons (set elt)
|
|
|
140 "Add to SET element ELT. Returns nil iff ELT is already in SET.
|
|
100
|
141 Uses `equal' for comparison."
|
|
0
|
142 (` (if (br-member (, elt) (, set))
|
|
|
143 nil
|
|
|
144 (setq (, set) (cons (, elt) (, set))))))
|
|
|
145
|
|
|
146
|
|
|
147 (defun br-wind-line-at-point ()
|
|
|
148 "Return window relative line number that point is on."
|
|
|
149 (max 0 (1- (- (count-lines 1 (1+ (point)))
|
|
|
150 (count-lines 1 (window-start))))))
|
|
|
151
|
|
|
152 ;;; ************************************************************************
|
|
|
153 ;;; Browser public functions
|
|
|
154 ;;; ************************************************************************
|
|
|
155
|
|
|
156 (defun br-add-class (class-name &optional class-path lib-table-p save-file)
|
|
|
157 "Add or replace CLASS-NAME in current Environment.
|
|
|
158 Find class source in optional CLASS-PATH. Interactively or when optional
|
|
|
159 CLASS-PATH is nil, defaults to current buffer file as CLASS-PATH. If
|
|
|
160 optional LIB-TABLE-P is non-nil, add to Library Environment, otherwise add to
|
|
|
161 System Environment. If optional SAVE-FILE is t, the Environment is then
|
|
100
|
162 stored to filename given by `br-env-file'. If SAVE-FILE is non-nil and
|
|
0
|
163 not t, its string value is used as the file to which to save the Environment.
|
|
|
164 Does not update children lookup table."
|
|
|
165 (interactive
|
|
|
166 (list (read-string "Class name to add: ")
|
|
|
167 (read-file-name (concat "Class file name"
|
|
|
168 (if buffer-file-name
|
|
|
169 " (default <current file>)")
|
|
|
170 ": ")
|
|
|
171 nil buffer-file-name t)
|
|
|
172 (y-or-n-p "Add to Library, rather than System tables? ")
|
|
|
173 (y-or-n-p
|
|
|
174 (concat "Save tables after addition to " br-env-file "? "))))
|
|
|
175 ;;
|
|
|
176 ;; Pseudo code:
|
|
|
177 ;;
|
|
|
178 ;; If class-name is in table
|
|
|
179 ;; If function called interactively
|
|
|
180 ;; Query whether should overwrite class-name in tables
|
|
|
181 ;; If yes
|
|
100
|
182 ;; Replace class and its features
|
|
0
|
183 ;; else
|
|
|
184 ;; Don't add class; do nothing
|
|
|
185 ;; end
|
|
|
186 ;; else
|
|
100
|
187 ;; Store class without its features in all necessary tables
|
|
0
|
188 ;; end
|
|
|
189 ;; else
|
|
100
|
190 ;; Store class and its features under key in all necessary tables
|
|
0
|
191 ;; end
|
|
|
192 ;;
|
|
|
193 (or class-path (setq class-path buffer-file-name)
|
|
|
194 (error "No class pathname specified."))
|
|
|
195 (if (or (string-equal class-name "")
|
|
|
196 (not (or (equal class-path br-null-path)
|
|
|
197 (file-exists-p class-path))))
|
|
100
|
198 (error (format "Invalid class specified, `%s', in: %s" class-name class-path)))
|
|
0
|
199 ;; Is class already in Environment?
|
|
|
200 (if (hash-key-p class-name (br-get-htable
|
|
|
201 (if lib-table-p "lib-parents" "sys-parents")))
|
|
100
|
202 (if (or (not (interactive-p))
|
|
|
203 (y-or-n-p (format "Overwrite existing `%s' entry? " class-name)))
|
|
|
204 (br-real-add-class lib-table-p class-name class-path t)
|
|
|
205 (setq save-file nil))
|
|
0
|
206 (br-real-add-class lib-table-p class-name class-path))
|
|
|
207 (cond ((eq save-file nil))
|
|
|
208 ((eq save-file t) (br-env-save))
|
|
|
209 ((br-env-save save-file))))
|
|
|
210
|
|
|
211 (defun br-build-lib-htable ()
|
|
|
212 "Build Library dependent Environment."
|
|
|
213 (interactive)
|
|
|
214 (cond ((and (interactive-p)
|
|
|
215 (not (y-or-n-p "Rebuild Library Environment? ")))
|
|
|
216 nil)
|
|
|
217 (t
|
|
|
218 (message "Building Library Environment...")
|
|
|
219 (sit-for 2)
|
|
|
220 (br-real-build-alists br-lib-search-dirs)
|
|
|
221 (setq br-lib-paths-htable (hash-make br-paths-alist)
|
|
|
222 br-lib-parents-htable (hash-make br-parents-alist))
|
|
|
223 (run-hooks 'br-after-build-lib-hook)
|
|
|
224 (br-env-set-htables)
|
|
|
225 (br-build-children-htable)
|
|
|
226 ;; Set prev-search-dirs so table rebuilds are not triggered.
|
|
|
227 (setq br-lib-prev-search-dirs br-lib-search-dirs)
|
|
|
228 (if (interactive-p) (br-env-save))
|
|
|
229 (message "Building Library Environment...Done")
|
|
|
230 t)))
|
|
|
231
|
|
|
232 (defun br-build-sys-htable ()
|
|
|
233 "Build System dependent class Environment."
|
|
|
234 (interactive)
|
|
|
235 (cond ((and (interactive-p)
|
|
|
236 (not (y-or-n-p "Rebuild System Environment? ")))
|
|
|
237 nil)
|
|
|
238 (t
|
|
|
239 (message "Building System Environment...")
|
|
|
240 (sit-for 2)
|
|
|
241 (br-real-build-alists br-sys-search-dirs)
|
|
|
242 (setq br-sys-paths-htable (hash-make br-paths-alist)
|
|
|
243 br-sys-parents-htable (hash-make br-parents-alist))
|
|
|
244 (run-hooks 'br-after-build-sys-hook)
|
|
|
245 (br-env-set-htables)
|
|
|
246 (br-build-children-htable)
|
|
|
247 ;; Set prev-search-dirs so table rebuilds are not triggered.
|
|
|
248 (setq br-sys-prev-search-dirs br-sys-search-dirs)
|
|
|
249 (if (interactive-p) (br-env-save))
|
|
|
250 (message "Building System Environment...Done")
|
|
|
251 t)))
|
|
|
252
|
|
|
253 (defun br-class-in-table-p (class-name)
|
|
|
254 "Return t iff CLASS-NAME is found in current Environment."
|
|
|
255 (interactive (list (br-complete-class-name)))
|
|
|
256 (if class-name (hash-key-p class-name (br-get-parents-htable))))
|
|
|
257
|
|
|
258 (defun br-class-path (class-name &optional insert)
|
|
|
259 "Return full path, if any, to CLASS-NAME.
|
|
|
260 With optional prefix argument INSERT non-nil, insert path at point.
|
|
|
261 Only the first matching class is returned, so each CLASS-NAME should be
|
|
100
|
262 unique. Set `br-lib/sys-search-dirs' properly before use."
|
|
0
|
263 (interactive (list (br-complete-class-name)))
|
|
|
264 (setq class-name (if class-name (br-set-case class-name)))
|
|
|
265 (let* ((class-path)
|
|
|
266 (class-htable (br-get-paths-htable)))
|
|
|
267 (hash-map
|
|
|
268 (function (lambda (val-key-cons)
|
|
|
269 (and (null class-path)
|
|
|
270 (br-member-sorted-strings class-name (car val-key-cons))
|
|
|
271 (setq class-path (br-select-path val-key-cons nil)))))
|
|
|
272 class-htable)
|
|
|
273 (if (equal class-path br-null-path)
|
|
|
274 (setq class-path nil))
|
|
|
275 (and (interactive-p) (setq insert current-prefix-arg))
|
|
|
276 (if (and insert class-path)
|
|
|
277 (insert class-path)
|
|
|
278 (if (interactive-p)
|
|
|
279 (message
|
|
|
280 (or class-path
|
|
|
281 (format
|
|
100
|
282 "(OO-Browser): No `%s' class found in `br-lib/sys-search-dirs'."
|
|
0
|
283 class-name)))))
|
|
|
284 class-path))
|
|
|
285
|
|
|
286 (defun br-find-class (&optional class-name view-only other-win)
|
|
|
287 "Display file of class text matching CLASS-NAME in VIEW-ONLY mode if non-nil.
|
|
|
288 Return t if class is successfully displayed, nil otherwise. Can also
|
|
|
289 signal an error when called interactively."
|
|
|
290 (interactive)
|
|
|
291 (and (interactive-p) (setq view-only current-prefix-arg))
|
|
|
292 (let ((class-path)
|
|
|
293 (info (equal br-lang-prefix "info-"))
|
|
|
294 (err))
|
|
|
295 (setq class-name
|
|
|
296 (or class-name (br-complete-class-name))
|
|
|
297 class-path (br-class-path class-name))
|
|
|
298 (cond
|
|
|
299 (info (info-find-nd class-path class-name (not view-only)))
|
|
|
300 (class-path
|
|
|
301 (if (file-readable-p class-path)
|
|
|
302 (progn (if view-only
|
|
|
303 (funcall br-view-file-function class-path other-win)
|
|
|
304 (funcall br-edit-file-function class-path other-win)
|
|
|
305 ;; Handle case of already existing buffer in
|
|
|
306 ;; read only mode.
|
|
|
307 (and buffer-read-only
|
|
|
308 (file-writable-p class-path)
|
|
|
309 (progn (setq buffer-read-only nil)
|
|
|
310 ;; Force mode-line redisplay
|
|
|
311 (set-buffer-modified-p
|
|
|
312 (buffer-modified-p)))))
|
|
|
313 (br-major-mode)
|
|
|
314 (let ((opoint (point))
|
|
|
315 (start)
|
|
|
316 (pmin (point-min))
|
|
|
317 (pmax (point-max))
|
|
|
318 (class-def (br-class-definition-regexp class-name)))
|
|
|
319 (widen)
|
|
|
320 (goto-char (point-min))
|
|
|
321 (if br-narrow-view-to-class
|
|
|
322 ;; Display file narrowed to definition of
|
|
100
|
323 ;; `class-name'.
|
|
0
|
324 (if (re-search-forward class-def nil t)
|
|
|
325 ;; Narrow display to this class
|
|
|
326 (progn (narrow-to-region
|
|
|
327 (progn (setq opoint
|
|
|
328 (goto-char
|
|
|
329 (match-beginning 0)))
|
|
|
330 (br-to-comments-begin)
|
|
|
331 (setq start (point))
|
|
|
332 (goto-char opoint)
|
|
|
333 start)
|
|
|
334 (progn (br-to-class-end)
|
|
|
335 (point)))
|
|
|
336 (goto-char (point-min)))
|
|
|
337 (goto-char opoint)
|
|
|
338 (narrow-to-region pmin pmax)
|
|
100
|
339 (setq err (format "(OO-Browser): No `%s' in %s" class-name
|
|
0
|
340 class-path))
|
|
|
341 )
|
|
|
342 (if (re-search-forward class-def nil t)
|
|
|
343 (progn (setq opoint (goto-char (match-beginning 0)))
|
|
|
344 (br-to-comments-begin)
|
|
|
345 (recenter 0))
|
|
|
346 (goto-char opoint)
|
|
|
347 (narrow-to-region pmin pmax)
|
|
100
|
348 (setq err (format "(OO-Browser): No `%s' in %s" class-name
|
|
0
|
349 class-path))
|
|
|
350 )))
|
|
|
351 (setq class-path t))
|
|
100
|
352 (setq err (format "(OO-Browser): `%s' - src file not found or not readable, %s"
|
|
0
|
353 class-name class-path)
|
|
|
354 class-path nil)
|
|
|
355 )
|
|
|
356 (if (interactive-p)
|
|
|
357 (setq err
|
|
100
|
358 (format "(OO-Browser): No `%s' class defined in Environment."
|
|
0
|
359 class-name))
|
|
|
360 )))
|
|
|
361 (if err (error err))
|
|
|
362 class-path))
|
|
|
363
|
|
|
364 (defun br-major-mode ()
|
|
|
365 "Invoke language-specific major mode on current buffer if not already set."
|
|
|
366 (or (eq major-mode (symbol-function 'br-lang-mode))
|
|
|
367 (br-lang-mode)))
|
|
|
368
|
|
100
|
369 (defun br-scan-mode ()
|
|
|
370 "Invoke language-specific major mode for current buffer without running its hooks.
|
|
|
371 This is used when scanning source files to build Environments."
|
|
|
372 (let ((mode-hook-sym
|
|
|
373 (intern-soft (concat (symbol-name (symbol-function 'br-lang-mode))
|
|
|
374 "-hook"))))
|
|
|
375 (if mode-hook-sym
|
|
|
376 (eval (` (let ((, mode-hook-sym)) (br-lang-mode))))
|
|
|
377 (br-lang-mode))))
|
|
|
378
|
|
0
|
379 (defun br-show-children (class-name)
|
|
|
380 "Return children of CLASS-NAME from current Environment."
|
|
|
381 (interactive (list (br-complete-class-name t)))
|
|
|
382 (and class-name
|
|
|
383 (br-get-children class-name)))
|
|
|
384
|
|
|
385 (defun br-show-parents (class-name)
|
|
|
386 "Return parents of CLASS-NAME from Environment or scan of current buffer's source."
|
|
|
387 (interactive (list (br-complete-class-name t)))
|
|
|
388 (if class-name
|
|
|
389 (if (br-class-in-table-p class-name)
|
|
|
390 (br-get-parents class-name)
|
|
|
391 (if (and buffer-file-name (file-readable-p buffer-file-name))
|
|
|
392 (let ((br-view-file-function 'br-insert-file-contents))
|
|
|
393 (br-get-parents-from-source buffer-file-name class-name))))))
|
|
|
394
|
|
|
395 (defun br-undefined-classes ()
|
|
|
396 "Return a list of the classes referenced but not defined within the current Environment."
|
|
|
397 (let ((classes (hash-get br-null-path (br-get-paths-htable))))
|
|
|
398 (delq nil (mapcar (function (lambda (class)
|
|
|
399 ;; Remove default classes
|
|
|
400 (if (/= (aref class 0) ?\[)
|
|
|
401 class)))
|
|
|
402 classes))))
|
|
|
403
|
|
|
404 ;;; ************************************************************************
|
|
|
405 ;;; Private functions
|
|
|
406 ;;; ************************************************************************
|
|
|
407
|
|
|
408 (defun br-add-to-paths-htable (class-name paths-key htable)
|
|
|
409 "Add CLASS-NAME under PATHS-KEY in paths lookup HTABLE, keeping the classes sorted."
|
|
|
410 (let ((other-classes (hash-get paths-key htable)))
|
|
|
411 (if (and other-classes (br-member-sorted-strings class-name other-classes))
|
|
|
412 nil
|
|
|
413 (hash-add (sort (cons class-name other-classes) 'string-lessp)
|
|
|
414 paths-key htable))))
|
|
|
415
|
|
|
416 (defun br-build-lib-parents-htable ()
|
|
|
417 (interactive)
|
|
|
418 (if (not br-lib-search-dirs)
|
|
|
419 nil
|
|
|
420 (message "Building Library parent...")
|
|
|
421 (sit-for 2)
|
|
|
422 (setq br-lib-parents-htable
|
|
|
423 (hash-make
|
|
|
424 (if br-lib-paths-htable
|
|
|
425 (br-real-build-parents-alist br-lib-paths-htable)
|
|
|
426 (br-real-build-alists br-lib-search-dirs)
|
|
|
427 br-parents-alist)))
|
|
|
428 (if (interactive-p) (br-env-save))
|
|
|
429 (message "Building Library parent...Done")))
|
|
|
430
|
|
|
431 (defun br-build-lib-paths-htable ()
|
|
|
432 (interactive)
|
|
|
433 (if (not br-lib-search-dirs)
|
|
|
434 nil
|
|
|
435 (message "Building Library paths...")
|
|
|
436 (sit-for 2)
|
|
|
437 (br-real-build-alists br-lib-search-dirs)
|
|
|
438 (setq br-lib-paths-htable (hash-make br-paths-alist))
|
|
|
439 (if (interactive-p) (br-env-save))
|
|
|
440 (message "Building Library paths...Done")))
|
|
|
441
|
|
|
442 (defun br-build-sys-parents-htable ()
|
|
|
443 (interactive)
|
|
|
444 (if (not br-sys-search-dirs)
|
|
|
445 nil
|
|
|
446 (message "Building System parents...")
|
|
|
447 (sit-for 2)
|
|
|
448 (setq br-sys-parents-htable
|
|
|
449 (hash-make
|
|
|
450 (if br-sys-paths-htable
|
|
|
451 (br-real-build-parents-alist br-sys-paths-htable)
|
|
|
452 (br-real-build-alists br-sys-search-dirs)
|
|
|
453 br-parents-alist)))
|
|
|
454 (if (interactive-p) (br-env-save))
|
|
|
455 (message "Building System parents...Done")))
|
|
|
456
|
|
|
457 (defun br-build-sys-paths-htable ()
|
|
|
458 (interactive)
|
|
|
459 (if (not br-sys-search-dirs)
|
|
|
460 nil
|
|
|
461 (message "Building System paths...")
|
|
|
462 (sit-for 2)
|
|
|
463 (br-real-build-alists br-sys-search-dirs)
|
|
|
464 (setq br-sys-paths-htable (hash-make br-paths-alist))
|
|
|
465 (if (interactive-p) (br-env-save))
|
|
|
466 (message "Building System paths...Done")))
|
|
|
467
|
|
|
468 (defun br-build-children-htable ()
|
|
|
469 (interactive)
|
|
|
470 (setq br-children-htable (br-real-build-children-htable))
|
|
|
471 (if (interactive-p) (br-env-save)))
|
|
|
472
|
|
|
473 (defun br-build-parents-htable ()
|
|
|
474 (interactive)
|
|
|
475 (br-build-sys-parents-htable)
|
|
|
476 (br-build-lib-parents-htable)
|
|
|
477 ;; Make System entries override Library entries which they duplicate, since
|
|
|
478 ;; this is generally more desireable than merging the two.
|
|
|
479 (let ((hash-merge-values-function (function (lambda (val1 val2) val1))))
|
|
|
480 (setq br-parents-htable (hash-merge br-sys-parents-htable
|
|
|
481 br-lib-parents-htable)))
|
|
|
482 (if (interactive-p) (br-env-save)))
|
|
|
483
|
|
|
484 (defun br-build-paths-htable ()
|
|
|
485 (interactive)
|
|
|
486 (br-build-sys-paths-htable)
|
|
|
487 (br-build-lib-paths-htable)
|
|
|
488 (setq br-paths-htable (hash-merge br-sys-paths-htable br-lib-paths-htable))
|
|
|
489 (if (interactive-p) (br-env-save)))
|
|
|
490
|
|
|
491 (defun br-class-defined-p (class)
|
|
|
492 "Return path for CLASS if defined in current Environment.
|
|
|
493 Otherwise, display error and return nil."
|
|
|
494 (or (br-class-path class)
|
|
|
495 (progn
|
|
|
496 (beep)
|
|
|
497 (message
|
|
|
498 (if (br-class-in-table-p class)
|
|
100
|
499 (format "(OO-Browser): Class `%s' referenced but not defined in Environment."
|
|
0
|
500 class)
|
|
100
|
501 (format "(OO-Browser): Class `%s' not defined in Environment."
|
|
0
|
502 class)))
|
|
|
503 nil)))
|
|
|
504
|
|
|
505 (defun br-check-for-class (cl &optional other-win)
|
|
|
506 "Try to display class CL.
|
|
|
507 Display message and return nil if unsucessful."
|
|
|
508 (if (br-class-in-table-p cl)
|
|
|
509 (or (br-find-class cl nil other-win)
|
|
|
510 (progn
|
|
|
511 (beep)
|
|
|
512 (message
|
|
100
|
513 (format "(OO-Browser): Class `%s' referenced but not defined in Environment."
|
|
0
|
514 cl))
|
|
|
515 t))))
|
|
|
516
|
|
100
|
517 (defun br-delete-features (class)
|
|
|
518 "Delete all feature tags lexically defined in CLASS."
|
|
|
519 (br-feature-map-class-tags
|
|
|
520 (function (lambda ()
|
|
|
521 (beginning-of-line)
|
|
|
522 (delete-region (point) (progn (forward-line 1) (point)))))
|
|
|
523 class)
|
|
|
524 nil)
|
|
|
525
|
|
0
|
526 (defun br-get-children (class-name)
|
|
|
527 "Return list of children of CLASS-NAME from child lookup table.
|
|
|
528 Those which directly inherit from CLASS-NAME."
|
|
|
529 (setq class-name (and class-name (br-set-case class-name)))
|
|
|
530 (br-set-of-strings (hash-get class-name (br-get-children-htable))))
|
|
|
531
|
|
|
532 (defun br-get-parents (class-name)
|
|
|
533 "Return list of parents of CLASS-NAME from parent lookup table.
|
|
|
534 Those from which CLASS-NAME directly inherits."
|
|
|
535 (setq class-name (and class-name (br-set-case class-name)))
|
|
|
536 (br-set-of-strings (hash-get class-name (br-get-parents-htable))))
|
|
|
537
|
|
|
538 (defun br-get-children-htable ()
|
|
100
|
539 "Loads or builds `br-children-htable' if necessary and returns value."
|
|
0
|
540 (br-get-htable "children"))
|
|
|
541
|
|
|
542 (defun br-get-paths-htable ()
|
|
100
|
543 "Loads or builds `br-paths-htable' if necessary and returns value."
|
|
0
|
544 (br-get-htable "paths"))
|
|
|
545
|
|
|
546 (defun br-get-parents-htable ()
|
|
100
|
547 "Loads or builds `br-parents-htable' if necessary and returns value."
|
|
0
|
548 (br-get-htable "parents"))
|
|
|
549
|
|
|
550 (defun br-get-children-from-parents-htable (class-name)
|
|
|
551 "Return list of children of CLASS-NAME.
|
|
|
552 Those that directly inherit from CLASS-NAME. Use parent lookup table to
|
|
|
553 compute children."
|
|
|
554 (setq class-name (and class-name (br-set-case class-name)))
|
|
|
555 (delq nil (hash-map (function (lambda (cns)
|
|
|
556 (if (and (consp cns)
|
|
|
557 (br-member class-name (car cns)))
|
|
|
558 (cdr cns))))
|
|
|
559 (br-get-parents-htable))))
|
|
|
560
|
|
|
561 (defun br-get-htable (htable-type)
|
|
|
562 "Return hash table corresponding to string, HTABLE-TYPE. When necessary,
|
|
|
563 load the hash table from a file or build it."
|
|
|
564 (let* ((htable-symbol (intern-soft (concat "br-" htable-type "-htable")))
|
|
|
565 (htable-specific (if (string-match "sys\\|lib" htable-type)
|
|
|
566 (substring htable-type (match-beginning 0)
|
|
|
567 (match-end 0))))
|
|
|
568 changed-types non-matched-types)
|
|
|
569 (if (equal htable-type "children")
|
|
|
570 nil
|
|
|
571 (if (and (or (not htable-specific) (equal htable-specific "lib"))
|
|
|
572 (or (null (symbol-value htable-symbol))
|
|
|
573 (not (equal br-lib-prev-search-dirs br-lib-search-dirs))))
|
|
|
574 (setq changed-types '("lib")))
|
|
|
575 (if (and (or (not htable-specific) (equal htable-specific "sys"))
|
|
|
576 (or (null (symbol-value htable-symbol))
|
|
|
577 (not (equal br-sys-prev-search-dirs br-sys-search-dirs))))
|
|
|
578 (setq changed-types (cons "sys" changed-types))))
|
|
|
579 (if (and (or br-lib-search-dirs br-sys-search-dirs)
|
|
|
580 (or changed-types (null (symbol-value htable-symbol)))
|
|
|
581 (not (boundp 'br-loaded)))
|
|
|
582 ;;
|
|
|
583 ;; Then need to load or rebuild htable.
|
|
|
584 ;;
|
|
|
585 (progn (if (and br-env-file
|
|
|
586 (file-exists-p br-env-file))
|
|
|
587 ;;
|
|
|
588 ;; Try to load from file.
|
|
|
589 ;;
|
|
|
590 (progn (setq non-matched-types
|
|
|
591 (br-env-load-matching-htables changed-types))
|
|
|
592 (if non-matched-types
|
|
|
593 (setq changed-types
|
|
|
594 (delq nil (mapcar
|
|
|
595 (function
|
|
|
596 (lambda (type)
|
|
|
597 (if (br-member type
|
|
|
598 changed-types)
|
|
|
599 type)))
|
|
|
600 non-matched-types)))
|
|
|
601 (and changed-types (br-env-set-htables))
|
|
|
602 (setq changed-types nil)
|
|
|
603 (cond (htable-specific)
|
|
|
604 ((equal htable-type "children")
|
|
|
605 (progn (goto-char (point-min))
|
|
|
606 (setq br-children-htable
|
|
|
607 (cdr (br-env-file-sym-val
|
|
|
608 "br-children-htable")))))
|
|
|
609 ((let ((suffix
|
|
|
610 (concat "-" htable-type "-htable"))
|
|
|
611 (hash-merge-values-function
|
|
|
612 'hash-merge-values))
|
|
|
613 ;; Make System entries override
|
|
|
614 ;; Library entries which they
|
|
|
615 ;; duplicate, if this is the parents
|
|
|
616 ;; htable.
|
|
|
617 (if (equal htable-type "parents")
|
|
|
618 (setq hash-merge-values-function
|
|
|
619 (function
|
|
|
620 (lambda (val1 val2) val1))))
|
|
|
621 (set htable-symbol
|
|
|
622 (hash-merge
|
|
|
623 (symbol-value
|
|
|
624 (intern-soft
|
|
|
625 (concat "br-sys" suffix)))
|
|
|
626 (symbol-value
|
|
|
627 (intern-soft
|
|
|
628 (concat
|
|
|
629 "br-lib" suffix)))
|
|
|
630 ))))))))
|
|
|
631 ;; Rebuild any lists that need to be changed.
|
|
|
632 (mapcar
|
|
|
633 (function
|
|
|
634 (lambda (type-str)
|
|
|
635 (let ((suffix (concat "-" htable-type "-htable")))
|
|
|
636 (funcall (intern-soft
|
|
|
637 (concat "br-build-" type-str suffix)))
|
|
|
638 (and htable-specific
|
|
|
639 ;; Make System entries override Library entries
|
|
|
640 ;; which they duplicate, if this is the parents
|
|
|
641 ;; htable.
|
|
|
642 (let ((hash-merge-values-function
|
|
|
643 'hash-merge-values))
|
|
|
644 (if (equal htable-type "parents")
|
|
|
645 (setq hash-merge-values-function
|
|
|
646 (function (lambda (val1 val2) val1))))
|
|
|
647 (set htable-symbol
|
|
|
648 (hash-merge (symbol-value
|
|
|
649 (intern-soft
|
|
|
650 (concat "br-sys" suffix)))
|
|
|
651 (symbol-value
|
|
|
652 (intern-soft
|
|
|
653 (concat "br-lib" suffix)))
|
|
|
654 )))))))
|
|
|
655 changed-types)
|
|
|
656 (if (and changed-types br-env-file)
|
|
|
657 (br-env-save))
|
|
|
658 (let ((buf (get-file-buffer br-env-file)))
|
|
|
659 (and buf (kill-buffer buf)))
|
|
|
660 ))
|
|
|
661 ;; Return non-nil hash table.
|
|
|
662 (if (null (symbol-value htable-symbol))
|
|
|
663 (set htable-symbol (hash-make 0))
|
|
|
664 (symbol-value htable-symbol))))
|
|
|
665
|
|
|
666 (defun br-get-top-class-list (htable-type-str)
|
|
|
667 "Returns unordered list of top-level classes.
|
|
|
668 Those that do not explicitly inherit from any other classes. Obtains classes
|
|
|
669 from list denoted by HTABLE-TYPE-STR whose values may be:
|
|
|
670 \"parents\", \"sys-parents\", or \"lib-parents\"."
|
|
|
671 (delq nil (hash-map (function
|
|
|
672 (lambda (cns)
|
|
|
673 (and (null (car cns)) (cdr cns))))
|
|
|
674 (br-get-htable htable-type-str))))
|
|
|
675
|
|
|
676 (defun br-get-top-classes ()
|
|
|
677 "Returns lexicographically ordered list of top-level classes.
|
|
|
678 Those that do not explicitly inherit from any other classes."
|
|
|
679 (br-get-top-class-list "parents"))
|
|
|
680
|
|
|
681 (defun br-get-lib-top-classes ()
|
|
|
682 "Returns lexicographically ordered list of top-level Library classes.
|
|
|
683 Those that do not explicitly inherit from any other classes."
|
|
|
684 (br-get-top-class-list "lib-parents"))
|
|
|
685
|
|
|
686 (defun br-get-sys-top-classes ()
|
|
|
687 "Returns lexicographically ordered list of top-level System classes.
|
|
|
688 Those that do not explicitly inherit from any other classes."
|
|
|
689 (br-get-top-class-list "sys-parents"))
|
|
|
690
|
|
|
691 (defun br-has-children-p (class-name)
|
|
|
692 "Return non-nil iff CLASS-NAME has at least one child.
|
|
|
693 That is a class that directly inherits from CLASS-NAME."
|
|
|
694 (setq class-name (and class-name (br-set-case class-name)))
|
|
|
695 (hash-get class-name (br-get-children-htable)))
|
|
|
696
|
|
|
697 (defun br-has-parents-p (class-name)
|
|
|
698 "Return non-nil iff CLASS-NAME has at least one parent.
|
|
|
699 That is a class which is a direct ancestor of CLASS-NAME."
|
|
|
700 (setq class-name (and class-name (br-set-case class-name)))
|
|
|
701 (hash-get class-name (br-get-parents-htable)))
|
|
|
702
|
|
|
703 (defun br-get-process-group (group max)
|
|
|
704 "Return list of all active processes in GROUP (a string).
|
|
|
705 MAX is max number of processes to check for."
|
|
|
706 (let ((i 0)
|
|
|
707 (proc-list))
|
|
|
708 (while (<= i max)
|
|
|
709 (setq i (1+ i)
|
|
|
710 proc-list (cons (get-process (concat group (int-to-string i)))
|
|
|
711 proc-list)))
|
|
|
712 (delq nil proc-list)))
|
|
|
713
|
|
|
714
|
|
|
715 (defun br-kill-process-group (group max group-descrip)
|
|
|
716 "Optionally question user, then kill all subprocesses in named GROUP.
|
|
|
717 Processes are numbered one to MAX, some of which may have been killed already.
|
|
|
718 User is prompted with a string containing GROUP-DESCRIP, only if non-nil.
|
|
|
719 Return list of processes killed."
|
|
|
720 (let ((proc-list (br-get-process-group group max)))
|
|
|
721 (if proc-list
|
|
|
722 (if (or (null group-descrip)
|
|
|
723 (y-or-n-p (concat "Terminate all " group-descrip "? ")))
|
|
|
724 (prog1 (mapcar 'delete-process proc-list)
|
|
|
725 (message ""))))))
|
|
|
726
|
|
|
727 (defun br-real-add-class (lib-table-p class-name class-path &optional replace)
|
|
100
|
728 "Add or replace class and its features within the current Environment.
|
|
0
|
729 If LIB-TABLE-P is non-nil, add to Library Environment, otherwise add to
|
|
|
730 System Environment. Add class CLASS-NAME located in CLASS-PATH to
|
|
|
731 Environment. If CLASS-PATH is nil, use current buffer file as CLASS-PATH.
|
|
|
732 Optional REPLACE non-nil means replace already existing class. Does not
|
|
|
733 update children lookup table."
|
|
|
734 (or class-path (setq class-path buffer-file-name))
|
|
|
735 (let ((par-list)
|
|
|
736 (paths-key class-path)
|
|
|
737 (func)
|
|
|
738 (class class-name))
|
|
|
739 (if replace
|
|
|
740 (setq func 'hash-replace
|
|
|
741 class-name (br-first-match
|
|
|
742 (concat "^" (regexp-quote class-name) "$")
|
|
|
743 (hash-get paths-key
|
|
|
744 (if lib-table-p
|
|
|
745 (br-get-htable "lib-paths")
|
|
|
746 (br-get-htable "sys-paths"))))
|
|
|
747 par-list
|
|
|
748 (and (stringp class-path) (file-readable-p class-path)
|
|
|
749 (let ((br-view-file-function 'br-insert-file-contents))
|
|
|
750 (br-get-parents-from-source class-path class-name))))
|
|
|
751 (setq func 'hash-add))
|
|
|
752 ;; Signal error if class-name is invalid.
|
|
|
753 (if (null class-name)
|
|
|
754 (if replace
|
|
100
|
755 (error "(br-real-add-class): `%s' not found in %s classes, so cannot replace it."
|
|
0
|
756 class (if lib-table-p "Library" "System"))
|
|
|
757 (error
|
|
|
758 "(br-real-add-class): Attempt to add null class to %s classes."
|
|
|
759 (if lib-table-p "Library" "System"))))
|
|
|
760 ;;
|
|
|
761 (mapcar
|
|
|
762 (function
|
|
|
763 (lambda (type)
|
|
|
764 (let ((par-htable (br-get-htable (concat type "parents")))
|
|
|
765 (path-htable (br-get-htable (concat type "paths"))))
|
|
|
766 (funcall func par-list class-name par-htable)
|
|
|
767 (br-add-to-paths-htable class-name paths-key path-htable))))
|
|
100
|
768 (list (if lib-table-p "lib-" "sys-") ""))
|
|
|
769 (and (stringp class-path) (file-readable-p class-path)
|
|
|
770 (br-get-classes-from-source class-path))))
|
|
0
|
771
|
|
|
772 (defun br-real-delete-class (class-name)
|
|
|
773 "Delete class CLASS-NAME from current Environment.
|
|
|
774 No error occurs if the class is undefined in the Environment."
|
|
|
775 (require 'set)
|
|
100
|
776 (br-delete-features class-name)
|
|
0
|
777 (let ((paths-key (br-class-path class-name))
|
|
|
778 htable)
|
|
|
779 (setq class-name
|
|
|
780 (br-first-match (concat "^" class-name "$")
|
|
|
781 (hash-get paths-key (br-get-paths-htable))))
|
|
|
782 (if class-name
|
|
|
783 (progn (mapcar
|
|
|
784 (function
|
|
|
785 (lambda (type)
|
|
|
786 (hash-delete class-name
|
|
|
787 (br-get-htable (concat type "parents")))
|
|
|
788 (setq htable (br-get-htable (concat type "paths")))
|
|
|
789 (if (hash-key-p paths-key htable)
|
|
|
790 (hash-replace
|
|
|
791 (set:remove
|
|
|
792 class-name
|
|
|
793 (hash-get paths-key htable))
|
|
|
794 paths-key htable))))
|
|
|
795 '("lib-" "sys-" ""))
|
|
|
796 (hash-delete class-name (br-get-children-htable))))))
|
|
|
797
|
|
|
798 (defun br-real-build-children-htable ()
|
|
|
799 "Build and return Environment parent to child lookup table."
|
|
|
800 (let* ((par-ht (br-get-parents-htable))
|
|
|
801 (htable (hash-make (hash-size par-ht)))
|
|
|
802 (child))
|
|
|
803 (hash-map
|
|
|
804 (function
|
|
|
805 (lambda (par-child-cns)
|
|
|
806 (setq child (cdr par-child-cns))
|
|
|
807 (mapcar
|
|
|
808 (function
|
|
|
809 (lambda (parent)
|
|
|
810 (hash-add
|
|
|
811 (cons child (hash-get parent htable))
|
|
|
812 parent htable)))
|
|
|
813 (car par-child-cns))))
|
|
|
814 par-ht)
|
|
|
815 (hash-map (function
|
|
|
816 (lambda (children-parent-cns)
|
|
|
817 (hash-replace (sort (car children-parent-cns) 'string-lessp)
|
|
|
818 (cdr children-parent-cns) htable)))
|
|
|
819 htable)
|
|
|
820 htable))
|
|
|
821
|
|
|
822 (defun br-real-get-children (class-name)
|
|
|
823 "Return list of child classes of CLASS-NAME listed in Environment parents htable."
|
|
|
824 (delq nil (hash-map
|
|
|
825 (function
|
|
|
826 (lambda (cns)
|
|
|
827 (if (and (consp cns)
|
|
|
828 (br-member class-name (car cns)))
|
|
|
829 (cdr cns))))
|
|
|
830 (br-get-parents-htable))))
|
|
|
831
|
|
|
832 (defun br-real-build-alists (search-dirs)
|
|
100
|
833 "Use SEARCH-DIRS to build `br-paths-alist' and `br-parents-alist'."
|
|
0
|
834 (setq br-paths-alist nil br-parents-alist nil)
|
|
|
835 (br-feature-tags-init)
|
|
|
836 (br-real-build-al search-dirs)
|
|
|
837 (setq br-paths-alist br-paths-alist)
|
|
|
838 (br-feature-tags-save)
|
|
|
839 br-paths-alist)
|
|
|
840
|
|
|
841 (defvar br-paths-alist nil)
|
|
|
842 (defvar br-parents-alist nil)
|
|
|
843
|
|
|
844 (defun br-skip-dir-p (dir-name)
|
|
100
|
845 "Returns non-nil iff DIR-NAME is matched by a member of `br-skip-dir-regexps'."
|
|
0
|
846 (delq nil
|
|
|
847 (mapcar (function
|
|
|
848 (lambda (dir-regexp)
|
|
|
849 (string-match dir-regexp
|
|
|
850 (file-name-nondirectory
|
|
|
851 (directory-file-name dir-name)))))
|
|
|
852 br-skip-dir-regexps)))
|
|
|
853
|
|
|
854 ;;; If abbreviate-file-name is not defined, just make it return the same
|
|
|
855 ;;; string.
|
|
|
856 (or (fboundp 'abbreviate-file-name)
|
|
|
857 (fset 'abbreviate-file-name 'identity))
|
|
|
858
|
|
|
859 (defun br-real-build-al (search-dirs)
|
|
100
|
860 "Descend SEARCH-DIRS and build `br-paths-alist' and `br-parents-alist'.
|
|
|
861 Does not initialize `br-paths-alist' or `br-parents-alist' to nil."
|
|
0
|
862 (let ((inhibit-local-variables nil)
|
|
|
863 (enable-local-variables t)
|
|
|
864 (files)
|
|
100
|
865 ;; These are used in the `br-search-directory' function.
|
|
0
|
866 classes parents paths-parents-cons)
|
|
|
867 (mapcar
|
|
|
868 (function
|
|
|
869 (lambda (dir)
|
|
|
870 (if (or (null dir) (equal dir "")
|
|
|
871 (progn (setq dir (file-name-as-directory dir))
|
|
|
872 (br-skip-dir-p dir)))
|
|
|
873 nil
|
|
|
874 (setq files (if (and (file-directory-p dir)
|
|
|
875 (file-readable-p dir))
|
|
|
876 (directory-files dir t br-file-dir-regexp)))
|
|
|
877 ;; Extract all class/parent names in all source files in a
|
|
|
878 ;; particular directory.
|
|
|
879 (if files
|
|
|
880 (progn (message "Scanning %s in %s ..."
|
|
|
881 (file-name-nondirectory
|
|
|
882 (directory-file-name dir))
|
|
|
883 (abbreviate-file-name
|
|
|
884 (or (file-name-directory
|
|
|
885 (directory-file-name dir))
|
|
|
886 "")))
|
|
|
887 (br-search-directory dir files)
|
|
|
888 ;; Call same function on all the directories below
|
|
|
889 ;; this one.
|
|
|
890 (br-real-build-al
|
|
|
891 (mapcar (function (lambda (f)
|
|
|
892 (if (file-directory-p f) f)))
|
|
|
893 files)))))))
|
|
|
894 search-dirs)))
|
|
|
895
|
|
|
896 (defun br-search-directory (dir files)
|
|
|
897 (mapcar
|
|
|
898 (function
|
|
|
899 (lambda (f)
|
|
|
900 (if (file-readable-p f)
|
|
|
901 (setq paths-parents-cons
|
|
|
902 (let ((br-view-file-function 'br-insert-file-contents))
|
|
|
903 (message "Scanning %s in %s ..."
|
|
|
904 (file-name-nondirectory f)
|
|
|
905 (abbreviate-file-name
|
|
|
906 (or (file-name-directory f) default-directory)))
|
|
|
907 (br-get-classes-from-source f nil t))
|
|
|
908 classes (car paths-parents-cons)
|
|
|
909 parents (cdr paths-parents-cons)
|
|
|
910 br-paths-alist (if classes
|
|
|
911 (cons (cons (sort classes
|
|
|
912 'string-lessp) f)
|
|
|
913 br-paths-alist)
|
|
|
914 br-paths-alist)
|
|
|
915 br-parents-alist (if parents
|
|
|
916 (append br-parents-alist
|
|
|
917 parents)
|
|
|
918 br-parents-alist))
|
|
|
919 (message "(OO-Browser): Unreadable file: %s in %s"
|
|
|
920 (file-name-nondirectory f)
|
|
|
921 (abbreviate-file-name
|
|
|
922 (or (file-name-directory f) default-directory)))
|
|
|
923 (sit-for 1))))
|
|
|
924 ;; List of files potentially containing classes.
|
|
|
925 (delq nil
|
|
|
926 (mapcar
|
|
|
927 (function
|
|
|
928 (lambda (f)
|
|
|
929 (and (string-match br-src-file-regexp f)
|
|
|
930 (not (file-directory-p f))
|
|
|
931 f)))
|
|
|
932 files))))
|
|
|
933
|
|
|
934 (defun br-real-build-parents-alist (paths-htable)
|
|
100
|
935 "Build and return `br-parents-alist' of (parent-list . class) elements built from PATHS-HTABLE.
|
|
|
936 Initializes `br-parents-alist' to nil."
|
|
0
|
937 (let ((inhibit-local-variables nil)
|
|
|
938 (enable-local-variables t)
|
|
|
939 (br-view-file-function 'br-insert-file-contents))
|
|
|
940 (setq br-parents-alist nil)
|
|
|
941 (mapcar
|
|
|
942 (function
|
|
|
943 (lambda (cl-dir-list)
|
|
|
944 (mapcar (function
|
|
|
945 (lambda (class-dir-cons)
|
|
|
946 (let ((dir (cdr class-dir-cons)))
|
|
|
947 (mapcar
|
|
|
948 (function
|
|
|
949 (lambda (class-name)
|
|
|
950 (setq br-parents-alist
|
|
|
951 (cons (cons
|
|
|
952 (and (stringp dir)
|
|
|
953 (file-exists-p dir)
|
|
|
954 (br-get-parents-from-source
|
|
|
955 dir class-name))
|
|
|
956 class-name)
|
|
|
957 br-parents-alist))))
|
|
|
958 (car class-dir-cons)))))
|
|
|
959 cl-dir-list)))
|
|
|
960 paths-htable)
|
|
|
961 br-parents-alist))
|
|
|
962
|
|
|
963 (defun br-set-lang-env (func sym-list val)
|
|
|
964 "Use FUNC to set each element in SYM-LIST.
|
|
100
|
965 If VAL is non-nil, set `br' element to value of current OO-Browser language
|
|
0
|
966 element with the same name, otherwise set to symbol."
|
|
|
967 (let ((br) (lang))
|
|
|
968 (mapcar (function
|
|
|
969 (lambda (nm)
|
|
|
970 (setq br (intern (concat "br-" nm))
|
|
|
971 lang (intern-soft (concat br-lang-prefix nm)))
|
|
|
972 (funcall func br (if val
|
|
|
973 (symbol-value lang)
|
|
|
974 (or lang 'br-undefined-function)))))
|
|
|
975 sym-list)))
|
|
|
976
|
|
|
977 (defun br-undefined-function (&rest ignore)
|
|
|
978 (interactive)
|
|
|
979 (error "(OO-Browser): That command is not supported for this language."))
|
|
|
980
|
|
|
981 (defun br-setup-functions ()
|
|
|
982 "Initialize appropriate function pointers for the current browser language."
|
|
|
983 (br-set-lang-env 'fset
|
|
|
984 '("class-definition-regexp" "class-list-filter"
|
|
|
985 "get-classes-from-source" "get-parents-from-source"
|
|
|
986 "insert-class-info" "set-case" "set-case-type"
|
|
|
987 "to-class-end" "to-comments-begin" "to-definition"
|
|
|
988 "select-path"
|
|
|
989
|
|
|
990 "feature-implementors" "feature-locate-p"
|
|
100
|
991 "feature-name-to-regexp" "feature-map-class-tags"
|
|
|
992 "feature-signature-to-name"
|
|
0
|
993 "feature-signature-to-regexp" "feature-tag-class"
|
|
100
|
994 "feature-tag-regexp" "feature-tree-command-p"
|
|
0
|
995 "list-categories" "list-features" "list-protocols"
|
|
|
996 "view-friend" "view-protocol")
|
|
|
997 nil))
|
|
|
998
|
|
|
999 (defun br-setup-constants ()
|
|
|
1000 "Initialize appropriate constant values for the current browser language."
|
|
|
1001 ;; Clear language-dependent hooks.
|
|
|
1002 (setq br-after-build-lib-hook nil
|
|
|
1003 br-after-build-sys-hook nil)
|
|
|
1004 ;; Set language-specific constants.
|
|
|
1005 (br-set-lang-env 'set '("class-def-regexp" "env-file"
|
|
|
1006 "identifier" "identifier-chars"
|
|
|
1007 "src-file-regexp" "narrow-view-to-class"
|
|
|
1008 "type-tag-separator")
|
|
|
1009 t))
|
|
|
1010
|
|
|
1011 ;;; ************************************************************************
|
|
|
1012 ;;; Private variables
|
|
|
1013 ;;; ************************************************************************
|
|
|
1014
|
|
|
1015 (defvar br-lib-search-dirs nil
|
|
|
1016 "List of directories below which library dirs and source files are found.
|
|
|
1017 A library is a stable group of classes. Value is language-specific.")
|
|
|
1018 (defvar br-sys-search-dirs nil
|
|
|
1019 "List of directories below which system dirs and source files are found.
|
|
|
1020 A system is a group of classes that are likely to change. Value is
|
|
|
1021 language-specific.")
|
|
|
1022
|
|
|
1023 (defvar br-lib-prev-search-dirs nil
|
|
100
|
1024 "Used to check if `br-lib-paths-htable' must be regenerated.
|
|
0
|
1025 Value is language-specific.")
|
|
|
1026 (defvar br-sys-prev-search-dirs nil
|
|
100
|
1027 "Used to check if `br-sys-paths-htable' must be regenerated.
|
|
0
|
1028 Value is language-specific.")
|
|
|
1029
|
|
|
1030 (defun br-find-file (filename &optional other-win read-only)
|
|
|
1031 "Edit file FILENAME.
|
|
|
1032 Switch to a buffer visiting file FILENAME, creating one if none
|
|
|
1033 already exists. Optional OTHER-WIN means show in other window.
|
|
|
1034 Optional READ-ONLY means make buffer read-only."
|
|
|
1035 (interactive "FFind file: ")
|
|
100
|
1036 (if (br-in-browser)
|
|
|
1037 (progn (br-to-view-window)
|
|
|
1038 (setq other-win nil)))
|
|
0
|
1039 (funcall (if other-win 'switch-to-buffer-other-window 'switch-to-buffer)
|
|
|
1040 (find-file-noselect filename))
|
|
100
|
1041 (if read-only (setq buffer-read-only t)))
|
|
0
|
1042
|
|
|
1043 (defun br-find-file-read-only (filename &optional other-win)
|
|
|
1044 "Display file FILENAME read-only.
|
|
|
1045 Switch to a buffer visiting file FILENAME, creating one if none
|
|
|
1046 already exists. Optional OTHER-WIN means show in other window."
|
|
|
1047 (interactive "FFind file read-only: ")
|
|
|
1048 (br-find-file filename other-win t))
|
|
|
1049
|
|
|
1050 (defvar br-edit-file-function 'br-find-file
|
|
|
1051 "*Function to call to edit a class file within the browser.")
|
|
|
1052 (defvar br-view-file-function
|
|
|
1053 (if (eq br-edit-file-function 'br-find-file)
|
|
|
1054 'br-find-file-read-only
|
|
|
1055 br-edit-file-function)
|
|
|
1056 "*Function to call to view a class file within the browser.")
|
|
|
1057
|
|
|
1058 (defvar br-find-file-noselect-function 'find-file-noselect
|
|
|
1059 "Function to call to load a browser file but not select it.
|
|
|
1060 The function must return the buffer containing the file's contents.")
|
|
|
1061
|
|
|
1062 (defvar *br-tmp-buffer* "*oobr-tmp*"
|
|
|
1063 "Name of temporary buffer used by the OO-Browser for parsing source files.")
|
|
|
1064
|
|
|
1065 (defun br-insert-file-contents (filename)
|
|
|
1066 "Insert FILENAME contents into a temporary buffer and select buffer.
|
|
100
|
1067 Does not run any find-file or mode specific hooks. Marks buffer read-only to
|
|
|
1068 prevent any accidental editing.
|
|
0
|
1069
|
|
100
|
1070 Set `br-view-file-function' to this function when parsing OO-Browser source
|
|
0
|
1071 files for fast loading of many files."
|
|
|
1072 (let ((buf (get-buffer-create *br-tmp-buffer*)))
|
|
|
1073 (switch-to-buffer buf)
|
|
100
|
1074 ;; Don't bother saving anything for this temporary buffer
|
|
0
|
1075 (buffer-disable-undo buf)
|
|
100
|
1076 (setq buffer-auto-save-file-name nil
|
|
|
1077 buffer-read-only nil)
|
|
0
|
1078 (erase-buffer)
|
|
100
|
1079 (insert-file-contents filename t)
|
|
|
1080 (br-scan-mode)
|
|
|
1081 (setq buffer-read-only t)))
|
|
0
|
1082
|
|
|
1083 (defvar br-lang-prefix nil
|
|
|
1084 "Prefix string that starts language-specific symbol names.")
|
|
|
1085
|
|
|
1086 (defvar br-children-htable nil
|
|
|
1087 "Htable whose elements are of the form: (LIST-OF-CHILD-CLASSES . CLASS-NAME).
|
|
100
|
1088 Used to traverse class inheritance graph. `br-build-children-htable' builds
|
|
0
|
1089 this list. Value is language-specific.")
|
|
|
1090 (defvar br-parents-htable nil
|
|
|
1091 "Htable whose elements are of the form: (LIST-OF-PARENT-CLASSES . CLASS-NAME).
|
|
100
|
1092 Used to traverse class inheritance graph. `br-build-parents-htable' builds
|
|
0
|
1093 this list. Value is language-specific.")
|
|
|
1094 (defvar br-paths-htable nil
|
|
|
1095 "Htable whose elements are of the form: (LIST-OF-CLASS-NAMES . DIRECTORY).
|
|
|
1096 DIRECTORY gives the location of classes found in LIST-OF-CLASS-NAMES.
|
|
100
|
1097 `br-build-paths-htable' builds this list. Value is language-specific.")
|
|
0
|
1098
|
|
|
1099 (defvar br-lib-parents-htable nil
|
|
|
1100 "Htable whose elements are of the form: (LIST-OF-PARENT-CLASSES . CLASS-NAME).
|
|
|
1101 Only classes from stable software libraries are used to build the list.
|
|
|
1102 Value is language-specific.")
|
|
|
1103 (defvar br-lib-paths-htable nil
|
|
|
1104 "Htable whose elements are of the form: (LIST-OF-CLASS-NAMES . DIRECTORY).
|
|
|
1105 DIRECTORY gives the location of classes found in LIST-OF-CLASS-NAMES.
|
|
|
1106 Only classes from stable software libraries are used to build the list.
|
|
|
1107 Value is language-specific.")
|
|
|
1108
|
|
|
1109 (defvar br-sys-parents-htable nil
|
|
|
1110 "Htable whose elements are of the form: (LIST-OF-PARENT-CLASSES . CLASS-NAME).
|
|
|
1111 Only classes from systems that are likely to change are used to build the
|
|
|
1112 list. Value is language-specific.")
|
|
|
1113 (defvar br-sys-paths-htable nil
|
|
|
1114 "Htable whose elements are of the form: (LIST-OF-CLASS-NAMES . DIRECTORY).
|
|
|
1115 DIRECTORY gives the location of classes found in LIST-OF-CLASS-NAMES.
|
|
|
1116 Only classes from systems that are likely to change are used to build the
|
|
|
1117 list. Value is language-specific.")
|
|
|
1118
|
|
|
1119 (defvar br-file-dir-regexp "\\`[^.~#]\\(.*[^.~#]\\)?\\'"
|
|
|
1120 "Regexp that matches only to files and directories that the OO-Browser should scan.
|
|
|
1121 Others are ignored.")
|
|
|
1122
|
|
|
1123 (defvar br-src-file-regexp nil
|
|
|
1124 "Regular expression matching a unique part of source file names and no others.")
|
|
|
1125
|
|
|
1126 (defvar br-narrow-view-to-class nil
|
|
|
1127 "Non-nil means narrow buffer to just the matching class definition when displayed.
|
|
|
1128 Don't set this, use the language specific variable instead.")
|
|
|
1129
|
|
|
1130 (provide 'br-lib)
|
