Commit | Line | Data |
---|---|---|
b035a678 | 1 | ;;; complete.el --- partial completion mechanism plus other goodies |
b545bfe6 | 2 | |
e91081eb | 3 | ;; Copyright (C) 1990, 1991, 1992, 1993, 1999, 2000, 2001, 2002, 2003, |
5df4f04c | 4 | ;; 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc. |
b545bfe6 JB |
5 | |
6 | ;; Author: Dave Gillespie <daveg@synaptics.com> | |
f5f727f8 | 7 | ;; Keywords: abbrev convenience |
c1e25821 | 8 | ;; Obsolete-since: 24.1 |
88f4758e | 9 | ;; |
b545bfe6 JB |
10 | ;; Special thanks to Hallvard Furuseth for his many ideas and contributions. |
11 | ||
12 | ;; This file is part of GNU Emacs. | |
13 | ||
eb3fa2cf | 14 | ;; GNU Emacs is free software: you can redistribute it and/or modify |
59243403 | 15 | ;; it under the terms of the GNU General Public License as published by |
eb3fa2cf GM |
16 | ;; the Free Software Foundation, either version 3 of the License, or |
17 | ;; (at your option) any later version. | |
59243403 | 18 | |
b545bfe6 | 19 | ;; GNU Emacs is distributed in the hope that it will be useful, |
59243403 RS |
20 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of |
21 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
22 | ;; GNU General Public License for more details. | |
b545bfe6 | 23 | |
59243403 | 24 | ;; You should have received a copy of the GNU General Public License |
eb3fa2cf | 25 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
b545bfe6 | 26 | |
07b3798c | 27 | ;;; Commentary: |
b545bfe6 JB |
28 | |
29 | ;; Extended completion for the Emacs minibuffer. | |
30 | ;; | |
31 | ;; The basic idea is that the command name or other completable text is | |
32 | ;; divided into words and each word is completed separately, so that | |
33 | ;; "M-x p-b" expands to "M-x print-buffer". If the entry is ambiguous | |
34 | ;; each word is completed as much as possible and then the cursor is | |
35 | ;; left at the first position where typing another letter will resolve | |
36 | ;; the ambiguity. | |
37 | ;; | |
38 | ;; Word separators for this purpose are hyphen, space, and period. | |
39 | ;; These would most likely occur in command names, Info menu items, | |
40 | ;; and file names, respectively. But all word separators are treated | |
41 | ;; alike at all times. | |
42 | ;; | |
43 | ;; This completion package replaces the old-style completer's key | |
44 | ;; bindings for TAB, SPC, RET, and `?'. The old completer is still | |
45 | ;; available on the Meta versions of those keys. If you set | |
46 | ;; PC-meta-flag to nil, the old completion keys will be left alone | |
47 | ;; and the partial completer will use the Meta versions of the keys. | |
48 | ||
49 | ||
7117761b | 50 | ;; Usage: M-x partial-completion-mode. During completable minibuffer entry, |
b545bfe6 JB |
51 | ;; |
52 | ;; TAB means to do a partial completion; | |
53 | ;; SPC means to do a partial complete-word; | |
54 | ;; RET means to do a partial complete-and-exit; | |
55 | ;; ? means to do a partial completion-help. | |
56 | ;; | |
57 | ;; If you set PC-meta-flag to nil, then TAB, SPC, RET, and ? perform | |
58 | ;; original Emacs completions, and M-TAB etc. do partial completion. | |
59 | ;; To do this, put the command, | |
60 | ;; | |
61 | ;; (setq PC-meta-flag nil) | |
62 | ;; | |
63 | ;; in your .emacs file. To load partial completion automatically, put | |
64 | ;; | |
7117761b | 65 | ;; (partial-completion-mode t) |
b545bfe6 JB |
66 | ;; |
67 | ;; in your .emacs file, too. Things will be faster if you byte-compile | |
68 | ;; this file when you install it. | |
69 | ;; | |
70 | ;; As an extra feature, in cases where RET would not normally | |
71 | ;; complete (such as `C-x b'), the M-RET key will always do a partial | |
72 | ;; complete-and-exit. Thus `C-x b f.c RET' will select or create a | |
73 | ;; buffer called "f.c", but `C-x b f.c M-RET' will select the existing | |
74 | ;; buffer whose name matches that pattern (perhaps "filing.c"). | |
75 | ;; (PC-meta-flag does not affect this behavior; M-RET used to be | |
76 | ;; undefined in this situation.) | |
77 | ;; | |
78 | ;; The regular M-TAB (lisp-complete-symbol) command also supports | |
79 | ;; partial completion in this package. | |
80 | ||
b545bfe6 JB |
81 | ;; In addition, this package includes a feature for accessing include |
82 | ;; files. For example, `C-x C-f <sys/time.h> RET' reads the file | |
83 | ;; /usr/include/sys/time.h. The variable PC-include-file-path is a | |
84 | ;; list of directories in which to search for include files. Completion | |
85 | ;; is supported in include file names. | |
86 | ||
87 | ||
07b3798c | 88 | ;;; Code: |
b545bfe6 | 89 | |
92677e25 SM |
90 | (defgroup partial-completion nil |
91 | "Partial Completion of items." | |
92 | :prefix "pc-" | |
f5f727f8 DN |
93 | :group 'minibuffer |
94 | :group 'convenience) | |
92677e25 | 95 | |
92677e25 | 96 | (defcustom PC-first-char 'find-file |
95983b95 | 97 | "Control how the first character of a string is to be interpreted. |
92677e25 SM |
98 | If nil, the first character of a string is not taken literally if it is a word |
99 | delimiter, so that \".e\" matches \"*.e*\". | |
100 | If t, the first character of a string is always taken literally even if it is a | |
101 | word delimiter, so that \".e\" matches \".e*\". | |
102 | If non-nil and non-t, the first character is taken literally only for file name | |
103 | completion." | |
104 | :type '(choice (const :tag "delimiter" nil) | |
105 | (const :tag "literal" t) | |
45200424 | 106 | (other :tag "find-file" find-file)) |
92677e25 SM |
107 | :group 'partial-completion) |
108 | ||
109 | (defcustom PC-meta-flag t | |
95983b95 | 110 | "If non-nil, TAB means PC completion and M-TAB means normal completion. |
92677e25 SM |
111 | Otherwise, TAB means normal completion and M-TAB means Partial Completion." |
112 | :type 'boolean | |
113 | :group 'partial-completion) | |
114 | ||
115 | (defcustom PC-word-delimiters "-_. " | |
95983b95 | 116 | "A string of characters treated as word delimiters for completion. |
92677e25 SM |
117 | Some arcane rules: |
118 | If `]' is in this string, it must come first. | |
119 | If `^' is in this string, it must not come first. | |
120 | If `-' is in this string, it must come first or right after `]'. | |
932fb767 | 121 | In other words, if S is this string, then `[S]' must be a valid Emacs regular |
92677e25 SM |
122 | expression (not containing character ranges like `a-z')." |
123 | :type 'string | |
124 | :group 'partial-completion) | |
125 | ||
126 | (defcustom PC-include-file-path '("/usr/include" "/usr/local/include") | |
95983b95 | 127 | "A list of directories in which to look for include files. |
92677e25 SM |
128 | If nil, means use the colon-separated path in the variable $INCPATH instead." |
129 | :type '(repeat directory) | |
130 | :group 'partial-completion) | |
131 | ||
92677e25 | 132 | (defcustom PC-disable-includes nil |
95983b95 | 133 | "If non-nil, include-file support in \\[find-file] is disabled." |
92677e25 SM |
134 | :type 'boolean |
135 | :group 'partial-completion) | |
b545bfe6 JB |
136 | |
137 | (defvar PC-default-bindings t | |
92677e25 | 138 | "If non-nil, default partial completion key bindings are suppressed.") |
356b1352 GM |
139 | |
140 | (defvar PC-env-vars-alist nil | |
141 | "A list of the environment variable names and values.") | |
142 | ||
92677e25 | 143 | \f |
92677e25 SM |
144 | (defun PC-bindings (bind) |
145 | (let ((completion-map minibuffer-local-completion-map) | |
146 | (must-match-map minibuffer-local-must-match-map)) | |
147 | (cond ((not bind) | |
148 | ;; These bindings are the default bindings. It would be better to | |
149 | ;; restore the previous bindings. | |
fff1a077 CY |
150 | (define-key read-expression-map "\e\t" 'lisp-complete-symbol) |
151 | ||
92677e25 SM |
152 | (define-key completion-map "\t" 'minibuffer-complete) |
153 | (define-key completion-map " " 'minibuffer-complete-word) | |
154 | (define-key completion-map "?" 'minibuffer-completion-help) | |
155 | ||
92677e25 SM |
156 | (define-key must-match-map "\r" 'minibuffer-complete-and-exit) |
157 | (define-key must-match-map "\n" 'minibuffer-complete-and-exit) | |
92677e25 | 158 | |
6e52f715 | 159 | (define-key global-map [remap lisp-complete-symbol] nil)) |
92677e25 | 160 | (PC-default-bindings |
fff1a077 CY |
161 | (define-key read-expression-map "\e\t" 'PC-lisp-complete-symbol) |
162 | ||
92677e25 SM |
163 | (define-key completion-map "\t" 'PC-complete) |
164 | (define-key completion-map " " 'PC-complete-word) | |
165 | (define-key completion-map "?" 'PC-completion-help) | |
166 | ||
167 | (define-key completion-map "\e\t" 'PC-complete) | |
168 | (define-key completion-map "\e " 'PC-complete-word) | |
169 | (define-key completion-map "\e\r" 'PC-force-complete-and-exit) | |
170 | (define-key completion-map "\e\n" 'PC-force-complete-and-exit) | |
171 | (define-key completion-map "\e?" 'PC-completion-help) | |
172 | ||
92677e25 SM |
173 | (define-key must-match-map "\r" 'PC-complete-and-exit) |
174 | (define-key must-match-map "\n" 'PC-complete-and-exit) | |
92677e25 | 175 | |
92677e25 SM |
176 | (define-key must-match-map "\e\r" 'PC-complete-and-exit) |
177 | (define-key must-match-map "\e\n" 'PC-complete-and-exit) | |
92677e25 | 178 | |
6e52f715 | 179 | (define-key global-map [remap lisp-complete-symbol] 'PC-lisp-complete-symbol))))) |
92677e25 | 180 | |
1fbd1830 GM |
181 | (defvar PC-do-completion-end nil |
182 | "Internal variable used by `PC-do-completion'.") | |
183 | ||
e00c1b9c GM |
184 | (make-variable-buffer-local 'PC-do-completion-end) |
185 | ||
d73bbb35 GM |
186 | (defvar PC-goto-end nil |
187 | "Internal variable set in `PC-do-completion', used in | |
188 | `choose-completion-string-functions'.") | |
189 | ||
e00c1b9c GM |
190 | (make-variable-buffer-local 'PC-goto-end) |
191 | ||
cc7e4da0 SM |
192 | ;;;###autoload |
193 | (define-minor-mode partial-completion-mode | |
194 | "Toggle Partial Completion mode. | |
195 | With prefix ARG, turn Partial Completion mode on if ARG is positive. | |
196 | ||
197 | When Partial Completion mode is enabled, TAB (or M-TAB if `PC-meta-flag' is | |
198 | nil) is enhanced so that if some string is divided into words and each word is | |
199 | delimited by a character in `PC-word-delimiters', partial words are completed | |
200 | as much as possible and `*' characters are treated likewise in file names. | |
201 | ||
202 | For example, M-x p-c-m expands to M-x partial-completion-mode since no other | |
203 | command begins with that sequence of characters, and | |
204 | \\[find-file] f_b.c TAB might complete to foo_bar.c if that file existed and no | |
08fd202a | 205 | other file in that directory begins with that sequence of characters. |
cc7e4da0 | 206 | |
2ad432ab | 207 | Unless `PC-disable-includes' is non-nil, the `<...>' sequence is interpreted |
cc7e4da0 | 208 | specially in \\[find-file]. For example, |
2ad432ab | 209 | \\[find-file] <sys/time.h> RET finds the file `/usr/include/sys/time.h'. |
10156852 EZ |
210 | See also the variable `PC-include-file-path'. |
211 | ||
212 | Partial Completion mode extends the meaning of `completion-auto-help' (which | |
6c76000b RS |
213 | see), so that if it is neither nil nor t, Emacs shows the `*Completions*' |
214 | buffer only on the second attempt to complete. That is, if TAB finds nothing | |
215 | to complete, the first TAB just says \"Next char not unique\" and the | |
fddf97f6 | 216 | second TAB brings up the `*Completions*' buffer." |
00089cad | 217 | :global t :group 'partial-completion |
cc7e4da0 SM |
218 | ;; Deal with key bindings... |
219 | (PC-bindings partial-completion-mode) | |
220 | ;; Deal with include file feature... | |
221 | (cond ((not partial-completion-mode) | |
f679907b | 222 | (remove-hook 'find-file-not-found-functions 'PC-look-for-include-file)) |
cc7e4da0 | 223 | ((not PC-disable-includes) |
f679907b | 224 | (add-hook 'find-file-not-found-functions 'PC-look-for-include-file))) |
8d85a565 SM |
225 | ;; Adjust the completion selection in *Completion* buffers to the way |
226 | ;; we work. The default minibuffer completion code only completes the | |
227 | ;; text before point and leaves the text after point alone (new in | |
228 | ;; Emacs-22). In contrast we use the whole text and we even sometimes | |
229 | ;; move point to a place before EOB, to indicate the first position where | |
230 | ;; there's a difference, so when the user uses choose-completion, we have | |
231 | ;; to trick choose-completion into replacing the whole minibuffer text | |
232 | ;; rather than only the text before point. --Stef | |
233 | (funcall | |
234 | (if partial-completion-mode 'add-hook 'remove-hook) | |
235 | 'choose-completion-string-functions | |
d5e63715 | 236 | (lambda (choice buffer &rest ignored) |
d73bbb35 GM |
237 | ;; When completing M-: (lisp- ) with point before the ), it is |
238 | ;; not appropriate to go to point-max (unlike the filename case). | |
239 | (if (and (not PC-goto-end) | |
d5e63715 | 240 | (minibufferp buffer)) |
d73bbb35 | 241 | (goto-char (point-max)) |
1fbd1830 | 242 | ;; Need a similar hack for the non-minibuffer-case -- gm. |
660fd6fb GM |
243 | (when PC-do-completion-end |
244 | (goto-char PC-do-completion-end) | |
245 | (setq PC-do-completion-end nil))) | |
d73bbb35 | 246 | (setq PC-goto-end nil) |
d46104ae | 247 | nil)) |
8d85a565 SM |
248 | ;; Build the env-completion and mapping table. |
249 | (when (and partial-completion-mode (null PC-env-vars-alist)) | |
250 | (setq PC-env-vars-alist | |
251 | (mapcar (lambda (string) | |
252 | (let ((d (string-match "=" string))) | |
253 | (cons (concat "$" (substring string 0 d)) | |
254 | (and d (substring string (1+ d)))))) | |
255 | process-environment)))) | |
cc7e4da0 | 256 | |
92677e25 | 257 | \f |
b545bfe6 JB |
258 | (defun PC-complete () |
259 | "Like minibuffer-complete, but allows \"b--di\"-style abbreviations. | |
260 | For example, \"M-x b--di\" would match `byte-recompile-directory', or any | |
261 | name which consists of three or more words, the first beginning with \"b\" | |
262 | and the third beginning with \"di\". | |
263 | ||
264 | The pattern \"b--d\" is ambiguous for `byte-recompile-directory' and | |
265 | `beginning-of-defun', so this would produce a list of completions | |
266 | just like when normal Emacs completions are ambiguous. | |
267 | ||
268 | Word-delimiters for the purposes of Partial Completion are \"-\", \"_\", | |
269 | \".\", and SPC." | |
270 | (interactive) | |
271 | (if (PC-was-meta-key) | |
272 | (minibuffer-complete) | |
95c0d3a7 RS |
273 | ;; If the previous command was not this one, |
274 | ;; never scroll, always retry completion. | |
275 | (or (eq last-command this-command) | |
276 | (setq minibuffer-scroll-window nil)) | |
277 | (let ((window minibuffer-scroll-window)) | |
278 | ;; If there's a fresh completion window with a live buffer, | |
279 | ;; and this command is repeated, scroll that window. | |
280 | (if (and window (window-buffer window) | |
281 | (buffer-name (window-buffer window))) | |
f679907b | 282 | (with-current-buffer (window-buffer window) |
95c0d3a7 RS |
283 | (if (pos-visible-in-window-p (point-max) window) |
284 | (set-window-start window (point-min) nil) | |
285 | (scroll-other-window))) | |
286 | (PC-do-completion nil))))) | |
b545bfe6 JB |
287 | |
288 | ||
289 | (defun PC-complete-word () | |
290 | "Like `minibuffer-complete-word', but allows \"b--di\"-style abbreviations. | |
291 | See `PC-complete' for details. | |
292 | This can be bound to other keys, like `-' and `.', if you wish." | |
293 | (interactive) | |
294 | (if (eq (PC-was-meta-key) PC-meta-flag) | |
8989a920 | 295 | (if (eq last-command-event ? ) |
b545bfe6 JB |
296 | (minibuffer-complete-word) |
297 | (self-insert-command 1)) | |
298 | (self-insert-command 1) | |
299 | (if (eobp) | |
300 | (PC-do-completion 'word)))) | |
301 | ||
302 | ||
303 | (defun PC-complete-space () | |
304 | "Like `minibuffer-complete-word', but allows \"b--di\"-style abbreviations. | |
305 | See `PC-complete' for details. | |
306 | This is suitable for binding to other keys which should act just like SPC." | |
307 | (interactive) | |
308 | (if (eq (PC-was-meta-key) PC-meta-flag) | |
309 | (minibuffer-complete-word) | |
310 | (insert " ") | |
311 | (if (eobp) | |
312 | (PC-do-completion 'word)))) | |
313 | ||
314 | ||
315 | (defun PC-complete-and-exit () | |
316 | "Like `minibuffer-complete-and-exit', but allows \"b--di\"-style abbreviations. | |
317 | See `PC-complete' for details." | |
318 | (interactive) | |
319 | (if (eq (PC-was-meta-key) PC-meta-flag) | |
320 | (minibuffer-complete-and-exit) | |
321 | (PC-do-complete-and-exit))) | |
322 | ||
323 | (defun PC-force-complete-and-exit () | |
324 | "Like `minibuffer-complete-and-exit', but allows \"b--di\"-style abbreviations. | |
325 | See `PC-complete' for details." | |
326 | (interactive) | |
327 | (let ((minibuffer-completion-confirm nil)) | |
328 | (PC-do-complete-and-exit))) | |
329 | ||
330 | (defun PC-do-complete-and-exit () | |
f15ca944 SM |
331 | (cond |
332 | ((= (point-max) (minibuffer-prompt-end)) | |
333 | ;; Duplicate the "bug" that Info-menu relies on... | |
334 | (exit-minibuffer)) | |
f8d106b0 | 335 | ((eq minibuffer-completion-confirm 'confirm) |
f15ca944 SM |
336 | (if (or (eq last-command this-command) |
337 | (test-completion (field-string) | |
338 | minibuffer-completion-table | |
339 | minibuffer-completion-predicate)) | |
340 | (exit-minibuffer) | |
341 | (PC-temp-minibuffer-message " [Confirm]"))) | |
f8d106b0 CY |
342 | ((eq minibuffer-completion-confirm 'confirm-after-completion) |
343 | ;; Similar to the above, but only if trying to exit immediately | |
344 | ;; after typing TAB (this catches most minibuffer typos). | |
a8851092 | 345 | (if (and (memq last-command minibuffer-confirm-exit-commands) |
f8d106b0 CY |
346 | (not (test-completion (field-string) |
347 | minibuffer-completion-table | |
348 | minibuffer-completion-predicate))) | |
349 | (PC-temp-minibuffer-message " [Confirm]") | |
350 | (exit-minibuffer))) | |
f15ca944 | 351 | (t |
b545bfe6 JB |
352 | (let ((flag (PC-do-completion 'exit))) |
353 | (and flag | |
354 | (if (or (eq flag 'complete) | |
355 | (not minibuffer-completion-confirm)) | |
356 | (exit-minibuffer) | |
f15ca944 | 357 | (PC-temp-minibuffer-message " [Confirm]"))))))) |
b545bfe6 JB |
358 | |
359 | ||
360 | (defun PC-completion-help () | |
361 | "Like `minibuffer-completion-help', but allows \"b--di\"-style abbreviations. | |
362 | See `PC-complete' for details." | |
363 | (interactive) | |
364 | (if (eq (PC-was-meta-key) PC-meta-flag) | |
365 | (minibuffer-completion-help) | |
366 | (PC-do-completion 'help))) | |
367 | ||
368 | (defun PC-was-meta-key () | |
369 | (or (/= (length (this-command-keys)) 1) | |
370 | (let ((key (aref (this-command-keys) 0))) | |
371 | (if (integerp key) | |
372 | (>= key 128) | |
373 | (not (null (memq 'meta (event-modifiers key)))))))) | |
374 | ||
375 | ||
376 | (defvar PC-ignored-extensions 'empty-cache) | |
377 | (defvar PC-delims 'empty-cache) | |
378 | (defvar PC-ignored-regexp nil) | |
379 | (defvar PC-word-failed-flag nil) | |
380 | (defvar PC-delim-regex nil) | |
381 | (defvar PC-ndelims-regex nil) | |
382 | (defvar PC-delims-list nil) | |
383 | ||
249f7eeb | 384 | (defvar PC-completion-as-file-name-predicate |
f679907b SM |
385 | (lambda () minibuffer-completing-file-name) |
386 | "A function testing whether a minibuffer completion now will work filename-style. | |
249f7eeb RS |
387 | The function takes no arguments, and typically looks at the value |
388 | of `minibuffer-completion-table' and the minibuffer contents.") | |
3985c790 | 389 | |
08fd202a EZ |
390 | ;; Returns the sequence of non-delimiter characters that follow regexp in string. |
391 | (defun PC-chunk-after (string regexp) | |
392 | (if (not (string-match regexp string)) | |
f6e7ec02 DG |
393 | (let ((message "String %s didn't match regexp %s")) |
394 | (message message string regexp) | |
395 | (error message string regexp))) | |
08fd202a EZ |
396 | (let ((result (substring string (match-end 0)))) |
397 | ;; result may contain multiple chunks | |
398 | (if (string-match PC-delim-regex result) | |
399 | (setq result (substring result 0 (match-beginning 0)))) | |
400 | result)) | |
401 | ||
402 | (defun test-completion-ignore-case (str table pred) | |
403 | "Like `test-completion', but ignores case when possible." | |
404 | ;; Binding completion-ignore-case to nil ensures, for compatibility with | |
405 | ;; standard completion, that the return value is exactly one of the | |
406 | ;; possibilities. Do this binding only if pred is nil, out of paranoia; | |
407 | ;; perhaps it is safe even if pred is non-nil. | |
408 | (if pred | |
409 | (test-completion str table pred) | |
410 | (let ((completion-ignore-case nil)) | |
411 | (test-completion str table pred)))) | |
412 | ||
2ef31c1c MR |
413 | ;; The following function is an attempt to work around two problems: |
414 | ||
415 | ;; (1) When complete.el was written, (try-completion "" '(("") (""))) used to | |
416 | ;; return the value "". With a change from 2002-07-07 it returns t which caused | |
417 | ;; `PC-lisp-complete-symbol' to fail with a "Wrong type argument: sequencep, t" | |
418 | ;; error. `PC-try-completion' returns STRING in this case. | |
419 | ||
420 | ;; (2) (try-completion "" '((""))) returned t before the above-mentioned change. | |
421 | ;; Since `PC-chop-word' operates on the return value of `try-completion' this | |
422 | ;; case might have provoked a similar error as in (1). `PC-try-completion' | |
423 | ;; returns "" instead. I don't know whether this is a real problem though. | |
424 | ||
425 | ;; Since `PC-try-completion' is not a guaranteed to fix these bugs reliably, you | |
426 | ;; should try to look at the following discussions when you encounter problems: | |
427 | ;; - emacs-pretest-bug ("Partial Completion" starting 2007-02-23), | |
428 | ;; - emacs-devel ("[address-of-OP: Partial completion]" starting 2007-02-24), | |
429 | ;; - emacs-devel ("[address-of-OP: EVAL and mouse selection in *Completions*]" | |
430 | ;; starting 2007-03-05). | |
431 | (defun PC-try-completion (string alist &optional predicate) | |
432 | "Like `try-completion' but return STRING instead of t." | |
433 | (let ((result (try-completion string alist predicate))) | |
434 | (if (eq result t) string result))) | |
435 | ||
d73bbb35 GM |
436 | ;; TODO document MODE magic... |
437 | (defun PC-do-completion (&optional mode beg end goto-end) | |
438 | "Internal function to do the work of partial completion. | |
439 | Text to be completed lies between BEG and END. Normally when | |
440 | replacing text in the minibuffer, this function replaces up to | |
441 | point-max (as is appropriate for completing a file name). If | |
442 | GOTO-END is non-nil, however, it instead replaces up to END." | |
f08d8594 | 443 | (or beg (setq beg (minibuffer-prompt-end))) |
b545bfe6 | 444 | (or end (setq end (point-max))) |
b1916c6e RS |
445 | (let* ((table (if (eq minibuffer-completion-table 'read-file-name-internal) |
446 | 'PC-read-file-name-internal | |
447 | minibuffer-completion-table)) | |
b545bfe6 | 448 | (pred minibuffer-completion-predicate) |
249f7eeb | 449 | (filename (funcall PC-completion-as-file-name-predicate)) |
8dbe4a8c | 450 | (dirname nil) ; non-nil only if a filename is being completed |
a7b52a1e MR |
451 | ;; The following used to be "(dirlength 0)" which caused the erasure of |
452 | ;; the entire buffer text before `point' when inserting a completion | |
453 | ;; into a buffer. | |
454 | dirlength | |
b545bfe6 JB |
455 | (str (buffer-substring beg end)) |
456 | (incname (and filename (string-match "<\\([^\"<>]*\\)>?$" str))) | |
457 | (ambig nil) | |
35731e3b | 458 | basestr origstr |
356b1352 | 459 | env-on |
b545bfe6 JB |
460 | regex |
461 | p offset | |
03ed845e | 462 | abbreviated |
b545bfe6 JB |
463 | (poss nil) |
464 | helpposs | |
465 | (case-fold-search completion-ignore-case)) | |
466 | ||
467 | ;; Check if buffer contents can already be considered complete | |
468 | (if (and (eq mode 'exit) | |
b89d8a77 | 469 | (test-completion str table pred)) |
1aaaf8ea | 470 | 'complete |
b545bfe6 JB |
471 | |
472 | ;; Do substitutions in directory names | |
473 | (and filename | |
356b1352 GM |
474 | (setq basestr (or (file-name-directory str) "")) |
475 | (setq dirlength (length basestr)) | |
476 | ;; Do substitutions in directory names | |
477 | (setq p (substitute-in-file-name basestr)) | |
478 | (not (string-equal basestr p)) | |
479 | (setq str (concat p (file-name-nondirectory str))) | |
480 | (progn | |
b545bfe6 | 481 | (delete-region beg end) |
356b1352 GM |
482 | (insert str) |
483 | (setq end (+ beg (length str))))) | |
8e28519a | 484 | |
b545bfe6 JB |
485 | ;; Prepare various delimiter strings |
486 | (or (equal PC-word-delimiters PC-delims) | |
487 | (setq PC-delims PC-word-delimiters | |
488 | PC-delim-regex (concat "[" PC-delims "]") | |
489 | PC-ndelims-regex (concat "[^" PC-delims "]*") | |
490 | PC-delims-list (append PC-delims nil))) | |
491 | ||
c2801b50 | 492 | ;; Add wildcards if necessary |
8e28519a NF |
493 | (and filename |
494 | (let ((dir (file-name-directory str)) | |
93f4fe7a | 495 | (file (file-name-nondirectory str)) |
2f65ac9e SM |
496 | ;; The base dir for file-completion was passed in `predicate'. |
497 | (default-directory (if (stringp pred) (expand-file-name pred) | |
498 | default-directory))) | |
8e28519a NF |
499 | (while (and (stringp dir) (not (file-directory-p dir))) |
500 | (setq dir (directory-file-name dir)) | |
501 | (setq file (concat (replace-regexp-in-string | |
502 | PC-delim-regex "*\\&" | |
503 | (file-name-nondirectory dir)) | |
504 | "*/" file)) | |
505 | (setq dir (file-name-directory dir))) | |
35731e3b | 506 | (setq origstr str str (concat dir file)))) |
8e28519a | 507 | |
b545bfe6 JB |
508 | ;; Look for wildcard expansions in directory name |
509 | (and filename | |
510 | (string-match "\\*.*/" str) | |
511 | (let ((pat str) | |
2f65ac9e SM |
512 | ;; The base dir for file-completion was passed in `predicate'. |
513 | (default-directory (if (stringp pred) (expand-file-name pred) | |
514 | default-directory)) | |
b545bfe6 JB |
515 | files) |
516 | (setq p (1+ (string-match "/[^/]*\\'" pat))) | |
517 | (while (setq p (string-match PC-delim-regex pat p)) | |
518 | (setq pat (concat (substring pat 0 p) | |
519 | "*" | |
520 | (substring pat p)) | |
521 | p (+ p 2))) | |
da3e76dc | 522 | (setq files (file-expand-wildcards (concat pat "*"))) |
b545bfe6 JB |
523 | (if files |
524 | (let ((dir (file-name-directory (car files))) | |
525 | (p files)) | |
526 | (while (and (setq p (cdr p)) | |
527 | (equal dir (file-name-directory (car p))))) | |
528 | (if p | |
2f65ac9e SM |
529 | (setq filename nil table nil |
530 | pred (if (stringp pred) nil pred) | |
b545bfe6 JB |
531 | ambig t) |
532 | (delete-region beg end) | |
533 | (setq str (concat dir (file-name-nondirectory str))) | |
534 | (insert str) | |
535 | (setq end (+ beg (length str))))) | |
35731e3b | 536 | (if origstr |
b1916c6e RS |
537 | ;; If the wildcards were introduced by us, it's |
538 | ;; possible that PC-read-file-name-internal can | |
539 | ;; still find matches for the original string | |
540 | ;; even if we couldn't, so remove the added | |
541 | ;; wildcards. | |
35731e3b | 542 | (setq str origstr) |
2f65ac9e SM |
543 | (setq filename nil table nil |
544 | pred (if (stringp pred) nil pred)))))) | |
b545bfe6 JB |
545 | |
546 | ;; Strip directory name if appropriate | |
547 | (if filename | |
548 | (if incname | |
549 | (setq basestr (substring str incname) | |
550 | dirname (substring str 0 incname)) | |
551 | (setq basestr (file-name-nondirectory str) | |
b38d1cc7 EZ |
552 | dirname (file-name-directory str)) |
553 | ;; Make sure str is consistent with its directory and basename | |
554 | ;; parts. This is important on DOZe'NT systems when str only | |
555 | ;; includes a drive letter, like in "d:". | |
556 | (setq str (concat dirname basestr))) | |
b545bfe6 JB |
557 | (setq basestr str)) |
558 | ||
559 | ;; Convert search pattern to a standard regular expression | |
560 | (setq regex (regexp-quote basestr) | |
561 | offset (if (and (> (length regex) 0) | |
562 | (not (eq (aref basestr 0) ?\*)) | |
563 | (or (eq PC-first-char t) | |
564 | (and PC-first-char filename))) 1 0) | |
565 | p offset) | |
566 | (while (setq p (string-match PC-delim-regex regex p)) | |
567 | (if (eq (aref regex p) ? ) | |
568 | (setq regex (concat (substring regex 0 p) | |
569 | PC-ndelims-regex | |
570 | PC-delim-regex | |
571 | (substring regex (1+ p))) | |
572 | p (+ p (length PC-ndelims-regex) (length PC-delim-regex))) | |
573 | (let ((bump (if (memq (aref regex p) | |
574 | '(?$ ?^ ?\. ?* ?+ ?? ?[ ?] ?\\)) | |
575 | -1 0))) | |
576 | (setq regex (concat (substring regex 0 (+ p bump)) | |
577 | PC-ndelims-regex | |
578 | (substring regex (+ p bump))) | |
579 | p (+ p (length PC-ndelims-regex) 1))))) | |
580 | (setq p 0) | |
581 | (if filename | |
582 | (while (setq p (string-match "\\\\\\*" regex p)) | |
583 | (setq regex (concat (substring regex 0 p) | |
584 | "[^/]*" | |
585 | (substring regex (+ p 2)))))) | |
586 | ;;(setq the-regex regex) | |
587 | (setq regex (concat "\\`" regex)) | |
588 | ||
356b1352 GM |
589 | (and (> (length basestr) 0) |
590 | (= (aref basestr 0) ?$) | |
591 | (setq env-on t | |
592 | table PC-env-vars-alist | |
593 | pred nil)) | |
594 | ||
b545bfe6 | 595 | ;; Find an initial list of possible completions |
03ed845e | 596 | (unless (setq p (string-match (concat PC-delim-regex |
b545bfe6 JB |
597 | (if filename "\\|\\*" "")) |
598 | str | |
03ed845e | 599 | (+ (length dirname) offset))) |
b545bfe6 JB |
600 | |
601 | ;; Minibuffer contains no hyphens -- simple case! | |
03ed845e | 602 | (setq poss (all-completions (if env-on basestr str) |
b545bfe6 JB |
603 | table |
604 | pred)) | |
9a8b3a5c | 605 | (unless (or poss (string-equal str "")) |
03ed845e | 606 | ;; Try completion as an abbreviation, e.g. "mvb" -> |
9a8b3a5c RF |
607 | ;; "m-v-b" -> "multiple-value-bind", but only for |
608 | ;; non-empty strings. | |
03ed845e RS |
609 | (setq origstr str |
610 | abbreviated t) | |
611 | (if filename | |
612 | (cond | |
613 | ;; "alpha" or "/alpha" -> expand whole path. | |
614 | ((string-match "^/?\\([A-Za-z0-9]+\\)$" str) | |
615 | (setq | |
616 | basestr "" | |
617 | p nil | |
da3e76dc | 618 | poss (file-expand-wildcards |
03ed845e RS |
619 | (concat "/" |
620 | (mapconcat #'list (match-string 1 str) "*/") | |
621 | "*")) | |
622 | beg (1- beg))) | |
623 | ;; Alphanumeric trailer -> expand trailing file | |
624 | ((string-match "^\\(.+/\\)\\([A-Za-z0-9]+\\)$" str) | |
625 | (setq regex (concat "\\`" | |
626 | (mapconcat #'list | |
627 | (match-string 2 str) | |
628 | "[A-Za-z0-9]*[^A-Za-z0-9]")) | |
629 | p (1+ (length (match-string 1 str)))))) | |
31d24a4b JB |
630 | (setq regex (concat "\\`" (mapconcat (lambda (c) |
631 | (regexp-quote (string c))) | |
632 | str "[^-]*-")) | |
633 | p 1)))) | |
03ed845e | 634 | (when p |
b545bfe6 JB |
635 | ;; Use all-completions to do an initial cull. This is a big win, |
636 | ;; since all-completions is written in C! | |
356b1352 GM |
637 | (let ((compl (all-completions (if env-on |
638 | (file-name-nondirectory (substring str 0 p)) | |
639 | (substring str 0 p)) | |
4a63ceb8 SM |
640 | table |
641 | pred))) | |
b545bfe6 | 642 | (setq p compl) |
03ed845e RS |
643 | (when (and compl abbreviated) |
644 | (if filename | |
645 | (progn | |
646 | (setq p nil) | |
647 | (dolist (x compl) | |
648 | (when (string-match regex x) | |
649 | (push x p))) | |
650 | (setq basestr (try-completion "" p))) | |
651 | (setq basestr (mapconcat 'list str "-")) | |
652 | (delete-region beg end) | |
653 | (setq end (+ beg (length basestr))) | |
654 | (insert basestr)))) | |
b545bfe6 JB |
655 | (while p |
656 | (and (string-match regex (car p)) | |
fc21ed03 KH |
657 | (progn |
658 | (set-text-properties 0 (length (car p)) '() (car p)) | |
659 | (setq poss (cons (car p) poss)))) | |
03ed845e | 660 | (setq p (cdr p)))) |
b545bfe6 | 661 | |
85066604 MC |
662 | ;; If table had duplicates, they can be here. |
663 | (delete-dups poss) | |
664 | ||
4a63ceb8 SM |
665 | ;; Handle completion-ignored-extensions |
666 | (and filename | |
667 | (not (eq mode 'help)) | |
668 | (let ((p2 poss)) | |
669 | ||
670 | ;; Build a regular expression representing the extensions list | |
671 | (or (equal completion-ignored-extensions PC-ignored-extensions) | |
672 | (setq PC-ignored-regexp | |
673 | (concat "\\(" | |
674 | (mapconcat | |
675 | 'regexp-quote | |
676 | (setq PC-ignored-extensions | |
677 | completion-ignored-extensions) | |
678 | "\\|") | |
679 | "\\)\\'"))) | |
680 | ||
681 | ;; Check if there are any without an ignored extension. | |
682 | ;; Also ignore `.' and `..'. | |
683 | (setq p nil) | |
684 | (while p2 | |
685 | (or (string-match PC-ignored-regexp (car p2)) | |
686 | (string-match "\\(\\`\\|/\\)[.][.]?/?\\'" (car p2)) | |
687 | (setq p (cons (car p2) p))) | |
688 | (setq p2 (cdr p2))) | |
689 | ||
690 | ;; If there are "good" names, use them | |
691 | (and p (setq poss p)))) | |
692 | ||
b545bfe6 | 693 | ;; Now we have a list of possible completions |
03ed845e | 694 | |
b545bfe6 JB |
695 | (cond |
696 | ||
697 | ;; No valid completions found | |
698 | ((null poss) | |
699 | (if (and (eq mode 'word) | |
700 | (not PC-word-failed-flag)) | |
701 | (let ((PC-word-failed-flag t)) | |
d355a0b7 | 702 | (delete-char -1) |
b545bfe6 | 703 | (PC-do-completion 'word)) |
03ed845e RS |
704 | (when abbreviated |
705 | (delete-region beg end) | |
706 | (insert origstr)) | |
b545bfe6 JB |
707 | (beep) |
708 | (PC-temp-minibuffer-message (if ambig | |
80f14e53 | 709 | " [Ambiguous dir name]" |
b545bfe6 | 710 | (if (eq mode 'help) |
80f14e53 RS |
711 | " [No completions]" |
712 | " [No match]"))) | |
b545bfe6 JB |
713 | nil)) |
714 | ||
715 | ;; More than one valid completion found | |
716 | ((or (cdr (setq helpposs poss)) | |
717 | (memq mode '(help word))) | |
718 | ||
b545bfe6 JB |
719 | ;; Is the actual string one of the possible completions? |
720 | (setq p (and (not (eq mode 'help)) poss)) | |
721 | (while (and p | |
fc21ed03 | 722 | (not (string-equal (car p) basestr))) |
b545bfe6 | 723 | (setq p (cdr p))) |
80f14e53 RS |
724 | (and p (null mode) |
725 | (PC-temp-minibuffer-message " [Complete, but not unique]")) | |
726 | (if (and p | |
727 | (not (and (null mode) | |
728 | (eq this-command last-command)))) | |
729 | t | |
b545bfe6 JB |
730 | |
731 | ;; If ambiguous, try for a partial completion | |
732 | (let ((improved nil) | |
733 | prefix | |
734 | (pt nil) | |
735 | (skip "\\`")) | |
736 | ||
737 | ;; Check if next few letters are the same in all cases | |
738 | (if (and (not (eq mode 'help)) | |
2ef31c1c MR |
739 | (setq prefix (PC-try-completion |
740 | (PC-chunk-after basestr skip) poss))) | |
b545bfe6 JB |
741 | (let ((first t) i) |
742 | (if (eq mode 'word) | |
743 | (setq prefix (PC-chop-word prefix basestr))) | |
744 | (goto-char (+ beg (length dirname))) | |
745 | (while (and (progn | |
08fd202a | 746 | (setq i 0) ; index into prefix string |
b545bfe6 JB |
747 | (while (< i (length prefix)) |
748 | (if (and (< (point) end) | |
1f4e4f86 CY |
749 | (or (eq (downcase (aref prefix i)) |
750 | (downcase (following-char))) | |
751 | (and (looking-at " ") | |
752 | (memq (aref prefix i) | |
753 | PC-delims-list)))) | |
754 | ;; replace " " by the actual delimiter | |
755 | ;; or input char by prefix char | |
08fd202a | 756 | (progn |
1f4e4f86 CY |
757 | (delete-char 1) |
758 | (insert (substring prefix i (1+ i)))) | |
759 | ;; insert a new character | |
760 | (progn | |
761 | (and filename (looking-at "\\*") | |
762 | (progn | |
763 | (delete-char 1) | |
764 | (setq end (1- end)))) | |
765 | (setq improved t) | |
766 | (insert (substring prefix i (1+ i))) | |
767 | (setq end (1+ end)))) | |
b545bfe6 | 768 | (setq i (1+ i))) |
fddf97f6 | 769 | (or pt (setq pt (point))) |
b545bfe6 JB |
770 | (looking-at PC-delim-regex)) |
771 | (setq skip (concat skip | |
772 | (regexp-quote prefix) | |
773 | PC-ndelims-regex) | |
2ef31c1c | 774 | prefix (PC-try-completion |
08fd202a EZ |
775 | (PC-chunk-after |
776 | ;; not basestr, because that does | |
777 | ;; not reflect insertions | |
778 | (buffer-substring | |
779 | (+ beg (length dirname)) end) | |
780 | skip) | |
b545bfe6 | 781 | (mapcar |
4a63ceb8 SM |
782 | (lambda (x) |
783 | (when (string-match skip x) | |
784 | (substring x (match-end 0)))) | |
b545bfe6 JB |
785 | poss))) |
786 | (or (> i 0) (> (length prefix) 0)) | |
787 | (or (not (eq mode 'word)) | |
788 | (and first (> (length prefix) 0) | |
789 | (setq first nil | |
790 | prefix (substring prefix 0 1)))))) | |
791 | (goto-char (if (eq mode 'word) end | |
792 | (or pt beg))))) | |
793 | ||
794 | (if (and (eq mode 'word) | |
795 | (not PC-word-failed-flag)) | |
796 | ||
797 | (if improved | |
798 | ||
799 | ;; We changed it... would it be complete without the space? | |
da0bed93 SM |
800 | (if (test-completion (buffer-substring |
801 | (field-beginning) (1- end)) | |
8dbe4a8c | 802 | table pred) |
b545bfe6 JB |
803 | (delete-region (1- end) end))) |
804 | ||
805 | (if improved | |
806 | ||
807 | ;; We changed it... enough to be complete? | |
808 | (and (eq mode 'exit) | |
08fd202a | 809 | (test-completion-ignore-case (field-string) table pred)) |
b545bfe6 JB |
810 | |
811 | ;; If totally ambiguous, display a list of completions | |
cc7e4da0 SM |
812 | (if (or (eq completion-auto-help t) |
813 | (and completion-auto-help | |
814 | (eq last-command this-command)) | |
b545bfe6 | 815 | (eq mode 'help)) |
8dbe4a8c GM |
816 | (let ((prompt-end (minibuffer-prompt-end))) |
817 | (with-output-to-temp-buffer "*Completions*" | |
818 | (display-completion-list (sort helpposs 'string-lessp)) | |
e00c1b9c GM |
819 | (setq PC-do-completion-end end |
820 | PC-goto-end goto-end) | |
8dbe4a8c GM |
821 | (with-current-buffer standard-output |
822 | ;; Record which part of the buffer we are completing | |
823 | ;; so that choosing a completion from the list | |
824 | ;; knows how much old text to replace. | |
825 | ;; This was briefly nil in the non-dirname case. | |
826 | ;; However, if one calls PC-lisp-complete-symbol | |
827 | ;; on "(ne-f" with point on the hyphen, PC offers | |
828 | ;; all completions starting with "(ne", some of | |
829 | ;; which do not match the "-f" part (maybe it | |
830 | ;; should not, but it does). In such cases, | |
831 | ;; completion gets confused trying to figure out | |
832 | ;; how much to replace, so we tell it explicitly | |
833 | ;; (ie, the number of chars in the buffer before beg). | |
1fbd1830 GM |
834 | ;; |
835 | ;; Note that choose-completion-string-functions | |
836 | ;; plays around with point. | |
8dbe4a8c GM |
837 | (setq completion-base-size (if dirname |
838 | dirlength | |
e00c1b9c | 839 | (- beg prompt-end)))))) |
f8a3deed MC |
840 | (PC-temp-minibuffer-message " [Next char not unique]")) |
841 | ;; Expansion of filenames is not reversible, | |
842 | ;; so just keep the prefix. | |
03ed845e RS |
843 | (when (and abbreviated filename) |
844 | (delete-region (point) end)) | |
f8a3deed | 845 | nil))))) |
b545bfe6 JB |
846 | |
847 | ;; Only one possible completion | |
848 | (t | |
356b1352 | 849 | (if (and (equal basestr (car poss)) |
03ed845e RS |
850 | (not (and env-on filename)) |
851 | (not abbreviated)) | |
b545bfe6 | 852 | (if (null mode) |
80f14e53 | 853 | (PC-temp-minibuffer-message " [Sole completion]")) |
b545bfe6 | 854 | (delete-region beg end) |
e5fd2822 RS |
855 | (insert (format "%s" |
856 | (if filename | |
857 | (substitute-in-file-name (concat dirname (car poss))) | |
858 | (car poss))))) | |
b545bfe6 JB |
859 | t))))) |
860 | ||
b545bfe6 JB |
861 | (defun PC-chop-word (new old) |
862 | (let ((i -1) | |
863 | (j -1)) | |
864 | (while (and (setq i (string-match PC-delim-regex old (1+ i))) | |
865 | (setq j (string-match PC-delim-regex new (1+ j))))) | |
866 | (if (and j | |
867 | (or (not PC-word-failed-flag) | |
868 | (setq j (string-match PC-delim-regex new (1+ j))))) | |
869 | (substring new 0 (1+ j)) | |
870 | new))) | |
871 | ||
872 | (defvar PC-not-minibuffer nil) | |
873 | ||
92677e25 | 874 | (defun PC-temp-minibuffer-message (message) |
b545bfe6 | 875 | "A Lisp version of `temp_minibuffer_message' from minibuf.c." |
92677e25 | 876 | (cond (PC-not-minibuffer |
f6e7ec02 | 877 | (message "%s" message) |
92677e25 SM |
878 | (sit-for 2) |
879 | (message "")) | |
880 | ((fboundp 'temp-minibuffer-message) | |
881 | (temp-minibuffer-message message)) | |
882 | (t | |
883 | (let ((point-max (point-max))) | |
884 | (save-excursion | |
885 | (goto-char point-max) | |
886 | (insert message)) | |
887 | (let ((inhibit-quit t)) | |
888 | (sit-for 2) | |
889 | (delete-region point-max (point-max)) | |
890 | (when quit-flag | |
891 | (setq quit-flag nil | |
892 | unread-command-events '(7)))))))) | |
b545bfe6 | 893 | |
660fd6fb GM |
894 | ;; Does not need to be buffer-local (?) because only used when one |
895 | ;; PC-l-c-s immediately follows another. | |
8dbe4a8c GM |
896 | (defvar PC-lisp-complete-end nil |
897 | "Internal variable used by `PC-lisp-complete-symbol'.") | |
b545bfe6 JB |
898 | |
899 | (defun PC-lisp-complete-symbol () | |
900 | "Perform completion on Lisp symbol preceding point. | |
901 | That symbol is compared against the symbols that exist | |
902 | and any additional characters determined by what is there | |
903 | are inserted. | |
904 | If the symbol starts just after an open-parenthesis, | |
905 | only symbols with function definitions are considered. | |
906 | Otherwise, all symbols with function definitions, values | |
907 | or properties are considered." | |
908 | (interactive) | |
03ed845e RS |
909 | (let* ((end |
910 | (save-excursion | |
911 | (with-syntax-table lisp-mode-syntax-table | |
912 | (skip-syntax-forward "_w") | |
913 | (point)))) | |
f679907b SM |
914 | (beg (save-excursion |
915 | (with-syntax-table lisp-mode-syntax-table | |
916 | (backward-sexp 1) | |
917 | (while (= (char-syntax (following-char)) ?\') | |
918 | (forward-char 1)) | |
919 | (point)))) | |
b545bfe6 JB |
920 | (minibuffer-completion-table obarray) |
921 | (minibuffer-completion-predicate | |
922 | (if (eq (char-after (1- beg)) ?\() | |
923 | 'fboundp | |
924 | (function (lambda (sym) | |
925 | (or (boundp sym) (fboundp sym) | |
926 | (symbol-plist sym)))))) | |
927 | (PC-not-minibuffer t)) | |
8dbe4a8c GM |
928 | ;; http://lists.gnu.org/archive/html/emacs-devel/2007-03/msg01211.html |
929 | ;; | |
930 | ;; This deals with cases like running PC-l-c-s on "M-: (n-f". | |
931 | ;; The first call to PC-l-c-s expands this to "(ne-f", and moves | |
932 | ;; point to the hyphen [1]. If one calls PC-l-c-s immediately after, | |
933 | ;; then without the last-command check, one is offered all | |
934 | ;; completions of "(ne", which is presumably not what one wants. | |
935 | ;; | |
936 | ;; This is arguably (at least, it seems to be the existing intended | |
fffa137c | 937 | ;; behavior) what one _does_ want if point has been explicitly |
8dbe4a8c GM |
938 | ;; positioned on the hyphen. Note that if PC-do-completion (qv) binds |
939 | ;; completion-base-size to nil, then completion does not replace the | |
940 | ;; correct amount of text in such cases. | |
941 | ;; | |
942 | ;; Neither of these problems occur when using PC for filenames in the | |
943 | ;; minibuffer, because in that case PC-do-completion is called without | |
944 | ;; an explicit value for END, and so uses (point-max). This is fine for | |
945 | ;; a filename, because the end of the filename must be at the end of | |
946 | ;; the minibuffer. The same is not true for lisp symbols. | |
947 | ;; | |
948 | ;; [1] An alternate fix would be to not move point to the hyphen | |
fffa137c | 949 | ;; in such cases, but that would make the behavior different from |
8dbe4a8c GM |
950 | ;; that for filenames. It seems PC moves point to the site of the |
951 | ;; first difference between the possible completions. | |
952 | ;; | |
953 | ;; Alternatively alternatively, maybe end should be computed in | |
fffa137c | 954 | ;; the same way as beg. That would change the behavior though. |
8dbe4a8c | 955 | (if (equal last-command 'PC-lisp-complete-symbol) |
d73bbb35 | 956 | (PC-do-completion nil beg PC-lisp-complete-end t) |
660fd6fb GM |
957 | (if PC-lisp-complete-end |
958 | (move-marker PC-lisp-complete-end end) | |
959 | (setq PC-lisp-complete-end (copy-marker end t))) | |
d73bbb35 | 960 | (PC-do-completion nil beg end t)))) |
b545bfe6 | 961 | |
356b1352 GM |
962 | (defun PC-complete-as-file-name () |
963 | "Perform completion on file names preceding point. | |
964 | Environment vars are converted to their values." | |
965 | (interactive) | |
966 | (let* ((end (point)) | |
967 | (beg (if (re-search-backward "[^\\][ \t\n\"\`\'][^ \t\n\"\`\']" | |
968 | (point-min) t) | |
969 | (+ (point) 2) | |
970 | (point-min))) | |
b1916c6e | 971 | (minibuffer-completion-table 'PC-read-file-name-internal) |
c023a34f | 972 | (minibuffer-completion-predicate nil) |
356b1352 GM |
973 | (PC-not-minibuffer t)) |
974 | (goto-char end) | |
975 | (PC-do-completion nil beg end))) | |
976 | ||
f679907b SM |
977 | ;; Facilities for loading C header files. This is independent from the |
978 | ;; main completion code. See also the variable `PC-include-file-path' | |
979 | ;; at top of this file. | |
b545bfe6 JB |
980 | |
981 | (defun PC-look-for-include-file () | |
982 | (if (string-match "[\"<]\\([^\"<>]*\\)[\">]?$" (buffer-file-name)) | |
983 | (let ((name (substring (buffer-file-name) | |
984 | (match-beginning 1) (match-end 1))) | |
985 | (punc (aref (buffer-file-name) (match-beginning 0))) | |
986 | (path nil) | |
987 | new-buf) | |
988 | (kill-buffer (current-buffer)) | |
989 | (if (equal name "") | |
f679907b | 990 | (with-current-buffer (car (buffer-list)) |
b545bfe6 JB |
991 | (save-excursion |
992 | (beginning-of-line) | |
993 | (if (looking-at | |
994 | "[ \t]*#[ \t]*include[ \t]+[<\"]\\(.+\\)[>\"][ \t]*[\n/]") | |
995 | (setq name (buffer-substring (match-beginning 1) | |
996 | (match-end 1)) | |
997 | punc (char-after (1- (match-beginning 1)))) | |
998 | ;; Suggested by Frank Siebenlist: | |
999 | (if (or (looking-at | |
1000 | "[ \t]*([ \t]*load[ \t]+\"\\([^\"]+\\)\"") | |
1001 | (looking-at | |
1002 | "[ \t]*([ \t]*load-library[ \t]+\"\\([^\"]+\\)\"") | |
1003 | (looking-at | |
1004 | "[ \t]*([ \t]*require[ \t]+'\\([^\t )]+\\)[\t )]")) | |
1005 | (progn | |
1006 | (setq name (buffer-substring (match-beginning 1) | |
1007 | (match-end 1)) | |
1008 | punc ?\< | |
1009 | path load-path) | |
1010 | (if (string-match "\\.elc$" name) | |
1011 | (setq name (substring name 0 -1)) | |
1012 | (or (string-match "\\.el$" name) | |
1013 | (setq name (concat name ".el"))))) | |
1014 | (error "Not on an #include line")))))) | |
5f34457e | 1015 | (or (string-match "\\.[[:alnum:]]+$" name) |
b545bfe6 JB |
1016 | (setq name (concat name ".h"))) |
1017 | (if (eq punc ?\<) | |
1018 | (let ((path (or path (PC-include-file-path)))) | |
1019 | (while (and path | |
1020 | (not (file-exists-p | |
1021 | (concat (file-name-as-directory (car path)) | |
1022 | name)))) | |
1023 | (setq path (cdr path))) | |
1024 | (if path | |
1025 | (setq name (concat (file-name-as-directory (car path)) name)) | |
1026 | (error "No such include file: <%s>" name))) | |
f679907b | 1027 | (let ((dir (with-current-buffer (car (buffer-list)) |
b545bfe6 JB |
1028 | default-directory))) |
1029 | (if (file-exists-p (concat dir name)) | |
1030 | (setq name (concat dir name)) | |
5b0f8cbc | 1031 | (error "No such include file: `%s'" name)))) |
b545bfe6 JB |
1032 | (setq new-buf (get-file-buffer name)) |
1033 | (if new-buf | |
1034 | ;; no need to verify last-modified time for this! | |
1035 | (set-buffer new-buf) | |
f679907b | 1036 | (set-buffer (create-file-buffer name)) |
b545bfe6 JB |
1037 | (erase-buffer) |
1038 | (insert-file-contents name t)) | |
5b0f8cbc KH |
1039 | ;; Returning non-nil with the new buffer current |
1040 | ;; is sufficient to tell find-file to use it. | |
b545bfe6 JB |
1041 | t) |
1042 | nil)) | |
1043 | ||
1044 | (defun PC-include-file-path () | |
1045 | (or PC-include-file-path | |
1046 | (let ((env (getenv "INCPATH")) | |
1047 | (path nil) | |
1048 | pos) | |
1049 | (or env (error "No include file path specified")) | |
1050 | (while (setq pos (string-match ":[^:]+$" env)) | |
1051 | (setq path (cons (substring env (1+ pos)) path) | |
1052 | env (substring env 0 pos))) | |
1053 | path))) | |
1054 | ||
f679907b | 1055 | ;; This is adapted from lib-complete.el, by Mike Williams. |
b545bfe6 JB |
1056 | (defun PC-include-file-all-completions (file search-path &optional full) |
1057 | "Return all completions for FILE in any directory on SEARCH-PATH. | |
8e28519a | 1058 | If optional third argument FULL is non-nil, returned pathnames should be |
b545bfe6 JB |
1059 | absolute rather than relative to some directory on the SEARCH-PATH." |
1060 | (setq search-path | |
cc7e4da0 SM |
1061 | (mapcar (lambda (dir) |
1062 | (if dir (file-name-as-directory dir) default-directory)) | |
b545bfe6 JB |
1063 | search-path)) |
1064 | (if (file-name-absolute-p file) | |
1065 | ;; It's an absolute file name, so don't need search-path | |
1066 | (progn | |
1067 | (setq file (expand-file-name file)) | |
8e28519a | 1068 | (file-name-all-completions |
b545bfe6 JB |
1069 | (file-name-nondirectory file) (file-name-directory file))) |
1070 | (let ((subdir (file-name-directory file)) | |
1071 | (ndfile (file-name-nondirectory file)) | |
1072 | file-lists) | |
1073 | ;; Append subdirectory part to each element of search-path | |
1074 | (if subdir | |
1075 | (setq search-path | |
cc7e4da0 | 1076 | (mapcar (lambda (dir) (concat dir subdir)) |
b545bfe6 JB |
1077 | search-path) |
1078 | file )) | |
1079 | ;; Make list of completions in each directory on search-path | |
1080 | (while search-path | |
1081 | (let* ((dir (car search-path)) | |
1082 | (subdir (if full dir subdir))) | |
1083 | (if (file-directory-p dir) | |
1084 | (progn | |
1085 | (setq file-lists | |
8e28519a | 1086 | (cons |
cc7e4da0 | 1087 | (mapcar (lambda (file) (concat subdir file)) |
8e28519a | 1088 | (file-name-all-completions ndfile |
b545bfe6 JB |
1089 | (car search-path))) |
1090 | file-lists)))) | |
1091 | (setq search-path (cdr search-path)))) | |
1092 | ;; Compress out duplicates while building complete list (slloooow!) | |
1093 | (let ((sorted (sort (apply 'nconc file-lists) | |
cc7e4da0 | 1094 | (lambda (x y) (not (string-lessp x y))))) |
b545bfe6 JB |
1095 | compressed) |
1096 | (while sorted | |
1097 | (if (equal (car sorted) (car compressed)) nil | |
1098 | (setq compressed (cons (car sorted) compressed))) | |
1099 | (setq sorted (cdr sorted))) | |
1100 | compressed)))) | |
1101 | ||
c023a34f | 1102 | (defun PC-read-file-name-internal (string pred action) |
b1916c6e RS |
1103 | "Extend `read-file-name-internal' to handle include files. |
1104 | This is only used by " | |
1105 | (if (string-match "<\\([^\"<>]*\\)>?\\'" string) | |
1106 | (let* ((name (match-string 1 string)) | |
b545bfe6 JB |
1107 | (str2 (substring string (match-beginning 0))) |
1108 | (completion-table | |
414a17c9 SM |
1109 | (mapcar (lambda (x) |
1110 | (format (if (string-match "/\\'" x) "<%s" "<%s>") x)) | |
b545bfe6 JB |
1111 | (PC-include-file-all-completions |
1112 | name (PC-include-file-path))))) | |
30b775ff SM |
1113 | (cond |
1114 | ((not completion-table) nil) | |
1115 | ((eq action 'lambda) (test-completion str2 completion-table nil)) | |
1116 | ((eq action nil) (PC-try-completion str2 completion-table nil)) | |
1117 | ((eq action t) (all-completions str2 completion-table nil)))) | |
c023a34f | 1118 | (read-file-name-internal string pred action))) |
b545bfe6 | 1119 | \f |
92677e25 | 1120 | |
b545bfe6 JB |
1121 | (provide 'complete) |
1122 | ||
a7ad0079 | 1123 | ;; arch-tag: fc7e2768-ff44-4e22-b579-4d825b968458 |
e8af40ee | 1124 | ;;; complete.el ends here |