annotate lisp/info-look.el @ 28306:71e534c8c5cf

(COMPILE_FIRST): New macro. (compile-files): Compile files from COMPILE_FIRST first.
author Gerd Moellmann <gerd@gnu.org>
date Fri, 24 Mar 2000 22:51:40 +0000
parents 853a7fcaf7f0
children 23cb074f9d88
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1 ;;; info-look.el --- major-mode-sensitive Info index lookup facility.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
2 ;; An older version of this was known as libc.el.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
3
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
4 ;; Copyright (C) 1995, 1996, 1997, 1998, 1999 Free Software Foundation, Inc.
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
5
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
6 ;; Author: Ralph Schleicher <rs@purple.UL.BaWue.DE>
24769
28aea9fa43e1 Comment change.
Richard M. Stallman <rms@gnu.org>
parents: 23365
diff changeset
7 ;; Maintainers: FSF (unless Schleicher can be found)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
8 ;; Keywords: help languages
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
9
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
10 ;; This file is part of GNU Emacs.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
11
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
12 ;; GNU Emacs is free software; you can redistribute it and/or modify
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
13 ;; it under the terms of the GNU General Public License as published by
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
15 ;; any later version.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
16
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
17 ;; GNU Emacs is distributed in the hope that it will be useful,
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
20 ;; GNU General Public License for more details.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
21
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
25 ;; Boston, MA 02111-1307, USA.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
26
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
27 ;;; Code:
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
28
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
29 (require 'info)
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
30
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
31 (defgroup info-lookup nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
32 "Major mode sensitive help agent."
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
33 :group 'help :group 'languages)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
34
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
35 (defvar info-lookup-mode nil
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
36 "Symbol of the current buffer's help mode.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
37 Help is provided according to the buffer's major mode if value is nil.
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
38 Automatically becomes buffer local when set in any fashion.")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
39 (make-variable-buffer-local 'info-lookup-mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
40
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
41 (defcustom info-lookup-other-window-flag t
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
42 "Non-nil means pop up the Info buffer in another window."
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
43 :group 'info-lookup :type 'boolean)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
45 (defcustom info-lookup-highlight-face 'highlight
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
46 "Face for highlighting looked up help items.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
47 Setting this variable to nil disables highlighting."
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
48 :group 'info-lookup :type 'face)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
49
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
50 (defvar info-lookup-highlight-overlay nil
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
51 "Overlay object used for highlighting.")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
52
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
53 (defcustom info-lookup-file-name-alist
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
54 '(("\\`configure\\.in\\'" . autoconf-mode)
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
55 ("\\`aclocal\\.m4\\'" . autoconf-mode)
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
56 ("\\`acsite\\.m4\\'" . autoconf-mode)
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
57 ("\\`acinclude\\.m4\\'" . autoconf-mode))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
58 "Alist of file names handled specially.
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
59 List elements are cons cells of the form
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
60
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
61 (REGEXP . MODE)
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
62
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
63 If a file name matches REGEXP, then use help mode MODE instead of the
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
64 buffer's major mode."
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
65 :group 'info-lookup :type '(repeat (cons (string :tag "Regexp")
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
66 (symbol :tag "Mode"))))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
67
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
68 (defvar info-lookup-history nil
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
69 "History of previous input lines.")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
70
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
71 (defvar info-lookup-alist nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
72 "Alist of known help topics.
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
73 Cons cells are of the form
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
74
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
75 (HELP-TOPIC . HELP-DATA)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
76
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
77 HELP-TOPIC is the symbol of a help topic.
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
78 HELP-DATA is a HELP-TOPIC's public data set.
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
79 Value is an alist with elements of the form
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
80
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
81 (HELP-MODE REGEXP IGNORE-CASE DOC-SPEC PARSE-RULE OTHER-MODES)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
82
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
83 HELP-MODE is a mode's symbol.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
84 REGEXP is a regular expression matching those help items whose
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
85 documentation can be looked up via DOC-SPEC.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
86 IGNORE-CASE is non-nil if help items are case insensitive.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
87 DOC-SPEC is a list of documentation specifications of the form
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
88
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
89 (INFO-NODE TRANS-FUNC PREFIX SUFFIX)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
90
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
91 INFO-NODE is the name (including file name part) of an Info index.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
92 TRANS-FUNC is a function translating index entries into help items;
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
93 nil means add only those index entries matching REGEXP, a string
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
94 means prepend string to the first word of all index entries.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
95 PREFIX and SUFFIX are parts of a regular expression. If one of
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
96 them is non-nil then search the help item's Info node for the
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
97 first occurrence of the regular expression `PREFIX ITEM SUFFIX'.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
98 ITEM will be highlighted with `info-lookup-highlight-face' if this
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
99 variable is not nil.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
100 PARSE-RULE is either the symbol name of a function or a regular
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
101 expression for guessing the default help item at point. Fuzzy
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
102 regular expressions like \"[_a-zA-Z0-9]+\" do a better job if
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
103 there are no clear delimiters; do not try to write too complex
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
104 expressions. PARSE-RULE defaults to REGEXP.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
105 OTHER-MODES is a list of cross references to other help modes.")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
106
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
107 (defsubst info-lookup->topic-value (topic)
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
108 (cdr (assoc topic info-lookup-alist)))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
109
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
110 (defsubst info-lookup->mode-value (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
111 (assoc mode (info-lookup->topic-value topic)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
112
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
113 (defsubst info-lookup->regexp (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
114 (nth 1 (info-lookup->mode-value topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
115
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
116 (defsubst info-lookup->ignore-case (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
117 (nth 2 (info-lookup->mode-value topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
118
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
119 (defsubst info-lookup->doc-spec (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
120 (nth 3 (info-lookup->mode-value topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
121
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
122 (defsubst info-lookup->parse-rule (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
123 (nth 4 (info-lookup->mode-value topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
124
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
125 (defsubst info-lookup->other-modes (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
126 (nth 5 (info-lookup->mode-value topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
127
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
128 (eval-and-compile
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
129 (mapcar (lambda (keyword)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
130 (or (boundp keyword)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
131 (set keyword keyword)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
132 '(:topic :mode :regexp :ignore-case
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
133 :doc-spec :parse-rule :other-modes)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
134
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
135 (defun info-lookup-add-help (&rest arg)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
136 "Add or update a help specification.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
137 Function arguments are one or more options of the form
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
138
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
139 KEYWORD ARGUMENT
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
140
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
141 KEYWORD is either `:topic', `:mode', `:regexp', `:ignore-case',
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
142 `:doc-spec', `:parse-rule', or `:other-modes'.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
143 ARGUMENT has a value as explained in the documentation of the
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
144 variable `info-lookup-alist'.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
145
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
146 If no topic or mode option has been specified, then the help topic defaults
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
147 to `symbol', and the help mode defaults to the current major mode."
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
148 (apply 'info-lookup-add-help* nil arg))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
149
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
150 (defun info-lookup-maybe-add-help (&rest arg)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
151 "Add a help specification iff no one is defined.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
152 See the documentation of the function `info-lookup-add-help'
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
153 for more details."
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
154 (apply 'info-lookup-add-help* t arg))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
155
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
156 (defun info-lookup-add-help* (maybe &rest arg)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
157 (let (topic mode regexp ignore-case doc-spec
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
158 parse-rule other-modes keyword value)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
159 (setq topic 'symbol
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
160 mode major-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
161 regexp "\\w+")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
162 (while arg
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
163 (setq keyword (car arg))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
164 (or (symbolp keyword)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
165 (error "Junk in argument list \"%S\"" arg))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
166 (setq arg (cdr arg))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
167 (and (null arg)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
168 (error "Keyword \"%S\" is missing an argument" keyword))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
169 (setq value (car arg)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
170 arg (cdr arg))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
171 (cond ((eq keyword :topic)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
172 (setq topic value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
173 ((eq keyword :mode)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
174 (setq mode value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
175 ((eq keyword :regexp)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
176 (setq regexp value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
177 ((eq keyword :ignore-case)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
178 (setq ignore-case value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
179 ((eq keyword :doc-spec)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
180 (setq doc-spec value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
181 ((eq keyword :parse-rule)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
182 (setq parse-rule value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
183 ((eq keyword :other-modes)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
184 (setq other-modes value))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
185 (t
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
186 (error "Unknown keyword \"%S\"" keyword))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
187 (or (and maybe (info-lookup->mode-value topic mode))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
188 (let* ((data (list regexp ignore-case doc-spec parse-rule other-modes))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
189 (topic-cell (or (assoc topic info-lookup-alist)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
190 (car (setq info-lookup-alist
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
191 (cons (cons topic nil)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
192 info-lookup-alist)))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
193 (mode-cell (assoc mode topic-cell)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
194 (if (null mode-cell)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
195 (setcdr topic-cell (cons (cons mode data) (cdr topic-cell)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
196 (setcdr mode-cell data))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
197 nil))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
198
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
199 (defvar info-lookup-cache nil
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
200 "Cache storing data maintained automatically by the program.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
201 Value is an alist with cons cell of the form
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
202
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
203 (HELP-TOPIC . ((HELP-MODE INITIALIZED COMPLETIONS REFER-MODES) ...))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
204
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
205 HELP-TOPIC is the symbol of a help topic.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
206 HELP-MODE is a mode's symbol.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
207 INITIALIZED is nil if HELP-MODE is uninitialized, t if
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
208 HELP-MODE is initialized, and `0' means HELP-MODE is
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
209 initialized but void.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
210 COMPLETIONS is an alist of documented help items.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
211 REFER-MODES is a list of other help modes to use.")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
212
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
213 (defsubst info-lookup->cache (topic)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
214 (or (assoc topic info-lookup-cache)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
215 (car (setq info-lookup-cache
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
216 (cons (cons topic nil)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
217 info-lookup-cache)))))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
218
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
219 (defun info-lookup->topic-cache (topic)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
220 (cdr (info-lookup->cache topic)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
221
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
222 (defun info-lookup->mode-cache (topic mode)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
223 (assoc mode (info-lookup->topic-cache topic)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
224
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
225 (defun info-lookup->initialized (topic mode)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
226 (nth 1 (info-lookup->mode-cache topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
227
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
228 (defun info-lookup->completions (topic mode)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
229 (or (info-lookup->initialized topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
230 (info-lookup-setup-mode topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
231 (nth 2 (info-lookup->mode-cache topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
232
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
233 (defun info-lookup->refer-modes (topic mode)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
234 (or (info-lookup->initialized topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
235 (info-lookup-setup-mode topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
236 (nth 3 (info-lookup->mode-cache topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
237
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
238 (defun info-lookup->all-modes (topic mode)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
239 (cons mode (info-lookup->refer-modes topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
240
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
241 (defun info-lookup-quick-all-modes (topic mode)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
242 (cons mode (info-lookup->other-modes topic mode)))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
243
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
244 ;;;###autoload
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
245 (defun info-lookup-reset ()
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
246 "Throw away all cached data.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
247 This command is useful if the user wants to start at the beginning without
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
248 quitting Emacs, for example, after some Info documents were updated on the
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
249 system."
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
250 (interactive)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
251 (setq info-lookup-cache nil))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
252
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
253 ;;;###autoload
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
254 (defun info-lookup-symbol (symbol &optional mode)
24829
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
255 "Display the definition of SYMBOL, as found in the relevant manual.
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
256 When this command is called interactively, it reads SYMBOL from the minibuffer.
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
257 In the minibuffer, use M-n to yank the default argument value
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
258 into the minibuffer so you can edit it.
25057
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
259 The default symbol is the one found at point.
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
260
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
261 With prefix arg a query for the symbol help mode is offered."
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
262 (interactive
25057
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
263 (info-lookup-interactive-arguments 'symbol current-prefix-arg))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
264 (info-lookup 'symbol symbol mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
265
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
266 ;;;###autoload
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
267 (defun info-lookup-file (file &optional mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
268 "Display the documentation of a file.
24829
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
269 When this command is called interactively, it reads FILE from the minibuffer.
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
270 In the minibuffer, use M-n to yank the default file name
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
271 into the minibuffer so you can edit it.
25057
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
272 The default file name is the one found at point.
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
273
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
274 With prefix arg a query for the file help mode is offered."
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
275 (interactive
25057
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
276 (info-lookup-interactive-arguments 'file current-prefix-arg))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
277 (info-lookup 'file file mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
278
25057
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
279 (defun info-lookup-interactive-arguments (topic &optional query)
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
280 "Read and return argument value (and help mode) for help topic TOPIC.
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
281 If optional argument QUERY is non-nil, query for the help mode."
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
282 (let* ((mode (cond (query
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
283 (info-lookup-change-mode topic))
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
284 ((info-lookup->mode-value topic (info-lookup-select-mode))
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
285 info-lookup-mode)
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
286 ((info-lookup-change-mode topic))))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
287 (completions (info-lookup->completions topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
288 (default (info-lookup-guess-default topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
289 (completion-ignore-case (info-lookup->ignore-case topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
290 (enable-recursive-minibuffers t)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
291 (value (completing-read
24829
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
292 (if default
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
293 (format "Describe %s (default %s): " topic default)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
294 (format "Describe %s: " topic))
24829
749c12791859 (info-lookup-file, info-lookup-symbol): Doc fix.
Karl Heuer <kwzh@gnu.org>
parents: 24769
diff changeset
295 completions nil nil nil 'info-lookup-history default)))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
296 (list (if (equal value "") default value) mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
297
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
298 (defun info-lookup-select-mode ()
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
299 (when (and (not info-lookup-mode) (buffer-file-name))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
300 (let ((file-name (file-name-nondirectory (buffer-file-name)))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
301 (file-name-alist info-lookup-file-name-alist))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
302 (while (and (not info-lookup-mode) file-name-alist)
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
303 (when (string-match (caar file-name-alist) file-name)
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
304 (setq info-lookup-mode (cdar file-name-alist)))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
305 (setq file-name-alist (cdr file-name-alist)))))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
306 (or info-lookup-mode (setq info-lookup-mode major-mode)))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
307
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
308 (defun info-lookup-change-mode (topic)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
309 (let* ((completions (mapcar (lambda (arg)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
310 (cons (symbol-name (car arg)) (car arg)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
311 (info-lookup->topic-value topic)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
312 (mode (completing-read
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
313 (format "Use %s help mode: " topic)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
314 completions nil t nil 'info-lookup-history)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
315 (or (setq mode (cdr (assoc mode completions)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
316 (error "No %s help available" topic))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
317 (or (info-lookup->mode-value topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
318 (error "No %s help available for `%s'" topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
319 (setq info-lookup-mode mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
320
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
321 (defun info-lookup (topic item mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
322 "Display the documentation of a help item."
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
323 (or mode (setq mode (info-lookup-select-mode)))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
324 (or (info-lookup->mode-value topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
325 (error "No %s help available for `%s'" topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
326 (let ((entry (or (assoc (if (info-lookup->ignore-case topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
327 (downcase item) item)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
328 (info-lookup->completions topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
329 (error "Not documented as a %s: %s" topic (or item ""))))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
330 (modes (info-lookup->all-modes topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
331 (window (selected-window))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
332 found doc-spec node prefix suffix doc-found)
25057
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
333 (if (or (not info-lookup-other-window-flag)
6019ba9c1a95 (info-lookup-interactive-arguments): Add optional
Karl Heuer <kwzh@gnu.org>
parents: 25041
diff changeset
334 (eq (current-buffer) (get-buffer "*info*")))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
335 (info)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
336 (save-window-excursion (info))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
337 (switch-to-buffer-other-window "*info*"))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
338 (while (and (not found) modes)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
339 (setq doc-spec (info-lookup->doc-spec topic (car modes)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
340 (while (and (not found) doc-spec)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
341 (setq node (nth 0 (car doc-spec))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
342 prefix (nth 2 (car doc-spec))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
343 suffix (nth 3 (car doc-spec)))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
344 (when (condition-case error-data
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
345 (progn
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
346 (Info-goto-node node)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
347 (setq doc-found t))
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
348 (error
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
349 (message "Cannot access Info node %s" node)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
350 (sit-for 1)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
351 nil))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
352 (condition-case nil
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
353 (progn
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
354 (Info-menu (or (cdr entry) item))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
355 (setq found t)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
356 (if (or prefix suffix)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
357 (let ((case-fold-search
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
358 (info-lookup->ignore-case topic (car modes)))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
359 (buffer-read-only nil))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
360 (goto-char (point-min))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
361 (re-search-forward
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
362 (concat prefix (regexp-quote item) suffix))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
363 (goto-char (match-beginning 0))
28112
853a7fcaf7f0 (info-lookup): Use display-color-p.
Dave Love <fx@gnu.org>
parents: 25364
diff changeset
364 (and (display-color-p) info-lookup-highlight-face
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
365 ;; Search again for ITEM so that the first
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
366 ;; occurence of ITEM will be highlighted.
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
367 (re-search-forward (regexp-quote item))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
368 (let ((start (match-beginning 0))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
369 (end (match-end 0)))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
370 (if (overlayp info-lookup-highlight-overlay)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
371 (move-overlay info-lookup-highlight-overlay
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
372 start end (current-buffer))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
373 (setq info-lookup-highlight-overlay
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
374 (make-overlay start end))))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
375 (overlay-put info-lookup-highlight-overlay
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
376 'face info-lookup-highlight-face)))))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
377 (error nil)))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
378 (setq doc-spec (cdr doc-spec)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
379 (setq modes (cdr modes)))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
380 (or doc-found
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
381 (error "Info documentation for lookup was not found"))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
382 ;; Don't leave the Info buffer if the help item couldn't be looked up.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
383 (if (and info-lookup-other-window-flag found)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
384 (select-window window))))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
385
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
386 (defun info-lookup-setup-mode (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
387 "Initialize the internal data structure."
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
388 (or (info-lookup->initialized topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
389 (let (cell data (initialized 0) completions refer-modes)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
390 (if (not (info-lookup->mode-value topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
391 (message "No %s help available for `%s'" topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
392 ;; Recursively setup cross references.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
393 ;; But refer only to non-void modes.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
394 (mapcar (lambda (arg)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
395 (or (info-lookup->initialized topic arg)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
396 (info-lookup-setup-mode topic arg))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
397 (and (eq (info-lookup->initialized topic arg) t)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
398 (setq refer-modes (cons arg refer-modes))))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
399 (info-lookup->other-modes topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
400 (setq refer-modes (nreverse refer-modes))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
401 ;; Build the full completion alist.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
402 (setq completions
25041
d45a32b777f6 (info-lookup-setup-mode): Don't give up, if
Karl Heuer <kwzh@gnu.org>
parents: 24829
diff changeset
403 (nconc (condition-case nil
d45a32b777f6 (info-lookup-setup-mode): Don't give up, if
Karl Heuer <kwzh@gnu.org>
parents: 24829
diff changeset
404 (info-lookup-make-completions topic mode)
d45a32b777f6 (info-lookup-setup-mode): Don't give up, if
Karl Heuer <kwzh@gnu.org>
parents: 24829
diff changeset
405 (error nil))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
406 (apply 'append
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
407 (mapcar (lambda (arg)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
408 (info-lookup->completions topic arg))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
409 refer-modes))))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
410 (setq initialized t))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
411 ;; Update `info-lookup-cache'.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
412 (setq cell (info-lookup->mode-cache topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
413 data (list initialized completions refer-modes))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
414 (if (not cell)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
415 (setcdr (info-lookup->cache topic)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
416 (cons (cons mode data) (info-lookup->topic-cache topic)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
417 (setcdr cell data))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
418 initialized)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
419
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
420 (defun info-lookup-make-completions (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
421 "Create a unique alist from all index entries."
20519
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
422 (let ((doc-spec (info-lookup->doc-spec topic mode))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
423 (regexp (concat "^\\(" (info-lookup->regexp topic mode)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
424 "\\)\\([ \t].*\\)?$"))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
425 node trans entry item prefix result doc-found
20519
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
426 (buffer (get-buffer-create " temp-info-look")))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
427 (with-current-buffer buffer
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
428 (Info-mode))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
429 (while doc-spec
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
430 (setq node (nth 0 (car doc-spec))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
431 trans (cond ((eq (nth 1 (car doc-spec)) nil)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
432 (lambda (arg)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
433 (if (string-match regexp arg)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
434 (match-string 1 arg))))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
435 ((stringp (nth 1 (car doc-spec)))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
436 (setq prefix (nth 1 (car doc-spec)))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
437 (lambda (arg)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
438 (if (string-match "^\\([^: \t\n]+\\)" arg)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
439 (concat prefix (match-string 1 arg)))))
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
440 (t (nth 1 (car doc-spec)))))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
441 (with-current-buffer buffer
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
442 (message "Processing Info node `%s'..." node)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
443 (when (condition-case error-data
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
444 (progn
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
445 (Info-goto-node node)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
446 (setq doc-found t))
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
447 (error
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
448 (message "Cannot access Info node `%s'" node)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
449 (sit-for 1)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
450 nil))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
451 (condition-case nil
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
452 (progn
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
453 (goto-char (point-min))
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
454 (and (search-forward "\n* Menu:" nil t)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
455 (while (re-search-forward "\n\\* \\([^:\t\n]*\\):" nil t)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
456 (setq entry (match-string 1)
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
457 item (funcall trans entry))
23365
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
458 ;; `trans' can return nil if the regexp doesn't match.
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
459 (when (and item
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
460 ;; Sometimes there's more than one Menu:
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
461 (not (string= entry "Menu")))
23365
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
462 (and (info-lookup->ignore-case topic mode)
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
463 (setq item (downcase item)))
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
464 (and (string-equal entry item)
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
465 (setq entry nil))
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
466 (and (or (assoc item result)
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
467 (setq result (cons (cons item entry)
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
468 result))))))))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
469 (error nil))))
20519
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
470 (message "Processing Info node `%s'...done" node)
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
471 (setq doc-spec (cdr doc-spec)))
20690
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
472 (or doc-found
a51c71dd5cda (info-lookup): Report if Info-goto-node fails.
Richard M. Stallman <rms@gnu.org>
parents: 20519
diff changeset
473 (error "Info documentation for lookup was not found"))
20519
c7b3ef0ed1ad (info-lookup-symbol-alist): Handle Emacs Lisp mode.
Richard M. Stallman <rms@gnu.org>
parents: 18323
diff changeset
474 result))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
475
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
476 (defun info-lookup-guess-default (topic mode)
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
477 "Return a guess for a symbol to look up, based on text around point.
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
478 Try all related modes applicable to TOPIC and MODE.
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
479 Return nil if there is nothing appropriate in the buffer near point."
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
480 (let ((modes (info-lookup->all-modes topic mode))
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
481 guess)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
482 (while (and (not guess) modes)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
483 (setq guess (info-lookup-guess-default* topic (car modes))
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
484 modes (cdr modes)))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
485 ;; Collapse whitespace characters.
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
486 (when guess
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
487 (let ((pos 0))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
488 (while (string-match "[ \t\n]+" guess pos)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
489 (setq pos (1+ (match-beginning 0)))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
490 (setq guess (replace-match " " t t guess)))))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
491 guess))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
492
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
493 (defun info-lookup-guess-default* (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
494 (let ((case-fold-search (info-lookup->ignore-case topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
495 (rule (or (info-lookup->parse-rule topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
496 (info-lookup->regexp topic mode)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
497 (start (point)) end regexp subexp result)
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
498 (save-excursion
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
499 (if (symbolp rule)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
500 (setq result (funcall rule))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
501 (if (consp rule)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
502 (setq regexp (car rule)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
503 subexp (cdr rule))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
504 (setq regexp rule
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
505 subexp 0))
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
506 ;; If at start of symbol, don't go back to end of previous one.
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
507 (if (save-match-data
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
508 (looking-at "[ \t\n]"))
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
509 (skip-chars-backward " \t\n"))
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
510 (setq end (point))
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
511 (while (and (re-search-backward regexp nil t)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
512 (looking-at regexp)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
513 (>= (match-end 0) end))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
514 (setq result (match-string subexp)))
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
515 (if (not result)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
516 (progn
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
517 (goto-char start)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
518 (skip-chars-forward " \t\n")
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
519 (and (looking-at regexp)
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
520 (setq result (match-string subexp)))))))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
521 result))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
522
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
523 (defun info-lookup-guess-c-symbol ()
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
524 "Get the C symbol at point."
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
525 (condition-case nil
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
526 (progn
25222
1802f1bb3285 (info-lookup-guess-c-symbol): Use skip-syntax-backward.
Karl Heuer <kwzh@gnu.org>
parents: 25057
diff changeset
527 (skip-syntax-backward "w_")
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
528 (let ((start (point)) prefix name)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
529 ;; Test for a leading `struct', `union', or `enum' keyword
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
530 ;; but ignore names like `foo_struct'.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
531 (setq prefix (and (< (skip-chars-backward " \t\n") 0)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
532 (< (skip-chars-backward "_a-zA-Z0-9") 0)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
533 (looking-at "\\(struct\\|union\\|enum\\)\\s ")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
534 (concat (match-string 1) " ")))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
535 (goto-char start)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
536 (and (looking-at "[_a-zA-Z][_a-zA-Z0-9]*")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
537 (setq name (match-string 0)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
538 ;; Caveat! Look forward if point is at `struct' etc.
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
539 (and (not prefix)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
540 (or (string-equal name "struct")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
541 (string-equal name "union")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
542 (string-equal name "enum"))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
543 (looking-at "[a-z]+\\s +\\([_a-zA-Z][_a-zA-Z0-9]*\\)")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
544 (setq prefix (concat name " ")
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
545 name (match-string 1)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
546 (and (or prefix name)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
547 (concat prefix name))))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
548 (error nil)))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
549
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
550 ;;;###autoload
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
551 (defun info-complete-symbol (&optional mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
552 "Perform completion on symbol preceding point."
18323
64d728fb396a (info-complete-symbol): If MODE is nil, use the default value.
Richard M. Stallman <rms@gnu.org>
parents: 18322
diff changeset
553 (interactive)
64d728fb396a (info-complete-symbol): If MODE is nil, use the default value.
Richard M. Stallman <rms@gnu.org>
parents: 18322
diff changeset
554 (info-complete 'symbol
64d728fb396a (info-complete-symbol): If MODE is nil, use the default value.
Richard M. Stallman <rms@gnu.org>
parents: 18322
diff changeset
555 (or mode
64d728fb396a (info-complete-symbol): If MODE is nil, use the default value.
Richard M. Stallman <rms@gnu.org>
parents: 18322
diff changeset
556 (if (info-lookup->mode-value
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
557 'symbol (info-lookup-select-mode))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
558 info-lookup-mode
18323
64d728fb396a (info-complete-symbol): If MODE is nil, use the default value.
Richard M. Stallman <rms@gnu.org>
parents: 18322
diff changeset
559 (info-lookup-change-mode 'symbol)))))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
560
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
561 ;;;###autoload
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
562 (defun info-complete-file (&optional mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
563 "Perform completion on file preceding point."
20973
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
564 (interactive)
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
565 (info-complete 'file
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
566 (or mode
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
567 (if (info-lookup->mode-value
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
568 'file (info-lookup-select-mode))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
569 info-lookup-mode
20973
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
570 (info-lookup-change-mode 'file)))))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
571
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
572 (defun info-complete (topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
573 "Try to complete a help item."
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
574 (barf-if-buffer-read-only)
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
575 (or mode (setq mode (info-lookup-select-mode)))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
576 (or (info-lookup->mode-value topic mode)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
577 (error "No %s completion available for `%s'" topic mode))
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
578 (let ((modes (info-lookup-quick-all-modes topic mode))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
579 (start (point))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
580 try)
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
581 (while (and (not try) modes)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
582 (setq mode (car modes)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
583 modes (cdr modes)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
584 try (info-lookup-guess-default* topic mode))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
585 (goto-char start))
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
586 (and (not try)
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
587 (error "Found no %S to complete" topic))
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
588 (let ((completions (info-lookup->completions topic mode))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
589 (completion-ignore-case (info-lookup->ignore-case topic mode))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
590 completion)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
591 (setq completion (try-completion try completions))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
592 (cond ((not completion)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
593 (ding)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
594 (message "No match"))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
595 ((stringp completion)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
596 (or (assoc completion completions)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
597 (setq completion (completing-read
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
598 (format "Complete %S: " topic)
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
599 completions nil t completion
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
600 info-lookup-history)))
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
601 ;; Find the original symbol and zap it.
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
602 (end-of-line)
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
603 (while (and (search-backward try nil t)
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
604 (< start (point))))
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
605 (replace-match "")
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
606 (insert completion))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
607 (t
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
608 (message "%s is complete"
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
609 (capitalize (prin1-to-string topic))))))))
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
610
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
611
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
612 ;;; Initialize some common modes.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
613
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
614 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
615 :mode 'c-mode :topic 'symbol
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
616 :regexp "\\(struct \\|union \\|enum \\)?[_a-zA-Z][_a-zA-Z0-9]*"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
617 :doc-spec '(("(libc)Function Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
618 "^[ \t]+- \\(Function\\|Macro\\): .*\\<" "\\>")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
619 ("(libc)Variable Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
620 "^[ \t]+- \\(Variable\\|Macro\\): .*\\<" "\\>")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
621 ("(libc)Type Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
622 "^[ \t]+- Data Type: \\<" "\\>")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
623 ("(termcap)Var Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
624 "^[ \t]*`" "'"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
625 :parse-rule 'info-lookup-guess-c-symbol)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
626
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
627 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
628 :mode 'c-mode :topic 'file
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
629 :regexp "[_a-zA-Z0-9./+-]+"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
630 :doc-spec '(("(libc)File Index")))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
631
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
632 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
633 :mode 'bison-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
634 :regexp "[:;|]\\|%\\([%{}]\\|[_a-z]+\\)\\|YY[_A-Z]+\\|yy[_a-z]+"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
635 :doc-spec '(("(bison)Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
636 "`" "'"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
637 :parse-rule "[:;|]\\|%\\([%{}]\\|[_a-zA-Z][_a-zA-Z0-9]*\\)"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
638 :other-modes '(c-mode))
20899
d1f6ac340403 (info-complete): Display completions on second invocation at same point
Richard M. Stallman <rms@gnu.org>
parents: 20690
diff changeset
639
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
640 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
641 :mode 'makefile-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
642 :regexp "\\$[^({]\\|\\.[_A-Z]*\\|[_a-zA-Z][_a-zA-Z0-9-]*"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
643 :doc-spec '(("(make)Name Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
644 "^[ \t]*`" "'"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
645 :parse-rule "\\$[^({]\\|\\.[_A-Z]*\\|[_a-zA-Z0-9-]+")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
646
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
647 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
648 :mode 'texinfo-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
649 :regexp "@\\([a-zA-Z]+\\|[^a-zA-Z]\\)"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
650 :doc-spec '(("(texinfo)Command and Variable Index"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
651 ;; Ignore Emacs commands and prepend a `@'.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
652 (lambda (item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
653 (if (string-match "^\\([a-zA-Z]+\\|[^a-zA-Z]\\)\\( .*\\)?$" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
654 (concat "@" (match-string 1 item))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
655 "`" "'")))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
656
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
657 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
658 :mode 'm4-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
659 :regexp "[_a-zA-Z][_a-zA-Z0-9]*"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
660 :doc-spec '(("(m4)Macro index"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
661 :parse-rule "[_a-zA-Z0-9]+")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
662
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
663 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
664 :mode 'autoconf-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
665 :regexp "A[CM]_[_A-Z0-9]+"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
666 :doc-spec '(("(autoconf)Macro Index" "AC_"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
667 "^[ \t]+- \\(Macro\\|Variable\\): .*\\<" "\\>")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
668 ("(automake)Index" nil
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
669 "^[ \t]*`" "'"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
670 ;; Autoconf symbols are M4 macros. Thus use M4's parser.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
671 :parse-rule 'ignore
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
672 :other-modes '(m4-mode))
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
673
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
674 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
675 :mode 'awk-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
676 :regexp "[_a-zA-Z]+"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
677 :doc-spec '(("(gawk)Index"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
678 (lambda (item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
679 (let ((case-fold-search nil))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
680 (cond
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
681 ;; `BEGIN' and `END'.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
682 ((string-match "^\\([A-Z]+\\) special pattern\\b" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
683 (match-string 1 item))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
684 ;; `if', `while', `do', ...
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
685 ((string-match "^\\([a-z]+\\) statement\\b" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
686 (if (not (string-equal (match-string 1 item) "control"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
687 (match-string 1 item)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
688 ;; `NR', `NF', ...
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
689 ((string-match "^[A-Z]+$" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
690 item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
691 ;; Built-in functions (matches to many entries).
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
692 ((string-match "^[a-z]+$" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
693 item))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
694 "`" "\\([ \t]*([^)]*)\\)?'")))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
695
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
696 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
697 :mode 'perl-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
698 :regexp "[$@%][^a-zA-Z]\\|\\$\\^[A-Z]\\|[$@%]?[a-zA-Z][_a-zA-Z0-9]*"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
699 :doc-spec '(("(perl5)Function Index"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
700 (lambda (item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
701 (if (string-match "^\\([a-zA-Z0-9]+\\)" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
702 (match-string 1 item)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
703 "^" "\\b")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
704 ("(perl5)Variable Index"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
705 (lambda (item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
706 ;; Work around bad formatted array variables.
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
707 (let ((sym (cond ((or (string-match "^\\$\\(.\\|@@\\)$" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
708 (string-match "^\\$\\^[A-Z]$" item))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
709 item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
710 ((string-match
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
711 "^\\([$%@]\\|@@\\)?[_a-zA-Z0-9]+" item)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
712 (match-string 0 item))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
713 (t ""))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
714 (if (string-match "@@" sym)
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
715 (setq sym (concat (substring sym 0 (match-beginning 0))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
716 (substring sym (1- (match-end 0))))))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
717 (if (string-equal sym "") nil sym)))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
718 "^" "\\b"))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
719 :parse-rule "[$@%]?\\([_a-zA-Z0-9]+\\|[^a-zA-Z]\\)")
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
720
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
721 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
722 :mode 'latex-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
723 :regexp "\\\\\\([a-zA-Z]+\\|[^a-zA-Z]\\)"
25041
d45a32b777f6 (info-lookup-setup-mode): Don't give up, if
Karl Heuer <kwzh@gnu.org>
parents: 24829
diff changeset
724 :doc-spec '(("(latex)Command Index" nil
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
725 "`" "\\({[^}]*}\\)?'")))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
726
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
727 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
728 :mode 'emacs-lisp-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
729 :regexp "[^()' \t\n]+"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
730 :doc-spec '(("(emacs)Command Index")
20973
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
731 ("(emacs)Variable Index")
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
732 ("(elisp)Index"
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
733 (lambda (item)
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
734 (let ((sym (intern-soft item)))
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
735 (cond ((null sym)
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
736 (if (string-equal item "nil") item))
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
737 ((or (boundp sym) (fboundp sym))
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
738 item))))
b7e7f7c9685a Added support for the Emacs Lisp manual.
Karl Heuer <kwzh@gnu.org>
parents: 20909
diff changeset
739 "^[ \t]+- [^:]+:[ \t]*" "\\b")))
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
740
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
741 (info-lookup-maybe-add-help
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
742 :mode 'lisp-interaction-mode
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
743 :regexp "[^()' \t\n]+"
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
744 :parse-rule 'ignore
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
745 :other-modes '(emacs-lisp-mode))
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
746
21334
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
747 (info-lookup-maybe-add-help
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
748 :mode 'lisp-mode
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
749 :regexp "[^()' \t\n]+"
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
750 :parse-rule 'ignore
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
751 :other-modes '(emacs-lisp-mode))
66b3b9fe3e3c (info-lookup->topic-cache): Use defun, not defsubst.
Richard M. Stallman <rms@gnu.org>
parents: 20973
diff changeset
752
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
753 (info-lookup-maybe-add-help
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
754 :mode 'scheme-mode
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
755 :regexp "[^()' \t\n]+"
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
756 :ignore-case t
23365
d400637428d1 Remove duplicate scheme-mode entry.
Dave Love <fx@gnu.org>
parents: 23346
diff changeset
757 ;; Aubrey Jaffer's rendition from <URL:ftp://ftp-swiss.ai.mit.edu/pub/scm>
22281
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
758 :doc-spec '(("(r5rs)Index" nil
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
759 "^[ \t]+- [^:]+:[ \t]*" "\\b")))
fa2cf768a61a Added support for Scheme.
Karl Heuer <kwzh@gnu.org>
parents: 22266
diff changeset
760
23346
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
761 (info-lookup-maybe-add-help
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
762 :mode 'octave-mode
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
763 :regexp "[_a-zA-Z0-9]+"
25364
d593a9e28430 Octave-mode support: for the function index entries, allow the prefix
Stephen Eglen <stephen@gnu.org>
parents: 25310
diff changeset
764 :doc-spec '(("(octave)Function Index" nil
d593a9e28430 Octave-mode support: for the function index entries, allow the prefix
Stephen Eglen <stephen@gnu.org>
parents: 25310
diff changeset
765 "^ - [^:]+:[ ]+\\(\\[[^=]*=[ ]+\\)?" nil)
23346
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
766 ("(octave)Variable Index" nil "^ - [^:]+:[ ]+" nil)
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
767 ;; Catch lines of the form "xyz statement"
25310
f38d26cd9b8f Remove compatibility code.
Dave Love <fx@gnu.org>
parents: 25222
diff changeset
768 ("(octave)Concept Index"
23346
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
769 (lambda (item)
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
770 (cond
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
771 ((string-match "^\\([A-Z]+\\) statement\\b" item)
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
772 (match-string 1 item))
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
773 (t nil)))
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
774 nil; "^ - [^:]+:[ ]+" don't think this prefix is useful here.
4db659df7407 Add support for Octave.
Stephen Eglen <stephen@gnu.org>
parents: 22281
diff changeset
775 nil)))
20909
542ae65815fb (info-complete): Rewrite minibuffer completion code.
Richard M. Stallman <rms@gnu.org>
parents: 20899
diff changeset
776
18322
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
777 (provide 'info-look)
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
778
02f932c91db2 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
779 ;;; info-look.el ends here