mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-11-27 07:37:33 +00:00
1075 lines
37 KiB
EmacsLisp
1075 lines
37 KiB
EmacsLisp
;;; info.el --- info package for Emacs.
|
||
|
||
;; Copyright (C) 1985, 1986 Free Software Foundation, Inc.
|
||
|
||
;; Maintainer: FSF
|
||
;; Keywords: help
|
||
|
||
;; 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
|
||
;; the Free Software Foundation; either version 2, or (at your option)
|
||
;; 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
|
||
;; along with GNU Emacs; see the file COPYING. If not, write to
|
||
;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
|
||
|
||
;;; Commentary:
|
||
|
||
;;; Note that nowadays we expect info files to be made using makeinfo.
|
||
|
||
;;; Code:
|
||
|
||
(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
|
||
"*Non-nil means the \\<info-mode-map>\\[Info-edit] command in Info can edit the current node.
|
||
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.")
|
||
|
||
(defvar Info-enable-active-nodes t
|
||
"Non-nil allows Info to execute Lisp code associated with nodes.
|
||
The Lisp code is executed when the node is selected.")
|
||
|
||
(defvar Info-default-directory-list nil
|
||
"List of default directories to search for Info documentation files.
|
||
This value is used as the default for `Info-directory-list'. It is set
|
||
in paths.el.")
|
||
|
||
(defvar Info-directory-list nil
|
||
"List of directories to search for Info documentation files.
|
||
nil means not yet initialized. In this case, Info uses the environment
|
||
variable INFODIR to initialize it, or `Info-default-directory-list'
|
||
if there is no INFODIR variable in the environment.")
|
||
|
||
(defvar Info-current-file nil
|
||
"Info file that Info is now looking at, or nil.")
|
||
|
||
(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.")
|
||
|
||
(defvar Info-tag-table-marker (make-marker)
|
||
"Marker pointing at beginning of current Info file's tag table.
|
||
Marker points nowhere if file has no tag table.")
|
||
|
||
;;;###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
|
||
to read a file name from the minibuffer."
|
||
(interactive (if current-prefix-arg
|
||
(list (read-file-name "Info file name: " nil nil t))))
|
||
(or Info-directory-list
|
||
(setq Info-directory-list
|
||
(let ((path (getenv "INFOPATH")))
|
||
(if path
|
||
(let ((list nil)
|
||
idx)
|
||
(while (> (length path) 0)
|
||
(setq idx (or (string-match ":" path) (length path))
|
||
list (cons (substring path 0 idx) list)
|
||
path (substring path (min (1+ idx)
|
||
(length path)))))
|
||
(nreverse list))
|
||
Info-default-directory-list))))
|
||
(if file
|
||
(Info-goto-node (concat "(" file ")"))
|
||
(if (get-buffer "*info*")
|
||
(switch-to-buffer "*info*")
|
||
(Info-directory))))
|
||
|
||
;; 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))
|
||
(let ((dirs (if (string-match "^\\./" filename)
|
||
;; If specified name starts with `./'
|
||
;; then just try current directory.
|
||
'("./")
|
||
Info-directory-list)))
|
||
;; 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.
|
||
;; Try downcasing, appending `.info', or both.
|
||
(cond ((file-exists-p temp)
|
||
(setq found temp))
|
||
((file-exists-p temp-downcase)
|
||
(setq found temp-downcase))
|
||
((file-exists-p (concat temp ".info"))
|
||
(setq found (concat temp ".info")))
|
||
((file-exists-p (concat temp-downcase ".info"))
|
||
(setq found (concat temp-downcase ".info"))))
|
||
(setq dirs (cdr dirs))))
|
||
(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.
|
||
(switch-to-buffer "*info*")
|
||
(buffer-flush-undo (current-buffer))
|
||
(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
|
||
buffer-file-name nil)
|
||
(erase-buffer)
|
||
(insert-file-contents filename t)
|
||
(set-buffer-modified-p nil)
|
||
(setq default-directory (file-name-directory filename))
|
||
;; See whether file has a tag table. Record the location if yes.
|
||
(set-marker Info-tag-table-marker nil)
|
||
(goto-char (point-max))
|
||
(forward-line -8)
|
||
(or (equal nodename "*")
|
||
(not (search-forward "\^_\nEnd tag table\n" nil t))
|
||
(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.
|
||
(save-excursion
|
||
(let ((buf (current-buffer)))
|
||
(set-buffer (get-buffer-create " *info tag table*"))
|
||
(buffer-flush-undo (current-buffer))
|
||
(setq case-fold-search t)
|
||
(erase-buffer)
|
||
(insert-buffer-substring buf)
|
||
(set-marker Info-tag-table-marker
|
||
(match-end 0))))
|
||
(set-marker Info-tag-table-marker pos))))
|
||
(setq Info-current-file
|
||
(file-name-sans-versions buffer-file-name))))
|
||
(if (equal nodename "*")
|
||
(progn (setq Info-current-node nodename)
|
||
(Info-set-mode-line))
|
||
;; Search file for a suitable node.
|
||
(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.
|
||
(if (marker-position Info-tag-table-marker)
|
||
(save-excursion
|
||
(set-buffer (marker-buffer Info-tag-table-marker))
|
||
(goto-char Info-tag-table-marker)
|
||
(if (re-search-forward regexp nil t)
|
||
(progn
|
||
(setq guesspos (read (current-buffer)))
|
||
;; If this is an indirect file,
|
||
;; determine which file really holds this node
|
||
;; and read it in.
|
||
(if (not (eq (current-buffer) (get-buffer "*info*")))
|
||
(setq guesspos
|
||
(Info-read-subfile guesspos))))
|
||
(error "No such node: \"%s\"" nodename))))
|
||
(goto-char (max (point-min) (- guesspos 1000)))
|
||
;; Now search from our advised position (or from beg of buffer)
|
||
;; to find the actual node.
|
||
(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.
|
||
(or Info-current-node no-going-back
|
||
(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)))
|
||
|
||
(defun Info-read-subfile (nodepos)
|
||
(set-buffer (marker-buffer Info-tag-table-marker))
|
||
(goto-char (point-min))
|
||
(search-forward "\n\^_")
|
||
(let (lastfilepos
|
||
lastfilename)
|
||
(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))))
|
||
(set-buffer (get-buffer "*info*"))
|
||
(or (equal Info-current-subfile lastfilename)
|
||
(let ((buffer-read-only nil))
|
||
(setq buffer-file-name nil)
|
||
(widen)
|
||
(erase-buffer)
|
||
(insert-file-contents lastfilename)
|
||
(set-buffer-modified-p nil)
|
||
(setq Info-current-subfile lastfilename)))
|
||
(goto-char (point-min))
|
||
(search-forward "\n\^_")
|
||
(+ (- nodepos lastfilepos) (point))))
|
||
|
||
;; 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
|
||
(buffer-substring (point)
|
||
(progn
|
||
(skip-chars-forward "^,\t\n")
|
||
(point))))
|
||
(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)))
|
||
(if Info-enable-active-nodes (eval active-expression)))))
|
||
|
||
(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."
|
||
(interactive "sGoto node: ")
|
||
(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))))
|
||
(Info-find-node (if (equal filename "") nil filename)
|
||
(if (equal nodename "") "Top" nodename))))
|
||
|
||
(defun Info-restore-point (hl)
|
||
"If this node has been visited, restore the point value when we left."
|
||
(if hl
|
||
(if (and (equal (nth 0 (car hl)) Info-current-file)
|
||
(equal (nth 1 (car hl)) Info-current-node))
|
||
(goto-char (nth 2 (car hl)))
|
||
(Info-restore-point (cdr hl)))))
|
||
|
||
(defun Info-restore-point (hl)
|
||
"If this node has been visited, restore the point value when we left."
|
||
(if hl
|
||
(if (and (equal (nth 0 (car hl)) Info-current-file)
|
||
(equal (nth 1 (car hl)) Info-current-node))
|
||
(goto-char (nth 2 (car hl)))
|
||
(Info-restore-point (cdr hl)))))
|
||
|
||
(defvar Info-last-search nil
|
||
"Default regexp for \\<info-mode-map>\\[Info-search] command to search for.")
|
||
|
||
(defun Info-search (regexp)
|
||
"Search for REGEXP, starting from point, and select node it's found in."
|
||
(interactive "sSearch (regexp): ")
|
||
(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))
|
||
(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 ()))
|
||
(set-buffer (marker-buffer Info-tag-table-marker))
|
||
(goto-char (point-min))
|
||
(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)))
|
||
(while list
|
||
(message "Searching subfile %s..." (cdr (car list)))
|
||
(Info-read-subfile (car (car list)))
|
||
(setq list (cdr list))
|
||
(goto-char (point-min))
|
||
(if (re-search-forward regexp nil t)
|
||
(setq found (point) list ())))
|
||
(if found
|
||
(message "")
|
||
(signal 'search-failed (list regexp))))
|
||
(if (not found)
|
||
(progn (Info-read-subfile opoint)
|
||
(goto-char opoint)
|
||
(Info-select-node)))))
|
||
(widen)
|
||
(goto-char found)
|
||
(Info-select-node)
|
||
(or (and (equal onode Info-current-node)
|
||
(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
|
||
(error (concat "Node has no " (capitalize (or errorname name))))))))
|
||
|
||
(defun Info-following-node-name (&optional allowedchars)
|
||
(skip-chars-forward " \t")
|
||
(buffer-substring
|
||
(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)
|
||
(Info-goto-node (Info-extract-pointer "up"))
|
||
(Info-restore-point Info-history))
|
||
|
||
(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)
|
||
completions default (start-point (point)) str i)
|
||
(save-excursion
|
||
(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)
|
||
(< (match-beginning 0) start-point)
|
||
(<= start-point (point))
|
||
(setq default t))
|
||
(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))
|
||
(setq completions
|
||
(cons (cons str nil)
|
||
completions))))
|
||
(if completions
|
||
(list (completing-read (if default
|
||
(concat "Follow reference named: ("
|
||
default ") ")
|
||
"Follow reference named: ")
|
||
completions default t))
|
||
(error "No cross-references in this node"))))
|
||
(let (target beg i (str (concat "\\*note " footnotename)))
|
||
(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 ":")
|
||
(buffer-substring beg (1- (point)))
|
||
(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 ?\ ))
|
||
str))
|
||
|
||
(defun Info-menu-item-sequence (list)
|
||
(while list
|
||
(Info-menu-item (car list))
|
||
(setq list (cdr list))))
|
||
|
||
(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))
|
||
(last nil))
|
||
(save-excursion
|
||
(goto-char (point-min))
|
||
(if (not (search-forward "\n* menu:" nil t))
|
||
(error "No menu in this node"))
|
||
(while (re-search-forward
|
||
"\n\\* \\([^:\t\n]*\\):" nil t)
|
||
(if (and (null default)
|
||
(prog1 (if last (< last p) nil)
|
||
(setq last (match-beginning 0)))
|
||
(<= p last))
|
||
(setq default (car (car completions))))
|
||
(setq completions (cons (cons (buffer-substring
|
||
(match-beginning 1)
|
||
(match-end 1))
|
||
(match-beginning 1))
|
||
completions)))
|
||
(if (and (null default) last
|
||
(< last p)
|
||
(<= p (progn (end-of-line) (point))))
|
||
(setq default (car (car completions)))))
|
||
(let ((item nil))
|
||
(while (null item)
|
||
(setq item (let ((completion-ignore-case t))
|
||
(completing-read (if default
|
||
(format "Menu item (default %s): "
|
||
default)
|
||
"Menu item: ")
|
||
completions nil t)))
|
||
;; 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
|
||
(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"))
|
||
(or (re-search-forward (concat "\n* " menu-item ":") nil t)
|
||
(re-search-forward (concat "\n* " menu-item) nil t)
|
||
(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)))
|
||
|
||
(defun Info-first-menu-item ()
|
||
"Go to the node of the first menu item."
|
||
(interactive)
|
||
(Info-goto-node (Info-extract-menu-counting 1)))
|
||
|
||
(defun Info-second-menu-item ()
|
||
"Go to the node of the second menu item."
|
||
(interactive)
|
||
(Info-goto-node (Info-extract-menu-counting 2)))
|
||
|
||
(defun Info-third-menu-item ()
|
||
"Go to the node of the third menu item."
|
||
(interactive)
|
||
(Info-goto-node (Info-extract-menu-counting 3)))
|
||
|
||
(defun Info-fourth-menu-item ()
|
||
"Go to the node of the fourth menu item."
|
||
(interactive)
|
||
(Info-goto-node (Info-extract-menu-counting 4)))
|
||
|
||
(defun Info-fifth-menu-item ()
|
||
"Go to the node of the fifth menu item."
|
||
(interactive)
|
||
(Info-goto-node (Info-extract-menu-counting 5)))
|
||
|
||
(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)))
|
||
(Info-first-menu-item)
|
||
t)
|
||
((save-excursion (search-backward "next:" nil t))
|
||
(Info-next)
|
||
t)
|
||
((and (save-excursion (search-backward "up:" nil t))
|
||
(not (equal (downcase (Info-extract-pointer "up")) "top")))
|
||
(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)
|
||
(equal (downcase prevnode) (downcase upnode))))
|
||
(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)
|
||
(switch-to-buffer (prog1 (other-buffer (current-buffer))
|
||
(bury-buffer (current-buffer)))))
|
||
|
||
(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)
|
||
(search-backward "\n* menu:" nil t)
|
||
(or (search-backward "\n* " nil t)
|
||
(error "No previous items in menu"))
|
||
(Info-goto-node (Info-extract-menu-node-name))))
|
||
|
||
(defmacro no-error (&rest body)
|
||
(list 'condition-case nil (cons 'progn (append body '(t))) '(error nil)))
|
||
|
||
(defun Info-next-preorder ()
|
||
"Go to the next node, popping up a level if there is none."
|
||
(interactive)
|
||
(cond ((no-error (Info-next-menu-item)) )
|
||
((no-error (Info-up)) (forward-line 1))
|
||
(t (error "No more nodes"))))
|
||
|
||
(defun Info-last-preorder ()
|
||
"Go to the last node, popping up a level if there is none."
|
||
(interactive)
|
||
(cond ((no-error (Info-last-menu-item)) )
|
||
((no-error (Info-up)) (forward-line -1))
|
||
(t (error "No previous nodes"))))
|
||
|
||
(defun Info-scroll-up ()
|
||
"Read the next screen. If end of buffer is visible, go to next entry."
|
||
(interactive)
|
||
(if (pos-visible-in-window-p (point-max))
|
||
(Info-next-preorder)
|
||
(scroll-up))
|
||
)
|
||
|
||
(defun Info-scroll-down ()
|
||
"Read the previous screen. If start of buffer is visible, go to last entry."
|
||
(interactive)
|
||
(if (pos-visible-in-window-p (point-min))
|
||
(Info-last-preorder)
|
||
(scroll-down))
|
||
)
|
||
|
||
(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))
|
||
(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"))
|
||
(if (/= ?\ (setq ch (read-char)))
|
||
(progn (setq unread-command-char ch) nil)
|
||
flag))
|
||
(scroll-up)))))
|
||
|
||
(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
|
||
parenthized subpattern which is the token to be
|
||
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)
|
||
(re-search-backward start (max (point-min) (- pos 200)) 'yes)
|
||
(while (and (re-search-forward all (min (point-max) (+ pos 200)) 'yes)
|
||
(not (and (<= (match-beginning 0) pos)
|
||
(> (match-end 0) pos)))))
|
||
(if (and (<= (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))))))
|
||
|
||
(defun Info-follow-nearest-node (click)
|
||
"\\<Info-mode-map>Follow a node reference near point. Like \\[Info-menu], \\Info-follow-reference], \\[Info-next], \\[Info-previous] or \\Info-up] command.
|
||
At end of the node's text, moves to the next node."
|
||
(interactive "K")
|
||
(let* ((relative-coordinates (coordinates-in-window-p (mouse-coords click)
|
||
(selected-window)))
|
||
(rel-x (car relative-coordinates))
|
||
(rel-y (cdr relative-coordinates)))
|
||
(move-to-window-line rel-y)
|
||
(move-to-column rel-x))
|
||
(let (node)
|
||
(cond
|
||
((setq node (Info-get-token (point) "\\*note " "\\*note \\([^:]*\\):" t))
|
||
(Info-follow-reference node))
|
||
((setq node (Info-get-token (point) "\\* " "\\* \\([^:]*\\)::" t))
|
||
(Info-goto-node node))
|
||
((setq node (Info-get-token (point) "\\* " "\\* \\([^:]*\\):" t))
|
||
(Info-menu node))
|
||
((setq node (Info-get-token (point) "Up: " "Up: \\([^,\n\t]*\\)" t))
|
||
(Info-goto-node node))
|
||
((setq node (Info-get-token (point) "Next: " "Next: \\([^,\n\t]*\\)" t))
|
||
(Info-goto-node node))
|
||
((setq node (Info-get-token (point) "File: " "File: \\([^,\n\t]*\\)" t))
|
||
(Info-goto-node "Top"))
|
||
((setq node (Info-get-token (point) "Prev: " "Prev: \\([^,\n\t]*\\)" t))
|
||
(Info-goto-node node))
|
||
((save-excursion (forward-line 1) (eobp))
|
||
(Info-next)))
|
||
))
|
||
|
||
(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)
|
||
(define-key Info-mode-map " " 'Info-scroll-up)
|
||
(define-key Info-mode-map "\C-m" 'Info-next-preorder)
|
||
(define-key Info-mode-map "1" 'Info-first-menu-item)
|
||
(define-key Info-mode-map "2" 'Info-second-menu-item)
|
||
(define-key Info-mode-map "3" 'Info-third-menu-item)
|
||
(define-key Info-mode-map "4" 'Info-fourth-menu-item)
|
||
(define-key Info-mode-map "5" 'Info-fifth-menu-item)
|
||
(define-key Info-mode-map "6" 'undefined)
|
||
(define-key Info-mode-map "7" 'undefined)
|
||
(define-key Info-mode-map "8" 'undefined)
|
||
(define-key Info-mode-map "9" 'undefined)
|
||
(define-key Info-mode-map "0" 'undefined)
|
||
(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)
|
||
(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)
|
||
(define-key Info-mode-map "u" 'Info-up)
|
||
(define-key Info-mode-map "\177" 'Info-scroll-down)
|
||
)
|
||
|
||
;; 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:
|
||
\\[Info-next] Move to the \"next\" node of this node.
|
||
\\[Info-previous] Move to the \"previous\" node of this node.
|
||
\\[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.
|
||
\\[Info-directory] Go to the Info directory node.
|
||
\\[Info-follow-reference] Follow a cross reference. Reads name of reference.
|
||
\\[Info-last] Move to the last node you were at.
|
||
|
||
Moving within a node:
|
||
\\[scroll-up] Normally, scroll forward a full screen. If the end of the buffer is
|
||
already visible, try to go to the next menu entry, or up if there is none.
|
||
\\[scroll-down] Normally, scroll backward. If the beginning of the buffer is
|
||
already visible, try to go to the previous menu entry, or up if there is none.
|
||
\\[beginning-of-buffer] Go to beginning of node.
|
||
|
||
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.
|
||
\\[Info-search] Search through this Info file for specified regexp,
|
||
and select the node in which the next occurrence is found.
|
||
\\[Info-next-preorder] Next-preorder; that is, try to go to the next menu item,
|
||
and if that fails try to move up, and if that fails, tell user
|
||
he/she is done reading."
|
||
(kill-all-local-variables)
|
||
(setq major-mode 'Info-mode)
|
||
(setq mode-name "Info")
|
||
(use-local-map Info-mode-map)
|
||
(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)
|
||
(make-local-variable 'Info-history)
|
||
(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.
|
||
Like text mode with the addition of Info-cease-edit
|
||
which returns to Info mode for browsing.
|
||
\\{Info-edit-map}"
|
||
)
|
||
|
||
(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"))
|
||
(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)
|
||
;; Make mode line update.
|
||
(set-buffer-modified-p (buffer-modified-p))
|
||
(message (substitute-command-keys
|
||
"Editing: Type \\<info-mode-map>\\[Info-cease-edit] to return to info")))
|
||
|
||
(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)
|
||
;; Make mode line update.
|
||
(set-buffer-modified-p (buffer-modified-p))
|
||
(and (marker-position Info-tag-table-marker)
|
||
(buffer-modified-p)
|
||
(message "Tags may have changed. Use Info-tagify if necessary")))
|
||
|
||
(defun Info-find-emacs-command-nodes (command)
|
||
"Return a list of locations documenting COMMAND in the Emacs Info manual.
|
||
The locations are of the format used in Info-history, i.e.
|
||
\(FILENAME NODENAME BUFFERPOS\)."
|
||
(require 'info)
|
||
(let ((where '())
|
||
(cmd-desc (concat "^\\* " (regexp-quote (symbol-name command))
|
||
":\\s *\\(.*\\)\\.$")))
|
||
(save-excursion
|
||
(Info-find-node "emacs" "Command Index")
|
||
;; 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)
|
||
"Go to the Info node in the Emacs manual for command COMMAND."
|
||
(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))
|
||
(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))
|
||
(message (substitute-command-keys
|
||
"Found %d other entr%. Use \\[Info-last] to see %s."
|
||
(1- num-matches)
|
||
(if (> num-matches 2) "ies" "y")
|
||
(if (> num-matches 2) "them" "it"))))))
|
||
(error "Couldn't find documentation for %s." command))))
|
||
|
||
;;;###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.
|
||
Interactively, if the binding is execute-extended-command, a command is read."
|
||
(interactive "kFind documentation for key:")
|
||
(let ((command (key-binding key)))
|
||
(cond ((null command)
|
||
(message "%s is undefined" (key-description keys)))
|
||
((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)))))
|
||
|
||
(provide 'info)
|
||
|
||
;;; info.el ends here
|