1 /* Minibuffer input and completion.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001, 2002, 2003, 2004, 2005,
4 2006, 2007 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs; see the file COPYING. If not, write to
20 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
31 #include "dispextern.h"
36 #include "intervals.h"
38 #include "termhooks.h"
42 /* List of buffers for use as minibuffers.
43 The first element of the list is used for the outermost minibuffer
44 invocation, the next element is used for a recursive minibuffer
45 invocation, etc. The list is extended at the end as deeper
46 minibuffer recursions are encountered. */
48 Lisp_Object Vminibuffer_list
;
50 /* Data to remember during recursive minibuffer invocations */
52 Lisp_Object minibuf_save_list
;
54 /* Depth in minibuffer invocations. */
58 /* Nonzero means display completion help for invalid input. */
60 Lisp_Object Vcompletion_auto_help
;
62 /* The maximum length of a minibuffer history. */
64 Lisp_Object Qhistory_length
, Vhistory_length
;
66 /* No duplicates in history. */
68 int history_delete_duplicates
;
70 /* Non-nil means add new input to history. */
72 Lisp_Object Vhistory_add_new_input
;
74 /* Fread_minibuffer leaves the input here as a string. */
76 Lisp_Object last_minibuf_string
;
78 /* Nonzero means let functions called when within a minibuffer
79 invoke recursive minibuffers (to read arguments, or whatever) */
81 int enable_recursive_minibuffers
;
83 /* Nonzero means don't ignore text properties
84 in Fread_from_minibuffer. */
86 int minibuffer_allow_text_properties
;
88 /* help-form is bound to this while in the minibuffer. */
90 Lisp_Object Vminibuffer_help_form
;
92 /* Variable which is the history list to add minibuffer values to. */
94 Lisp_Object Vminibuffer_history_variable
;
96 /* Current position in the history list (adjusted by M-n and M-p). */
98 Lisp_Object Vminibuffer_history_position
;
100 /* Text properties that are added to minibuffer prompts.
101 These are in addition to the basic `field' property, and stickiness
104 Lisp_Object Vminibuffer_prompt_properties
;
106 Lisp_Object Qminibuffer_history
, Qbuffer_name_history
;
108 Lisp_Object Qread_file_name_internal
;
110 /* Normal hooks for entry to and exit from minibuffer. */
112 Lisp_Object Qminibuffer_setup_hook
, Vminibuffer_setup_hook
;
113 Lisp_Object Qminibuffer_exit_hook
, Vminibuffer_exit_hook
;
115 /* Function to call to read a buffer name. */
116 Lisp_Object Vread_buffer_function
;
118 /* Nonzero means completion ignores case. */
120 int completion_ignore_case
;
122 /* List of regexps that should restrict possible completions. */
124 Lisp_Object Vcompletion_regexp_list
;
126 /* Nonzero means raise the minibuffer frame when the minibuffer
129 int minibuffer_auto_raise
;
131 /* If last completion attempt reported "Complete but not unique"
132 then this is the string completed then; otherwise this is nil. */
134 static Lisp_Object last_exact_completion
;
136 /* Keymap for reading expressions. */
137 Lisp_Object Vread_expression_map
;
139 Lisp_Object Vminibuffer_completion_table
, Qminibuffer_completion_table
;
140 Lisp_Object Vminibuffer_completion_predicate
, Qminibuffer_completion_predicate
;
141 Lisp_Object Vminibuffer_completion_confirm
, Qminibuffer_completion_confirm
;
142 Lisp_Object Vminibuffer_completing_file_name
;
144 Lisp_Object Quser_variable_p
;
146 Lisp_Object Qminibuffer_default
;
148 Lisp_Object Qcurrent_input_method
, Qactivate_input_method
;
150 Lisp_Object Qcase_fold_search
;
152 Lisp_Object Qread_expression_history
;
154 extern Lisp_Object Voverriding_local_map
;
156 extern Lisp_Object Qmouse_face
;
158 extern Lisp_Object Qfield
;
160 /* Put minibuf on currently selected frame's minibuffer.
161 We do this whenever the user starts a new minibuffer
162 or when a minibuffer exits. */
165 choose_minibuf_frame ()
167 if (FRAMEP (selected_frame
)
168 && FRAME_LIVE_P (XFRAME (selected_frame
))
169 && !EQ (minibuf_window
, XFRAME (selected_frame
)->minibuffer_window
))
171 struct frame
*sf
= XFRAME (selected_frame
);
174 /* I don't think that any frames may validly have a null minibuffer
176 if (NILP (sf
->minibuffer_window
))
179 /* Under X, we come here with minibuf_window being the
180 minibuffer window of the unused termcap window created in
181 init_window_once. That window doesn't have a buffer. */
182 buffer
= XWINDOW (minibuf_window
)->buffer
;
183 if (BUFFERP (buffer
))
184 Fset_window_buffer (sf
->minibuffer_window
, buffer
, Qnil
);
185 minibuf_window
= sf
->minibuffer_window
;
188 /* Make sure no other frame has a minibuffer as its selected window,
189 because the text would not be displayed in it, and that would be
190 confusing. Only allow the selected frame to do this,
191 and that only if the minibuffer is active. */
193 Lisp_Object tail
, frame
;
195 FOR_EACH_FRAME (tail
, frame
)
196 if (MINI_WINDOW_P (XWINDOW (FRAME_SELECTED_WINDOW (XFRAME (frame
))))
197 && !(EQ (frame
, selected_frame
)
198 && minibuf_level
> 0))
199 Fset_frame_selected_window (frame
, Fframe_first_window (frame
));
204 choose_minibuf_frame_1 (ignore
)
207 choose_minibuf_frame ();
211 DEFUN ("set-minibuffer-window", Fset_minibuffer_window
,
212 Sset_minibuffer_window
, 1, 1, 0,
213 doc
: /* Specify which minibuffer window to use for the minibuffer.
214 This affects where the minibuffer is displayed if you put text in it
215 without invoking the usual minibuffer commands. */)
219 CHECK_WINDOW (window
);
220 if (! MINI_WINDOW_P (XWINDOW (window
)))
221 error ("Window is not a minibuffer window");
223 minibuf_window
= window
;
229 /* Actual minibuffer invocation. */
231 static Lisp_Object read_minibuf_unwind
P_ ((Lisp_Object
));
232 static Lisp_Object run_exit_minibuf_hook
P_ ((Lisp_Object
));
233 static Lisp_Object read_minibuf
P_ ((Lisp_Object
, Lisp_Object
,
234 Lisp_Object
, Lisp_Object
,
236 Lisp_Object
, Lisp_Object
,
238 static Lisp_Object read_minibuf_noninteractive
P_ ((Lisp_Object
, Lisp_Object
,
239 Lisp_Object
, Lisp_Object
,
241 Lisp_Object
, Lisp_Object
,
243 static Lisp_Object string_to_object
P_ ((Lisp_Object
, Lisp_Object
));
246 /* Read a Lisp object from VAL and return it. If VAL is an empty
247 string, and DEFALT is a string, read from DEFALT instead of VAL. */
250 string_to_object (val
, defalt
)
251 Lisp_Object val
, defalt
;
253 struct gcpro gcpro1
, gcpro2
;
254 Lisp_Object expr_and_pos
;
257 GCPRO2 (val
, defalt
);
259 if (STRINGP (val
) && SCHARS (val
) == 0
263 expr_and_pos
= Fread_from_string (val
, Qnil
, Qnil
);
264 pos
= XINT (Fcdr (expr_and_pos
));
265 if (pos
!= SCHARS (val
))
267 /* Ignore trailing whitespace; any other trailing junk
270 pos
= string_char_to_byte (val
, pos
);
271 for (i
= pos
; i
< SBYTES (val
); i
++)
273 int c
= SREF (val
, i
);
274 if (c
!= ' ' && c
!= '\t' && c
!= '\n')
275 error ("Trailing garbage following expression");
279 val
= Fcar (expr_and_pos
);
280 RETURN_UNGCPRO (val
);
284 /* Like read_minibuf but reading from stdin. This function is called
285 from read_minibuf to do the job if noninteractive. */
288 read_minibuf_noninteractive (map
, initial
, prompt
, backup_n
, expflag
,
289 histvar
, histpos
, defalt
, allow_props
,
290 inherit_input_method
)
294 Lisp_Object backup_n
;
300 int inherit_input_method
;
306 fprintf (stdout
, "%s", SDATA (prompt
));
312 line
= (char *) xmalloc (size
* sizeof *line
);
313 while ((s
= fgets (line
+ len
, size
- len
, stdin
)) != NULL
314 && (len
= strlen (line
),
315 len
== size
- 1 && line
[len
- 1] != '\n'))
318 line
= (char *) xrealloc (line
, size
);
325 if (len
> 0 && line
[len
- 1] == '\n')
328 val
= build_string (line
);
334 error ("Error reading from stdin");
337 /* If Lisp form desired instead of string, parse it. */
339 val
= string_to_object (val
, defalt
);
344 DEFUN ("minibufferp", Fminibufferp
,
345 Sminibufferp
, 0, 1, 0,
346 doc
: /* Return t if BUFFER is a minibuffer.
347 No argument or nil as argument means use current buffer as BUFFER.
348 BUFFER can be a buffer or a buffer name. */)
355 buffer
= Fcurrent_buffer ();
356 else if (STRINGP (buffer
))
357 buffer
= Fget_buffer (buffer
);
359 CHECK_BUFFER (buffer
);
361 tem
= Fmemq (buffer
, Vminibuffer_list
);
362 return ! NILP (tem
) ? Qt
: Qnil
;
365 DEFUN ("minibuffer-prompt-end", Fminibuffer_prompt_end
,
366 Sminibuffer_prompt_end
, 0, 0, 0,
367 doc
: /* Return the buffer position of the end of the minibuffer prompt.
368 Return (point-min) if current buffer is not a minibuffer. */)
371 /* This function is written to be most efficient when there's a prompt. */
372 Lisp_Object beg
, end
, tem
;
373 beg
= make_number (BEGV
);
375 tem
= Fmemq (Fcurrent_buffer (), Vminibuffer_list
);
379 end
= Ffield_end (beg
, Qnil
, Qnil
);
381 if (XINT (end
) == ZV
&& NILP (Fget_char_property (beg
, Qfield
, Qnil
)))
387 DEFUN ("minibuffer-contents", Fminibuffer_contents
,
388 Sminibuffer_contents
, 0, 0, 0,
389 doc
: /* Return the user input in a minibuffer as a string.
390 The current buffer must be a minibuffer. */)
393 int prompt_end
= XINT (Fminibuffer_prompt_end ());
394 return make_buffer_string (prompt_end
, ZV
, 1);
397 DEFUN ("minibuffer-contents-no-properties", Fminibuffer_contents_no_properties
,
398 Sminibuffer_contents_no_properties
, 0, 0, 0,
399 doc
: /* Return the user input in a minibuffer as a string, without text-properties.
400 The current buffer must be a minibuffer. */)
403 int prompt_end
= XINT (Fminibuffer_prompt_end ());
404 return make_buffer_string (prompt_end
, ZV
, 0);
407 DEFUN ("minibuffer-completion-contents", Fminibuffer_completion_contents
,
408 Sminibuffer_completion_contents
, 0, 0, 0,
409 doc
: /* Return the user input in a minibuffer before point as a string.
410 That is what completion commands operate on.
411 The current buffer must be a minibuffer. */)
414 int prompt_end
= XINT (Fminibuffer_prompt_end ());
416 error ("Cannot do completion in the prompt");
417 return make_buffer_string (prompt_end
, PT
, 1);
420 DEFUN ("delete-minibuffer-contents", Fdelete_minibuffer_contents
,
421 Sdelete_minibuffer_contents
, 0, 0, 0,
422 doc
: /* Delete all user input in a minibuffer.
423 The current buffer must be a minibuffer. */)
426 int prompt_end
= XINT (Fminibuffer_prompt_end ());
428 del_range (prompt_end
, ZV
);
433 /* Read from the minibuffer using keymap MAP and initial contents INITIAL,
434 putting point minus BACKUP_N bytes from the end of INITIAL,
435 prompting with PROMPT (a string), using history list HISTVAR
436 with initial position HISTPOS. INITIAL should be a string or a
437 cons of a string and an integer. BACKUP_N should be <= 0, or
438 Qnil, which is equivalent to 0. If INITIAL is a cons, BACKUP_N is
439 ignored and replaced with an integer that puts point at one-indexed
440 position N in INITIAL, where N is the CDR of INITIAL, or at the
441 beginning of INITIAL if N <= 0.
443 Normally return the result as a string (the text that was read),
444 but if EXPFLAG is nonzero, read it and return the object read.
445 If HISTVAR is given, save the value read on that history only if it doesn't
446 match the front of that history list exactly. The value is pushed onto
447 the list as the string that was read.
449 DEFALT specifies the default value for the sake of history commands.
451 If ALLOW_PROPS is nonzero, we do not throw away text properties.
453 if INHERIT_INPUT_METHOD is nonzero, the minibuffer inherits the
454 current input method. */
457 read_minibuf (map
, initial
, prompt
, backup_n
, expflag
,
458 histvar
, histpos
, defalt
, allow_props
, inherit_input_method
)
462 Lisp_Object backup_n
;
468 int inherit_input_method
;
471 int count
= SPECPDL_INDEX ();
472 Lisp_Object mini_frame
, ambient_dir
, minibuffer
, input_method
;
473 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
474 Lisp_Object enable_multibyte
;
475 int pos
= INTEGERP (backup_n
) ? XINT (backup_n
) : 0;
476 /* String to add to the history. */
477 Lisp_Object histstring
;
479 Lisp_Object empty_minibuf
;
480 Lisp_Object dummy
, frame
;
482 extern Lisp_Object Qfront_sticky
;
483 extern Lisp_Object Qrear_nonsticky
;
485 specbind (Qminibuffer_default
, defalt
);
487 /* If Vminibuffer_completing_file_name is `lambda' on entry, it was t
488 in previous recursive minibuffer, but was not set explicitly
489 to t for this invocation, so set it to nil in this minibuffer.
490 Save the old value now, before we change it. */
491 specbind (intern ("minibuffer-completing-file-name"), Vminibuffer_completing_file_name
);
492 if (EQ (Vminibuffer_completing_file_name
, Qlambda
))
493 Vminibuffer_completing_file_name
= Qnil
;
495 #ifdef HAVE_X_WINDOWS
496 if (display_hourglass_p
)
504 backup_n
= Fcdr (initial
);
505 initial
= Fcar (initial
);
506 CHECK_STRING (initial
);
507 if (!NILP (backup_n
))
509 CHECK_NUMBER (backup_n
);
510 /* Convert to distance from end of input. */
511 if (XINT (backup_n
) < 1)
512 /* A number too small means the beginning of the string. */
513 pos
= - SCHARS (initial
);
515 pos
= XINT (backup_n
) - 1 - SCHARS (initial
);
519 CHECK_STRING (initial
);
522 ambient_dir
= current_buffer
->directory
;
524 enable_multibyte
= Qnil
;
526 /* Don't need to protect PROMPT, HISTVAR, and HISTPOS because we
527 store them away before we can GC. Don't need to protect
528 BACKUP_N because we use the value only if it is an integer. */
529 GCPRO5 (map
, initial
, val
, ambient_dir
, input_method
);
531 if (!STRINGP (prompt
))
532 prompt
= empty_string
;
534 if (!enable_recursive_minibuffers
535 && minibuf_level
> 0)
537 if (EQ (selected_window
, minibuf_window
))
538 error ("Command attempted to use minibuffer while in minibuffer");
540 /* If we're in another window, cancel the minibuffer that's active. */
542 build_string ("Command attempted to use minibuffer while in minibuffer"));
545 if (noninteractive
&& NILP (Vexecuting_kbd_macro
))
547 val
= read_minibuf_noninteractive (map
, initial
, prompt
,
549 expflag
, histvar
, histpos
, defalt
,
550 allow_props
, inherit_input_method
);
552 return unbind_to (count
, val
);
555 /* Choose the minibuffer window and frame, and take action on them. */
557 choose_minibuf_frame ();
559 record_unwind_protect (choose_minibuf_frame_1
, Qnil
);
561 record_unwind_protect (Fset_window_configuration
,
562 Fcurrent_window_configuration (Qnil
));
564 /* If the minibuffer window is on a different frame, save that
565 frame's configuration too. */
566 mini_frame
= WINDOW_FRAME (XWINDOW (minibuf_window
));
567 if (!EQ (mini_frame
, selected_frame
))
568 record_unwind_protect (Fset_window_configuration
,
569 Fcurrent_window_configuration (mini_frame
));
571 /* If the minibuffer is on an iconified or invisible frame,
572 make it visible now. */
573 Fmake_frame_visible (mini_frame
);
575 if (minibuffer_auto_raise
)
576 Fraise_frame (mini_frame
);
578 temporarily_switch_to_single_kboard (XFRAME (mini_frame
));
580 /* We have to do this after saving the window configuration
581 since that is what restores the current buffer. */
583 /* Arrange to restore a number of minibuffer-related variables.
584 We could bind each variable separately, but that would use lots of
587 = Fcons (Voverriding_local_map
,
588 Fcons (minibuf_window
,
591 = Fcons (minibuf_prompt
,
592 Fcons (make_number (minibuf_prompt_width
),
594 Fcons (Vcurrent_prefix_arg
,
595 Fcons (Vminibuffer_history_position
,
596 Fcons (Vminibuffer_history_variable
,
597 minibuf_save_list
))))));
599 record_unwind_protect (read_minibuf_unwind
, Qnil
);
601 /* We are exiting the minibuffer one way or the other, so run the hook.
602 It should be run before unwinding the minibuf settings. Do it
603 separately from read_minibuf_unwind because we need to make sure that
604 read_minibuf_unwind is fully executed even if exit-minibuffer-hook
605 signals an error. --Stef */
606 record_unwind_protect (run_exit_minibuf_hook
, Qnil
);
608 /* Now that we can restore all those variables, start changing them. */
610 minibuf_prompt_width
= 0;
611 minibuf_prompt
= Fcopy_sequence (prompt
);
612 Vminibuffer_history_position
= histpos
;
613 Vminibuffer_history_variable
= histvar
;
614 Vhelp_form
= Vminibuffer_help_form
;
615 /* If this minibuffer is reading a file name, that doesn't mean
616 recursive ones are. But we cannot set it to nil, because
617 completion code still need to know the minibuffer is completing a
618 file name. So use `lambda' as intermediate value meaning
619 "t" in this minibuffer, but "nil" in next minibuffer. */
620 if (!NILP (Vminibuffer_completing_file_name
))
621 Vminibuffer_completing_file_name
= Qlambda
;
623 if (inherit_input_method
)
625 /* `current-input-method' is buffer local. So, remember it in
626 INPUT_METHOD before changing the current buffer. */
627 input_method
= Fsymbol_value (Qcurrent_input_method
);
628 enable_multibyte
= current_buffer
->enable_multibyte_characters
;
631 /* Switch to the minibuffer. */
633 minibuffer
= get_minibuffer (minibuf_level
);
634 Fset_buffer (minibuffer
);
636 /* If appropriate, copy enable-multibyte-characters into the minibuffer. */
637 if (inherit_input_method
)
638 current_buffer
->enable_multibyte_characters
= enable_multibyte
;
640 /* The current buffer's default directory is usually the right thing
641 for our minibuffer here. However, if you're typing a command at
642 a minibuffer-only frame when minibuf_level is zero, then buf IS
643 the current_buffer, so reset_buffer leaves buf's default
644 directory unchanged. This is a bummer when you've just started
645 up Emacs and buf's default directory is Qnil. Here's a hack; can
646 you think of something better to do? Find another buffer with a
647 better directory, and use that one instead. */
648 if (STRINGP (ambient_dir
))
649 current_buffer
->directory
= ambient_dir
;
652 Lisp_Object buf_list
;
654 for (buf_list
= Vbuffer_alist
;
656 buf_list
= XCDR (buf_list
))
658 Lisp_Object other_buf
;
660 other_buf
= XCDR (XCAR (buf_list
));
661 if (STRINGP (XBUFFER (other_buf
)->directory
))
663 current_buffer
->directory
= XBUFFER (other_buf
)->directory
;
669 if (!EQ (mini_frame
, selected_frame
))
670 Fredirect_frame_focus (selected_frame
, mini_frame
);
672 Vminibuf_scroll_window
= selected_window
;
673 if (minibuf_level
== 1 || !EQ (minibuf_window
, selected_window
))
674 minibuf_selected_window
= selected_window
;
676 /* Empty out the minibuffers of all frames other than the one
677 where we are going to display one now.
678 Set them to point to ` *Minibuf-0*', which is always empty. */
679 empty_minibuf
= Fget_buffer (build_string (" *Minibuf-0*"));
681 FOR_EACH_FRAME (dummy
, frame
)
683 Lisp_Object root_window
= Fframe_root_window (frame
);
684 Lisp_Object mini_window
= XWINDOW (root_window
)->next
;
686 if (! NILP (mini_window
) && ! EQ (mini_window
, minibuf_window
)
687 && !NILP (Fwindow_minibuffer_p (mini_window
)))
688 Fset_window_buffer (mini_window
, empty_minibuf
, Qnil
);
691 /* Display this minibuffer in the proper window. */
692 Fset_window_buffer (minibuf_window
, Fcurrent_buffer (), Qnil
);
693 Fselect_window (minibuf_window
, Qnil
);
694 XSETFASTINT (XWINDOW (minibuf_window
)->hscroll
, 0);
696 Fmake_local_variable (Qprint_escape_newlines
);
697 print_escape_newlines
= 1;
699 /* Erase the buffer. */
701 int count1
= SPECPDL_INDEX ();
702 specbind (Qinhibit_read_only
, Qt
);
703 specbind (Qinhibit_modification_hooks
, Qt
);
705 unbind_to (count1
, Qnil
);
708 if (!NILP (current_buffer
->enable_multibyte_characters
)
709 && ! STRING_MULTIBYTE (minibuf_prompt
))
710 minibuf_prompt
= Fstring_make_multibyte (minibuf_prompt
);
712 /* Insert the prompt, record where it ends. */
713 Finsert (1, &minibuf_prompt
);
716 Fput_text_property (make_number (BEG
), make_number (PT
),
717 Qfront_sticky
, Qt
, Qnil
);
718 Fput_text_property (make_number (BEG
), make_number (PT
),
719 Qrear_nonsticky
, Qt
, Qnil
);
720 Fput_text_property (make_number (BEG
), make_number (PT
),
722 Fadd_text_properties (make_number (BEG
), make_number (PT
),
723 Vminibuffer_prompt_properties
, Qnil
);
726 minibuf_prompt_width
= (int) current_column (); /* iftc */
728 /* Put in the initial input. */
731 Finsert (1, &initial
);
732 Fforward_char (make_number (pos
));
735 clear_message (1, 1);
736 current_buffer
->keymap
= map
;
738 /* Turn on an input method stored in INPUT_METHOD if any. */
739 if (STRINGP (input_method
) && !NILP (Ffboundp (Qactivate_input_method
)))
740 call1 (Qactivate_input_method
, input_method
);
742 /* Run our hook, but not if it is empty.
743 (run-hooks would do nothing if it is empty,
744 but it's important to save time here in the usual case.) */
745 if (!NILP (Vminibuffer_setup_hook
) && !EQ (Vminibuffer_setup_hook
, Qunbound
)
746 && !NILP (Vrun_hooks
))
747 call1 (Vrun_hooks
, Qminibuffer_setup_hook
);
749 /* Don't allow the user to undo past this point. */
750 current_buffer
->undo_list
= Qnil
;
754 /* If cursor is on the minibuffer line,
755 show the user we have exited by putting it in column 0. */
756 if (XWINDOW (minibuf_window
)->cursor
.vpos
>= 0
759 XWINDOW (minibuf_window
)->cursor
.hpos
= 0;
760 XWINDOW (minibuf_window
)->cursor
.x
= 0;
761 XWINDOW (minibuf_window
)->must_be_updated_p
= 1;
762 update_frame (XFRAME (selected_frame
), 1, 1);
764 struct frame
*f
= XFRAME (XWINDOW (minibuf_window
)->frame
);
765 struct redisplay_interface
*rif
= FRAME_RIF (f
);
766 if (rif
&& rif
->flush_display
)
767 rif
->flush_display (f
);
771 /* Make minibuffer contents into a string. */
772 Fset_buffer (minibuffer
);
774 val
= Fminibuffer_contents ();
776 val
= Fminibuffer_contents_no_properties ();
778 /* VAL is the string of minibuffer text. */
780 last_minibuf_string
= val
;
782 /* Choose the string to add to the history. */
783 if (SCHARS (val
) != 0)
785 else if (STRINGP (defalt
))
790 /* Add the value to the appropriate history list, if any. */
791 if (!NILP (Vhistory_add_new_input
)
792 && SYMBOLP (Vminibuffer_history_variable
)
793 && !NILP (histstring
))
795 /* If the caller wanted to save the value read on a history list,
796 then do so if the value is not already the front of the list. */
799 /* If variable is unbound, make it nil. */
800 if (EQ (SYMBOL_VALUE (Vminibuffer_history_variable
), Qunbound
))
801 Fset (Vminibuffer_history_variable
, Qnil
);
803 histval
= Fsymbol_value (Vminibuffer_history_variable
);
805 /* The value of the history variable must be a cons or nil. Other
806 values are unacceptable. We silently ignore these values. */
810 /* Don't duplicate the most recent entry in the history. */
811 && (NILP (Fequal (histstring
, Fcar (histval
))))))
815 if (history_delete_duplicates
) Fdelete (histstring
, histval
);
816 histval
= Fcons (histstring
, histval
);
817 Fset (Vminibuffer_history_variable
, histval
);
819 /* Truncate if requested. */
820 length
= Fget (Vminibuffer_history_variable
, Qhistory_length
);
821 if (NILP (length
)) length
= Vhistory_length
;
822 if (INTEGERP (length
))
824 if (XINT (length
) <= 0)
825 Fset (Vminibuffer_history_variable
, Qnil
);
830 temp
= Fnthcdr (Fsub1 (length
), histval
);
831 if (CONSP (temp
)) Fsetcdr (temp
, Qnil
);
837 /* If Lisp form desired instead of string, parse it. */
839 val
= string_to_object (val
, defalt
);
841 /* The appropriate frame will get selected
842 in set-window-configuration. */
844 return unbind_to (count
, val
);
847 /* Return a buffer to be used as the minibuffer at depth `depth'.
848 depth = 0 is the lowest allowed argument, and that is the value
849 used for nonrecursive minibuffer invocations */
852 get_minibuffer (depth
)
855 Lisp_Object tail
, num
, buf
;
857 extern Lisp_Object
nconc2 ();
859 XSETFASTINT (num
, depth
);
860 tail
= Fnthcdr (num
, Vminibuffer_list
);
863 tail
= Fcons (Qnil
, Qnil
);
864 Vminibuffer_list
= nconc2 (Vminibuffer_list
, tail
);
867 if (NILP (buf
) || NILP (XBUFFER (buf
)->name
))
869 sprintf (name
, " *Minibuf-%d*", depth
);
870 buf
= Fget_buffer_create (build_string (name
));
872 /* Although the buffer's name starts with a space, undo should be
874 Fbuffer_enable_undo (buf
);
880 int count
= SPECPDL_INDEX ();
881 /* `reset_buffer' blindly sets the list of overlays to NULL, so we
882 have to empty the list, otherwise we end up with overlays that
883 think they belong to this buffer while the buffer doesn't know about
885 delete_all_overlays (XBUFFER (buf
));
886 reset_buffer (XBUFFER (buf
));
887 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
889 Fkill_all_local_variables ();
890 unbind_to (count
, Qnil
);
897 run_exit_minibuf_hook (data
)
900 if (!NILP (Vminibuffer_exit_hook
) && !EQ (Vminibuffer_exit_hook
, Qunbound
)
901 && !NILP (Vrun_hooks
))
902 safe_run_hooks (Qminibuffer_exit_hook
);
907 /* This function is called on exiting minibuffer, whether normally or
908 not, and it restores the current window, buffer, etc. */
911 read_minibuf_unwind (data
)
914 Lisp_Object old_deactivate_mark
;
917 /* If this was a recursive minibuffer,
918 tie the minibuffer window back to the outer level minibuffer buffer. */
921 window
= minibuf_window
;
922 /* To keep things predictable, in case it matters, let's be in the
923 minibuffer when we reset the relevant variables. */
924 Fset_buffer (XWINDOW (window
)->buffer
);
926 /* Restore prompt, etc, from outer minibuffer level. */
927 minibuf_prompt
= Fcar (minibuf_save_list
);
928 minibuf_save_list
= Fcdr (minibuf_save_list
);
929 minibuf_prompt_width
= XFASTINT (Fcar (minibuf_save_list
));
930 minibuf_save_list
= Fcdr (minibuf_save_list
);
931 Vhelp_form
= Fcar (minibuf_save_list
);
932 minibuf_save_list
= Fcdr (minibuf_save_list
);
933 Vcurrent_prefix_arg
= Fcar (minibuf_save_list
);
934 minibuf_save_list
= Fcdr (minibuf_save_list
);
935 Vminibuffer_history_position
= Fcar (minibuf_save_list
);
936 minibuf_save_list
= Fcdr (minibuf_save_list
);
937 Vminibuffer_history_variable
= Fcar (minibuf_save_list
);
938 minibuf_save_list
= Fcdr (minibuf_save_list
);
939 Voverriding_local_map
= Fcar (minibuf_save_list
);
940 minibuf_save_list
= Fcdr (minibuf_save_list
);
942 temp
= Fcar (minibuf_save_list
);
943 if (FRAME_LIVE_P (XFRAME (WINDOW_FRAME (XWINDOW (temp
)))))
944 minibuf_window
= temp
;
946 minibuf_save_list
= Fcdr (minibuf_save_list
);
948 /* Erase the minibuffer we were using at this level. */
950 int count
= SPECPDL_INDEX ();
951 /* Prevent error in erase-buffer. */
952 specbind (Qinhibit_read_only
, Qt
);
953 specbind (Qinhibit_modification_hooks
, Qt
);
954 old_deactivate_mark
= Vdeactivate_mark
;
956 Vdeactivate_mark
= old_deactivate_mark
;
957 unbind_to (count
, Qnil
);
960 /* When we get to the outmost level, make sure we resize the
961 mini-window back to its normal size. */
962 if (minibuf_level
== 0)
963 resize_mini_window (XWINDOW (window
), 0);
965 /* Make sure minibuffer window is erased, not ignored. */
966 windows_or_buffers_changed
++;
967 XSETFASTINT (XWINDOW (window
)->last_modified
, 0);
968 XSETFASTINT (XWINDOW (window
)->last_overlay_modified
, 0);
973 DEFUN ("read-from-minibuffer", Fread_from_minibuffer
, Sread_from_minibuffer
, 1, 7, 0,
974 doc
: /* Read a string from the minibuffer, prompting with string PROMPT.
975 The optional second arg INITIAL-CONTENTS is an obsolete alternative to
976 DEFAULT-VALUE. It normally should be nil in new code, except when
977 HIST is a cons. It is discussed in more detail below.
978 Third arg KEYMAP is a keymap to use whilst reading;
979 if omitted or nil, the default is `minibuffer-local-map'.
980 If fourth arg READ is non-nil, then interpret the result as a Lisp object
981 and return that object:
982 in other words, do `(car (read-from-string INPUT-STRING))'
983 Fifth arg HIST, if non-nil, specifies a history list and optionally
984 the initial position in the list. It can be a symbol, which is the
985 history list variable to use, or it can be a cons cell
986 (HISTVAR . HISTPOS). In that case, HISTVAR is the history list variable
987 to use, and HISTPOS is the initial position for use by the minibuffer
988 history commands. For consistency, you should also specify that
989 element of the history as the value of INITIAL-CONTENTS. Positions
990 are counted starting from 1 at the beginning of the list.
991 Sixth arg DEFAULT-VALUE is the default value. If non-nil, it is available
992 for history commands; but, unless READ is non-nil, `read-from-minibuffer'
993 does NOT return DEFAULT-VALUE if the user enters empty input! It returns
995 Seventh arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
996 the current input method and the setting of `enable-multibyte-characters'.
997 If the variable `minibuffer-allow-text-properties' is non-nil,
998 then the string which is returned includes whatever text properties
999 were present in the minibuffer. Otherwise the value has no text properties.
1001 The remainder of this documentation string describes the
1002 INITIAL-CONTENTS argument in more detail. It is only relevant when
1003 studying existing code, or when HIST is a cons. If non-nil,
1004 INITIAL-CONTENTS is a string to be inserted into the minibuffer before
1005 reading input. Normally, point is put at the end of that string.
1006 However, if INITIAL-CONTENTS is \(STRING . POSITION), the initial
1007 input is STRING, but point is placed at _one-indexed_ position
1008 POSITION in the minibuffer. Any integer value less than or equal to
1009 one puts point at the beginning of the string. *Note* that this
1010 behavior differs from the way such arguments are used in `completing-read'
1011 and some related functions, which use zero-indexing for POSITION. */)
1012 (prompt
, initial_contents
, keymap
, read
, hist
, default_value
, inherit_input_method
)
1013 Lisp_Object prompt
, initial_contents
, keymap
, read
, hist
, default_value
;
1014 Lisp_Object inherit_input_method
;
1016 Lisp_Object histvar
, histpos
, val
;
1017 struct gcpro gcpro1
;
1019 CHECK_STRING (prompt
);
1021 keymap
= Vminibuffer_local_map
;
1023 keymap
= get_keymap (keymap
, 1, 0);
1032 histvar
= Fcar_safe (hist
);
1033 histpos
= Fcdr_safe (hist
);
1036 histvar
= Qminibuffer_history
;
1038 XSETFASTINT (histpos
, 0);
1040 GCPRO1 (default_value
);
1041 val
= read_minibuf (keymap
, initial_contents
, prompt
,
1043 histvar
, histpos
, default_value
,
1044 minibuffer_allow_text_properties
,
1045 !NILP (inherit_input_method
));
1050 DEFUN ("read-minibuffer", Fread_minibuffer
, Sread_minibuffer
, 1, 2, 0,
1051 doc
: /* Return a Lisp object read using the minibuffer, unevaluated.
1052 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS
1053 is a string to insert in the minibuffer before reading.
1054 \(INITIAL-CONTENTS can also be a cons of a string and an integer. Such
1055 arguments are used as in `read-from-minibuffer'.) */)
1056 (prompt
, initial_contents
)
1057 Lisp_Object prompt
, initial_contents
;
1059 CHECK_STRING (prompt
);
1060 return read_minibuf (Vminibuffer_local_map
, initial_contents
,
1061 prompt
, Qnil
, 1, Qminibuffer_history
,
1062 make_number (0), Qnil
, 0, 0);
1065 DEFUN ("eval-minibuffer", Feval_minibuffer
, Seval_minibuffer
, 1, 2, 0,
1066 doc
: /* Return value of Lisp expression read using the minibuffer.
1067 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS
1068 is a string to insert in the minibuffer before reading.
1069 \(INITIAL-CONTENTS can also be a cons of a string and an integer. Such
1070 arguments are used as in `read-from-minibuffer'.) */)
1071 (prompt
, initial_contents
)
1072 Lisp_Object prompt
, initial_contents
;
1074 return Feval (read_minibuf (Vread_expression_map
, initial_contents
,
1075 prompt
, Qnil
, 1, Qread_expression_history
,
1076 make_number (0), Qnil
, 0, 0));
1079 /* Functions that use the minibuffer to read various things. */
1081 DEFUN ("read-string", Fread_string
, Sread_string
, 1, 5, 0,
1082 doc
: /* Read a string from the minibuffer, prompting with string PROMPT.
1083 If non-nil, second arg INITIAL-INPUT is a string to insert before reading.
1084 This argument has been superseded by DEFAULT-VALUE and should normally
1085 be nil in new code. It behaves as in `read-from-minibuffer'. See the
1086 documentation string of that function for details.
1087 The third arg HISTORY, if non-nil, specifies a history list
1088 and optionally the initial position in the list.
1089 See `read-from-minibuffer' for details of HISTORY argument.
1090 Fourth arg DEFAULT-VALUE is the default value. If non-nil, it is used
1091 for history commands, and as the value to return if the user enters
1093 Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
1094 the current input method and the setting of `enable-multibyte-characters'. */)
1095 (prompt
, initial_input
, history
, default_value
, inherit_input_method
)
1096 Lisp_Object prompt
, initial_input
, history
, default_value
;
1097 Lisp_Object inherit_input_method
;
1100 val
= Fread_from_minibuffer (prompt
, initial_input
, Qnil
,
1101 Qnil
, history
, default_value
,
1102 inherit_input_method
);
1103 if (STRINGP (val
) && SCHARS (val
) == 0 && ! NILP (default_value
))
1104 val
= default_value
;
1108 DEFUN ("read-no-blanks-input", Fread_no_blanks_input
, Sread_no_blanks_input
, 1, 3, 0,
1109 doc
: /* Read a string from the terminal, not allowing blanks.
1110 Prompt with PROMPT. Whitespace terminates the input. If INITIAL is
1111 non-nil, it should be a string, which is used as initial input, with
1112 point positioned at the end, so that SPACE will accept the input.
1113 \(Actually, INITIAL can also be a cons of a string and an integer.
1114 Such values are treated as in `read-from-minibuffer', but are normally
1115 not useful in this function.)
1116 Third arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits
1117 the current input method and the setting of`enable-multibyte-characters'. */)
1118 (prompt
, initial
, inherit_input_method
)
1119 Lisp_Object prompt
, initial
, inherit_input_method
;
1121 CHECK_STRING (prompt
);
1122 return read_minibuf (Vminibuffer_local_ns_map
, initial
, prompt
, Qnil
,
1123 0, Qminibuffer_history
, make_number (0), Qnil
, 0,
1124 !NILP (inherit_input_method
));
1127 DEFUN ("read-command", Fread_command
, Sread_command
, 1, 2, 0,
1128 doc
: /* Read the name of a command and return as a symbol.
1129 Prompt with PROMPT. By default, return DEFAULT-VALUE. */)
1130 (prompt
, default_value
)
1131 Lisp_Object prompt
, default_value
;
1133 Lisp_Object name
, default_string
;
1135 if (NILP (default_value
))
1136 default_string
= Qnil
;
1137 else if (SYMBOLP (default_value
))
1138 default_string
= SYMBOL_NAME (default_value
);
1140 default_string
= default_value
;
1142 name
= Fcompleting_read (prompt
, Vobarray
, Qcommandp
, Qt
,
1143 Qnil
, Qnil
, default_string
, Qnil
);
1146 return Fintern (name
, Qnil
);
1150 DEFUN ("read-function", Fread_function
, Sread_function
, 1, 1, 0,
1151 doc
: /* One arg PROMPT, a string. Read the name of a function and return as a symbol.
1152 Prompt with PROMPT. */)
1156 return Fintern (Fcompleting_read (prompt
, Vobarray
, Qfboundp
, Qt
, Qnil
, Qnil
, Qnil
, Qnil
),
1161 DEFUN ("read-variable", Fread_variable
, Sread_variable
, 1, 2, 0,
1162 doc
: /* Read the name of a user variable and return it as a symbol.
1163 Prompt with PROMPT. By default, return DEFAULT-VALUE.
1164 A user variable is one for which `user-variable-p' returns non-nil. */)
1165 (prompt
, default_value
)
1166 Lisp_Object prompt
, default_value
;
1168 Lisp_Object name
, default_string
;
1170 if (NILP (default_value
))
1171 default_string
= Qnil
;
1172 else if (SYMBOLP (default_value
))
1173 default_string
= SYMBOL_NAME (default_value
);
1175 default_string
= default_value
;
1177 name
= Fcompleting_read (prompt
, Vobarray
,
1178 Quser_variable_p
, Qt
,
1179 Qnil
, Qnil
, default_string
, Qnil
);
1182 return Fintern (name
, Qnil
);
1185 DEFUN ("read-buffer", Fread_buffer
, Sread_buffer
, 1, 3, 0,
1186 doc
: /* Read the name of a buffer and return as a string.
1188 Optional second arg DEF is value to return if user enters an empty line.
1189 If optional third arg REQUIRE-MATCH is non-nil,
1190 only existing buffer names are allowed.
1191 The argument PROMPT should be a string ending with a colon and a space. */)
1192 (prompt
, def
, require_match
)
1193 Lisp_Object prompt
, def
, require_match
;
1195 Lisp_Object args
[4];
1200 def
= XBUFFER (def
)->name
;
1202 if (NILP (Vread_buffer_function
))
1206 /* A default value was provided: we must change PROMPT,
1207 editing the default value in before the colon. To achieve
1208 this, we replace PROMPT with a substring that doesn't
1209 contain the terminal space and colon (if present). They
1210 are then added back using Fformat. */
1212 if (STRINGP (prompt
))
1216 if (len
>= 2 && s
[len
- 2] == ':' && s
[len
- 1] == ' ')
1218 else if (len
>= 1 && (s
[len
- 1] == ':' || s
[len
- 1] == ' '))
1221 prompt
= make_specified_string (s
, -1, len
,
1222 STRING_MULTIBYTE (prompt
));
1225 args
[0] = build_string ("%s (default %s): ");
1228 prompt
= Fformat (3, args
);
1231 return Fcompleting_read (prompt
, intern ("internal-complete-buffer"),
1232 Qnil
, require_match
, Qnil
, Qbuffer_name_history
,
1237 args
[0] = Vread_buffer_function
;
1240 args
[3] = require_match
;
1241 return Ffuncall(4, args
);
1246 minibuf_conform_representation (string
, basis
)
1247 Lisp_Object string
, basis
;
1249 if (STRING_MULTIBYTE (string
) == STRING_MULTIBYTE (basis
))
1252 if (STRING_MULTIBYTE (string
))
1253 return Fstring_make_unibyte (string
);
1255 return Fstring_make_multibyte (string
);
1258 DEFUN ("try-completion", Ftry_completion
, Stry_completion
, 2, 3, 0,
1259 doc
: /* Return common substring of all completions of STRING in COLLECTION.
1260 Test each possible completion specified by COLLECTION
1261 to see if it begins with STRING. The possible completions may be
1262 strings or symbols. Symbols are converted to strings before testing,
1264 All that match STRING are compared together; the longest initial sequence
1265 common to all these matches is the return value.
1266 If there is no match at all, the return value is nil.
1267 For a unique match which is exact, the return value is t.
1269 If COLLECTION is an alist, the keys (cars of elements) are the
1270 possible completions. If an element is not a cons cell, then the
1271 element itself is the possible completion.
1272 If COLLECTION is a hash-table, all the keys that are strings or symbols
1273 are the possible completions.
1274 If COLLECTION is an obarray, the names of all symbols in the obarray
1275 are the possible completions.
1277 COLLECTION can also be a function to do the completion itself.
1278 It receives three arguments: the values STRING, PREDICATE and nil.
1279 Whatever it returns becomes the value of `try-completion'.
1281 If optional third argument PREDICATE is non-nil,
1282 it is used to test each possible match.
1283 The match is a candidate only if PREDICATE returns non-nil.
1284 The argument given to PREDICATE is the alist element
1285 or the symbol from the obarray. If COLLECTION is a hash-table,
1286 predicate is called with two arguments: the key and the value.
1287 Additionally to this predicate, `completion-regexp-list'
1288 is used to further constrain the set of candidates. */)
1289 (string
, collection
, predicate
)
1290 Lisp_Object string
, collection
, predicate
;
1292 Lisp_Object bestmatch
, tail
, elt
, eltstring
;
1293 /* Size in bytes of BESTMATCH. */
1294 int bestmatchsize
= 0;
1295 /* These are in bytes, too. */
1296 int compare
, matchsize
;
1297 int type
= (HASH_TABLE_P (collection
) ? 3
1298 : VECTORP (collection
) ? 2
1299 : NILP (collection
) || (CONSP (collection
)
1300 && (!SYMBOLP (XCAR (collection
))
1301 || NILP (XCAR (collection
)))));
1302 int index
= 0, obsize
= 0;
1305 Lisp_Object bucket
, zero
, end
, tem
;
1306 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1308 CHECK_STRING (string
);
1310 return call3 (collection
, string
, predicate
, Qnil
);
1312 bestmatch
= bucket
= Qnil
;
1313 zero
= make_number (0);
1315 /* If COLLECTION is not a list, set TAIL just for gc pro. */
1319 collection
= check_obarray (collection
);
1320 obsize
= XVECTOR (collection
)->size
;
1321 bucket
= XVECTOR (collection
)->contents
[index
];
1326 /* Get the next element of the alist, obarray, or hash-table. */
1327 /* Exit the loop if the elements are all used up. */
1328 /* elt gets the alist element or symbol.
1329 eltstring gets the name to check as a completion. */
1336 eltstring
= CONSP (elt
) ? XCAR (elt
) : elt
;
1341 if (!EQ (bucket
, zero
))
1343 if (!SYMBOLP (bucket
))
1344 error ("Bad data in guts of obarray");
1347 if (XSYMBOL (bucket
)->next
)
1348 XSETSYMBOL (bucket
, XSYMBOL (bucket
)->next
);
1350 XSETFASTINT (bucket
, 0);
1352 else if (++index
>= obsize
)
1356 bucket
= XVECTOR (collection
)->contents
[index
];
1360 else /* if (type == 3) */
1362 while (index
< HASH_TABLE_SIZE (XHASH_TABLE (collection
))
1363 && NILP (HASH_HASH (XHASH_TABLE (collection
), index
)))
1365 if (index
>= HASH_TABLE_SIZE (XHASH_TABLE (collection
)))
1368 elt
= eltstring
= HASH_KEY (XHASH_TABLE (collection
), index
++);
1371 /* Is this element a possible completion? */
1373 if (SYMBOLP (eltstring
))
1374 eltstring
= Fsymbol_name (eltstring
);
1376 if (STRINGP (eltstring
)
1377 && SCHARS (string
) <= SCHARS (eltstring
)
1378 && (tem
= Fcompare_strings (eltstring
, zero
,
1379 make_number (SCHARS (string
)),
1381 completion_ignore_case
? Qt
: Qnil
),
1385 Lisp_Object regexps
;
1387 /* Ignore this element if it fails to match all the regexps. */
1389 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1390 regexps
= XCDR (regexps
))
1392 if (bindcount
< 0) {
1393 bindcount
= SPECPDL_INDEX ();
1394 specbind (Qcase_fold_search
,
1395 completion_ignore_case
? Qt
: Qnil
);
1397 tem
= Fstring_match (XCAR (regexps
), eltstring
, zero
);
1401 if (CONSP (regexps
))
1405 /* Ignore this element if there is a predicate
1406 and the predicate doesn't like it. */
1408 if (!NILP (predicate
))
1410 if (EQ (predicate
, Qcommandp
))
1411 tem
= Fcommandp (elt
, Qnil
);
1414 if (bindcount
>= 0) {
1415 unbind_to (bindcount
, Qnil
);
1418 GCPRO4 (tail
, string
, eltstring
, bestmatch
);
1420 ? call2 (predicate
, elt
,
1421 HASH_VALUE (XHASH_TABLE (collection
), index
- 1))
1422 : call1 (predicate
, elt
);
1425 if (NILP (tem
)) continue;
1428 /* Update computation of how much all possible completions match */
1430 if (NILP (bestmatch
))
1433 bestmatch
= eltstring
;
1434 bestmatchsize
= SCHARS (eltstring
);
1438 compare
= min (bestmatchsize
, SCHARS (eltstring
));
1439 tem
= Fcompare_strings (bestmatch
, zero
,
1440 make_number (compare
),
1442 make_number (compare
),
1443 completion_ignore_case
? Qt
: Qnil
);
1445 matchsize
= compare
;
1446 else if (XINT (tem
) < 0)
1447 matchsize
= - XINT (tem
) - 1;
1449 matchsize
= XINT (tem
) - 1;
1452 /* When can this happen ? -stef */
1453 matchsize
= compare
;
1454 if (completion_ignore_case
)
1456 /* If this is an exact match except for case,
1457 use it as the best match rather than one that is not an
1458 exact match. This way, we get the case pattern
1459 of the actual match. */
1460 if ((matchsize
== SCHARS (eltstring
)
1461 && matchsize
< SCHARS (bestmatch
))
1463 /* If there is more than one exact match ignoring case,
1464 and one of them is exact including case,
1466 /* If there is no exact match ignoring case,
1467 prefer a match that does not change the case
1469 ((matchsize
== SCHARS (eltstring
))
1471 (matchsize
== SCHARS (bestmatch
))
1472 && (tem
= Fcompare_strings (eltstring
, zero
,
1473 make_number (SCHARS (string
)),
1478 && (tem
= Fcompare_strings (bestmatch
, zero
,
1479 make_number (SCHARS (string
)),
1484 bestmatch
= eltstring
;
1486 if (bestmatchsize
!= SCHARS (eltstring
)
1487 || bestmatchsize
!= matchsize
)
1488 /* Don't count the same string multiple times. */
1490 bestmatchsize
= matchsize
;
1491 if (matchsize
<= SCHARS (string
)
1493 /* No need to look any further. */
1499 if (bindcount
>= 0) {
1500 unbind_to (bindcount
, Qnil
);
1504 if (NILP (bestmatch
))
1505 return Qnil
; /* No completions found */
1506 /* If we are ignoring case, and there is no exact match,
1507 and no additional text was supplied,
1508 don't change the case of what the user typed. */
1509 if (completion_ignore_case
&& bestmatchsize
== SCHARS (string
)
1510 && SCHARS (bestmatch
) > bestmatchsize
)
1511 return minibuf_conform_representation (string
, bestmatch
);
1513 /* Return t if the supplied string is an exact match (counting case);
1514 it does not require any change to be made. */
1515 if (matchcount
== 1 && bestmatchsize
== SCHARS (string
)
1516 && (tem
= Fcompare_strings (bestmatch
, make_number (0),
1517 make_number (bestmatchsize
),
1518 string
, make_number (0),
1519 make_number (bestmatchsize
),
1524 XSETFASTINT (zero
, 0); /* Else extract the part in which */
1525 XSETFASTINT (end
, bestmatchsize
); /* all completions agree */
1526 return Fsubstring (bestmatch
, zero
, end
);
1529 DEFUN ("all-completions", Fall_completions
, Sall_completions
, 2, 4, 0,
1530 doc
: /* Search for partial matches to STRING in COLLECTION.
1531 Test each of the possible completions specified by COLLECTION
1532 to see if it begins with STRING. The possible completions may be
1533 strings or symbols. Symbols are converted to strings before testing,
1535 The value is a list of all the possible completions that match STRING.
1537 If COLLECTION is an alist, the keys (cars of elements) are the
1538 possible completions. If an element is not a cons cell, then the
1539 element itself is the possible completion.
1540 If COLLECTION is a hash-table, all the keys that are strings or symbols
1541 are the possible completions.
1542 If COLLECTION is an obarray, the names of all symbols in the obarray
1543 are the possible completions.
1545 COLLECTION can also be a function to do the completion itself.
1546 It receives three arguments: the values STRING, PREDICATE and t.
1547 Whatever it returns becomes the value of `all-completions'.
1549 If optional third argument PREDICATE is non-nil,
1550 it is used to test each possible match.
1551 The match is a candidate only if PREDICATE returns non-nil.
1552 The argument given to PREDICATE is the alist element
1553 or the symbol from the obarray. If COLLECTION is a hash-table,
1554 predicate is called with two arguments: the key and the value.
1555 Additionally to this predicate, `completion-regexp-list'
1556 is used to further constrain the set of candidates.
1558 If the optional fourth argument HIDE-SPACES is non-nil,
1559 strings in COLLECTION that start with a space
1560 are ignored unless STRING itself starts with a space. */)
1561 (string
, collection
, predicate
, hide_spaces
)
1562 Lisp_Object string
, collection
, predicate
, hide_spaces
;
1564 Lisp_Object tail
, elt
, eltstring
;
1565 Lisp_Object allmatches
;
1566 int type
= HASH_TABLE_P (collection
) ? 3
1567 : VECTORP (collection
) ? 2
1568 : NILP (collection
) || (CONSP (collection
)
1569 && (!SYMBOLP (XCAR (collection
))
1570 || NILP (XCAR (collection
))));
1571 int index
= 0, obsize
= 0;
1573 Lisp_Object bucket
, tem
, zero
;
1574 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1576 CHECK_STRING (string
);
1578 return call3 (collection
, string
, predicate
, Qt
);
1579 allmatches
= bucket
= Qnil
;
1580 zero
= make_number (0);
1582 /* If COLLECTION is not a list, set TAIL just for gc pro. */
1586 obsize
= XVECTOR (collection
)->size
;
1587 bucket
= XVECTOR (collection
)->contents
[index
];
1592 /* Get the next element of the alist, obarray, or hash-table. */
1593 /* Exit the loop if the elements are all used up. */
1594 /* elt gets the alist element or symbol.
1595 eltstring gets the name to check as a completion. */
1602 eltstring
= CONSP (elt
) ? XCAR (elt
) : elt
;
1607 if (!EQ (bucket
, zero
))
1611 if (XSYMBOL (bucket
)->next
)
1612 XSETSYMBOL (bucket
, XSYMBOL (bucket
)->next
);
1614 XSETFASTINT (bucket
, 0);
1616 else if (++index
>= obsize
)
1620 bucket
= XVECTOR (collection
)->contents
[index
];
1624 else /* if (type == 3) */
1626 while (index
< HASH_TABLE_SIZE (XHASH_TABLE (collection
))
1627 && NILP (HASH_HASH (XHASH_TABLE (collection
), index
)))
1629 if (index
>= HASH_TABLE_SIZE (XHASH_TABLE (collection
)))
1632 elt
= eltstring
= HASH_KEY (XHASH_TABLE (collection
), index
++);
1635 /* Is this element a possible completion? */
1637 if (SYMBOLP (eltstring
))
1638 eltstring
= Fsymbol_name (eltstring
);
1640 if (STRINGP (eltstring
)
1641 && SCHARS (string
) <= SCHARS (eltstring
)
1642 /* If HIDE_SPACES, reject alternatives that start with space
1643 unless the input starts with space. */
1644 && ((SBYTES (string
) > 0
1645 && SREF (string
, 0) == ' ')
1646 || SREF (eltstring
, 0) != ' '
1647 || NILP (hide_spaces
))
1648 && (tem
= Fcompare_strings (eltstring
, zero
,
1649 make_number (SCHARS (string
)),
1651 make_number (SCHARS (string
)),
1652 completion_ignore_case
? Qt
: Qnil
),
1656 Lisp_Object regexps
;
1658 XSETFASTINT (zero
, 0);
1660 /* Ignore this element if it fails to match all the regexps. */
1662 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1663 regexps
= XCDR (regexps
))
1665 if (bindcount
< 0) {
1666 bindcount
= SPECPDL_INDEX ();
1667 specbind (Qcase_fold_search
,
1668 completion_ignore_case
? Qt
: Qnil
);
1670 tem
= Fstring_match (XCAR (regexps
), eltstring
, zero
);
1674 if (CONSP (regexps
))
1678 /* Ignore this element if there is a predicate
1679 and the predicate doesn't like it. */
1681 if (!NILP (predicate
))
1683 if (EQ (predicate
, Qcommandp
))
1684 tem
= Fcommandp (elt
, Qnil
);
1687 if (bindcount
>= 0) {
1688 unbind_to (bindcount
, Qnil
);
1691 GCPRO4 (tail
, eltstring
, allmatches
, string
);
1693 ? call2 (predicate
, elt
,
1694 HASH_VALUE (XHASH_TABLE (collection
), index
- 1))
1695 : call1 (predicate
, elt
);
1698 if (NILP (tem
)) continue;
1700 /* Ok => put it on the list. */
1701 allmatches
= Fcons (eltstring
, allmatches
);
1705 if (bindcount
>= 0) {
1706 unbind_to (bindcount
, Qnil
);
1710 return Fnreverse (allmatches
);
1713 DEFUN ("completing-read", Fcompleting_read
, Scompleting_read
, 2, 8, 0,
1714 doc
: /* Read a string in the minibuffer, with completion.
1715 PROMPT is a string to prompt with; normally it ends in a colon and a space.
1716 COLLECTION can be a list of strings, an alist, an obarray or a hash table.
1717 COLLECTION can also be a function to do the completion itself.
1718 PREDICATE limits completion to a subset of COLLECTION.
1719 See `try-completion' and `all-completions' for more details
1720 on completion, COLLECTION, and PREDICATE.
1722 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
1723 the input is (or completes to) an element of COLLECTION or is null.
1724 If it is also not t, typing RET does not exit if it does non-null completion.
1725 If the input is null, `completing-read' returns DEF, or an empty string
1726 if DEF is nil, regardless of the value of REQUIRE-MATCH.
1728 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially,
1729 with point positioned at the end.
1730 If it is (STRING . POSITION), the initial input is STRING, but point
1731 is placed at _zero-indexed_ position POSITION in STRING. (*Note*
1732 that this is different from `read-from-minibuffer' and related
1733 functions, which use one-indexing for POSITION.) This feature is
1734 deprecated--it is best to pass nil for INITIAL-INPUT and supply the
1735 default value DEF instead. The user can yank the default value into
1736 the minibuffer easily using \\[next-history-element].
1738 HIST, if non-nil, specifies a history list and optionally the initial
1739 position in the list. It can be a symbol, which is the history list
1740 variable to use, or it can be a cons cell (HISTVAR . HISTPOS). In
1741 that case, HISTVAR is the history list variable to use, and HISTPOS
1742 is the initial position (the position in the list used by the
1743 minibuffer history commands). For consistency, you should also
1744 specify that element of the history as the value of
1745 INITIAL-INPUT. (This is the only case in which you should use
1746 INITIAL-INPUT instead of DEF.) Positions are counted starting from
1747 1 at the beginning of the list. The variable `history-length'
1748 controls the maximum length of a history list.
1750 DEF, if non-nil, is the default value.
1752 If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits
1753 the current input method and the setting of `enable-multibyte-characters'.
1755 Completion ignores case if the ambient value of
1756 `completion-ignore-case' is non-nil. */)
1757 (prompt
, collection
, predicate
, require_match
, initial_input
, hist
, def
, inherit_input_method
)
1758 Lisp_Object prompt
, collection
, predicate
, require_match
, initial_input
;
1759 Lisp_Object hist
, def
, inherit_input_method
;
1761 Lisp_Object val
, histvar
, histpos
, position
;
1764 int count
= SPECPDL_INDEX ();
1765 struct gcpro gcpro1
;
1767 init
= initial_input
;
1770 specbind (Qminibuffer_completion_table
, collection
);
1771 specbind (Qminibuffer_completion_predicate
, predicate
);
1772 specbind (Qminibuffer_completion_confirm
,
1773 EQ (require_match
, Qt
) ? Qnil
: require_match
);
1774 last_exact_completion
= Qnil
;
1781 position
= Fcdr (init
);
1784 CHECK_STRING (init
);
1785 if (!NILP (position
))
1787 CHECK_NUMBER (position
);
1788 /* Convert to distance from end of input. */
1789 pos
= XINT (position
) - SCHARS (init
);
1800 histvar
= Fcar_safe (hist
);
1801 histpos
= Fcdr_safe (hist
);
1804 histvar
= Qminibuffer_history
;
1806 XSETFASTINT (histpos
, 0);
1808 val
= read_minibuf (NILP (require_match
)
1809 ? (NILP (Vminibuffer_completing_file_name
)
1810 || EQ (Vminibuffer_completing_file_name
, Qlambda
)
1811 ? Vminibuffer_local_completion_map
1812 : Vminibuffer_local_filename_completion_map
)
1813 : (NILP (Vminibuffer_completing_file_name
)
1814 || EQ (Vminibuffer_completing_file_name
, Qlambda
)
1815 ? Vminibuffer_local_must_match_map
1816 : Vminibuffer_local_must_match_filename_map
),
1817 init
, prompt
, make_number (pos
), 0,
1818 histvar
, histpos
, def
, 0,
1819 !NILP (inherit_input_method
));
1821 if (STRINGP (val
) && SCHARS (val
) == 0 && ! NILP (def
))
1824 RETURN_UNGCPRO (unbind_to (count
, val
));
1827 Lisp_Object
Fminibuffer_completion_help ();
1828 Lisp_Object
Fassoc_string ();
1830 /* Test whether TXT is an exact completion. */
1831 DEFUN ("test-completion", Ftest_completion
, Stest_completion
, 2, 3, 0,
1832 doc
: /* Return non-nil if STRING is a valid completion.
1833 Takes the same arguments as `all-completions' and `try-completion'.
1834 If COLLECTION is a function, it is called with three arguments:
1835 the values STRING, PREDICATE and `lambda'. */)
1836 (string
, collection
, predicate
)
1837 Lisp_Object string
, collection
, predicate
;
1839 Lisp_Object regexps
, tail
, tem
= Qnil
;
1842 CHECK_STRING (string
);
1844 if ((CONSP (collection
)
1845 && (!SYMBOLP (XCAR (collection
)) || NILP (XCAR (collection
))))
1846 || NILP (collection
))
1848 tem
= Fassoc_string (string
, collection
, completion_ignore_case
? Qt
: Qnil
);
1852 else if (VECTORP (collection
))
1854 /* Bypass intern-soft as that loses for nil. */
1855 tem
= oblookup (collection
,
1861 if (STRING_MULTIBYTE (string
))
1862 string
= Fstring_make_unibyte (string
);
1864 string
= Fstring_make_multibyte (string
);
1866 tem
= oblookup (collection
,
1872 if (completion_ignore_case
&& !SYMBOLP (tem
))
1874 for (i
= XVECTOR (collection
)->size
- 1; i
>= 0; i
--)
1876 tail
= XVECTOR (collection
)->contents
[i
];
1880 if (EQ((Fcompare_strings (string
, make_number (0), Qnil
,
1881 Fsymbol_name (tail
),
1882 make_number (0) , Qnil
, Qt
)),
1888 if (XSYMBOL (tail
)->next
== 0)
1890 XSETSYMBOL (tail
, XSYMBOL (tail
)->next
);
1898 else if (HASH_TABLE_P (collection
))
1900 struct Lisp_Hash_Table
*h
= XHASH_TABLE (collection
);
1901 i
= hash_lookup (h
, string
, NULL
);
1903 tem
= HASH_KEY (h
, i
);
1905 for (i
= 0; i
< HASH_TABLE_SIZE (h
); ++i
)
1906 if (!NILP (HASH_HASH (h
, i
)) &&
1907 EQ (Fcompare_strings (string
, make_number (0), Qnil
,
1908 HASH_KEY (h
, i
), make_number (0) , Qnil
,
1909 completion_ignore_case
? Qt
: Qnil
),
1912 tem
= HASH_KEY (h
, i
);
1919 return call3 (collection
, string
, predicate
, Qlambda
);
1921 /* Reject this element if it fails to match all the regexps. */
1922 if (CONSP (Vcompletion_regexp_list
))
1924 int count
= SPECPDL_INDEX ();
1925 specbind (Qcase_fold_search
, completion_ignore_case
? Qt
: Qnil
);
1926 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1927 regexps
= XCDR (regexps
))
1929 if (NILP (Fstring_match (XCAR (regexps
),
1930 SYMBOLP (tem
) ? string
: tem
,
1932 return unbind_to (count
, Qnil
);
1934 unbind_to (count
, Qnil
);
1937 /* Finally, check the predicate. */
1938 if (!NILP (predicate
))
1940 return HASH_TABLE_P (collection
)
1941 ? call2 (predicate
, tem
, HASH_VALUE (XHASH_TABLE (collection
), i
))
1942 : call1 (predicate
, tem
);
1948 DEFUN ("internal-complete-buffer", Finternal_complete_buffer
, Sinternal_complete_buffer
, 3, 3, 0,
1949 doc
: /* Perform completion on buffer names.
1950 If the argument FLAG is nil, invoke `try-completion', if it's t, invoke
1951 `all-completions', otherwise invoke `test-completion'.
1953 The arguments STRING and PREDICATE are as in `try-completion',
1954 `all-completions', and `test-completion'. */)
1955 (string
, predicate
, flag
)
1956 Lisp_Object string
, predicate
, flag
;
1959 return Ftry_completion (string
, Vbuffer_alist
, predicate
);
1960 else if (EQ (flag
, Qt
))
1961 return Fall_completions (string
, Vbuffer_alist
, predicate
, Qt
);
1962 else /* assume `lambda' */
1963 return Ftest_completion (string
, Vbuffer_alist
, predicate
);
1967 * 0 no possible completion
1968 * 1 was already an exact and unique completion
1969 * 3 was already an exact completion
1970 * 4 completed to an exact completion
1971 * 5 some completion happened
1972 * 6 no completion happened
1977 Lisp_Object completion
, string
, tem
;
1980 struct gcpro gcpro1
, gcpro2
;
1982 completion
= Ftry_completion (Fminibuffer_completion_contents (),
1983 Vminibuffer_completion_table
,
1984 Vminibuffer_completion_predicate
);
1985 last
= last_exact_completion
;
1986 last_exact_completion
= Qnil
;
1988 GCPRO2 (completion
, last
);
1990 if (NILP (completion
))
1993 temp_echo_area_glyphs (build_string (" [No match]"));
1998 if (EQ (completion
, Qt
)) /* exact and unique match */
2004 string
= Fminibuffer_completion_contents ();
2006 /* COMPLETEDP should be true if some completion was done, which
2007 doesn't include simply changing the case of the entered string.
2008 However, for appearance, the string is rewritten if the case
2010 tem
= Fcompare_strings (completion
, Qnil
, Qnil
, string
, Qnil
, Qnil
, Qt
);
2011 completedp
= !EQ (tem
, Qt
);
2013 tem
= Fcompare_strings (completion
, Qnil
, Qnil
, string
, Qnil
, Qnil
, Qnil
);
2015 /* Rewrite the user's input. */
2017 int prompt_end
= XINT (Fminibuffer_prompt_end ());
2018 /* Some completion happened */
2020 if (! NILP (Vminibuffer_completing_file_name
)
2021 && SREF (completion
, SBYTES (completion
) - 1) == '/'
2023 && FETCH_CHAR (PT_BYTE
) == '/')
2025 del_range (prompt_end
, PT
+ 1);
2028 del_range (prompt_end
, PT
);
2030 Finsert (1, &completion
);
2033 /* The case of the string changed, but that's all. We're not
2034 sure whether this is a unique completion or not, so try again
2035 using the real case (this shouldn't recurse again, because
2036 the next time try-completion will return either `t' or the
2040 return do_completion ();
2044 /* It did find a match. Do we match some possibility exactly now? */
2045 tem
= Ftest_completion (Fminibuffer_contents (),
2046 Vminibuffer_completion_table
,
2047 Vminibuffer_completion_predicate
);
2050 /* not an exact match */
2054 else if (!NILP (Vcompletion_auto_help
))
2055 Fminibuffer_completion_help ();
2057 temp_echo_area_glyphs (build_string (" [Next char not unique]"));
2060 else if (completedp
)
2065 /* If the last exact completion and this one were the same,
2066 it means we've already given a "Complete but not unique"
2067 message and the user's hit TAB again, so now we give him help. */
2068 last_exact_completion
= completion
;
2071 tem
= Fminibuffer_completion_contents ();
2072 if (!NILP (Fequal (tem
, last
)))
2073 Fminibuffer_completion_help ();
2079 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */
2081 DEFUN ("assoc-string", Fassoc_string
, Sassoc_string
, 2, 3, 0,
2082 doc
: /* Like `assoc' but specifically for strings (and symbols).
2083 Symbols are converted to strings, and unibyte strings are converted to
2084 multibyte for comparison.
2085 Case is ignored if optional arg CASE-FOLD is non-nil.
2086 As opposed to `assoc', it will also match an entry consisting of a single
2087 string rather than a cons cell whose car is a string. */)
2088 (key
, list
, case_fold
)
2089 register Lisp_Object key
;
2090 Lisp_Object list
, case_fold
;
2092 register Lisp_Object tail
;
2095 key
= Fsymbol_name (key
);
2097 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
2099 register Lisp_Object elt
, tem
, thiscar
;
2101 thiscar
= CONSP (elt
) ? XCAR (elt
) : elt
;
2102 if (SYMBOLP (thiscar
))
2103 thiscar
= Fsymbol_name (thiscar
);
2104 else if (!STRINGP (thiscar
))
2106 tem
= Fcompare_strings (thiscar
, make_number (0), Qnil
,
2107 key
, make_number (0), Qnil
,
2116 DEFUN ("minibuffer-complete", Fminibuffer_complete
, Sminibuffer_complete
, 0, 0, "",
2117 doc
: /* Complete the minibuffer contents as far as possible.
2118 Return nil if there is no valid completion, else t.
2119 If no characters can be completed, display a list of possible completions.
2120 If you repeat this command after it displayed such a list,
2121 scroll the window of possible completions. */)
2125 Lisp_Object window
, tem
;
2127 /* If the previous command was not this,
2128 mark the completion buffer obsolete. */
2129 if (! EQ (current_kboard
->Vlast_command
, Vthis_command
))
2130 Vminibuf_scroll_window
= Qnil
;
2132 window
= Vminibuf_scroll_window
;
2133 /* If there's a fresh completion window with a live buffer,
2134 and this command is repeated, scroll that window. */
2135 if (! NILP (window
) && ! NILP (XWINDOW (window
)->buffer
)
2136 && !NILP (XBUFFER (XWINDOW (window
)->buffer
)->name
))
2138 struct buffer
*obuf
= current_buffer
;
2140 Fset_buffer (XWINDOW (window
)->buffer
);
2141 tem
= Fpos_visible_in_window_p (make_number (ZV
), window
, Qnil
);
2143 /* If end is in view, scroll up to the beginning. */
2144 Fset_window_start (window
, make_number (BEGV
), Qnil
);
2146 /* Else scroll down one screen. */
2147 Fscroll_other_window (Qnil
);
2149 set_buffer_internal (obuf
);
2153 i
= do_completion ();
2161 Fgoto_char (make_number (ZV
));
2162 temp_echo_area_glyphs (build_string (" [Sole completion]"));
2167 Fgoto_char (make_number (ZV
));
2168 temp_echo_area_glyphs (build_string (" [Complete, but not unique]"));
2175 /* Subroutines of Fminibuffer_complete_and_exit. */
2177 /* This one is called by internal_condition_case to do the real work. */
2180 complete_and_exit_1 ()
2182 return make_number (do_completion ());
2185 /* This one is called by internal_condition_case if an error happens.
2186 Pretend the current value is an exact match. */
2189 complete_and_exit_2 (ignore
)
2192 return make_number (1);
2195 EXFUN (Fexit_minibuffer
, 0) NO_RETURN
;
2197 DEFUN ("minibuffer-complete-and-exit", Fminibuffer_complete_and_exit
,
2198 Sminibuffer_complete_and_exit
, 0, 0, "",
2199 doc
: /* If the minibuffer contents is a valid completion then exit.
2200 Otherwise try to complete it. If completion leads to a valid completion,
2201 a repetition of this command will exit. */)
2205 Lisp_Object val
, tem
;
2207 /* Allow user to specify null string */
2208 if (XINT (Fminibuffer_prompt_end ()) == ZV
)
2211 val
= Fminibuffer_contents ();
2212 tem
= Ftest_completion (val
,
2213 Vminibuffer_completion_table
,
2214 Vminibuffer_completion_predicate
);
2217 if (completion_ignore_case
)
2218 { /* Fixup case of the field, if necessary. */
2220 = Ftry_completion (val
,
2221 Vminibuffer_completion_table
,
2222 Vminibuffer_completion_predicate
);
2224 /* If it weren't for this piece of paranoia, I'd replace
2225 the whole thing with a call to do_completion. */
2226 && EQ (Flength (val
), Flength (compl)))
2228 del_range (XINT (Fminibuffer_prompt_end ()), ZV
);
2229 Finsert (1, &compl);
2235 /* Call do_completion, but ignore errors. */
2237 val
= internal_condition_case (complete_and_exit_1
, Qerror
,
2238 complete_and_exit_2
);
2248 if (!NILP (Vminibuffer_completion_confirm
))
2250 temp_echo_area_glyphs (build_string (" [Confirm]"));
2260 return Fexit_minibuffer ();
2264 DEFUN ("minibuffer-complete-word", Fminibuffer_complete_word
, Sminibuffer_complete_word
,
2266 doc
: /* Complete the minibuffer contents at most a single word.
2267 After one word is completed as much as possible, a space or hyphen
2268 is added, provided that matches some possible completion.
2269 Return nil if there is no valid completion, else t. */)
2272 Lisp_Object completion
, tem
, tem1
;
2273 register int i
, i_byte
;
2274 struct gcpro gcpro1
, gcpro2
;
2275 int prompt_end_charpos
= XINT (Fminibuffer_prompt_end ());
2277 /* We keep calling Fbuffer_string rather than arrange for GC to
2278 hold onto a pointer to one of the strings thus made. */
2280 completion
= Ftry_completion (Fminibuffer_completion_contents (),
2281 Vminibuffer_completion_table
,
2282 Vminibuffer_completion_predicate
);
2283 if (NILP (completion
))
2286 temp_echo_area_glyphs (build_string (" [No match]"));
2289 if (EQ (completion
, Qt
))
2292 #if 0 /* How the below code used to look, for reference. */
2293 tem
= Fminibuffer_contents ();
2295 i
= ZV
- 1 - SCHARS (completion
);
2296 p
= SDATA (completion
);
2298 0 <= scmp (b
, p
, ZV
- 1))
2301 /* Set buffer to longest match of buffer tail and completion head. */
2302 while (0 <= scmp (b
+ i
, p
, ZV
- 1 - i
))
2304 del_range (1, i
+ 1);
2307 #else /* Rewritten code */
2309 int buffer_nchars
, completion_nchars
;
2311 CHECK_STRING (completion
);
2312 tem
= Fminibuffer_completion_contents ();
2313 GCPRO2 (completion
, tem
);
2314 /* If reading a file name,
2315 expand any $ENVVAR refs in the buffer and in TEM. */
2316 if (! NILP (Vminibuffer_completing_file_name
))
2318 Lisp_Object substituted
;
2319 substituted
= Fsubstitute_in_file_name (tem
);
2320 if (! EQ (substituted
, tem
))
2323 del_range (prompt_end_charpos
, PT
);
2327 buffer_nchars
= SCHARS (tem
); /* # chars in what we completed. */
2328 completion_nchars
= SCHARS (completion
);
2329 i
= buffer_nchars
- completion_nchars
;
2332 (tem1
= Fcompare_strings (tem
, make_number (0),
2333 make_number (buffer_nchars
),
2334 completion
, make_number (0),
2335 make_number (buffer_nchars
),
2336 completion_ignore_case
? Qt
: Qnil
),
2341 /* Make buffer (before point) contain the longest match
2342 of TEM's tail and COMPLETION's head. */
2348 tem1
= Fcompare_strings (tem
, make_number (start_pos
), Qnil
,
2349 completion
, make_number (0),
2350 make_number (buffer_nchars
),
2351 completion_ignore_case
? Qt
: Qnil
);
2358 del_range (start_pos
, start_pos
+ buffer_nchars
);
2362 #endif /* Rewritten code */
2365 int prompt_end_bytepos
;
2366 prompt_end_bytepos
= CHAR_TO_BYTE (prompt_end_charpos
);
2367 i
= PT
- prompt_end_charpos
;
2368 i_byte
= PT_BYTE
- prompt_end_bytepos
;
2371 /* If completion finds next char not unique,
2372 consider adding a space or a hyphen. */
2373 if (i
== SCHARS (completion
))
2375 GCPRO1 (completion
);
2376 tem
= Ftry_completion (concat2 (Fminibuffer_completion_contents (),
2377 build_string (" ")),
2378 Vminibuffer_completion_table
,
2379 Vminibuffer_completion_predicate
);
2386 GCPRO1 (completion
);
2388 Ftry_completion (concat2 (Fminibuffer_completion_contents (),
2389 build_string ("-")),
2390 Vminibuffer_completion_table
,
2391 Vminibuffer_completion_predicate
);
2399 /* Now find first word-break in the stuff found by completion.
2400 i gets index in string of where to stop completing. */
2403 int bytes
= SBYTES (completion
);
2404 register const unsigned char *completion_string
= SDATA (completion
);
2405 for (; i_byte
< SBYTES (completion
); i_byte
+= len
, i
++)
2407 c
= STRING_CHAR_AND_LENGTH (completion_string
+ i_byte
,
2410 if (SYNTAX (c
) != Sword
)
2419 /* If got no characters, print help for user. */
2421 if (i
== PT
- prompt_end_charpos
)
2423 if (!NILP (Vcompletion_auto_help
))
2424 Fminibuffer_completion_help ();
2428 /* Otherwise insert in minibuffer the chars we got */
2430 if (! NILP (Vminibuffer_completing_file_name
)
2431 && SREF (completion
, SBYTES (completion
) - 1) == '/'
2433 && FETCH_CHAR (PT_BYTE
) == '/')
2435 del_range (prompt_end_charpos
, PT
+ 1);
2438 del_range (prompt_end_charpos
, PT
);
2440 insert_from_string (completion
, 0, 0, i
, i_byte
, 1);
2444 DEFUN ("display-completion-list", Fdisplay_completion_list
, Sdisplay_completion_list
,
2446 doc
: /* Display the list of completions, COMPLETIONS, using `standard-output'.
2447 Each element may be just a symbol or string
2448 or may be a list of two strings to be printed as if concatenated.
2449 If it is a list of two strings, the first is the actual completion
2450 alternative, the second serves as annotation.
2451 `standard-output' must be a buffer.
2452 The actual completion alternatives, as inserted, are given `mouse-face'
2453 properties of `highlight'.
2454 At the end, this runs the normal hook `completion-setup-hook'.
2455 It can find the completion buffer in `standard-output'.
2456 The optional second arg COMMON-SUBSTRING is a string.
2457 It is used to put faces, `completions-first-difference' and
2458 `completions-common-part' on the completion buffer. The
2459 `completions-common-part' face is put on the common substring
2460 specified by COMMON-SUBSTRING. If COMMON-SUBSTRING is nil
2461 and the current buffer is not the minibuffer, the faces are not put.
2462 Internally, COMMON-SUBSTRING is bound to `completion-common-substring'
2463 during running `completion-setup-hook'. */)
2464 (completions
, common_substring
)
2465 Lisp_Object completions
;
2466 Lisp_Object common_substring
;
2468 Lisp_Object tail
, elt
;
2471 struct gcpro gcpro1
, gcpro2
, gcpro3
;
2472 struct buffer
*old
= current_buffer
;
2475 /* Note that (when it matters) every variable
2476 points to a non-string that is pointed to by COMPLETIONS,
2477 except for ELT. ELT can be pointing to a string
2478 when terpri or Findent_to calls a change hook. */
2480 GCPRO3 (completions
, elt
, common_substring
);
2482 if (BUFFERP (Vstandard_output
))
2483 set_buffer_internal (XBUFFER (Vstandard_output
));
2485 if (NILP (completions
))
2486 write_string ("There are no possible completions of what you have typed.",
2490 write_string ("Possible completions are:", -1);
2491 for (tail
= completions
, i
= 0; CONSP (tail
); tail
= XCDR (tail
), i
++)
2493 Lisp_Object tem
, string
;
2495 Lisp_Object startpos
, endpos
;
2501 elt
= SYMBOL_NAME (elt
);
2502 /* Compute the length of this element. */
2507 length
= SCHARS (tem
);
2509 tem
= Fcar (XCDR (elt
));
2511 length
+= SCHARS (tem
);
2516 length
= SCHARS (elt
);
2519 /* This does a bad job for narrower than usual windows.
2520 Sadly, the window it will appear in is not known
2521 until after the text has been made. */
2523 if (BUFFERP (Vstandard_output
))
2524 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2526 /* If the previous completion was very wide,
2527 or we have two on this line already,
2528 don't put another on the same line. */
2529 if (column
> 33 || first
2530 /* If this is really wide, don't put it second on a line. */
2531 || (column
> 0 && length
> 45))
2536 /* Otherwise advance to column 35. */
2539 if (BUFFERP (Vstandard_output
))
2541 tem
= Findent_to (make_number (35), make_number (2));
2543 column
= XINT (tem
);
2549 write_string (" ", -1);
2552 while (column
< 35);
2556 if (BUFFERP (Vstandard_output
))
2558 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2559 Fset_text_properties (startpos
, endpos
,
2560 Qnil
, Vstandard_output
);
2563 /* Output this element.
2564 If necessary, convert it to unibyte or to multibyte first. */
2566 string
= Fcar (elt
);
2569 if (NILP (current_buffer
->enable_multibyte_characters
)
2570 && STRING_MULTIBYTE (string
))
2571 string
= Fstring_make_unibyte (string
);
2572 else if (!NILP (current_buffer
->enable_multibyte_characters
)
2573 && !STRING_MULTIBYTE (string
))
2574 string
= Fstring_make_multibyte (string
);
2576 if (BUFFERP (Vstandard_output
))
2578 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2580 Fprinc (string
, Qnil
);
2582 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2584 Fput_text_property (startpos
, endpos
,
2585 Qmouse_face
, intern ("highlight"),
2590 Fprinc (string
, Qnil
);
2593 /* Output the annotation for this element. */
2596 if (BUFFERP (Vstandard_output
))
2598 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2600 Fprinc (Fcar (Fcdr (elt
)), Qnil
);
2602 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2604 Fset_text_properties (startpos
, endpos
, Qnil
,
2609 Fprinc (Fcar (Fcdr (elt
)), Qnil
);
2614 /* Update COLUMN for what we have output. */
2617 /* If output is to a buffer, recompute COLUMN in a way
2618 that takes account of character widths. */
2619 if (BUFFERP (Vstandard_output
))
2621 tem
= Fcurrent_column ();
2622 column
= XINT (tem
);
2629 if (BUFFERP (Vstandard_output
))
2630 set_buffer_internal (old
);
2632 if (!NILP (Vrun_hooks
))
2634 int count1
= SPECPDL_INDEX ();
2636 specbind (intern ("completion-common-substring"), common_substring
);
2637 call1 (Vrun_hooks
, intern ("completion-setup-hook"));
2639 unbind_to (count1
, Qnil
);
2649 display_completion_list_1 (list
)
2652 return Fdisplay_completion_list (list
, Qnil
);
2655 DEFUN ("minibuffer-completion-help", Fminibuffer_completion_help
, Sminibuffer_completion_help
,
2657 doc
: /* Display a list of possible completions of the current minibuffer contents. */)
2660 Lisp_Object completions
;
2662 message ("Making completion list...");
2663 completions
= Fall_completions (Fminibuffer_completion_contents (),
2664 Vminibuffer_completion_table
,
2665 Vminibuffer_completion_predicate
,
2667 clear_message (1, 0);
2669 if (NILP (completions
))
2672 temp_echo_area_glyphs (build_string (" [No completions]"));
2676 /* Sort and remove duplicates. */
2677 Lisp_Object tmp
= completions
= Fsort (completions
, Qstring_lessp
);
2680 if (CONSP (XCDR (tmp
))
2681 && !NILP (Fequal (XCAR (tmp
), XCAR (XCDR (tmp
)))))
2682 XSETCDR (tmp
, XCDR (XCDR (tmp
)));
2686 internal_with_output_to_temp_buffer ("*Completions*",
2687 display_completion_list_1
,
2693 DEFUN ("self-insert-and-exit", Fself_insert_and_exit
, Sself_insert_and_exit
, 0, 0, "",
2694 doc
: /* Terminate minibuffer input. */)
2697 if (INTEGERP (last_command_char
))
2698 internal_self_insert (XINT (last_command_char
), 0);
2702 return Fexit_minibuffer ();
2705 DEFUN ("exit-minibuffer", Fexit_minibuffer
, Sexit_minibuffer
, 0, 0, "",
2706 doc
: /* Terminate this minibuffer argument. */)
2709 /* If the command that uses this has made modifications in the minibuffer,
2710 we don't want them to cause deactivation of the mark in the original
2712 A better solution would be to make deactivate-mark buffer-local
2713 (or to turn it into a list of buffers, ...), but in the mean time,
2714 this should do the trick in most cases. */
2715 Vdeactivate_mark
= Qnil
;
2716 Fthrow (Qexit
, Qnil
);
2719 DEFUN ("minibuffer-depth", Fminibuffer_depth
, Sminibuffer_depth
, 0, 0, 0,
2720 doc
: /* Return current depth of activations of minibuffer, a nonnegative integer. */)
2723 return make_number (minibuf_level
);
2726 DEFUN ("minibuffer-prompt", Fminibuffer_prompt
, Sminibuffer_prompt
, 0, 0, 0,
2727 doc
: /* Return the prompt string of the currently-active minibuffer.
2728 If no minibuffer is active, return nil. */)
2731 return Fcopy_sequence (minibuf_prompt
);
2735 /* Temporarily display STRING at the end of the current
2736 minibuffer contents. This is used to display things like
2737 "[No Match]" when the user requests a completion for a prefix
2738 that has no possible completions, and other quick, unobtrusive
2741 extern Lisp_Object Vminibuffer_message_timeout
;
2744 temp_echo_area_glyphs (string
)
2748 int osize_byte
= ZV_BYTE
;
2750 int opoint_byte
= PT_BYTE
;
2751 Lisp_Object oinhibit
;
2752 oinhibit
= Vinhibit_quit
;
2754 /* Clear out any old echo-area message to make way for our new thing. */
2757 SET_PT_BOTH (osize
, osize_byte
);
2758 insert_from_string (string
, 0, 0, SCHARS (string
), SBYTES (string
), 0);
2759 SET_PT_BOTH (opoint
, opoint_byte
);
2762 if (NUMBERP (Vminibuffer_message_timeout
))
2763 sit_for (Vminibuffer_message_timeout
, 0, 2);
2767 del_range_both (osize
, osize_byte
, ZV
, ZV_BYTE
, 1);
2768 SET_PT_BOTH (opoint
, opoint_byte
);
2769 if (!NILP (Vquit_flag
))
2772 Vunread_command_events
= Fcons (make_number (quit_char
), Qnil
);
2774 Vinhibit_quit
= oinhibit
;
2777 DEFUN ("minibuffer-message", Fminibuffer_message
, Sminibuffer_message
,
2779 doc
: /* Temporarily display STRING at the end of the minibuffer.
2780 The text is displayed for a period controlled by `minibuffer-message-timeout',
2781 or until the next input event arrives, whichever comes first. */)
2785 CHECK_STRING (string
);
2786 temp_echo_area_glyphs (string
);
2791 init_minibuf_once ()
2793 Vminibuffer_list
= Qnil
;
2794 staticpro (&Vminibuffer_list
);
2801 minibuf_prompt
= Qnil
;
2802 staticpro (&minibuf_prompt
);
2804 minibuf_save_list
= Qnil
;
2805 staticpro (&minibuf_save_list
);
2807 Qread_file_name_internal
= intern ("read-file-name-internal");
2808 staticpro (&Qread_file_name_internal
);
2810 Qminibuffer_default
= intern ("minibuffer-default");
2811 staticpro (&Qminibuffer_default
);
2812 Fset (Qminibuffer_default
, Qnil
);
2814 Qminibuffer_completion_table
= intern ("minibuffer-completion-table");
2815 staticpro (&Qminibuffer_completion_table
);
2817 Qminibuffer_completion_confirm
= intern ("minibuffer-completion-confirm");
2818 staticpro (&Qminibuffer_completion_confirm
);
2820 Qminibuffer_completion_predicate
= intern ("minibuffer-completion-predicate");
2821 staticpro (&Qminibuffer_completion_predicate
);
2823 staticpro (&last_exact_completion
);
2824 last_exact_completion
= Qnil
;
2826 staticpro (&last_minibuf_string
);
2827 last_minibuf_string
= Qnil
;
2829 Quser_variable_p
= intern ("user-variable-p");
2830 staticpro (&Quser_variable_p
);
2832 Qminibuffer_history
= intern ("minibuffer-history");
2833 staticpro (&Qminibuffer_history
);
2835 Qbuffer_name_history
= intern ("buffer-name-history");
2836 staticpro (&Qbuffer_name_history
);
2837 Fset (Qbuffer_name_history
, Qnil
);
2839 Qminibuffer_setup_hook
= intern ("minibuffer-setup-hook");
2840 staticpro (&Qminibuffer_setup_hook
);
2842 Qminibuffer_exit_hook
= intern ("minibuffer-exit-hook");
2843 staticpro (&Qminibuffer_exit_hook
);
2845 Qhistory_length
= intern ("history-length");
2846 staticpro (&Qhistory_length
);
2848 Qcurrent_input_method
= intern ("current-input-method");
2849 staticpro (&Qcurrent_input_method
);
2851 Qactivate_input_method
= intern ("activate-input-method");
2852 staticpro (&Qactivate_input_method
);
2854 Qcase_fold_search
= intern ("case-fold-search");
2855 staticpro (&Qcase_fold_search
);
2857 Qread_expression_history
= intern ("read-expression-history");
2858 staticpro (&Qread_expression_history
);
2860 DEFVAR_LISP ("read-buffer-function", &Vread_buffer_function
,
2861 doc
: /* If this is non-nil, `read-buffer' does its work by calling this function. */);
2862 Vread_buffer_function
= Qnil
;
2864 DEFVAR_LISP ("minibuffer-setup-hook", &Vminibuffer_setup_hook
,
2865 doc
: /* Normal hook run just after entry to minibuffer. */);
2866 Vminibuffer_setup_hook
= Qnil
;
2868 DEFVAR_LISP ("minibuffer-exit-hook", &Vminibuffer_exit_hook
,
2869 doc
: /* Normal hook run just after exit from minibuffer. */);
2870 Vminibuffer_exit_hook
= Qnil
;
2872 DEFVAR_LISP ("history-length", &Vhistory_length
,
2873 doc
: /* *Maximum length for history lists before truncation takes place.
2874 A number means that length; t means infinite. Truncation takes place
2875 just after a new element is inserted. Setting the `history-length'
2876 property of a history variable overrides this default. */);
2877 XSETFASTINT (Vhistory_length
, 30);
2879 DEFVAR_BOOL ("history-delete-duplicates", &history_delete_duplicates
,
2880 doc
: /* *Non-nil means to delete duplicates in history.
2881 If set to t when adding a new history element, all previous identical
2882 elements are deleted from the history list. */);
2883 history_delete_duplicates
= 0;
2885 DEFVAR_LISP ("history-add-new-input", &Vhistory_add_new_input
,
2886 doc
: /* *Non-nil means to add new elements in history.
2887 If set to nil, minibuffer reading functions don't add new elements to the
2888 history list, so it is possible to do this afterwards by calling
2889 `add-to-history' explicitly. */);
2890 Vhistory_add_new_input
= Qt
;
2892 DEFVAR_LISP ("completion-auto-help", &Vcompletion_auto_help
,
2893 doc
: /* *Non-nil means automatically provide help for invalid completion input.
2894 Under Partial Completion mode, a non-nil, non-t value has a special meaning;
2895 see the doc string of `partial-completion-mode' for more details. */);
2896 Vcompletion_auto_help
= Qt
;
2898 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case
,
2899 doc
: /* Non-nil means don't consider case significant in completion.
2901 For file-name completion, the variable `read-file-name-completion-ignore-case'
2902 controls the behavior, rather than this variable. */);
2903 completion_ignore_case
= 0;
2905 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers
,
2906 doc
: /* *Non-nil means to allow minibuffer commands while in the minibuffer.
2907 This variable makes a difference whenever the minibuffer window is active. */);
2908 enable_recursive_minibuffers
= 0;
2910 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table
,
2911 doc
: /* Alist or obarray used for completion in the minibuffer.
2912 This becomes the ALIST argument to `try-completion' and `all-completions'.
2913 The value can also be a list of strings or a hash table.
2915 The value may alternatively be a function, which is given three arguments:
2916 STRING, the current buffer contents;
2917 PREDICATE, the predicate for filtering possible matches;
2918 CODE, which says what kind of things to do.
2919 CODE can be nil, t or `lambda':
2920 nil -- return the best completion of STRING, or nil if there is none.
2921 t -- return a list of all possible completions of STRING.
2922 lambda -- return t if STRING is a valid completion as it stands. */);
2923 Vminibuffer_completion_table
= Qnil
;
2925 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate
,
2926 doc
: /* Within call to `completing-read', this holds the PREDICATE argument. */);
2927 Vminibuffer_completion_predicate
= Qnil
;
2929 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm
,
2930 doc
: /* Non-nil means to demand confirmation of completion before exiting minibuffer. */);
2931 Vminibuffer_completion_confirm
= Qnil
;
2933 DEFVAR_LISP ("minibuffer-completing-file-name",
2934 &Vminibuffer_completing_file_name
,
2935 doc
: /* Non-nil and non-`lambda' means completing file names. */);
2936 Vminibuffer_completing_file_name
= Qnil
;
2938 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form
,
2939 doc
: /* Value that `help-form' takes on inside the minibuffer. */);
2940 Vminibuffer_help_form
= Qnil
;
2942 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable
,
2943 doc
: /* History list symbol to add minibuffer values to.
2944 Each string of minibuffer input, as it appears on exit from the minibuffer,
2946 (set minibuffer-history-variable
2947 (cons STRING (symbol-value minibuffer-history-variable))) */);
2948 XSETFASTINT (Vminibuffer_history_variable
, 0);
2950 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position
,
2951 doc
: /* Current position of redoing in the history list. */);
2952 Vminibuffer_history_position
= Qnil
;
2954 DEFVAR_BOOL ("minibuffer-auto-raise", &minibuffer_auto_raise
,
2955 doc
: /* *Non-nil means entering the minibuffer raises the minibuffer's frame.
2956 Some uses of the echo area also raise that frame (since they use it too). */);
2957 minibuffer_auto_raise
= 0;
2959 DEFVAR_LISP ("completion-regexp-list", &Vcompletion_regexp_list
,
2960 doc
: /* List of regexps that should restrict possible completions.
2961 The basic completion functions only consider a completion acceptable
2962 if it matches all regular expressions in this list, with
2963 `case-fold-search' bound to the value of `completion-ignore-case'.
2964 See Info node `(elisp)Basic Completion', for a description of these
2966 Vcompletion_regexp_list
= Qnil
;
2968 DEFVAR_BOOL ("minibuffer-allow-text-properties",
2969 &minibuffer_allow_text_properties
,
2970 doc
: /* Non-nil means `read-from-minibuffer' should not discard text properties.
2971 This also affects `read-string', but it does not affect `read-minibuffer',
2972 `read-no-blanks-input', or any of the functions that do minibuffer input
2973 with completion; they always discard text properties. */);
2974 minibuffer_allow_text_properties
= 0;
2976 DEFVAR_LISP ("minibuffer-prompt-properties", &Vminibuffer_prompt_properties
,
2977 doc
: /* Text properties that are added to minibuffer prompts.
2978 These are in addition to the basic `field' property, and stickiness
2980 /* We use `intern' here instead of Qread_only to avoid
2981 initialization-order problems. */
2982 Vminibuffer_prompt_properties
2983 = Fcons (intern ("read-only"), Fcons (Qt
, Qnil
));
2985 DEFVAR_LISP ("read-expression-map", &Vread_expression_map
,
2986 doc
: /* Minibuffer keymap used for reading Lisp expressions. */);
2987 Vread_expression_map
= Qnil
;
2989 defsubr (&Sset_minibuffer_window
);
2990 defsubr (&Sread_from_minibuffer
);
2991 defsubr (&Seval_minibuffer
);
2992 defsubr (&Sread_minibuffer
);
2993 defsubr (&Sread_string
);
2994 defsubr (&Sread_command
);
2995 defsubr (&Sread_variable
);
2996 defsubr (&Sinternal_complete_buffer
);
2997 defsubr (&Sread_buffer
);
2998 defsubr (&Sread_no_blanks_input
);
2999 defsubr (&Sminibuffer_depth
);
3000 defsubr (&Sminibuffer_prompt
);
3002 defsubr (&Sminibufferp
);
3003 defsubr (&Sminibuffer_prompt_end
);
3004 defsubr (&Sminibuffer_contents
);
3005 defsubr (&Sminibuffer_contents_no_properties
);
3006 defsubr (&Sminibuffer_completion_contents
);
3007 defsubr (&Sdelete_minibuffer_contents
);
3009 defsubr (&Stry_completion
);
3010 defsubr (&Sall_completions
);
3011 defsubr (&Stest_completion
);
3012 defsubr (&Sassoc_string
);
3013 defsubr (&Scompleting_read
);
3014 defsubr (&Sminibuffer_complete
);
3015 defsubr (&Sminibuffer_complete_word
);
3016 defsubr (&Sminibuffer_complete_and_exit
);
3017 defsubr (&Sdisplay_completion_list
);
3018 defsubr (&Sminibuffer_completion_help
);
3020 defsubr (&Sself_insert_and_exit
);
3021 defsubr (&Sexit_minibuffer
);
3023 defsubr (&Sminibuffer_message
);
3029 initial_define_key (Vminibuffer_local_map
, Ctl ('g'),
3030 "abort-recursive-edit");
3031 initial_define_key (Vminibuffer_local_map
, Ctl ('m'),
3033 initial_define_key (Vminibuffer_local_map
, Ctl ('j'),
3036 initial_define_key (Vminibuffer_local_ns_map
, ' ',
3038 initial_define_key (Vminibuffer_local_ns_map
, '\t',
3040 initial_define_key (Vminibuffer_local_ns_map
, '?',
3041 "self-insert-and-exit");
3043 initial_define_key (Vminibuffer_local_completion_map
, '\t',
3044 "minibuffer-complete");
3045 initial_define_key (Vminibuffer_local_completion_map
, ' ',
3046 "minibuffer-complete-word");
3047 initial_define_key (Vminibuffer_local_completion_map
, '?',
3048 "minibuffer-completion-help");
3050 Fdefine_key (Vminibuffer_local_filename_completion_map
,
3051 build_string (" "), Qnil
);
3053 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('m'),
3054 "minibuffer-complete-and-exit");
3055 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('j'),
3056 "minibuffer-complete-and-exit");
3058 Fdefine_key (Vminibuffer_local_must_match_filename_map
,
3059 build_string (" "), Qnil
);
3062 /* arch-tag: 8f69b601-fba3-484c-a6dd-ceaee54a7a73
3063 (do not change this comment) */