Mercurial > hg > xemacs-beta
diff lisp/oobr/info-brows.el @ 0:376386a54a3c r19-14
Import from CVS: tag r19-14
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:45:50 +0200 |
parents | |
children | 4103f0995bd7 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/lisp/oobr/info-brows.el Mon Aug 13 08:45:50 2007 +0200 @@ -0,0 +1,115 @@ +;;!emacs +;; +;; FILE: info-brows.el +;; SUMMARY: Support routines for Info inheritance browsing and error parsing. +;; USAGE: GNU Emacs Lisp Library +;; KEYWORDS: docs, help, hypermedia +;; +;; AUTHOR: Bob Weiner +;; ORG: Motorola Inc. +;; +;; ORIG-DATE: 7-Dec-89 +;; LAST-MOD: 20-Sep-95 at 14:33:33 by Bob Weiner +;; +;; Copyright (C) 1989-1995 Free Software Foundation, Inc. +;; See the file BR-COPY for license information. +;; +;; This file is part of the OO-Browser. +;; +;; DESCRIPTION: +;; +;; Use 'info-browse' to invoke the Info OO-Browser. Prefix arg prompts for +;; name of Environment file. +;; +;; DESCRIP-END. + +;;; ************************************************************************ +;;; Other required Elisp libraries +;;; ************************************************************************ + +(mapcar 'require '(info br-start br br-info)) + +;;; ************************************************************************ +;;; Public functions +;;; ************************************************************************ + +;;;###autoload +(defun info-browse (&optional env-file no-ui) + "Invoke the Info OO-Browser. +This allows browsing through Info library and system class hierarchies. With +an optional non-nil prefix argument ENV-FILE, prompt for Environment file to +use. Alternatively, a string value of ENV-FILE is used as the Environment +file name. See also the file \"br-help\"." + (interactive "P") + (let ((same-lang (equal br-lang-prefix info-lang-prefix)) + (load-succeeded t) + same-env) + (if same-lang + nil + ;; Save other language Environment in memory + (if br-lang-prefix (br-env-copy nil)) + (setq br-lang-prefix info-lang-prefix + *br-save-wconfig* nil)) + (setq same-env (or (equal info-env-file env-file) + (and (null env-file) + (or info-lib-search-dirs info-sys-search-dirs)))) + (cond + ;; Continue browsing an Environment + ((and same-env same-lang)) + ((and same-env (not same-lang)) + (info-browse-setup) (br-env-copy t)) + ;; + ;; Create default Environment file specification if needed and none + ;; exists. + ;; + (t (or env-file (file-exists-p info-env-file) + (br-env-create info-env-file info-lang-prefix)) + (or env-file (setq env-file info-env-file)) + ;; + ;; Start browsing a new Environment. + ;; + (info-browse-setup) + (setq load-succeeded (br-env-init env-file same-lang nil)) + (if load-succeeded + (setq *br-save-wconfig* nil + info-env-file load-succeeded + info-sys-search-dirs br-sys-search-dirs + info-lib-search-dirs br-lib-search-dirs)))) + (cond (load-succeeded + (br-init) + (or no-ui (br-browse))) + (no-ui nil) + (t (message "(info-browse): You must build the Environment to browse it."))))) + +;; Don't filter Environment classes when listed. +(fset 'info-class-list-filter 'identity) + +(defun info-class-definition-regexp (class) + "Return regexp to uniquely match the definition of CLASS name." + (concat info-class-name-before (regexp-quote class) + info-class-name-after)) + +;;; ************************************************************************ +;;; Internal functions +;;; ************************************************************************ + +(defun info-find-nd-name () + (let ((end)) + (save-excursion + (skip-chars-forward info-identifier-chars) + (setq end (point)) + (skip-chars-backward info-identifier-chars) + (skip-chars-forward " \n") + (buffer-substring (point) end)))) + +(defun info-browse-setup () + "Setup language-dependent functions for OO-Browser." + (br-setup-functions) + ;; Use this until an info function is implemented for the language. + (fmakunbound 'br-insert-class-info) + (fset 'br-store-class-info 'info-store-class-info) + (fset 'br-lang-mode 'Info-mode) + (fset 'br-find-class-name 'info-find-nd-name) + (br-setup-constants)) + +(provide 'info-browse)