1992-07-08 23:04:51 +00:00
|
|
|
|
;;; info.el --- info package for Emacs.
|
1992-07-16 21:47:34 +00:00
|
|
|
|
|
1997-03-12 18:40:06 +00:00
|
|
|
|
;; Copyright (C) 1985, 86, 92, 93, 94, 97 Free Software Foundation, Inc.
|
1992-07-22 04:22:42 +00:00
|
|
|
|
|
1992-07-16 21:47:34 +00:00
|
|
|
|
;; Maintainer: FSF
|
1992-07-17 08:15:29 +00:00
|
|
|
|
;; Keywords: help
|
1992-07-16 21:47:34 +00:00
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
|
|
|
|
|
|
;; GNU Emacs is free software; you can redistribute it and/or modify
|
|
|
|
|
;; it under the terms of the GNU General Public License as published by
|
1992-07-16 21:47:34 +00:00
|
|
|
|
;; the Free Software Foundation; either version 2, or (at your option)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
;; any later version.
|
|
|
|
|
|
|
|
|
|
;; GNU Emacs is distributed in the hope that it will be useful,
|
|
|
|
|
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
;; GNU General Public License for more details.
|
|
|
|
|
|
|
|
|
|
;; You should have received a copy of the GNU General Public License
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; along with GNU Emacs; see the file COPYING. If not, write to the
|
|
|
|
|
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
|
;; Boston, MA 02111-1307, USA.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1992-07-16 21:47:34 +00:00
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; Note that nowadays we expect info files to be made using makeinfo.
|
1992-07-16 21:47:34 +00:00
|
|
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defvar Info-history nil
|
|
|
|
|
"List of info nodes user has visited.
|
|
|
|
|
Each element of list is a list (FILENAME NODENAME BUFFERPOS).")
|
|
|
|
|
|
|
|
|
|
(defvar Info-enable-edit nil
|
1993-05-25 17:17:50 +00:00
|
|
|
|
"*Non-nil means the \\<Info-mode-map>\\[Info-edit] command in Info can edit the current node.
|
1992-06-03 20:43:49 +00:00
|
|
|
|
This is convenient if you want to write info files by hand.
|
|
|
|
|
However, we recommend that you not do this.
|
|
|
|
|
It is better to write a Texinfo file and generate the Info file from that,
|
|
|
|
|
because that gives you a printed manual as well.")
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1996-05-07 00:51:23 +00:00
|
|
|
|
(defvar Info-enable-active-nodes nil
|
1991-07-13 07:49:50 +00:00
|
|
|
|
"Non-nil allows Info to execute Lisp code associated with nodes.
|
|
|
|
|
The Lisp code is executed when the node is selected.")
|
1996-05-07 00:51:23 +00:00
|
|
|
|
(put 'Info-enable-active-nodes 'risky-local-variable t)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(defvar Info-fontify t
|
|
|
|
|
"*Non-nil enables highlighting and fonts in Info nodes.")
|
|
|
|
|
|
1994-07-11 00:55:56 +00:00
|
|
|
|
(defvar Info-fontify-maximum-menu-size 30000
|
|
|
|
|
"*Maximum size of menu to fontify if `Info-fontify' is non-nil.")
|
1994-08-07 23:35:47 +00:00
|
|
|
|
|
1993-05-30 23:32:41 +00:00
|
|
|
|
(defvar Info-directory-list
|
1994-01-07 11:58:27 +00:00
|
|
|
|
(let ((path (getenv "INFOPATH"))
|
1995-06-17 19:12:53 +00:00
|
|
|
|
;; This is for older Emacs versions
|
|
|
|
|
;; which might get this info.el from the Texinfo distribution.
|
|
|
|
|
(path-separator (if (boundp 'path-separator) path-separator
|
|
|
|
|
(if (eq system-type 'ms-dos) ";" ":")))
|
1995-11-21 21:11:16 +00:00
|
|
|
|
(source (expand-file-name "info/" source-directory))
|
1995-05-09 05:36:55 +00:00
|
|
|
|
(sibling (if installation-directory
|
1995-11-21 21:11:16 +00:00
|
|
|
|
(expand-file-name "info/" installation-directory)))
|
|
|
|
|
alternative)
|
1993-05-30 23:32:41 +00:00
|
|
|
|
(if path
|
|
|
|
|
(let ((list nil)
|
|
|
|
|
idx)
|
|
|
|
|
(while (> (length path) 0)
|
1995-05-27 00:36:25 +00:00
|
|
|
|
(setq idx (or (string-match path-separator path) (length path))
|
1993-05-30 23:32:41 +00:00
|
|
|
|
list (cons (substring path 0 idx) list)
|
|
|
|
|
path (substring path (min (1+ idx)
|
|
|
|
|
(length path)))))
|
|
|
|
|
(nreverse list))
|
1995-11-21 21:11:16 +00:00
|
|
|
|
(if (and sibling (file-exists-p sibling))
|
|
|
|
|
(setq alternative sibling)
|
|
|
|
|
(setq alternative source))
|
|
|
|
|
(if (or (member alternative Info-default-directory-list)
|
|
|
|
|
(not (file-exists-p alternative))
|
1994-11-01 05:54:58 +00:00
|
|
|
|
;; On DOS/NT, we use movable executables always,
|
1994-06-21 15:39:44 +00:00
|
|
|
|
;; and we must always find the Info dir at run time.
|
1994-11-01 05:54:58 +00:00
|
|
|
|
(if (or (eq system-type 'ms-dos) (eq system-type 'windows-nt))
|
1994-06-21 15:39:44 +00:00
|
|
|
|
nil
|
|
|
|
|
;; Use invocation-directory for Info only if we used it for
|
|
|
|
|
;; exec-directory also.
|
|
|
|
|
(not (string= exec-directory
|
1995-05-09 05:36:55 +00:00
|
|
|
|
(expand-file-name "lib-src/"
|
|
|
|
|
installation-directory)))))
|
1994-01-07 11:58:27 +00:00
|
|
|
|
Info-default-directory-list
|
1995-11-21 21:11:16 +00:00
|
|
|
|
(reverse (cons alternative
|
|
|
|
|
(cdr (reverse Info-default-directory-list)))))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
"List of directories to search for Info documentation files.
|
1992-02-07 21:40:34 +00:00
|
|
|
|
nil means not yet initialized. In this case, Info uses the environment
|
1993-03-02 07:27:17 +00:00
|
|
|
|
variable INFOPATH to initialize it, or `Info-default-directory-list'
|
1994-05-28 20:06:08 +00:00
|
|
|
|
if there is no INFOPATH variable in the environment.
|
|
|
|
|
The last element of `Info-default-directory-list' is the directory
|
1994-05-30 11:47:07 +00:00
|
|
|
|
where Emacs installs the Info files that come with it.
|
1994-08-06 02:58:22 +00:00
|
|
|
|
|
|
|
|
|
If you run the Emacs executable from the `src' directory in the Emacs
|
|
|
|
|
source tree, the `info' directory in the source tree is used as the last
|
|
|
|
|
element, in place of the installation Info directory. This is useful
|
|
|
|
|
when you run a version of Emacs without installing it.")
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1994-08-07 23:35:47 +00:00
|
|
|
|
(defvar Info-additional-directory-list nil
|
|
|
|
|
"List of additional directories to search for Info documentation files.
|
|
|
|
|
These directories are not searched for merging the `dir' file.")
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defvar Info-current-file nil
|
1995-07-24 01:26:23 +00:00
|
|
|
|
"Info file that Info is now looking at, or nil.
|
|
|
|
|
This is the name that was specified in Info, not the actual file name.
|
|
|
|
|
It doesn't contain directory names or file name extensions added by Info.")
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defvar Info-current-subfile nil
|
|
|
|
|
"Info subfile that is actually in the *info* buffer now,
|
|
|
|
|
or nil if current info file is not split into subfiles.")
|
|
|
|
|
|
|
|
|
|
(defvar Info-current-node nil
|
|
|
|
|
"Name of node that Info is now looking at, or nil.")
|
|
|
|
|
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(defvar Info-tag-table-marker nil
|
1991-07-13 07:49:50 +00:00
|
|
|
|
"Marker pointing at beginning of current Info file's tag table.
|
|
|
|
|
Marker points nowhere if file has no tag table.")
|
|
|
|
|
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(defvar Info-tag-table-buffer nil
|
|
|
|
|
"Buffer used for indirect tag tables.")
|
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(defvar Info-current-file-completions nil
|
|
|
|
|
"Cached completion list for current Info file.")
|
|
|
|
|
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(defvar Info-index-alternatives nil
|
|
|
|
|
"List of possible matches for last Info-index command.")
|
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(defvar Info-standalone nil
|
|
|
|
|
"Non-nil if Emacs was started solely as an Info browser.")
|
|
|
|
|
|
1995-08-22 18:51:46 +00:00
|
|
|
|
(defvar Info-suffix-list
|
|
|
|
|
(if (eq system-type 'ms-dos)
|
|
|
|
|
'( (".gz" . "gunzip")
|
|
|
|
|
(".z" . "gunzip")
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(".inf" . nil)
|
1995-08-22 18:51:46 +00:00
|
|
|
|
("" . nil))
|
|
|
|
|
'( (".info.Z" . "uncompress")
|
|
|
|
|
(".info.Y" . "unyabba")
|
|
|
|
|
(".info.gz" . "gunzip")
|
|
|
|
|
(".info.z" . "gunzip")
|
|
|
|
|
(".info" . nil)
|
|
|
|
|
(".Z" . "uncompress")
|
|
|
|
|
(".Y" . "unyabba")
|
|
|
|
|
(".gz" . "gunzip")
|
|
|
|
|
(".z" . "gunzip")
|
|
|
|
|
("" . nil)))
|
1993-04-23 02:20:55 +00:00
|
|
|
|
"List of file name suffixes and associated decoding commands.
|
|
|
|
|
Each entry should be (SUFFIX . STRING); the file is given to
|
1994-03-29 01:39:51 +00:00
|
|
|
|
the command as standard input. If STRING is nil, no decoding is done.
|
|
|
|
|
Because the SUFFIXes are tried in order, the empty string should
|
|
|
|
|
be last in the list.")
|
1993-04-23 02:20:55 +00:00
|
|
|
|
|
1995-11-15 23:17:18 +00:00
|
|
|
|
;; Concatenate SUFFIX onto FILENAME. SUFFIX should start with a dot.
|
1995-08-22 18:51:46 +00:00
|
|
|
|
;; First, on ms-dos, delete some of the extension in FILENAME
|
|
|
|
|
;; to make room.
|
|
|
|
|
(defun info-insert-file-contents-1 (filename suffix)
|
|
|
|
|
(if (not (eq system-type 'ms-dos))
|
|
|
|
|
(concat filename suffix)
|
|
|
|
|
(let* ((sans-exts (file-name-sans-extension filename))
|
1995-11-15 23:17:18 +00:00
|
|
|
|
;; How long is the extension in FILENAME (not counting the dot).
|
|
|
|
|
(ext-len (max 0 (- (length filename) (length sans-exts) 1)))
|
|
|
|
|
ext-left)
|
1995-09-06 18:04:02 +00:00
|
|
|
|
;; SUFFIX starts with a dot. If FILENAME already has one,
|
1996-02-16 00:58:07 +00:00
|
|
|
|
;; get rid of the one in SUFFIX (unless suffix is empty).
|
1995-11-15 23:17:18 +00:00
|
|
|
|
(or (and (<= ext-len 0)
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(not (eq (aref filename (1- (length filename))) ?.)))
|
1996-02-16 00:58:07 +00:00
|
|
|
|
(= (length suffix) 0)
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(setq suffix (substring suffix 1)))
|
1995-11-15 23:17:18 +00:00
|
|
|
|
;; How many chars of that extension should we keep?
|
|
|
|
|
(setq ext-left (min ext-len (max 0 (- 3 (length suffix)))))
|
1995-08-22 18:51:46 +00:00
|
|
|
|
;; Get rid of the rest of the extension, and add SUFFIX.
|
|
|
|
|
(concat (substring filename 0 (- (length filename)
|
|
|
|
|
(- ext-len ext-left)))
|
|
|
|
|
suffix))))
|
|
|
|
|
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(defun info-insert-file-contents (filename &optional visit)
|
|
|
|
|
"Insert the contents of an info file in the current buffer.
|
|
|
|
|
Do the right thing if the file has been compressed or zipped."
|
1994-03-29 01:39:51 +00:00
|
|
|
|
(let ((tail Info-suffix-list)
|
|
|
|
|
fullname decoder)
|
|
|
|
|
(if (file-exists-p filename)
|
1995-08-22 18:51:46 +00:00
|
|
|
|
;; FILENAME exists--see if that name contains a suffix.
|
|
|
|
|
;; If so, set DECODE accordingly.
|
1994-03-29 01:39:51 +00:00
|
|
|
|
(progn
|
|
|
|
|
(while (and tail
|
|
|
|
|
(not (string-match
|
|
|
|
|
(concat (regexp-quote (car (car tail))) "$")
|
|
|
|
|
filename)))
|
|
|
|
|
(setq tail (cdr tail)))
|
|
|
|
|
(setq fullname filename
|
|
|
|
|
decoder (cdr (car tail))))
|
1995-08-22 18:51:46 +00:00
|
|
|
|
;; Try adding suffixes to FILENAME and see if we can find something.
|
1994-03-29 01:39:51 +00:00
|
|
|
|
(while (and tail
|
1995-08-22 18:51:46 +00:00
|
|
|
|
(not (file-exists-p (info-insert-file-contents-1
|
|
|
|
|
filename (car (car tail))))))
|
1994-03-29 01:39:51 +00:00
|
|
|
|
(setq tail (cdr tail)))
|
1995-08-22 18:51:46 +00:00
|
|
|
|
;; If we found a file with a suffix, set DECODER according to the suffix
|
|
|
|
|
;; and set FULLNAME to the file's actual name.
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(setq fullname (info-insert-file-contents-1 filename (car (car tail)))
|
1994-03-29 01:39:51 +00:00
|
|
|
|
decoder (cdr (car tail)))
|
|
|
|
|
(or tail
|
1995-08-22 18:51:46 +00:00
|
|
|
|
(error "Can't find %s or any compressed version of it" filename)))
|
1994-10-18 05:25:40 +00:00
|
|
|
|
;; check for conflict with jka-compr
|
|
|
|
|
(if (and (featurep 'jka-compr)
|
|
|
|
|
(jka-compr-installed-p)
|
|
|
|
|
(jka-compr-get-compression-info fullname))
|
|
|
|
|
(setq decoder nil))
|
1994-03-29 01:39:51 +00:00
|
|
|
|
(insert-file-contents fullname visit)
|
|
|
|
|
(if decoder
|
1995-04-24 15:31:19 +00:00
|
|
|
|
(let ((buffer-read-only nil)
|
1995-05-08 23:23:37 +00:00
|
|
|
|
(default-directory (or (file-name-directory fullname)
|
|
|
|
|
default-directory)))
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(call-process-region (point-min) (point-max) decoder t t)))))
|
1993-04-23 02:20:55 +00:00
|
|
|
|
|
1995-03-12 18:22:14 +00:00
|
|
|
|
;;;###autoload (add-hook 'same-window-buffer-names "*info*")
|
1995-03-11 04:37:47 +00:00
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun info (&optional file)
|
|
|
|
|
"Enter Info, the documentation browser.
|
|
|
|
|
Optional argument FILE specifies the file to examine;
|
|
|
|
|
the default is the top-level directory of Info.
|
|
|
|
|
|
|
|
|
|
In interactive use, a prefix argument directs this command
|
1996-02-09 19:12:10 +00:00
|
|
|
|
to read a file name from the minibuffer.
|
|
|
|
|
|
|
|
|
|
The search path for Info files is in the variable `Info-directory-list'.
|
|
|
|
|
The top-level Info directory is made by combining all the files named `dir'
|
|
|
|
|
in all the directories in that path."
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(interactive (if current-prefix-arg
|
|
|
|
|
(list (read-file-name "Info file name: " nil nil t))))
|
|
|
|
|
(if file
|
|
|
|
|
(Info-goto-node (concat "(" file ")"))
|
|
|
|
|
(if (get-buffer "*info*")
|
1995-03-11 04:37:47 +00:00
|
|
|
|
(pop-to-buffer "*info*")
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-directory))))
|
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun info-standalone ()
|
|
|
|
|
"Run Emacs as a standalone Info reader.
|
|
|
|
|
Usage: emacs -f info-standalone [filename]
|
|
|
|
|
In standalone mode, \\<Info-mode-map>\\[Info-exit] exits Emacs itself."
|
|
|
|
|
(setq Info-standalone t)
|
|
|
|
|
(if (and command-line-args-left
|
|
|
|
|
(not (string-match "^-" (car command-line-args-left))))
|
|
|
|
|
(condition-case err
|
|
|
|
|
(progn
|
|
|
|
|
(info (car command-line-args-left))
|
|
|
|
|
(setq command-line-args-left (cdr command-line-args-left)))
|
|
|
|
|
(error (send-string-to-terminal
|
|
|
|
|
(format "%s\n" (if (eq (car-safe err) 'error)
|
|
|
|
|
(nth 1 err) err)))
|
|
|
|
|
(save-buffers-kill-emacs)))
|
|
|
|
|
(info)))
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
;; Go to an info node specified as separate filename and nodename.
|
|
|
|
|
;; no-going-back is non-nil if recovering from an error in this function;
|
|
|
|
|
;; it says do not attempt further (recursive) error recovery.
|
|
|
|
|
(defun Info-find-node (filename nodename &optional no-going-back)
|
|
|
|
|
;; Convert filename to lower case if not found as specified.
|
|
|
|
|
;; Expand it.
|
|
|
|
|
(if filename
|
|
|
|
|
(let (temp temp-downcase found)
|
|
|
|
|
(setq filename (substitute-in-file-name filename))
|
1996-05-02 06:08:40 +00:00
|
|
|
|
(if (string= (downcase filename) "dir")
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(setq found t)
|
|
|
|
|
(let ((dirs (if (string-match "^\\./" filename)
|
|
|
|
|
;; If specified name starts with `./'
|
|
|
|
|
;; then just try current directory.
|
|
|
|
|
'("./")
|
1994-10-18 05:25:40 +00:00
|
|
|
|
(if (file-name-absolute-p filename)
|
|
|
|
|
;; No point in searching for an
|
|
|
|
|
;; absolute file name
|
|
|
|
|
'(nil)
|
|
|
|
|
(if Info-additional-directory-list
|
|
|
|
|
(append Info-directory-list
|
|
|
|
|
Info-additional-directory-list)
|
|
|
|
|
Info-directory-list)))))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
;; Search the directory list for file FILENAME.
|
|
|
|
|
(while (and dirs (not found))
|
|
|
|
|
(setq temp (expand-file-name filename (car dirs)))
|
|
|
|
|
(setq temp-downcase
|
|
|
|
|
(expand-file-name (downcase filename) (car dirs)))
|
|
|
|
|
;; Try several variants of specified name.
|
1994-07-28 12:53:30 +00:00
|
|
|
|
(let ((suffix-list Info-suffix-list))
|
|
|
|
|
(while (and suffix-list (not found))
|
|
|
|
|
(cond ((file-exists-p
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(info-insert-file-contents-1
|
|
|
|
|
temp (car (car suffix-list))))
|
1994-07-28 12:53:30 +00:00
|
|
|
|
(setq found temp))
|
|
|
|
|
((file-exists-p
|
1995-09-06 18:04:02 +00:00
|
|
|
|
(info-insert-file-contents-1
|
|
|
|
|
temp-downcase (car (car suffix-list))))
|
1994-07-28 12:53:30 +00:00
|
|
|
|
(setq found temp-downcase)))
|
|
|
|
|
(setq suffix-list (cdr suffix-list))))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(setq dirs (cdr dirs)))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(if found
|
|
|
|
|
(setq filename found)
|
|
|
|
|
(error "Info file %s does not exist" filename))))
|
|
|
|
|
;; Record the node we are leaving.
|
|
|
|
|
(if (and Info-current-file (not no-going-back))
|
|
|
|
|
(setq Info-history
|
|
|
|
|
(cons (list Info-current-file Info-current-node (point))
|
|
|
|
|
Info-history)))
|
|
|
|
|
;; Go into info buffer.
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(or (eq major-mode 'Info-mode) (pop-to-buffer "*info*"))
|
1992-10-27 10:14:08 +00:00
|
|
|
|
(buffer-disable-undo (current-buffer))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(or (eq major-mode 'Info-mode)
|
|
|
|
|
(Info-mode))
|
|
|
|
|
(widen)
|
|
|
|
|
(setq Info-current-node nil)
|
|
|
|
|
(unwind-protect
|
|
|
|
|
(progn
|
|
|
|
|
;; Switch files if necessary
|
|
|
|
|
(or (null filename)
|
|
|
|
|
(equal Info-current-file filename)
|
|
|
|
|
(let ((buffer-read-only nil))
|
|
|
|
|
(setq Info-current-file nil
|
|
|
|
|
Info-current-subfile nil
|
1993-08-02 04:22:12 +00:00
|
|
|
|
Info-current-file-completions nil
|
1991-07-13 07:49:50 +00:00
|
|
|
|
buffer-file-name nil)
|
|
|
|
|
(erase-buffer)
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(if (eq filename t)
|
|
|
|
|
(Info-insert-dir)
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(info-insert-file-contents filename t)
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(setq default-directory (file-name-directory filename)))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(set-buffer-modified-p nil)
|
|
|
|
|
;; See whether file has a tag table. Record the location if yes.
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(forward-line -8)
|
1995-04-24 15:31:19 +00:00
|
|
|
|
;; Use string-equal, not equal, to ignore text props.
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(if (not (or (string-equal nodename "*")
|
|
|
|
|
(not
|
|
|
|
|
(search-forward "\^_\nEnd tag table\n" nil t))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let (pos)
|
|
|
|
|
;; We have a tag table. Find its beginning.
|
|
|
|
|
;; Is this an indirect file?
|
|
|
|
|
(search-backward "\nTag table:\n")
|
|
|
|
|
(setq pos (point))
|
|
|
|
|
(if (save-excursion
|
|
|
|
|
(forward-line 2)
|
|
|
|
|
(looking-at "(Indirect)\n"))
|
|
|
|
|
;; It is indirect. Copy it to another buffer
|
|
|
|
|
;; and record that the tag table is in that buffer.
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(let ((buf (current-buffer))
|
|
|
|
|
(tagbuf
|
|
|
|
|
(or Info-tag-table-buffer
|
|
|
|
|
(generate-new-buffer " *info tag table*"))))
|
|
|
|
|
(setq Info-tag-table-buffer tagbuf)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer tagbuf)
|
1992-10-27 10:14:08 +00:00
|
|
|
|
(buffer-disable-undo (current-buffer))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(setq case-fold-search t)
|
|
|
|
|
(erase-buffer)
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(insert-buffer-substring buf))
|
|
|
|
|
(set-marker Info-tag-table-marker
|
|
|
|
|
(match-end 0) tagbuf))
|
|
|
|
|
(set-marker Info-tag-table-marker pos)))
|
|
|
|
|
(set-marker Info-tag-table-marker nil))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(setq Info-current-file
|
1995-07-24 01:26:23 +00:00
|
|
|
|
(if (eq filename t) "dir" filename))))
|
1995-04-24 15:31:19 +00:00
|
|
|
|
;; Use string-equal, not equal, to ignore text props.
|
|
|
|
|
(if (string-equal nodename "*")
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(progn (setq Info-current-node nodename)
|
|
|
|
|
(Info-set-mode-line))
|
|
|
|
|
;; Search file for a suitable node.
|
1992-08-14 07:50:26 +00:00
|
|
|
|
(let ((guesspos (point-min))
|
|
|
|
|
(regexp (concat "Node: *" (regexp-quote nodename) " *[,\t\n\177]")))
|
|
|
|
|
;; First get advice from tag table if file has one.
|
|
|
|
|
;; Also, if this is an indirect info file,
|
|
|
|
|
;; read the proper subfile into this buffer.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(if (marker-position Info-tag-table-marker)
|
|
|
|
|
(save-excursion
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(let ((m Info-tag-table-marker)
|
|
|
|
|
found found-mode)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer (marker-buffer m))
|
|
|
|
|
(goto-char m)
|
|
|
|
|
(beginning-of-line) ;so re-search will work.
|
|
|
|
|
(setq found (re-search-forward regexp nil t))
|
|
|
|
|
(if found
|
|
|
|
|
(setq guesspos (read (current-buffer))))
|
|
|
|
|
(setq found-mode major-mode))
|
|
|
|
|
(if found
|
|
|
|
|
(progn
|
|
|
|
|
;; If this is an indirect file, determine
|
|
|
|
|
;; which file really holds this node and
|
|
|
|
|
;; read it in.
|
|
|
|
|
(if (not (eq found-mode 'Info-mode))
|
|
|
|
|
;; Note that the current buffer must be
|
|
|
|
|
;; the *info* buffer on entry to
|
|
|
|
|
;; Info-read-subfile. Thus the hackery
|
|
|
|
|
;; above.
|
|
|
|
|
(setq guesspos (Info-read-subfile guesspos))))
|
|
|
|
|
(error "No such node: %s" nodename)))))
|
1992-08-14 07:50:26 +00:00
|
|
|
|
(goto-char (max (point-min) (- guesspos 1000)))
|
|
|
|
|
;; Now search from our advised position (or from beg of buffer)
|
|
|
|
|
;; to find the actual node.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(catch 'foo
|
|
|
|
|
(while (search-forward "\n\^_" nil t)
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(let ((beg (point)))
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(if (re-search-backward regexp beg t)
|
|
|
|
|
(throw 'foo t))))
|
|
|
|
|
(error "No such node: %s" nodename)))
|
|
|
|
|
(Info-select-node)))
|
|
|
|
|
;; If we did not finish finding the specified node,
|
|
|
|
|
;; go back to the previous one.
|
1994-04-07 03:11:50 +00:00
|
|
|
|
(or Info-current-node no-going-back (null Info-history)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let ((hist (car Info-history)))
|
|
|
|
|
(setq Info-history (cdr Info-history))
|
|
|
|
|
(Info-find-node (nth 0 hist) (nth 1 hist) t)
|
|
|
|
|
(goto-char (nth 2 hist)))))
|
|
|
|
|
(goto-char (point-min)))
|
|
|
|
|
|
1993-03-02 07:27:17 +00:00
|
|
|
|
;; Cache the contents of the (virtual) dir file, once we have merged
|
|
|
|
|
;; it for the first time, so we can save time subsequently.
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(defvar Info-dir-contents nil)
|
|
|
|
|
|
1993-03-02 07:27:17 +00:00
|
|
|
|
;; Cache for the directory we decided to use for the default-directory
|
|
|
|
|
;; of the merged dir text.
|
|
|
|
|
(defvar Info-dir-contents-directory nil)
|
|
|
|
|
|
1993-06-19 20:18:05 +00:00
|
|
|
|
;; Record the file attributes of all the files from which we
|
|
|
|
|
;; constructed Info-dir-contents.
|
|
|
|
|
(defvar Info-dir-file-attributes nil)
|
|
|
|
|
|
1993-03-01 09:25:44 +00:00
|
|
|
|
;; Construct the Info directory node by merging the files named `dir'
|
1993-03-02 07:27:17 +00:00
|
|
|
|
;; from various directories. Set the *info* buffer's
|
|
|
|
|
;; default-directory to the first directory we actually get any text
|
|
|
|
|
;; from.
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(defun Info-insert-dir ()
|
1993-06-19 20:18:05 +00:00
|
|
|
|
(if (and Info-dir-contents Info-dir-file-attributes
|
|
|
|
|
;; Verify that none of the files we used has changed
|
|
|
|
|
;; since we used it.
|
|
|
|
|
(eval (cons 'and
|
|
|
|
|
(mapcar '(lambda (elt)
|
1994-06-15 18:13:52 +00:00
|
|
|
|
(let ((curr (file-attributes (car elt))))
|
|
|
|
|
;; Don't compare the access time.
|
|
|
|
|
(if curr (setcar (nthcdr 4 curr) 0))
|
|
|
|
|
(setcar (nthcdr 4 (cdr elt)) 0)
|
|
|
|
|
(equal (cdr elt) curr)))
|
1993-06-19 20:18:05 +00:00
|
|
|
|
Info-dir-file-attributes))))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(insert Info-dir-contents)
|
|
|
|
|
(let ((dirs Info-directory-list)
|
1993-05-28 18:35:23 +00:00
|
|
|
|
buffers buffer others nodes dirs-done)
|
1993-03-02 07:27:17 +00:00
|
|
|
|
|
1994-06-15 18:13:52 +00:00
|
|
|
|
(setq Info-dir-file-attributes nil)
|
|
|
|
|
|
1993-03-02 07:27:17 +00:00
|
|
|
|
;; Search the directory list for the directory file.
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(while dirs
|
1993-12-23 03:20:32 +00:00
|
|
|
|
(let ((truename (file-truename (expand-file-name (car dirs)))))
|
|
|
|
|
(or (member truename dirs-done)
|
|
|
|
|
(member (directory-file-name truename) dirs-done)
|
|
|
|
|
;; Try several variants of specified name.
|
|
|
|
|
;; Try upcasing, appending `.info', or both.
|
1994-06-15 18:13:52 +00:00
|
|
|
|
(let* (file
|
|
|
|
|
(attrs
|
|
|
|
|
(or
|
|
|
|
|
(progn (setq file (expand-file-name "dir" truename))
|
|
|
|
|
(file-attributes file))
|
|
|
|
|
(progn (setq file (expand-file-name "DIR" truename))
|
|
|
|
|
(file-attributes file))
|
|
|
|
|
(progn (setq file (expand-file-name "dir.info" truename))
|
|
|
|
|
(file-attributes file))
|
|
|
|
|
(progn (setq file (expand-file-name "DIR.INFO" truename))
|
|
|
|
|
(file-attributes file)))))
|
1993-12-23 03:20:32 +00:00
|
|
|
|
(setq dirs-done
|
|
|
|
|
(cons truename
|
|
|
|
|
(cons (directory-file-name truename)
|
|
|
|
|
dirs-done)))
|
1994-06-15 18:13:52 +00:00
|
|
|
|
(if attrs
|
|
|
|
|
(save-excursion
|
|
|
|
|
(or buffers
|
|
|
|
|
(message "Composing main Info directory..."))
|
|
|
|
|
(set-buffer (generate-new-buffer "info dir"))
|
|
|
|
|
(insert-file-contents file)
|
|
|
|
|
(setq buffers (cons (current-buffer) buffers)
|
|
|
|
|
Info-dir-file-attributes
|
|
|
|
|
(cons (cons file attrs)
|
|
|
|
|
Info-dir-file-attributes))))))
|
1996-10-25 04:43:06 +00:00
|
|
|
|
(or (cdr dirs) (setq Info-dir-contents-directory
|
|
|
|
|
(file-name-as-directory (car dirs))))
|
1994-06-15 18:13:52 +00:00
|
|
|
|
(setq dirs (cdr dirs))))
|
|
|
|
|
|
1994-04-07 03:11:50 +00:00
|
|
|
|
(or buffers
|
1996-02-25 18:31:16 +00:00
|
|
|
|
(error "Can't find the Info directory node"))
|
1993-03-02 07:27:17 +00:00
|
|
|
|
;; Distinguish the dir file that comes with Emacs from all the
|
1993-05-28 18:35:23 +00:00
|
|
|
|
;; others. Yes, that is really what this is supposed to do.
|
|
|
|
|
;; If it doesn't work, fix it.
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(setq buffer (car buffers)
|
|
|
|
|
others (cdr buffers))
|
1993-03-02 07:27:17 +00:00
|
|
|
|
|
1996-05-30 19:46:24 +00:00
|
|
|
|
;; Insert the entire original dir file as a start; note that we've
|
|
|
|
|
;; already saved its default directory to use as the default
|
|
|
|
|
;; directory for the whole concatenation.
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(insert-buffer buffer)
|
1993-03-02 07:27:17 +00:00
|
|
|
|
|
1993-03-01 09:25:44 +00:00
|
|
|
|
;; Look at each of the other buffers one by one.
|
|
|
|
|
(while others
|
|
|
|
|
(let ((other (car others)))
|
|
|
|
|
;; In each, find all the menus.
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer other)
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
;; Find each menu, and add an elt to NODES for it.
|
|
|
|
|
(while (re-search-forward "^\\* Menu:" nil t)
|
|
|
|
|
(let (beg nodename end)
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(setq beg (point))
|
1994-03-14 21:27:13 +00:00
|
|
|
|
(search-backward "\n\^_")
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(search-forward "Node: ")
|
|
|
|
|
(setq nodename (Info-following-node-name))
|
1994-03-14 21:27:13 +00:00
|
|
|
|
(search-forward "\n\^_" nil 'move)
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(setq end (point))
|
|
|
|
|
(setq nodes (cons (list nodename other beg end) nodes))))))
|
|
|
|
|
(setq others (cdr others)))
|
|
|
|
|
;; Add to the main menu a menu item for each other node.
|
|
|
|
|
(re-search-forward "^\\* Menu:")
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(let ((menu-items '("top"))
|
|
|
|
|
(nodes nodes)
|
|
|
|
|
(case-fold-search t)
|
1994-03-14 21:27:13 +00:00
|
|
|
|
(end (save-excursion (search-forward "\^_" nil t) (point))))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(while nodes
|
|
|
|
|
(let ((nodename (car (car nodes))))
|
1994-03-26 05:24:17 +00:00
|
|
|
|
(save-excursion
|
|
|
|
|
(or (member (downcase nodename) menu-items)
|
|
|
|
|
(re-search-forward (concat "^\\* "
|
|
|
|
|
(regexp-quote nodename)
|
|
|
|
|
"::")
|
|
|
|
|
end t)
|
|
|
|
|
(progn
|
|
|
|
|
(insert "* " nodename "::" "\n")
|
|
|
|
|
(setq menu-items (cons nodename menu-items))))))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(setq nodes (cdr nodes))))
|
|
|
|
|
;; Now take each node of each of the other buffers
|
|
|
|
|
;; and merge it into the main buffer.
|
|
|
|
|
(while nodes
|
|
|
|
|
(let ((nodename (car (car nodes))))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
;; Find the like-named node in the main buffer.
|
1994-03-14 21:27:13 +00:00
|
|
|
|
(if (re-search-forward (concat "\n\^_.*\n.*Node: "
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(regexp-quote nodename)
|
|
|
|
|
"[,\n\t]")
|
|
|
|
|
nil t)
|
|
|
|
|
(progn
|
1994-03-14 21:27:13 +00:00
|
|
|
|
(search-forward "\n\^_" nil 'move)
|
1994-09-19 05:11:40 +00:00
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(insert "\n"))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
;; If none exists, add one.
|
|
|
|
|
(goto-char (point-max))
|
1994-06-27 20:54:14 +00:00
|
|
|
|
(insert "\^_\nFile: dir\tNode: " nodename "\n\n* Menu:\n\n"))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
;; Merge the text from the other buffer's menu
|
|
|
|
|
;; into the menu in the like-named node in the main buffer.
|
1994-09-19 05:11:40 +00:00
|
|
|
|
(apply 'insert-buffer-substring (cdr (car nodes))))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
(setq nodes (cdr nodes)))
|
|
|
|
|
;; Kill all the buffers we just made.
|
|
|
|
|
(while buffers
|
|
|
|
|
(kill-buffer (car buffers))
|
1994-06-15 18:13:52 +00:00
|
|
|
|
(setq buffers (cdr buffers)))
|
|
|
|
|
(message "Composing main Info directory...done"))
|
1993-03-02 07:27:17 +00:00
|
|
|
|
(setq Info-dir-contents (buffer-string)))
|
|
|
|
|
(setq default-directory Info-dir-contents-directory))
|
1993-03-01 09:25:44 +00:00
|
|
|
|
|
1997-02-08 18:34:21 +00:00
|
|
|
|
;; Note that on entry to this function the current-buffer must be the
|
|
|
|
|
;; *info* buffer; not the info tags buffer.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defun Info-read-subfile (nodepos)
|
1996-10-06 22:50:07 +00:00
|
|
|
|
;; NODEPOS is either a position (in the Info file as a whole,
|
|
|
|
|
;; not relative to a subfile) or the name of a subfile.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let (lastfilepos
|
|
|
|
|
lastfilename)
|
1996-10-06 22:50:07 +00:00
|
|
|
|
(if (numberp nodepos)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer (marker-buffer Info-tag-table-marker))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(search-forward "\n\^_")
|
|
|
|
|
(forward-line 2)
|
|
|
|
|
(catch 'foo
|
|
|
|
|
(while (not (looking-at "\^_"))
|
|
|
|
|
(if (not (eolp))
|
|
|
|
|
(let ((beg (point))
|
|
|
|
|
thisfilepos thisfilename)
|
|
|
|
|
(search-forward ": ")
|
|
|
|
|
(setq thisfilename (buffer-substring beg (- (point) 2)))
|
|
|
|
|
(setq thisfilepos (read (current-buffer)))
|
|
|
|
|
;; read in version 19 stops at the end of number.
|
|
|
|
|
;; Advance to the next line.
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(if (> thisfilepos nodepos)
|
|
|
|
|
(throw 'foo t))
|
|
|
|
|
(setq lastfilename thisfilename)
|
|
|
|
|
(setq lastfilepos thisfilepos))
|
|
|
|
|
(forward-line 1)))))
|
|
|
|
|
(setq lastfilename nodepos)
|
|
|
|
|
(setq lastfilepos 0))
|
1997-02-08 18:34:21 +00:00
|
|
|
|
;; Assume previous buffer is in Info-mode.
|
|
|
|
|
;; (set-buffer (get-buffer "*info*"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(or (equal Info-current-subfile lastfilename)
|
|
|
|
|
(let ((buffer-read-only nil))
|
|
|
|
|
(setq buffer-file-name nil)
|
|
|
|
|
(widen)
|
|
|
|
|
(erase-buffer)
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(info-insert-file-contents lastfilename)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(set-buffer-modified-p nil)
|
|
|
|
|
(setq Info-current-subfile lastfilename)))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(search-forward "\n\^_")
|
1996-10-06 22:50:07 +00:00
|
|
|
|
(if (numberp nodepos)
|
|
|
|
|
(+ (- nodepos lastfilepos) (point)))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
;; Select the info node that point is in.
|
|
|
|
|
(defun Info-select-node ()
|
|
|
|
|
(save-excursion
|
|
|
|
|
;; Find beginning of node.
|
|
|
|
|
(search-backward "\n\^_")
|
|
|
|
|
(forward-line 2)
|
|
|
|
|
;; Get nodename spelled as it is in the node.
|
|
|
|
|
(re-search-forward "Node:[ \t]*")
|
|
|
|
|
(setq Info-current-node
|
1995-10-24 16:36:52 +00:00
|
|
|
|
(buffer-substring-no-properties (point)
|
|
|
|
|
(progn
|
|
|
|
|
(skip-chars-forward "^,\t\n")
|
|
|
|
|
(point))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-set-mode-line)
|
|
|
|
|
;; Find the end of it, and narrow.
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(let (active-expression)
|
|
|
|
|
(narrow-to-region (point)
|
|
|
|
|
(if (re-search-forward "\n[\^_\f]" nil t)
|
|
|
|
|
(prog1
|
|
|
|
|
(1- (point))
|
|
|
|
|
(if (looking-at "[\n\^_\f]*execute: ")
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char (match-end 0))
|
|
|
|
|
(setq active-expression
|
|
|
|
|
(read (current-buffer))))))
|
|
|
|
|
(point-max)))
|
1993-07-24 17:35:02 +00:00
|
|
|
|
(if Info-enable-active-nodes (eval active-expression))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(if Info-fontify (Info-fontify-node))
|
1993-07-24 17:35:02 +00:00
|
|
|
|
(run-hooks 'Info-selection-hook))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-set-mode-line ()
|
|
|
|
|
(setq mode-line-buffer-identification
|
|
|
|
|
(concat
|
|
|
|
|
"Info: ("
|
|
|
|
|
(if Info-current-file
|
|
|
|
|
(file-name-nondirectory Info-current-file)
|
|
|
|
|
"")
|
|
|
|
|
")"
|
|
|
|
|
(or Info-current-node ""))))
|
|
|
|
|
|
|
|
|
|
;; Go to an info node specified with a filename-and-nodename string
|
|
|
|
|
;; of the sort that is found in pointers in nodes.
|
|
|
|
|
|
|
|
|
|
(defun Info-goto-node (nodename)
|
|
|
|
|
"Go to info node named NAME. Give just NODENAME or (FILENAME)NODENAME."
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(interactive (list (Info-read-node-name "Goto node: ")))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let (filename)
|
|
|
|
|
(string-match "\\s *\\((\\s *\\([^\t)]*\\)\\s *)\\s *\\|\\)\\(.*\\)"
|
|
|
|
|
nodename)
|
|
|
|
|
(setq filename (if (= (match-beginning 1) (match-end 1))
|
|
|
|
|
""
|
|
|
|
|
(substring nodename (match-beginning 2) (match-end 2)))
|
|
|
|
|
nodename (substring nodename (match-beginning 3) (match-end 3)))
|
|
|
|
|
(let ((trim (string-match "\\s *\\'" filename)))
|
|
|
|
|
(if trim (setq filename (substring filename 0 trim))))
|
|
|
|
|
(let ((trim (string-match "\\s *\\'" nodename)))
|
|
|
|
|
(if trim (setq nodename (substring nodename 0 trim))))
|
1995-06-29 18:57:15 +00:00
|
|
|
|
(if transient-mark-mode (deactivate-mark))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-find-node (if (equal filename "") nil filename)
|
|
|
|
|
(if (equal nodename "") "Top" nodename))))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
|
1995-08-05 20:56:23 +00:00
|
|
|
|
;; This function is used as the "completion table" while reading a node name.
|
|
|
|
|
;; It does completion using the alist in completion-table
|
|
|
|
|
;; unless STRING starts with an open-paren.
|
|
|
|
|
(defun Info-read-node-name-1 (string predicate code)
|
|
|
|
|
(let ((no-completion (and (> (length string) 0) (eq (aref string 0) ?\())))
|
|
|
|
|
(cond ((eq code nil)
|
|
|
|
|
(if no-completion
|
|
|
|
|
string
|
|
|
|
|
(try-completion string completion-table predicate)))
|
|
|
|
|
((eq code t)
|
|
|
|
|
(if no-completion
|
|
|
|
|
nil
|
|
|
|
|
(all-completions string completion-table predicate)))
|
|
|
|
|
((eq code 'lambda)
|
|
|
|
|
(if no-completion
|
|
|
|
|
t
|
|
|
|
|
(assoc string completion-table))))))
|
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(defun Info-read-node-name (prompt &optional default)
|
|
|
|
|
(let* ((completion-ignore-case t)
|
1995-08-05 20:56:23 +00:00
|
|
|
|
(completion-table (Info-build-node-completions))
|
1997-03-08 19:19:51 +00:00
|
|
|
|
(nodename (completing-read prompt 'Info-read-node-name-1 nil t)))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(if (equal nodename "")
|
|
|
|
|
(or default
|
|
|
|
|
(Info-read-node-name prompt))
|
|
|
|
|
nodename)))
|
|
|
|
|
|
|
|
|
|
(defun Info-build-node-completions ()
|
|
|
|
|
(or Info-current-file-completions
|
|
|
|
|
(let ((compl nil))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(save-restriction
|
|
|
|
|
(if (marker-buffer Info-tag-table-marker)
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(let ((marker Info-tag-table-marker))
|
|
|
|
|
(set-buffer (marker-buffer marker))
|
1994-02-24 03:25:46 +00:00
|
|
|
|
(widen)
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(goto-char marker)
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(while (re-search-forward "\nNode: \\(.*\\)\177" nil t)
|
|
|
|
|
(setq compl
|
|
|
|
|
(cons (list (buffer-substring (match-beginning 1)
|
|
|
|
|
(match-end 1)))
|
|
|
|
|
compl))))
|
|
|
|
|
(widen)
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(while (search-forward "\n\^_" nil t)
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(let ((beg (point)))
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(if (re-search-backward "Node: *\\([^,\n]*\\) *[,\n\t]"
|
|
|
|
|
beg t)
|
|
|
|
|
(setq compl
|
|
|
|
|
(cons (list (buffer-substring (match-beginning 1)
|
|
|
|
|
(match-end 1)))
|
|
|
|
|
compl))))))))
|
|
|
|
|
(setq Info-current-file-completions compl))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1992-02-07 21:40:34 +00:00
|
|
|
|
(defun Info-restore-point (hl)
|
|
|
|
|
"If this node has been visited, restore the point value when we left."
|
1994-02-24 03:25:46 +00:00
|
|
|
|
(while hl
|
|
|
|
|
(if (and (equal (nth 0 (car hl)) Info-current-file)
|
1995-04-24 15:31:19 +00:00
|
|
|
|
;; Use string-equal, not equal, to ignore text props.
|
|
|
|
|
(string-equal (nth 1 (car hl)) Info-current-node))
|
1994-02-24 03:25:46 +00:00
|
|
|
|
(progn
|
1994-03-01 09:02:19 +00:00
|
|
|
|
(goto-char (nth 2 (car hl)))
|
|
|
|
|
(setq hl nil)) ;terminate the while at next iter
|
1994-02-24 03:25:46 +00:00
|
|
|
|
(setq hl (cdr hl)))))
|
1992-02-07 21:40:34 +00:00
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defvar Info-last-search nil
|
1993-05-25 17:17:50 +00:00
|
|
|
|
"Default regexp for \\<Info-mode-map>\\[Info-search] command to search for.")
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-search (regexp)
|
|
|
|
|
"Search for REGEXP, starting from point, and select node it's found in."
|
|
|
|
|
(interactive "sSearch (regexp): ")
|
1995-06-29 18:57:15 +00:00
|
|
|
|
(if transient-mark-mode (deactivate-mark))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(if (equal regexp "")
|
|
|
|
|
(setq regexp Info-last-search)
|
|
|
|
|
(setq Info-last-search regexp))
|
|
|
|
|
(let ((found ()) current
|
|
|
|
|
(onode Info-current-node)
|
|
|
|
|
(ofile Info-current-file)
|
|
|
|
|
(opoint (point))
|
1996-10-06 22:50:07 +00:00
|
|
|
|
(ostart (window-start))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(osubfile Info-current-subfile))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(save-restriction
|
|
|
|
|
(widen)
|
|
|
|
|
(if (null Info-current-subfile)
|
|
|
|
|
(progn (re-search-forward regexp) (setq found (point)))
|
|
|
|
|
(condition-case err
|
|
|
|
|
(progn (re-search-forward regexp) (setq found (point)))
|
|
|
|
|
(search-failed nil)))))
|
|
|
|
|
(if (not found) ;can only happen in subfile case -- else would have erred
|
|
|
|
|
(unwind-protect
|
|
|
|
|
(let ((list ()))
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer (marker-buffer Info-tag-table-marker))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(goto-char (point-min))
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(search-forward "\n\^_\nIndirect:")
|
|
|
|
|
(save-restriction
|
|
|
|
|
(narrow-to-region (point)
|
|
|
|
|
(progn (search-forward "\n\^_")
|
|
|
|
|
(1- (point))))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(search-forward (concat "\n" osubfile ": "))
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(while (not (eobp))
|
|
|
|
|
(re-search-forward "\\(^.*\\): [0-9]+$")
|
|
|
|
|
(goto-char (+ (match-end 1) 2))
|
|
|
|
|
(setq list (cons (cons (read (current-buffer))
|
|
|
|
|
(buffer-substring
|
|
|
|
|
(match-beginning 1) (match-end 1)))
|
|
|
|
|
list))
|
|
|
|
|
(goto-char (1+ (match-end 0))))
|
|
|
|
|
(setq list (nreverse list)
|
|
|
|
|
current (car (car list))
|
|
|
|
|
list (cdr list))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(while list
|
|
|
|
|
(message "Searching subfile %s..." (cdr (car list)))
|
|
|
|
|
(Info-read-subfile (car (car list)))
|
|
|
|
|
(setq list (cdr list))
|
1994-06-27 20:54:14 +00:00
|
|
|
|
;; (goto-char (point-min))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(if (re-search-forward regexp nil t)
|
|
|
|
|
(setq found (point) list ())))
|
|
|
|
|
(if found
|
|
|
|
|
(message "")
|
|
|
|
|
(signal 'search-failed (list regexp))))
|
|
|
|
|
(if (not found)
|
1996-10-06 22:50:07 +00:00
|
|
|
|
(progn (Info-read-subfile osubfile)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(goto-char opoint)
|
1996-10-06 22:50:07 +00:00
|
|
|
|
(Info-select-node)
|
|
|
|
|
(set-window-start (selected-window) ostart)))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(widen)
|
|
|
|
|
(goto-char found)
|
|
|
|
|
(Info-select-node)
|
1995-04-24 15:31:19 +00:00
|
|
|
|
;; Use string-equal, not equal, to ignore text props.
|
|
|
|
|
(or (and (string-equal onode Info-current-node)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(equal ofile Info-current-file))
|
|
|
|
|
(setq Info-history (cons (list ofile onode opoint)
|
|
|
|
|
Info-history)))))
|
|
|
|
|
|
|
|
|
|
;; Extract the value of the node-pointer named NAME.
|
|
|
|
|
;; If there is none, use ERRORNAME in the error message;
|
|
|
|
|
;; if ERRORNAME is nil, just return nil.
|
|
|
|
|
(defun Info-extract-pointer (name &optional errorname)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
(if (re-search-backward (concat name ":") nil t)
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char (match-end 0))
|
|
|
|
|
(Info-following-node-name))
|
|
|
|
|
(if (eq errorname t)
|
|
|
|
|
nil
|
1996-01-29 23:16:36 +00:00
|
|
|
|
(error "Node has no %s" (capitalize (or errorname name)))))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1993-03-01 09:25:44 +00:00
|
|
|
|
;; Return the node name in the buffer following point.
|
|
|
|
|
;; ALLOWEDCHARS, if non-nil, goes within [...] to make a regexp
|
1997-02-08 18:34:21 +00:00
|
|
|
|
;; saying which chars may appear in the node name.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defun Info-following-node-name (&optional allowedchars)
|
|
|
|
|
(skip-chars-forward " \t")
|
1995-10-24 16:36:52 +00:00
|
|
|
|
(buffer-substring-no-properties
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(point)
|
|
|
|
|
(progn
|
|
|
|
|
(while (looking-at (concat "[" (or allowedchars "^,\t\n") "]"))
|
|
|
|
|
(skip-chars-forward (concat (or allowedchars "^,\t\n") "("))
|
|
|
|
|
(if (looking-at "(")
|
|
|
|
|
(skip-chars-forward "^)")))
|
|
|
|
|
(skip-chars-backward " ")
|
|
|
|
|
(point))))
|
|
|
|
|
|
|
|
|
|
(defun Info-next ()
|
|
|
|
|
"Go to the next node of this node."
|
|
|
|
|
(interactive)
|
|
|
|
|
(Info-goto-node (Info-extract-pointer "next")))
|
|
|
|
|
|
|
|
|
|
(defun Info-prev ()
|
|
|
|
|
"Go to the previous node of this node."
|
|
|
|
|
(interactive)
|
|
|
|
|
(Info-goto-node (Info-extract-pointer "prev[ious]*" "previous")))
|
|
|
|
|
|
|
|
|
|
(defun Info-up ()
|
|
|
|
|
"Go to the superior node of this node."
|
|
|
|
|
(interactive)
|
1992-02-07 21:40:34 +00:00
|
|
|
|
(Info-goto-node (Info-extract-pointer "up"))
|
|
|
|
|
(Info-restore-point Info-history))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-last ()
|
|
|
|
|
"Go back to the last node visited."
|
|
|
|
|
(interactive)
|
|
|
|
|
(or Info-history
|
|
|
|
|
(error "This is the first Info node you looked at"))
|
|
|
|
|
(let (filename nodename opoint)
|
|
|
|
|
(setq filename (car (car Info-history)))
|
|
|
|
|
(setq nodename (car (cdr (car Info-history))))
|
|
|
|
|
(setq opoint (car (cdr (cdr (car Info-history)))))
|
|
|
|
|
(setq Info-history (cdr Info-history))
|
|
|
|
|
(Info-find-node filename nodename)
|
|
|
|
|
(setq Info-history (cdr Info-history))
|
|
|
|
|
(goto-char opoint)))
|
|
|
|
|
|
|
|
|
|
(defun Info-directory ()
|
|
|
|
|
"Go to the Info directory node."
|
|
|
|
|
(interactive)
|
|
|
|
|
(Info-find-node "dir" "top"))
|
|
|
|
|
|
|
|
|
|
(defun Info-follow-reference (footnotename)
|
|
|
|
|
"Follow cross reference named NAME to the node it refers to.
|
|
|
|
|
NAME may be an abbreviation of the reference name."
|
|
|
|
|
(interactive
|
|
|
|
|
(let ((completion-ignore-case t)
|
1994-01-10 22:35:29 +00:00
|
|
|
|
completions default alt-default (start-point (point)) str i bol eol)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(save-excursion
|
1994-01-10 22:35:29 +00:00
|
|
|
|
;; Store end and beginning of line.
|
|
|
|
|
(end-of-line)
|
|
|
|
|
(setq eol (point))
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(setq bol (point))
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(while (re-search-forward "\\*note[ \n\t]*\\([^:]*\\):" nil t)
|
|
|
|
|
(setq str (buffer-substring
|
|
|
|
|
(match-beginning 1)
|
|
|
|
|
(1- (point))))
|
|
|
|
|
;; See if this one should be the default.
|
|
|
|
|
(and (null default)
|
1993-11-24 00:19:39 +00:00
|
|
|
|
(<= (match-beginning 0) start-point)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(<= start-point (point))
|
|
|
|
|
(setq default t))
|
1994-01-10 22:35:29 +00:00
|
|
|
|
;; See if this one should be the alternate default.
|
|
|
|
|
(and (null alt-default)
|
|
|
|
|
(and (<= bol (match-beginning 0))
|
|
|
|
|
(<= (point) eol))
|
|
|
|
|
(setq alt-default t))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(setq i 0)
|
|
|
|
|
(while (setq i (string-match "[ \n\t]+" str i))
|
|
|
|
|
(setq str (concat (substring str 0 i) " "
|
|
|
|
|
(substring str (match-end 0))))
|
|
|
|
|
(setq i (1+ i)))
|
|
|
|
|
;; Record as a completion and perhaps as default.
|
|
|
|
|
(if (eq default t) (setq default str))
|
1994-01-10 22:35:29 +00:00
|
|
|
|
(if (eq alt-default t) (setq alt-default str))
|
1996-12-05 19:53:00 +00:00
|
|
|
|
;; Don't add this string if it's a duplicate.
|
|
|
|
|
;; We use a loop instead of "(assoc str completions)" because
|
|
|
|
|
;; we want to do a case-insensitive compare.
|
|
|
|
|
(let ((tail completions)
|
|
|
|
|
(tem (downcase str)))
|
|
|
|
|
(while (and tail
|
|
|
|
|
(not (string-equal tem (downcase (car (car tail))))))
|
|
|
|
|
(setq tail (cdr tail)))
|
|
|
|
|
(or tail
|
|
|
|
|
(setq completions
|
|
|
|
|
(cons (cons str nil)
|
|
|
|
|
completions))))))
|
1994-01-10 22:35:29 +00:00
|
|
|
|
;; If no good default was found, try an alternate.
|
|
|
|
|
(or default
|
|
|
|
|
(setq default alt-default))
|
|
|
|
|
;; If only one cross-reference found, then make it default.
|
|
|
|
|
(if (eq (length completions) 1)
|
|
|
|
|
(setq default (car (car completions))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(if completions
|
1993-06-08 04:41:00 +00:00
|
|
|
|
(let ((input (completing-read (if default
|
|
|
|
|
(concat "Follow reference named: ("
|
|
|
|
|
default ") ")
|
|
|
|
|
"Follow reference named: ")
|
|
|
|
|
completions nil t)))
|
|
|
|
|
(list (if (equal input "")
|
|
|
|
|
default input)))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(error "No cross-references in this node"))))
|
1994-11-23 19:56:15 +00:00
|
|
|
|
(let (target beg i (str (concat "\\*note " (regexp-quote footnotename))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(while (setq i (string-match " " str i))
|
|
|
|
|
(setq str (concat (substring str 0 i) "[ \t\n]+" (substring str (1+ i))))
|
|
|
|
|
(setq i (+ i 6)))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(or (re-search-forward str nil t)
|
|
|
|
|
(error "No cross-reference named %s" footnotename))
|
|
|
|
|
(goto-char (+ (match-beginning 0) 5))
|
|
|
|
|
(setq target
|
|
|
|
|
(Info-extract-menu-node-name "Bad format cross reference" t)))
|
|
|
|
|
(while (setq i (string-match "[ \t\n]+" target i))
|
|
|
|
|
(setq target (concat (substring target 0 i) " "
|
|
|
|
|
(substring target (match-end 0))))
|
|
|
|
|
(setq i (+ i 1)))
|
|
|
|
|
(Info-goto-node target)))
|
|
|
|
|
|
|
|
|
|
(defun Info-extract-menu-node-name (&optional errmessage multi-line)
|
|
|
|
|
(skip-chars-forward " \t\n")
|
|
|
|
|
(let ((beg (point))
|
|
|
|
|
str i)
|
|
|
|
|
(skip-chars-forward "^:")
|
|
|
|
|
(forward-char 1)
|
|
|
|
|
(setq str
|
|
|
|
|
(if (looking-at ":")
|
1995-10-24 16:36:52 +00:00
|
|
|
|
(buffer-substring-no-properties beg (1- (point)))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(skip-chars-forward " \t\n")
|
|
|
|
|
(Info-following-node-name (if multi-line "^.,\t" "^.,\t\n"))))
|
|
|
|
|
(while (setq i (string-match "\n" str i))
|
|
|
|
|
(aset str i ?\ ))
|
1995-03-06 04:25:29 +00:00
|
|
|
|
;; Collapse multiple spaces.
|
|
|
|
|
(while (string-match " +" str)
|
|
|
|
|
(setq str (replace-match " " t t str)))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
str))
|
|
|
|
|
|
1994-06-10 21:00:53 +00:00
|
|
|
|
;; No one calls this.
|
1992-10-27 10:14:08 +00:00
|
|
|
|
;;(defun Info-menu-item-sequence (list)
|
|
|
|
|
;; (while list
|
1994-06-10 21:00:53 +00:00
|
|
|
|
;; (Info-menu (car list))
|
1992-10-27 10:14:08 +00:00
|
|
|
|
;; (setq list (cdr list))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1994-06-10 21:00:53 +00:00
|
|
|
|
(defun Info-complete-menu-item (string predicate action)
|
|
|
|
|
(let ((case-fold-search t))
|
|
|
|
|
(cond ((eq action nil)
|
|
|
|
|
(let (completions
|
|
|
|
|
(pattern (concat "\n\\* \\("
|
|
|
|
|
(regexp-quote string)
|
|
|
|
|
"[^:\t\n]*\\):")))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer Info-complete-menu-buffer)
|
|
|
|
|
(goto-char (point-min))
|
1995-11-16 16:33:04 +00:00
|
|
|
|
(search-forward "\n* Menu:")
|
1994-06-10 21:00:53 +00:00
|
|
|
|
(while (re-search-forward pattern nil t)
|
|
|
|
|
(setq completions (cons (cons (format "%s"
|
|
|
|
|
(buffer-substring
|
|
|
|
|
(match-beginning 1)
|
|
|
|
|
(match-end 1)))
|
|
|
|
|
(match-beginning 1))
|
|
|
|
|
completions))))
|
|
|
|
|
(try-completion string completions predicate)))
|
|
|
|
|
((eq action t)
|
|
|
|
|
(let (completions
|
|
|
|
|
(pattern (concat "\n\\* \\("
|
|
|
|
|
(regexp-quote string)
|
|
|
|
|
"[^:\t\n]*\\):")))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer Info-complete-menu-buffer)
|
|
|
|
|
(goto-char (point-min))
|
1995-11-16 16:33:04 +00:00
|
|
|
|
(search-forward "\n* Menu:")
|
1994-06-10 21:00:53 +00:00
|
|
|
|
(while (re-search-forward pattern nil t)
|
|
|
|
|
(setq completions (cons (cons (format "%s"
|
|
|
|
|
(buffer-substring
|
|
|
|
|
(match-beginning 1)
|
|
|
|
|
(match-end 1)))
|
|
|
|
|
(match-beginning 1))
|
|
|
|
|
completions))))
|
|
|
|
|
(all-completions string completions predicate)))
|
|
|
|
|
(t
|
|
|
|
|
(save-excursion
|
|
|
|
|
(set-buffer Info-complete-menu-buffer)
|
|
|
|
|
(goto-char (point-min))
|
1995-11-16 16:33:04 +00:00
|
|
|
|
(search-forward "\n* Menu:")
|
1994-06-10 21:00:53 +00:00
|
|
|
|
(re-search-forward (concat "\n\\* "
|
|
|
|
|
(regexp-quote string)
|
|
|
|
|
":")
|
|
|
|
|
nil t))))))
|
|
|
|
|
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defun Info-menu (menu-item)
|
|
|
|
|
"Go to node for menu item named (or abbreviated) NAME.
|
|
|
|
|
Completion is allowed, and the menu item point is on is the default."
|
|
|
|
|
(interactive
|
|
|
|
|
(let ((completions '())
|
|
|
|
|
;; If point is within a menu item, use that item as the default
|
|
|
|
|
(default nil)
|
|
|
|
|
(p (point))
|
1995-03-11 04:37:47 +00:00
|
|
|
|
beg
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(last nil))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(if (not (search-forward "\n* menu:" nil t))
|
|
|
|
|
(error "No menu in this node"))
|
1994-06-10 21:00:53 +00:00
|
|
|
|
(setq beg (point))
|
|
|
|
|
(and (< (point) p)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char p)
|
|
|
|
|
(end-of-line)
|
|
|
|
|
(re-search-backward "\n\\* \\([^:\t\n]*\\):" beg t)
|
|
|
|
|
(setq default (format "%s" (buffer-substring
|
|
|
|
|
(match-beginning 1)
|
|
|
|
|
(match-end 1)))))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let ((item nil))
|
|
|
|
|
(while (null item)
|
1994-06-10 21:00:53 +00:00
|
|
|
|
(setq item (let ((completion-ignore-case t)
|
|
|
|
|
(Info-complete-menu-buffer (current-buffer)))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(completing-read (if default
|
|
|
|
|
(format "Menu item (default %s): "
|
|
|
|
|
default)
|
|
|
|
|
"Menu item: ")
|
1994-06-10 21:00:53 +00:00
|
|
|
|
'Info-complete-menu-item nil t)))
|
1992-02-07 21:40:34 +00:00
|
|
|
|
;; we rely on the fact that completing-read accepts an input
|
|
|
|
|
;; of "" even when the require-match argument is true and ""
|
|
|
|
|
;; is not a valid possibility
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(if (string= item "")
|
|
|
|
|
(if default
|
|
|
|
|
(setq item default)
|
|
|
|
|
;; ask again
|
|
|
|
|
(setq item nil))))
|
|
|
|
|
(list item))))
|
|
|
|
|
;; there is a problem here in that if several menu items have the same
|
|
|
|
|
;; name you can only go to the node of the first with this command.
|
|
|
|
|
(Info-goto-node (Info-extract-menu-item menu-item)))
|
|
|
|
|
|
|
|
|
|
(defun Info-extract-menu-item (menu-item)
|
|
|
|
|
(setq menu-item (regexp-quote menu-item))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(or (search-forward "\n* menu:" nil t)
|
|
|
|
|
(error "No menu in this node"))
|
1993-11-10 20:46:09 +00:00
|
|
|
|
(or (re-search-forward (concat "\n\\* " menu-item ":") nil t)
|
|
|
|
|
(re-search-forward (concat "\n\\* " menu-item) nil t)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(error "No such item in menu"))
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(forward-char 2)
|
|
|
|
|
(Info-extract-menu-node-name)))
|
|
|
|
|
|
|
|
|
|
;; If COUNT is nil, use the last item in the menu.
|
|
|
|
|
(defun Info-extract-menu-counting (count)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(or (search-forward "\n* menu:" nil t)
|
|
|
|
|
(error "No menu in this node"))
|
|
|
|
|
(if count
|
|
|
|
|
(or (search-forward "\n* " nil t count)
|
|
|
|
|
(error "Too few items in menu"))
|
|
|
|
|
(while (search-forward "\n* " nil t)
|
|
|
|
|
nil))
|
|
|
|
|
(Info-extract-menu-node-name)))
|
|
|
|
|
|
1992-12-09 17:28:25 +00:00
|
|
|
|
(defun Info-nth-menu-item ()
|
|
|
|
|
"Go to the node of the Nth menu item.
|
|
|
|
|
N is the digit argument used to invoke this command."
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(interactive)
|
1992-12-09 17:28:25 +00:00
|
|
|
|
(Info-goto-node
|
|
|
|
|
(Info-extract-menu-counting
|
|
|
|
|
(- (aref (this-command-keys) (1- (length (this-command-keys)))) ?0))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-top-node ()
|
|
|
|
|
"Go to the Top node of this file."
|
|
|
|
|
(interactive)
|
|
|
|
|
(Info-goto-node "Top"))
|
|
|
|
|
|
|
|
|
|
(defun Info-final-node ()
|
|
|
|
|
"Go to the final node in this file."
|
|
|
|
|
(interactive)
|
|
|
|
|
(Info-goto-node "Top")
|
|
|
|
|
(let (Info-history)
|
|
|
|
|
;; Go to the last node in the menu of Top.
|
|
|
|
|
(Info-goto-node (Info-extract-menu-counting nil))
|
|
|
|
|
;; If the last node in the menu is not last in pointer structure,
|
|
|
|
|
;; move forward until we can't go any farther.
|
|
|
|
|
(while (Info-forward-node t t) nil)
|
|
|
|
|
;; Then keep moving down to last subnode, unless we reach an index.
|
|
|
|
|
(while (and (not (string-match "\\<index\\>" Info-current-node))
|
|
|
|
|
(save-excursion (search-forward "\n* Menu:" nil t)))
|
|
|
|
|
(Info-goto-node (Info-extract-menu-counting nil)))))
|
|
|
|
|
|
|
|
|
|
(defun Info-forward-node (&optional not-down no-error)
|
|
|
|
|
"Go forward one node, considering all nodes as forming one sequence."
|
|
|
|
|
(interactive)
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(forward-line 1)
|
|
|
|
|
;; three possibilities, in order of priority:
|
|
|
|
|
;; 1. next node is in a menu in this node (but not in an index)
|
|
|
|
|
;; 2. next node is next at same level
|
|
|
|
|
;; 3. next node is up and next
|
|
|
|
|
(cond ((and (not not-down)
|
|
|
|
|
(save-excursion (search-forward "\n* menu:" nil t))
|
|
|
|
|
(not (string-match "\\<index\\>" Info-current-node)))
|
1993-03-07 04:22:15 +00:00
|
|
|
|
(Info-goto-node (Info-extract-menu-counting 1))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
t)
|
|
|
|
|
((save-excursion (search-backward "next:" nil t))
|
|
|
|
|
(Info-next)
|
|
|
|
|
t)
|
|
|
|
|
((and (save-excursion (search-backward "up:" nil t))
|
1995-04-24 15:31:19 +00:00
|
|
|
|
;; Use string-equal, not equal, to ignore text props.
|
|
|
|
|
(not (string-equal (downcase (Info-extract-pointer "up"))
|
|
|
|
|
"top")))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let ((old-node Info-current-node))
|
|
|
|
|
(Info-up)
|
|
|
|
|
(let (Info-history success)
|
|
|
|
|
(unwind-protect
|
|
|
|
|
(setq success (Info-forward-node t no-error))
|
|
|
|
|
(or success (Info-goto-node old-node))))))
|
|
|
|
|
(no-error nil)
|
|
|
|
|
(t (error "No pointer forward from this node"))))
|
|
|
|
|
|
|
|
|
|
(defun Info-backward-node ()
|
|
|
|
|
"Go backward one node, considering all nodes as forming one sequence."
|
|
|
|
|
(interactive)
|
|
|
|
|
(let ((prevnode (Info-extract-pointer "prev[ious]*" t))
|
|
|
|
|
(upnode (Info-extract-pointer "up" t)))
|
|
|
|
|
(cond ((and upnode (string-match "(" upnode))
|
|
|
|
|
(error "First node in file"))
|
|
|
|
|
((and upnode (or (null prevnode)
|
1995-04-24 15:31:19 +00:00
|
|
|
|
;; Use string-equal, not equal,
|
|
|
|
|
;; to ignore text properties.
|
|
|
|
|
(string-equal (downcase prevnode)
|
|
|
|
|
(downcase upnode))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-up))
|
|
|
|
|
(prevnode
|
|
|
|
|
;; If we move back at the same level,
|
|
|
|
|
;; go down to find the last subnode*.
|
|
|
|
|
(Info-prev)
|
|
|
|
|
(let (Info-history)
|
|
|
|
|
(while (and (not (string-match "\\<index\\>" Info-current-node))
|
|
|
|
|
(save-excursion (search-forward "\n* Menu:" nil t)))
|
|
|
|
|
(Info-goto-node (Info-extract-menu-counting nil)))))
|
|
|
|
|
(t
|
|
|
|
|
(error "No pointer backward from this node")))))
|
|
|
|
|
|
|
|
|
|
(defun Info-exit ()
|
|
|
|
|
"Exit Info by selecting some other buffer."
|
|
|
|
|
(interactive)
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(if Info-standalone
|
|
|
|
|
(save-buffers-kill-emacs)
|
|
|
|
|
(switch-to-buffer (prog1 (other-buffer (current-buffer))
|
|
|
|
|
(bury-buffer (current-buffer))))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1992-08-04 16:49:42 +00:00
|
|
|
|
(defun Info-next-menu-item ()
|
|
|
|
|
(interactive)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(forward-line -1)
|
|
|
|
|
(search-forward "\n* menu:" nil t)
|
|
|
|
|
(or (search-forward "\n* " nil t)
|
|
|
|
|
(error "No more items in menu"))
|
|
|
|
|
(Info-goto-node (Info-extract-menu-node-name))))
|
|
|
|
|
|
|
|
|
|
(defun Info-last-menu-item ()
|
|
|
|
|
(interactive)
|
|
|
|
|
(save-excursion
|
|
|
|
|
(forward-line 1)
|
1994-08-09 01:41:08 +00:00
|
|
|
|
(let ((beg (save-excursion
|
|
|
|
|
(and (search-backward "\n* menu:" nil t)
|
|
|
|
|
(point)))))
|
|
|
|
|
(or (and beg (search-backward "\n* " beg t))
|
|
|
|
|
(error "No previous items in menu")))
|
|
|
|
|
(Info-goto-node (save-excursion
|
|
|
|
|
(goto-char (match-end 0))
|
|
|
|
|
(Info-extract-menu-node-name)))))
|
1992-08-04 16:49:42 +00:00
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(defmacro Info-no-error (&rest body)
|
1992-08-04 16:49:42 +00:00
|
|
|
|
(list 'condition-case nil (cons 'progn (append body '(t))) '(error nil)))
|
|
|
|
|
|
|
|
|
|
(defun Info-next-preorder ()
|
1994-06-23 14:24:38 +00:00
|
|
|
|
"Go to the next subnode or the next node, or go up a level."
|
|
|
|
|
(interactive)
|
|
|
|
|
(cond ((Info-no-error (Info-next-menu-item)))
|
|
|
|
|
((Info-no-error (Info-next)))
|
|
|
|
|
((Info-no-error (Info-up))
|
1995-06-09 01:26:00 +00:00
|
|
|
|
;; Since we have already gone thru all the items in this menu,
|
|
|
|
|
;; go up to the end of this node.
|
1996-06-30 08:12:17 +00:00
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
;; Since logically we are done with the node with that menu,
|
|
|
|
|
;; move on from it.
|
|
|
|
|
(Info-next-preorder))
|
1994-06-23 14:24:38 +00:00
|
|
|
|
(t
|
|
|
|
|
(error "No more nodes"))))
|
1992-08-04 16:49:42 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-last-preorder ()
|
|
|
|
|
"Go to the last node, popping up a level if there is none."
|
|
|
|
|
(interactive)
|
1994-08-09 01:41:08 +00:00
|
|
|
|
(cond ((Info-no-error
|
|
|
|
|
(Info-last-menu-item)
|
|
|
|
|
;; If we go down a menu item, go to the end of the node
|
|
|
|
|
;; so we can scroll back through it.
|
1995-06-09 01:26:00 +00:00
|
|
|
|
(goto-char (point-max)))
|
1996-06-30 08:12:17 +00:00
|
|
|
|
;; Keep going down, as long as there are nested menu nodes.
|
|
|
|
|
(while (Info-no-error
|
|
|
|
|
(Info-last-menu-item)
|
|
|
|
|
;; If we go down a menu item, go to the end of the node
|
|
|
|
|
;; so we can scroll back through it.
|
|
|
|
|
(goto-char (point-max))))
|
1995-06-09 01:26:00 +00:00
|
|
|
|
(recenter -1))
|
|
|
|
|
((Info-no-error (Info-prev))
|
|
|
|
|
(goto-char (point-max))
|
1996-06-30 08:12:17 +00:00
|
|
|
|
(while (Info-no-error
|
|
|
|
|
(Info-last-menu-item)
|
|
|
|
|
;; If we go down a menu item, go to the end of the node
|
|
|
|
|
;; so we can scroll back through it.
|
|
|
|
|
(goto-char (point-max))))
|
1995-06-09 01:26:00 +00:00
|
|
|
|
(recenter -1))
|
|
|
|
|
((Info-no-error (Info-up))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(or (search-forward "\n* Menu:" nil t)
|
|
|
|
|
(goto-char (point-max))))
|
|
|
|
|
(t (error "No previous nodes"))))
|
1992-08-04 16:49:42 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-scroll-up ()
|
1994-10-02 08:36:08 +00:00
|
|
|
|
"Scroll one screenful forward in Info, considering all nodes as one sequence.
|
1996-11-02 07:39:07 +00:00
|
|
|
|
Once you scroll far enough in a node that its menu appears on the screen
|
|
|
|
|
but after point, the next scroll moves into its first subnode.
|
|
|
|
|
|
|
|
|
|
When you scroll past the end of a node, that goes to the next node; if
|
|
|
|
|
this node has no successor, it moves to the parent node's successor,
|
|
|
|
|
and so on. If point is inside the menu of a node, it moves to
|
|
|
|
|
subnode indicated by the following menu item. (That case won't
|
|
|
|
|
normally result from this command, but can happen in other ways.)"
|
|
|
|
|
|
1992-08-04 16:49:42 +00:00
|
|
|
|
(interactive)
|
1994-08-09 01:41:08 +00:00
|
|
|
|
(if (or (< (window-start) (point-min))
|
|
|
|
|
(> (window-start) (point-max)))
|
|
|
|
|
(set-window-start (selected-window) (point)))
|
|
|
|
|
(let ((virtual-end (save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(if (search-forward "\n* Menu:" nil t)
|
|
|
|
|
(point)
|
|
|
|
|
(point-max)))))
|
|
|
|
|
(if (or (< virtual-end (window-start))
|
|
|
|
|
(pos-visible-in-window-p virtual-end))
|
|
|
|
|
(Info-next-preorder)
|
|
|
|
|
(scroll-up))))
|
1992-08-04 16:49:42 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-scroll-down ()
|
1994-10-02 08:36:08 +00:00
|
|
|
|
"Scroll one screenful back in Info, considering all nodes as one sequence.
|
1995-06-09 01:26:00 +00:00
|
|
|
|
Within the menu of a node, this goes to its last subnode.
|
|
|
|
|
When you scroll past the beginning of a node, that goes to the
|
|
|
|
|
previous node or back up to the parent node."
|
1992-08-04 16:49:42 +00:00
|
|
|
|
(interactive)
|
1994-08-09 01:41:08 +00:00
|
|
|
|
(if (or (< (window-start) (point-min))
|
|
|
|
|
(> (window-start) (point-max)))
|
|
|
|
|
(set-window-start (selected-window) (point)))
|
1996-06-30 08:12:17 +00:00
|
|
|
|
(let* ((current-point (point))
|
|
|
|
|
(virtual-end (save-excursion
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(setq current-point (point))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(search-forward "\n* Menu:"
|
|
|
|
|
current-point
|
|
|
|
|
t))))
|
1994-08-09 01:41:08 +00:00
|
|
|
|
(if (or virtual-end (pos-visible-in-window-p (point-min)))
|
|
|
|
|
(Info-last-preorder)
|
|
|
|
|
(scroll-down))))
|
1992-08-04 16:49:42 +00:00
|
|
|
|
|
1996-04-21 01:47:02 +00:00
|
|
|
|
(defun Info-next-reference (&optional recur)
|
1993-08-02 04:22:12 +00:00
|
|
|
|
"Move cursor to the next cross-reference or menu item in the node."
|
|
|
|
|
(interactive)
|
|
|
|
|
(let ((pat "\\*note[ \n\t]*\\([^:]*\\):\\|^\\* .*:")
|
|
|
|
|
(old-pt (point)))
|
|
|
|
|
(or (eobp) (forward-char 1))
|
|
|
|
|
(or (re-search-forward pat nil t)
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(or (re-search-forward pat nil t)
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char old-pt)
|
|
|
|
|
(error "No cross references in this node")))))
|
|
|
|
|
(goto-char (match-beginning 0))
|
|
|
|
|
(if (looking-at "\\* Menu:")
|
1996-04-21 01:47:02 +00:00
|
|
|
|
(if recur
|
|
|
|
|
(error "No cross references in this node")
|
|
|
|
|
(Info-next-reference t)))))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
|
1996-04-21 01:47:02 +00:00
|
|
|
|
(defun Info-prev-reference (&optional recur)
|
1993-08-02 04:22:12 +00:00
|
|
|
|
"Move cursor to the previous cross-reference or menu item in the node."
|
|
|
|
|
(interactive)
|
|
|
|
|
(let ((pat "\\*note[ \n\t]*\\([^:]*\\):\\|^\\* .*:")
|
|
|
|
|
(old-pt (point)))
|
|
|
|
|
(or (re-search-backward pat nil t)
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(or (re-search-backward pat nil t)
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char old-pt)
|
|
|
|
|
(error "No cross references in this node")))))
|
|
|
|
|
(goto-char (match-beginning 0))
|
|
|
|
|
(if (looking-at "\\* Menu:")
|
1996-04-21 01:47:02 +00:00
|
|
|
|
(if recur
|
|
|
|
|
(error "No cross references in this node")
|
|
|
|
|
(Info-prev-reference t)))))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(defun Info-index (topic)
|
|
|
|
|
"Look up a string in the index for this file.
|
|
|
|
|
The index is defined as the first node in the top-level menu whose
|
|
|
|
|
name contains the word \"Index\", plus any immediately following
|
|
|
|
|
nodes whose names also contain the word \"Index\".
|
|
|
|
|
If there are no exact matches to the specified topic, this chooses
|
|
|
|
|
the first match which is a case-insensitive substring of a topic.
|
|
|
|
|
Use the `,' command to see the other matches.
|
|
|
|
|
Give a blank topic name to go to the Index node itself."
|
|
|
|
|
(interactive "sIndex topic: ")
|
|
|
|
|
(let ((orignode Info-current-node)
|
|
|
|
|
(rnode nil)
|
1994-06-28 04:14:41 +00:00
|
|
|
|
(pattern (format "\n\\* \\([^\n:]*%s[^\n:]*\\):[ \t]*\\([^.\n]*\\)\\.[ \t]*\\([0-9]*\\)"
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(regexp-quote topic)))
|
|
|
|
|
node)
|
|
|
|
|
(Info-goto-node "Top")
|
|
|
|
|
(or (search-forward "\n* menu:" nil t)
|
|
|
|
|
(error "No index"))
|
|
|
|
|
(or (re-search-forward "\n\\* \\(.*\\<Index\\>\\)" nil t)
|
|
|
|
|
(error "No index"))
|
|
|
|
|
(goto-char (match-beginning 1))
|
1995-02-15 08:36:09 +00:00
|
|
|
|
;; Here, and subsequently in this function,
|
|
|
|
|
;; we bind Info-history to nil for internal node-switches
|
|
|
|
|
;; so that we don't put junk in the history.
|
|
|
|
|
;; In the first Info-goto-node call, above, we do update the history
|
|
|
|
|
;; because that is what the user's previous node choice into it.
|
|
|
|
|
(let ((Info-history nil))
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(Info-goto-node (Info-extract-menu-node-name)))
|
|
|
|
|
(or (equal topic "")
|
|
|
|
|
(let ((matches nil)
|
|
|
|
|
(exact nil)
|
1995-02-15 08:36:09 +00:00
|
|
|
|
(Info-history nil)
|
1993-04-23 02:20:55 +00:00
|
|
|
|
found)
|
|
|
|
|
(while
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(while (re-search-forward pattern nil t)
|
|
|
|
|
(setq matches
|
|
|
|
|
(cons (list (buffer-substring (match-beginning 1)
|
|
|
|
|
(match-end 1))
|
|
|
|
|
(buffer-substring (match-beginning 2)
|
|
|
|
|
(match-end 2))
|
|
|
|
|
Info-current-node
|
|
|
|
|
(string-to-int (concat "0"
|
|
|
|
|
(buffer-substring
|
|
|
|
|
(match-beginning 3)
|
|
|
|
|
(match-end 3)))))
|
|
|
|
|
matches)))
|
|
|
|
|
(and (setq node (Info-extract-pointer "next" t))
|
|
|
|
|
(string-match "\\<Index\\>" node)))
|
|
|
|
|
(Info-goto-node node))
|
|
|
|
|
(or matches
|
|
|
|
|
(progn
|
1996-02-25 18:31:16 +00:00
|
|
|
|
(Info-goto-node orignode)
|
1996-02-12 20:57:39 +00:00
|
|
|
|
(error "No `%s' in index" topic)))
|
1993-04-23 02:20:55 +00:00
|
|
|
|
;; Here it is a feature that assoc is case-sensitive.
|
|
|
|
|
(while (setq found (assoc topic matches))
|
|
|
|
|
(setq exact (cons found exact)
|
|
|
|
|
matches (delq found matches)))
|
|
|
|
|
(setq Info-index-alternatives (nconc exact (nreverse matches)))
|
|
|
|
|
(Info-index-next 0)))))
|
|
|
|
|
|
|
|
|
|
(defun Info-index-next (num)
|
|
|
|
|
"Go to the next matching index item from the last `i' command."
|
|
|
|
|
(interactive "p")
|
|
|
|
|
(or Info-index-alternatives
|
1996-12-30 20:44:24 +00:00
|
|
|
|
(error "No previous `i' command"))
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(while (< num 0)
|
|
|
|
|
(setq num (+ num (length Info-index-alternatives))))
|
|
|
|
|
(while (> num 0)
|
|
|
|
|
(setq Info-index-alternatives
|
|
|
|
|
(nconc (cdr Info-index-alternatives)
|
|
|
|
|
(list (car Info-index-alternatives)))
|
|
|
|
|
num (1- num)))
|
|
|
|
|
(Info-goto-node (nth 1 (car Info-index-alternatives)))
|
|
|
|
|
(if (> (nth 3 (car Info-index-alternatives)) 0)
|
|
|
|
|
(forward-line (nth 3 (car Info-index-alternatives)))
|
|
|
|
|
(forward-line 3) ; don't search in headers
|
|
|
|
|
(let ((name (car (car Info-index-alternatives))))
|
1996-02-12 20:57:39 +00:00
|
|
|
|
(Info-find-index-name name)))
|
|
|
|
|
(message "Found `%s' in %s. %s"
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(car (car Info-index-alternatives))
|
|
|
|
|
(nth 2 (car Info-index-alternatives))
|
|
|
|
|
(if (cdr Info-index-alternatives)
|
|
|
|
|
"(Press `,' for more)"
|
|
|
|
|
"(Only match)")))
|
|
|
|
|
|
1996-02-12 20:57:39 +00:00
|
|
|
|
(defun Info-find-index-name (name)
|
|
|
|
|
"Move point to the place within the current node where NAME is defined."
|
|
|
|
|
(if (or (re-search-forward (format
|
|
|
|
|
"[a-zA-Z]+: %s\\( \\|$\\)"
|
|
|
|
|
(regexp-quote name)) nil t)
|
|
|
|
|
(search-forward (format "`%s'" name) nil t)
|
|
|
|
|
(and (string-match "\\`.*\\( (.*)\\)\\'" name)
|
|
|
|
|
(search-forward
|
|
|
|
|
(format "`%s'" (substring name 0 (match-beginning 1)))
|
|
|
|
|
nil t))
|
|
|
|
|
(search-forward name nil t))
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(goto-char (point-min))))
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(defun Info-undefined ()
|
|
|
|
|
"Make command be undefined in Info."
|
|
|
|
|
(interactive)
|
|
|
|
|
(ding))
|
|
|
|
|
|
|
|
|
|
(defun Info-help ()
|
|
|
|
|
"Enter the Info tutorial."
|
|
|
|
|
(interactive)
|
|
|
|
|
(delete-other-windows)
|
|
|
|
|
(Info-find-node "info"
|
|
|
|
|
(if (< (window-height) 23)
|
|
|
|
|
"Help-Small-Screen"
|
|
|
|
|
"Help")))
|
|
|
|
|
|
|
|
|
|
(defun Info-summary ()
|
|
|
|
|
"Display a brief summary of all Info commands."
|
|
|
|
|
(interactive)
|
|
|
|
|
(save-window-excursion
|
|
|
|
|
(switch-to-buffer "*Help*")
|
|
|
|
|
(erase-buffer)
|
|
|
|
|
(insert (documentation 'Info-mode))
|
1994-11-09 05:49:52 +00:00
|
|
|
|
(help-mode)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(let (ch flag)
|
|
|
|
|
(while (progn (setq flag (not (pos-visible-in-window-p (point-max))))
|
|
|
|
|
(message (if flag "Type Space to see more"
|
|
|
|
|
"Type Space to return to Info"))
|
1993-03-06 06:15:39 +00:00
|
|
|
|
(if (not (eq ?\ (setq ch (read-event))))
|
1993-01-26 01:58:16 +00:00
|
|
|
|
(progn (setq unread-command-events (list ch)) nil)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
flag))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(scroll-up)))
|
|
|
|
|
(bury-buffer "*Help*")))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-get-token (pos start all &optional errorstring)
|
|
|
|
|
"Return the token around POS,
|
|
|
|
|
POS must be somewhere inside the token
|
|
|
|
|
START is a regular expression which will match the
|
|
|
|
|
beginning of the tokens delimited string
|
|
|
|
|
ALL is a regular expression with a single
|
1996-01-04 23:42:04 +00:00
|
|
|
|
parenthesized subpattern which is the token to be
|
1991-07-13 07:49:50 +00:00
|
|
|
|
returned. E.g. '{\(.*\)}' would return any string
|
|
|
|
|
enclosed in braces around POS.
|
|
|
|
|
SIG optional fourth argument, controls action on no match
|
|
|
|
|
nil: return nil
|
|
|
|
|
t: beep
|
|
|
|
|
a string: signal an error, using that string."
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char pos)
|
1996-12-08 07:37:55 +00:00
|
|
|
|
;; First look for a match for START that goes across POS.
|
|
|
|
|
(while (and (not (bobp)) (> (point) (- pos (length start)))
|
|
|
|
|
(not (looking-at start)))
|
|
|
|
|
(forward-char -1))
|
|
|
|
|
;; If we did not find one, search back for START
|
|
|
|
|
;; (this finds only matches that end at or before POS).
|
|
|
|
|
(or (looking-at start)
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char pos)
|
|
|
|
|
(re-search-backward start (max (point-min) (- pos 200)) 'yes)))
|
1993-05-31 17:56:14 +00:00
|
|
|
|
(let (found)
|
|
|
|
|
(while (and (re-search-forward all (min (point-max) (+ pos 200)) 'yes)
|
|
|
|
|
(not (setq found (and (<= (match-beginning 0) pos)
|
|
|
|
|
(> (match-end 0) pos))))))
|
|
|
|
|
(if (and found (<= (match-beginning 0) pos)
|
|
|
|
|
(> (match-end 0) pos))
|
|
|
|
|
(buffer-substring (match-beginning 1) (match-end 1))
|
|
|
|
|
(cond ((null errorstring)
|
|
|
|
|
nil)
|
|
|
|
|
((eq errorstring t)
|
|
|
|
|
(beep)
|
|
|
|
|
nil)
|
|
|
|
|
(t
|
|
|
|
|
(error "No %s around position %d" errorstring pos)))))))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
1994-04-21 16:51:53 +00:00
|
|
|
|
(defun Info-mouse-follow-nearest-node (click)
|
1992-10-02 23:52:26 +00:00
|
|
|
|
"\\<Info-mode-map>Follow a node reference near point.
|
|
|
|
|
Like \\[Info-menu], \\[Info-follow-reference], \\[Info-next], \\[Info-prev] or \\[Info-up] command, depending on where you click.
|
1994-04-21 16:51:53 +00:00
|
|
|
|
At end of the node's text, moves to the next node, or up if none."
|
1992-10-02 23:52:26 +00:00
|
|
|
|
(interactive "e")
|
1992-10-27 10:14:08 +00:00
|
|
|
|
(let* ((start (event-start click))
|
|
|
|
|
(window (car start))
|
|
|
|
|
(pos (car (cdr start))))
|
|
|
|
|
(select-window window)
|
|
|
|
|
(goto-char pos))
|
1994-04-21 16:51:53 +00:00
|
|
|
|
(and (not (Info-try-follow-nearest-node))
|
|
|
|
|
(save-excursion (forward-line 1) (eobp))
|
1995-06-09 01:26:00 +00:00
|
|
|
|
(Info-next-preorder)))
|
1994-04-21 16:51:53 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-follow-nearest-node ()
|
|
|
|
|
"\\<Info-mode-map>Follow a node reference near point.
|
|
|
|
|
Like \\[Info-menu], \\[Info-follow-reference], \\[Info-next], \\[Info-prev] or \\[Info-up] command, depending on where point is.
|
|
|
|
|
If no reference to follow, moves to the next node, or up if none."
|
|
|
|
|
(interactive)
|
|
|
|
|
(or (Info-try-follow-nearest-node)
|
1995-06-09 01:26:00 +00:00
|
|
|
|
(Info-next-preorder)))
|
1994-04-21 16:51:53 +00:00
|
|
|
|
|
|
|
|
|
;; Common subroutine.
|
|
|
|
|
(defun Info-try-follow-nearest-node ()
|
|
|
|
|
"Follow a node reference near point. Return non-nil if successful."
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(let (node)
|
|
|
|
|
(cond
|
1994-04-21 16:51:53 +00:00
|
|
|
|
((setq node (Info-get-token (point) "\\*note[ \n]"
|
|
|
|
|
"\\*note[ \n]\\([^:]*\\):"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-follow-reference node))
|
1993-05-26 18:57:54 +00:00
|
|
|
|
((setq node (Info-get-token (point) "\\* " "\\* \\([^:]*\\)::"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-goto-node node))
|
1993-05-26 18:57:54 +00:00
|
|
|
|
((setq node (Info-get-token (point) "\\* " "\\* \\([^:]*\\):"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-menu node))
|
1993-05-26 18:57:54 +00:00
|
|
|
|
((setq node (Info-get-token (point) "Up: " "Up: \\([^,\n\t]*\\)"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-goto-node node))
|
1993-05-26 18:57:54 +00:00
|
|
|
|
((setq node (Info-get-token (point) "Next: " "Next: \\([^,\n\t]*\\)"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-goto-node node))
|
1993-05-26 18:57:54 +00:00
|
|
|
|
((setq node (Info-get-token (point) "File: " "File: \\([^,\n\t]*\\)"))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-goto-node "Top"))
|
1993-05-26 18:57:54 +00:00
|
|
|
|
((setq node (Info-get-token (point) "Prev: " "Prev: \\([^,\n\t]*\\)"))
|
1994-04-21 16:51:53 +00:00
|
|
|
|
(Info-goto-node node)))
|
|
|
|
|
node))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defvar Info-mode-map nil
|
|
|
|
|
"Keymap containing Info commands.")
|
|
|
|
|
(if Info-mode-map
|
|
|
|
|
nil
|
|
|
|
|
(setq Info-mode-map (make-keymap))
|
|
|
|
|
(suppress-keymap Info-mode-map)
|
|
|
|
|
(define-key Info-mode-map "." 'beginning-of-buffer)
|
1992-08-04 16:49:42 +00:00
|
|
|
|
(define-key Info-mode-map " " 'Info-scroll-up)
|
1994-04-21 16:51:53 +00:00
|
|
|
|
(define-key Info-mode-map "\C-m" 'Info-follow-nearest-node)
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(define-key Info-mode-map "\t" 'Info-next-reference)
|
|
|
|
|
(define-key Info-mode-map "\e\t" 'Info-prev-reference)
|
1992-12-09 17:28:25 +00:00
|
|
|
|
(define-key Info-mode-map "1" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "2" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "3" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "4" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "5" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "6" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "7" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "8" 'Info-nth-menu-item)
|
|
|
|
|
(define-key Info-mode-map "9" 'Info-nth-menu-item)
|
1992-12-09 17:30:20 +00:00
|
|
|
|
(define-key Info-mode-map "0" 'undefined)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(define-key Info-mode-map "?" 'Info-summary)
|
|
|
|
|
(define-key Info-mode-map "]" 'Info-forward-node)
|
|
|
|
|
(define-key Info-mode-map "[" 'Info-backward-node)
|
|
|
|
|
(define-key Info-mode-map "<" 'Info-top-node)
|
|
|
|
|
(define-key Info-mode-map ">" 'Info-final-node)
|
|
|
|
|
(define-key Info-mode-map "b" 'beginning-of-buffer)
|
|
|
|
|
(define-key Info-mode-map "d" 'Info-directory)
|
|
|
|
|
(define-key Info-mode-map "e" 'Info-edit)
|
|
|
|
|
(define-key Info-mode-map "f" 'Info-follow-reference)
|
|
|
|
|
(define-key Info-mode-map "g" 'Info-goto-node)
|
|
|
|
|
(define-key Info-mode-map "h" 'Info-help)
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(define-key Info-mode-map "i" 'Info-index)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(define-key Info-mode-map "l" 'Info-last)
|
|
|
|
|
(define-key Info-mode-map "m" 'Info-menu)
|
|
|
|
|
(define-key Info-mode-map "n" 'Info-next)
|
|
|
|
|
(define-key Info-mode-map "p" 'Info-prev)
|
|
|
|
|
(define-key Info-mode-map "q" 'Info-exit)
|
|
|
|
|
(define-key Info-mode-map "s" 'Info-search)
|
1994-09-14 09:17:32 +00:00
|
|
|
|
;; For consistency with Rmail.
|
|
|
|
|
(define-key Info-mode-map "\M-s" 'Info-search)
|
1993-05-30 20:04:48 +00:00
|
|
|
|
(define-key Info-mode-map "t" 'Info-top-node)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(define-key Info-mode-map "u" 'Info-up)
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(define-key Info-mode-map "," 'Info-index-next)
|
1992-08-04 17:18:16 +00:00
|
|
|
|
(define-key Info-mode-map "\177" 'Info-scroll-down)
|
1994-04-21 16:51:53 +00:00
|
|
|
|
(define-key Info-mode-map [mouse-2] 'Info-mouse-follow-nearest-node)
|
1992-02-07 21:40:34 +00:00
|
|
|
|
)
|
1996-09-01 20:43:10 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-check-pointer (item)
|
|
|
|
|
;; Non-nil if ITEM is present in this node.
|
|
|
|
|
(condition-case nil
|
|
|
|
|
(Info-extract-pointer item)
|
|
|
|
|
(error nil)))
|
|
|
|
|
|
|
|
|
|
(easy-menu-define Info-mode-menu Info-mode-map
|
|
|
|
|
"Menu for info files."
|
|
|
|
|
'("Info"
|
|
|
|
|
["Up" Info-up (Info-check-pointer "up")]
|
|
|
|
|
["Next" Info-next (Info-check-pointer "next")]
|
|
|
|
|
["Previous" Info-prev (Info-check-pointer "prev[ious]*")]
|
|
|
|
|
("Menu item" ["You should never see this" report-emacs-bug t])
|
|
|
|
|
("Reference" ["You should never see this" report-emacs-bug t])
|
|
|
|
|
["Search..." Info-search t]
|
|
|
|
|
["Goto node..." Info-goto-node t]
|
|
|
|
|
["Last" Info-last Info-history]
|
|
|
|
|
["Exit" Info-exit t]))
|
|
|
|
|
|
|
|
|
|
(defvar Info-menu-last-node nil)
|
|
|
|
|
;; Last node the menu was created for.
|
|
|
|
|
|
|
|
|
|
(defun Info-menu-update ()
|
|
|
|
|
;; Update the Info menu for the current node.
|
|
|
|
|
(condition-case nil
|
|
|
|
|
(if (or (not (eq major-mode 'Info-mode))
|
|
|
|
|
(eq Info-current-node Info-menu-last-node))
|
|
|
|
|
()
|
|
|
|
|
;; Update menu menu.
|
|
|
|
|
(let* ((Info-complete-menu-buffer (current-buffer))
|
|
|
|
|
(items (nreverse (condition-case nil
|
|
|
|
|
(Info-complete-menu-item
|
|
|
|
|
"" (lambda (e) t) t)
|
|
|
|
|
(error nil))))
|
|
|
|
|
entries current
|
|
|
|
|
(number 0))
|
|
|
|
|
(while (and items (< number 9))
|
|
|
|
|
(setq current (car items)
|
|
|
|
|
items (cdr items)
|
|
|
|
|
number (1+ number))
|
|
|
|
|
(setq entries (cons `[,current
|
|
|
|
|
(Info-menu ,current)
|
|
|
|
|
:keys ,(format "%d" number)]
|
|
|
|
|
entries)))
|
|
|
|
|
(if items
|
|
|
|
|
(setq entries (cons ["Other..." Info-menu t] entries)))
|
|
|
|
|
(or entries
|
|
|
|
|
(setq entries (list ["No menu" nil nil])))
|
|
|
|
|
(easy-menu-change '("Info") "Menu item" (nreverse entries)))
|
|
|
|
|
;; Update reference menu. Code stolen from `Info-follow-reference'.
|
|
|
|
|
(let ((items nil)
|
|
|
|
|
str i entries current
|
|
|
|
|
(number 0))
|
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(while (re-search-forward "\\*note[ \n\t]*\\([^:]*\\):" nil t)
|
|
|
|
|
(setq str (buffer-substring
|
|
|
|
|
(match-beginning 1)
|
|
|
|
|
(1- (point))))
|
|
|
|
|
(setq i 0)
|
|
|
|
|
(while (setq i (string-match "[ \n\t]+" str i))
|
|
|
|
|
(setq str (concat (substring str 0 i) " "
|
|
|
|
|
(substring str (match-end 0))))
|
|
|
|
|
(setq i (1+ i)))
|
|
|
|
|
(setq items
|
|
|
|
|
(cons str items))))
|
|
|
|
|
(while (and items (< number 9))
|
|
|
|
|
(setq current (car items)
|
|
|
|
|
items (cdr items)
|
|
|
|
|
number (1+ number))
|
|
|
|
|
(setq entries (cons `[,current
|
|
|
|
|
(Info-follow-reference ,current)
|
|
|
|
|
t]
|
|
|
|
|
entries)))
|
|
|
|
|
(if items
|
|
|
|
|
(setq entries (cons ["Other..." Info-follow-reference t]
|
|
|
|
|
entries)))
|
|
|
|
|
(or entries
|
|
|
|
|
(setq entries (list ["No references" nil nil])))
|
|
|
|
|
(easy-menu-change '("Info") "Reference" (nreverse entries)))
|
|
|
|
|
;; Update last seen node.
|
|
|
|
|
(setq Info-menu-last-node (current-buffer)))
|
|
|
|
|
;; Try to avoid entering infinite beep mode in case of errors.
|
|
|
|
|
(error (ding))))
|
|
|
|
|
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
;; Info mode is suitable only for specially formatted data.
|
|
|
|
|
(put 'info-mode 'mode-class 'special)
|
|
|
|
|
|
|
|
|
|
(defun Info-mode ()
|
|
|
|
|
"\\<Info-mode-map>
|
|
|
|
|
Info mode provides commands for browsing through the Info documentation tree.
|
|
|
|
|
Documentation in Info is divided into \"nodes\", each of which discusses
|
|
|
|
|
one topic and contains references to other nodes which discuss related
|
|
|
|
|
topics. Info has commands to follow the references and show you other nodes.
|
|
|
|
|
|
|
|
|
|
\\[Info-help] Invoke the Info tutorial.
|
|
|
|
|
|
|
|
|
|
Selecting other nodes:
|
1994-08-18 01:08:03 +00:00
|
|
|
|
\\[Info-mouse-follow-nearest-node]
|
|
|
|
|
Follow a node reference you click on.
|
|
|
|
|
This works with menu items, cross references, and
|
|
|
|
|
the \"next\", \"previous\" and \"up\", depending on where you click.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
\\[Info-next] Move to the \"next\" node of this node.
|
1993-05-26 18:57:54 +00:00
|
|
|
|
\\[Info-prev] Move to the \"previous\" node of this node.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
\\[Info-up] Move \"up\" from this node.
|
|
|
|
|
\\[Info-menu] Pick menu item specified by name (or abbreviation).
|
|
|
|
|
Picking a menu item causes another node to be selected.
|
1992-02-07 21:40:34 +00:00
|
|
|
|
\\[Info-directory] Go to the Info directory node.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
\\[Info-follow-reference] Follow a cross reference. Reads name of reference.
|
|
|
|
|
\\[Info-last] Move to the last node you were at.
|
1993-04-23 02:20:55 +00:00
|
|
|
|
\\[Info-index] Look up a topic in this file's Index and move to that node.
|
|
|
|
|
\\[Info-index-next] (comma) Move to the next match from a previous `i' command.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
Moving within a node:
|
1993-11-16 06:52:12 +00:00
|
|
|
|
\\[Info-scroll-up] Normally, scroll forward a full screen. If the end of the buffer is
|
1992-08-04 17:18:16 +00:00
|
|
|
|
already visible, try to go to the next menu entry, or up if there is none.
|
1993-11-16 06:52:12 +00:00
|
|
|
|
\\[Info-scroll-down] Normally, scroll backward. If the beginning of the buffer is
|
1992-08-04 17:18:16 +00:00
|
|
|
|
already visible, try to go to the previous menu entry, or up if there is none.
|
|
|
|
|
\\[beginning-of-buffer] Go to beginning of node.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
Advanced commands:
|
|
|
|
|
\\[Info-exit] Quit Info: reselect previously selected buffer.
|
|
|
|
|
\\[Info-edit] Edit contents of selected node.
|
|
|
|
|
1 Pick first item in node's menu.
|
|
|
|
|
2, 3, 4, 5 Pick second ... fifth item in node's menu.
|
|
|
|
|
\\[Info-goto-node] Move to node specified by name.
|
|
|
|
|
You may include a filename as well, as (FILENAME)NODENAME.
|
1993-08-02 04:22:12 +00:00
|
|
|
|
\\[universal-argument] \\[info] Move to new Info file with completion.
|
1991-07-13 07:49:50 +00:00
|
|
|
|
\\[Info-search] Search through this Info file for specified regexp,
|
1992-08-04 17:18:16 +00:00
|
|
|
|
and select the node in which the next occurrence is found.
|
1993-08-02 04:22:12 +00:00
|
|
|
|
\\[Info-next-reference] Move cursor to next cross-reference or menu item.
|
|
|
|
|
\\[Info-prev-reference] Move cursor to previous cross-reference or menu item."
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(kill-all-local-variables)
|
|
|
|
|
(setq major-mode 'Info-mode)
|
|
|
|
|
(setq mode-name "Info")
|
1996-12-12 23:00:31 +00:00
|
|
|
|
(setq tab-width 8)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(use-local-map Info-mode-map)
|
1996-09-01 20:43:10 +00:00
|
|
|
|
(make-local-hook 'activate-menubar-hook)
|
|
|
|
|
(add-hook 'activate-menubar-hook 'Info-menu-update nil t)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(set-syntax-table text-mode-syntax-table)
|
|
|
|
|
(setq local-abbrev-table text-mode-abbrev-table)
|
|
|
|
|
(setq case-fold-search t)
|
|
|
|
|
(setq buffer-read-only t)
|
|
|
|
|
(make-local-variable 'Info-current-file)
|
|
|
|
|
(make-local-variable 'Info-current-subfile)
|
|
|
|
|
(make-local-variable 'Info-current-node)
|
|
|
|
|
(make-local-variable 'Info-tag-table-marker)
|
1997-02-08 18:34:21 +00:00
|
|
|
|
(setq Info-tag-table-marker (make-marker))
|
|
|
|
|
(make-local-variable 'Info-tag-table-buffer)
|
|
|
|
|
(setq Info-tag-table-buffer nil)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(make-local-variable 'Info-history)
|
1993-04-23 02:20:55 +00:00
|
|
|
|
(make-local-variable 'Info-index-alternatives)
|
1996-11-19 06:59:17 +00:00
|
|
|
|
(if (memq (framep (selected-frame)) '(x pc w32))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(progn
|
|
|
|
|
(make-face 'info-node)
|
|
|
|
|
(make-face 'info-menu-5)
|
|
|
|
|
(make-face 'info-xref)
|
|
|
|
|
(or (face-differs-from-default-p 'info-node)
|
|
|
|
|
(if (face-differs-from-default-p 'bold-italic)
|
|
|
|
|
(copy-face 'bold-italic 'info-node)
|
|
|
|
|
(copy-face 'bold 'info-node)))
|
|
|
|
|
(or (face-differs-from-default-p 'info-menu-5)
|
|
|
|
|
(set-face-underline-p 'info-menu-5 t))
|
|
|
|
|
(or (face-differs-from-default-p 'info-xref)
|
|
|
|
|
(copy-face 'bold 'info-xref)))
|
|
|
|
|
(setq Info-fontify nil))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(Info-set-mode-line)
|
|
|
|
|
(run-hooks 'Info-mode-hook))
|
|
|
|
|
|
|
|
|
|
(defvar Info-edit-map nil
|
|
|
|
|
"Local keymap used within `e' command of Info.")
|
|
|
|
|
(if Info-edit-map
|
|
|
|
|
nil
|
|
|
|
|
(setq Info-edit-map (nconc (make-sparse-keymap) text-mode-map))
|
|
|
|
|
(define-key Info-edit-map "\C-c\C-c" 'Info-cease-edit))
|
|
|
|
|
|
|
|
|
|
;; Info-edit mode is suitable only for specially formatted data.
|
|
|
|
|
(put 'info-edit-mode 'mode-class 'special)
|
|
|
|
|
|
|
|
|
|
(defun Info-edit-mode ()
|
|
|
|
|
"Major mode for editing the contents of an Info node.
|
1992-10-25 21:14:16 +00:00
|
|
|
|
Like text mode with the addition of `Info-cease-edit'
|
1991-07-13 07:49:50 +00:00
|
|
|
|
which returns to Info mode for browsing.
|
|
|
|
|
\\{Info-edit-map}"
|
|
|
|
|
(use-local-map Info-edit-map)
|
|
|
|
|
(setq major-mode 'Info-edit-mode)
|
|
|
|
|
(setq mode-name "Info Edit")
|
|
|
|
|
(kill-local-variable 'mode-line-buffer-identification)
|
|
|
|
|
(setq buffer-read-only nil)
|
1995-04-25 22:28:58 +00:00
|
|
|
|
(force-mode-line-update)
|
1994-09-16 23:31:10 +00:00
|
|
|
|
(buffer-enable-undo (current-buffer))
|
|
|
|
|
(run-hooks 'Info-edit-mode-hook))
|
|
|
|
|
|
|
|
|
|
(defun Info-edit ()
|
|
|
|
|
"Edit the contents of this Info node.
|
|
|
|
|
Allowed only if variable `Info-enable-edit' is non-nil."
|
|
|
|
|
(interactive)
|
|
|
|
|
(or Info-enable-edit
|
|
|
|
|
(error "Editing info nodes is not enabled"))
|
|
|
|
|
(Info-edit-mode)
|
1996-01-25 00:54:59 +00:00
|
|
|
|
(message "%s" (substitute-command-keys
|
1994-09-16 23:31:10 +00:00
|
|
|
|
"Editing: Type \\<Info-edit-map>\\[Info-cease-edit] to return to info")))
|
1991-07-13 07:49:50 +00:00
|
|
|
|
|
|
|
|
|
(defun Info-cease-edit ()
|
|
|
|
|
"Finish editing Info node; switch back to Info proper."
|
|
|
|
|
(interactive)
|
|
|
|
|
;; Do this first, so nothing has changed if user C-g's at query.
|
|
|
|
|
(and (buffer-modified-p)
|
|
|
|
|
(y-or-n-p "Save the file? ")
|
|
|
|
|
(save-buffer))
|
|
|
|
|
(use-local-map Info-mode-map)
|
|
|
|
|
(setq major-mode 'Info-mode)
|
|
|
|
|
(setq mode-name "Info")
|
|
|
|
|
(Info-set-mode-line)
|
|
|
|
|
(setq buffer-read-only t)
|
1995-04-25 22:28:58 +00:00
|
|
|
|
(force-mode-line-update)
|
1991-07-13 07:49:50 +00:00
|
|
|
|
(and (marker-position Info-tag-table-marker)
|
|
|
|
|
(buffer-modified-p)
|
|
|
|
|
(message "Tags may have changed. Use Info-tagify if necessary")))
|
1991-07-28 00:21:00 +00:00
|
|
|
|
|
1995-08-19 05:03:12 +00:00
|
|
|
|
(defvar Info-file-list-for-emacs
|
|
|
|
|
'("ediff" "forms" "gnus" "info" ("mh" . "mh-e") "sc")
|
|
|
|
|
"List of Info files that describe Emacs commands.
|
|
|
|
|
An element can be a file name, or a list of the form (PREFIX . FILE)
|
|
|
|
|
where PREFIX is a name prefix and FILE is the file to look in.
|
|
|
|
|
If the element is just a file name, the file name also serves as the prefix.")
|
|
|
|
|
|
1991-07-28 00:21:00 +00:00
|
|
|
|
(defun Info-find-emacs-command-nodes (command)
|
1995-08-19 05:03:12 +00:00
|
|
|
|
"Return a list of locations documenting COMMAND.
|
1995-08-19 16:54:27 +00:00
|
|
|
|
The `info-file' property of COMMAND says which Info manual to search.
|
|
|
|
|
If COMMAND has no property, the variable `Info-file-list-for-emacs'
|
|
|
|
|
defines heuristics for which Info manual to try.
|
1991-07-28 00:21:00 +00:00
|
|
|
|
The locations are of the format used in Info-history, i.e.
|
|
|
|
|
\(FILENAME NODENAME BUFFERPOS\)."
|
|
|
|
|
(let ((where '())
|
|
|
|
|
(cmd-desc (concat "^\\* " (regexp-quote (symbol-name command))
|
1995-08-19 05:03:12 +00:00
|
|
|
|
":\\s *\\(.*\\)\\.$"))
|
|
|
|
|
(info-file "emacs")) ;default
|
|
|
|
|
;; Determine which info file this command is documented in.
|
|
|
|
|
(if (get command 'info-file)
|
|
|
|
|
(setq info-file (get command 'info-file))
|
|
|
|
|
;; If it doesn't say explicitly, test its name against
|
|
|
|
|
;; various prefixes that we know.
|
|
|
|
|
(let ((file-list Info-file-list-for-emacs))
|
|
|
|
|
(while file-list
|
|
|
|
|
(let* ((elt (car file-list))
|
|
|
|
|
(name (if (consp elt)
|
|
|
|
|
(car elt)
|
|
|
|
|
elt))
|
|
|
|
|
(file (if (consp elt) (cdr elt) elt))
|
1995-08-19 16:54:27 +00:00
|
|
|
|
(regexp (concat "\\`" (regexp-quote name)
|
1995-08-19 05:03:12 +00:00
|
|
|
|
"\\(\\'\\|-\\)")))
|
|
|
|
|
(if (string-match regexp (symbol-name command))
|
|
|
|
|
(setq info-file file file-list nil))
|
|
|
|
|
(setq file-list (cdr file-list))))))
|
1991-07-28 00:21:00 +00:00
|
|
|
|
(save-excursion
|
1995-08-19 05:03:12 +00:00
|
|
|
|
(condition-case nil
|
|
|
|
|
(Info-find-node info-file "Command Index")
|
|
|
|
|
;; Some manuals may not have a separate Command Index node,
|
|
|
|
|
;; so try just Index instead.
|
|
|
|
|
(error
|
|
|
|
|
(Info-find-node info-file "Index")))
|
1991-07-28 00:21:00 +00:00
|
|
|
|
;; Take the index node off the Info history.
|
|
|
|
|
(setq Info-history (cdr Info-history))
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(while (re-search-backward cmd-desc nil t)
|
|
|
|
|
(setq where (cons (list Info-current-file
|
|
|
|
|
(buffer-substring
|
|
|
|
|
(match-beginning 1)
|
|
|
|
|
(match-end 1))
|
|
|
|
|
0)
|
|
|
|
|
where)))
|
|
|
|
|
where)))
|
|
|
|
|
|
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun Info-goto-emacs-command-node (command)
|
1993-08-06 20:29:23 +00:00
|
|
|
|
"Go to the Info node in the Emacs manual for command COMMAND.
|
1995-08-19 05:03:12 +00:00
|
|
|
|
The command is found by looking up in Emacs manual's Command Index
|
1995-08-19 16:54:27 +00:00
|
|
|
|
or in another manual found via COMMAND's `info-file' property or
|
|
|
|
|
the variable `Info-file-list-for-emacs'."
|
1991-07-28 00:21:00 +00:00
|
|
|
|
(interactive "CFind documentation for command: ")
|
|
|
|
|
(or (commandp command)
|
|
|
|
|
(signal 'wrong-type-argument (list 'commandp command)))
|
|
|
|
|
(let ((where (Info-find-emacs-command-nodes command)))
|
|
|
|
|
(if where
|
|
|
|
|
(let ((num-matches (length where)))
|
|
|
|
|
;; Get Info running, and pop to it in another window.
|
|
|
|
|
(save-window-excursion
|
|
|
|
|
(info))
|
1997-02-08 18:34:21 +00:00
|
|
|
|
;; FIXME It would be cool if this could use a buffer other
|
|
|
|
|
;; than *info*.
|
1991-07-28 00:21:00 +00:00
|
|
|
|
(pop-to-buffer "*info*")
|
|
|
|
|
(Info-find-node (car (car where))
|
|
|
|
|
(car (cdr (car where))))
|
|
|
|
|
(if (> num-matches 1)
|
|
|
|
|
(progn
|
|
|
|
|
;; Info-find-node already pushed (car where) onto
|
|
|
|
|
;; Info-history. Put the other nodes that were found on
|
|
|
|
|
;; the history.
|
|
|
|
|
(setq Info-history (nconc (cdr where) Info-history))
|
1996-01-25 00:54:59 +00:00
|
|
|
|
(message "Found %d other entr%s. Use %s to see %s."
|
1994-02-24 03:25:46 +00:00
|
|
|
|
(1- num-matches)
|
|
|
|
|
(if (> num-matches 2) "ies" "y")
|
1996-01-25 00:54:59 +00:00
|
|
|
|
(substitute-command-keys "\\[Info-last]")
|
1994-02-24 03:25:46 +00:00
|
|
|
|
(if (> num-matches 2) "them" "it")))))
|
1996-01-25 06:05:40 +00:00
|
|
|
|
(error "Couldn't find documentation for %s" command))))
|
1991-07-28 00:21:00 +00:00
|
|
|
|
|
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun Info-goto-emacs-key-command-node (key)
|
|
|
|
|
"Go to the Info node in the Emacs manual the command bound to KEY, a string.
|
1993-08-06 20:29:23 +00:00
|
|
|
|
Interactively, if the binding is execute-extended-command, a command is read.
|
1995-08-19 05:03:12 +00:00
|
|
|
|
The command is found by looking up in Emacs manual's Command Index
|
1995-08-19 16:54:27 +00:00
|
|
|
|
or in another manual found via COMMAND's `info-file' property or
|
|
|
|
|
the variable `Info-file-list-for-emacs'."
|
1991-07-28 00:21:00 +00:00
|
|
|
|
(interactive "kFind documentation for key:")
|
|
|
|
|
(let ((command (key-binding key)))
|
|
|
|
|
(cond ((null command)
|
1992-10-27 10:14:08 +00:00
|
|
|
|
(message "%s is undefined" (key-description key)))
|
1991-07-28 00:21:00 +00:00
|
|
|
|
((and (interactive-p)
|
|
|
|
|
(eq command 'execute-extended-command))
|
|
|
|
|
(Info-goto-emacs-command-node
|
|
|
|
|
(read-command "Find documentation for command: ")))
|
|
|
|
|
(t
|
|
|
|
|
(Info-goto-emacs-command-node command)))))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
|
1995-09-25 18:58:51 +00:00
|
|
|
|
(defvar Info-title-face-alist
|
|
|
|
|
'((?* bold underline)
|
|
|
|
|
(?= bold-italic underline)
|
|
|
|
|
(?- italic underline))
|
|
|
|
|
"*Alist of face or list of faces to use for pseudo-underlined titles.
|
|
|
|
|
The alist key is the character the title is underlined with (?*, ?= or ?-).")
|
|
|
|
|
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(defun Info-fontify-node ()
|
|
|
|
|
(save-excursion
|
|
|
|
|
(let ((buffer-read-only nil))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(if (looking-at "^File: [^,: \t]+,?[ \t]+")
|
|
|
|
|
(progn
|
|
|
|
|
(goto-char (match-end 0))
|
|
|
|
|
(while
|
|
|
|
|
(looking-at "[ \t]*[^:, \t\n]+:[ \t]+\\([^:,\t\n]+\\),?")
|
|
|
|
|
(goto-char (match-end 0))
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
1994-04-01 10:10:24 +00:00
|
|
|
|
'face 'info-xref)
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
|
|
|
|
'mouse-face 'highlight))))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(goto-char (point-min))
|
1995-09-25 18:58:51 +00:00
|
|
|
|
(while (re-search-forward "\n\\([^ \t\n].+\\)\n\\(\\*+\\|=+\\|-+\\)$"
|
|
|
|
|
nil t)
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
|
|
|
|
'face
|
1995-09-25 19:50:22 +00:00
|
|
|
|
(cdr (assq (preceding-char) Info-title-face-alist)))
|
1995-09-25 18:58:51 +00:00
|
|
|
|
(put-text-property (match-end 1) (match-end 2)
|
|
|
|
|
'invisible t))
|
|
|
|
|
(goto-char (point-min))
|
1994-06-12 14:37:21 +00:00
|
|
|
|
(while (re-search-forward "\\*Note[ \n\t]+\\([^:]*\\):" nil t)
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(if (= (char-after (1- (match-beginning 0))) ?\") ; hack
|
|
|
|
|
nil
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
1994-04-01 10:10:24 +00:00
|
|
|
|
'face 'info-xref)
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
|
|
|
|
'mouse-face 'highlight)))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(if (and (search-forward "\n* Menu:" nil t)
|
|
|
|
|
(not (string-match "\\<Index\\>" Info-current-node))
|
|
|
|
|
;; Don't take time to annotate huge menus
|
1994-07-11 00:55:56 +00:00
|
|
|
|
(< (- (point-max) (point)) Info-fontify-maximum-menu-size))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(let ((n 0))
|
|
|
|
|
(while (re-search-forward "^\\* \\([^:\t\n]*\\):" nil t)
|
|
|
|
|
(setq n (1+ n))
|
|
|
|
|
(if (memq n '(5 9)) ; visual aids to help with 1-9 keys
|
|
|
|
|
(put-text-property (match-beginning 0)
|
|
|
|
|
(1+ (match-beginning 0))
|
|
|
|
|
'face 'info-menu-5))
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
1994-04-01 10:10:24 +00:00
|
|
|
|
'face 'info-node)
|
|
|
|
|
(put-text-property (match-beginning 1) (match-end 1)
|
|
|
|
|
'mouse-face 'highlight))))
|
1993-08-02 04:22:12 +00:00
|
|
|
|
(set-buffer-modified-p nil))))
|
1997-02-08 18:34:21 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;; When an Info buffer is killed, make sure the associated tags buffer
|
|
|
|
|
;; is killed too.
|
|
|
|
|
(defun Info-kill-buffer ()
|
|
|
|
|
(and (eq major-mode 'Info-mode)
|
|
|
|
|
Info-tag-table-buffer
|
|
|
|
|
(kill-buffer Info-tag-table-buffer)))
|
|
|
|
|
|
|
|
|
|
(add-hook 'kill-buffer-hook 'Info-kill-buffer)
|
|
|
|
|
|
1992-03-16 20:39:07 +00:00
|
|
|
|
|
|
|
|
|
(provide 'info)
|
|
|
|
|
|
1992-05-30 23:12:08 +00:00
|
|
|
|
;;; info.el ends here
|