]> code.delx.au - gnu-emacs/blob - src/minibuf.c
(concat): Handle bool-vectors correctly.
[gnu-emacs] / src / minibuf.c
1 /* Minibuffer input and completion.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1996, 1997, 1998
3 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
21
22
23 #include <config.h>
24 #include "lisp.h"
25 #include "commands.h"
26 #include "buffer.h"
27 #include "charset.h"
28 #include "dispextern.h"
29 #include "frame.h"
30 #include "window.h"
31 #include "syntax.h"
32 #include "keyboard.h"
33
34 #define min(a, b) ((a) < (b) ? (a) : (b))
35
36 extern int quit_char;
37
38 /* List of buffers for use as minibuffers.
39 The first element of the list is used for the outermost minibuffer
40 invocation, the next element is used for a recursive minibuffer
41 invocation, etc. The list is extended at the end as deeper
42 minibuffer recursions are encountered. */
43 Lisp_Object Vminibuffer_list;
44
45 /* Data to remember during recursive minibuffer invocations */
46 Lisp_Object minibuf_save_list;
47
48 /* Depth in minibuffer invocations. */
49 int minibuf_level;
50
51 /* Nonzero means display completion help for invalid input. */
52 int auto_help;
53
54 /* The maximum length of a minibuffer history. */
55 Lisp_Object Qhistory_length, Vhistory_length;
56
57 /* Fread_minibuffer leaves the input here as a string. */
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 /* Nonzero means don't ignore text properties
65 in Fread_from_minibuffer. */
66 int minibuffer_allow_text_properties;
67
68 /* help-form is bound to this while in the minibuffer. */
69
70 Lisp_Object Vminibuffer_help_form;
71
72 /* Variable which is the history list to add minibuffer values to. */
73
74 Lisp_Object Vminibuffer_history_variable;
75
76 /* Current position in the history list (adjusted by M-n and M-p). */
77
78 Lisp_Object Vminibuffer_history_position;
79
80 Lisp_Object Qminibuffer_history;
81
82 Lisp_Object Qread_file_name_internal;
83
84 /* Normal hooks for entry to and exit from minibuffer. */
85
86 Lisp_Object Qminibuffer_setup_hook, Vminibuffer_setup_hook;
87 Lisp_Object Qminibuffer_exit_hook, Vminibuffer_exit_hook;
88
89 /* Function to call to read a buffer name. */
90 Lisp_Object Vread_buffer_function;
91
92 /* Nonzero means completion ignores case. */
93
94 int completion_ignore_case;
95
96 /* List of regexps that should restrict possible completions. */
97
98 Lisp_Object Vcompletion_regexp_list;
99
100 /* Nonzero means raise the minibuffer frame when the minibuffer
101 is entered. */
102
103 int minibuffer_auto_raise;
104
105 /* If last completion attempt reported "Complete but not unique"
106 then this is the string completed then; otherwise this is nil. */
107
108 static Lisp_Object last_exact_completion;
109
110 Lisp_Object Quser_variable_p;
111
112 Lisp_Object Qminibuffer_default;
113
114 /* Non-nil means it is the window for C-M-v to scroll
115 when the minibuffer is selected. */
116 extern Lisp_Object Vminibuf_scroll_window;
117
118 extern Lisp_Object Voverriding_local_map;
119
120 Lisp_Object Qcurrent_input_method, Qactivate_input_method;
121
122 \f
123 /* Put minibuf on currently selected frame's minibuffer.
124 We do this whenever the user starts a new minibuffer
125 or when a minibuffer exits. */
126
127 void
128 choose_minibuf_frame ()
129 {
130 if (selected_frame != 0
131 && !EQ (minibuf_window, selected_frame->minibuffer_window))
132 {
133 /* I don't think that any frames may validly have a null minibuffer
134 window anymore. */
135 if (NILP (selected_frame->minibuffer_window))
136 abort ();
137
138 Fset_window_buffer (selected_frame->minibuffer_window,
139 XWINDOW (minibuf_window)->buffer);
140 minibuf_window = selected_frame->minibuffer_window;
141 }
142
143 /* Make sure no other frame has a minibuffer as its selected window,
144 because the text would not be displayed in it, and that would be
145 confusing. Only allow the selected frame to do this,
146 and that only if the minibuffer is active. */
147 {
148 Lisp_Object tail, frame;
149
150 FOR_EACH_FRAME (tail, frame)
151 if (MINI_WINDOW_P (XWINDOW (FRAME_SELECTED_WINDOW (XFRAME (frame))))
152 && !(XFRAME (frame) == selected_frame
153 && minibuf_level > 0))
154 Fset_frame_selected_window (frame, Fframe_first_window (frame));
155 }
156 }
157
158 Lisp_Object
159 choose_minibuf_frame_1 (ignore)
160 Lisp_Object ignore;
161 {
162 choose_minibuf_frame ();
163 return Qnil;
164 }
165
166 DEFUN ("set-minibuffer-window", Fset_minibuffer_window,
167 Sset_minibuffer_window, 1, 1, 0,
168 "Specify which minibuffer window to use for the minibuffer.\n\
169 This effects where the minibuffer is displayed if you put text in it\n\
170 without invoking the usual minibuffer commands.")
171 (window)
172 Lisp_Object window;
173 {
174 CHECK_WINDOW (window, 1);
175 if (! MINI_WINDOW_P (XWINDOW (window)))
176 error ("Window is not a minibuffer window");
177
178 minibuf_window = window;
179
180 return window;
181 }
182
183 \f
184 /* Actual minibuffer invocation. */
185
186 static Lisp_Object read_minibuf_unwind P_ ((Lisp_Object));
187 static Lisp_Object read_minibuf P_ ((Lisp_Object, Lisp_Object,
188 Lisp_Object, Lisp_Object,
189 int, Lisp_Object,
190 Lisp_Object, Lisp_Object,
191 int, int));
192
193 /* Read from the minibuffer using keymap MAP, initial contents INITIAL
194 (a string), putting point minus BACKUP_N bytes from the end of INITIAL,
195 prompting with PROMPT (a string), using history list HISTVAR
196 with initial position HISTPOS. (BACKUP_N should be <= 0.)
197
198 Normally return the result as a string (the text that was read),
199 but if EXPFLAG is nonzero, read it and return the object read.
200 If HISTVAR is given, save the value read on that history only if it doesn't
201 match the front of that history list exactly. The value is pushed onto
202 the list as the string that was read.
203
204 DEFALT specifies te default value for the sake of history commands.
205
206 If ALLOW_PROPS is nonzero, we do not throw away text properties.
207
208 if INHERIT_INPUT_METHOD is nonzeor, the minibuffer inherit the
209 current input method. */
210
211 static Lisp_Object
212 read_minibuf (map, initial, prompt, backup_n, expflag,
213 histvar, histpos, defalt, allow_props, inherit_input_method)
214 Lisp_Object map;
215 Lisp_Object initial;
216 Lisp_Object prompt;
217 Lisp_Object backup_n;
218 int expflag;
219 Lisp_Object histvar;
220 Lisp_Object histpos;
221 Lisp_Object defalt;
222 int allow_props;
223 int inherit_input_method;
224 {
225 Lisp_Object val;
226 int count = specpdl_ptr - specpdl;
227 Lisp_Object mini_frame, ambient_dir, minibuffer, input_method;
228 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
229 Lisp_Object enable_multibyte;
230
231 specbind (Qminibuffer_default, defalt);
232
233 single_kboard_state ();
234
235 val = Qnil;
236 ambient_dir = current_buffer->directory;
237 input_method = Qnil;
238 enable_multibyte = Qnil;
239
240 /* Don't need to protect PROMPT, HISTVAR, and HISTPOS because we
241 store them away before we can GC. Don't need to protect
242 BACKUP_N because we use the value only if it is an integer. */
243 GCPRO5 (map, initial, val, ambient_dir, input_method);
244
245 if (!STRINGP (prompt))
246 prompt = build_string ("");
247
248 if (!enable_recursive_minibuffers
249 && minibuf_level > 0)
250 {
251 if (EQ (selected_window, minibuf_window))
252 error ("Command attempted to use minibuffer while in minibuffer");
253 else
254 /* If we're in another window, cancel the minibuffer that's active. */
255 Fthrow (Qexit,
256 build_string ("Command attempted to use minibuffer while in minibuffer"));
257 }
258
259 /* Choose the minibuffer window and frame, and take action on them. */
260
261 choose_minibuf_frame ();
262
263 record_unwind_protect (choose_minibuf_frame_1, Qnil);
264
265 record_unwind_protect (Fset_window_configuration,
266 Fcurrent_window_configuration (Qnil));
267
268 /* If the minibuffer window is on a different frame, save that
269 frame's configuration too. */
270 mini_frame = WINDOW_FRAME (XWINDOW (minibuf_window));
271 if (XFRAME (mini_frame) != selected_frame)
272 record_unwind_protect (Fset_window_configuration,
273 Fcurrent_window_configuration (mini_frame));
274
275 /* If the minibuffer is on an iconified or invisible frame,
276 make it visible now. */
277 Fmake_frame_visible (mini_frame);
278
279 if (minibuffer_auto_raise)
280 Fraise_frame (mini_frame);
281
282 /* We have to do this after saving the window configuration
283 since that is what restores the current buffer. */
284
285 /* Arrange to restore a number of minibuffer-related variables.
286 We could bind each variable separately, but that would use lots of
287 specpdl slots. */
288 minibuf_save_list
289 = Fcons (Voverriding_local_map,
290 Fcons (minibuf_window, minibuf_save_list));
291 minibuf_save_list
292 = Fcons (minibuf_prompt,
293 Fcons (make_number (minibuf_prompt_width),
294 Fcons (Vhelp_form,
295 Fcons (Vcurrent_prefix_arg,
296 Fcons (Vminibuffer_history_position,
297 Fcons (Vminibuffer_history_variable,
298 minibuf_save_list))))));
299
300 record_unwind_protect (read_minibuf_unwind, Qnil);
301 minibuf_level++;
302
303 /* Now that we can restore all those variables, start changing them. */
304
305 minibuf_prompt_width = 0; /* xdisp.c puts in the right value. */
306 minibuf_prompt = Fcopy_sequence (prompt);
307 Vminibuffer_history_position = histpos;
308 Vminibuffer_history_variable = histvar;
309 Vhelp_form = Vminibuffer_help_form;
310
311 if (inherit_input_method)
312 {
313 /* `current-input-method' is buffer local. So, remeber it in
314 INPUT_METHOD before changing the current buffer. */
315 input_method = Fsymbol_value (Qcurrent_input_method);
316 enable_multibyte = current_buffer->enable_multibyte_characters;
317 }
318
319 /* Switch to the minibuffer. */
320
321 minibuffer = get_minibuffer (minibuf_level);
322 Fset_buffer (minibuffer);
323
324 /* The current buffer's default directory is usually the right thing
325 for our minibuffer here. However, if you're typing a command at
326 a minibuffer-only frame when minibuf_level is zero, then buf IS
327 the current_buffer, so reset_buffer leaves buf's default
328 directory unchanged. This is a bummer when you've just started
329 up Emacs and buf's default directory is Qnil. Here's a hack; can
330 you think of something better to do? Find another buffer with a
331 better directory, and use that one instead. */
332 if (STRINGP (ambient_dir))
333 current_buffer->directory = ambient_dir;
334 else
335 {
336 Lisp_Object buf_list;
337
338 for (buf_list = Vbuffer_alist;
339 CONSP (buf_list);
340 buf_list = XCONS (buf_list)->cdr)
341 {
342 Lisp_Object other_buf;
343
344 other_buf = XCONS (XCONS (buf_list)->car)->cdr;
345 if (STRINGP (XBUFFER (other_buf)->directory))
346 {
347 current_buffer->directory = XBUFFER (other_buf)->directory;
348 break;
349 }
350 }
351 }
352
353 if (XFRAME (mini_frame) != selected_frame)
354 Fredirect_frame_focus (Fselected_frame (), mini_frame);
355
356 Vminibuf_scroll_window = selected_window;
357 Fset_window_buffer (minibuf_window, Fcurrent_buffer ());
358 Fselect_window (minibuf_window);
359 XSETFASTINT (XWINDOW (minibuf_window)->hscroll, 0);
360
361 Fmake_local_variable (Qprint_escape_newlines);
362 print_escape_newlines = 1;
363
364 /* Erase the buffer. */
365 {
366 int count1 = specpdl_ptr - specpdl;
367 specbind (Qinhibit_read_only, Qt);
368 Ferase_buffer ();
369 unbind_to (count1, Qnil);
370 }
371
372 /* Put in the initial input. */
373 if (!NILP (initial))
374 {
375 Finsert (1, &initial);
376 if (INTEGERP (backup_n))
377 Fforward_char (backup_n);
378 }
379
380 echo_area_glyphs = 0;
381 /* This is in case the minibuffer-setup-hook calls Fsit_for. */
382 previous_echo_glyphs = 0;
383
384 current_buffer->keymap = map;
385
386 /* Turn on an input method stored in INPUT_METHOD if any. */
387 if (STRINGP (input_method) && !NILP (Ffboundp (Qactivate_input_method)))
388 call1 (Qactivate_input_method, input_method);
389
390 /* If appropriate, copy enable-multibyte-characters into the minibuffer. */
391 if (inherit_input_method)
392 current_buffer->enable_multibyte_characters = enable_multibyte;
393
394 /* Run our hook, but not if it is empty.
395 (run-hooks would do nothing if it is empty,
396 but it's important to save time here in the usual case). */
397 if (!NILP (Vminibuffer_setup_hook) && !EQ (Vminibuffer_setup_hook, Qunbound)
398 && !NILP (Vrun_hooks))
399 call1 (Vrun_hooks, Qminibuffer_setup_hook);
400
401 /* ??? MCC did redraw_screen here if switching screens. */
402 recursive_edit_1 ();
403
404 /* If cursor is on the minibuffer line,
405 show the user we have exited by putting it in column 0. */
406 if ((FRAME_CURSOR_Y (selected_frame)
407 >= XFASTINT (XWINDOW (minibuf_window)->top))
408 && !noninteractive)
409 {
410 FRAME_CURSOR_X (selected_frame)
411 = FRAME_LEFT_SCROLL_BAR_WIDTH (selected_frame);
412 update_frame (selected_frame, 1, 1);
413 }
414
415 /* Make minibuffer contents into a string. */
416 Fset_buffer (minibuffer);
417 val = make_buffer_string (1, Z, allow_props);
418 #if 0 /* make_buffer_string should handle the gap. */
419 bcopy (GAP_END_ADDR, XSTRING (val)->data + GPT - BEG, Z - GPT);
420 #endif
421
422 /* VAL is the string of minibuffer text. */
423
424 if (STRINGP (val) && XSTRING (val)->size == 0 && ! NILP (defalt))
425 val = defalt;
426
427 last_minibuf_string = val;
428
429 /* Add the value to the appropriate history list unless it is empty. */
430 if (XSTRING (val)->size != 0
431 && SYMBOLP (Vminibuffer_history_variable)
432 && ! EQ (XSYMBOL (Vminibuffer_history_variable)->value, Qunbound))
433 {
434 /* If the caller wanted to save the value read on a history list,
435 then do so if the value is not already the front of the list. */
436 Lisp_Object histval;
437 histval = Fsymbol_value (Vminibuffer_history_variable);
438
439 /* The value of the history variable must be a cons or nil. Other
440 values are unacceptable. We silently ignore these values. */
441 if (NILP (histval)
442 || (CONSP (histval)
443 && NILP (Fequal (last_minibuf_string, Fcar (histval)))))
444 {
445 Lisp_Object length;
446
447 histval = Fcons (last_minibuf_string, histval);
448 Fset (Vminibuffer_history_variable, histval);
449
450 /* Truncate if requested. */
451 length = Fget (Vminibuffer_history_variable, Qhistory_length);
452 if (NILP (length)) length = Vhistory_length;
453 if (INTEGERP (length))
454 {
455 if (XINT (length) <= 0)
456 Fset (Vminibuffer_history_variable, Qnil);
457 else
458 {
459 Lisp_Object temp;
460
461 temp = Fnthcdr (Fsub1 (length), histval);
462 if (CONSP (temp)) Fsetcdr (temp, Qnil);
463 }
464 }
465 }
466 }
467
468 /* If Lisp form desired instead of string, parse it. */
469 if (expflag)
470 {
471 Lisp_Object expr_and_pos;
472 unsigned char *p;
473 int pos;
474
475 expr_and_pos = Fread_from_string (val, Qnil, Qnil);
476 pos = XINT (Fcdr (expr_and_pos));
477 if (pos != XSTRING (val)->size)
478 {
479 /* Ignore trailing whitespace; any other trailing junk is an error. */
480 int i;
481 pos = string_char_to_byte (val, pos);
482 for (i = pos; i < XSTRING (val)->size_byte; i++)
483 {
484 int c = XSTRING (val)->data[i];
485 if (c != ' ' && c != '\t' && c != '\n')
486 error ("Trailing garbage following expression");
487 }
488 }
489 val = Fcar (expr_and_pos);
490 }
491
492 /* The appropriate frame will get selected
493 in set-window-configuration. */
494 RETURN_UNGCPRO (unbind_to (count, val));
495 }
496
497 /* Return a buffer to be used as the minibuffer at depth `depth'.
498 depth = 0 is the lowest allowed argument, and that is the value
499 used for nonrecursive minibuffer invocations */
500
501 Lisp_Object
502 get_minibuffer (depth)
503 int depth;
504 {
505 Lisp_Object tail, num, buf;
506 char name[24];
507 extern Lisp_Object nconc2 ();
508
509 XSETFASTINT (num, depth);
510 tail = Fnthcdr (num, Vminibuffer_list);
511 if (NILP (tail))
512 {
513 tail = Fcons (Qnil, Qnil);
514 Vminibuffer_list = nconc2 (Vminibuffer_list, tail);
515 }
516 buf = Fcar (tail);
517 if (NILP (buf) || NILP (XBUFFER (buf)->name))
518 {
519 sprintf (name, " *Minibuf-%d*", depth);
520 buf = Fget_buffer_create (build_string (name));
521
522 /* Although the buffer's name starts with a space, undo should be
523 enabled in it. */
524 Fbuffer_enable_undo (buf);
525
526 XCONS (tail)->car = buf;
527 }
528 else
529 {
530 int count = specpdl_ptr - specpdl;
531
532 reset_buffer (XBUFFER (buf));
533 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
534 Fset_buffer (buf);
535 Fkill_all_local_variables ();
536 unbind_to (count, Qnil);
537 }
538
539 return buf;
540 }
541
542 /* This function is called on exiting minibuffer, whether normally or not,
543 and it restores the current window, buffer, etc. */
544
545 static Lisp_Object
546 read_minibuf_unwind (data)
547 Lisp_Object data;
548 {
549 Lisp_Object old_deactivate_mark;
550 Lisp_Object window;
551
552 /* We are exiting the minibuffer one way or the other,
553 so run the hook. */
554 if (!NILP (Vminibuffer_exit_hook) && !EQ (Vminibuffer_exit_hook, Qunbound)
555 && !NILP (Vrun_hooks))
556 safe_run_hooks (Qminibuffer_exit_hook);
557
558 /* If this was a recursive minibuffer,
559 tie the minibuffer window back to the outer level minibuffer buffer. */
560 minibuf_level--;
561
562 window = minibuf_window;
563 /* To keep things predictable, in case it matters, let's be in the minibuffer
564 when we reset the relevant variables. */
565 Fset_buffer (XWINDOW (window)->buffer);
566
567 /* Restore prompt, etc, from outer minibuffer level. */
568 minibuf_prompt = Fcar (minibuf_save_list);
569 minibuf_save_list = Fcdr (minibuf_save_list);
570 minibuf_prompt_width = XFASTINT (Fcar (minibuf_save_list));
571 minibuf_save_list = Fcdr (minibuf_save_list);
572 Vhelp_form = Fcar (minibuf_save_list);
573 minibuf_save_list = Fcdr (minibuf_save_list);
574 Vcurrent_prefix_arg = Fcar (minibuf_save_list);
575 minibuf_save_list = Fcdr (minibuf_save_list);
576 Vminibuffer_history_position = Fcar (minibuf_save_list);
577 minibuf_save_list = Fcdr (minibuf_save_list);
578 Vminibuffer_history_variable = Fcar (minibuf_save_list);
579 minibuf_save_list = Fcdr (minibuf_save_list);
580 Voverriding_local_map = Fcar (minibuf_save_list);
581 minibuf_save_list = Fcdr (minibuf_save_list);
582 #if 0
583 temp = Fcar (minibuf_save_list);
584 if (FRAME_LIVE_P (XFRAME (WINDOW_FRAME (XWINDOW (temp)))))
585 minibuf_window = temp;
586 #endif
587 minibuf_save_list = Fcdr (minibuf_save_list);
588
589 /* Erase the minibuffer we were using at this level. */
590 {
591 int count = specpdl_ptr - specpdl;
592 /* Prevent error in erase-buffer. */
593 specbind (Qinhibit_read_only, Qt);
594 old_deactivate_mark = Vdeactivate_mark;
595 Ferase_buffer ();
596 Vdeactivate_mark = old_deactivate_mark;
597 unbind_to (count, Qnil);
598 }
599
600 /* Make sure minibuffer window is erased, not ignored. */
601 windows_or_buffers_changed++;
602 XSETFASTINT (XWINDOW (window)->last_modified, 0);
603 XSETFASTINT (XWINDOW (window)->last_overlay_modified, 0);
604
605 return Qnil;
606 }
607 \f
608
609 /* This comment supplies the doc string for read-from-minibuffer,
610 for make-docfile to see. We cannot put this in the real DEFUN
611 due to limits in the Unix cpp.
612
613 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 7, 0,
614 "Read a string from the minibuffer, prompting with string PROMPT.\n\
615 If optional second arg INITIAL-CONTENTS is non-nil, it is a string\n\
616 to be inserted into the minibuffer before reading input.\n\
617 If INITIAL-CONTENTS is (STRING . POSITION), the initial input\n\
618 is STRING, but point is placed at position POSITION in the minibuffer.\n\
619 Third arg KEYMAP is a keymap to use whilst reading;\n\
620 if omitted or nil, the default is `minibuffer-local-map'.\n\
621 If fourth arg READ is non-nil, then interpret the result as a lisp object\n\
622 and return that object:\n\
623 in other words, do `(car (read-from-string INPUT-STRING))'\n\
624 Fifth arg HIST, if non-nil, specifies a history list\n\
625 and optionally the initial position in the list.\n\
626 It can be a symbol, which is the history list variable to use,\n\
627 or it can be a cons cell (HISTVAR . HISTPOS).\n\
628 In that case, HISTVAR is the history list variable to use,\n\
629 and HISTPOS is the initial position (the position in the list\n\
630 which INITIAL-CONTENTS corresponds to).\n\
631 Positions are counted starting from 1 at the beginning of the list.\n\
632 Sixth arg DEFAULT-VALUE is the default value. If non-nil, it is used\n\
633 for history commands, and as the value to return if the user enters\n\
634 the empty string.\n\
635 Seventh arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
636 the current input method and the setting of enable-multibyte-characters.\n\
637 If the variable `minibuffer-allow-text-properties' is non-nil,\n\
638 then the string which is returned includes whatever text properties\n\
639 were present in the minibuffer. Otherwise the value has no text properties.")
640 (prompt, initial_contents, keymap, read, hist, default_value, inherit_input_method)
641 */
642
643 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 7, 0,
644 0 /* See immediately above */)
645 (prompt, initial_contents, keymap, read, hist, default_value, inherit_input_method)
646 Lisp_Object prompt, initial_contents, keymap, read, hist, default_value;
647 Lisp_Object inherit_input_method;
648 {
649 int pos = 0;
650 Lisp_Object histvar, histpos, position, val;
651 struct gcpro gcpro1;
652
653 position = Qnil;
654
655 CHECK_STRING (prompt, 0);
656 if (!NILP (initial_contents))
657 {
658 if (CONSP (initial_contents))
659 {
660 position = Fcdr (initial_contents);
661 initial_contents = Fcar (initial_contents);
662 }
663 CHECK_STRING (initial_contents, 1);
664 if (!NILP (position))
665 {
666 CHECK_NUMBER (position, 0);
667 /* Convert to distance from end of input. */
668 if (XINT (position) < 1)
669 /* A number too small means the beginning of the string. */
670 pos = - XSTRING (initial_contents)->size;
671 else
672 pos = XINT (position) - 1 - XSTRING (initial_contents)->size;
673 }
674 }
675
676 if (NILP (keymap))
677 keymap = Vminibuffer_local_map;
678 else
679 keymap = get_keymap (keymap);
680
681 if (SYMBOLP (hist))
682 {
683 histvar = hist;
684 histpos = Qnil;
685 }
686 else
687 {
688 histvar = Fcar_safe (hist);
689 histpos = Fcdr_safe (hist);
690 }
691 if (NILP (histvar))
692 histvar = Qminibuffer_history;
693 if (NILP (histpos))
694 XSETFASTINT (histpos, 0);
695
696 GCPRO1 (default_value);
697 val = read_minibuf (keymap, initial_contents, prompt,
698 make_number (pos), !NILP (read),
699 histvar, histpos, default_value,
700 minibuffer_allow_text_properties,
701 !NILP (inherit_input_method));
702 UNGCPRO;
703 return val;
704 }
705
706 DEFUN ("read-minibuffer", Fread_minibuffer, Sread_minibuffer, 1, 2, 0,
707 "Return a Lisp object read using the minibuffer.\n\
708 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\
709 is a string to insert in the minibuffer before reading.")
710 (prompt, initial_contents)
711 Lisp_Object prompt, initial_contents;
712 {
713 CHECK_STRING (prompt, 0);
714 if (!NILP (initial_contents))
715 CHECK_STRING (initial_contents, 1);
716 return read_minibuf (Vminibuffer_local_map, initial_contents,
717 prompt, Qnil, 1, Qminibuffer_history,
718 make_number (0), Qnil, 0, 0);
719 }
720
721 DEFUN ("eval-minibuffer", Feval_minibuffer, Seval_minibuffer, 1, 2, 0,
722 "Return value of Lisp expression read using the minibuffer.\n\
723 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\
724 is a string to insert in the minibuffer before reading.")
725 (prompt, initial_contents)
726 Lisp_Object prompt, initial_contents;
727 {
728 return Feval (Fread_minibuffer (prompt, initial_contents));
729 }
730
731 /* Functions that use the minibuffer to read various things. */
732
733 DEFUN ("read-string", Fread_string, Sread_string, 1, 5, 0,
734 "Read a string from the minibuffer, prompting with string PROMPT.\n\
735 If non-nil, second arg INITIAL-INPUT is a string to insert before reading.\n\
736 The third arg HISTORY, if non-nil, specifies a history list\n\
737 and optionally the initial position in the list.\n\
738 See `read-from-minibuffer' for details of HISTORY argument.\n\
739 Fourth arg DEFAULT-VALUE is the default value. If non-nil, it is used\n\
740 for history commands, and as the value to return if the user enters\n\
741 the empty string.\n\
742 Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
743 the current input method and the setting of enable-multibyte-characters.")
744 (prompt, initial_input, history, default_value, inherit_input_method)
745 Lisp_Object prompt, initial_input, history, default_value;
746 Lisp_Object inherit_input_method;
747 {
748 return Fread_from_minibuffer (prompt, initial_input, Qnil,
749 Qnil, history, default_value,
750 inherit_input_method);
751 }
752
753 DEFUN ("read-no-blanks-input", Fread_no_blanks_input, Sread_no_blanks_input, 1, 3, 0,
754 "Args PROMPT and INIT, strings. Read a string from the terminal, not allowing blanks.\n\
755 Prompt with PROMPT, and provide INIT as an initial value of the input string.\n\
756 Third arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
757 the current input method and the setting of enable-multibyte-characters.")
758 (prompt, init, inherit_input_method)
759 Lisp_Object prompt, init, inherit_input_method;
760 {
761 CHECK_STRING (prompt, 0);
762 if (! NILP (init))
763 CHECK_STRING (init, 1);
764
765 return read_minibuf (Vminibuffer_local_ns_map, init, prompt, Qnil,
766 0, Qminibuffer_history, make_number (0), Qnil, 0,
767 !NILP (inherit_input_method));
768 }
769
770 DEFUN ("read-command", Fread_command, Sread_command, 1, 2, 0,
771 "Read the name of a command and return as a symbol.\n\
772 Prompts with PROMPT. By default, return DEFAULT-VALUE.")
773 (prompt, default_value)
774 Lisp_Object prompt, default_value;
775 {
776 Lisp_Object name, default_string;
777
778 if (NILP (default_value))
779 default_string = Qnil;
780 else if (SYMBOLP (default_value))
781 XSETSTRING (default_string, XSYMBOL (default_value)->name);
782 else
783 default_string = default_value;
784
785 name = Fcompleting_read (prompt, Vobarray, Qcommandp, Qt,
786 Qnil, Qnil, default_string, Qnil);
787 if (NILP (name))
788 return name;
789 return Fintern (name, Qnil);
790 }
791
792 #ifdef NOTDEF
793 DEFUN ("read-function", Fread_function, Sread_function, 1, 1, 0,
794 "One arg PROMPT, a string. Read the name of a function and return as a symbol.\n\
795 Prompts with PROMPT.")
796 (prompt)
797 Lisp_Object prompt;
798 {
799 return Fintern (Fcompleting_read (prompt, Vobarray, Qfboundp, Qt, Qnil, Qnil, Qnil, Qnil),
800 Qnil);
801 }
802 #endif /* NOTDEF */
803
804 DEFUN ("read-variable", Fread_variable, Sread_variable, 1, 2, 0,
805 "Read the name of a user variable and return it as a symbol.\n\
806 Prompts with PROMPT. By default, return DEFAULT-VALUE.\n\
807 A user variable is one whose documentation starts with a `*' character.")
808 (prompt, default_value)
809 Lisp_Object prompt, default_value;
810 {
811 Lisp_Object name, default_string;
812
813 if (NILP (default_value))
814 default_string = Qnil;
815 else if (SYMBOLP (default_value))
816 XSETSTRING (default_string, XSYMBOL (default_value)->name);
817 else
818 default_string = default_value;
819
820 name = Fcompleting_read (prompt, Vobarray,
821 Quser_variable_p, Qt,
822 Qnil, Qnil, default_string, Qnil);
823 if (NILP (name))
824 return name;
825 return Fintern (name, Qnil);
826 }
827
828 DEFUN ("read-buffer", Fread_buffer, Sread_buffer, 1, 3, 0,
829 "One arg PROMPT, a string. Read the name of a buffer and return as a string.\n\
830 Prompts with PROMPT.\n\
831 Optional second arg DEF is value to return if user enters an empty line.\n\
832 If optional third arg REQUIRE-MATCH is non-nil, only existing buffer names are allowed.")
833 (prompt, def, require_match)
834 Lisp_Object prompt, def, require_match;
835 {
836 Lisp_Object tem;
837 Lisp_Object args[4];
838
839 if (BUFFERP (def))
840 def = XBUFFER (def)->name;
841
842 if (NILP (Vread_buffer_function))
843 {
844 if (!NILP (def))
845 {
846 args[0] = build_string ("%s(default %s) ");
847 args[1] = prompt;
848 args[2] = def;
849 prompt = Fformat (3, args);
850 }
851
852 return Fcompleting_read (prompt, Vbuffer_alist, Qnil,
853 require_match, Qnil, Qnil, def, Qnil);
854 }
855 else
856 {
857 args[0] = Vread_buffer_function;
858 args[1] = prompt;
859 args[2] = def;
860 args[3] = require_match;
861 return Ffuncall(4, args);
862 }
863 }
864 \f
865 DEFUN ("try-completion", Ftry_completion, Stry_completion, 2, 3, 0,
866 "Return common substring of all completions of STRING in ALIST.\n\
867 Each car of each element of ALIST is tested to see if it begins with STRING.\n\
868 All that match are compared together; the longest initial sequence\n\
869 common to all matches is returned as a string.\n\
870 If there is no match at all, nil is returned.\n\
871 For an exact match, t is returned.\n\
872 \n\
873 ALIST can be an obarray instead of an alist.\n\
874 Then the print names of all symbols in the obarray are the possible matches.\n\
875 \n\
876 ALIST can also be a function to do the completion itself.\n\
877 It receives three arguments: the values STRING, PREDICATE and nil.\n\
878 Whatever it returns becomes the value of `try-completion'.\n\
879 \n\
880 If optional third argument PREDICATE is non-nil,\n\
881 it is used to test each possible match.\n\
882 The match is a candidate only if PREDICATE returns non-nil.\n\
883 The argument given to PREDICATE is the alist element\n\
884 or the symbol from the obarray.")
885 (string, alist, predicate)
886 Lisp_Object string, alist, predicate;
887 {
888 Lisp_Object bestmatch, tail, elt, eltstring;
889 /* Size in bytes of BESTMATCH. */
890 int bestmatchsize;
891 /* These are in bytes, too. */
892 int compare, matchsize;
893 int list = CONSP (alist) || NILP (alist);
894 int index, obsize;
895 int matchcount = 0;
896 Lisp_Object bucket, zero, end, tem;
897 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
898
899 CHECK_STRING (string, 0);
900 if (!list && !VECTORP (alist))
901 return call3 (alist, string, predicate, Qnil);
902
903 bestmatch = Qnil;
904
905 /* If ALIST is not a list, set TAIL just for gc pro. */
906 tail = alist;
907 if (! list)
908 {
909 index = 0;
910 obsize = XVECTOR (alist)->size;
911 bucket = XVECTOR (alist)->contents[index];
912 }
913
914 while (1)
915 {
916 /* Get the next element of the alist or obarray. */
917 /* Exit the loop if the elements are all used up. */
918 /* elt gets the alist element or symbol.
919 eltstring gets the name to check as a completion. */
920
921 if (list)
922 {
923 if (NILP (tail))
924 break;
925 elt = Fcar (tail);
926 eltstring = Fcar (elt);
927 tail = Fcdr (tail);
928 }
929 else
930 {
931 if (XFASTINT (bucket) != 0)
932 {
933 elt = bucket;
934 eltstring = Fsymbol_name (elt);
935 if (XSYMBOL (bucket)->next)
936 XSETSYMBOL (bucket, XSYMBOL (bucket)->next);
937 else
938 XSETFASTINT (bucket, 0);
939 }
940 else if (++index >= obsize)
941 break;
942 else
943 {
944 bucket = XVECTOR (alist)->contents[index];
945 continue;
946 }
947 }
948
949 /* Is this element a possible completion? */
950
951 if (STRINGP (eltstring)
952 && XSTRING (string)->size_byte <= XSTRING (eltstring)->size_byte
953 && 0 > scmp (XSTRING (eltstring)->data, XSTRING (string)->data,
954 XSTRING (string)->size_byte))
955 {
956 /* Yes. */
957 Lisp_Object regexps;
958 Lisp_Object zero;
959 XSETFASTINT (zero, 0);
960
961 /* Ignore this element if it fails to match all the regexps. */
962 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
963 regexps = XCONS (regexps)->cdr)
964 {
965 tem = Fstring_match (XCONS (regexps)->car, eltstring, zero);
966 if (NILP (tem))
967 break;
968 }
969 if (CONSP (regexps))
970 continue;
971
972 /* Ignore this element if there is a predicate
973 and the predicate doesn't like it. */
974
975 if (!NILP (predicate))
976 {
977 if (EQ (predicate, Qcommandp))
978 tem = Fcommandp (elt);
979 else
980 {
981 GCPRO4 (tail, string, eltstring, bestmatch);
982 tem = call1 (predicate, elt);
983 UNGCPRO;
984 }
985 if (NILP (tem)) continue;
986 }
987
988 /* Update computation of how much all possible completions match */
989
990 matchcount++;
991 if (NILP (bestmatch))
992 {
993 bestmatch = eltstring;
994 bestmatchsize = XSTRING (eltstring)->size_byte;
995 }
996 else
997 {
998 compare = min (bestmatchsize, XSTRING (eltstring)->size_byte);
999 matchsize = scmp (XSTRING (bestmatch)->data,
1000 XSTRING (eltstring)->data,
1001 compare);
1002 if (matchsize < 0)
1003 matchsize = compare;
1004 if (completion_ignore_case)
1005 {
1006 /* If this is an exact match except for case,
1007 use it as the best match rather than one that is not an
1008 exact match. This way, we get the case pattern
1009 of the actual match. */
1010 if ((matchsize == XSTRING (eltstring)->size_byte
1011 && matchsize < XSTRING (bestmatch)->size_byte)
1012 ||
1013 /* If there is more than one exact match ignoring case,
1014 and one of them is exact including case,
1015 prefer that one. */
1016 /* If there is no exact match ignoring case,
1017 prefer a match that does not change the case
1018 of the input. */
1019 ((matchsize == XSTRING (eltstring)->size_byte)
1020 ==
1021 (matchsize == XSTRING (bestmatch)->size_byte)
1022 && !bcmp (XSTRING (eltstring)->data,
1023 XSTRING (string)->data,
1024 XSTRING (string)->size_byte)
1025 && bcmp (XSTRING (bestmatch)->data,
1026 XSTRING (string)->data,
1027 XSTRING (string)->size_byte)))
1028 bestmatch = eltstring;
1029 }
1030 bestmatchsize = matchsize;
1031 }
1032 }
1033 }
1034
1035 if (NILP (bestmatch))
1036 return Qnil; /* No completions found */
1037 /* If we are ignoring case, and there is no exact match,
1038 and no additional text was supplied,
1039 don't change the case of what the user typed. */
1040 if (completion_ignore_case && bestmatchsize == XSTRING (string)->size_byte
1041 && XSTRING (bestmatch)->size_byte > bestmatchsize)
1042 return string;
1043
1044 /* Return t if the supplied string is an exact match (counting case);
1045 it does not require any change to be made. */
1046 if (matchcount == 1 && bestmatchsize == XSTRING (string)->size_byte
1047 && !bcmp (XSTRING (bestmatch)->data, XSTRING (string)->data,
1048 bestmatchsize))
1049 return Qt;
1050
1051 bestmatchsize = string_byte_to_char (bestmatch, bestmatchsize);
1052
1053 XSETFASTINT (zero, 0); /* Else extract the part in which */
1054 XSETFASTINT (end, bestmatchsize); /* all completions agree */
1055 return Fsubstring (bestmatch, zero, end);
1056 }
1057
1058 /* Compare exactly LEN chars of strings at S1 and S2,
1059 ignoring case if appropriate.
1060 Return -1 if strings match,
1061 else number of chars that match at the beginning. */
1062
1063 int
1064 scmp (s1, s2, len)
1065 register unsigned char *s1, *s2;
1066 int len;
1067 {
1068 register int l = len;
1069 register unsigned char *start = s1;
1070
1071 if (completion_ignore_case)
1072 {
1073 while (l && DOWNCASE (*s1++) == DOWNCASE (*s2++))
1074 l--;
1075 }
1076 else
1077 {
1078 while (l && *s1++ == *s2++)
1079 l--;
1080 }
1081 if (l == 0)
1082 return -1;
1083 else
1084 {
1085 int match = len - l;
1086
1087 /* Now *--S1 is the unmatching byte. If it is in the middle of
1088 multi-byte form, we must say that the multi-byte character
1089 there doesn't match. */
1090 while (match && *--s1 >= 0xA0) match--;
1091 return match;
1092 }
1093 }
1094 \f
1095 DEFUN ("all-completions", Fall_completions, Sall_completions, 2, 4, 0,
1096 "Search for partial matches to STRING in ALIST.\n\
1097 Each car of each element of ALIST is tested to see if it begins with STRING.\n\
1098 The value is a list of all the strings from ALIST that match.\n\
1099 \n\
1100 ALIST can be an obarray instead of an alist.\n\
1101 Then the print names of all symbols in the obarray are the possible matches.\n\
1102 \n\
1103 ALIST can also be a function to do the completion itself.\n\
1104 It receives three arguments: the values STRING, PREDICATE and t.\n\
1105 Whatever it returns becomes the value of `all-completion'.\n\
1106 \n\
1107 If optional third argument PREDICATE is non-nil,\n\
1108 it is used to test each possible match.\n\
1109 The match is a candidate only if PREDICATE returns non-nil.\n\
1110 The argument given to PREDICATE is the alist element\n\
1111 or the symbol from the obarray.\n\
1112 \n\
1113 If the optional fourth argument HIDE-SPACES is non-nil,\n\
1114 strings in ALIST that start with a space\n\
1115 are ignored unless STRING itself starts with a space.")
1116 (string, alist, predicate, hide_spaces)
1117 Lisp_Object string, alist, predicate, hide_spaces;
1118 {
1119 Lisp_Object tail, elt, eltstring;
1120 Lisp_Object allmatches;
1121 int list = CONSP (alist) || NILP (alist);
1122 int index, obsize;
1123 Lisp_Object bucket, tem;
1124 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1125
1126 CHECK_STRING (string, 0);
1127 if (!list && !VECTORP (alist))
1128 {
1129 return call3 (alist, string, predicate, Qt);
1130 }
1131 allmatches = Qnil;
1132
1133 /* If ALIST is not a list, set TAIL just for gc pro. */
1134 tail = alist;
1135 if (! list)
1136 {
1137 index = 0;
1138 obsize = XVECTOR (alist)->size;
1139 bucket = XVECTOR (alist)->contents[index];
1140 }
1141
1142 while (1)
1143 {
1144 /* Get the next element of the alist or obarray. */
1145 /* Exit the loop if the elements are all used up. */
1146 /* elt gets the alist element or symbol.
1147 eltstring gets the name to check as a completion. */
1148
1149 if (list)
1150 {
1151 if (NILP (tail))
1152 break;
1153 elt = Fcar (tail);
1154 eltstring = Fcar (elt);
1155 tail = Fcdr (tail);
1156 }
1157 else
1158 {
1159 if (XFASTINT (bucket) != 0)
1160 {
1161 elt = bucket;
1162 eltstring = Fsymbol_name (elt);
1163 if (XSYMBOL (bucket)->next)
1164 XSETSYMBOL (bucket, XSYMBOL (bucket)->next);
1165 else
1166 XSETFASTINT (bucket, 0);
1167 }
1168 else if (++index >= obsize)
1169 break;
1170 else
1171 {
1172 bucket = XVECTOR (alist)->contents[index];
1173 continue;
1174 }
1175 }
1176
1177 /* Is this element a possible completion? */
1178
1179 if (STRINGP (eltstring)
1180 && XSTRING (string)->size_byte <= XSTRING (eltstring)->size_byte
1181 /* If HIDE_SPACES, reject alternatives that start with space
1182 unless the input starts with space. */
1183 && ((XSTRING (string)->size_byte > 0
1184 && XSTRING (string)->data[0] == ' ')
1185 || XSTRING (eltstring)->data[0] != ' '
1186 || NILP (hide_spaces))
1187 && 0 > scmp (XSTRING (eltstring)->data, XSTRING (string)->data,
1188 XSTRING (string)->size_byte))
1189 {
1190 /* Yes. */
1191 Lisp_Object regexps;
1192 Lisp_Object zero;
1193 XSETFASTINT (zero, 0);
1194
1195 /* Ignore this element if it fails to match all the regexps. */
1196 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1197 regexps = XCONS (regexps)->cdr)
1198 {
1199 tem = Fstring_match (XCONS (regexps)->car, eltstring, zero);
1200 if (NILP (tem))
1201 break;
1202 }
1203 if (CONSP (regexps))
1204 continue;
1205
1206 /* Ignore this element if there is a predicate
1207 and the predicate doesn't like it. */
1208
1209 if (!NILP (predicate))
1210 {
1211 if (EQ (predicate, Qcommandp))
1212 tem = Fcommandp (elt);
1213 else
1214 {
1215 GCPRO4 (tail, eltstring, allmatches, string);
1216 tem = call1 (predicate, elt);
1217 UNGCPRO;
1218 }
1219 if (NILP (tem)) continue;
1220 }
1221 /* Ok => put it on the list. */
1222 allmatches = Fcons (eltstring, allmatches);
1223 }
1224 }
1225
1226 return Fnreverse (allmatches);
1227 }
1228 \f
1229 Lisp_Object Vminibuffer_completion_table, Qminibuffer_completion_table;
1230 Lisp_Object Vminibuffer_completion_predicate, Qminibuffer_completion_predicate;
1231 Lisp_Object Vminibuffer_completion_confirm, Qminibuffer_completion_confirm;
1232
1233 /* This comment supplies the doc string for completing-read,
1234 for make-docfile to see. We cannot put this in the real DEFUN
1235 due to limits in the Unix cpp.
1236
1237 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 8, 0,
1238 "Read a string in the minibuffer, with completion.\n\
1239 PROMPT is a string to prompt with; normally it ends in a colon and a space.\n\
1240 TABLE is an alist whose elements' cars are strings, or an obarray.\n\
1241 PREDICATE limits completion to a subset of TABLE.\n\
1242 See `try-completion' and `all-completions' for more details
1243 on completion, TABLE, and PREDICATE.\n\
1244 \n\
1245 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless\n\
1246 the input is (or completes to) an element of TABLE or is null.\n\
1247 If it is also not t, Return does not exit if it does non-null completion.\n\
1248 If the input is null, `completing-read' returns an empty string,\n\
1249 regardless of the value of REQUIRE-MATCH.\n\
1250 \n\
1251 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially.\n\
1252 If it is (STRING . POSITION), the initial input\n\
1253 is STRING, but point is placed POSITION characters into the string.\n\
1254 HIST, if non-nil, specifies a history list\n\
1255 and optionally the initial position in the list.\n\
1256 It can be a symbol, which is the history list variable to use,\n\
1257 or it can be a cons cell (HISTVAR . HISTPOS).\n\
1258 In that case, HISTVAR is the history list variable to use,\n\
1259 and HISTPOS is the initial position (the position in the list\n\
1260 which INITIAL-INPUT corresponds to).\n\
1261 Positions are counted starting from 1 at the beginning of the list.\n\
1262 DEF, if non-nil, is the default value.\n\
1263 \n\
1264 If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits\n\
1265 the current input method and the setting of enable-multibyte-characters.\n\
1266 \n\
1267 Completion ignores case if the ambient value of\n\
1268 `completion-ignore-case' is non-nil."
1269 */
1270 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 8, 0,
1271 0 /* See immediately above */)
1272 (prompt, table, predicate, require_match, init, hist, def, inherit_input_method)
1273 Lisp_Object prompt, table, predicate, require_match, init, hist, def;
1274 Lisp_Object inherit_input_method;
1275 {
1276 Lisp_Object val, histvar, histpos, position;
1277 int pos = 0;
1278 int count = specpdl_ptr - specpdl;
1279 struct gcpro gcpro1;
1280 int disable_multibyte = EQ (table, Qread_file_name_internal);
1281
1282 GCPRO1 (def);
1283
1284 specbind (Qminibuffer_completion_table, table);
1285 specbind (Qminibuffer_completion_predicate, predicate);
1286 specbind (Qminibuffer_completion_confirm,
1287 EQ (require_match, Qt) ? Qnil : Qt);
1288 last_exact_completion = Qnil;
1289
1290 position = Qnil;
1291 if (!NILP (init))
1292 {
1293 if (CONSP (init))
1294 {
1295 position = Fcdr (init);
1296 init = Fcar (init);
1297 }
1298 CHECK_STRING (init, 0);
1299 if (!NILP (position))
1300 {
1301 CHECK_NUMBER (position, 0);
1302 /* Convert to distance from end of input. */
1303 pos = XINT (position) - XSTRING (init)->size;
1304 }
1305 }
1306
1307 if (SYMBOLP (hist))
1308 {
1309 histvar = hist;
1310 histpos = Qnil;
1311 }
1312 else
1313 {
1314 histvar = Fcar_safe (hist);
1315 histpos = Fcdr_safe (hist);
1316 }
1317 if (NILP (histvar))
1318 histvar = Qminibuffer_history;
1319 if (NILP (histpos))
1320 XSETFASTINT (histpos, 0);
1321
1322 val = read_minibuf (NILP (require_match)
1323 ? Vminibuffer_local_completion_map
1324 : Vminibuffer_local_must_match_map,
1325 init, prompt, make_number (pos), 0,
1326 histvar, histpos, def, 0,
1327 !NILP (inherit_input_method));
1328 RETURN_UNGCPRO (unbind_to (count, val));
1329 }
1330 \f
1331 Lisp_Object Fminibuffer_completion_help ();
1332 Lisp_Object assoc_for_completion ();
1333
1334 /* Test whether TXT is an exact completion. */
1335 Lisp_Object
1336 test_completion (txt)
1337 Lisp_Object txt;
1338 {
1339 Lisp_Object tem;
1340
1341 if (CONSP (Vminibuffer_completion_table)
1342 || NILP (Vminibuffer_completion_table))
1343 return assoc_for_completion (txt, Vminibuffer_completion_table);
1344 else if (VECTORP (Vminibuffer_completion_table))
1345 {
1346 /* Bypass intern-soft as that loses for nil */
1347 tem = oblookup (Vminibuffer_completion_table,
1348 XSTRING (txt)->data,
1349 XSTRING (txt)->size,
1350 XSTRING (txt)->size_byte);
1351 if (!SYMBOLP (tem))
1352 return Qnil;
1353 else if (!NILP (Vminibuffer_completion_predicate))
1354 return call1 (Vminibuffer_completion_predicate, tem);
1355 else
1356 return Qt;
1357 }
1358 else
1359 return call3 (Vminibuffer_completion_table, txt,
1360 Vminibuffer_completion_predicate, Qlambda);
1361 }
1362
1363 /* returns:
1364 * 0 no possible completion
1365 * 1 was already an exact and unique completion
1366 * 3 was already an exact completion
1367 * 4 completed to an exact completion
1368 * 5 some completion happened
1369 * 6 no completion happened
1370 */
1371 int
1372 do_completion ()
1373 {
1374 Lisp_Object completion, tem;
1375 int completedp;
1376 Lisp_Object last;
1377 struct gcpro gcpro1, gcpro2;
1378
1379 completion = Ftry_completion (Fbuffer_string (), Vminibuffer_completion_table,
1380 Vminibuffer_completion_predicate);
1381 last = last_exact_completion;
1382 last_exact_completion = Qnil;
1383
1384 GCPRO2 (completion, last);
1385
1386 if (NILP (completion))
1387 {
1388 bitch_at_user ();
1389 temp_echo_area_glyphs (" [No match]");
1390 UNGCPRO;
1391 return 0;
1392 }
1393
1394 if (EQ (completion, Qt)) /* exact and unique match */
1395 {
1396 UNGCPRO;
1397 return 1;
1398 }
1399
1400 /* compiler bug */
1401 tem = Fstring_equal (completion, Fbuffer_string());
1402 if (completedp = NILP (tem))
1403 {
1404 Ferase_buffer (); /* Some completion happened */
1405 Finsert (1, &completion);
1406 }
1407
1408 /* It did find a match. Do we match some possibility exactly now? */
1409 tem = test_completion (Fbuffer_string ());
1410 if (NILP (tem))
1411 {
1412 /* not an exact match */
1413 UNGCPRO;
1414 if (completedp)
1415 return 5;
1416 else if (auto_help)
1417 Fminibuffer_completion_help ();
1418 else
1419 temp_echo_area_glyphs (" [Next char not unique]");
1420 return 6;
1421 }
1422 else if (completedp)
1423 {
1424 UNGCPRO;
1425 return 4;
1426 }
1427 /* If the last exact completion and this one were the same,
1428 it means we've already given a "Complete but not unique"
1429 message and the user's hit TAB again, so now we give him help. */
1430 last_exact_completion = completion;
1431 if (!NILP (last))
1432 {
1433 tem = Fbuffer_string ();
1434 if (!NILP (Fequal (tem, last)))
1435 Fminibuffer_completion_help ();
1436 }
1437 UNGCPRO;
1438 return 3;
1439 }
1440
1441 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */
1442
1443 Lisp_Object
1444 assoc_for_completion (key, list)
1445 register Lisp_Object key;
1446 Lisp_Object list;
1447 {
1448 register Lisp_Object tail;
1449
1450 if (completion_ignore_case)
1451 key = Fupcase (key);
1452
1453 for (tail = list; !NILP (tail); tail = Fcdr (tail))
1454 {
1455 register Lisp_Object elt, tem, thiscar;
1456 elt = Fcar (tail);
1457 if (!CONSP (elt)) continue;
1458 thiscar = Fcar (elt);
1459 if (!STRINGP (thiscar))
1460 continue;
1461 if (completion_ignore_case)
1462 thiscar = Fupcase (thiscar);
1463 tem = Fequal (thiscar, key);
1464 if (!NILP (tem)) return elt;
1465 QUIT;
1466 }
1467 return Qnil;
1468 }
1469
1470 DEFUN ("minibuffer-complete", Fminibuffer_complete, Sminibuffer_complete, 0, 0, "",
1471 "Complete the minibuffer contents as far as possible.\n\
1472 Return nil if there is no valid completion, else t.\n\
1473 If no characters can be completed, display a list of possible completions.\n\
1474 If you repeat this command after it displayed such a list,\n\
1475 scroll the window of possible completions.")
1476 ()
1477 {
1478 register int i;
1479 Lisp_Object window, tem;
1480
1481 /* If the previous command was not this, then mark the completion
1482 buffer obsolete. */
1483 if (! EQ (current_kboard->Vlast_command, this_command))
1484 Vminibuf_scroll_window = Qnil;
1485
1486 window = Vminibuf_scroll_window;
1487 /* If there's a fresh completion window with a live buffer,
1488 and this command is repeated, scroll that window. */
1489 if (! NILP (window) && ! NILP (XWINDOW (window)->buffer)
1490 && !NILP (XBUFFER (XWINDOW (window)->buffer)->name))
1491 {
1492 struct buffer *obuf = current_buffer;
1493
1494 Fset_buffer (XWINDOW (window)->buffer);
1495 tem = Fpos_visible_in_window_p (make_number (ZV), window);
1496 if (! NILP (tem))
1497 /* If end is in view, scroll up to the beginning. */
1498 Fset_window_start (window, make_number (BEGV), Qnil);
1499 else
1500 /* Else scroll down one screen. */
1501 Fscroll_other_window (Qnil);
1502
1503 set_buffer_internal (obuf);
1504 return Qnil;
1505 }
1506
1507 i = do_completion ();
1508 switch (i)
1509 {
1510 case 0:
1511 return Qnil;
1512
1513 case 1:
1514 temp_echo_area_glyphs (" [Sole completion]");
1515 break;
1516
1517 case 3:
1518 temp_echo_area_glyphs (" [Complete, but not unique]");
1519 break;
1520 }
1521
1522 return Qt;
1523 }
1524 \f
1525 /* Subroutines of Fminibuffer_complete_and_exit. */
1526
1527 /* This one is called by internal_condition_case to do the real work. */
1528
1529 Lisp_Object
1530 complete_and_exit_1 ()
1531 {
1532 return make_number (do_completion ());
1533 }
1534
1535 /* This one is called by internal_condition_case if an error happens.
1536 Pretend the current value is an exact match. */
1537
1538 Lisp_Object
1539 complete_and_exit_2 (ignore)
1540 Lisp_Object ignore;
1541 {
1542 return make_number (1);
1543 }
1544
1545 DEFUN ("minibuffer-complete-and-exit", Fminibuffer_complete_and_exit,
1546 Sminibuffer_complete_and_exit, 0, 0, "",
1547 "If the minibuffer contents is a valid completion then exit.\n\
1548 Otherwise try to complete it. If completion leads to a valid completion,\n\
1549 a repetition of this command will exit.")
1550 ()
1551 {
1552 register int i;
1553 Lisp_Object val;
1554
1555 /* Allow user to specify null string */
1556 if (BEGV == ZV)
1557 goto exit;
1558
1559 if (!NILP (test_completion (Fbuffer_string ())))
1560 goto exit;
1561
1562 /* Call do_completion, but ignore errors. */
1563 val = internal_condition_case (complete_and_exit_1, Qerror,
1564 complete_and_exit_2);
1565
1566 i = XFASTINT (val);
1567 switch (i)
1568 {
1569 case 1:
1570 case 3:
1571 goto exit;
1572
1573 case 4:
1574 if (!NILP (Vminibuffer_completion_confirm))
1575 {
1576 temp_echo_area_glyphs (" [Confirm]");
1577 return Qnil;
1578 }
1579 else
1580 goto exit;
1581
1582 default:
1583 return Qnil;
1584 }
1585 exit:
1586 Fthrow (Qexit, Qnil);
1587 /* NOTREACHED */
1588 }
1589
1590 DEFUN ("minibuffer-complete-word", Fminibuffer_complete_word, Sminibuffer_complete_word,
1591 0, 0, "",
1592 "Complete the minibuffer contents at most a single word.\n\
1593 After one word is completed as much as possible, a space or hyphen\n\
1594 is added, provided that matches some possible completion.\n\
1595 Return nil if there is no valid completion, else t.")
1596 ()
1597 {
1598 Lisp_Object completion, tem;
1599 register int i, i_byte;
1600 register unsigned char *completion_string;
1601 struct gcpro gcpro1, gcpro2;
1602
1603 /* We keep calling Fbuffer_string rather than arrange for GC to
1604 hold onto a pointer to one of the strings thus made. */
1605
1606 completion = Ftry_completion (Fbuffer_string (),
1607 Vminibuffer_completion_table,
1608 Vminibuffer_completion_predicate);
1609 if (NILP (completion))
1610 {
1611 bitch_at_user ();
1612 temp_echo_area_glyphs (" [No match]");
1613 return Qnil;
1614 }
1615 if (EQ (completion, Qt))
1616 return Qnil;
1617
1618 #if 0 /* How the below code used to look, for reference. */
1619 tem = Fbuffer_string ();
1620 b = XSTRING (tem)->data;
1621 i = ZV - 1 - XSTRING (completion)->size;
1622 p = XSTRING (completion)->data;
1623 if (i > 0 ||
1624 0 <= scmp (b, p, ZV - 1))
1625 {
1626 i = 1;
1627 /* Set buffer to longest match of buffer tail and completion head. */
1628 while (0 <= scmp (b + i, p, ZV - 1 - i))
1629 i++;
1630 del_range (1, i + 1);
1631 SET_PT (ZV);
1632 }
1633 #else /* Rewritten code */
1634 {
1635 register unsigned char *buffer_string;
1636 int buffer_nbytes, completion_nbytes;
1637
1638 CHECK_STRING (completion, 0);
1639 tem = Fbuffer_string ();
1640 GCPRO2 (completion, tem);
1641 /* If reading a file name,
1642 expand any $ENVVAR refs in the buffer and in TEM. */
1643 if (EQ (Vminibuffer_completion_table, Qread_file_name_internal))
1644 {
1645 Lisp_Object substituted;
1646 substituted = Fsubstitute_in_file_name (tem);
1647 if (! EQ (substituted, tem))
1648 {
1649 tem = substituted;
1650 Ferase_buffer ();
1651 insert_from_string (tem, 0, 0, XSTRING (tem)->size,
1652 XSTRING (tem)->size_byte, 0);
1653 }
1654 }
1655 buffer_string = XSTRING (tem)->data;
1656 completion_string = XSTRING (completion)->data;
1657 buffer_nbytes = XSTRING (tem)->size_byte; /* ie ZV_BYTE - BEGV_BYTE */
1658 completion_nbytes = XSTRING (completion)->size_byte;
1659 i_byte = buffer_nbytes - completion_nbytes;
1660 if (i_byte > 0 ||
1661 0 <= scmp (buffer_string, completion_string, buffer_nbytes))
1662 {
1663 /* Set buffer to longest match of buffer tail and completion head. */
1664 if (i_byte <= 0) i_byte = 1;
1665 buffer_string += i_byte;
1666 buffer_nbytes -= i_byte;
1667 while (0 <= scmp (buffer_string++, completion_string, buffer_nbytes--))
1668 i_byte++;
1669 del_range_byte (1, i_byte + 1, 1);
1670 SET_PT_BOTH (ZV, ZV_BYTE);
1671 }
1672 UNGCPRO;
1673 }
1674 #endif /* Rewritten code */
1675 i_byte = ZV_BYTE - BEGV_BYTE;
1676 i = ZV - BEGV;
1677
1678 /* If completion finds next char not unique,
1679 consider adding a space or a hyphen. */
1680 if (i == XSTRING (completion)->size)
1681 {
1682 GCPRO1 (completion);
1683 tem = Ftry_completion (concat2 (Fbuffer_string (), build_string (" ")),
1684 Vminibuffer_completion_table,
1685 Vminibuffer_completion_predicate);
1686 UNGCPRO;
1687
1688 if (STRINGP (tem))
1689 completion = tem;
1690 else
1691 {
1692 GCPRO1 (completion);
1693 tem =
1694 Ftry_completion (concat2 (Fbuffer_string (), build_string ("-")),
1695 Vminibuffer_completion_table,
1696 Vminibuffer_completion_predicate);
1697 UNGCPRO;
1698
1699 if (STRINGP (tem))
1700 completion = tem;
1701 }
1702 }
1703
1704 /* Now find first word-break in the stuff found by completion.
1705 i gets index in string of where to stop completing. */
1706 {
1707 int len, c;
1708
1709 completion_string = XSTRING (completion)->data;
1710 for (; i_byte < XSTRING (completion)->size_byte; i_byte += len, i++)
1711 {
1712 c = STRING_CHAR_AND_LENGTH (completion_string + i_byte,
1713 XSTRING (completion)->size - i_byte,
1714 len);
1715 if (SYNTAX (c) != Sword)
1716 {
1717 i_byte += len;
1718 i++;
1719 break;
1720 }
1721 }
1722 }
1723
1724 /* If got no characters, print help for user. */
1725
1726 if (i_byte == ZV_BYTE - BEGV_BYTE)
1727 {
1728 if (auto_help)
1729 Fminibuffer_completion_help ();
1730 return Qnil;
1731 }
1732
1733 /* Otherwise insert in minibuffer the chars we got */
1734
1735 Ferase_buffer ();
1736 insert_from_string (completion, 0, 0, i, i_byte, 1);
1737 return Qt;
1738 }
1739 \f
1740 DEFUN ("display-completion-list", Fdisplay_completion_list, Sdisplay_completion_list,
1741 1, 1, 0,
1742 "Display the list of completions, COMPLETIONS, using `standard-output'.\n\
1743 Each element may be just a symbol or string\n\
1744 or may be a list of two strings to be printed as if concatenated.\n\
1745 `standard-output' must be a buffer.\n\
1746 At the end, run the normal hook `completion-setup-hook'.\n\
1747 It can find the completion buffer in `standard-output'.")
1748 (completions)
1749 Lisp_Object completions;
1750 {
1751 Lisp_Object tail, elt;
1752 register int i;
1753 int column = 0;
1754 struct gcpro gcpro1, gcpro2;
1755 struct buffer *old = current_buffer;
1756 int first = 1;
1757
1758 /* Note that (when it matters) every variable
1759 points to a non-string that is pointed to by COMPLETIONS,
1760 except for ELT. ELT can be pointing to a string
1761 when terpri or Findent_to calls a change hook. */
1762 elt = Qnil;
1763 GCPRO2 (completions, elt);
1764
1765 if (BUFFERP (Vstandard_output))
1766 set_buffer_internal (XBUFFER (Vstandard_output));
1767
1768 if (NILP (completions))
1769 write_string ("There are no possible completions of what you have typed.",
1770 -1);
1771 else
1772 {
1773 write_string ("Possible completions are:", -1);
1774 for (tail = completions, i = 0; !NILP (tail); tail = Fcdr (tail), i++)
1775 {
1776 Lisp_Object tem;
1777 int length;
1778 Lisp_Object startpos, endpos;
1779
1780 elt = Fcar (tail);
1781 /* Compute the length of this element. */
1782 if (CONSP (elt))
1783 {
1784 tem = XCAR (elt);
1785 CHECK_STRING (tem, 0);
1786 length = XSTRING (tem)->size;
1787
1788 tem = Fcar (XCDR (elt));
1789 CHECK_STRING (tem, 0);
1790 length += XSTRING (tem)->size;
1791 }
1792 else
1793 {
1794 CHECK_STRING (elt, 0);
1795 length = XSTRING (elt)->size;
1796 }
1797
1798 /* This does a bad job for narrower than usual windows.
1799 Sadly, the window it will appear in is not known
1800 until after the text has been made. */
1801
1802 if (BUFFERP (Vstandard_output))
1803 XSETINT (startpos, BUF_PT (XBUFFER (Vstandard_output)));
1804
1805 /* If the previous completion was very wide,
1806 or we have two on this line already,
1807 don't put another on the same line. */
1808 if (column > 33 || first
1809 /* If this is really wide, don't put it second on a line. */
1810 || column > 0 && length > 45)
1811 {
1812 Fterpri (Qnil);
1813 column = 0;
1814 }
1815 /* Otherwise advance to column 35. */
1816 else
1817 {
1818 if (BUFFERP (Vstandard_output))
1819 {
1820 tem = Findent_to (make_number (35), make_number (2));
1821
1822 column = XINT (tem);
1823 }
1824 else
1825 {
1826 do
1827 {
1828 write_string (" ", -1);
1829 column++;
1830 }
1831 while (column < 35);
1832 }
1833 }
1834
1835 if (BUFFERP (Vstandard_output))
1836 {
1837 XSETINT (endpos, BUF_PT (XBUFFER (Vstandard_output)));
1838 Fset_text_properties (startpos, endpos,
1839 Qnil, Vstandard_output);
1840 }
1841
1842 /* Output this element and update COLUMN. */
1843 if (CONSP (elt))
1844 {
1845 Fprinc (Fcar (elt), Qnil);
1846 Fprinc (Fcar (Fcdr (elt)), Qnil);
1847 }
1848 else
1849 Fprinc (elt, Qnil);
1850
1851 column += length;
1852
1853 /* If output is to a buffer, recompute COLUMN in a way
1854 that takes account of character widths. */
1855 if (BUFFERP (Vstandard_output))
1856 {
1857 tem = Fcurrent_column ();
1858 column = XINT (tem);
1859 }
1860
1861 first = 0;
1862 }
1863 }
1864
1865 UNGCPRO;
1866
1867 if (BUFFERP (Vstandard_output))
1868 set_buffer_internal (old);
1869
1870 if (!NILP (Vrun_hooks))
1871 call1 (Vrun_hooks, intern ("completion-setup-hook"));
1872
1873 return Qnil;
1874 }
1875
1876 DEFUN ("minibuffer-completion-help", Fminibuffer_completion_help, Sminibuffer_completion_help,
1877 0, 0, "",
1878 "Display a list of possible completions of the current minibuffer contents.")
1879 ()
1880 {
1881 Lisp_Object completions;
1882
1883 message ("Making completion list...");
1884 completions = Fall_completions (Fbuffer_string (),
1885 Vminibuffer_completion_table,
1886 Vminibuffer_completion_predicate,
1887 Qt);
1888 echo_area_glyphs = 0;
1889
1890 if (NILP (completions))
1891 {
1892 bitch_at_user ();
1893 temp_echo_area_glyphs (" [No completions]");
1894 }
1895 else
1896 internal_with_output_to_temp_buffer ("*Completions*",
1897 Fdisplay_completion_list,
1898 Fsort (completions, Qstring_lessp));
1899 return Qnil;
1900 }
1901 \f
1902 DEFUN ("self-insert-and-exit", Fself_insert_and_exit, Sself_insert_and_exit, 0, 0, "",
1903 "Terminate minibuffer input.")
1904 ()
1905 {
1906 if (INTEGERP (last_command_char))
1907 internal_self_insert (last_command_char, 0);
1908 else
1909 bitch_at_user ();
1910
1911 Fthrow (Qexit, Qnil);
1912 }
1913
1914 DEFUN ("exit-minibuffer", Fexit_minibuffer, Sexit_minibuffer, 0, 0, "",
1915 "Terminate this minibuffer argument.")
1916 ()
1917 {
1918 Fthrow (Qexit, Qnil);
1919 }
1920
1921 DEFUN ("minibuffer-depth", Fminibuffer_depth, Sminibuffer_depth, 0, 0, 0,
1922 "Return current depth of activations of minibuffer, a nonnegative integer.")
1923 ()
1924 {
1925 return make_number (minibuf_level);
1926 }
1927
1928 DEFUN ("minibuffer-prompt", Fminibuffer_prompt, Sminibuffer_prompt, 0, 0, 0,
1929 "Return the prompt string of the currently-active minibuffer.\n\
1930 If no minibuffer is active, return nil.")
1931 ()
1932 {
1933 return Fcopy_sequence (minibuf_prompt);
1934 }
1935
1936 DEFUN ("minibuffer-prompt-width", Fminibuffer_prompt_width,
1937 Sminibuffer_prompt_width, 0, 0, 0,
1938 "Return the display width of the minibuffer prompt.")
1939 ()
1940 {
1941 Lisp_Object width;
1942 XSETFASTINT (width, minibuf_prompt_width);
1943 return width;
1944 }
1945 \f
1946 /* Temporarily display the string M at the end of the current
1947 minibuffer contents. This is used to display things like
1948 "[No Match]" when the user requests a completion for a prefix
1949 that has no possible completions, and other quick, unobtrusive
1950 messages. */
1951
1952 void
1953 temp_echo_area_glyphs (m)
1954 char *m;
1955 {
1956 int osize = ZV;
1957 int osize_byte = ZV_BYTE;
1958 int opoint = PT;
1959 int opoint_byte = PT_BYTE;
1960 Lisp_Object oinhibit;
1961 oinhibit = Vinhibit_quit;
1962
1963 /* Clear out any old echo-area message to make way for our new thing. */
1964 message (0);
1965
1966 SET_PT_BOTH (osize, osize_byte);
1967 insert_string (m);
1968 SET_PT_BOTH (opoint, opoint_byte);
1969 Vinhibit_quit = Qt;
1970 Fsit_for (make_number (2), Qnil, Qnil);
1971 del_range_both (osize, ZV, osize_byte, ZV_BYTE, 1);
1972 SET_PT_BOTH (opoint, opoint_byte);
1973 if (!NILP (Vquit_flag))
1974 {
1975 Vquit_flag = Qnil;
1976 Vunread_command_events = Fcons (make_number (quit_char), Qnil);
1977 }
1978 Vinhibit_quit = oinhibit;
1979 }
1980
1981 DEFUN ("minibuffer-message", Fminibuffer_message, Sminibuffer_message,
1982 1, 1, 0,
1983 "Temporarily display STRING at the end of the minibuffer.\n\
1984 The text is displayed for two seconds,\n\
1985 or until the next input event arrives, whichever comes first.")
1986 (string)
1987 Lisp_Object string;
1988 {
1989 temp_echo_area_glyphs (XSTRING (string)->data);
1990 return Qnil;
1991 }
1992 \f
1993 void
1994 init_minibuf_once ()
1995 {
1996 Vminibuffer_list = Qnil;
1997 staticpro (&Vminibuffer_list);
1998 }
1999
2000 void
2001 syms_of_minibuf ()
2002 {
2003 minibuf_level = 0;
2004 minibuf_prompt = Qnil;
2005 staticpro (&minibuf_prompt);
2006
2007 minibuf_save_list = Qnil;
2008 staticpro (&minibuf_save_list);
2009
2010 Qread_file_name_internal = intern ("read-file-name-internal");
2011 staticpro (&Qread_file_name_internal);
2012
2013 Qminibuffer_default = intern ("minibuffer-default");
2014 staticpro (&Qminibuffer_default);
2015 Fset (Qminibuffer_default, Qnil);
2016
2017 Qminibuffer_completion_table = intern ("minibuffer-completion-table");
2018 staticpro (&Qminibuffer_completion_table);
2019
2020 Qminibuffer_completion_confirm = intern ("minibuffer-completion-confirm");
2021 staticpro (&Qminibuffer_completion_confirm);
2022
2023 Qminibuffer_completion_predicate = intern ("minibuffer-completion-predicate");
2024 staticpro (&Qminibuffer_completion_predicate);
2025
2026 staticpro (&last_exact_completion);
2027 last_exact_completion = Qnil;
2028
2029 staticpro (&last_minibuf_string);
2030 last_minibuf_string = Qnil;
2031
2032 Quser_variable_p = intern ("user-variable-p");
2033 staticpro (&Quser_variable_p);
2034
2035 Qminibuffer_history = intern ("minibuffer-history");
2036 staticpro (&Qminibuffer_history);
2037
2038 Qminibuffer_setup_hook = intern ("minibuffer-setup-hook");
2039 staticpro (&Qminibuffer_setup_hook);
2040
2041 Qminibuffer_exit_hook = intern ("minibuffer-exit-hook");
2042 staticpro (&Qminibuffer_exit_hook);
2043
2044 Qhistory_length = intern ("history-length");
2045 staticpro (&Qhistory_length);
2046
2047 Qcurrent_input_method = intern ("current-input-method");
2048 staticpro (&Qcurrent_input_method);
2049
2050 Qactivate_input_method = intern ("activate-input-method");
2051 staticpro (&Qactivate_input_method);
2052
2053 DEFVAR_LISP ("read-buffer-function", &Vread_buffer_function,
2054 "If this is non-nil, `read-buffer' does its work by calling this function.");
2055 Vread_buffer_function = Qnil;
2056
2057 DEFVAR_LISP ("minibuffer-setup-hook", &Vminibuffer_setup_hook,
2058 "Normal hook run just after entry to minibuffer.");
2059 Vminibuffer_setup_hook = Qnil;
2060
2061 DEFVAR_LISP ("minibuffer-exit-hook", &Vminibuffer_exit_hook,
2062 "Normal hook run just after exit from minibuffer.");
2063 Vminibuffer_exit_hook = Qnil;
2064
2065 DEFVAR_LISP ("history-length", &Vhistory_length,
2066 "*Maximum length for history lists before truncation takes place.\n\
2067 A number means that length; t means infinite. Truncation takes place\n\
2068 just after a new element is inserted. Setting the history-length\n\
2069 property of a history variable overrides this default.");
2070 XSETFASTINT (Vhistory_length, 30);
2071
2072 DEFVAR_BOOL ("completion-auto-help", &auto_help,
2073 "*Non-nil means automatically provide help for invalid completion input.");
2074 auto_help = 1;
2075
2076 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case,
2077 "Non-nil means don't consider case significant in completion.");
2078 completion_ignore_case = 0;
2079
2080 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers,
2081 "*Non-nil means to allow minibuffer commands while in the minibuffer.\n\
2082 This variable makes a difference whenever the minibuffer window is active.");
2083 enable_recursive_minibuffers = 0;
2084
2085 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table,
2086 "Alist or obarray used for completion in the minibuffer.\n\
2087 This becomes the ALIST argument to `try-completion' and `all-completion'.\n\
2088 \n\
2089 The value may alternatively be a function, which is given three arguments:\n\
2090 STRING, the current buffer contents;\n\
2091 PREDICATE, the predicate for filtering possible matches;\n\
2092 CODE, which says what kind of things to do.\n\
2093 CODE can be nil, t or `lambda'.\n\
2094 nil means to return the best completion of STRING, or nil if there is none.\n\
2095 t means to return a list of all possible completions of STRING.\n\
2096 `lambda' means to return t if STRING is a valid completion as it stands.");
2097 Vminibuffer_completion_table = Qnil;
2098
2099 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate,
2100 "Within call to `completing-read', this holds the PREDICATE argument.");
2101 Vminibuffer_completion_predicate = Qnil;
2102
2103 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm,
2104 "Non-nil => demand confirmation of completion before exiting minibuffer.");
2105 Vminibuffer_completion_confirm = Qnil;
2106
2107 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form,
2108 "Value that `help-form' takes on inside the minibuffer.");
2109 Vminibuffer_help_form = Qnil;
2110
2111 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable,
2112 "History list symbol to add minibuffer values to.\n\
2113 Each string of minibuffer input, as it appears on exit from the minibuffer,\n\
2114 is added with\n\
2115 (set minibuffer-history-variable\n\
2116 (cons STRING (symbol-value minibuffer-history-variable)))");
2117 XSETFASTINT (Vminibuffer_history_variable, 0);
2118
2119 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position,
2120 "Current position of redoing in the history list.");
2121 Vminibuffer_history_position = Qnil;
2122
2123 DEFVAR_BOOL ("minibuffer-auto-raise", &minibuffer_auto_raise,
2124 "*Non-nil means entering the minibuffer raises the minibuffer's frame.\n\
2125 Some uses of the echo area also raise that frame (since they use it too).");
2126 minibuffer_auto_raise = 0;
2127
2128 DEFVAR_LISP ("completion-regexp-list", &Vcompletion_regexp_list,
2129 "List of regexps that should restrict possible completions.");
2130 Vcompletion_regexp_list = Qnil;
2131
2132 DEFVAR_BOOL ("minibuffer-allow-text-properties",
2133 &minibuffer_allow_text_properties,
2134 "Non-nil means `read-from-miniffer' should not discard text properties.\n\
2135 This also affects `read-string', but it does not affect `read-minibuffer',\n\
2136 `read-no-blanks-input', or any of the functions that do minibuffer input\n\
2137 with completion; they always discard text properties.");
2138 minibuffer_allow_text_properties = 0;
2139
2140 defsubr (&Sset_minibuffer_window);
2141 defsubr (&Sread_from_minibuffer);
2142 defsubr (&Seval_minibuffer);
2143 defsubr (&Sread_minibuffer);
2144 defsubr (&Sread_string);
2145 defsubr (&Sread_command);
2146 defsubr (&Sread_variable);
2147 defsubr (&Sread_buffer);
2148 defsubr (&Sread_no_blanks_input);
2149 defsubr (&Sminibuffer_depth);
2150 defsubr (&Sminibuffer_prompt);
2151 defsubr (&Sminibuffer_prompt_width);
2152
2153 defsubr (&Stry_completion);
2154 defsubr (&Sall_completions);
2155 defsubr (&Scompleting_read);
2156 defsubr (&Sminibuffer_complete);
2157 defsubr (&Sminibuffer_complete_word);
2158 defsubr (&Sminibuffer_complete_and_exit);
2159 defsubr (&Sdisplay_completion_list);
2160 defsubr (&Sminibuffer_completion_help);
2161
2162 defsubr (&Sself_insert_and_exit);
2163 defsubr (&Sexit_minibuffer);
2164
2165 defsubr (&Sminibuffer_message);
2166 }
2167
2168 void
2169 keys_of_minibuf ()
2170 {
2171 initial_define_key (Vminibuffer_local_map, Ctl ('g'),
2172 "abort-recursive-edit");
2173 initial_define_key (Vminibuffer_local_map, Ctl ('m'),
2174 "exit-minibuffer");
2175 initial_define_key (Vminibuffer_local_map, Ctl ('j'),
2176 "exit-minibuffer");
2177
2178 initial_define_key (Vminibuffer_local_ns_map, Ctl ('g'),
2179 "abort-recursive-edit");
2180 initial_define_key (Vminibuffer_local_ns_map, Ctl ('m'),
2181 "exit-minibuffer");
2182 initial_define_key (Vminibuffer_local_ns_map, Ctl ('j'),
2183 "exit-minibuffer");
2184
2185 initial_define_key (Vminibuffer_local_ns_map, ' ',
2186 "exit-minibuffer");
2187 initial_define_key (Vminibuffer_local_ns_map, '\t',
2188 "exit-minibuffer");
2189 initial_define_key (Vminibuffer_local_ns_map, '?',
2190 "self-insert-and-exit");
2191
2192 initial_define_key (Vminibuffer_local_completion_map, Ctl ('g'),
2193 "abort-recursive-edit");
2194 initial_define_key (Vminibuffer_local_completion_map, Ctl ('m'),
2195 "exit-minibuffer");
2196 initial_define_key (Vminibuffer_local_completion_map, Ctl ('j'),
2197 "exit-minibuffer");
2198
2199 initial_define_key (Vminibuffer_local_completion_map, '\t',
2200 "minibuffer-complete");
2201 initial_define_key (Vminibuffer_local_completion_map, ' ',
2202 "minibuffer-complete-word");
2203 initial_define_key (Vminibuffer_local_completion_map, '?',
2204 "minibuffer-completion-help");
2205
2206 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('g'),
2207 "abort-recursive-edit");
2208 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('m'),
2209 "minibuffer-complete-and-exit");
2210 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('j'),
2211 "minibuffer-complete-and-exit");
2212 initial_define_key (Vminibuffer_local_must_match_map, '\t',
2213 "minibuffer-complete");
2214 initial_define_key (Vminibuffer_local_must_match_map, ' ',
2215 "minibuffer-complete-word");
2216 initial_define_key (Vminibuffer_local_must_match_map, '?',
2217 "minibuffer-completion-help");
2218 }