|
0
|
1 ;;!emacs
|
|
|
2 ;;
|
|
|
3 ;; FILE: info-brows.el
|
|
|
4 ;; SUMMARY: Support routines for Info inheritance browsing and error parsing.
|
|
|
5 ;; USAGE: GNU Emacs Lisp Library
|
|
|
6 ;; KEYWORDS: docs, help, hypermedia
|
|
|
7 ;;
|
|
|
8 ;; AUTHOR: Bob Weiner
|
|
24
|
9 ;; ORG: InfoDock Associates
|
|
0
|
10 ;;
|
|
|
11 ;; ORIG-DATE: 7-Dec-89
|
|
24
|
12 ;; LAST-MOD: 20-Feb-97 at 07:05:47 by Bob Weiner
|
|
0
|
13 ;;
|
|
24
|
14 ;; Copyright (C) 1989-1995, 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 ;; DESCRIPTION:
|
|
|
20 ;;
|
|
24
|
21 ;; Use `info-browse' to invoke the Info OO-Browser. Prefix arg prompts for
|
|
0
|
22 ;; name of Environment file.
|
|
|
23 ;;
|
|
|
24 ;; DESCRIP-END.
|
|
|
25
|
|
|
26 ;;; ************************************************************************
|
|
|
27 ;;; Other required Elisp libraries
|
|
|
28 ;;; ************************************************************************
|
|
|
29
|
|
|
30 (mapcar 'require '(info br-start br br-info))
|
|
|
31
|
|
|
32 ;;; ************************************************************************
|
|
|
33 ;;; Public functions
|
|
|
34 ;;; ************************************************************************
|
|
|
35
|
|
|
36 ;;;###autoload
|
|
|
37 (defun info-browse (&optional env-file no-ui)
|
|
|
38 "Invoke the Info OO-Browser.
|
|
|
39 This allows browsing through Info library and system class hierarchies. With
|
|
|
40 an optional non-nil prefix argument ENV-FILE, prompt for Environment file to
|
|
|
41 use. Alternatively, a string value of ENV-FILE is used as the Environment
|
|
|
42 file name. See also the file \"br-help\"."
|
|
|
43 (interactive "P")
|
|
|
44 (let ((same-lang (equal br-lang-prefix info-lang-prefix))
|
|
|
45 (load-succeeded t)
|
|
|
46 same-env)
|
|
|
47 (if same-lang
|
|
|
48 nil
|
|
|
49 ;; Save other language Environment in memory
|
|
|
50 (if br-lang-prefix (br-env-copy nil))
|
|
|
51 (setq br-lang-prefix info-lang-prefix
|
|
|
52 *br-save-wconfig* nil))
|
|
|
53 (setq same-env (or (equal info-env-file env-file)
|
|
|
54 (and (null env-file)
|
|
|
55 (or info-lib-search-dirs info-sys-search-dirs))))
|
|
|
56 (cond
|
|
|
57 ;; Continue browsing an Environment
|
|
|
58 ((and same-env same-lang))
|
|
|
59 ((and same-env (not same-lang))
|
|
|
60 (info-browse-setup) (br-env-copy t))
|
|
|
61 ;;
|
|
|
62 ;; Create default Environment file specification if needed and none
|
|
|
63 ;; exists.
|
|
|
64 ;;
|
|
|
65 (t (or env-file (file-exists-p info-env-file)
|
|
|
66 (br-env-create info-env-file info-lang-prefix))
|
|
|
67 (or env-file (setq env-file info-env-file))
|
|
|
68 ;;
|
|
|
69 ;; Start browsing a new Environment.
|
|
|
70 ;;
|
|
|
71 (info-browse-setup)
|
|
|
72 (setq load-succeeded (br-env-init env-file same-lang nil))
|
|
|
73 (if load-succeeded
|
|
|
74 (setq *br-save-wconfig* nil
|
|
|
75 info-env-file load-succeeded
|
|
|
76 info-sys-search-dirs br-sys-search-dirs
|
|
|
77 info-lib-search-dirs br-lib-search-dirs))))
|
|
|
78 (cond (load-succeeded
|
|
|
79 (br-init)
|
|
|
80 (or no-ui (br-browse)))
|
|
|
81 (no-ui nil)
|
|
|
82 (t (message "(info-browse): You must build the Environment to browse it.")))))
|
|
|
83
|
|
|
84 ;; Don't filter Environment classes when listed.
|
|
|
85 (fset 'info-class-list-filter 'identity)
|
|
|
86
|
|
|
87 (defun info-class-definition-regexp (class)
|
|
|
88 "Return regexp to uniquely match the definition of CLASS name."
|
|
|
89 (concat info-class-name-before (regexp-quote class)
|
|
|
90 info-class-name-after))
|
|
|
91
|
|
|
92 ;;; ************************************************************************
|
|
|
93 ;;; Internal functions
|
|
|
94 ;;; ************************************************************************
|
|
|
95
|
|
|
96 (defun info-find-nd-name ()
|
|
|
97 (let ((end))
|
|
|
98 (save-excursion
|
|
|
99 (skip-chars-forward info-identifier-chars)
|
|
|
100 (setq end (point))
|
|
|
101 (skip-chars-backward info-identifier-chars)
|
|
|
102 (skip-chars-forward " \n")
|
|
|
103 (buffer-substring (point) end))))
|
|
|
104
|
|
|
105 (defun info-browse-setup ()
|
|
|
106 "Setup language-dependent functions for OO-Browser."
|
|
|
107 (br-setup-functions)
|
|
|
108 ;; Use this until an info function is implemented for the language.
|
|
|
109 (fmakunbound 'br-insert-class-info)
|
|
|
110 (fset 'br-store-class-info 'info-store-class-info)
|
|
|
111 (fset 'br-lang-mode 'Info-mode)
|
|
|
112 (fset 'br-find-class-name 'info-find-nd-name)
|
|
|
113 (br-setup-constants))
|
|
|
114
|
|
|
115 (provide 'info-browse)
|
