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)