Mercurial > hg > xemacs-beta

comparison lisp/oobr/info-brows.el @ 0:376386a54a3c r19-14

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r19-14
author cvs
date Mon, 13 Aug 2007 08:45:50 +0200
parents
children 4103f0995bd7
comparison
equal deleted inserted replaced
-1:000000000000 0:376386a54a3c
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
9 ;; ORG: Motorola Inc.
10 ;;
11 ;; ORIG-DATE: 7-Dec-89
12 ;; LAST-MOD: 20-Sep-95 at 14:33:33 by Bob Weiner
13 ;;
14 ;; Copyright (C) 1989-1995 Free Software Foundation, Inc.
15 ;; See the file BR-COPY for license information.
16 ;;
17 ;; This file is part of the OO-Browser.
18 ;;
19 ;; DESCRIPTION:
20 ;;
21 ;; Use 'info-browse' to invoke the Info OO-Browser. Prefix arg prompts for
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)