Mercurial > emacs
annotate src/minibuf.c @ 1584:fed9a9ee5156
* s/sol2.h (LD_SWITCH_SYSTEM): Add -R option.
author | Jim Blandy <jimb@redhat.com> |
---|---|
date | Mon, 16 Nov 1992 00:31:04 +0000 |
parents | f55c75c6806d |
children | a3862c6dfcd0 |
rev | line source |
---|---|
284 | 1 /* Minibuffer input and completion. |
648 | 2 Copyright (C) 1985, 1986, 1992 Free Software Foundation, Inc. |
284 | 3 |
4 This file is part of GNU Emacs. | |
5 | |
6 GNU Emacs is free software; you can redistribute it and/or modify | |
7 it under the terms of the GNU General Public License as published by | |
648 | 8 the Free Software Foundation; either version 2, or (at your option) |
284 | 9 any later version. |
10 | |
11 GNU Emacs is distributed in the hope that it will be useful, | |
12 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 GNU General Public License for more details. | |
15 | |
16 You should have received a copy of the GNU General Public License | |
17 along with GNU Emacs; see the file COPYING. If not, write to | |
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
19 | |
20 | |
21 #include "config.h" | |
22 #include "lisp.h" | |
23 #include "commands.h" | |
24 #include "buffer.h" | |
25 #include "dispextern.h" | |
765 | 26 #include "frame.h" |
284 | 27 #include "window.h" |
28 #include "syntax.h" | |
29 | |
30 #define min(a, b) ((a) < (b) ? (a) : (b)) | |
31 | |
32 /* List of buffers for use as minibuffers. | |
33 The first element of the list is used for the outermost minibuffer invocation, | |
34 the next element is used for a recursive minibuffer invocation, etc. | |
35 The list is extended at the end as deeped minibuffer recursions are encountered. */ | |
36 Lisp_Object Vminibuffer_list; | |
37 | |
38 struct minibuf_save_data | |
39 { | |
40 char *prompt; | |
41 int prompt_width; | |
42 Lisp_Object help_form; | |
43 Lisp_Object current_prefix_arg; | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
44 Lisp_Object history_position; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
45 Lisp_Object history_variable; |
284 | 46 }; |
47 | |
48 int minibuf_save_vector_size; | |
49 struct minibuf_save_data *minibuf_save_vector; | |
50 | |
51 /* Depth in minibuffer invocations. */ | |
52 int minibuf_level; | |
53 | |
54 /* Nonzero means display completion help for invalid input */ | |
55 int auto_help; | |
56 | |
57 /* Fread_minibuffer leaves the input, as a string, here */ | |
58 Lisp_Object last_minibuf_string; | |
59 | |
60 /* Nonzero means let functions called when within a minibuffer | |
61 invoke recursive minibuffers (to read arguments, or whatever) */ | |
62 int enable_recursive_minibuffers; | |
63 | |
64 /* help-form is bound to this while in the minibuffer. */ | |
65 | |
66 Lisp_Object Vminibuffer_help_form; | |
67 | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
68 /* Variable which is the history list to add minibuffer values to. */ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
69 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
70 Lisp_Object Vminibuffer_history_variable; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
71 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
72 /* Current position in the history list (adjusted by M-n and M-p). */ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
73 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
74 Lisp_Object Vminibuffer_history_position; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
75 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
76 Lisp_Object Qminibuffer_history; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
77 |
284 | 78 /* Nonzero means completion ignores case. */ |
79 | |
80 int completion_ignore_case; | |
81 | |
82 /* If last completion attempt reported "Complete but not unique" | |
83 then this is the string completed then; otherwise this is nil. */ | |
84 | |
85 static Lisp_Object last_exact_completion; | |
86 | |
87 Lisp_Object Quser_variable_p; | |
88 | |
89 | |
90 /* Actual minibuffer invocation. */ | |
91 | |
92 void read_minibuf_unwind (); | |
93 Lisp_Object get_minibuffer (); | |
94 Lisp_Object read_minibuf (); | |
95 | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
96 /* Read from the minibuffer using keymap MAP, initial contents INITIAL |
866 | 97 (a string), putting point minus BACKUP_N chars from the end of INITIAL, |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
98 prompting with PROMPT (a string), using history list HISTVAR |
866 | 99 with initial position HISTPOS. (BACKUP_N should be <= 0.) |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
100 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
101 Normally return the result as a string (the text that was read), |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
102 but if EXPFLAG is non-nil, read it and return the object read. */ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
103 |
284 | 104 Lisp_Object |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
105 read_minibuf (map, initial, prompt, backup_n, expflag, histvar, histpos) |
284 | 106 Lisp_Object map; |
107 Lisp_Object initial; | |
108 Lisp_Object prompt; | |
866 | 109 int backup_n; |
284 | 110 int expflag; |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
111 Lisp_Object histvar; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
112 Lisp_Object histpos; |
284 | 113 { |
114 register Lisp_Object val; | |
115 int count = specpdl_ptr - specpdl; | |
765 | 116 Lisp_Object mini_frame = WINDOW_FRAME (XWINDOW (minibuf_window)); |
284 | 117 struct gcpro gcpro1, gcpro2; |
118 | |
119 if (XTYPE (prompt) != Lisp_String) | |
120 prompt = build_string (""); | |
121 | |
122 /* Emacs in -batch mode calls minibuffer: print the prompt. */ | |
123 if (noninteractive && XTYPE (prompt) == Lisp_String) | |
124 printf ("%s", XSTRING (prompt)->data); | |
125 | |
126 if (!enable_recursive_minibuffers | |
127 && minibuf_level > 0 | |
128 && (EQ (selected_window, minibuf_window))) | |
129 #if 0 | |
765 | 130 || selected_frame != XFRAME (WINDOW_FRAME (XWINDOW (minibuf_window))) |
284 | 131 #endif |
132 error ("Command attempted to use minibuffer while in minibuffer"); | |
133 | |
134 if (minibuf_level == minibuf_save_vector_size) | |
135 minibuf_save_vector = | |
136 (struct minibuf_save_data *) | |
137 xrealloc (minibuf_save_vector, | |
138 (minibuf_save_vector_size *= 2) | |
139 * sizeof (struct minibuf_save_data)); | |
140 minibuf_save_vector[minibuf_level].prompt = minibuf_prompt; | |
141 minibuf_save_vector[minibuf_level].prompt_width = minibuf_prompt_width; | |
142 minibuf_prompt_width = 0; | |
143 /* >> Why is this done this way rather than binding these variables? */ | |
144 minibuf_save_vector[minibuf_level].help_form = Vhelp_form; | |
145 minibuf_save_vector[minibuf_level].current_prefix_arg = Vcurrent_prefix_arg; | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
146 minibuf_save_vector[minibuf_level].history_position = Vminibuffer_history_position; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
147 minibuf_save_vector[minibuf_level].history_variable = Vminibuffer_history_variable; |
284 | 148 GCPRO2 (minibuf_save_vector[minibuf_level].help_form, |
149 minibuf_save_vector[minibuf_level].current_prefix_arg); | |
150 | |
151 record_unwind_protect (Fset_window_configuration, | |
345 | 152 Fcurrent_window_configuration (Qnil)); |
153 | |
765 | 154 /* If the minibuffer window is on a different frame, save that |
155 frame's configuration too. */ | |
156 if (XFRAME (mini_frame) != selected_frame) | |
358 | 157 { |
158 record_unwind_protect (Fset_window_configuration, | |
765 | 159 Fcurrent_window_configuration (mini_frame)); |
358 | 160 } |
284 | 161 |
162 val = current_buffer->directory; | |
163 Fset_buffer (get_minibuffer (minibuf_level)); | |
164 current_buffer->directory = val; | |
1568
f55c75c6806d
* minibuf.c (read_minibuf): Protect call to Fredirect_frame_focus
Jim Blandy <jimb@redhat.com>
parents:
1520
diff
changeset
|
165 #ifdef MULTI_FRAME |
1317
b74069f669cc
* minibuf.c (read_minibuf): Don't bother to save the current
Jim Blandy <jimb@redhat.com>
parents:
1198
diff
changeset
|
166 Fredirect_frame_focus (Fselected_frame (), mini_frame); |
1568
f55c75c6806d
* minibuf.c (read_minibuf): Protect call to Fredirect_frame_focus
Jim Blandy <jimb@redhat.com>
parents:
1520
diff
changeset
|
167 #endif |
284 | 168 Fmake_local_variable (Qprint_escape_newlines); |
169 print_escape_newlines = 1; | |
170 | |
358 | 171 record_unwind_protect (read_minibuf_unwind, Qnil); |
172 | |
284 | 173 Vminibuf_scroll_window = selected_window; |
174 Fset_window_buffer (minibuf_window, Fcurrent_buffer ()); | |
175 Fselect_window (minibuf_window); | |
176 XFASTINT (XWINDOW (minibuf_window)->hscroll) = 0; | |
177 | |
178 Ferase_buffer (); | |
179 minibuf_level++; | |
180 | |
488 | 181 if (!NILP (initial)) |
284 | 182 { |
183 Finsert (1, &initial); | |
488 | 184 if (!NILP (backup_n) && XTYPE (backup_n) == Lisp_Int) |
284 | 185 Fforward_char (backup_n); |
186 } | |
187 | |
188 minibuf_prompt = (char *) alloca (XSTRING (prompt)->size + 1); | |
189 bcopy (XSTRING (prompt)->data, minibuf_prompt, XSTRING (prompt)->size + 1); | |
190 echo_area_glyphs = 0; | |
191 | |
192 Vhelp_form = Vminibuffer_help_form; | |
193 current_buffer->keymap = map; | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
194 Vminibuffer_history_position = histpos; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
195 Vminibuffer_history_variable = histvar; |
284 | 196 |
197 /* ??? MCC did redraw_screen here if switching screens. */ | |
198 recursive_edit_1 (); | |
199 | |
200 /* If cursor is on the minibuffer line, | |
201 show the user we have exited by putting it in column 0. */ | |
765 | 202 if ((FRAME_CURSOR_Y (selected_frame) |
284 | 203 >= XFASTINT (XWINDOW (minibuf_window)->top)) |
204 && !noninteractive) | |
205 { | |
765 | 206 FRAME_CURSOR_X (selected_frame) = 0; |
207 update_frame (selected_frame, 1, 1); | |
284 | 208 } |
209 | |
210 /* Make minibuffer contents into a string */ | |
648 | 211 val = make_buffer_string (1, Z); |
284 | 212 bcopy (GAP_END_ADDR, XSTRING (val)->data + GPT - BEG, Z - GPT); |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
213 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
214 /* Add the value to the appropriate history list. */ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
215 if (XTYPE (Vminibuffer_history_variable) == Lisp_Symbol |
1520
8f4575a04825
* minibuf.c (read_minibuf): Use EQ to compare, not ==.
Jim Blandy <jimb@redhat.com>
parents:
1443
diff
changeset
|
216 && ! EQ (XSYMBOL (Vminibuffer_history_variable)->value, Qunbound)) |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
217 Fset (Vminibuffer_history_variable, |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
218 Fcons (val, Fsymbol_value (Vminibuffer_history_variable))); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
219 |
765 | 220 unbind_to (count, Qnil); /* The appropriate frame will get selected |
358 | 221 in set-window-configuration. */ |
284 | 222 |
223 UNGCPRO; | |
224 | |
225 /* VAL is the string of minibuffer text. */ | |
226 last_minibuf_string = val; | |
227 | |
228 /* If Lisp form desired instead of string, parse it */ | |
229 if (expflag) | |
230 val = Fread (val); | |
231 | |
232 return val; | |
233 } | |
234 | |
235 /* Return a buffer to be used as the minibuffer at depth `depth'. | |
236 depth = 0 is the lowest allowed argument, and that is the value | |
237 used for nonrecursive minibuffer invocations */ | |
238 | |
239 Lisp_Object | |
240 get_minibuffer (depth) | |
241 int depth; | |
242 { | |
243 Lisp_Object tail, num, buf; | |
244 char name[14]; | |
245 extern Lisp_Object nconc2 (); | |
246 | |
247 XFASTINT (num) = depth; | |
248 tail = Fnthcdr (num, Vminibuffer_list); | |
488 | 249 if (NILP (tail)) |
284 | 250 { |
251 tail = Fcons (Qnil, Qnil); | |
252 Vminibuffer_list = nconc2 (Vminibuffer_list, tail); | |
253 } | |
254 buf = Fcar (tail); | |
488 | 255 if (NILP (buf) || NILP (XBUFFER (buf)->name)) |
284 | 256 { |
257 sprintf (name, " *Minibuf-%d*", depth); | |
258 buf = Fget_buffer_create (build_string (name)); | |
1198
7c4519722020
Thu Sep 17 15:51:18 1992 Jim Blandy (jimb@pogo.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents:
1010
diff
changeset
|
259 |
7c4519722020
Thu Sep 17 15:51:18 1992 Jim Blandy (jimb@pogo.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents:
1010
diff
changeset
|
260 /* Although the buffer's name starts with a space, undo should be |
7c4519722020
Thu Sep 17 15:51:18 1992 Jim Blandy (jimb@pogo.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents:
1010
diff
changeset
|
261 enabled in it. */ |
7c4519722020
Thu Sep 17 15:51:18 1992 Jim Blandy (jimb@pogo.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents:
1010
diff
changeset
|
262 Fbuffer_enable_undo (buf); |
7c4519722020
Thu Sep 17 15:51:18 1992 Jim Blandy (jimb@pogo.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents:
1010
diff
changeset
|
263 |
284 | 264 XCONS (tail)->car = buf; |
265 } | |
266 else | |
267 reset_buffer (XBUFFER (buf)); | |
268 return buf; | |
269 } | |
270 | |
271 /* This function is called on exiting minibuffer, whether normally or not, | |
272 and it restores the current window, buffer, etc. */ | |
273 | |
274 void | |
358 | 275 read_minibuf_unwind (data) |
276 Lisp_Object data; | |
284 | 277 { |
278 /* Erase the minibuffer we were using at this level. */ | |
279 Fset_buffer (XWINDOW (minibuf_window)->buffer); | |
280 | |
281 /* Prevent error in erase-buffer. */ | |
282 current_buffer->read_only = Qnil; | |
283 Ferase_buffer (); | |
284 | |
285 /* If this was a recursive minibuffer, | |
286 tie the minibuffer window back to the outer level minibuffer buffer */ | |
287 minibuf_level--; | |
288 /* Make sure minibuffer window is erased, not ignored */ | |
289 windows_or_buffers_changed++; | |
290 XFASTINT (XWINDOW (minibuf_window)->last_modified) = 0; | |
291 | |
292 /* Restore prompt from outer minibuffer */ | |
293 minibuf_prompt = minibuf_save_vector[minibuf_level].prompt; | |
294 minibuf_prompt_width = minibuf_save_vector[minibuf_level].prompt_width; | |
295 Vhelp_form = minibuf_save_vector[minibuf_level].help_form; | |
296 Vcurrent_prefix_arg = minibuf_save_vector[minibuf_level].current_prefix_arg; | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
297 Vminibuffer_history_position |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
298 = minibuf_save_vector[minibuf_level].history_position; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
299 Vminibuffer_history_variable |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
300 = minibuf_save_vector[minibuf_level].history_variable; |
284 | 301 } |
302 | |
1010
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
303 |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
304 /* This comment supplies the doc string for read-from-minibuffer, |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
305 for make-docfile to see. We cannot put this in the real DEFUN |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
306 due to limits in the Unix cpp. |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
307 |
284 | 308 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 5, 0, |
309 "Read a string from the minibuffer, prompting with string PROMPT.\n\ | |
310 If optional second arg INITIAL-CONTENTS is non-nil, it is a string\n\ | |
311 to be inserted into the minibuffer before reading input.\n\ | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
312 If INITIAL-CONTENTS is (STRING . POSITION), the initial input\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
313 is STRING, but point is placed POSITION characters into the string.\n\ |
284 | 314 Third arg KEYMAP is a keymap to use whilst reading;\n\ |
315 if omitted or nil, the default is `minibuffer-local-map'.\n\ | |
316 If fourth arg READ is non-nil, then interpret the result as a lisp object\n\ | |
317 and return that object:\n\ | |
318 in other words, do `(car (read-from-string INPUT-STRING))'\n\ | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
319 Fifth arg HIST, if non-nil, specifies a history list\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
320 and optionally the initial position in the list.\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
321 It can be a symbol, which is the history list variable to use,\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
322 or it can be a cons cell (HISTVAR . HISTPOS).\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
323 In that case, HISTVAR is the history list variable to use,\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
324 and HISTPOS is the initial position (the position in the list\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
325 which INITIAL-CONTENTS corresponds to).\n\ |
1010
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
326 Positions are counted starting from 1 at the beginning of the list." |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
327 */ |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
328 |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
329 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 5, 0, |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
330 0 /* See immediately above */) |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
331 (prompt, initial_input, keymap, read, hist) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
332 Lisp_Object prompt, initial_input, keymap, read, hist; |
284 | 333 { |
334 int pos = 0; | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
335 Lisp_Object histvar, histpos, position; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
336 position = Qnil; |
284 | 337 |
338 CHECK_STRING (prompt, 0); | |
488 | 339 if (!NILP (initial_input)) |
284 | 340 { |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
341 if (XTYPE (initial_input) == Lisp_Cons) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
342 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
343 position = Fcdr (initial_input); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
344 initial_input = Fcar (initial_input); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
345 } |
284 | 346 CHECK_STRING (initial_input, 1); |
488 | 347 if (!NILP (position)) |
284 | 348 { |
349 CHECK_NUMBER (position, 0); | |
350 /* Convert to distance from end of input. */ | |
351 pos = XINT (position) - 1 - XSTRING (initial_input)->size; | |
352 } | |
353 } | |
354 | |
488 | 355 if (NILP (keymap)) |
284 | 356 keymap = Vminibuffer_local_map; |
357 else | |
358 keymap = get_keymap (keymap,2); | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
359 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
360 if (XTYPE (hist) == Lisp_Symbol) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
361 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
362 histvar = hist; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
363 histpos = Qnil; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
364 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
365 else |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
366 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
367 histvar = Fcar_safe (hist); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
368 histpos = Fcdr_safe (hist); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
369 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
370 if (NILP (histvar)) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
371 histvar = Qminibuffer_history; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
372 if (NILP (histpos)) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
373 XFASTINT (histpos) = 0; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
374 |
284 | 375 return read_minibuf (keymap, initial_input, prompt, |
866 | 376 make_number (pos), !NILP (read), histvar, histpos); |
284 | 377 } |
378 | |
379 DEFUN ("read-minibuffer", Fread_minibuffer, Sread_minibuffer, 1, 2, 0, | |
380 "Return a Lisp object read using the minibuffer.\n\ | |
381 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\ | |
382 is a string to insert in the minibuffer before reading.") | |
383 (prompt, initial_contents) | |
384 Lisp_Object prompt, initial_contents; | |
385 { | |
386 CHECK_STRING (prompt, 0); | |
488 | 387 if (!NILP (initial_contents)) |
284 | 388 CHECK_STRING (initial_contents, 1) |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
389 return read_minibuf (Vminibuffer_local_map, initial_contents, |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
390 prompt, Qnil, 1, Qminibuffer_history, make_number (0)); |
284 | 391 } |
392 | |
393 DEFUN ("eval-minibuffer", Feval_minibuffer, Seval_minibuffer, 1, 2, 0, | |
394 "Return value of Lisp expression read using the minibuffer.\n\ | |
395 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\ | |
396 is a string to insert in the minibuffer before reading.") | |
397 (prompt, initial_contents) | |
398 Lisp_Object prompt, initial_contents; | |
399 { | |
400 return Feval (Fread_minibuffer (prompt, initial_contents)); | |
401 } | |
402 | |
403 /* Functions that use the minibuffer to read various things. */ | |
404 | |
405 DEFUN ("read-string", Fread_string, Sread_string, 1, 2, 0, | |
406 "Read a string from the minibuffer, prompting with string PROMPT.\n\ | |
407 If non-nil second arg INITIAL-INPUT is a string to insert before reading.") | |
408 (prompt, initial_input) | |
409 Lisp_Object prompt, initial_input; | |
410 { | |
411 return Fread_from_minibuffer (prompt, initial_input, Qnil, Qnil, Qnil); | |
412 } | |
413 | |
732 | 414 DEFUN ("read-no-blanks-input", Fread_no_blanks_input, Sread_no_blanks_input, 2, 2, 0, |
284 | 415 "Args PROMPT and INIT, strings. Read a string from the terminal, not allowing blanks.\n\ |
416 Prompt with PROMPT, and provide INIT as an initial value of the input string.") | |
417 (prompt, init) | |
418 Lisp_Object prompt, init; | |
419 { | |
420 CHECK_STRING (prompt, 0); | |
488 | 421 if (! NILP (init)) |
284 | 422 CHECK_STRING (init, 1); |
423 | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
424 return read_minibuf (Vminibuffer_local_ns_map, init, prompt, Qnil, 0, |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
425 Qminibuffer_history, make_number (0)); |
284 | 426 } |
427 | |
428 DEFUN ("read-command", Fread_command, Sread_command, 1, 1, 0, | |
429 "One arg PROMPT, a string. Read the name of a command and return as a symbol.\n\ | |
430 Prompts with PROMPT.") | |
431 (prompt) | |
432 Lisp_Object prompt; | |
433 { | |
434 return Fintern (Fcompleting_read (prompt, Vobarray, Qcommandp, Qt, Qnil, Qnil), | |
435 Qnil); | |
436 } | |
437 | |
438 #ifdef NOTDEF | |
439 DEFUN ("read-function", Fread_function, Sread_function, 1, 1, 0, | |
440 "One arg PROMPT, a string. Read the name of a function and return as a symbol.\n\ | |
441 Prompts with PROMPT.") | |
442 (prompt) | |
443 Lisp_Object prompt; | |
444 { | |
445 return Fintern (Fcompleting_read (prompt, Vobarray, Qfboundp, Qt, Qnil, Qnil), | |
446 Qnil); | |
447 } | |
448 #endif /* NOTDEF */ | |
449 | |
450 DEFUN ("read-variable", Fread_variable, Sread_variable, 1, 1, 0, | |
451 "One arg PROMPT, a string. Read the name of a user variable and return\n\ | |
452 it as a symbol. Prompts with PROMPT.\n\ | |
453 A user variable is one whose documentation starts with a `*' character.") | |
454 (prompt) | |
455 Lisp_Object prompt; | |
456 { | |
457 return Fintern (Fcompleting_read (prompt, Vobarray, | |
458 Quser_variable_p, Qt, Qnil, Qnil), | |
459 Qnil); | |
460 } | |
461 | |
462 DEFUN ("read-buffer", Fread_buffer, Sread_buffer, 1, 3, 0, | |
463 "One arg PROMPT, a string. Read the name of a buffer and return as a string.\n\ | |
464 Prompts with PROMPT.\n\ | |
465 Optional second arg is value to return if user enters an empty line.\n\ | |
466 If optional third arg REQUIRE-MATCH is non-nil, only existing buffer names are allowed.") | |
467 (prompt, def, require_match) | |
468 Lisp_Object prompt, def, require_match; | |
469 { | |
470 Lisp_Object tem; | |
471 Lisp_Object args[3]; | |
472 struct gcpro gcpro1; | |
473 | |
474 if (XTYPE (def) == Lisp_Buffer) | |
475 def = XBUFFER (def)->name; | |
488 | 476 if (!NILP (def)) |
284 | 477 { |
478 args[0] = build_string ("%s(default %s) "); | |
479 args[1] = prompt; | |
480 args[2] = def; | |
481 prompt = Fformat (3, args); | |
482 } | |
483 GCPRO1 (def); | |
484 tem = Fcompleting_read (prompt, Vbuffer_alist, Qnil, require_match, Qnil, Qnil); | |
485 UNGCPRO; | |
486 if (XSTRING (tem)->size) | |
487 return tem; | |
488 return def; | |
489 } | |
490 | |
491 DEFUN ("try-completion", Ftry_completion, Stry_completion, 2, 3, 0, | |
492 "Return common substring of all completions of STRING in ALIST.\n\ | |
493 Each car of each element of ALIST is tested to see if it begins with STRING.\n\ | |
494 All that match are compared together; the longest initial sequence\n\ | |
495 common to all matches is returned as a string.\n\ | |
496 If there is no match at all, nil is returned.\n\ | |
497 For an exact match, t is returned.\n\ | |
498 \n\ | |
499 ALIST can be an obarray instead of an alist.\n\ | |
500 Then the print names of all symbols in the obarray are the possible matches.\n\ | |
501 \n\ | |
502 ALIST can also be a function to do the completion itself.\n\ | |
503 It receives three arguments: the values STRING, PREDICATE and nil.\n\ | |
504 Whatever it returns becomes the value of `try-completion'.\n\ | |
505 \n\ | |
506 If optional third argument PREDICATE is non-nil,\n\ | |
507 it is used to test each possible match.\n\ | |
508 The match is a candidate only if PREDICATE returns non-nil.\n\ | |
509 The argument given to PREDICATE is the alist element or the symbol from the obarray.") | |
510 (string, alist, pred) | |
511 Lisp_Object string, alist, pred; | |
512 { | |
513 Lisp_Object bestmatch, tail, elt, eltstring; | |
514 int bestmatchsize; | |
515 int compare, matchsize; | |
488 | 516 int list = CONSP (alist) || NILP (alist); |
284 | 517 int index, obsize; |
518 int matchcount = 0; | |
519 Lisp_Object bucket, zero, end, tem; | |
520 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4; | |
521 | |
522 CHECK_STRING (string, 0); | |
523 if (!list && XTYPE (alist) != Lisp_Vector) | |
524 return call3 (alist, string, pred, Qnil); | |
525 | |
526 bestmatch = Qnil; | |
527 | |
528 /* If ALIST is not a list, set TAIL just for gc pro. */ | |
529 tail = alist; | |
530 if (! list) | |
531 { | |
532 index = 0; | |
533 obsize = XVECTOR (alist)->size; | |
534 bucket = XVECTOR (alist)->contents[index]; | |
535 } | |
536 | |
537 while (1) | |
538 { | |
539 /* Get the next element of the alist or obarray. */ | |
540 /* Exit the loop if the elements are all used up. */ | |
541 /* elt gets the alist element or symbol. | |
542 eltstring gets the name to check as a completion. */ | |
543 | |
544 if (list) | |
545 { | |
488 | 546 if (NILP (tail)) |
284 | 547 break; |
548 elt = Fcar (tail); | |
549 eltstring = Fcar (elt); | |
550 tail = Fcdr (tail); | |
551 } | |
552 else | |
553 { | |
554 if (XFASTINT (bucket) != 0) | |
555 { | |
556 elt = bucket; | |
557 eltstring = Fsymbol_name (elt); | |
558 if (XSYMBOL (bucket)->next) | |
559 XSETSYMBOL (bucket, XSYMBOL (bucket)->next); | |
560 else | |
561 XFASTINT (bucket) = 0; | |
562 } | |
563 else if (++index >= obsize) | |
564 break; | |
565 else | |
566 { | |
567 bucket = XVECTOR (alist)->contents[index]; | |
568 continue; | |
569 } | |
570 } | |
571 | |
572 /* Is this element a possible completion? */ | |
573 | |
574 if (XTYPE (eltstring) == Lisp_String && | |
575 XSTRING (string)->size <= XSTRING (eltstring)->size && | |
576 0 > scmp (XSTRING (eltstring)->data, XSTRING (string)->data, | |
577 XSTRING (string)->size)) | |
578 { | |
579 /* Yes. */ | |
580 /* Ignore this element if there is a predicate | |
581 and the predicate doesn't like it. */ | |
582 | |
488 | 583 if (!NILP (pred)) |
284 | 584 { |
585 if (EQ (pred, Qcommandp)) | |
586 tem = Fcommandp (elt); | |
587 else | |
588 { | |
589 GCPRO4 (tail, string, eltstring, bestmatch); | |
590 tem = call1 (pred, elt); | |
591 UNGCPRO; | |
592 } | |
488 | 593 if (NILP (tem)) continue; |
284 | 594 } |
595 | |
596 /* Update computation of how much all possible completions match */ | |
597 | |
598 matchcount++; | |
488 | 599 if (NILP (bestmatch)) |
284 | 600 bestmatch = eltstring, bestmatchsize = XSTRING (eltstring)->size; |
601 else | |
602 { | |
603 compare = min (bestmatchsize, XSTRING (eltstring)->size); | |
604 matchsize = scmp (XSTRING (bestmatch)->data, | |
605 XSTRING (eltstring)->data, | |
606 compare); | |
330 | 607 if (matchsize < 0) |
608 matchsize = compare; | |
609 if (completion_ignore_case) | |
610 { | |
611 /* If this is an exact match except for case, | |
612 use it as the best match rather than one that is not an | |
613 exact match. This way, we get the case pattern | |
614 of the actual match. */ | |
615 if ((matchsize == XSTRING (eltstring)->size | |
616 && matchsize < XSTRING (bestmatch)->size) | |
617 || | |
618 /* If there is more than one exact match ignoring case, | |
619 and one of them is exact including case, | |
620 prefer that one. */ | |
621 /* If there is no exact match ignoring case, | |
622 prefer a match that does not change the case | |
623 of the input. */ | |
624 ((matchsize == XSTRING (eltstring)->size) | |
625 == | |
626 (matchsize == XSTRING (bestmatch)->size) | |
627 && !bcmp (XSTRING (eltstring)->data, | |
628 XSTRING (string)->data, XSTRING (string)->size) | |
629 && bcmp (XSTRING (bestmatch)->data, | |
630 XSTRING (string)->data, XSTRING (string)->size))) | |
631 bestmatch = eltstring; | |
632 } | |
633 bestmatchsize = matchsize; | |
284 | 634 } |
635 } | |
636 } | |
637 | |
488 | 638 if (NILP (bestmatch)) |
284 | 639 return Qnil; /* No completions found */ |
330 | 640 /* If we are ignoring case, and there is no exact match, |
641 and no additional text was supplied, | |
642 don't change the case of what the user typed. */ | |
643 if (completion_ignore_case && bestmatchsize == XSTRING (string)->size | |
644 && XSTRING (bestmatch)->size > bestmatchsize) | |
645 return string; | |
646 | |
647 /* Return t if the supplied string is an exact match (counting case); | |
648 it does not require any change to be made. */ | |
649 if (matchcount == 1 && bestmatchsize == XSTRING (string)->size | |
650 && !bcmp (XSTRING (bestmatch)->data, XSTRING (string)->data, | |
651 bestmatchsize)) | |
284 | 652 return Qt; |
653 | |
654 XFASTINT (zero) = 0; /* Else extract the part in which */ | |
655 XFASTINT (end) = bestmatchsize; /* all completions agree */ | |
656 return Fsubstring (bestmatch, zero, end); | |
657 } | |
658 | |
659 /* Compare exactly LEN chars of strings at S1 and S2, | |
660 ignoring case if appropriate. | |
661 Return -1 if strings match, | |
662 else number of chars that match at the beginning. */ | |
663 | |
664 scmp (s1, s2, len) | |
665 register char *s1, *s2; | |
666 int len; | |
667 { | |
668 register int l = len; | |
669 | |
670 if (completion_ignore_case) | |
671 { | |
672 while (l && DOWNCASE (*s1++) == DOWNCASE (*s2++)) | |
673 l--; | |
674 } | |
675 else | |
676 { | |
677 while (l && *s1++ == *s2++) | |
678 l--; | |
679 } | |
680 if (l == 0) | |
681 return -1; | |
682 else return len - l; | |
683 } | |
684 | |
685 DEFUN ("all-completions", Fall_completions, Sall_completions, 2, 3, 0, | |
686 "Search for partial matches to STRING in ALIST.\n\ | |
687 Each car of each element of ALIST is tested to see if it begins with STRING.\n\ | |
688 The value is a list of all the strings from ALIST that match.\n\ | |
689 ALIST can be an obarray instead of an alist.\n\ | |
690 Then the print names of all symbols in the obarray are the possible matches.\n\ | |
691 \n\ | |
692 ALIST can also be a function to do the completion itself.\n\ | |
693 It receives three arguments: the values STRING, PREDICATE and t.\n\ | |
694 Whatever it returns becomes the value of `all-completion'.\n\ | |
695 \n\ | |
696 If optional third argument PREDICATE is non-nil,\n\ | |
697 it is used to test each possible match.\n\ | |
698 The match is a candidate only if PREDICATE returns non-nil.\n\ | |
699 The argument given to PREDICATE is the alist element or the symbol from the obarray.") | |
700 (string, alist, pred) | |
701 Lisp_Object string, alist, pred; | |
702 { | |
703 Lisp_Object tail, elt, eltstring; | |
704 Lisp_Object allmatches; | |
488 | 705 int list = CONSP (alist) || NILP (alist); |
284 | 706 int index, obsize; |
707 Lisp_Object bucket, tem; | |
708 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4; | |
709 | |
710 CHECK_STRING (string, 0); | |
711 if (!list && XTYPE (alist) != Lisp_Vector) | |
712 { | |
713 return call3 (alist, string, pred, Qt); | |
714 } | |
715 allmatches = Qnil; | |
716 | |
717 /* If ALIST is not a list, set TAIL just for gc pro. */ | |
718 tail = alist; | |
719 if (! list) | |
720 { | |
721 index = 0; | |
722 obsize = XVECTOR (alist)->size; | |
723 bucket = XVECTOR (alist)->contents[index]; | |
724 } | |
725 | |
726 while (1) | |
727 { | |
728 /* Get the next element of the alist or obarray. */ | |
729 /* Exit the loop if the elements are all used up. */ | |
730 /* elt gets the alist element or symbol. | |
731 eltstring gets the name to check as a completion. */ | |
732 | |
733 if (list) | |
734 { | |
488 | 735 if (NILP (tail)) |
284 | 736 break; |
737 elt = Fcar (tail); | |
738 eltstring = Fcar (elt); | |
739 tail = Fcdr (tail); | |
740 } | |
741 else | |
742 { | |
743 if (XFASTINT (bucket) != 0) | |
744 { | |
745 elt = bucket; | |
746 eltstring = Fsymbol_name (elt); | |
747 if (XSYMBOL (bucket)->next) | |
748 XSETSYMBOL (bucket, XSYMBOL (bucket)->next); | |
749 else | |
750 XFASTINT (bucket) = 0; | |
751 } | |
752 else if (++index >= obsize) | |
753 break; | |
754 else | |
755 { | |
756 bucket = XVECTOR (alist)->contents[index]; | |
757 continue; | |
758 } | |
759 } | |
760 | |
761 /* Is this element a possible completion? */ | |
762 | |
763 if (XTYPE (eltstring) == Lisp_String && | |
764 XSTRING (string)->size <= XSTRING (eltstring)->size && | |
765 XSTRING (eltstring)->data[0] != ' ' && | |
766 0 > scmp (XSTRING (eltstring)->data, XSTRING (string)->data, | |
767 XSTRING (string)->size)) | |
768 { | |
769 /* Yes. */ | |
770 /* Ignore this element if there is a predicate | |
771 and the predicate doesn't like it. */ | |
772 | |
488 | 773 if (!NILP (pred)) |
284 | 774 { |
775 if (EQ (pred, Qcommandp)) | |
776 tem = Fcommandp (elt); | |
777 else | |
778 { | |
779 GCPRO4 (tail, eltstring, allmatches, string); | |
780 tem = call1 (pred, elt); | |
781 UNGCPRO; | |
782 } | |
488 | 783 if (NILP (tem)) continue; |
284 | 784 } |
785 /* Ok => put it on the list. */ | |
786 allmatches = Fcons (eltstring, allmatches); | |
787 } | |
788 } | |
789 | |
790 return Fnreverse (allmatches); | |
791 } | |
792 | |
793 Lisp_Object Vminibuffer_completion_table, Qminibuffer_completion_table; | |
794 Lisp_Object Vminibuffer_completion_predicate, Qminibuffer_completion_predicate; | |
795 Lisp_Object Vminibuffer_completion_confirm, Qminibuffer_completion_confirm; | |
796 | |
1010
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
797 /* This comment supplies the doc string for completing-read, |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
798 for make-docfile to see. We cannot put this in the real DEFUN |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
799 due to limits in the Unix cpp. |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
800 |
284 | 801 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 6, 0, |
802 "Read a string in the minibuffer, with completion.\n\ | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
803 Args: PROMPT, TABLE, PREDICATE, REQUIRE-MATCH, INITIAL-INPUT, HIST.\n\ |
284 | 804 PROMPT is a string to prompt with; normally it ends in a colon and a space.\n\ |
805 TABLE is an alist whose elements' cars are strings, or an obarray.\n\ | |
806 PREDICATE limits completion to a subset of TABLE.\n\ | |
807 See `try-completion' for more details on completion, TABLE, and PREDICATE.\n\ | |
808 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless\n\ | |
809 the input is (or completes to) an element of TABLE.\n\ | |
810 If it is also not t, Return does not exit if it does non-null completion.\n\ | |
811 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially.\n\ | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
812 If it is (STRING . POSITION), the initial input\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
813 is STRING, but point is placed POSITION characters into the string.\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
814 HIST, if non-nil, specifies a history list\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
815 and optionally the initial position in the list.\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
816 It can be a symbol, which is the history list variable to use,\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
817 or it can be a cons cell (HISTVAR . HISTPOS).\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
818 In that case, HISTVAR is the history list variable to use,\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
819 and HISTPOS is the initial position (the position in the list\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
820 which INITIAL-CONTENTS corresponds to).\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
821 Positions are counted starting from 1 at the beginning of the list.\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
822 Completion ignores case if the ambient value of\n\ |
1010
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
823 `completion-ignore-case' is non-nil." |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
824 */ |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
825 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 6, 0, |
b6a67ffc7536
* minibuf.c (Fread_from_minibuffer): Put this function's doc
Jim Blandy <jimb@redhat.com>
parents:
967
diff
changeset
|
826 0 /* See immediately above */) |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
827 (prompt, table, pred, require_match, init, hist) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
828 Lisp_Object prompt, table, pred, require_match, init, hist; |
284 | 829 { |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
830 Lisp_Object val, histvar, histpos, position; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
831 int pos = 0; |
284 | 832 int count = specpdl_ptr - specpdl; |
833 specbind (Qminibuffer_completion_table, table); | |
834 specbind (Qminibuffer_completion_predicate, pred); | |
835 specbind (Qminibuffer_completion_confirm, | |
836 EQ (require_match, Qt) ? Qnil : Qt); | |
837 last_exact_completion = Qnil; | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
838 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
839 position = Qnil; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
840 if (!NILP (init)) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
841 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
842 if (XTYPE (init) == Lisp_Cons) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
843 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
844 position = Fcdr (init); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
845 init = Fcar (init); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
846 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
847 CHECK_STRING (init, 0); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
848 if (!NILP (position)) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
849 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
850 CHECK_NUMBER (position, 0); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
851 /* Convert to distance from end of input. */ |
967
6df04dcbd2e9
* minibuf.c (Fcompleting_read): Stop subtracting one from the
Jim Blandy <jimb@redhat.com>
parents:
866
diff
changeset
|
852 pos = XINT (position) - XSTRING (init)->size; |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
853 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
854 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
855 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
856 if (XTYPE (hist) == Lisp_Symbol) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
857 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
858 histvar = hist; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
859 histpos = Qnil; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
860 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
861 else |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
862 { |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
863 histvar = Fcar_safe (hist); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
864 histpos = Fcdr_safe (hist); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
865 } |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
866 if (NILP (histvar)) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
867 histvar = Qminibuffer_history; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
868 if (NILP (histpos)) |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
869 XFASTINT (histpos) = 0; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
870 |
488 | 871 val = read_minibuf (NILP (require_match) |
284 | 872 ? Vminibuffer_local_completion_map |
873 : Vminibuffer_local_must_match_map, | |
866 | 874 init, prompt, make_number (pos), 0, |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
875 histvar, histpos); |
284 | 876 return unbind_to (count, val); |
877 } | |
878 | |
879 /* Temporarily display the string M at the end of the current | |
880 minibuffer contents. This is used to display things like | |
881 "[No Match]" when the user requests a completion for a prefix | |
882 that has no possible completions, and other quick, unobtrusive | |
883 messages. */ | |
884 | |
885 temp_echo_area_glyphs (m) | |
886 char *m; | |
887 { | |
888 int osize = ZV; | |
889 Lisp_Object oinhibit; | |
890 oinhibit = Vinhibit_quit; | |
891 | |
1443
b359c67a9194
* minibuf.c (temp_echo_area_glyphs): Don't clear echo_area_glyphs
Jim Blandy <jimb@redhat.com>
parents:
1317
diff
changeset
|
892 /* Clear out any old echo-area message to make way for our new thing. */ |
b359c67a9194
* minibuf.c (temp_echo_area_glyphs): Don't clear echo_area_glyphs
Jim Blandy <jimb@redhat.com>
parents:
1317
diff
changeset
|
893 message (0); |
284 | 894 |
895 SET_PT (osize); | |
896 insert_string (m); | |
897 SET_PT (osize); | |
898 Vinhibit_quit = Qt; | |
899 Fsit_for (make_number (2), Qnil, Qnil); | |
900 del_range (point, ZV); | |
488 | 901 if (!NILP (Vquit_flag)) |
284 | 902 { |
903 Vquit_flag = Qnil; | |
1520
8f4575a04825
* minibuf.c (read_minibuf): Use EQ to compare, not ==.
Jim Blandy <jimb@redhat.com>
parents:
1443
diff
changeset
|
904 XFASTINT (unread_command_char) = Ctl ('g'); |
284 | 905 } |
906 Vinhibit_quit = oinhibit; | |
907 } | |
908 | |
909 Lisp_Object Fminibuffer_completion_help (); | |
330 | 910 Lisp_Object assoc_for_completion (); |
284 | 911 |
912 /* returns: | |
913 * 0 no possible completion | |
914 * 1 was already an exact and unique completion | |
915 * 3 was already an exact completion | |
916 * 4 completed to an exact completion | |
917 * 5 some completion happened | |
918 * 6 no completion happened | |
919 */ | |
920 int | |
921 do_completion () | |
922 { | |
923 Lisp_Object completion, tem; | |
924 int completedp; | |
925 Lisp_Object last; | |
926 | |
927 completion = Ftry_completion (Fbuffer_string (), Vminibuffer_completion_table, | |
928 Vminibuffer_completion_predicate); | |
929 last = last_exact_completion; | |
930 last_exact_completion = Qnil; | |
931 | |
488 | 932 if (NILP (completion)) |
284 | 933 { |
934 bitch_at_user (); | |
935 temp_echo_area_glyphs (" [No match]"); | |
936 return 0; | |
937 } | |
938 | |
939 if (EQ (completion, Qt)) /* exact and unique match */ | |
940 return 1; | |
941 | |
942 /* compiler bug */ | |
943 tem = Fstring_equal (completion, Fbuffer_string()); | |
488 | 944 if (completedp = NILP (tem)) |
284 | 945 { |
946 Ferase_buffer (); /* Some completion happened */ | |
947 Finsert (1, &completion); | |
948 } | |
949 | |
950 /* It did find a match. Do we match some possibility exactly now? */ | |
951 if (CONSP (Vminibuffer_completion_table) | |
488 | 952 || NILP (Vminibuffer_completion_table)) |
330 | 953 tem = assoc_for_completion (Fbuffer_string (), |
954 Vminibuffer_completion_table); | |
284 | 955 else if (XTYPE (Vminibuffer_completion_table) == Lisp_Vector) |
956 { | |
957 /* the primitive used by Fintern_soft */ | |
958 extern Lisp_Object oblookup (); | |
959 | |
960 tem = Fbuffer_string (); | |
961 /* Bypass intern-soft as that loses for nil */ | |
962 tem = oblookup (Vminibuffer_completion_table, | |
963 XSTRING (tem)->data, XSTRING (tem)->size); | |
964 if (XTYPE (tem) != Lisp_Symbol) | |
965 tem = Qnil; | |
488 | 966 else if (!NILP (Vminibuffer_completion_predicate)) |
284 | 967 tem = call1 (Vminibuffer_completion_predicate, tem); |
968 else | |
969 tem = Qt; | |
970 } | |
971 else | |
972 tem = call3 (Vminibuffer_completion_table, | |
973 Fbuffer_string (), | |
974 Vminibuffer_completion_predicate, | |
975 Qlambda); | |
976 | |
488 | 977 if (NILP (tem)) |
284 | 978 { /* not an exact match */ |
979 if (completedp) | |
980 return 5; | |
981 else if (auto_help) | |
982 Fminibuffer_completion_help (); | |
983 else | |
984 temp_echo_area_glyphs (" [Next char not unique]"); | |
985 return 6; | |
986 } | |
987 else if (completedp) | |
988 return 4; | |
989 /* If the last exact completion and this one were the same, | |
990 it means we've already given a "Complete but not unique" | |
330 | 991 message and the user's hit TAB again, so now we give him help. */ |
284 | 992 last_exact_completion = completion; |
488 | 993 if (!NILP (last)) |
284 | 994 { |
995 tem = Fbuffer_string (); | |
488 | 996 if (!NILP (Fequal (tem, last))) |
284 | 997 Fminibuffer_completion_help (); |
998 } | |
999 return 3; | |
1000 } | |
1001 | |
330 | 1002 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */ |
1003 | |
1004 Lisp_Object | |
1005 assoc_for_completion (key, list) | |
1006 register Lisp_Object key; | |
1007 Lisp_Object list; | |
1008 { | |
1009 register Lisp_Object tail; | |
1010 | |
1011 if (completion_ignore_case) | |
1012 key = Fupcase (key); | |
1013 | |
488 | 1014 for (tail = list; !NILP (tail); tail = Fcdr (tail)) |
330 | 1015 { |
1016 register Lisp_Object elt, tem, thiscar; | |
1017 elt = Fcar (tail); | |
1018 if (!CONSP (elt)) continue; | |
1019 thiscar = Fcar (elt); | |
1020 if (XTYPE (thiscar) != Lisp_String) | |
1021 continue; | |
1022 if (completion_ignore_case) | |
1023 thiscar = Fupcase (thiscar); | |
1024 tem = Fequal (thiscar, key); | |
488 | 1025 if (!NILP (tem)) return elt; |
330 | 1026 QUIT; |
1027 } | |
1028 return Qnil; | |
1029 } | |
284 | 1030 |
1031 DEFUN ("minibuffer-complete", Fminibuffer_complete, Sminibuffer_complete, 0, 0, "", | |
1032 "Complete the minibuffer contents as far as possible.") | |
1033 () | |
1034 { | |
1035 register int i = do_completion (); | |
1036 switch (i) | |
1037 { | |
1038 case 0: | |
1039 return Qnil; | |
1040 | |
1041 case 1: | |
1042 temp_echo_area_glyphs (" [Sole completion]"); | |
1043 break; | |
1044 | |
1045 case 3: | |
1046 temp_echo_area_glyphs (" [Complete, but not unique]"); | |
1047 break; | |
1048 } | |
1049 | |
1050 return Qt; | |
1051 } | |
1052 | |
1053 DEFUN ("minibuffer-complete-and-exit", Fminibuffer_complete_and_exit, | |
1054 Sminibuffer_complete_and_exit, 0, 0, "", | |
1055 "Complete the minibuffer contents, and maybe exit.\n\ | |
1056 Exit if the name is valid with no completion needed.\n\ | |
1057 If name was completed to a valid match,\n\ | |
1058 a repetition of this command will exit.") | |
1059 () | |
1060 { | |
1061 register int i; | |
1062 | |
1063 /* Allow user to specify null string */ | |
1064 if (BEGV == ZV) | |
1065 goto exit; | |
1066 | |
1067 i = do_completion (); | |
1068 switch (i) | |
1069 { | |
1070 case 1: | |
1071 case 3: | |
1072 goto exit; | |
1073 | |
1074 case 4: | |
488 | 1075 if (!NILP (Vminibuffer_completion_confirm)) |
284 | 1076 { |
1077 temp_echo_area_glyphs (" [Confirm]"); | |
1078 return Qnil; | |
1079 } | |
1080 else | |
1081 goto exit; | |
1082 | |
1083 default: | |
1084 return Qnil; | |
1085 } | |
1086 exit: | |
1087 Fthrow (Qexit, Qnil); | |
1088 /* NOTREACHED */ | |
1089 } | |
1090 | |
1091 DEFUN ("minibuffer-complete-word", Fminibuffer_complete_word, Sminibuffer_complete_word, | |
1092 0, 0, "", | |
1093 "Complete the minibuffer contents at most a single word.\n\ | |
1094 After one word is completed as much as possible, a space or hyphen\n\ | |
1095 is added, provided that matches some possible completion.") | |
1096 () | |
1097 { | |
1098 Lisp_Object completion, tem; | |
1099 register int i; | |
1100 register unsigned char *completion_string; | |
1101 /* We keep calling Fbuffer_string | |
1102 rather than arrange for GC to hold onto a pointer to | |
1103 one of the strings thus made. */ | |
1104 | |
1105 completion = Ftry_completion (Fbuffer_string (), | |
1106 Vminibuffer_completion_table, | |
1107 Vminibuffer_completion_predicate); | |
488 | 1108 if (NILP (completion)) |
284 | 1109 { |
1110 bitch_at_user (); | |
1111 temp_echo_area_glyphs (" [No match]"); | |
1112 return Qnil; | |
1113 } | |
1114 if (EQ (completion, Qt)) | |
1115 return Qnil; | |
1116 | |
1117 #if 0 /* How the below code used to look, for reference */ | |
1118 tem = Fbuffer_string (); | |
1119 b = XSTRING (tem)->data; | |
1120 i = ZV - 1 - XSTRING (completion)->size; | |
1121 p = XSTRING (completion)->data; | |
1122 if (i > 0 || | |
1123 0 <= scmp (b, p, ZV - 1)) | |
1124 { | |
1125 i = 1; | |
1126 /* Set buffer to longest match of buffer tail and completion head. */ | |
1127 while (0 <= scmp (b + i, p, ZV - 1 - i)) | |
1128 i++; | |
1129 del_range (1, i + 1); | |
1130 SET_PT (ZV); | |
1131 } | |
1132 #else /* Rewritten code */ | |
1133 { | |
1134 register unsigned char *buffer_string; | |
1135 int buffer_length, completion_length; | |
1136 | |
1137 tem = Fbuffer_string (); | |
1138 buffer_string = XSTRING (tem)->data; | |
1139 completion_string = XSTRING (completion)->data; | |
1140 buffer_length = XSTRING (tem)->size; /* ie ZV - BEGV */ | |
1141 completion_length = XSTRING (completion)->size; | |
1142 i = buffer_length - completion_length; | |
1143 /* Mly: I don't understand what this is supposed to do AT ALL */ | |
1144 if (i > 0 || | |
1145 0 <= scmp (buffer_string, completion_string, buffer_length)) | |
1146 { | |
1147 /* Set buffer to longest match of buffer tail and completion head. */ | |
1148 if (i <= 0) i = 1; | |
1149 buffer_string += i; | |
1150 buffer_length -= i; | |
1151 while (0 <= scmp (buffer_string++, completion_string, buffer_length--)) | |
1152 i++; | |
1153 del_range (1, i + 1); | |
1154 SET_PT (ZV); | |
1155 } | |
1156 } | |
1157 #endif /* Rewritten code */ | |
1158 i = ZV - BEGV; | |
1159 | |
1160 /* If completion finds next char not unique, | |
1161 consider adding a space or a hyphen */ | |
1162 if (i == XSTRING (completion)->size) | |
1163 { | |
1164 tem = Ftry_completion (concat2 (Fbuffer_string (), build_string (" ")), | |
1165 Vminibuffer_completion_table, | |
1166 Vminibuffer_completion_predicate); | |
1167 if (XTYPE (tem) == Lisp_String) | |
1168 completion = tem; | |
1169 else | |
1170 { | |
1171 tem = Ftry_completion (concat2 (Fbuffer_string (), build_string ("-")), | |
1172 Vminibuffer_completion_table, | |
1173 Vminibuffer_completion_predicate); | |
1174 if (XTYPE (tem) == Lisp_String) | |
1175 completion = tem; | |
1176 } | |
1177 } | |
1178 | |
1179 /* Now find first word-break in the stuff found by completion. | |
1180 i gets index in string of where to stop completing. */ | |
1181 completion_string = XSTRING (completion)->data; | |
1182 | |
1183 for (; i < XSTRING (completion)->size; i++) | |
1184 if (SYNTAX (completion_string[i]) != Sword) break; | |
1185 if (i < XSTRING (completion)->size) | |
1186 i = i + 1; | |
1187 | |
1188 /* If got no characters, print help for user. */ | |
1189 | |
1190 if (i == ZV - BEGV) | |
1191 { | |
1192 if (auto_help) | |
1193 Fminibuffer_completion_help (); | |
1194 return Qnil; | |
1195 } | |
1196 | |
1197 /* Otherwise insert in minibuffer the chars we got */ | |
1198 | |
1199 Ferase_buffer (); | |
1200 insert_from_string (completion, 0, i); | |
1201 return Qt; | |
1202 } | |
1203 | |
1204 DEFUN ("display-completion-list", Fdisplay_completion_list, Sdisplay_completion_list, | |
1205 1, 1, 0, | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1206 "Display the list of completions, COMPLETIONS, using `standard-output'.\n\ |
284 | 1207 Each element may be just a symbol or string\n\ |
1208 or may be a list of two strings to be printed as if concatenated.") | |
1209 (completions) | |
1210 Lisp_Object completions; | |
1211 { | |
1212 register Lisp_Object tail, elt; | |
1213 register int i; | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1214 int column = 0; |
284 | 1215 /* No GCPRO needed, since (when it matters) every variable |
1216 points to a non-string that is pointed to by COMPLETIONS. */ | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1217 struct buffer *old = current_buffer; |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1218 if (XTYPE (Vstandard_output) == Lisp_Buffer) |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1219 set_buffer_internal (XBUFFER (Vstandard_output)); |
284 | 1220 |
488 | 1221 if (NILP (completions)) |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1222 write_string ("There are no possible completions of what you have typed.", -1); |
284 | 1223 else |
1224 { | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1225 write_string ("Possible completions are:", -1); |
488 | 1226 for (tail = completions, i = 0; !NILP (tail); tail = Fcdr (tail), i++) |
284 | 1227 { |
1228 /* this needs fixing for the case of long completions | |
1229 and/or narrow windows */ | |
1230 /* Sadly, the window it will appear in is not known | |
1231 until after the text has been made. */ | |
1232 if (i & 1) | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1233 { |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1234 if (XTYPE (Vstandard_output) == Lisp_Buffer) |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1235 Findent_to (make_number (35), make_number (1)); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1236 else |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1237 { |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1238 do |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1239 { |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1240 write_string (" ", -1); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1241 column++; |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1242 } |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1243 while (column < 35); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1244 } |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1245 } |
284 | 1246 else |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1247 { |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1248 Fterpri (Qnil); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1249 column = 0; |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1250 } |
284 | 1251 elt = Fcar (tail); |
1252 if (CONSP (elt)) | |
1253 { | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1254 if (XTYPE (Vstandard_output) != Lisp_Buffer) |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1255 { |
737 | 1256 Lisp_Object tem; |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1257 tem = Flength (Fcar (elt)); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1258 column += XINT (tem); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1259 tem = Flength (Fcar (Fcdr (elt))); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1260 column += XINT (tem); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1261 } |
284 | 1262 Fprinc (Fcar (elt), Qnil); |
1263 Fprinc (Fcar (Fcdr (elt)), Qnil); | |
1264 } | |
1265 else | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1266 { |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1267 if (XTYPE (Vstandard_output) != Lisp_Buffer) |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1268 { |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1269 Lisp_Object tem; |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1270 tem = Flength (elt, Qt); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1271 column += XINT (tem); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1272 } |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1273 Fprinc (elt, Qnil); |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1274 } |
284 | 1275 } |
1276 } | |
736
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1277 |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1278 if (XTYPE (Vstandard_output) == Lisp_Buffer) |
18b892513cb7
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
732
diff
changeset
|
1279 set_buffer_internal (old); |
284 | 1280 return Qnil; |
1281 } | |
1282 | |
1283 DEFUN ("minibuffer-completion-help", Fminibuffer_completion_help, Sminibuffer_completion_help, | |
1284 0, 0, "", | |
1285 "Display a list of possible completions of the current minibuffer contents.") | |
1286 () | |
1287 { | |
1288 Lisp_Object completions; | |
1289 | |
1290 message ("Making completion list..."); | |
1291 completions = Fall_completions (Fbuffer_string (), | |
1292 Vminibuffer_completion_table, | |
1293 Vminibuffer_completion_predicate); | |
1294 echo_area_glyphs = 0; | |
1295 | |
488 | 1296 if (NILP (completions)) |
284 | 1297 { |
1298 bitch_at_user (); | |
1299 temp_echo_area_glyphs (" [No completions]"); | |
1300 } | |
1301 else | |
1302 internal_with_output_to_temp_buffer ("*Completions*", | |
1303 Fdisplay_completion_list, | |
1304 Fsort (completions, Qstring_lessp)); | |
1305 return Qnil; | |
1306 } | |
1307 | |
1308 DEFUN ("self-insert-and-exit", Fself_insert_and_exit, Sself_insert_and_exit, 0, 0, "", | |
1309 "Terminate minibuffer input.") | |
1310 () | |
1311 { | |
1312 if (XTYPE (last_command_char) == Lisp_Int) | |
1313 internal_self_insert (last_command_char, 0); | |
1314 else | |
1315 bitch_at_user (); | |
1316 | |
1317 Fthrow (Qexit, Qnil); | |
1318 } | |
1319 | |
1320 DEFUN ("exit-minibuffer", Fexit_minibuffer, Sexit_minibuffer, 0, 0, "", | |
1321 "Terminate this minibuffer argument.") | |
1322 () | |
1323 { | |
1324 Fthrow (Qexit, Qnil); | |
1325 } | |
1326 | |
1327 DEFUN ("minibuffer-depth", Fminibuffer_depth, Sminibuffer_depth, 0, 0, 0, | |
1328 "Return current depth of activations of minibuffer, a nonnegative integer.") | |
1329 () | |
1330 { | |
1331 return make_number (minibuf_level); | |
1332 } | |
1333 | |
1334 | |
1335 init_minibuf_once () | |
1336 { | |
1337 Vminibuffer_list = Qnil; | |
1338 staticpro (&Vminibuffer_list); | |
1339 } | |
1340 | |
1341 syms_of_minibuf () | |
1342 { | |
1343 minibuf_level = 0; | |
1344 minibuf_prompt = 0; | |
1345 minibuf_save_vector_size = 5; | |
1346 minibuf_save_vector = (struct minibuf_save_data *) malloc (5 * sizeof (struct minibuf_save_data)); | |
1347 | |
1348 Qminibuffer_completion_table = intern ("minibuffer-completion-table"); | |
1349 staticpro (&Qminibuffer_completion_table); | |
1350 | |
1351 Qminibuffer_completion_confirm = intern ("minibuffer-completion-confirm"); | |
1352 staticpro (&Qminibuffer_completion_confirm); | |
1353 | |
1354 Qminibuffer_completion_predicate = intern ("minibuffer-completion-predicate"); | |
1355 staticpro (&Qminibuffer_completion_predicate); | |
1356 | |
1357 staticpro (&last_minibuf_string); | |
1358 last_minibuf_string = Qnil; | |
1359 | |
1360 Quser_variable_p = intern ("user-variable-p"); | |
1361 staticpro (&Quser_variable_p); | |
1362 | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1363 Qminibuffer_history = intern ("minibuffer-history"); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1364 staticpro (&Qminibuffer_history); |
284 | 1365 |
1366 DEFVAR_BOOL ("completion-auto-help", &auto_help, | |
1367 "*Non-nil means automatically provide help for invalid completion input."); | |
1368 auto_help = 1; | |
1369 | |
1370 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case, | |
1371 "Non-nil means don't consider case significant in completion."); | |
1372 completion_ignore_case = 0; | |
1373 | |
1374 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers, | |
1375 "*Non-nil means to allow minibuffer commands while in the minibuffer.\n\ | |
1376 More precisely, this variable makes a difference when the minibuffer window\n\ | |
1377 is the selected window. If you are in some other window, minibuffer commands\n\ | |
1378 are allowed even if a minibuffer is active."); | |
1379 enable_recursive_minibuffers = 0; | |
1380 | |
1381 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table, | |
1382 "Alist or obarray used for completion in the minibuffer.\n\ | |
1383 This becomes the ALIST argument to `try-completion' and `all-completion'.\n\ | |
1384 \n\ | |
1385 The value may alternatively be a function, which is given three arguments:\n\ | |
1386 STRING, the current buffer contents;\n\ | |
1387 PREDICATE, the predicate for filtering possible matches;\n\ | |
1388 CODE, which says what kind of things to do.\n\ | |
1389 CODE can be nil, t or `lambda'.\n\ | |
1390 nil means to return the best completion of STRING, or nil if there is none.\n\ | |
1391 t means to return a list of all possible completions of STRING.\n\ | |
1392 `lambda' means to return t if STRING is a valid completion as it stands."); | |
1393 Vminibuffer_completion_table = Qnil; | |
1394 | |
1395 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate, | |
1396 "Within call to `completing-read', this holds the PREDICATE argument."); | |
1397 Vminibuffer_completion_predicate = Qnil; | |
1398 | |
1399 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm, | |
1400 "Non-nil => demand confirmation of completion before exiting minibuffer."); | |
1401 Vminibuffer_completion_confirm = Qnil; | |
1402 | |
1403 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form, | |
1404 "Value that `help-form' takes on inside the minibuffer."); | |
1405 Vminibuffer_help_form = Qnil; | |
1406 | |
864
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1407 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable, |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1408 "History list symbol to add minibuffer values to.\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1409 Each minibuffer output is added with\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1410 (set minibuffer-history-variable\n\ |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1411 (cons STRING (symbol-value minibuffer-history-variable)))"); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1412 XFASTINT (Vminibuffer_history_variable) = 0; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1413 |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1414 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position, |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1415 "Current position of redoing in the history list."); |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1416 Vminibuffer_history_position = Qnil; |
fe5f6b7c9727
*** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents:
765
diff
changeset
|
1417 |
284 | 1418 defsubr (&Sread_from_minibuffer); |
1419 defsubr (&Seval_minibuffer); | |
1420 defsubr (&Sread_minibuffer); | |
1421 defsubr (&Sread_string); | |
1422 defsubr (&Sread_command); | |
1423 defsubr (&Sread_variable); | |
1424 defsubr (&Sread_buffer); | |
1425 defsubr (&Sread_no_blanks_input); | |
1426 defsubr (&Sminibuffer_depth); | |
1427 | |
1428 defsubr (&Stry_completion); | |
1429 defsubr (&Sall_completions); | |
1430 defsubr (&Scompleting_read); | |
1431 defsubr (&Sminibuffer_complete); | |
1432 defsubr (&Sminibuffer_complete_word); | |
1433 defsubr (&Sminibuffer_complete_and_exit); | |
1434 defsubr (&Sdisplay_completion_list); | |
1435 defsubr (&Sminibuffer_completion_help); | |
1436 | |
1437 defsubr (&Sself_insert_and_exit); | |
1438 defsubr (&Sexit_minibuffer); | |
1439 | |
1440 } | |
1441 | |
1442 keys_of_minibuf () | |
1443 { | |
1444 initial_define_key (Vminibuffer_local_map, Ctl ('g'), | |
1445 "abort-recursive-edit"); | |
1446 initial_define_key (Vminibuffer_local_map, Ctl ('m'), | |
1447 "exit-minibuffer"); | |
1448 initial_define_key (Vminibuffer_local_map, Ctl ('j'), | |
1449 "exit-minibuffer"); | |
1450 | |
1451 initial_define_key (Vminibuffer_local_ns_map, Ctl ('g'), | |
1452 "abort-recursive-edit"); | |
1453 initial_define_key (Vminibuffer_local_ns_map, Ctl ('m'), | |
1454 "exit-minibuffer"); | |
1455 initial_define_key (Vminibuffer_local_ns_map, Ctl ('j'), | |
1456 "exit-minibuffer"); | |
1457 | |
1458 initial_define_key (Vminibuffer_local_ns_map, ' ', | |
1459 "exit-minibuffer"); | |
1460 initial_define_key (Vminibuffer_local_ns_map, '\t', | |
1461 "exit-minibuffer"); | |
1462 initial_define_key (Vminibuffer_local_ns_map, '?', | |
1463 "self-insert-and-exit"); | |
1464 | |
1465 initial_define_key (Vminibuffer_local_completion_map, Ctl ('g'), | |
1466 "abort-recursive-edit"); | |
1467 initial_define_key (Vminibuffer_local_completion_map, Ctl ('m'), | |
1468 "exit-minibuffer"); | |
1469 initial_define_key (Vminibuffer_local_completion_map, Ctl ('j'), | |
1470 "exit-minibuffer"); | |
1471 | |
1472 initial_define_key (Vminibuffer_local_completion_map, '\t', | |
1473 "minibuffer-complete"); | |
1474 initial_define_key (Vminibuffer_local_completion_map, ' ', | |
1475 "minibuffer-complete-word"); | |
1476 initial_define_key (Vminibuffer_local_completion_map, '?', | |
1477 "minibuffer-completion-help"); | |
1478 | |
1479 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('g'), | |
1480 "abort-recursive-edit"); | |
1481 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('m'), | |
1482 "minibuffer-complete-and-exit"); | |
1483 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('j'), | |
1484 "minibuffer-complete-and-exit"); | |
1485 initial_define_key (Vminibuffer_local_must_match_map, '\t', | |
1486 "minibuffer-complete"); | |
1487 initial_define_key (Vminibuffer_local_must_match_map, ' ', | |
1488 "minibuffer-complete-word"); | |
1489 initial_define_key (Vminibuffer_local_must_match_map, '?', | |
1490 "minibuffer-completion-help"); | |
1491 } |