(mouse-drag-region-1): When remapping mouse-1 to mouse-2, go back to
[bpt/emacs.git] / src / minibuf.c
1 /* Minibuffer input and completion.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005 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., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
21
22
23 #include <config.h>
24 #include <stdio.h>
25
26 #include "lisp.h"
27 #include "commands.h"
28 #include "buffer.h"
29 #include "charset.h"
30 #include "dispextern.h"
31 #include "keyboard.h"
32 #include "frame.h"
33 #include "window.h"
34 #include "syntax.h"
35 #include "intervals.h"
36 #include "keymap.h"
37
38 extern int quit_char;
39
40 /* List of buffers for use as minibuffers.
41 The first element of the list is used for the outermost minibuffer
42 invocation, the next element is used for a recursive minibuffer
43 invocation, etc. The list is extended at the end as deeper
44 minibuffer recursions are encountered. */
45
46 Lisp_Object Vminibuffer_list;
47
48 /* Data to remember during recursive minibuffer invocations */
49
50 Lisp_Object minibuf_save_list;
51
52 /* Depth in minibuffer invocations. */
53
54 int minibuf_level;
55
56 /* Nonzero means display completion help for invalid input. */
57
58 Lisp_Object Vcompletion_auto_help;
59
60 /* The maximum length of a minibuffer history. */
61
62 Lisp_Object Qhistory_length, Vhistory_length;
63
64 /* No duplicates in history. */
65
66 int history_delete_duplicates;
67
68 /* Fread_minibuffer leaves the input here as a string. */
69
70 Lisp_Object last_minibuf_string;
71
72 /* Nonzero means let functions called when within a minibuffer
73 invoke recursive minibuffers (to read arguments, or whatever) */
74
75 int enable_recursive_minibuffers;
76
77 /* Nonzero means don't ignore text properties
78 in Fread_from_minibuffer. */
79
80 int minibuffer_allow_text_properties;
81
82 /* help-form is bound to this while in the minibuffer. */
83
84 Lisp_Object Vminibuffer_help_form;
85
86 /* Variable which is the history list to add minibuffer values to. */
87
88 Lisp_Object Vminibuffer_history_variable;
89
90 /* Current position in the history list (adjusted by M-n and M-p). */
91
92 Lisp_Object Vminibuffer_history_position;
93
94 /* Text properties that are added to minibuffer prompts.
95 These are in addition to the basic `field' property, and stickiness
96 properties. */
97
98 Lisp_Object Vminibuffer_prompt_properties;
99
100 Lisp_Object Qminibuffer_history, Qbuffer_name_history;
101
102 Lisp_Object Qread_file_name_internal;
103
104 /* Normal hooks for entry to and exit from minibuffer. */
105
106 Lisp_Object Qminibuffer_setup_hook, Vminibuffer_setup_hook;
107 Lisp_Object Qminibuffer_exit_hook, Vminibuffer_exit_hook;
108
109 /* Function to call to read a buffer name. */
110 Lisp_Object Vread_buffer_function;
111
112 /* Nonzero means completion ignores case. */
113
114 int completion_ignore_case;
115
116 /* List of regexps that should restrict possible completions. */
117
118 Lisp_Object Vcompletion_regexp_list;
119
120 /* Nonzero means raise the minibuffer frame when the minibuffer
121 is entered. */
122
123 int minibuffer_auto_raise;
124
125 /* If last completion attempt reported "Complete but not unique"
126 then this is the string completed then; otherwise this is nil. */
127
128 static Lisp_Object last_exact_completion;
129
130 extern Lisp_Object Voverriding_local_map;
131
132 Lisp_Object Quser_variable_p;
133
134 Lisp_Object Qminibuffer_default;
135
136 Lisp_Object Qcurrent_input_method, Qactivate_input_method;
137
138 Lisp_Object Qcase_fold_search;
139
140 extern Lisp_Object Qmouse_face;
141
142 extern Lisp_Object Qfield;
143 \f
144 /* Put minibuf on currently selected frame's minibuffer.
145 We do this whenever the user starts a new minibuffer
146 or when a minibuffer exits. */
147
148 void
149 choose_minibuf_frame ()
150 {
151 if (FRAMEP (selected_frame)
152 && FRAME_LIVE_P (XFRAME (selected_frame))
153 && !EQ (minibuf_window, XFRAME (selected_frame)->minibuffer_window))
154 {
155 struct frame *sf = XFRAME (selected_frame);
156 Lisp_Object buffer;
157
158 /* I don't think that any frames may validly have a null minibuffer
159 window anymore. */
160 if (NILP (sf->minibuffer_window))
161 abort ();
162
163 /* Under X, we come here with minibuf_window being the
164 minibuffer window of the unused termcap window created in
165 init_window_once. That window doesn't have a buffer. */
166 buffer = XWINDOW (minibuf_window)->buffer;
167 if (BUFFERP (buffer))
168 Fset_window_buffer (sf->minibuffer_window, buffer, Qnil);
169 minibuf_window = sf->minibuffer_window;
170 }
171
172 /* Make sure no other frame has a minibuffer as its selected window,
173 because the text would not be displayed in it, and that would be
174 confusing. Only allow the selected frame to do this,
175 and that only if the minibuffer is active. */
176 {
177 Lisp_Object tail, frame;
178
179 FOR_EACH_FRAME (tail, frame)
180 if (MINI_WINDOW_P (XWINDOW (FRAME_SELECTED_WINDOW (XFRAME (frame))))
181 && !(EQ (frame, selected_frame)
182 && minibuf_level > 0))
183 Fset_frame_selected_window (frame, Fframe_first_window (frame));
184 }
185 }
186
187 Lisp_Object
188 choose_minibuf_frame_1 (ignore)
189 Lisp_Object ignore;
190 {
191 choose_minibuf_frame ();
192 return Qnil;
193 }
194
195 DEFUN ("set-minibuffer-window", Fset_minibuffer_window,
196 Sset_minibuffer_window, 1, 1, 0,
197 doc: /* Specify which minibuffer window to use for the minibuffer.
198 This affects where the minibuffer is displayed if you put text in it
199 without invoking the usual minibuffer commands. */)
200 (window)
201 Lisp_Object window;
202 {
203 CHECK_WINDOW (window);
204 if (! MINI_WINDOW_P (XWINDOW (window)))
205 error ("Window is not a minibuffer window");
206
207 minibuf_window = window;
208
209 return window;
210 }
211
212 \f
213 /* Actual minibuffer invocation. */
214
215 static Lisp_Object read_minibuf_unwind P_ ((Lisp_Object));
216 static Lisp_Object run_exit_minibuf_hook P_ ((Lisp_Object));
217 static Lisp_Object read_minibuf P_ ((Lisp_Object, Lisp_Object,
218 Lisp_Object, Lisp_Object,
219 int, Lisp_Object,
220 Lisp_Object, Lisp_Object,
221 int, int, int));
222 static Lisp_Object read_minibuf_noninteractive P_ ((Lisp_Object, Lisp_Object,
223 Lisp_Object, Lisp_Object,
224 int, Lisp_Object,
225 Lisp_Object, Lisp_Object,
226 int, int));
227 static Lisp_Object string_to_object P_ ((Lisp_Object, Lisp_Object));
228
229
230 /* Read a Lisp object from VAL and return it. If VAL is an empty
231 string, and DEFALT is a string, read from DEFALT instead of VAL. */
232
233 static Lisp_Object
234 string_to_object (val, defalt)
235 Lisp_Object val, defalt;
236 {
237 struct gcpro gcpro1, gcpro2;
238 Lisp_Object expr_and_pos;
239 int pos;
240
241 GCPRO2 (val, defalt);
242
243 if (STRINGP (val) && SCHARS (val) == 0
244 && STRINGP (defalt))
245 val = defalt;
246
247 expr_and_pos = Fread_from_string (val, Qnil, Qnil);
248 pos = XINT (Fcdr (expr_and_pos));
249 if (pos != SCHARS (val))
250 {
251 /* Ignore trailing whitespace; any other trailing junk
252 is an error. */
253 int i;
254 pos = string_char_to_byte (val, pos);
255 for (i = pos; i < SBYTES (val); i++)
256 {
257 int c = SREF (val, i);
258 if (c != ' ' && c != '\t' && c != '\n')
259 error ("Trailing garbage following expression");
260 }
261 }
262
263 val = Fcar (expr_and_pos);
264 RETURN_UNGCPRO (val);
265 }
266
267
268 /* Like read_minibuf but reading from stdin. This function is called
269 from read_minibuf to do the job if noninteractive. */
270
271 static Lisp_Object
272 read_minibuf_noninteractive (map, initial, prompt, backup_n, expflag,
273 histvar, histpos, defalt, allow_props,
274 inherit_input_method)
275 Lisp_Object map;
276 Lisp_Object initial;
277 Lisp_Object prompt;
278 Lisp_Object backup_n;
279 int expflag;
280 Lisp_Object histvar;
281 Lisp_Object histpos;
282 Lisp_Object defalt;
283 int allow_props;
284 int inherit_input_method;
285 {
286 int size, len;
287 char *line, *s;
288 Lisp_Object val;
289
290 fprintf (stdout, "%s", SDATA (prompt));
291 fflush (stdout);
292
293 val = Qnil;
294 size = 100;
295 len = 0;
296 line = (char *) xmalloc (size * sizeof *line);
297 while ((s = fgets (line + len, size - len, stdin)) != NULL
298 && (len = strlen (line),
299 len == size - 1 && line[len - 1] != '\n'))
300 {
301 size *= 2;
302 line = (char *) xrealloc (line, size);
303 }
304
305 if (s)
306 {
307 len = strlen (line);
308
309 if (len > 0 && line[len - 1] == '\n')
310 line[--len] = '\0';
311
312 val = build_string (line);
313 xfree (line);
314 }
315 else
316 {
317 xfree (line);
318 error ("Error reading from stdin");
319 }
320
321 /* If Lisp form desired instead of string, parse it. */
322 if (expflag)
323 val = string_to_object (val, defalt);
324
325 return val;
326 }
327 \f
328 DEFUN ("minibufferp", Fminibufferp,
329 Sminibufferp, 0, 1, 0,
330 doc: /* Return t if BUFFER is a minibuffer.
331 No argument or nil as argument means use current buffer as BUFFER.
332 BUFFER can be a buffer or a buffer name. */)
333 (buffer)
334 Lisp_Object buffer;
335 {
336 Lisp_Object tem;
337
338 if (NILP (buffer))
339 buffer = Fcurrent_buffer ();
340 else if (STRINGP (buffer))
341 buffer = Fget_buffer (buffer);
342 else
343 CHECK_BUFFER (buffer);
344
345 tem = Fmemq (buffer, Vminibuffer_list);
346 return ! NILP (tem) ? Qt : Qnil;
347 }
348
349 DEFUN ("minibuffer-prompt-end", Fminibuffer_prompt_end,
350 Sminibuffer_prompt_end, 0, 0, 0,
351 doc: /* Return the buffer position of the end of the minibuffer prompt.
352 Return (point-min) if current buffer is not a minibuffer. */)
353 ()
354 {
355 /* This function is written to be most efficient when there's a prompt. */
356 Lisp_Object beg, end, tem;
357 beg = make_number (BEGV);
358
359 tem = Fmemq (Fcurrent_buffer (), Vminibuffer_list);
360 if (NILP (tem))
361 return beg;
362
363 end = Ffield_end (beg, Qnil, Qnil);
364
365 if (XINT (end) == ZV && NILP (Fget_char_property (beg, Qfield, Qnil)))
366 return beg;
367 else
368 return end;
369 }
370
371 DEFUN ("minibuffer-contents", Fminibuffer_contents,
372 Sminibuffer_contents, 0, 0, 0,
373 doc: /* Return the user input in a minibuffer as a string.
374 The current buffer must be a minibuffer. */)
375 ()
376 {
377 int prompt_end = XINT (Fminibuffer_prompt_end ());
378 return make_buffer_string (prompt_end, ZV, 1);
379 }
380
381 DEFUN ("minibuffer-contents-no-properties", Fminibuffer_contents_no_properties,
382 Sminibuffer_contents_no_properties, 0, 0, 0,
383 doc: /* Return the user input in a minibuffer as a string, without text-properties.
384 The current buffer must be a minibuffer. */)
385 ()
386 {
387 int prompt_end = XINT (Fminibuffer_prompt_end ());
388 return make_buffer_string (prompt_end, ZV, 0);
389 }
390
391 DEFUN ("minibuffer-completion-contents", Fminibuffer_completion_contents,
392 Sminibuffer_completion_contents, 0, 0, 0,
393 doc: /* Return the user input in a minibuffer before point as a string.
394 That is what completion commands operate on.
395 The current buffer must be a minibuffer. */)
396 ()
397 {
398 int prompt_end = XINT (Fminibuffer_prompt_end ());
399 if (PT < prompt_end)
400 error ("Cannot do completion in the prompt");
401 return make_buffer_string (prompt_end, PT, 1);
402 }
403
404 DEFUN ("delete-minibuffer-contents", Fdelete_minibuffer_contents,
405 Sdelete_minibuffer_contents, 0, 0, 0,
406 doc: /* Delete all user input in a minibuffer.
407 The current buffer must be a minibuffer. */)
408 ()
409 {
410 int prompt_end = XINT (Fminibuffer_prompt_end ());
411 if (prompt_end < ZV)
412 del_range (prompt_end, ZV);
413 return Qnil;
414 }
415
416 \f
417 /* Read from the minibuffer using keymap MAP and initial contents INITIAL,
418 putting point minus BACKUP_N bytes from the end of INITIAL,
419 prompting with PROMPT (a string), using history list HISTVAR
420 with initial position HISTPOS. INITIAL should be a string or a
421 cons of a string and an integer. BACKUP_N should be <= 0, or
422 Qnil, which is equivalent to 0. If INITIAL is a cons, BACKUP_N is
423 ignored and replaced with an integer that puts point at one-indexed
424 position N in INITIAL, where N is the CDR of INITIAL, or at the
425 beginning of INITIAL if N <= 0.
426
427 Normally return the result as a string (the text that was read),
428 but if EXPFLAG is nonzero, read it and return the object read.
429 If HISTVAR is given, save the value read on that history only if it doesn't
430 match the front of that history list exactly. The value is pushed onto
431 the list as the string that was read.
432
433 DEFALT specifies the default value for the sake of history commands.
434
435 If ALLOW_PROPS is nonzero, we do not throw away text properties.
436
437 if INHERIT_INPUT_METHOD is nonzero, the minibuffer inherits the
438 current input method. */
439
440 static Lisp_Object
441 read_minibuf (map, initial, prompt, backup_n, expflag,
442 histvar, histpos, defalt, allow_props, inherit_input_method,
443 keep_all)
444 Lisp_Object map;
445 Lisp_Object initial;
446 Lisp_Object prompt;
447 Lisp_Object backup_n;
448 int expflag;
449 Lisp_Object histvar;
450 Lisp_Object histpos;
451 Lisp_Object defalt;
452 int allow_props;
453 int inherit_input_method;
454 int keep_all;
455 {
456 Lisp_Object val;
457 int count = SPECPDL_INDEX ();
458 Lisp_Object mini_frame, ambient_dir, minibuffer, input_method;
459 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
460 Lisp_Object enable_multibyte;
461 int pos = INTEGERP (backup_n) ? XINT (backup_n) : 0;
462
463 /* String to add to the history. */
464 Lisp_Object histstring;
465
466 extern Lisp_Object Qfront_sticky;
467 extern Lisp_Object Qrear_nonsticky;
468
469 specbind (Qminibuffer_default, defalt);
470
471 single_kboard_state ();
472 #ifdef HAVE_X_WINDOWS
473 if (display_hourglass_p)
474 cancel_hourglass ();
475 #endif
476
477 if (!NILP (initial))
478 {
479 if (CONSP (initial))
480 {
481 backup_n = Fcdr (initial);
482 initial = Fcar (initial);
483 CHECK_STRING (initial);
484 if (!NILP (backup_n))
485 {
486 CHECK_NUMBER (backup_n);
487 /* Convert to distance from end of input. */
488 if (XINT (backup_n) < 1)
489 /* A number too small means the beginning of the string. */
490 pos = - SCHARS (initial);
491 else
492 pos = XINT (backup_n) - 1 - SCHARS (initial);
493 }
494 }
495 else
496 CHECK_STRING (initial);
497 }
498 val = Qnil;
499 ambient_dir = current_buffer->directory;
500 input_method = Qnil;
501 enable_multibyte = Qnil;
502
503 /* Don't need to protect PROMPT, HISTVAR, and HISTPOS because we
504 store them away before we can GC. Don't need to protect
505 BACKUP_N because we use the value only if it is an integer. */
506 GCPRO5 (map, initial, val, ambient_dir, input_method);
507
508 if (!STRINGP (prompt))
509 prompt = empty_string;
510
511 if (!enable_recursive_minibuffers
512 && minibuf_level > 0)
513 {
514 if (EQ (selected_window, minibuf_window))
515 error ("Command attempted to use minibuffer while in minibuffer");
516 else
517 /* If we're in another window, cancel the minibuffer that's active. */
518 Fthrow (Qexit,
519 build_string ("Command attempted to use minibuffer while in minibuffer"));
520 }
521
522 if (noninteractive)
523 {
524 val = read_minibuf_noninteractive (map, initial, prompt,
525 make_number (pos),
526 expflag, histvar, histpos, defalt,
527 allow_props, inherit_input_method);
528 UNGCPRO;
529 return unbind_to (count, val);
530 }
531
532 /* Choose the minibuffer window and frame, and take action on them. */
533
534 choose_minibuf_frame ();
535
536 record_unwind_protect (choose_minibuf_frame_1, Qnil);
537
538 record_unwind_protect (Fset_window_configuration,
539 Fcurrent_window_configuration (Qnil));
540
541 /* If the minibuffer window is on a different frame, save that
542 frame's configuration too. */
543 mini_frame = WINDOW_FRAME (XWINDOW (minibuf_window));
544 if (!EQ (mini_frame, selected_frame))
545 record_unwind_protect (Fset_window_configuration,
546 Fcurrent_window_configuration (mini_frame));
547
548 /* If the minibuffer is on an iconified or invisible frame,
549 make it visible now. */
550 Fmake_frame_visible (mini_frame);
551
552 if (minibuffer_auto_raise)
553 Fraise_frame (mini_frame);
554
555 /* We have to do this after saving the window configuration
556 since that is what restores the current buffer. */
557
558 /* Arrange to restore a number of minibuffer-related variables.
559 We could bind each variable separately, but that would use lots of
560 specpdl slots. */
561 minibuf_save_list
562 = Fcons (Voverriding_local_map,
563 Fcons (minibuf_window, minibuf_save_list));
564 minibuf_save_list
565 = Fcons (minibuf_prompt,
566 Fcons (make_number (minibuf_prompt_width),
567 Fcons (Vhelp_form,
568 Fcons (Vcurrent_prefix_arg,
569 Fcons (Vminibuffer_history_position,
570 Fcons (Vminibuffer_history_variable,
571 minibuf_save_list))))));
572
573 record_unwind_protect (read_minibuf_unwind, Qnil);
574 minibuf_level++;
575 /* We are exiting the minibuffer one way or the other, so run the hook.
576 It should be run before unwinding the minibuf settings. Do it
577 separately from read_minibuf_unwind because we need to make sure that
578 read_minibuf_unwind is fully executed even if exit-minibuffer-hook
579 signals an error. --Stef */
580 record_unwind_protect (run_exit_minibuf_hook, Qnil);
581
582 /* Now that we can restore all those variables, start changing them. */
583
584 minibuf_prompt_width = 0;
585 minibuf_prompt = Fcopy_sequence (prompt);
586 Vminibuffer_history_position = histpos;
587 Vminibuffer_history_variable = histvar;
588 Vhelp_form = Vminibuffer_help_form;
589
590 if (inherit_input_method)
591 {
592 /* `current-input-method' is buffer local. So, remember it in
593 INPUT_METHOD before changing the current buffer. */
594 input_method = Fsymbol_value (Qcurrent_input_method);
595 enable_multibyte = current_buffer->enable_multibyte_characters;
596 }
597
598 /* Switch to the minibuffer. */
599
600 minibuffer = get_minibuffer (minibuf_level);
601 Fset_buffer (minibuffer);
602
603 /* If appropriate, copy enable-multibyte-characters into the minibuffer. */
604 if (inherit_input_method)
605 current_buffer->enable_multibyte_characters = enable_multibyte;
606
607 /* The current buffer's default directory is usually the right thing
608 for our minibuffer here. However, if you're typing a command at
609 a minibuffer-only frame when minibuf_level is zero, then buf IS
610 the current_buffer, so reset_buffer leaves buf's default
611 directory unchanged. This is a bummer when you've just started
612 up Emacs and buf's default directory is Qnil. Here's a hack; can
613 you think of something better to do? Find another buffer with a
614 better directory, and use that one instead. */
615 if (STRINGP (ambient_dir))
616 current_buffer->directory = ambient_dir;
617 else
618 {
619 Lisp_Object buf_list;
620
621 for (buf_list = Vbuffer_alist;
622 CONSP (buf_list);
623 buf_list = XCDR (buf_list))
624 {
625 Lisp_Object other_buf;
626
627 other_buf = XCDR (XCAR (buf_list));
628 if (STRINGP (XBUFFER (other_buf)->directory))
629 {
630 current_buffer->directory = XBUFFER (other_buf)->directory;
631 break;
632 }
633 }
634 }
635
636 if (!EQ (mini_frame, selected_frame))
637 Fredirect_frame_focus (selected_frame, mini_frame);
638
639 Vminibuf_scroll_window = selected_window;
640 if (minibuf_level == 1 || !EQ (minibuf_window, selected_window))
641 minibuf_selected_window = selected_window;
642 Fset_window_buffer (minibuf_window, Fcurrent_buffer (), Qnil);
643 Fselect_window (minibuf_window, Qnil);
644 XSETFASTINT (XWINDOW (minibuf_window)->hscroll, 0);
645
646 Fmake_local_variable (Qprint_escape_newlines);
647 print_escape_newlines = 1;
648
649 /* Erase the buffer. */
650 {
651 int count1 = SPECPDL_INDEX ();
652 specbind (Qinhibit_read_only, Qt);
653 specbind (Qinhibit_modification_hooks, Qt);
654 Ferase_buffer ();
655 unbind_to (count1, Qnil);
656 }
657
658 if (!NILP (current_buffer->enable_multibyte_characters)
659 && ! STRING_MULTIBYTE (minibuf_prompt))
660 minibuf_prompt = Fstring_make_multibyte (minibuf_prompt);
661
662 /* Insert the prompt, record where it ends. */
663 Finsert (1, &minibuf_prompt);
664 if (PT > BEG)
665 {
666 Fput_text_property (make_number (BEG), make_number (PT),
667 Qfront_sticky, Qt, Qnil);
668 Fput_text_property (make_number (BEG), make_number (PT),
669 Qrear_nonsticky, Qt, Qnil);
670 Fput_text_property (make_number (BEG), make_number (PT),
671 Qfield, Qt, Qnil);
672 Fadd_text_properties (make_number (BEG), make_number (PT),
673 Vminibuffer_prompt_properties, Qnil);
674 }
675
676 minibuf_prompt_width = (int) current_column (); /* iftc */
677
678 /* Put in the initial input. */
679 if (!NILP (initial))
680 {
681 Finsert (1, &initial);
682 Fforward_char (make_number (pos));
683 }
684
685 clear_message (1, 1);
686 current_buffer->keymap = map;
687
688 /* Turn on an input method stored in INPUT_METHOD if any. */
689 if (STRINGP (input_method) && !NILP (Ffboundp (Qactivate_input_method)))
690 call1 (Qactivate_input_method, input_method);
691
692 /* Run our hook, but not if it is empty.
693 (run-hooks would do nothing if it is empty,
694 but it's important to save time here in the usual case.) */
695 if (!NILP (Vminibuffer_setup_hook) && !EQ (Vminibuffer_setup_hook, Qunbound)
696 && !NILP (Vrun_hooks))
697 call1 (Vrun_hooks, Qminibuffer_setup_hook);
698
699 /* Don't allow the user to undo past this point. */
700 current_buffer->undo_list = Qnil;
701
702 recursive_edit_1 ();
703
704 /* If cursor is on the minibuffer line,
705 show the user we have exited by putting it in column 0. */
706 if (XWINDOW (minibuf_window)->cursor.vpos >= 0
707 && !noninteractive)
708 {
709 XWINDOW (minibuf_window)->cursor.hpos = 0;
710 XWINDOW (minibuf_window)->cursor.x = 0;
711 XWINDOW (minibuf_window)->must_be_updated_p = 1;
712 update_frame (XFRAME (selected_frame), 1, 1);
713 if (rif && rif->flush_display)
714 rif->flush_display (XFRAME (XWINDOW (minibuf_window)->frame));
715 }
716
717 /* Make minibuffer contents into a string. */
718 Fset_buffer (minibuffer);
719 if (allow_props)
720 val = Fminibuffer_contents ();
721 else
722 val = Fminibuffer_contents_no_properties ();
723
724 /* VAL is the string of minibuffer text. */
725
726 last_minibuf_string = val;
727
728 /* Choose the string to add to the history. */
729 if (SCHARS (val) != 0 || keep_all)
730 histstring = val;
731 else if (STRINGP (defalt))
732 histstring = defalt;
733 else
734 histstring = Qnil;
735
736 /* Add the value to the appropriate history list, if any. */
737 if (SYMBOLP (Vminibuffer_history_variable)
738 && !NILP (histstring))
739 {
740 /* If the caller wanted to save the value read on a history list,
741 then do so if the value is not already the front of the list. */
742 Lisp_Object histval;
743
744 /* If variable is unbound, make it nil. */
745 if (EQ (SYMBOL_VALUE (Vminibuffer_history_variable), Qunbound))
746 Fset (Vminibuffer_history_variable, Qnil);
747
748 histval = Fsymbol_value (Vminibuffer_history_variable);
749
750 /* The value of the history variable must be a cons or nil. Other
751 values are unacceptable. We silently ignore these values. */
752
753 if (NILP (histval)
754 || (CONSP (histval)
755 /* Don't duplicate the most recent entry in the history. */
756 && (keep_all
757 || NILP (Fequal (histstring, Fcar (histval))))))
758 {
759 Lisp_Object length;
760
761 if (history_delete_duplicates) Fdelete (histstring, histval);
762 histval = Fcons (histstring, histval);
763 Fset (Vminibuffer_history_variable, histval);
764
765 /* Truncate if requested. */
766 length = Fget (Vminibuffer_history_variable, Qhistory_length);
767 if (NILP (length)) length = Vhistory_length;
768 if (INTEGERP (length))
769 {
770 if (XINT (length) <= 0)
771 Fset (Vminibuffer_history_variable, Qnil);
772 else
773 {
774 Lisp_Object temp;
775
776 temp = Fnthcdr (Fsub1 (length), histval);
777 if (CONSP (temp)) Fsetcdr (temp, Qnil);
778 }
779 }
780 }
781 }
782
783 /* If Lisp form desired instead of string, parse it. */
784 if (expflag)
785 val = string_to_object (val, defalt);
786
787 /* The appropriate frame will get selected
788 in set-window-configuration. */
789 UNGCPRO;
790 return unbind_to (count, val);
791 }
792
793 /* Return a buffer to be used as the minibuffer at depth `depth'.
794 depth = 0 is the lowest allowed argument, and that is the value
795 used for nonrecursive minibuffer invocations */
796
797 Lisp_Object
798 get_minibuffer (depth)
799 int depth;
800 {
801 Lisp_Object tail, num, buf;
802 char name[24];
803 extern Lisp_Object nconc2 ();
804
805 XSETFASTINT (num, depth);
806 tail = Fnthcdr (num, Vminibuffer_list);
807 if (NILP (tail))
808 {
809 tail = Fcons (Qnil, Qnil);
810 Vminibuffer_list = nconc2 (Vminibuffer_list, tail);
811 }
812 buf = Fcar (tail);
813 if (NILP (buf) || NILP (XBUFFER (buf)->name))
814 {
815 sprintf (name, " *Minibuf-%d*", depth);
816 buf = Fget_buffer_create (build_string (name));
817
818 /* Although the buffer's name starts with a space, undo should be
819 enabled in it. */
820 Fbuffer_enable_undo (buf);
821
822 XSETCAR (tail, buf);
823 }
824 else
825 {
826 int count = SPECPDL_INDEX ();
827 /* `reset_buffer' blindly sets the list of overlays to NULL, so we
828 have to empty the list, otherwise we end up with overlays that
829 think they belong to this buffer while the buffer doesn't know about
830 them any more. */
831 delete_all_overlays (XBUFFER (buf));
832 reset_buffer (XBUFFER (buf));
833 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
834 Fset_buffer (buf);
835 Fkill_all_local_variables ();
836 unbind_to (count, Qnil);
837 }
838
839 return buf;
840 }
841
842 static Lisp_Object
843 run_exit_minibuf_hook (data)
844 Lisp_Object data;
845 {
846 if (!NILP (Vminibuffer_exit_hook) && !EQ (Vminibuffer_exit_hook, Qunbound)
847 && !NILP (Vrun_hooks))
848 safe_run_hooks (Qminibuffer_exit_hook);
849
850 return Qnil;
851 }
852
853 /* This function is called on exiting minibuffer, whether normally or
854 not, and it restores the current window, buffer, etc. */
855
856 static Lisp_Object
857 read_minibuf_unwind (data)
858 Lisp_Object data;
859 {
860 Lisp_Object old_deactivate_mark;
861 Lisp_Object window;
862
863 /* If this was a recursive minibuffer,
864 tie the minibuffer window back to the outer level minibuffer buffer. */
865 minibuf_level--;
866
867 window = minibuf_window;
868 /* To keep things predictable, in case it matters, let's be in the
869 minibuffer when we reset the relevant variables. */
870 Fset_buffer (XWINDOW (window)->buffer);
871
872 /* Restore prompt, etc, from outer minibuffer level. */
873 minibuf_prompt = Fcar (minibuf_save_list);
874 minibuf_save_list = Fcdr (minibuf_save_list);
875 minibuf_prompt_width = XFASTINT (Fcar (minibuf_save_list));
876 minibuf_save_list = Fcdr (minibuf_save_list);
877 Vhelp_form = Fcar (minibuf_save_list);
878 minibuf_save_list = Fcdr (minibuf_save_list);
879 Vcurrent_prefix_arg = Fcar (minibuf_save_list);
880 minibuf_save_list = Fcdr (minibuf_save_list);
881 Vminibuffer_history_position = Fcar (minibuf_save_list);
882 minibuf_save_list = Fcdr (minibuf_save_list);
883 Vminibuffer_history_variable = Fcar (minibuf_save_list);
884 minibuf_save_list = Fcdr (minibuf_save_list);
885 Voverriding_local_map = Fcar (minibuf_save_list);
886 minibuf_save_list = Fcdr (minibuf_save_list);
887 #if 0
888 temp = Fcar (minibuf_save_list);
889 if (FRAME_LIVE_P (XFRAME (WINDOW_FRAME (XWINDOW (temp)))))
890 minibuf_window = temp;
891 #endif
892 minibuf_save_list = Fcdr (minibuf_save_list);
893
894 /* Erase the minibuffer we were using at this level. */
895 {
896 int count = SPECPDL_INDEX ();
897 /* Prevent error in erase-buffer. */
898 specbind (Qinhibit_read_only, Qt);
899 specbind (Qinhibit_modification_hooks, Qt);
900 old_deactivate_mark = Vdeactivate_mark;
901 Ferase_buffer ();
902 Vdeactivate_mark = old_deactivate_mark;
903 unbind_to (count, Qnil);
904 }
905
906 /* When we get to the outmost level, make sure we resize the
907 mini-window back to its normal size. */
908 if (minibuf_level == 0)
909 resize_mini_window (XWINDOW (window), 0);
910
911 /* Make sure minibuffer window is erased, not ignored. */
912 windows_or_buffers_changed++;
913 XSETFASTINT (XWINDOW (window)->last_modified, 0);
914 XSETFASTINT (XWINDOW (window)->last_overlay_modified, 0);
915 return Qnil;
916 }
917 \f
918
919 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 8, 0,
920 doc: /* Read a string from the minibuffer, prompting with string PROMPT.
921 The optional second arg INITIAL-CONTENTS is an obsolete alternative to
922 DEFAULT-VALUE. It normally should be nil in new code, except when
923 HIST is a cons. It is discussed in more detail below.
924 Third arg KEYMAP is a keymap to use whilst reading;
925 if omitted or nil, the default is `minibuffer-local-map'.
926 If fourth arg READ is non-nil, then interpret the result as a Lisp object
927 and return that object:
928 in other words, do `(car (read-from-string INPUT-STRING))'
929 Fifth arg HIST, if non-nil, specifies a history list and optionally
930 the initial position in the list. It can be a symbol, which is the
931 history list variable to use, or it can be a cons cell
932 (HISTVAR . HISTPOS). In that case, HISTVAR is the history list variable
933 to use, and HISTPOS is the initial position for use by the minibuffer
934 history commands. For consistency, you should also specify that
935 element of the history as the value of INITIAL-CONTENTS. Positions
936 are counted starting from 1 at the beginning of the list.
937 Sixth arg DEFAULT-VALUE is the default value. If non-nil, it is available
938 for history commands; but, unless READ is non-nil, `read-from-minibuffer'
939 does NOT return DEFAULT-VALUE if the user enters empty input! It returns
940 the empty string.
941 Seventh arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
942 the current input method and the setting of `enable-multibyte-characters'.
943 Eight arg KEEP-ALL, if non-nil, says to put all inputs in the history list,
944 even empty or duplicate inputs.
945 If the variable `minibuffer-allow-text-properties' is non-nil,
946 then the string which is returned includes whatever text properties
947 were present in the minibuffer. Otherwise the value has no text properties.
948
949 The remainder of this documentation string describes the
950 INITIAL-CONTENTS argument in more detail. It is only relevant when
951 studying existing code, or when HIST is a cons. If non-nil,
952 INITIAL-CONTENTS is a string to be inserted into the minibuffer before
953 reading input. Normally, point is put at the end of that string.
954 However, if INITIAL-CONTENTS is \(STRING . POSITION), the initial
955 input is STRING, but point is placed at _one-indexed_ position
956 POSITION in the minibuffer. Any integer value less than or equal to
957 one puts point at the beginning of the string. *Note* that this
958 behavior differs from the way such arguments are used in `completing-read'
959 and some related functions, which use zero-indexing for POSITION. */)
960 (prompt, initial_contents, keymap, read, hist, default_value, inherit_input_method, keep_all)
961 Lisp_Object prompt, initial_contents, keymap, read, hist, default_value;
962 Lisp_Object inherit_input_method, keep_all;
963 {
964 Lisp_Object histvar, histpos, val;
965 struct gcpro gcpro1;
966
967 CHECK_STRING (prompt);
968 if (NILP (keymap))
969 keymap = Vminibuffer_local_map;
970 else
971 keymap = get_keymap (keymap, 1, 0);
972
973 if (SYMBOLP (hist))
974 {
975 histvar = hist;
976 histpos = Qnil;
977 }
978 else
979 {
980 histvar = Fcar_safe (hist);
981 histpos = Fcdr_safe (hist);
982 }
983 if (NILP (histvar))
984 histvar = Qminibuffer_history;
985 if (NILP (histpos))
986 XSETFASTINT (histpos, 0);
987
988 GCPRO1 (default_value);
989 val = read_minibuf (keymap, initial_contents, prompt,
990 Qnil, !NILP (read),
991 histvar, histpos, default_value,
992 minibuffer_allow_text_properties,
993 !NILP (inherit_input_method),
994 !NILP (keep_all));
995 UNGCPRO;
996 return val;
997 }
998
999 DEFUN ("read-minibuffer", Fread_minibuffer, Sread_minibuffer, 1, 2, 0,
1000 doc: /* Return a Lisp object read using the minibuffer, unevaluated.
1001 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS
1002 is a string to insert in the minibuffer before reading.
1003 \(INITIAL-CONTENTS can also be a cons of a string and an integer. Such
1004 arguments are used as in `read-from-minibuffer') */)
1005 (prompt, initial_contents)
1006 Lisp_Object prompt, initial_contents;
1007 {
1008 CHECK_STRING (prompt);
1009 return read_minibuf (Vminibuffer_local_map, initial_contents,
1010 prompt, Qnil, 1, Qminibuffer_history,
1011 make_number (0), Qnil, 0, 0, 0);
1012 }
1013
1014 DEFUN ("eval-minibuffer", Feval_minibuffer, Seval_minibuffer, 1, 2, 0,
1015 doc: /* Return value of Lisp expression read using the minibuffer.
1016 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS
1017 is a string to insert in the minibuffer before reading.
1018 \(INITIAL-CONTENTS can also be a cons of a string and an integer. Such
1019 arguments are used as in `read-from-minibuffer'.) */)
1020 (prompt, initial_contents)
1021 Lisp_Object prompt, initial_contents;
1022 {
1023 return Feval (Fread_minibuffer (prompt, initial_contents));
1024 }
1025
1026 /* Functions that use the minibuffer to read various things. */
1027
1028 DEFUN ("read-string", Fread_string, Sread_string, 1, 5, 0,
1029 doc: /* Read a string from the minibuffer, prompting with string PROMPT.
1030 If non-nil, second arg INITIAL-INPUT is a string to insert before reading.
1031 This argument has been superseded by DEFAULT-VALUE and should normally
1032 be nil in new code. It behaves as in `read-from-minibuffer'. See the
1033 documentation string of that function for details.
1034 The third arg HISTORY, if non-nil, specifies a history list
1035 and optionally the initial position in the list.
1036 See `read-from-minibuffer' for details of HISTORY argument.
1037 Fourth arg DEFAULT-VALUE is the default value. If non-nil, it is used
1038 for history commands, and as the value to return if the user enters
1039 the empty string.
1040 Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
1041 the current input method and the setting of `enable-multibyte-characters'. */)
1042 (prompt, initial_input, history, default_value, inherit_input_method)
1043 Lisp_Object prompt, initial_input, history, default_value;
1044 Lisp_Object inherit_input_method;
1045 {
1046 Lisp_Object val;
1047 val = Fread_from_minibuffer (prompt, initial_input, Qnil,
1048 Qnil, history, default_value,
1049 inherit_input_method, Qnil);
1050 if (STRINGP (val) && SCHARS (val) == 0 && ! NILP (default_value))
1051 val = default_value;
1052 return val;
1053 }
1054
1055 DEFUN ("read-no-blanks-input", Fread_no_blanks_input, Sread_no_blanks_input, 1, 3, 0,
1056 doc: /* Read a string from the terminal, not allowing blanks.
1057 Prompt with PROMPT. Whitespace terminates the input. If INITIAL is
1058 non-nil, it should be a string, which is used as initial input, with
1059 point positioned at the end, so that SPACE will accept the input.
1060 \(Actually, INITIAL can also be a cons of a string and an integer.
1061 Such values are treated as in `read-from-minibuffer', but are normally
1062 not useful in this function.)
1063 Third arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
1064 the current input method and the setting of`enable-multibyte-characters'. */)
1065 (prompt, initial, inherit_input_method)
1066 Lisp_Object prompt, initial, inherit_input_method;
1067 {
1068 CHECK_STRING (prompt);
1069 return read_minibuf (Vminibuffer_local_ns_map, initial, prompt, Qnil,
1070 0, Qminibuffer_history, make_number (0), Qnil, 0,
1071 !NILP (inherit_input_method), 0);
1072 }
1073
1074 DEFUN ("read-command", Fread_command, Sread_command, 1, 2, 0,
1075 doc: /* Read the name of a command and return as a symbol.
1076 Prompt with PROMPT. By default, return DEFAULT-VALUE. */)
1077 (prompt, default_value)
1078 Lisp_Object prompt, default_value;
1079 {
1080 Lisp_Object name, default_string;
1081
1082 if (NILP (default_value))
1083 default_string = Qnil;
1084 else if (SYMBOLP (default_value))
1085 default_string = SYMBOL_NAME (default_value);
1086 else
1087 default_string = default_value;
1088
1089 name = Fcompleting_read (prompt, Vobarray, Qcommandp, Qt,
1090 Qnil, Qnil, default_string, Qnil);
1091 if (NILP (name))
1092 return name;
1093 return Fintern (name, Qnil);
1094 }
1095
1096 #ifdef NOTDEF
1097 DEFUN ("read-function", Fread_function, Sread_function, 1, 1, 0,
1098 doc: /* One arg PROMPT, a string. Read the name of a function and return as a symbol.
1099 Prompt with PROMPT. */)
1100 (prompt)
1101 Lisp_Object prompt;
1102 {
1103 return Fintern (Fcompleting_read (prompt, Vobarray, Qfboundp, Qt, Qnil, Qnil, Qnil, Qnil),
1104 Qnil);
1105 }
1106 #endif /* NOTDEF */
1107
1108 DEFUN ("read-variable", Fread_variable, Sread_variable, 1, 2, 0,
1109 doc: /* Read the name of a user variable and return it as a symbol.
1110 Prompt with PROMPT. By default, return DEFAULT-VALUE.
1111 A user variable is one for which `user-variable-p' returns non-nil. */)
1112 (prompt, default_value)
1113 Lisp_Object prompt, default_value;
1114 {
1115 Lisp_Object name, default_string;
1116
1117 if (NILP (default_value))
1118 default_string = Qnil;
1119 else if (SYMBOLP (default_value))
1120 default_string = SYMBOL_NAME (default_value);
1121 else
1122 default_string = default_value;
1123
1124 name = Fcompleting_read (prompt, Vobarray,
1125 Quser_variable_p, Qt,
1126 Qnil, Qnil, default_string, Qnil);
1127 if (NILP (name))
1128 return name;
1129 return Fintern (name, Qnil);
1130 }
1131
1132 DEFUN ("read-buffer", Fread_buffer, Sread_buffer, 1, 3, 0,
1133 doc: /* Read the name of a buffer and return as a string.
1134 Prompt with PROMPT.
1135 Optional second arg DEF is value to return if user enters an empty line.
1136 If optional third arg REQUIRE-MATCH is non-nil,
1137 only existing buffer names are allowed.
1138 The argument PROMPT should be a string ending with a colon and a space. */)
1139 (prompt, def, require_match)
1140 Lisp_Object prompt, def, require_match;
1141 {
1142 Lisp_Object args[4];
1143 unsigned char *s;
1144 int len;
1145
1146 if (BUFFERP (def))
1147 def = XBUFFER (def)->name;
1148
1149 if (NILP (Vread_buffer_function))
1150 {
1151 if (!NILP (def))
1152 {
1153 /* A default value was provided: we must change PROMPT,
1154 editing the default value in before the colon. To achieve
1155 this, we replace PROMPT with a substring that doesn't
1156 contain the terminal space and colon (if present). They
1157 are then added back using Fformat. */
1158
1159 if (STRINGP (prompt))
1160 {
1161 s = SDATA (prompt);
1162 len = strlen (s);
1163 if (len >= 2 && s[len - 2] == ':' && s[len - 1] == ' ')
1164 len = len - 2;
1165 else if (len >= 1 && (s[len - 1] == ':' || s[len - 1] == ' '))
1166 len--;
1167
1168 prompt = make_specified_string (s, -1, len,
1169 STRING_MULTIBYTE (prompt));
1170 }
1171
1172 args[0] = build_string ("%s (default %s): ");
1173 args[1] = prompt;
1174 args[2] = def;
1175 prompt = Fformat (3, args);
1176 }
1177
1178 return Fcompleting_read (prompt, Vbuffer_alist, Qnil,
1179 require_match, Qnil, Qbuffer_name_history,
1180 def, Qnil);
1181 }
1182 else
1183 {
1184 args[0] = Vread_buffer_function;
1185 args[1] = prompt;
1186 args[2] = def;
1187 args[3] = require_match;
1188 return Ffuncall(4, args);
1189 }
1190 }
1191 \f
1192 static Lisp_Object
1193 minibuf_conform_representation (string, basis)
1194 Lisp_Object string, basis;
1195 {
1196 if (STRING_MULTIBYTE (string) == STRING_MULTIBYTE (basis))
1197 return string;
1198
1199 if (STRING_MULTIBYTE (string))
1200 return Fstring_make_unibyte (string);
1201 else
1202 return Fstring_make_multibyte (string);
1203 }
1204
1205 DEFUN ("try-completion", Ftry_completion, Stry_completion, 2, 3, 0,
1206 doc: /* Return common substring of all completions of STRING in ALIST.
1207 Each car of each element of ALIST (or each element if it is not a cons cell)
1208 is tested to see if it begins with STRING. The possible matches may be
1209 strings or symbols. Symbols are converted to strings before testing,
1210 see `symbol-name'.
1211 All that match are compared together; the longest initial sequence
1212 common to all matches is returned as a string.
1213 If there is no match at all, nil is returned.
1214 For a unique match which is exact, t is returned.
1215
1216 If ALIST is a hash-table, all the string and symbol keys are the
1217 possible matches.
1218 If ALIST is an obarray, the names of all symbols in the obarray
1219 are the possible matches.
1220
1221 ALIST can also be a function to do the completion itself.
1222 It receives three arguments: the values STRING, PREDICATE and nil.
1223 Whatever it returns becomes the value of `try-completion'.
1224
1225 If optional third argument PREDICATE is non-nil,
1226 it is used to test each possible match.
1227 The match is a candidate only if PREDICATE returns non-nil.
1228 The argument given to PREDICATE is the alist element
1229 or the symbol from the obarray. If ALIST is a hash-table,
1230 predicate is called with two arguments: the key and the value.
1231 Additionally to this predicate, `completion-regexp-list'
1232 is used to further constrain the set of candidates. */)
1233 (string, alist, predicate)
1234 Lisp_Object string, alist, predicate;
1235 {
1236 Lisp_Object bestmatch, tail, elt, eltstring;
1237 /* Size in bytes of BESTMATCH. */
1238 int bestmatchsize = 0;
1239 /* These are in bytes, too. */
1240 int compare, matchsize;
1241 int type = (HASH_TABLE_P (alist) ? 3
1242 : VECTORP (alist) ? 2
1243 : NILP (alist) || (CONSP (alist)
1244 && (!SYMBOLP (XCAR (alist))
1245 || NILP (XCAR (alist)))));
1246 int index = 0, obsize = 0;
1247 int matchcount = 0;
1248 int bindcount = -1;
1249 Lisp_Object bucket, zero, end, tem;
1250 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1251
1252 CHECK_STRING (string);
1253 if (type == 0)
1254 return call3 (alist, string, predicate, Qnil);
1255
1256 bestmatch = bucket = Qnil;
1257 zero = make_number (0);
1258
1259 /* If ALIST is not a list, set TAIL just for gc pro. */
1260 tail = alist;
1261 if (type == 2)
1262 {
1263 obsize = XVECTOR (alist)->size;
1264 bucket = XVECTOR (alist)->contents[index];
1265 }
1266
1267 while (1)
1268 {
1269 /* Get the next element of the alist, obarray, or hash-table. */
1270 /* Exit the loop if the elements are all used up. */
1271 /* elt gets the alist element or symbol.
1272 eltstring gets the name to check as a completion. */
1273
1274 if (type == 1)
1275 {
1276 if (!CONSP (tail))
1277 break;
1278 elt = XCAR (tail);
1279 eltstring = CONSP (elt) ? XCAR (elt) : elt;
1280 tail = XCDR (tail);
1281 }
1282 else if (type == 2)
1283 {
1284 if (!EQ (bucket, zero))
1285 {
1286 elt = bucket;
1287 eltstring = elt;
1288 if (XSYMBOL (bucket)->next)
1289 XSETSYMBOL (bucket, XSYMBOL (bucket)->next);
1290 else
1291 XSETFASTINT (bucket, 0);
1292 }
1293 else if (++index >= obsize)
1294 break;
1295 else
1296 {
1297 bucket = XVECTOR (alist)->contents[index];
1298 continue;
1299 }
1300 }
1301 else /* if (type == 3) */
1302 {
1303 while (index < HASH_TABLE_SIZE (XHASH_TABLE (alist))
1304 && NILP (HASH_HASH (XHASH_TABLE (alist), index)))
1305 index++;
1306 if (index >= HASH_TABLE_SIZE (XHASH_TABLE (alist)))
1307 break;
1308 else
1309 elt = eltstring = HASH_KEY (XHASH_TABLE (alist), index++);
1310 }
1311
1312 /* Is this element a possible completion? */
1313
1314 if (SYMBOLP (eltstring))
1315 eltstring = Fsymbol_name (eltstring);
1316
1317 if (STRINGP (eltstring)
1318 && SCHARS (string) <= SCHARS (eltstring)
1319 && (tem = Fcompare_strings (eltstring, zero,
1320 make_number (SCHARS (string)),
1321 string, zero, Qnil,
1322 completion_ignore_case ? Qt : Qnil),
1323 EQ (Qt, tem)))
1324 {
1325 /* Yes. */
1326 Lisp_Object regexps;
1327
1328 /* Ignore this element if it fails to match all the regexps. */
1329 {
1330 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1331 regexps = XCDR (regexps))
1332 {
1333 if (bindcount < 0) {
1334 bindcount = SPECPDL_INDEX ();
1335 specbind (Qcase_fold_search,
1336 completion_ignore_case ? Qt : Qnil);
1337 }
1338 tem = Fstring_match (XCAR (regexps), eltstring, zero);
1339 if (NILP (tem))
1340 break;
1341 }
1342 if (CONSP (regexps))
1343 continue;
1344 }
1345
1346 /* Ignore this element if there is a predicate
1347 and the predicate doesn't like it. */
1348
1349 if (!NILP (predicate))
1350 {
1351 if (EQ (predicate, Qcommandp))
1352 tem = Fcommandp (elt, Qnil);
1353 else
1354 {
1355 if (bindcount >= 0) {
1356 unbind_to (bindcount, Qnil);
1357 bindcount = -1;
1358 }
1359 GCPRO4 (tail, string, eltstring, bestmatch);
1360 tem = type == 3
1361 ? call2 (predicate, elt,
1362 HASH_VALUE (XHASH_TABLE (alist), index - 1))
1363 : call1 (predicate, elt);
1364 UNGCPRO;
1365 }
1366 if (NILP (tem)) continue;
1367 }
1368
1369 /* Update computation of how much all possible completions match */
1370
1371 if (NILP (bestmatch))
1372 {
1373 matchcount = 1;
1374 bestmatch = eltstring;
1375 bestmatchsize = SCHARS (eltstring);
1376 }
1377 else
1378 {
1379 compare = min (bestmatchsize, SCHARS (eltstring));
1380 tem = Fcompare_strings (bestmatch, zero,
1381 make_number (compare),
1382 eltstring, zero,
1383 make_number (compare),
1384 completion_ignore_case ? Qt : Qnil);
1385 if (EQ (tem, Qt))
1386 matchsize = compare;
1387 else if (XINT (tem) < 0)
1388 matchsize = - XINT (tem) - 1;
1389 else
1390 matchsize = XINT (tem) - 1;
1391
1392 if (matchsize < 0)
1393 /* When can this happen ? -stef */
1394 matchsize = compare;
1395 if (completion_ignore_case)
1396 {
1397 /* If this is an exact match except for case,
1398 use it as the best match rather than one that is not an
1399 exact match. This way, we get the case pattern
1400 of the actual match. */
1401 if ((matchsize == SCHARS (eltstring)
1402 && matchsize < SCHARS (bestmatch))
1403 ||
1404 /* If there is more than one exact match ignoring case,
1405 and one of them is exact including case,
1406 prefer that one. */
1407 /* If there is no exact match ignoring case,
1408 prefer a match that does not change the case
1409 of the input. */
1410 ((matchsize == SCHARS (eltstring))
1411 ==
1412 (matchsize == SCHARS (bestmatch))
1413 && (tem = Fcompare_strings (eltstring, zero,
1414 make_number (SCHARS (string)),
1415 string, zero,
1416 Qnil,
1417 Qnil),
1418 EQ (Qt, tem))
1419 && (tem = Fcompare_strings (bestmatch, zero,
1420 make_number (SCHARS (string)),
1421 string, zero,
1422 Qnil,
1423 Qnil),
1424 ! EQ (Qt, tem))))
1425 bestmatch = eltstring;
1426 }
1427 if (bestmatchsize != SCHARS (eltstring)
1428 || bestmatchsize != matchsize)
1429 /* Don't count the same string multiple times. */
1430 matchcount++;
1431 bestmatchsize = matchsize;
1432 if (matchsize <= SCHARS (string)
1433 && matchcount > 1)
1434 /* No need to look any further. */
1435 break;
1436 }
1437 }
1438 }
1439
1440 if (bindcount >= 0) {
1441 unbind_to (bindcount, Qnil);
1442 bindcount = -1;
1443 }
1444
1445 if (NILP (bestmatch))
1446 return Qnil; /* No completions found */
1447 /* If we are ignoring case, and there is no exact match,
1448 and no additional text was supplied,
1449 don't change the case of what the user typed. */
1450 if (completion_ignore_case && bestmatchsize == SCHARS (string)
1451 && SCHARS (bestmatch) > bestmatchsize)
1452 return minibuf_conform_representation (string, bestmatch);
1453
1454 /* Return t if the supplied string is an exact match (counting case);
1455 it does not require any change to be made. */
1456 if (matchcount == 1 && bestmatchsize == SCHARS (string)
1457 && (tem = Fcompare_strings (bestmatch, make_number (0),
1458 make_number (bestmatchsize),
1459 string, make_number (0),
1460 make_number (bestmatchsize),
1461 Qnil),
1462 EQ (Qt, tem)))
1463 return Qt;
1464
1465 XSETFASTINT (zero, 0); /* Else extract the part in which */
1466 XSETFASTINT (end, bestmatchsize); /* all completions agree */
1467 return Fsubstring (bestmatch, zero, end);
1468 }
1469 \f
1470 DEFUN ("all-completions", Fall_completions, Sall_completions, 2, 4, 0,
1471 doc: /* Search for partial matches to STRING in ALIST.
1472 Each car of each element of ALIST (or each element if it is not a cons cell)
1473 is tested to see if it begins with STRING. The possible matches may be
1474 strings or symbols. Symbols are converted to strings before testing,
1475 see `symbol-name'.
1476 The value is a list of all the strings from ALIST that match.
1477
1478 If ALIST is a hash-table, all the string and symbol keys are the
1479 possible matches.
1480 If ALIST is an obarray, the names of all symbols in the obarray
1481 are the possible matches.
1482
1483 ALIST can also be a function to do the completion itself.
1484 It receives three arguments: the values STRING, PREDICATE and t.
1485 Whatever it returns becomes the value of `all-completions'.
1486
1487 If optional third argument PREDICATE is non-nil,
1488 it is used to test each possible match.
1489 The match is a candidate only if PREDICATE returns non-nil.
1490 The argument given to PREDICATE is the alist element
1491 or the symbol from the obarray. If ALIST is a hash-table,
1492 predicate is called with two arguments: the key and the value.
1493 Additionally to this predicate, `completion-regexp-list'
1494 is used to further constrain the set of candidates.
1495
1496 If the optional fourth argument HIDE-SPACES is non-nil,
1497 strings in ALIST that start with a space
1498 are ignored unless STRING itself starts with a space. */)
1499 (string, alist, predicate, hide_spaces)
1500 Lisp_Object string, alist, predicate, hide_spaces;
1501 {
1502 Lisp_Object tail, elt, eltstring;
1503 Lisp_Object allmatches;
1504 int type = HASH_TABLE_P (alist) ? 3
1505 : VECTORP (alist) ? 2
1506 : NILP (alist) || (CONSP (alist)
1507 && (!SYMBOLP (XCAR (alist))
1508 || NILP (XCAR (alist))));
1509 int index = 0, obsize = 0;
1510 int bindcount = -1;
1511 Lisp_Object bucket, tem, zero;
1512 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4;
1513
1514 CHECK_STRING (string);
1515 if (type == 0)
1516 return call3 (alist, string, predicate, Qt);
1517 allmatches = bucket = Qnil;
1518 zero = make_number (0);
1519
1520 /* If ALIST is not a list, set TAIL just for gc pro. */
1521 tail = alist;
1522 if (type == 2)
1523 {
1524 obsize = XVECTOR (alist)->size;
1525 bucket = XVECTOR (alist)->contents[index];
1526 }
1527
1528 while (1)
1529 {
1530 /* Get the next element of the alist, obarray, or hash-table. */
1531 /* Exit the loop if the elements are all used up. */
1532 /* elt gets the alist element or symbol.
1533 eltstring gets the name to check as a completion. */
1534
1535 if (type == 1)
1536 {
1537 if (!CONSP (tail))
1538 break;
1539 elt = XCAR (tail);
1540 eltstring = CONSP (elt) ? XCAR (elt) : elt;
1541 tail = XCDR (tail);
1542 }
1543 else if (type == 2)
1544 {
1545 if (!EQ (bucket, zero))
1546 {
1547 elt = bucket;
1548 eltstring = elt;
1549 if (XSYMBOL (bucket)->next)
1550 XSETSYMBOL (bucket, XSYMBOL (bucket)->next);
1551 else
1552 XSETFASTINT (bucket, 0);
1553 }
1554 else if (++index >= obsize)
1555 break;
1556 else
1557 {
1558 bucket = XVECTOR (alist)->contents[index];
1559 continue;
1560 }
1561 }
1562 else /* if (type == 3) */
1563 {
1564 while (index < HASH_TABLE_SIZE (XHASH_TABLE (alist))
1565 && NILP (HASH_HASH (XHASH_TABLE (alist), index)))
1566 index++;
1567 if (index >= HASH_TABLE_SIZE (XHASH_TABLE (alist)))
1568 break;
1569 else
1570 elt = eltstring = HASH_KEY (XHASH_TABLE (alist), index++);
1571 }
1572
1573 /* Is this element a possible completion? */
1574
1575 if (SYMBOLP (eltstring))
1576 eltstring = Fsymbol_name (eltstring);
1577
1578 if (STRINGP (eltstring)
1579 && SCHARS (string) <= SCHARS (eltstring)
1580 /* If HIDE_SPACES, reject alternatives that start with space
1581 unless the input starts with space. */
1582 && ((SBYTES (string) > 0
1583 && SREF (string, 0) == ' ')
1584 || SREF (eltstring, 0) != ' '
1585 || NILP (hide_spaces))
1586 && (tem = Fcompare_strings (eltstring, zero,
1587 make_number (SCHARS (string)),
1588 string, zero,
1589 make_number (SCHARS (string)),
1590 completion_ignore_case ? Qt : Qnil),
1591 EQ (Qt, tem)))
1592 {
1593 /* Yes. */
1594 Lisp_Object regexps;
1595 Lisp_Object zero;
1596 XSETFASTINT (zero, 0);
1597
1598 /* Ignore this element if it fails to match all the regexps. */
1599 {
1600 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1601 regexps = XCDR (regexps))
1602 {
1603 if (bindcount < 0) {
1604 bindcount = SPECPDL_INDEX ();
1605 specbind (Qcase_fold_search,
1606 completion_ignore_case ? Qt : Qnil);
1607 }
1608 tem = Fstring_match (XCAR (regexps), eltstring, zero);
1609 if (NILP (tem))
1610 break;
1611 }
1612 if (CONSP (regexps))
1613 continue;
1614 }
1615
1616 /* Ignore this element if there is a predicate
1617 and the predicate doesn't like it. */
1618
1619 if (!NILP (predicate))
1620 {
1621 if (EQ (predicate, Qcommandp))
1622 tem = Fcommandp (elt, Qnil);
1623 else
1624 {
1625 if (bindcount >= 0) {
1626 unbind_to (bindcount, Qnil);
1627 bindcount = -1;
1628 }
1629 GCPRO4 (tail, eltstring, allmatches, string);
1630 tem = type == 3
1631 ? call2 (predicate, elt,
1632 HASH_VALUE (XHASH_TABLE (alist), index - 1))
1633 : call1 (predicate, elt);
1634 UNGCPRO;
1635 }
1636 if (NILP (tem)) continue;
1637 }
1638 /* Ok => put it on the list. */
1639 allmatches = Fcons (eltstring, allmatches);
1640 }
1641 }
1642
1643 if (bindcount >= 0) {
1644 unbind_to (bindcount, Qnil);
1645 bindcount = -1;
1646 }
1647
1648 return Fnreverse (allmatches);
1649 }
1650 \f
1651 Lisp_Object Vminibuffer_completion_table, Qminibuffer_completion_table;
1652 Lisp_Object Vminibuffer_completion_predicate, Qminibuffer_completion_predicate;
1653 Lisp_Object Vminibuffer_completion_confirm, Qminibuffer_completion_confirm;
1654 Lisp_Object Vminibuffer_completing_file_name;
1655
1656 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 8, 0,
1657 doc: /* Read a string in the minibuffer, with completion.
1658 PROMPT is a string to prompt with; normally it ends in a colon and a space.
1659 TABLE can be an list of strings, an alist, an obarray or a hash table.
1660 TABLE can also be a function to do the completion itself.
1661 PREDICATE limits completion to a subset of TABLE.
1662 See `try-completion' and `all-completions' for more details
1663 on completion, TABLE, and PREDICATE.
1664
1665 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
1666 the input is (or completes to) an element of TABLE or is null.
1667 If it is also not t, typing RET does not exit if it does non-null completion.
1668 If the input is null, `completing-read' returns DEF, or an empty string
1669 if DEF is nil, regardless of the value of REQUIRE-MATCH.
1670
1671 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially,
1672 with point positioned at the end.
1673 If it is (STRING . POSITION), the initial input is STRING, but point
1674 is placed at _zero-indexed_ position POSITION in STRING. (*Note*
1675 that this is different from `read-from-minibuffer' and related
1676 functions, which use one-indexing for POSITION.) This feature is
1677 deprecated--it is best to pass nil for INITIAL-INPUT and supply the
1678 default value DEF instead. The user can yank the default value into
1679 the minibuffer easily using \\[next-history-element].
1680
1681 HIST, if non-nil, specifies a history list and optionally the initial
1682 position in the list. It can be a symbol, which is the history list
1683 variable to use, or it can be a cons cell (HISTVAR . HISTPOS). In
1684 that case, HISTVAR is the history list variable to use, and HISTPOS
1685 is the initial position (the position in the list used by the
1686 minibuffer history commands). For consistency, you should also
1687 specify that element of the history as the value of
1688 INITIAL-INPUT. (This is the only case in which you should use
1689 INITIAL-INPUT instead of DEF.) Positions are counted starting from
1690 1 at the beginning of the list. The variable `history-length'
1691 controls the maximum length of a history list.
1692
1693 DEF, if non-nil, is the default value.
1694
1695 If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits
1696 the current input method and the setting of `enable-multibyte-characters'.
1697
1698 Completion ignores case if the ambient value of
1699 `completion-ignore-case' is non-nil. */)
1700 (prompt, table, predicate, require_match, initial_input, hist, def, inherit_input_method)
1701 Lisp_Object prompt, table, predicate, require_match, initial_input;
1702 Lisp_Object hist, def, inherit_input_method;
1703 {
1704 Lisp_Object val, histvar, histpos, position;
1705 Lisp_Object init;
1706 int pos = 0;
1707 int count = SPECPDL_INDEX ();
1708 struct gcpro gcpro1;
1709
1710 init = initial_input;
1711 GCPRO1 (def);
1712
1713 specbind (Qminibuffer_completion_table, table);
1714 specbind (Qminibuffer_completion_predicate, predicate);
1715 specbind (Qminibuffer_completion_confirm,
1716 EQ (require_match, Qt) ? Qnil : require_match);
1717 last_exact_completion = Qnil;
1718
1719 position = Qnil;
1720 if (!NILP (init))
1721 {
1722 if (CONSP (init))
1723 {
1724 position = Fcdr (init);
1725 init = Fcar (init);
1726 }
1727 CHECK_STRING (init);
1728 if (!NILP (position))
1729 {
1730 CHECK_NUMBER (position);
1731 /* Convert to distance from end of input. */
1732 pos = XINT (position) - SCHARS (init);
1733 }
1734 }
1735
1736 if (SYMBOLP (hist))
1737 {
1738 histvar = hist;
1739 histpos = Qnil;
1740 }
1741 else
1742 {
1743 histvar = Fcar_safe (hist);
1744 histpos = Fcdr_safe (hist);
1745 }
1746 if (NILP (histvar))
1747 histvar = Qminibuffer_history;
1748 if (NILP (histpos))
1749 XSETFASTINT (histpos, 0);
1750
1751 val = read_minibuf (NILP (require_match)
1752 ? (NILP (Vminibuffer_completing_file_name)
1753 ? Vminibuffer_local_completion_map
1754 : Vminibuffer_local_filename_completion_map)
1755 : (NILP (Vminibuffer_completing_file_name)
1756 ? Vminibuffer_local_must_match_map
1757 : Vminibuffer_local_must_match_filename_map),
1758 init, prompt, make_number (pos), 0,
1759 histvar, histpos, def, 0,
1760 !NILP (inherit_input_method), 0);
1761
1762 if (STRINGP (val) && SCHARS (val) == 0 && ! NILP (def))
1763 val = def;
1764
1765 RETURN_UNGCPRO (unbind_to (count, val));
1766 }
1767 \f
1768 Lisp_Object Fminibuffer_completion_help ();
1769 Lisp_Object Fassoc_string ();
1770
1771 /* Test whether TXT is an exact completion. */
1772 DEFUN ("test-completion", Ftest_completion, Stest_completion, 2, 3, 0,
1773 doc: /* Return non-nil if STRING is a valid completion.
1774 Takes the same arguments as `all-completions' and `try-completion'.
1775 If ALIST is a function, it is called with three arguments:
1776 the values STRING, PREDICATE and `lambda'. */)
1777 (string, alist, predicate)
1778 Lisp_Object string, alist, predicate;
1779 {
1780 Lisp_Object regexps, tail, tem = Qnil;
1781 int i = 0;
1782
1783 CHECK_STRING (string);
1784
1785 if ((CONSP (alist) && (!SYMBOLP (XCAR (alist)) || NILP (XCAR (alist))))
1786 || NILP (alist))
1787 {
1788 tem = Fassoc_string (string, alist, completion_ignore_case ? Qt : Qnil);
1789 if (NILP (tem))
1790 return Qnil;
1791 }
1792 else if (VECTORP (alist))
1793 {
1794 /* Bypass intern-soft as that loses for nil. */
1795 tem = oblookup (alist,
1796 SDATA (string),
1797 SCHARS (string),
1798 SBYTES (string));
1799 if (!SYMBOLP (tem))
1800 {
1801 if (STRING_MULTIBYTE (string))
1802 string = Fstring_make_unibyte (string);
1803 else
1804 string = Fstring_make_multibyte (string);
1805
1806 tem = oblookup (alist,
1807 SDATA (string),
1808 SCHARS (string),
1809 SBYTES (string));
1810 }
1811
1812 if (completion_ignore_case && !SYMBOLP (tem))
1813 {
1814 for (i = XVECTOR (alist)->size - 1; i >= 0; i--)
1815 {
1816 tail = XVECTOR (alist)->contents[i];
1817 if (SYMBOLP (tail))
1818 while (1)
1819 {
1820 if (EQ((Fcompare_strings (string, make_number (0), Qnil,
1821 Fsymbol_name (tail),
1822 make_number (0) , Qnil, Qt)),
1823 Qt))
1824 {
1825 tem = tail;
1826 break;
1827 }
1828 if (XSYMBOL (tail)->next == 0)
1829 break;
1830 XSETSYMBOL (tail, XSYMBOL (tail)->next);
1831 }
1832 }
1833 }
1834
1835 if (!SYMBOLP (tem))
1836 return Qnil;
1837 }
1838 else if (HASH_TABLE_P (alist))
1839 {
1840 struct Lisp_Hash_Table *h = XHASH_TABLE (alist);
1841 i = hash_lookup (h, string, NULL);
1842 if (i >= 0)
1843 tem = HASH_KEY (h, i);
1844 else
1845 for (i = 0; i < HASH_TABLE_SIZE (h); ++i)
1846 if (!NILP (HASH_HASH (h, i)) &&
1847 EQ (Fcompare_strings (string, make_number (0), Qnil,
1848 HASH_KEY (h, i), make_number (0) , Qnil,
1849 completion_ignore_case ? Qt : Qnil),
1850 Qt))
1851 {
1852 tem = HASH_KEY (h, i);
1853 break;
1854 }
1855 if (!STRINGP (tem))
1856 return Qnil;
1857 }
1858 else
1859 return call3 (alist, string, predicate, Qlambda);
1860
1861 /* Reject this element if it fails to match all the regexps. */
1862 if (CONSP (Vcompletion_regexp_list))
1863 {
1864 int count = SPECPDL_INDEX ();
1865 specbind (Qcase_fold_search, completion_ignore_case ? Qt : Qnil);
1866 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
1867 regexps = XCDR (regexps))
1868 {
1869 if (NILP (Fstring_match (XCAR (regexps),
1870 SYMBOLP (tem) ? string : tem,
1871 Qnil)))
1872 return unbind_to (count, Qnil);
1873 }
1874 unbind_to (count, Qnil);
1875 }
1876
1877 /* Finally, check the predicate. */
1878 if (!NILP (predicate))
1879 {
1880 return HASH_TABLE_P (alist)
1881 ? call2 (predicate, tem, HASH_VALUE (XHASH_TABLE (alist), i))
1882 : call1 (predicate, tem);
1883 }
1884 else
1885 return Qt;
1886 }
1887
1888 /* returns:
1889 * 0 no possible completion
1890 * 1 was already an exact and unique completion
1891 * 3 was already an exact completion
1892 * 4 completed to an exact completion
1893 * 5 some completion happened
1894 * 6 no completion happened
1895 */
1896 int
1897 do_completion ()
1898 {
1899 Lisp_Object completion, string, tem;
1900 int completedp;
1901 Lisp_Object last;
1902 struct gcpro gcpro1, gcpro2;
1903
1904 completion = Ftry_completion (Fminibuffer_completion_contents (),
1905 Vminibuffer_completion_table,
1906 Vminibuffer_completion_predicate);
1907 last = last_exact_completion;
1908 last_exact_completion = Qnil;
1909
1910 GCPRO2 (completion, last);
1911
1912 if (NILP (completion))
1913 {
1914 bitch_at_user ();
1915 temp_echo_area_glyphs (build_string (" [No match]"));
1916 UNGCPRO;
1917 return 0;
1918 }
1919
1920 if (EQ (completion, Qt)) /* exact and unique match */
1921 {
1922 UNGCPRO;
1923 return 1;
1924 }
1925
1926 string = Fminibuffer_completion_contents ();
1927
1928 /* COMPLETEDP should be true if some completion was done, which
1929 doesn't include simply changing the case of the entered string.
1930 However, for appearance, the string is rewritten if the case
1931 changes. */
1932 tem = Fcompare_strings (completion, Qnil, Qnil, string, Qnil, Qnil, Qt);
1933 completedp = !EQ (tem, Qt);
1934
1935 tem = Fcompare_strings (completion, Qnil, Qnil, string, Qnil, Qnil, Qnil);
1936 if (!EQ (tem, Qt))
1937 /* Rewrite the user's input. */
1938 {
1939 int prompt_end = XINT (Fminibuffer_prompt_end ());
1940 /* Some completion happened */
1941
1942 if (! NILP (Vminibuffer_completing_file_name)
1943 && SREF (completion, SBYTES (completion) - 1) == '/'
1944 && PT < ZV
1945 && FETCH_CHAR (PT_BYTE) == '/')
1946 {
1947 del_range (prompt_end, PT + 1);
1948 }
1949 else
1950 del_range (prompt_end, PT);
1951
1952 Finsert (1, &completion);
1953
1954 if (! completedp)
1955 /* The case of the string changed, but that's all. We're not
1956 sure whether this is a unique completion or not, so try again
1957 using the real case (this shouldn't recurse again, because
1958 the next time try-completion will return either `t' or the
1959 exact string). */
1960 {
1961 UNGCPRO;
1962 return do_completion ();
1963 }
1964 }
1965
1966 /* It did find a match. Do we match some possibility exactly now? */
1967 tem = Ftest_completion (Fminibuffer_contents (),
1968 Vminibuffer_completion_table,
1969 Vminibuffer_completion_predicate);
1970 if (NILP (tem))
1971 {
1972 /* not an exact match */
1973 UNGCPRO;
1974 if (completedp)
1975 return 5;
1976 else if (!NILP (Vcompletion_auto_help))
1977 Fminibuffer_completion_help ();
1978 else
1979 temp_echo_area_glyphs (build_string (" [Next char not unique]"));
1980 return 6;
1981 }
1982 else if (completedp)
1983 {
1984 UNGCPRO;
1985 return 4;
1986 }
1987 /* If the last exact completion and this one were the same,
1988 it means we've already given a "Complete but not unique"
1989 message and the user's hit TAB again, so now we give him help. */
1990 last_exact_completion = completion;
1991 if (!NILP (last))
1992 {
1993 tem = Fminibuffer_completion_contents ();
1994 if (!NILP (Fequal (tem, last)))
1995 Fminibuffer_completion_help ();
1996 }
1997 UNGCPRO;
1998 return 3;
1999 }
2000
2001 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */
2002
2003 DEFUN ("assoc-string", Fassoc_string, Sassoc_string, 2, 3, 0,
2004 doc: /* Like `assoc' but specifically for strings.
2005 Unibyte strings are converted to multibyte for comparison.
2006 And case is ignored if CASE-FOLD is non-nil.
2007 As opposed to `assoc', it will also match an entry consisting of a single
2008 string rather than a cons cell whose car is a string. */)
2009 (key, list, case_fold)
2010 register Lisp_Object key;
2011 Lisp_Object list, case_fold;
2012 {
2013 register Lisp_Object tail;
2014
2015 for (tail = list; !NILP (tail); tail = Fcdr (tail))
2016 {
2017 register Lisp_Object elt, tem, thiscar;
2018 elt = Fcar (tail);
2019 thiscar = CONSP (elt) ? XCAR (elt) : elt;
2020 if (!STRINGP (thiscar))
2021 continue;
2022 tem = Fcompare_strings (thiscar, make_number (0), Qnil,
2023 key, make_number (0), Qnil,
2024 case_fold);
2025 if (EQ (tem, Qt))
2026 return elt;
2027 QUIT;
2028 }
2029 return Qnil;
2030 }
2031
2032 DEFUN ("minibuffer-complete", Fminibuffer_complete, Sminibuffer_complete, 0, 0, "",
2033 doc: /* Complete the minibuffer contents as far as possible.
2034 Return nil if there is no valid completion, else t.
2035 If no characters can be completed, display a list of possible completions.
2036 If you repeat this command after it displayed such a list,
2037 scroll the window of possible completions. */)
2038 ()
2039 {
2040 register int i;
2041 Lisp_Object window, tem;
2042
2043 /* If the previous command was not this,
2044 mark the completion buffer obsolete. */
2045 if (! EQ (current_kboard->Vlast_command, Vthis_command))
2046 Vminibuf_scroll_window = Qnil;
2047
2048 window = Vminibuf_scroll_window;
2049 /* If there's a fresh completion window with a live buffer,
2050 and this command is repeated, scroll that window. */
2051 if (! NILP (window) && ! NILP (XWINDOW (window)->buffer)
2052 && !NILP (XBUFFER (XWINDOW (window)->buffer)->name))
2053 {
2054 struct buffer *obuf = current_buffer;
2055
2056 Fset_buffer (XWINDOW (window)->buffer);
2057 tem = Fpos_visible_in_window_p (make_number (ZV), window, Qnil);
2058 if (! NILP (tem))
2059 /* If end is in view, scroll up to the beginning. */
2060 Fset_window_start (window, make_number (BEGV), Qnil);
2061 else
2062 /* Else scroll down one screen. */
2063 Fscroll_other_window (Qnil);
2064
2065 set_buffer_internal (obuf);
2066 return Qnil;
2067 }
2068
2069 i = do_completion ();
2070 switch (i)
2071 {
2072 case 0:
2073 return Qnil;
2074
2075 case 1:
2076 if (PT != ZV)
2077 Fgoto_char (make_number (ZV));
2078 temp_echo_area_glyphs (build_string (" [Sole completion]"));
2079 break;
2080
2081 case 3:
2082 if (PT != ZV)
2083 Fgoto_char (make_number (ZV));
2084 temp_echo_area_glyphs (build_string (" [Complete, but not unique]"));
2085 break;
2086 }
2087
2088 return Qt;
2089 }
2090 \f
2091 /* Subroutines of Fminibuffer_complete_and_exit. */
2092
2093 /* This one is called by internal_condition_case to do the real work. */
2094
2095 Lisp_Object
2096 complete_and_exit_1 ()
2097 {
2098 return make_number (do_completion ());
2099 }
2100
2101 /* This one is called by internal_condition_case if an error happens.
2102 Pretend the current value is an exact match. */
2103
2104 Lisp_Object
2105 complete_and_exit_2 (ignore)
2106 Lisp_Object ignore;
2107 {
2108 return make_number (1);
2109 }
2110
2111 EXFUN (Fexit_minibuffer, 0) NO_RETURN;
2112
2113 DEFUN ("minibuffer-complete-and-exit", Fminibuffer_complete_and_exit,
2114 Sminibuffer_complete_and_exit, 0, 0, "",
2115 doc: /* If the minibuffer contents is a valid completion then exit.
2116 Otherwise try to complete it. If completion leads to a valid completion,
2117 a repetition of this command will exit. */)
2118 ()
2119 {
2120 register int i;
2121 Lisp_Object val, tem;
2122
2123 /* Allow user to specify null string */
2124 if (XINT (Fminibuffer_prompt_end ()) == ZV)
2125 goto exit;
2126
2127 val = Fminibuffer_contents ();
2128 tem = Ftest_completion (val,
2129 Vminibuffer_completion_table,
2130 Vminibuffer_completion_predicate);
2131 if (!NILP (tem))
2132 {
2133 if (completion_ignore_case)
2134 { /* Fixup case of the field, if necessary. */
2135 Lisp_Object compl
2136 = Ftry_completion (val,
2137 Vminibuffer_completion_table,
2138 Vminibuffer_completion_predicate);
2139 if (STRINGP (compl)
2140 /* If it weren't for this piece of paranoia, I'd replace
2141 the whole thing with a call to do_completion. */
2142 && EQ (Flength (val), Flength (compl)))
2143 {
2144 del_range (XINT (Fminibuffer_prompt_end ()), ZV);
2145 Finsert (1, &compl);
2146 }
2147 }
2148 goto exit;
2149 }
2150
2151 /* Call do_completion, but ignore errors. */
2152 SET_PT (ZV);
2153 val = internal_condition_case (complete_and_exit_1, Qerror,
2154 complete_and_exit_2);
2155
2156 i = XFASTINT (val);
2157 switch (i)
2158 {
2159 case 1:
2160 case 3:
2161 goto exit;
2162
2163 case 4:
2164 if (!NILP (Vminibuffer_completion_confirm))
2165 {
2166 temp_echo_area_glyphs (build_string (" [Confirm]"));
2167 return Qnil;
2168 }
2169 else
2170 goto exit;
2171
2172 default:
2173 return Qnil;
2174 }
2175 exit:
2176 return Fexit_minibuffer ();
2177 /* NOTREACHED */
2178 }
2179
2180 DEFUN ("minibuffer-complete-word", Fminibuffer_complete_word, Sminibuffer_complete_word,
2181 0, 0, "",
2182 doc: /* Complete the minibuffer contents at most a single word.
2183 After one word is completed as much as possible, a space or hyphen
2184 is added, provided that matches some possible completion.
2185 Return nil if there is no valid completion, else t. */)
2186 ()
2187 {
2188 Lisp_Object completion, tem, tem1;
2189 register int i, i_byte;
2190 struct gcpro gcpro1, gcpro2;
2191 int prompt_end_charpos = XINT (Fminibuffer_prompt_end ());
2192
2193 /* We keep calling Fbuffer_string rather than arrange for GC to
2194 hold onto a pointer to one of the strings thus made. */
2195
2196 completion = Ftry_completion (Fminibuffer_completion_contents (),
2197 Vminibuffer_completion_table,
2198 Vminibuffer_completion_predicate);
2199 if (NILP (completion))
2200 {
2201 bitch_at_user ();
2202 temp_echo_area_glyphs (build_string (" [No match]"));
2203 return Qnil;
2204 }
2205 if (EQ (completion, Qt))
2206 return Qnil;
2207
2208 #if 0 /* How the below code used to look, for reference. */
2209 tem = Fminibuffer_contents ();
2210 b = SDATA (tem);
2211 i = ZV - 1 - SCHARS (completion);
2212 p = SDATA (completion);
2213 if (i > 0 ||
2214 0 <= scmp (b, p, ZV - 1))
2215 {
2216 i = 1;
2217 /* Set buffer to longest match of buffer tail and completion head. */
2218 while (0 <= scmp (b + i, p, ZV - 1 - i))
2219 i++;
2220 del_range (1, i + 1);
2221 SET_PT (ZV);
2222 }
2223 #else /* Rewritten code */
2224 {
2225 int buffer_nchars, completion_nchars;
2226
2227 CHECK_STRING (completion);
2228 tem = Fminibuffer_completion_contents ();
2229 GCPRO2 (completion, tem);
2230 /* If reading a file name,
2231 expand any $ENVVAR refs in the buffer and in TEM. */
2232 if (! NILP (Vminibuffer_completing_file_name))
2233 {
2234 Lisp_Object substituted;
2235 substituted = Fsubstitute_in_file_name (tem);
2236 if (! EQ (substituted, tem))
2237 {
2238 tem = substituted;
2239 del_range (prompt_end_charpos, PT);
2240 Finsert (1, &tem);
2241 }
2242 }
2243 buffer_nchars = SCHARS (tem); /* # chars in what we completed. */
2244 completion_nchars = SCHARS (completion);
2245 i = buffer_nchars - completion_nchars;
2246 if (i > 0
2247 ||
2248 (tem1 = Fcompare_strings (tem, make_number (0),
2249 make_number (buffer_nchars),
2250 completion, make_number (0),
2251 make_number (buffer_nchars),
2252 completion_ignore_case ? Qt : Qnil),
2253 ! EQ (tem1, Qt)))
2254 {
2255 int start_pos;
2256
2257 /* Make buffer (before point) contain the longest match
2258 of TEM's tail and COMPLETION's head. */
2259 if (i <= 0) i = 1;
2260 start_pos= i;
2261 buffer_nchars -= i;
2262 while (i > 0)
2263 {
2264 tem1 = Fcompare_strings (tem, make_number (start_pos), Qnil,
2265 completion, make_number (0),
2266 make_number (buffer_nchars),
2267 completion_ignore_case ? Qt : Qnil);
2268 start_pos++;
2269 if (EQ (tem1, Qt))
2270 break;
2271 i++;
2272 buffer_nchars--;
2273 }
2274 del_range (start_pos, start_pos + buffer_nchars);
2275 }
2276 UNGCPRO;
2277 }
2278 #endif /* Rewritten code */
2279
2280 {
2281 int prompt_end_bytepos;
2282 prompt_end_bytepos = CHAR_TO_BYTE (prompt_end_charpos);
2283 i = PT - prompt_end_charpos;
2284 i_byte = PT_BYTE - prompt_end_bytepos;
2285 }
2286
2287 /* If completion finds next char not unique,
2288 consider adding a space or a hyphen. */
2289 if (i == SCHARS (completion))
2290 {
2291 GCPRO1 (completion);
2292 tem = Ftry_completion (concat2 (Fminibuffer_completion_contents (),
2293 build_string (" ")),
2294 Vminibuffer_completion_table,
2295 Vminibuffer_completion_predicate);
2296 UNGCPRO;
2297
2298 if (STRINGP (tem))
2299 completion = tem;
2300 else
2301 {
2302 GCPRO1 (completion);
2303 tem =
2304 Ftry_completion (concat2 (Fminibuffer_completion_contents (),
2305 build_string ("-")),
2306 Vminibuffer_completion_table,
2307 Vminibuffer_completion_predicate);
2308 UNGCPRO;
2309
2310 if (STRINGP (tem))
2311 completion = tem;
2312 }
2313 }
2314
2315 /* Now find first word-break in the stuff found by completion.
2316 i gets index in string of where to stop completing. */
2317 {
2318 int len, c;
2319 int bytes = SBYTES (completion);
2320 register const unsigned char *completion_string = SDATA (completion);
2321 for (; i_byte < SBYTES (completion); i_byte += len, i++)
2322 {
2323 c = STRING_CHAR_AND_LENGTH (completion_string + i_byte,
2324 bytes - i_byte,
2325 len);
2326 if (SYNTAX (c) != Sword)
2327 {
2328 i_byte += len;
2329 i++;
2330 break;
2331 }
2332 }
2333 }
2334
2335 /* If got no characters, print help for user. */
2336
2337 if (i == PT - prompt_end_charpos)
2338 {
2339 if (!NILP (Vcompletion_auto_help))
2340 Fminibuffer_completion_help ();
2341 return Qnil;
2342 }
2343
2344 /* Otherwise insert in minibuffer the chars we got */
2345
2346 if (! NILP (Vminibuffer_completing_file_name)
2347 && SREF (completion, SBYTES (completion) - 1) == '/'
2348 && PT < ZV
2349 && FETCH_CHAR (PT_BYTE) == '/')
2350 {
2351 del_range (prompt_end_charpos, PT + 1);
2352 }
2353 else
2354 del_range (prompt_end_charpos, PT);
2355
2356 insert_from_string (completion, 0, 0, i, i_byte, 1);
2357 return Qt;
2358 }
2359 \f
2360 DEFUN ("display-completion-list", Fdisplay_completion_list, Sdisplay_completion_list,
2361 1, 2, 0,
2362 doc: /* Display the list of completions, COMPLETIONS, using `standard-output'.
2363 Each element may be just a symbol or string
2364 or may be a list of two strings to be printed as if concatenated.
2365 If it is a list of two strings, the first is the actual completion
2366 alternative, the second serves as annotation.
2367 `standard-output' must be a buffer.
2368 The actual completion alternatives, as inserted, are given `mouse-face'
2369 properties of `highlight'.
2370 At the end, this runs the normal hook `completion-setup-hook'.
2371 It can find the completion buffer in `standard-output'.
2372 The optional second arg COMMON-SUBSTRING is a string.
2373 It is used to put faces, `completions-first-difference' and
2374 `completions-common-part' on the completion buffer. The
2375 `completions-common-part' face is put on the common substring
2376 specified by COMMON-SUBSTRING. If COMMON-SUBSTRING is nil
2377 and the current buffer is not the minibuffer, the faces are not put.
2378 Internally, COMMON-SUBSTRING is bound to `completion-common-substring'
2379 during running `completion-setup-hook'. */)
2380 (completions, common_substring)
2381 Lisp_Object completions;
2382 Lisp_Object common_substring;
2383 {
2384 Lisp_Object tail, elt;
2385 register int i;
2386 int column = 0;
2387 struct gcpro gcpro1, gcpro2, gcpro3;
2388 struct buffer *old = current_buffer;
2389 int first = 1;
2390
2391 /* Note that (when it matters) every variable
2392 points to a non-string that is pointed to by COMPLETIONS,
2393 except for ELT. ELT can be pointing to a string
2394 when terpri or Findent_to calls a change hook. */
2395 elt = Qnil;
2396 GCPRO3 (completions, elt, common_substring);
2397
2398 if (BUFFERP (Vstandard_output))
2399 set_buffer_internal (XBUFFER (Vstandard_output));
2400
2401 if (NILP (completions))
2402 write_string ("There are no possible completions of what you have typed.",
2403 -1);
2404 else
2405 {
2406 write_string ("Possible completions are:", -1);
2407 for (tail = completions, i = 0; CONSP (tail); tail = XCDR (tail), i++)
2408 {
2409 Lisp_Object tem, string;
2410 int length;
2411 Lisp_Object startpos, endpos;
2412
2413 startpos = Qnil;
2414
2415 elt = XCAR (tail);
2416 if (SYMBOLP (elt))
2417 elt = SYMBOL_NAME (elt);
2418 /* Compute the length of this element. */
2419 if (CONSP (elt))
2420 {
2421 tem = XCAR (elt);
2422 CHECK_STRING (tem);
2423 length = SCHARS (tem);
2424
2425 tem = Fcar (XCDR (elt));
2426 CHECK_STRING (tem);
2427 length += SCHARS (tem);
2428 }
2429 else
2430 {
2431 CHECK_STRING (elt);
2432 length = SCHARS (elt);
2433 }
2434
2435 /* This does a bad job for narrower than usual windows.
2436 Sadly, the window it will appear in is not known
2437 until after the text has been made. */
2438
2439 if (BUFFERP (Vstandard_output))
2440 XSETINT (startpos, BUF_PT (XBUFFER (Vstandard_output)));
2441
2442 /* If the previous completion was very wide,
2443 or we have two on this line already,
2444 don't put another on the same line. */
2445 if (column > 33 || first
2446 /* If this is really wide, don't put it second on a line. */
2447 || (column > 0 && length > 45))
2448 {
2449 Fterpri (Qnil);
2450 column = 0;
2451 }
2452 /* Otherwise advance to column 35. */
2453 else
2454 {
2455 if (BUFFERP (Vstandard_output))
2456 {
2457 tem = Findent_to (make_number (35), make_number (2));
2458
2459 column = XINT (tem);
2460 }
2461 else
2462 {
2463 do
2464 {
2465 write_string (" ", -1);
2466 column++;
2467 }
2468 while (column < 35);
2469 }
2470 }
2471
2472 if (BUFFERP (Vstandard_output))
2473 {
2474 XSETINT (endpos, BUF_PT (XBUFFER (Vstandard_output)));
2475 Fset_text_properties (startpos, endpos,
2476 Qnil, Vstandard_output);
2477 }
2478
2479 /* Output this element.
2480 If necessary, convert it to unibyte or to multibyte first. */
2481 if (CONSP (elt))
2482 string = Fcar (elt);
2483 else
2484 string = elt;
2485 if (NILP (current_buffer->enable_multibyte_characters)
2486 && STRING_MULTIBYTE (string))
2487 string = Fstring_make_unibyte (string);
2488 else if (!NILP (current_buffer->enable_multibyte_characters)
2489 && !STRING_MULTIBYTE (string))
2490 string = Fstring_make_multibyte (string);
2491
2492 if (BUFFERP (Vstandard_output))
2493 {
2494 XSETINT (startpos, BUF_PT (XBUFFER (Vstandard_output)));
2495
2496 Fprinc (string, Qnil);
2497
2498 XSETINT (endpos, BUF_PT (XBUFFER (Vstandard_output)));
2499
2500 Fput_text_property (startpos, endpos,
2501 Qmouse_face, intern ("highlight"),
2502 Vstandard_output);
2503 }
2504 else
2505 {
2506 Fprinc (string, Qnil);
2507 }
2508
2509 /* Output the annotation for this element. */
2510 if (CONSP (elt))
2511 {
2512 if (BUFFERP (Vstandard_output))
2513 {
2514 XSETINT (startpos, BUF_PT (XBUFFER (Vstandard_output)));
2515
2516 Fprinc (Fcar (Fcdr (elt)), Qnil);
2517
2518 XSETINT (endpos, BUF_PT (XBUFFER (Vstandard_output)));
2519
2520 Fset_text_properties (startpos, endpos, Qnil,
2521 Vstandard_output);
2522 }
2523 else
2524 {
2525 Fprinc (Fcar (Fcdr (elt)), Qnil);
2526 }
2527 }
2528
2529
2530 /* Update COLUMN for what we have output. */
2531 column += length;
2532
2533 /* If output is to a buffer, recompute COLUMN in a way
2534 that takes account of character widths. */
2535 if (BUFFERP (Vstandard_output))
2536 {
2537 tem = Fcurrent_column ();
2538 column = XINT (tem);
2539 }
2540
2541 first = 0;
2542 }
2543 }
2544
2545 if (BUFFERP (Vstandard_output))
2546 set_buffer_internal (old);
2547
2548 if (!NILP (Vrun_hooks))
2549 {
2550 int count1 = SPECPDL_INDEX ();
2551
2552 specbind (intern ("completion-common-substring"), common_substring);
2553 call1 (Vrun_hooks, intern ("completion-setup-hook"));
2554
2555 unbind_to (count1, Qnil);
2556 }
2557
2558 UNGCPRO;
2559
2560 return Qnil;
2561 }
2562
2563
2564 static Lisp_Object
2565 display_completion_list_1 (list)
2566 Lisp_Object list;
2567 {
2568 return Fdisplay_completion_list (list, Qnil);
2569 }
2570
2571 DEFUN ("minibuffer-completion-help", Fminibuffer_completion_help, Sminibuffer_completion_help,
2572 0, 0, "",
2573 doc: /* Display a list of possible completions of the current minibuffer contents. */)
2574 ()
2575 {
2576 Lisp_Object completions;
2577
2578 message ("Making completion list...");
2579 completions = Fall_completions (Fminibuffer_completion_contents (),
2580 Vminibuffer_completion_table,
2581 Vminibuffer_completion_predicate,
2582 Qt);
2583 clear_message (1, 0);
2584
2585 if (NILP (completions))
2586 {
2587 bitch_at_user ();
2588 temp_echo_area_glyphs (build_string (" [No completions]"));
2589 }
2590 else
2591 {
2592 /* Sort and remove duplicates. */
2593 Lisp_Object tmp = completions = Fsort (completions, Qstring_lessp);
2594 while (CONSP (tmp))
2595 {
2596 if (CONSP (XCDR (tmp))
2597 && !NILP (Fequal (XCAR (tmp), XCAR (XCDR (tmp)))))
2598 XSETCDR (tmp, XCDR (XCDR (tmp)));
2599 else
2600 tmp = XCDR (tmp);
2601 }
2602 internal_with_output_to_temp_buffer ("*Completions*",
2603 display_completion_list_1,
2604 completions);
2605 }
2606 return Qnil;
2607 }
2608 \f
2609 DEFUN ("self-insert-and-exit", Fself_insert_and_exit, Sself_insert_and_exit, 0, 0, "",
2610 doc: /* Terminate minibuffer input. */)
2611 ()
2612 {
2613 if (INTEGERP (last_command_char))
2614 internal_self_insert (XINT (last_command_char), 0);
2615 else
2616 bitch_at_user ();
2617
2618 return Fexit_minibuffer ();
2619 }
2620
2621 DEFUN ("exit-minibuffer", Fexit_minibuffer, Sexit_minibuffer, 0, 0, "",
2622 doc: /* Terminate this minibuffer argument. */)
2623 ()
2624 {
2625 /* If the command that uses this has made modifications in the minibuffer,
2626 we don't want them to cause deactivation of the mark in the original
2627 buffer.
2628 A better solution would be to make deactivate-mark buffer-local
2629 (or to turn it into a list of buffers, ...), but in the mean time,
2630 this should do the trick in most cases. */
2631 Vdeactivate_mark = Qnil;
2632 Fthrow (Qexit, Qnil);
2633 }
2634
2635 DEFUN ("minibuffer-depth", Fminibuffer_depth, Sminibuffer_depth, 0, 0, 0,
2636 doc: /* Return current depth of activations of minibuffer, a nonnegative integer. */)
2637 ()
2638 {
2639 return make_number (minibuf_level);
2640 }
2641
2642 DEFUN ("minibuffer-prompt", Fminibuffer_prompt, Sminibuffer_prompt, 0, 0, 0,
2643 doc: /* Return the prompt string of the currently-active minibuffer.
2644 If no minibuffer is active, return nil. */)
2645 ()
2646 {
2647 return Fcopy_sequence (minibuf_prompt);
2648 }
2649
2650 \f
2651 /* Temporarily display STRING at the end of the current
2652 minibuffer contents. This is used to display things like
2653 "[No Match]" when the user requests a completion for a prefix
2654 that has no possible completions, and other quick, unobtrusive
2655 messages. */
2656
2657 void
2658 temp_echo_area_glyphs (string)
2659 Lisp_Object string;
2660 {
2661 int osize = ZV;
2662 int osize_byte = ZV_BYTE;
2663 int opoint = PT;
2664 int opoint_byte = PT_BYTE;
2665 Lisp_Object oinhibit;
2666 oinhibit = Vinhibit_quit;
2667
2668 /* Clear out any old echo-area message to make way for our new thing. */
2669 message (0);
2670
2671 SET_PT_BOTH (osize, osize_byte);
2672 insert_from_string (string, 0, 0, SCHARS (string), SBYTES (string), 0);
2673 SET_PT_BOTH (opoint, opoint_byte);
2674 Vinhibit_quit = Qt;
2675 Fsit_for (make_number (2), Qnil, Qnil);
2676 del_range_both (osize, osize_byte, ZV, ZV_BYTE, 1);
2677 SET_PT_BOTH (opoint, opoint_byte);
2678 if (!NILP (Vquit_flag))
2679 {
2680 Vquit_flag = Qnil;
2681 Vunread_command_events = Fcons (make_number (quit_char), Qnil);
2682 }
2683 Vinhibit_quit = oinhibit;
2684 }
2685
2686 DEFUN ("minibuffer-message", Fminibuffer_message, Sminibuffer_message,
2687 1, 1, 0,
2688 doc: /* Temporarily display STRING at the end of the minibuffer.
2689 The text is displayed for a period controlled by `minibuffer-message-timeout',
2690 or until the next input event arrives, whichever comes first. */)
2691 (string)
2692 Lisp_Object string;
2693 {
2694 CHECK_STRING (string);
2695 temp_echo_area_glyphs (string);
2696 return Qnil;
2697 }
2698 \f
2699 void
2700 init_minibuf_once ()
2701 {
2702 Vminibuffer_list = Qnil;
2703 staticpro (&Vminibuffer_list);
2704 }
2705
2706 void
2707 syms_of_minibuf ()
2708 {
2709 minibuf_level = 0;
2710 minibuf_prompt = Qnil;
2711 staticpro (&minibuf_prompt);
2712
2713 minibuf_save_list = Qnil;
2714 staticpro (&minibuf_save_list);
2715
2716 Qread_file_name_internal = intern ("read-file-name-internal");
2717 staticpro (&Qread_file_name_internal);
2718
2719 Qminibuffer_default = intern ("minibuffer-default");
2720 staticpro (&Qminibuffer_default);
2721 Fset (Qminibuffer_default, Qnil);
2722
2723 Qminibuffer_completion_table = intern ("minibuffer-completion-table");
2724 staticpro (&Qminibuffer_completion_table);
2725
2726 Qminibuffer_completion_confirm = intern ("minibuffer-completion-confirm");
2727 staticpro (&Qminibuffer_completion_confirm);
2728
2729 Qminibuffer_completion_predicate = intern ("minibuffer-completion-predicate");
2730 staticpro (&Qminibuffer_completion_predicate);
2731
2732 staticpro (&last_exact_completion);
2733 last_exact_completion = Qnil;
2734
2735 staticpro (&last_minibuf_string);
2736 last_minibuf_string = Qnil;
2737
2738 Quser_variable_p = intern ("user-variable-p");
2739 staticpro (&Quser_variable_p);
2740
2741 Qminibuffer_history = intern ("minibuffer-history");
2742 staticpro (&Qminibuffer_history);
2743
2744 Qbuffer_name_history = intern ("buffer-name-history");
2745 staticpro (&Qbuffer_name_history);
2746 Fset (Qbuffer_name_history, Qnil);
2747
2748 Qminibuffer_setup_hook = intern ("minibuffer-setup-hook");
2749 staticpro (&Qminibuffer_setup_hook);
2750
2751 Qminibuffer_exit_hook = intern ("minibuffer-exit-hook");
2752 staticpro (&Qminibuffer_exit_hook);
2753
2754 Qhistory_length = intern ("history-length");
2755 staticpro (&Qhistory_length);
2756
2757 Qcurrent_input_method = intern ("current-input-method");
2758 staticpro (&Qcurrent_input_method);
2759
2760 Qactivate_input_method = intern ("activate-input-method");
2761 staticpro (&Qactivate_input_method);
2762
2763 Qcase_fold_search = intern ("case-fold-search");
2764 staticpro (&Qcase_fold_search);
2765
2766 DEFVAR_LISP ("read-buffer-function", &Vread_buffer_function,
2767 doc: /* If this is non-nil, `read-buffer' does its work by calling this function. */);
2768 Vread_buffer_function = Qnil;
2769
2770 DEFVAR_LISP ("minibuffer-setup-hook", &Vminibuffer_setup_hook,
2771 doc: /* Normal hook run just after entry to minibuffer. */);
2772 Vminibuffer_setup_hook = Qnil;
2773
2774 DEFVAR_LISP ("minibuffer-exit-hook", &Vminibuffer_exit_hook,
2775 doc: /* Normal hook run just after exit from minibuffer. */);
2776 Vminibuffer_exit_hook = Qnil;
2777
2778 DEFVAR_LISP ("history-length", &Vhistory_length,
2779 doc: /* *Maximum length for history lists before truncation takes place.
2780 A number means that length; t means infinite. Truncation takes place
2781 just after a new element is inserted. Setting the history-length
2782 property of a history variable overrides this default. */);
2783 XSETFASTINT (Vhistory_length, 30);
2784
2785 DEFVAR_BOOL ("history-delete-duplicates", &history_delete_duplicates,
2786 doc: /* *Non-nil means to delete duplicates in history.
2787 If set to t when adding a new history element, all previous identical
2788 elements are deleted. */);
2789 history_delete_duplicates = 0;
2790
2791 DEFVAR_LISP ("completion-auto-help", &Vcompletion_auto_help,
2792 doc: /* *Non-nil means automatically provide help for invalid completion input.
2793 Under Partial Completion mode, a non-nil, non-t value has a special meaning;
2794 see the doc string of `partial-completion-mode' for more details. */);
2795 Vcompletion_auto_help = Qt;
2796
2797 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case,
2798 doc: /* Non-nil means don't consider case significant in completion.
2799
2800 For file-name completion, the variable `read-file-name-completion-ignore-case'
2801 controls the behavior, rather than this variable. */);
2802 completion_ignore_case = 0;
2803
2804 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers,
2805 doc: /* *Non-nil means to allow minibuffer commands while in the minibuffer.
2806 This variable makes a difference whenever the minibuffer window is active. */);
2807 enable_recursive_minibuffers = 0;
2808
2809 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table,
2810 doc: /* Alist or obarray used for completion in the minibuffer.
2811 This becomes the ALIST argument to `try-completion' and `all-completions'.
2812 The value can also be a list of strings or a hash table.
2813
2814 The value may alternatively be a function, which is given three arguments:
2815 STRING, the current buffer contents;
2816 PREDICATE, the predicate for filtering possible matches;
2817 CODE, which says what kind of things to do.
2818 CODE can be nil, t or `lambda'.
2819 nil means to return the best completion of STRING, or nil if there is none.
2820 t means to return a list of all possible completions of STRING.
2821 `lambda' means to return t if STRING is a valid completion as it stands. */);
2822 Vminibuffer_completion_table = Qnil;
2823
2824 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate,
2825 doc: /* Within call to `completing-read', this holds the PREDICATE argument. */);
2826 Vminibuffer_completion_predicate = Qnil;
2827
2828 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm,
2829 doc: /* Non-nil means to demand confirmation of completion before exiting minibuffer. */);
2830 Vminibuffer_completion_confirm = Qnil;
2831
2832 DEFVAR_LISP ("minibuffer-completing-file-name",
2833 &Vminibuffer_completing_file_name,
2834 doc: /* Non-nil means completing file names. */);
2835 Vminibuffer_completing_file_name = Qnil;
2836
2837 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form,
2838 doc: /* Value that `help-form' takes on inside the minibuffer. */);
2839 Vminibuffer_help_form = Qnil;
2840
2841 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable,
2842 doc: /* History list symbol to add minibuffer values to.
2843 Each string of minibuffer input, as it appears on exit from the minibuffer,
2844 is added with
2845 (set minibuffer-history-variable
2846 (cons STRING (symbol-value minibuffer-history-variable))) */);
2847 XSETFASTINT (Vminibuffer_history_variable, 0);
2848
2849 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position,
2850 doc: /* Current position of redoing in the history list. */);
2851 Vminibuffer_history_position = Qnil;
2852
2853 DEFVAR_BOOL ("minibuffer-auto-raise", &minibuffer_auto_raise,
2854 doc: /* *Non-nil means entering the minibuffer raises the minibuffer's frame.
2855 Some uses of the echo area also raise that frame (since they use it too). */);
2856 minibuffer_auto_raise = 0;
2857
2858 DEFVAR_LISP ("completion-regexp-list", &Vcompletion_regexp_list,
2859 doc: /* List of regexps that should restrict possible completions.
2860 The basic completion functions only consider a completion acceptable
2861 if it matches all regular expressions in this list, with
2862 `case-fold-search' bound to the value of `completion-ignore-case'.
2863 See Info node `(elisp)Basic Completion', for a description of these
2864 functions. */);
2865 Vcompletion_regexp_list = Qnil;
2866
2867 DEFVAR_BOOL ("minibuffer-allow-text-properties",
2868 &minibuffer_allow_text_properties,
2869 doc: /* Non-nil means `read-from-minibuffer' should not discard text properties.
2870 This also affects `read-string', but it does not affect `read-minibuffer',
2871 `read-no-blanks-input', or any of the functions that do minibuffer input
2872 with completion; they always discard text properties. */);
2873 minibuffer_allow_text_properties = 0;
2874
2875 DEFVAR_LISP ("minibuffer-prompt-properties", &Vminibuffer_prompt_properties,
2876 doc: /* Text properties that are added to minibuffer prompts.
2877 These are in addition to the basic `field' property, and stickiness
2878 properties. */);
2879 /* We use `intern' here instead of Qread_only to avoid
2880 initialization-order problems. */
2881 Vminibuffer_prompt_properties
2882 = Fcons (intern ("read-only"), Fcons (Qt, Qnil));
2883
2884 defsubr (&Sset_minibuffer_window);
2885 defsubr (&Sread_from_minibuffer);
2886 defsubr (&Seval_minibuffer);
2887 defsubr (&Sread_minibuffer);
2888 defsubr (&Sread_string);
2889 defsubr (&Sread_command);
2890 defsubr (&Sread_variable);
2891 defsubr (&Sread_buffer);
2892 defsubr (&Sread_no_blanks_input);
2893 defsubr (&Sminibuffer_depth);
2894 defsubr (&Sminibuffer_prompt);
2895
2896 defsubr (&Sminibufferp);
2897 defsubr (&Sminibuffer_prompt_end);
2898 defsubr (&Sminibuffer_contents);
2899 defsubr (&Sminibuffer_contents_no_properties);
2900 defsubr (&Sminibuffer_completion_contents);
2901 defsubr (&Sdelete_minibuffer_contents);
2902
2903 defsubr (&Stry_completion);
2904 defsubr (&Sall_completions);
2905 defsubr (&Stest_completion);
2906 defsubr (&Sassoc_string);
2907 defsubr (&Scompleting_read);
2908 defsubr (&Sminibuffer_complete);
2909 defsubr (&Sminibuffer_complete_word);
2910 defsubr (&Sminibuffer_complete_and_exit);
2911 defsubr (&Sdisplay_completion_list);
2912 defsubr (&Sminibuffer_completion_help);
2913
2914 defsubr (&Sself_insert_and_exit);
2915 defsubr (&Sexit_minibuffer);
2916
2917 defsubr (&Sminibuffer_message);
2918 }
2919
2920 void
2921 keys_of_minibuf ()
2922 {
2923 initial_define_key (Vminibuffer_local_map, Ctl ('g'),
2924 "abort-recursive-edit");
2925 initial_define_key (Vminibuffer_local_map, Ctl ('m'),
2926 "exit-minibuffer");
2927 initial_define_key (Vminibuffer_local_map, Ctl ('j'),
2928 "exit-minibuffer");
2929
2930 initial_define_key (Vminibuffer_local_ns_map, ' ',
2931 "exit-minibuffer");
2932 initial_define_key (Vminibuffer_local_ns_map, '\t',
2933 "exit-minibuffer");
2934 initial_define_key (Vminibuffer_local_ns_map, '?',
2935 "self-insert-and-exit");
2936
2937 initial_define_key (Vminibuffer_local_completion_map, '\t',
2938 "minibuffer-complete");
2939 initial_define_key (Vminibuffer_local_completion_map, ' ',
2940 "minibuffer-complete-word");
2941 initial_define_key (Vminibuffer_local_completion_map, '?',
2942 "minibuffer-completion-help");
2943
2944 Fdefine_key (Vminibuffer_local_filename_completion_map,
2945 build_string (" "), Qnil);
2946
2947 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('m'),
2948 "minibuffer-complete-and-exit");
2949 initial_define_key (Vminibuffer_local_must_match_map, Ctl ('j'),
2950 "minibuffer-complete-and-exit");
2951
2952 Fdefine_key (Vminibuffer_local_must_match_filename_map,
2953 build_string (" "), Qnil);
2954 }
2955
2956 /* arch-tag: 8f69b601-fba3-484c-a6dd-ceaee54a7a73
2957 (do not change this comment) */