1 /* Minibuffer input and completion.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1996, 1997, 1998
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
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)
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.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
28 #include "dispextern.h"
34 #define min(a, b) ((a) < (b) ? (a) : (b))
38 /* List of buffers for use as minibuffers.
39 The first element of the list is used for the outermost minibuffer
40 invocation, the next element is used for a recursive minibuffer
41 invocation, etc. The list is extended at the end as deeper
42 minibuffer recursions are encountered. */
44 Lisp_Object Vminibuffer_list
;
46 /* Data to remember during recursive minibuffer invocations */
48 Lisp_Object minibuf_save_list
;
50 /* Depth in minibuffer invocations. */
54 /* Nonzero means display completion help for invalid input. */
58 /* The maximum length of a minibuffer history. */
60 Lisp_Object Qhistory_length
, Vhistory_length
;
62 /* Fread_minibuffer leaves the input here as a string. */
64 Lisp_Object last_minibuf_string
;
66 /* Nonzero means let functions called when within a minibuffer
67 invoke recursive minibuffers (to read arguments, or whatever) */
69 int enable_recursive_minibuffers
;
71 /* Nonzero means don't ignore text properties
72 in Fread_from_minibuffer. */
74 int minibuffer_allow_text_properties
;
76 /* help-form is bound to this while in the minibuffer. */
78 Lisp_Object Vminibuffer_help_form
;
80 /* Variable which is the history list to add minibuffer values to. */
82 Lisp_Object Vminibuffer_history_variable
;
84 /* Current position in the history list (adjusted by M-n and M-p). */
86 Lisp_Object Vminibuffer_history_position
;
88 Lisp_Object Qminibuffer_history
, Qbuffer_name_history
;
90 Lisp_Object Qread_file_name_internal
;
92 /* Normal hooks for entry to and exit from minibuffer. */
94 Lisp_Object Qminibuffer_setup_hook
, Vminibuffer_setup_hook
;
95 Lisp_Object Qminibuffer_exit_hook
, Vminibuffer_exit_hook
;
97 /* Function to call to read a buffer name. */
98 Lisp_Object Vread_buffer_function
;
100 /* Nonzero means completion ignores case. */
102 int completion_ignore_case
;
104 /* List of regexps that should restrict possible completions. */
106 Lisp_Object Vcompletion_regexp_list
;
108 /* Nonzero means raise the minibuffer frame when the minibuffer
111 int minibuffer_auto_raise
;
113 /* If last completion attempt reported "Complete but not unique"
114 then this is the string completed then; otherwise this is nil. */
116 static Lisp_Object last_exact_completion
;
118 /* Non-nil means it is the window for C-M-v to scroll
119 when the minibuffer is selected. */
121 extern Lisp_Object Vminibuf_scroll_window
;
123 extern Lisp_Object Voverriding_local_map
;
125 Lisp_Object Quser_variable_p
;
127 Lisp_Object Qminibuffer_default
;
129 Lisp_Object Qcurrent_input_method
, Qactivate_input_method
;
131 extern Lisp_Object Qmouse_face
;
134 /* Put minibuf on currently selected frame's minibuffer.
135 We do this whenever the user starts a new minibuffer
136 or when a minibuffer exits. */
139 choose_minibuf_frame ()
141 if (selected_frame
!= 0
142 && !EQ (minibuf_window
, selected_frame
->minibuffer_window
))
144 /* I don't think that any frames may validly have a null minibuffer
146 if (NILP (selected_frame
->minibuffer_window
))
149 Fset_window_buffer (selected_frame
->minibuffer_window
,
150 XWINDOW (minibuf_window
)->buffer
);
151 minibuf_window
= selected_frame
->minibuffer_window
;
154 /* Make sure no other frame has a minibuffer as its selected window,
155 because the text would not be displayed in it, and that would be
156 confusing. Only allow the selected frame to do this,
157 and that only if the minibuffer is active. */
159 Lisp_Object tail
, frame
;
161 FOR_EACH_FRAME (tail
, frame
)
162 if (MINI_WINDOW_P (XWINDOW (FRAME_SELECTED_WINDOW (XFRAME (frame
))))
163 && !(XFRAME (frame
) == selected_frame
164 && minibuf_level
> 0))
165 Fset_frame_selected_window (frame
, Fframe_first_window (frame
));
170 choose_minibuf_frame_1 (ignore
)
173 choose_minibuf_frame ();
177 DEFUN ("set-minibuffer-window", Fset_minibuffer_window
,
178 Sset_minibuffer_window
, 1, 1, 0,
179 "Specify which minibuffer window to use for the minibuffer.\n\
180 This effects where the minibuffer is displayed if you put text in it\n\
181 without invoking the usual minibuffer commands.")
185 CHECK_WINDOW (window
, 1);
186 if (! MINI_WINDOW_P (XWINDOW (window
)))
187 error ("Window is not a minibuffer window");
189 minibuf_window
= window
;
197 /* Actual minibuffer invocation. */
199 static Lisp_Object read_minibuf_unwind
P_ ((Lisp_Object
));
200 static Lisp_Object read_minibuf
P_ ((Lisp_Object
, Lisp_Object
,
201 Lisp_Object
, Lisp_Object
,
203 Lisp_Object
, Lisp_Object
,
206 /* Read from the minibuffer using keymap MAP, initial contents INITIAL
207 (a string), putting point minus BACKUP_N bytes from the end of INITIAL,
208 prompting with PROMPT (a string), using history list HISTVAR
209 with initial position HISTPOS. (BACKUP_N should be <= 0.)
211 Normally return the result as a string (the text that was read),
212 but if EXPFLAG is nonzero, read it and return the object read.
213 If HISTVAR is given, save the value read on that history only if it doesn't
214 match the front of that history list exactly. The value is pushed onto
215 the list as the string that was read.
217 DEFALT specifies te default value for the sake of history commands.
219 If ALLOW_PROPS is nonzero, we do not throw away text properties.
221 if INHERIT_INPUT_METHOD is nonzeor, the minibuffer inherit the
222 current input method. */
225 read_minibuf (map
, initial
, prompt
, backup_n
, expflag
,
226 histvar
, histpos
, defalt
, allow_props
, inherit_input_method
)
230 Lisp_Object backup_n
;
236 int inherit_input_method
;
239 int count
= specpdl_ptr
- specpdl
;
240 Lisp_Object mini_frame
, ambient_dir
, minibuffer
, input_method
;
241 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
242 Lisp_Object enable_multibyte
;
243 extern Lisp_Object Qinvisible
, Qintangible
, Qread_only
, Qfront_sticky
;
245 specbind (Qminibuffer_default
, defalt
);
247 single_kboard_state ();
250 ambient_dir
= current_buffer
->directory
;
252 enable_multibyte
= Qnil
;
254 /* Don't need to protect PROMPT, HISTVAR, and HISTPOS because we
255 store them away before we can GC. Don't need to protect
256 BACKUP_N because we use the value only if it is an integer. */
257 GCPRO5 (map
, initial
, val
, ambient_dir
, input_method
);
259 if (!STRINGP (prompt
))
260 prompt
= build_string ("");
262 if (!enable_recursive_minibuffers
263 && minibuf_level
> 0)
265 if (EQ (selected_window
, minibuf_window
))
266 error ("Command attempted to use minibuffer while in minibuffer");
268 /* If we're in another window, cancel the minibuffer that's active. */
270 build_string ("Command attempted to use minibuffer while in minibuffer"));
273 /* Choose the minibuffer window and frame, and take action on them. */
275 choose_minibuf_frame ();
277 record_unwind_protect (choose_minibuf_frame_1
, Qnil
);
279 record_unwind_protect (Fset_window_configuration
,
280 Fcurrent_window_configuration (Qnil
));
282 /* If the minibuffer window is on a different frame, save that
283 frame's configuration too. */
284 mini_frame
= WINDOW_FRAME (XWINDOW (minibuf_window
));
285 if (XFRAME (mini_frame
) != selected_frame
)
286 record_unwind_protect (Fset_window_configuration
,
287 Fcurrent_window_configuration (mini_frame
));
289 /* If the minibuffer is on an iconified or invisible frame,
290 make it visible now. */
291 Fmake_frame_visible (mini_frame
);
293 if (minibuffer_auto_raise
)
294 Fraise_frame (mini_frame
);
296 /* We have to do this after saving the window configuration
297 since that is what restores the current buffer. */
299 /* Arrange to restore a number of minibuffer-related variables.
300 We could bind each variable separately, but that would use lots of
303 = Fcons (Voverriding_local_map
,
304 Fcons (minibuf_window
, minibuf_save_list
));
306 = Fcons (minibuf_prompt
,
307 Fcons (make_number (minibuf_prompt_width
),
309 Fcons (Vcurrent_prefix_arg
,
310 Fcons (Vminibuffer_history_position
,
311 Fcons (Vminibuffer_history_variable
,
312 minibuf_save_list
))))));
314 = Fcons (current_buffer
->minibuffer_prompt_length
,
317 record_unwind_protect (read_minibuf_unwind
, Qnil
);
320 /* Now that we can restore all those variables, start changing them. */
322 minibuf_prompt_width
= 0; /* xdisp.c puts in the right value. */
323 minibuf_prompt
= Fcopy_sequence (prompt
);
324 Vminibuffer_history_position
= histpos
;
325 Vminibuffer_history_variable
= histvar
;
326 Vhelp_form
= Vminibuffer_help_form
;
328 if (inherit_input_method
)
330 /* `current-input-method' is buffer local. So, remeber it in
331 INPUT_METHOD before changing the current buffer. */
332 input_method
= Fsymbol_value (Qcurrent_input_method
);
333 enable_multibyte
= current_buffer
->enable_multibyte_characters
;
336 /* Switch to the minibuffer. */
338 minibuffer
= get_minibuffer (minibuf_level
);
339 Fset_buffer (minibuffer
);
341 /* The current buffer's default directory is usually the right thing
342 for our minibuffer here. However, if you're typing a command at
343 a minibuffer-only frame when minibuf_level is zero, then buf IS
344 the current_buffer, so reset_buffer leaves buf's default
345 directory unchanged. This is a bummer when you've just started
346 up Emacs and buf's default directory is Qnil. Here's a hack; can
347 you think of something better to do? Find another buffer with a
348 better directory, and use that one instead. */
349 if (STRINGP (ambient_dir
))
350 current_buffer
->directory
= ambient_dir
;
353 Lisp_Object buf_list
;
355 for (buf_list
= Vbuffer_alist
;
357 buf_list
= XCONS (buf_list
)->cdr
)
359 Lisp_Object other_buf
;
361 other_buf
= XCONS (XCONS (buf_list
)->car
)->cdr
;
362 if (STRINGP (XBUFFER (other_buf
)->directory
))
364 current_buffer
->directory
= XBUFFER (other_buf
)->directory
;
370 if (XFRAME (mini_frame
) != selected_frame
)
371 Fredirect_frame_focus (Fselected_frame (), mini_frame
);
373 Vminibuf_scroll_window
= selected_window
;
374 Fset_window_buffer (minibuf_window
, Fcurrent_buffer ());
375 Fselect_window (minibuf_window
);
376 XSETFASTINT (XWINDOW (minibuf_window
)->hscroll
, 0);
378 Fmake_local_variable (Qprint_escape_newlines
);
379 print_escape_newlines
= 1;
380 XSETFASTINT (current_buffer
->minibuffer_prompt_length
, 0);
382 /* Erase the buffer. */
384 int count1
= specpdl_ptr
- specpdl
;
385 specbind (Qinhibit_read_only
, Qt
);
387 unbind_to (count1
, Qnil
);
390 if (!NILP (current_buffer
->enable_multibyte_characters
)
391 && ! STRING_MULTIBYTE (minibuf_prompt
))
392 minibuf_prompt
= Fstring_make_multibyte (minibuf_prompt
);
394 /* Insert the prompt, record where it ends. */
395 Finsert (1, &minibuf_prompt
);
396 XSETFASTINT (current_buffer
->minibuffer_prompt_length
, PT
);
399 Fput_text_property (make_number (BEG
), make_number (PT
- 1),
400 Qfront_sticky
, Qt
, Qnil
);
401 Fput_text_property (make_number (BEG
), make_number (PT
- 1),
402 Qread_only
, Qt
, Qnil
);
403 Fput_text_property (make_number (PT
- 1), make_number (Z
),
404 Qrear_nonsticky
, Qt
, Qnil
);
407 /* If appropriate, copy enable-multibyte-characters into the minibuffer. */
408 if (inherit_input_method
)
409 current_buffer
->enable_multibyte_characters
= enable_multibyte
;
411 /* Put in the initial input. */
414 Finsert (1, &initial
);
415 if (INTEGERP (backup_n
))
416 Fforward_char (backup_n
);
419 clear_message (1, 1);
420 current_buffer
->keymap
= map
;
422 /* Turn on an input method stored in INPUT_METHOD if any. */
423 if (STRINGP (input_method
) && !NILP (Ffboundp (Qactivate_input_method
)))
424 call1 (Qactivate_input_method
, input_method
);
426 /* Run our hook, but not if it is empty.
427 (run-hooks would do nothing if it is empty,
428 but it's important to save time here in the usual case). */
429 if (!NILP (Vminibuffer_setup_hook
) && !EQ (Vminibuffer_setup_hook
, Qunbound
)
430 && !NILP (Vrun_hooks
))
431 call1 (Vrun_hooks
, Qminibuffer_setup_hook
);
435 /* If cursor is on the minibuffer line,
436 show the user we have exited by putting it in column 0. */
437 if (XWINDOW (minibuf_window
)->cursor
.vpos
>= 0
440 XWINDOW (minibuf_window
)->cursor
.hpos
= 0;
441 XWINDOW (minibuf_window
)->cursor
.x
= 0;
442 XWINDOW (minibuf_window
)->must_be_updated_p
= 1;
443 update_frame (selected_frame
, 1, 1);
444 if (rif
&& rif
->flush_display
)
445 rif
->flush_display (XFRAME (XWINDOW (minibuf_window
)->frame
));
448 /* Make minibuffer contents into a string. */
449 Fset_buffer (minibuffer
);
450 val
= make_buffer_string (1, Z
, allow_props
);
452 /* VAL is the string of minibuffer text. */
454 last_minibuf_string
= val
;
456 /* Add the value to the appropriate history list unless it is empty. */
457 if (XSTRING (val
)->size
!= 0
458 && SYMBOLP (Vminibuffer_history_variable
))
460 /* If the caller wanted to save the value read on a history list,
461 then do so if the value is not already the front of the list. */
464 /* If variable is unbound, make it nil. */
465 if (EQ (XSYMBOL (Vminibuffer_history_variable
)->value
, Qunbound
))
466 Fset (Vminibuffer_history_variable
, Qnil
);
468 histval
= Fsymbol_value (Vminibuffer_history_variable
);
470 /* The value of the history variable must be a cons or nil. Other
471 values are unacceptable. We silently ignore these values. */
474 && NILP (Fequal (last_minibuf_string
, Fcar (histval
)))))
478 histval
= Fcons (last_minibuf_string
, histval
);
479 Fset (Vminibuffer_history_variable
, histval
);
481 /* Truncate if requested. */
482 length
= Fget (Vminibuffer_history_variable
, Qhistory_length
);
483 if (NILP (length
)) length
= Vhistory_length
;
484 if (INTEGERP (length
))
486 if (XINT (length
) <= 0)
487 Fset (Vminibuffer_history_variable
, Qnil
);
492 temp
= Fnthcdr (Fsub1 (length
), histval
);
493 if (CONSP (temp
)) Fsetcdr (temp
, Qnil
);
499 /* If Lisp form desired instead of string, parse it. */
502 Lisp_Object expr_and_pos
;
506 if (STRINGP (val
) && XSTRING (val
)->size
== 0
510 expr_and_pos
= Fread_from_string (val
, Qnil
, Qnil
);
511 pos
= XINT (Fcdr (expr_and_pos
));
512 if (pos
!= XSTRING (val
)->size
)
514 /* Ignore trailing whitespace; any other trailing junk is an error. */
516 pos
= string_char_to_byte (val
, pos
);
517 for (i
= pos
; i
< STRING_BYTES (XSTRING (val
)); i
++)
519 int c
= XSTRING (val
)->data
[i
];
520 if (c
!= ' ' && c
!= '\t' && c
!= '\n')
521 error ("Trailing garbage following expression");
524 val
= Fcar (expr_and_pos
);
527 /* The appropriate frame will get selected
528 in set-window-configuration. */
529 RETURN_UNGCPRO (unbind_to (count
, val
));
532 /* Return a buffer to be used as the minibuffer at depth `depth'.
533 depth = 0 is the lowest allowed argument, and that is the value
534 used for nonrecursive minibuffer invocations */
537 get_minibuffer (depth
)
540 Lisp_Object tail
, num
, buf
;
542 extern Lisp_Object
nconc2 ();
544 XSETFASTINT (num
, depth
);
545 tail
= Fnthcdr (num
, Vminibuffer_list
);
548 tail
= Fcons (Qnil
, Qnil
);
549 Vminibuffer_list
= nconc2 (Vminibuffer_list
, tail
);
552 if (NILP (buf
) || NILP (XBUFFER (buf
)->name
))
554 sprintf (name
, " *Minibuf-%d*", depth
);
555 buf
= Fget_buffer_create (build_string (name
));
557 /* Although the buffer's name starts with a space, undo should be
559 Fbuffer_enable_undo (buf
);
561 XCONS (tail
)->car
= buf
;
565 int count
= specpdl_ptr
- specpdl
;
567 reset_buffer (XBUFFER (buf
));
568 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
570 Fkill_all_local_variables ();
571 unbind_to (count
, Qnil
);
577 /* This function is called on exiting minibuffer, whether normally or
578 not, and it restores the current window, buffer, etc. */
581 read_minibuf_unwind (data
)
584 Lisp_Object old_deactivate_mark
;
587 /* We are exiting the minibuffer one way or the other,
589 if (!NILP (Vminibuffer_exit_hook
) && !EQ (Vminibuffer_exit_hook
, Qunbound
)
590 && !NILP (Vrun_hooks
))
591 safe_run_hooks (Qminibuffer_exit_hook
);
593 /* If this was a recursive minibuffer,
594 tie the minibuffer window back to the outer level minibuffer buffer. */
597 window
= minibuf_window
;
598 /* To keep things predictable, in case it matters, let's be in the
599 minibuffer when we reset the relevant variables. */
600 Fset_buffer (XWINDOW (window
)->buffer
);
602 /* Restore prompt, etc, from outer minibuffer level. */
603 current_buffer
->minibuffer_prompt_length
= Fcar (minibuf_save_list
);
604 minibuf_save_list
= Fcdr (minibuf_save_list
);
606 minibuf_prompt
= Fcar (minibuf_save_list
);
607 minibuf_save_list
= Fcdr (minibuf_save_list
);
608 minibuf_prompt_width
= XFASTINT (Fcar (minibuf_save_list
));
609 minibuf_save_list
= Fcdr (minibuf_save_list
);
610 Vhelp_form
= Fcar (minibuf_save_list
);
611 minibuf_save_list
= Fcdr (minibuf_save_list
);
612 Vcurrent_prefix_arg
= Fcar (minibuf_save_list
);
613 minibuf_save_list
= Fcdr (minibuf_save_list
);
614 Vminibuffer_history_position
= Fcar (minibuf_save_list
);
615 minibuf_save_list
= Fcdr (minibuf_save_list
);
616 Vminibuffer_history_variable
= Fcar (minibuf_save_list
);
617 minibuf_save_list
= Fcdr (minibuf_save_list
);
618 Voverriding_local_map
= Fcar (minibuf_save_list
);
619 minibuf_save_list
= Fcdr (minibuf_save_list
);
621 temp
= Fcar (minibuf_save_list
);
622 if (FRAME_LIVE_P (XFRAME (WINDOW_FRAME (XWINDOW (temp
)))))
623 minibuf_window
= temp
;
625 minibuf_save_list
= Fcdr (minibuf_save_list
);
627 /* Erase the minibuffer we were using at this level. */
629 int count
= specpdl_ptr
- specpdl
;
630 /* Prevent error in erase-buffer. */
631 specbind (Qinhibit_read_only
, Qt
);
632 old_deactivate_mark
= Vdeactivate_mark
;
634 Vdeactivate_mark
= old_deactivate_mark
;
635 unbind_to (count
, Qnil
);
638 /* Make sure minibuffer window is erased, not ignored. */
639 windows_or_buffers_changed
++;
640 XSETFASTINT (XWINDOW (window
)->last_modified
, 0);
641 XSETFASTINT (XWINDOW (window
)->last_overlay_modified
, 0);
646 /* This comment supplies the doc string for read-from-minibuffer,
647 for make-docfile to see. We cannot put this in the real DEFUN
648 due to limits in the Unix cpp.
650 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 7, 0,
651 "Read a string from the minibuffer, prompting with string PROMPT.\n\
652 If optional second arg INITIAL-CONTENTS is non-nil, it is a string\n\
653 to be inserted into the minibuffer before reading input.\n\
654 If INITIAL-CONTENTS is (STRING . POSITION), the initial input\n\
655 is STRING, but point is placed at position POSITION in the minibuffer.\n\
656 Third arg KEYMAP is a keymap to use whilst reading;\n\
657 if omitted or nil, the default is `minibuffer-local-map'.\n\
658 If fourth arg READ is non-nil, then interpret the result as a lisp object\n\
659 and return that object:\n\
660 in other words, do `(car (read-from-string INPUT-STRING))'\n\
661 Fifth arg HIST, if non-nil, specifies a history list\n\
662 and optionally the initial position in the list.\n\
663 It can be a symbol, which is the history list variable to use,\n\
664 or it can be a cons cell (HISTVAR . HISTPOS).\n\
665 In that case, HISTVAR is the history list variable to use,\n\
666 and HISTPOS is the initial position (the position in the list\n\
667 which INITIAL-CONTENTS corresponds to).\n\
668 Positions are counted starting from 1 at the beginning of the list.\n\
669 Sixth arg DEFAULT-VALUE is the default value. If non-nil, it is available\n\
670 for history commands; but `read-from-minibuffer' does NOT return DEFAULT-VALUE\n\
671 if the user enters empty input! It returns the empty string.\n\
672 Seventh arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
673 the current input method and the setting of enable-multibyte-characters.\n\
674 If the variable `minibuffer-allow-text-properties' is non-nil,\n\
675 then the string which is returned includes whatever text properties\n\
676 were present in the minibuffer. Otherwise the value has no text properties.")
677 (prompt, initial_contents, keymap, read, hist, default_value, inherit_input_method)
680 DEFUN ("read-from-minibuffer", Fread_from_minibuffer
, Sread_from_minibuffer
, 1, 7, 0,
681 0 /* See immediately above */)
682 (prompt
, initial_contents
, keymap
, read
, hist
, default_value
, inherit_input_method
)
683 Lisp_Object prompt
, initial_contents
, keymap
, read
, hist
, default_value
;
684 Lisp_Object inherit_input_method
;
687 Lisp_Object histvar
, histpos
, position
, val
;
692 CHECK_STRING (prompt
, 0);
693 if (!NILP (initial_contents
))
695 if (CONSP (initial_contents
))
697 position
= Fcdr (initial_contents
);
698 initial_contents
= Fcar (initial_contents
);
700 CHECK_STRING (initial_contents
, 1);
701 if (!NILP (position
))
703 CHECK_NUMBER (position
, 0);
704 /* Convert to distance from end of input. */
705 if (XINT (position
) < 1)
706 /* A number too small means the beginning of the string. */
707 pos
= - XSTRING (initial_contents
)->size
;
709 pos
= XINT (position
) - 1 - XSTRING (initial_contents
)->size
;
714 keymap
= Vminibuffer_local_map
;
716 keymap
= get_keymap (keymap
);
725 histvar
= Fcar_safe (hist
);
726 histpos
= Fcdr_safe (hist
);
729 histvar
= Qminibuffer_history
;
731 XSETFASTINT (histpos
, 0);
733 GCPRO1 (default_value
);
734 val
= read_minibuf (keymap
, initial_contents
, prompt
,
735 make_number (pos
), !NILP (read
),
736 histvar
, histpos
, default_value
,
737 minibuffer_allow_text_properties
,
738 !NILP (inherit_input_method
));
743 DEFUN ("read-minibuffer", Fread_minibuffer
, Sread_minibuffer
, 1, 2, 0,
744 "Return a Lisp object read using the minibuffer.\n\
745 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\
746 is a string to insert in the minibuffer before reading.")
747 (prompt
, initial_contents
)
748 Lisp_Object prompt
, initial_contents
;
750 CHECK_STRING (prompt
, 0);
751 if (!NILP (initial_contents
))
752 CHECK_STRING (initial_contents
, 1);
753 return read_minibuf (Vminibuffer_local_map
, initial_contents
,
754 prompt
, Qnil
, 1, Qminibuffer_history
,
755 make_number (0), Qnil
, 0, 0);
758 DEFUN ("eval-minibuffer", Feval_minibuffer
, Seval_minibuffer
, 1, 2, 0,
759 "Return value of Lisp expression read using the minibuffer.\n\
760 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\
761 is a string to insert in the minibuffer before reading.")
762 (prompt
, initial_contents
)
763 Lisp_Object prompt
, initial_contents
;
765 return Feval (Fread_minibuffer (prompt
, initial_contents
));
768 /* Functions that use the minibuffer to read various things. */
770 DEFUN ("read-string", Fread_string
, Sread_string
, 1, 5, 0,
771 "Read a string from the minibuffer, prompting with string PROMPT.\n\
772 If non-nil, second arg INITIAL-INPUT is a string to insert before reading.\n\
773 The third arg HISTORY, if non-nil, specifies a history list\n\
774 and optionally the initial position in the list.\n\
775 See `read-from-minibuffer' for details of HISTORY argument.\n\
776 Fourth arg DEFAULT-VALUE is the default value. If non-nil, it is used\n\
777 for history commands, and as the value to return if the user enters\n\
779 Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
780 the current input method and the setting of enable-multibyte-characters.")
781 (prompt
, initial_input
, history
, default_value
, inherit_input_method
)
782 Lisp_Object prompt
, initial_input
, history
, default_value
;
783 Lisp_Object inherit_input_method
;
786 val
= Fread_from_minibuffer (prompt
, initial_input
, Qnil
,
787 Qnil
, history
, default_value
,
788 inherit_input_method
);
789 if (STRINGP (val
) && XSTRING (val
)->size
== 0 && ! NILP (default_value
))
794 DEFUN ("read-no-blanks-input", Fread_no_blanks_input
, Sread_no_blanks_input
, 1, 3, 0,
795 "Read a string from the terminal, not allowing blanks.\n\
796 Prompt with PROMPT, and provide INITIAL as an initial value of the input string.\n\
797 Third arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
798 the current input method and the setting of enable-multibyte-characters.")
799 (prompt
, initial
, inherit_input_method
)
800 Lisp_Object prompt
, initial
, inherit_input_method
;
802 CHECK_STRING (prompt
, 0);
803 if (! NILP (initial
))
804 CHECK_STRING (initial
, 1);
806 return read_minibuf (Vminibuffer_local_ns_map
, initial
, prompt
, Qnil
,
807 0, Qminibuffer_history
, make_number (0), Qnil
, 0,
808 !NILP (inherit_input_method
));
811 DEFUN ("read-command", Fread_command
, Sread_command
, 1, 2, 0,
812 "Read the name of a command and return as a symbol.\n\
813 Prompts with PROMPT. By default, return DEFAULT-VALUE.")
814 (prompt
, default_value
)
815 Lisp_Object prompt
, default_value
;
817 Lisp_Object name
, default_string
;
819 if (NILP (default_value
))
820 default_string
= Qnil
;
821 else if (SYMBOLP (default_value
))
822 XSETSTRING (default_string
, XSYMBOL (default_value
)->name
);
824 default_string
= default_value
;
826 name
= Fcompleting_read (prompt
, Vobarray
, Qcommandp
, Qt
,
827 Qnil
, Qnil
, default_string
, Qnil
);
830 return Fintern (name
, Qnil
);
834 DEFUN ("read-function", Fread_function
, Sread_function
, 1, 1, 0,
835 "One arg PROMPT, a string. Read the name of a function and return as a symbol.\n\
836 Prompts with PROMPT.")
840 return Fintern (Fcompleting_read (prompt
, Vobarray
, Qfboundp
, Qt
, Qnil
, Qnil
, Qnil
, Qnil
),
845 DEFUN ("read-variable", Fread_variable
, Sread_variable
, 1, 2, 0,
846 "Read the name of a user variable and return it as a symbol.\n\
847 Prompts with PROMPT. By default, return DEFAULT-VALUE.\n\
848 A user variable is one whose documentation starts with a `*' character.")
849 (prompt
, default_value
)
850 Lisp_Object prompt
, default_value
;
852 Lisp_Object name
, default_string
;
854 if (NILP (default_value
))
855 default_string
= Qnil
;
856 else if (SYMBOLP (default_value
))
857 XSETSTRING (default_string
, XSYMBOL (default_value
)->name
);
859 default_string
= default_value
;
861 name
= Fcompleting_read (prompt
, Vobarray
,
862 Quser_variable_p
, Qt
,
863 Qnil
, Qnil
, default_string
, Qnil
);
866 return Fintern (name
, Qnil
);
869 DEFUN ("read-buffer", Fread_buffer
, Sread_buffer
, 1, 3, 0,
870 "One arg PROMPT, a string. Read the name of a buffer and return as a string.\n\
871 Prompts with PROMPT.\n\
872 Optional second arg DEF is value to return if user enters an empty line.\n\
873 If optional third arg REQUIRE-MATCH is non-nil, only existing buffer names are allowed.")
874 (prompt
, def
, require_match
)
875 Lisp_Object prompt
, def
, require_match
;
881 def
= XBUFFER (def
)->name
;
883 if (NILP (Vread_buffer_function
))
887 args
[0] = build_string ("%s(default %s) ");
890 prompt
= Fformat (3, args
);
893 return Fcompleting_read (prompt
, Vbuffer_alist
, Qnil
,
894 require_match
, Qnil
, Qbuffer_name_history
,
899 args
[0] = Vread_buffer_function
;
902 args
[3] = require_match
;
903 return Ffuncall(4, args
);
908 minibuf_conform_representation (string
, basis
)
909 Lisp_Object string
, basis
;
911 if (STRING_MULTIBYTE (string
) == STRING_MULTIBYTE (basis
))
914 if (STRING_MULTIBYTE (string
))
915 return Fstring_make_unibyte (string
);
917 return Fstring_make_multibyte (string
);
920 DEFUN ("try-completion", Ftry_completion
, Stry_completion
, 2, 3, 0,
921 "Return common substring of all completions of STRING in ALIST.\n\
922 Each car of each element of ALIST is tested to see if it begins with STRING.\n\
923 All that match are compared together; the longest initial sequence\n\
924 common to all matches is returned as a string.\n\
925 If there is no match at all, nil is returned.\n\
926 For an exact match, t is returned.\n\
928 ALIST can be an obarray instead of an alist.\n\
929 Then the print names of all symbols in the obarray are the possible matches.\n\
931 ALIST can also be a function to do the completion itself.\n\
932 It receives three arguments: the values STRING, PREDICATE and nil.\n\
933 Whatever it returns becomes the value of `try-completion'.\n\
935 If optional third argument PREDICATE is non-nil,\n\
936 it is used to test each possible match.\n\
937 The match is a candidate only if PREDICATE returns non-nil.\n\
938 The argument given to PREDICATE is the alist element\n\
939 or the symbol from the obarray.")
940 (string
, alist
, predicate
)
941 Lisp_Object string
, alist
, predicate
;
943 Lisp_Object bestmatch
, tail
, elt
, eltstring
;
944 /* Size in bytes of BESTMATCH. */
946 /* These are in bytes, too. */
947 int compare
, matchsize
;
948 int list
= CONSP (alist
) || NILP (alist
);
951 Lisp_Object bucket
, zero
, end
, tem
;
952 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
954 CHECK_STRING (string
, 0);
955 if (!list
&& !VECTORP (alist
))
956 return call3 (alist
, string
, predicate
, Qnil
);
960 /* If ALIST is not a list, set TAIL just for gc pro. */
965 obsize
= XVECTOR (alist
)->size
;
966 bucket
= XVECTOR (alist
)->contents
[index
];
971 /* Get the next element of the alist or obarray. */
972 /* Exit the loop if the elements are all used up. */
973 /* elt gets the alist element or symbol.
974 eltstring gets the name to check as a completion. */
981 eltstring
= Fcar (elt
);
986 if (XFASTINT (bucket
) != 0)
989 eltstring
= Fsymbol_name (elt
);
990 if (XSYMBOL (bucket
)->next
)
991 XSETSYMBOL (bucket
, XSYMBOL (bucket
)->next
);
993 XSETFASTINT (bucket
, 0);
995 else if (++index
>= obsize
)
999 bucket
= XVECTOR (alist
)->contents
[index
];
1004 /* Is this element a possible completion? */
1006 if (STRINGP (eltstring
)
1007 && XSTRING (string
)->size
<= XSTRING (eltstring
)->size
1008 && (tem
= Fcompare_strings (eltstring
, make_number (0),
1009 make_number (XSTRING (string
)->size
),
1010 string
, make_number (0), Qnil
,
1011 completion_ignore_case
?Qt
: Qnil
),
1015 Lisp_Object regexps
;
1017 XSETFASTINT (zero
, 0);
1019 /* Ignore this element if it fails to match all the regexps. */
1020 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1021 regexps
= XCONS (regexps
)->cdr
)
1023 tem
= Fstring_match (XCONS (regexps
)->car
, eltstring
, zero
);
1027 if (CONSP (regexps
))
1030 /* Ignore this element if there is a predicate
1031 and the predicate doesn't like it. */
1033 if (!NILP (predicate
))
1035 if (EQ (predicate
, Qcommandp
))
1036 tem
= Fcommandp (elt
);
1039 GCPRO4 (tail
, string
, eltstring
, bestmatch
);
1040 tem
= call1 (predicate
, elt
);
1043 if (NILP (tem
)) continue;
1046 /* Update computation of how much all possible completions match */
1049 if (NILP (bestmatch
))
1051 bestmatch
= eltstring
;
1052 bestmatchsize
= XSTRING (eltstring
)->size
;
1056 compare
= min (bestmatchsize
, XSTRING (eltstring
)->size
);
1057 tem
= Fcompare_strings (bestmatch
, make_number (0),
1058 make_number (compare
),
1059 eltstring
, make_number (0),
1060 make_number (compare
),
1061 completion_ignore_case
? Qt
: Qnil
);
1063 matchsize
= compare
;
1064 else if (XINT (tem
) < 0)
1065 matchsize
= - XINT (tem
) - 1;
1067 matchsize
= XINT (tem
) - 1;
1070 matchsize
= compare
;
1071 if (completion_ignore_case
)
1073 /* If this is an exact match except for case,
1074 use it as the best match rather than one that is not an
1075 exact match. This way, we get the case pattern
1076 of the actual match. */
1077 if ((matchsize
== XSTRING (eltstring
)->size
1078 && matchsize
< XSTRING (bestmatch
)->size
)
1080 /* If there is more than one exact match ignoring case,
1081 and one of them is exact including case,
1083 /* If there is no exact match ignoring case,
1084 prefer a match that does not change the case
1086 ((matchsize
== XSTRING (eltstring
)->size
)
1088 (matchsize
== XSTRING (bestmatch
)->size
)
1089 && (tem
= Fcompare_strings (eltstring
, make_number (0),
1090 make_number (XSTRING (string
)->size
),
1091 string
, make_number (0),
1095 && (tem
= Fcompare_strings (bestmatch
, make_number (0),
1096 make_number (XSTRING (string
)->size
),
1097 string
, make_number (0),
1101 bestmatch
= eltstring
;
1103 bestmatchsize
= matchsize
;
1108 if (NILP (bestmatch
))
1109 return Qnil
; /* No completions found */
1110 /* If we are ignoring case, and there is no exact match,
1111 and no additional text was supplied,
1112 don't change the case of what the user typed. */
1113 if (completion_ignore_case
&& bestmatchsize
== XSTRING (string
)->size
1114 && XSTRING (bestmatch
)->size
> bestmatchsize
)
1115 return minibuf_conform_representation (string
, bestmatch
);
1117 /* Return t if the supplied string is an exact match (counting case);
1118 it does not require any change to be made. */
1119 if (matchcount
== 1 && bestmatchsize
== XSTRING (string
)->size
1120 && (tem
= Fcompare_strings (bestmatch
, make_number (0),
1121 make_number (bestmatchsize
),
1122 string
, make_number (0),
1123 make_number (bestmatchsize
),
1128 XSETFASTINT (zero
, 0); /* Else extract the part in which */
1129 XSETFASTINT (end
, bestmatchsize
); /* all completions agree */
1130 return Fsubstring (bestmatch
, zero
, end
);
1133 /* Compare exactly LEN chars of strings at S1 and S2,
1134 ignoring case if appropriate.
1135 Return -1 if strings match,
1136 else number of chars that match at the beginning. */
1140 register unsigned char *s1
, *s2
;
1143 register int l
= len
;
1144 register unsigned char *start
= s1
;
1146 if (completion_ignore_case
)
1148 while (l
&& DOWNCASE (*s1
++) == DOWNCASE (*s2
++))
1153 while (l
&& *s1
++ == *s2
++)
1160 int match
= len
- l
;
1162 /* Now *--S1 is the unmatching byte. If it is in the middle of
1163 multi-byte form, we must say that the multi-byte character
1164 there doesn't match. */
1165 while (match
&& *--s1
>= 0xA0) match
--;
1170 DEFUN ("all-completions", Fall_completions
, Sall_completions
, 2, 4, 0,
1171 "Search for partial matches to STRING in ALIST.\n\
1172 Each car of each element of ALIST is tested to see if it begins with STRING.\n\
1173 The value is a list of all the strings from ALIST that match.\n\
1175 ALIST can be an obarray instead of an alist.\n\
1176 Then the print names of all symbols in the obarray are the possible matches.\n\
1178 ALIST can also be a function to do the completion itself.\n\
1179 It receives three arguments: the values STRING, PREDICATE and t.\n\
1180 Whatever it returns becomes the value of `all-completion'.\n\
1182 If optional third argument PREDICATE is non-nil,\n\
1183 it is used to test each possible match.\n\
1184 The match is a candidate only if PREDICATE returns non-nil.\n\
1185 The argument given to PREDICATE is the alist element\n\
1186 or the symbol from the obarray.\n\
1188 If the optional fourth argument HIDE-SPACES is non-nil,\n\
1189 strings in ALIST that start with a space\n\
1190 are ignored unless STRING itself starts with a space.")
1191 (string
, alist
, predicate
, hide_spaces
)
1192 Lisp_Object string
, alist
, predicate
, hide_spaces
;
1194 Lisp_Object tail
, elt
, eltstring
;
1195 Lisp_Object allmatches
;
1196 int list
= CONSP (alist
) || NILP (alist
);
1198 Lisp_Object bucket
, tem
;
1199 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1201 CHECK_STRING (string
, 0);
1202 if (!list
&& !VECTORP (alist
))
1204 return call3 (alist
, string
, predicate
, Qt
);
1208 /* If ALIST is not a list, set TAIL just for gc pro. */
1213 obsize
= XVECTOR (alist
)->size
;
1214 bucket
= XVECTOR (alist
)->contents
[index
];
1219 /* Get the next element of the alist or obarray. */
1220 /* Exit the loop if the elements are all used up. */
1221 /* elt gets the alist element or symbol.
1222 eltstring gets the name to check as a completion. */
1229 eltstring
= Fcar (elt
);
1234 if (XFASTINT (bucket
) != 0)
1237 eltstring
= Fsymbol_name (elt
);
1238 if (XSYMBOL (bucket
)->next
)
1239 XSETSYMBOL (bucket
, XSYMBOL (bucket
)->next
);
1241 XSETFASTINT (bucket
, 0);
1243 else if (++index
>= obsize
)
1247 bucket
= XVECTOR (alist
)->contents
[index
];
1252 /* Is this element a possible completion? */
1254 if (STRINGP (eltstring
)
1255 && XSTRING (string
)->size
<= XSTRING (eltstring
)->size
1256 /* If HIDE_SPACES, reject alternatives that start with space
1257 unless the input starts with space. */
1258 && ((STRING_BYTES (XSTRING (string
)) > 0
1259 && XSTRING (string
)->data
[0] == ' ')
1260 || XSTRING (eltstring
)->data
[0] != ' '
1261 || NILP (hide_spaces
))
1262 && (tem
= Fcompare_strings (eltstring
, make_number (0),
1263 make_number (XSTRING (string
)->size
),
1264 string
, make_number (0),
1265 make_number (XSTRING (string
)->size
),
1266 completion_ignore_case
? Qt
: Qnil
),
1270 Lisp_Object regexps
;
1272 XSETFASTINT (zero
, 0);
1274 /* Ignore this element if it fails to match all the regexps. */
1275 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1276 regexps
= XCONS (regexps
)->cdr
)
1278 tem
= Fstring_match (XCONS (regexps
)->car
, eltstring
, zero
);
1282 if (CONSP (regexps
))
1285 /* Ignore this element if there is a predicate
1286 and the predicate doesn't like it. */
1288 if (!NILP (predicate
))
1290 if (EQ (predicate
, Qcommandp
))
1291 tem
= Fcommandp (elt
);
1294 GCPRO4 (tail
, eltstring
, allmatches
, string
);
1295 tem
= call1 (predicate
, elt
);
1298 if (NILP (tem
)) continue;
1300 /* Ok => put it on the list. */
1301 allmatches
= Fcons (eltstring
, allmatches
);
1305 return Fnreverse (allmatches
);
1308 Lisp_Object Vminibuffer_completion_table
, Qminibuffer_completion_table
;
1309 Lisp_Object Vminibuffer_completion_predicate
, Qminibuffer_completion_predicate
;
1310 Lisp_Object Vminibuffer_completion_confirm
, Qminibuffer_completion_confirm
;
1311 Lisp_Object Vminibuffer_completing_file_name
;
1313 /* This comment supplies the doc string for completing-read,
1314 for make-docfile to see. We cannot put this in the real DEFUN
1315 due to limits in the Unix cpp.
1317 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 8, 0,
1318 "Read a string in the minibuffer, with completion.\n\
1319 PROMPT is a string to prompt with; normally it ends in a colon and a space.\n\
1320 TABLE is an alist whose elements' cars are strings, or an obarray.\n\
1321 PREDICATE limits completion to a subset of TABLE.\n\
1322 See `try-completion' and `all-completions' for more details\n\
1323 on completion, TABLE, and PREDICATE.\n\
1325 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless\n\
1326 the input is (or completes to) an element of TABLE or is null.\n\
1327 If it is also not t, Return does not exit if it does non-null completion.\n\
1328 If the input is null, `completing-read' returns an empty string,\n\
1329 regardless of the value of REQUIRE-MATCH.\n\
1331 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially.\n\
1332 If it is (STRING . POSITION), the initial input\n\
1333 is STRING, but point is placed POSITION characters into the string.\n\
1334 HIST, if non-nil, specifies a history list\n\
1335 and optionally the initial position in the list.\n\
1336 It can be a symbol, which is the history list variable to use,\n\
1337 or it can be a cons cell (HISTVAR . HISTPOS).\n\
1338 In that case, HISTVAR is the history list variable to use,\n\
1339 and HISTPOS is the initial position (the position in the list\n\
1340 which INITIAL-INPUT corresponds to).\n\
1341 Positions are counted starting from 1 at the beginning of the list.\n\
1342 DEF, if non-nil, is the default value.\n\
1344 If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits\n\
1345 the current input method and the setting of enable-multibyte-characters.\n\
1347 Completion ignores case if the ambient value of\n\
1348 `completion-ignore-case' is non-nil."
1350 DEFUN ("completing-read", Fcompleting_read
, Scompleting_read
, 2, 8, 0,
1351 0 /* See immediately above */)
1352 (prompt
, table
, predicate
, require_match
, init
, hist
, def
, inherit_input_method
)
1353 Lisp_Object prompt
, table
, predicate
, require_match
, init
, hist
, def
;
1354 Lisp_Object inherit_input_method
;
1356 Lisp_Object val
, histvar
, histpos
, position
;
1358 int count
= specpdl_ptr
- specpdl
;
1359 struct gcpro gcpro1
;
1360 int disable_multibyte
= ! NILP (Vminibuffer_completing_file_name
);
1364 specbind (Qminibuffer_completion_table
, table
);
1365 specbind (Qminibuffer_completion_predicate
, predicate
);
1366 specbind (Qminibuffer_completion_confirm
,
1367 EQ (require_match
, Qt
) ? Qnil
: Qt
);
1368 last_exact_completion
= Qnil
;
1375 position
= Fcdr (init
);
1378 CHECK_STRING (init
, 0);
1379 if (!NILP (position
))
1381 CHECK_NUMBER (position
, 0);
1382 /* Convert to distance from end of input. */
1383 pos
= XINT (position
) - XSTRING (init
)->size
;
1394 histvar
= Fcar_safe (hist
);
1395 histpos
= Fcdr_safe (hist
);
1398 histvar
= Qminibuffer_history
;
1400 XSETFASTINT (histpos
, 0);
1402 val
= read_minibuf (NILP (require_match
)
1403 ? Vminibuffer_local_completion_map
1404 : Vminibuffer_local_must_match_map
,
1405 init
, prompt
, make_number (pos
), 0,
1406 histvar
, histpos
, def
, 0,
1407 !NILP (inherit_input_method
));
1409 if (STRINGP (val
) && XSTRING (val
)->size
== 0 && ! NILP (def
))
1412 RETURN_UNGCPRO (unbind_to (count
, val
));
1415 Lisp_Object
Fminibuffer_completion_help ();
1416 Lisp_Object
assoc_for_completion ();
1418 /* Test whether TXT is an exact completion. */
1420 test_completion (txt
)
1425 if (CONSP (Vminibuffer_completion_table
)
1426 || NILP (Vminibuffer_completion_table
))
1427 return assoc_for_completion (txt
, Vminibuffer_completion_table
);
1428 else if (VECTORP (Vminibuffer_completion_table
))
1430 /* Bypass intern-soft as that loses for nil */
1431 tem
= oblookup (Vminibuffer_completion_table
,
1432 XSTRING (txt
)->data
,
1433 XSTRING (txt
)->size
,
1434 STRING_BYTES (XSTRING (txt
)));
1437 if (STRING_MULTIBYTE (txt
))
1438 txt
= Fstring_make_unibyte (txt
);
1440 txt
= Fstring_make_multibyte (txt
);
1442 tem
= oblookup (Vminibuffer_completion_table
,
1443 XSTRING (txt
)->data
,
1444 XSTRING (txt
)->size
,
1445 STRING_BYTES (XSTRING (txt
)));
1449 if (!NILP (Vminibuffer_completion_predicate
))
1450 return call1 (Vminibuffer_completion_predicate
, tem
);
1455 return call3 (Vminibuffer_completion_table
, txt
,
1456 Vminibuffer_completion_predicate
, Qlambda
);
1460 * 0 no possible completion
1461 * 1 was already an exact and unique completion
1462 * 3 was already an exact completion
1463 * 4 completed to an exact completion
1464 * 5 some completion happened
1465 * 6 no completion happened
1470 Lisp_Object completion
, tem
;
1473 struct gcpro gcpro1
, gcpro2
;
1475 completion
= Ftry_completion (Fbuffer_string (), Vminibuffer_completion_table
,
1476 Vminibuffer_completion_predicate
);
1477 last
= last_exact_completion
;
1478 last_exact_completion
= Qnil
;
1480 GCPRO2 (completion
, last
);
1482 if (NILP (completion
))
1485 temp_echo_area_glyphs (" [No match]");
1490 if (EQ (completion
, Qt
)) /* exact and unique match */
1497 tem
= Fstring_equal (completion
, Fbuffer_string());
1498 if (completedp
= NILP (tem
))
1500 Ferase_buffer (); /* Some completion happened */
1501 Finsert (1, &completion
);
1504 /* It did find a match. Do we match some possibility exactly now? */
1505 tem
= test_completion (Fbuffer_string ());
1508 /* not an exact match */
1513 Fminibuffer_completion_help ();
1515 temp_echo_area_glyphs (" [Next char not unique]");
1518 else if (completedp
)
1523 /* If the last exact completion and this one were the same,
1524 it means we've already given a "Complete but not unique"
1525 message and the user's hit TAB again, so now we give him help. */
1526 last_exact_completion
= completion
;
1529 tem
= Fbuffer_string ();
1530 if (!NILP (Fequal (tem
, last
)))
1531 Fminibuffer_completion_help ();
1537 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */
1540 assoc_for_completion (key
, list
)
1541 register Lisp_Object key
;
1544 register Lisp_Object tail
;
1546 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
1548 register Lisp_Object elt
, tem
, thiscar
;
1550 if (!CONSP (elt
)) continue;
1551 thiscar
= Fcar (elt
);
1552 if (!STRINGP (thiscar
))
1554 tem
= Fcompare_strings (thiscar
, make_number (0), Qnil
,
1555 key
, make_number (0), Qnil
,
1556 completion_ignore_case
? Qt
: Qnil
);
1564 DEFUN ("minibuffer-complete", Fminibuffer_complete
, Sminibuffer_complete
, 0, 0, "",
1565 "Complete the minibuffer contents as far as possible.\n\
1566 Return nil if there is no valid completion, else t.\n\
1567 If no characters can be completed, display a list of possible completions.\n\
1568 If you repeat this command after it displayed such a list,\n\
1569 scroll the window of possible completions.")
1573 Lisp_Object window
, tem
;
1575 /* If the previous command was not this,
1576 mark the completion buffer obsolete. */
1577 if (! EQ (current_kboard
->Vlast_command
, Vthis_command
))
1578 Vminibuf_scroll_window
= Qnil
;
1580 window
= Vminibuf_scroll_window
;
1581 /* If there's a fresh completion window with a live buffer,
1582 and this command is repeated, scroll that window. */
1583 if (! NILP (window
) && ! NILP (XWINDOW (window
)->buffer
)
1584 && !NILP (XBUFFER (XWINDOW (window
)->buffer
)->name
))
1586 struct buffer
*obuf
= current_buffer
;
1588 Fset_buffer (XWINDOW (window
)->buffer
);
1589 tem
= Fpos_visible_in_window_p (make_number (ZV
), window
);
1591 /* If end is in view, scroll up to the beginning. */
1592 Fset_window_start (window
, make_number (BEGV
), Qnil
);
1594 /* Else scroll down one screen. */
1595 Fscroll_other_window (Qnil
);
1597 set_buffer_internal (obuf
);
1601 i
= do_completion ();
1608 temp_echo_area_glyphs (" [Sole completion]");
1612 temp_echo_area_glyphs (" [Complete, but not unique]");
1619 /* Subroutines of Fminibuffer_complete_and_exit. */
1621 /* This one is called by internal_condition_case to do the real work. */
1624 complete_and_exit_1 ()
1626 return make_number (do_completion ());
1629 /* This one is called by internal_condition_case if an error happens.
1630 Pretend the current value is an exact match. */
1633 complete_and_exit_2 (ignore
)
1636 return make_number (1);
1639 DEFUN ("minibuffer-complete-and-exit", Fminibuffer_complete_and_exit
,
1640 Sminibuffer_complete_and_exit
, 0, 0, "",
1641 "If the minibuffer contents is a valid completion then exit.\n\
1642 Otherwise try to complete it. If completion leads to a valid completion,\n\
1643 a repetition of this command will exit.")
1649 /* Allow user to specify null string */
1650 if (XFASTINT (current_buffer
->minibuffer_prompt_length
) == ZV
)
1653 if (!NILP (test_completion (Fbuffer_string ())))
1656 /* Call do_completion, but ignore errors. */
1657 val
= internal_condition_case (complete_and_exit_1
, Qerror
,
1658 complete_and_exit_2
);
1668 if (!NILP (Vminibuffer_completion_confirm
))
1670 temp_echo_area_glyphs (" [Confirm]");
1680 Fthrow (Qexit
, Qnil
);
1684 DEFUN ("minibuffer-complete-word", Fminibuffer_complete_word
, Sminibuffer_complete_word
,
1686 "Complete the minibuffer contents at most a single word.\n\
1687 After one word is completed as much as possible, a space or hyphen\n\
1688 is added, provided that matches some possible completion.\n\
1689 Return nil if there is no valid completion, else t.")
1692 Lisp_Object completion
, tem
, tem1
;
1693 register int i
, i_byte
;
1694 register unsigned char *completion_string
;
1695 struct gcpro gcpro1
, gcpro2
;
1697 /* We keep calling Fbuffer_string rather than arrange for GC to
1698 hold onto a pointer to one of the strings thus made. */
1700 completion
= Ftry_completion (Fbuffer_string (),
1701 Vminibuffer_completion_table
,
1702 Vminibuffer_completion_predicate
);
1703 if (NILP (completion
))
1706 temp_echo_area_glyphs (" [No match]");
1709 if (EQ (completion
, Qt
))
1712 #if 0 /* How the below code used to look, for reference. */
1713 tem
= Fbuffer_string ();
1714 b
= XSTRING (tem
)->data
;
1715 i
= ZV
- 1 - XSTRING (completion
)->size
;
1716 p
= XSTRING (completion
)->data
;
1718 0 <= scmp (b
, p
, ZV
- 1))
1721 /* Set buffer to longest match of buffer tail and completion head. */
1722 while (0 <= scmp (b
+ i
, p
, ZV
- 1 - i
))
1724 del_range (1, i
+ 1);
1727 #else /* Rewritten code */
1729 int buffer_nchars
, completion_nchars
;
1731 CHECK_STRING (completion
, 0);
1732 tem
= Fbuffer_string ();
1733 GCPRO2 (completion
, tem
);
1734 /* If reading a file name,
1735 expand any $ENVVAR refs in the buffer and in TEM. */
1736 if (! NILP (Vminibuffer_completing_file_name
))
1738 Lisp_Object substituted
;
1739 substituted
= Fsubstitute_in_file_name (tem
);
1740 if (! EQ (substituted
, tem
))
1744 insert_from_string (tem
, 0, 0, XSTRING (tem
)->size
,
1745 STRING_BYTES (XSTRING (tem
)), 0);
1748 buffer_nchars
= XSTRING (tem
)->size
; /* ie ZV - BEGV */
1749 completion_nchars
= XSTRING (completion
)->size
;
1750 i
= buffer_nchars
- completion_nchars
;
1753 (tem1
= Fcompare_strings (tem
, make_number (0),
1754 make_number (buffer_nchars
),
1755 completion
, make_number (0),
1756 make_number (buffer_nchars
),
1757 completion_ignore_case
? Qt
: Qnil
),
1762 /* Set buffer to longest match of buffer tail and completion head. */
1768 tem1
= Fcompare_strings (tem
, make_number (start_pos
), Qnil
,
1769 completion
, make_number (0),
1770 make_number (buffer_nchars
),
1771 completion_ignore_case
? Qt
: Qnil
);
1778 del_range (1, i
+ 1);
1779 SET_PT_BOTH (ZV
, ZV_BYTE
);
1783 #endif /* Rewritten code */
1786 int prompt_end_charpos
, prompt_end_bytepos
;
1787 prompt_end_charpos
= XFASTINT (current_buffer
->minibuffer_prompt_length
);
1788 prompt_end_bytepos
= CHAR_TO_BYTE (prompt_end_charpos
);
1789 i
= ZV
- prompt_end_charpos
;
1790 i_byte
= ZV_BYTE
- prompt_end_bytepos
;
1793 /* If completion finds next char not unique,
1794 consider adding a space or a hyphen. */
1795 if (i
== XSTRING (completion
)->size
)
1797 GCPRO1 (completion
);
1798 tem
= Ftry_completion (concat2 (Fbuffer_string (), build_string (" ")),
1799 Vminibuffer_completion_table
,
1800 Vminibuffer_completion_predicate
);
1807 GCPRO1 (completion
);
1809 Ftry_completion (concat2 (Fbuffer_string (), build_string ("-")),
1810 Vminibuffer_completion_table
,
1811 Vminibuffer_completion_predicate
);
1819 /* Now find first word-break in the stuff found by completion.
1820 i gets index in string of where to stop completing. */
1824 completion_string
= XSTRING (completion
)->data
;
1825 for (; i_byte
< STRING_BYTES (XSTRING (completion
)); i_byte
+= len
, i
++)
1827 c
= STRING_CHAR_AND_LENGTH (completion_string
+ i_byte
,
1828 XSTRING (completion
)->size
- i_byte
,
1830 if (SYNTAX (c
) != Sword
)
1839 /* If got no characters, print help for user. */
1841 if (i
== ZV
- XFASTINT (current_buffer
->minibuffer_prompt_length
))
1844 Fminibuffer_completion_help ();
1848 /* Otherwise insert in minibuffer the chars we got */
1851 insert_from_string (completion
, 0, 0, i
, i_byte
, 1);
1855 DEFUN ("display-completion-list", Fdisplay_completion_list
, Sdisplay_completion_list
,
1857 "Display the list of completions, COMPLETIONS, using `standard-output'.\n\
1858 Each element may be just a symbol or string\n\
1859 or may be a list of two strings to be printed as if concatenated.\n\
1860 `standard-output' must be a buffer.\n\
1861 The actual completion alternatives, as inserted, are given `mouse-face'\n\
1862 properties of `highlight'.\n\
1863 At the end, this runs the normal hook `completion-setup-hook'.\n\
1864 It can find the completion buffer in `standard-output'.")
1866 Lisp_Object completions
;
1868 Lisp_Object tail
, elt
;
1871 struct gcpro gcpro1
, gcpro2
;
1872 struct buffer
*old
= current_buffer
;
1875 /* Note that (when it matters) every variable
1876 points to a non-string that is pointed to by COMPLETIONS,
1877 except for ELT. ELT can be pointing to a string
1878 when terpri or Findent_to calls a change hook. */
1880 GCPRO2 (completions
, elt
);
1882 if (BUFFERP (Vstandard_output
))
1883 set_buffer_internal (XBUFFER (Vstandard_output
));
1885 if (NILP (completions
))
1886 write_string ("There are no possible completions of what you have typed.",
1890 write_string ("Possible completions are:", -1);
1891 for (tail
= completions
, i
= 0; !NILP (tail
); tail
= Fcdr (tail
), i
++)
1893 Lisp_Object tem
, string
;
1895 Lisp_Object startpos
, endpos
;
1898 /* Compute the length of this element. */
1902 CHECK_STRING (tem
, 0);
1903 length
= XSTRING (tem
)->size
;
1905 tem
= Fcar (XCDR (elt
));
1906 CHECK_STRING (tem
, 0);
1907 length
+= XSTRING (tem
)->size
;
1911 CHECK_STRING (elt
, 0);
1912 length
= XSTRING (elt
)->size
;
1915 /* This does a bad job for narrower than usual windows.
1916 Sadly, the window it will appear in is not known
1917 until after the text has been made. */
1919 if (BUFFERP (Vstandard_output
))
1920 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1922 /* If the previous completion was very wide,
1923 or we have two on this line already,
1924 don't put another on the same line. */
1925 if (column
> 33 || first
1926 /* If this is really wide, don't put it second on a line. */
1927 || column
> 0 && length
> 45)
1932 /* Otherwise advance to column 35. */
1935 if (BUFFERP (Vstandard_output
))
1937 tem
= Findent_to (make_number (35), make_number (2));
1939 column
= XINT (tem
);
1945 write_string (" ", -1);
1948 while (column
< 35);
1952 if (BUFFERP (Vstandard_output
))
1954 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1955 Fset_text_properties (startpos
, endpos
,
1956 Qnil
, Vstandard_output
);
1959 /* Output this element.
1960 If necessary, convert it to unibyte or to multibyte first. */
1962 string
= Fcar (elt
);
1965 if (NILP (current_buffer
->enable_multibyte_characters
)
1966 && STRING_MULTIBYTE (string
))
1967 string
= Fstring_make_unibyte (string
);
1968 else if (!NILP (current_buffer
->enable_multibyte_characters
)
1969 && !STRING_MULTIBYTE (string
))
1970 string
= Fstring_make_multibyte (string
);
1972 if (BUFFERP (Vstandard_output
))
1974 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1976 Fprinc (string
, Qnil
);
1978 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1980 Fput_text_property (startpos
, endpos
,
1981 Qmouse_face
, intern ("highlight"),
1986 Fprinc (string
, Qnil
);
1989 /* Output the annotation for this element. */
1992 if (BUFFERP (Vstandard_output
))
1994 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1996 Fprinc (Fcar (Fcdr (elt
)), Qnil
);
1998 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2000 Fset_text_properties (startpos
, endpos
, Qnil
,
2005 Fprinc (Fcar (Fcdr (elt
)), Qnil
);
2010 /* Update COLUMN for what we have output. */
2013 /* If output is to a buffer, recompute COLUMN in a way
2014 that takes account of character widths. */
2015 if (BUFFERP (Vstandard_output
))
2017 tem
= Fcurrent_column ();
2018 column
= XINT (tem
);
2027 if (BUFFERP (Vstandard_output
))
2028 set_buffer_internal (old
);
2030 if (!NILP (Vrun_hooks
))
2031 call1 (Vrun_hooks
, intern ("completion-setup-hook"));
2036 DEFUN ("minibuffer-completion-help", Fminibuffer_completion_help
, Sminibuffer_completion_help
,
2038 "Display a list of possible completions of the current minibuffer contents.")
2041 Lisp_Object completions
;
2043 message ("Making completion list...");
2044 completions
= Fall_completions (Fbuffer_string (),
2045 Vminibuffer_completion_table
,
2046 Vminibuffer_completion_predicate
,
2048 clear_message (1, 0);
2050 if (NILP (completions
))
2053 temp_echo_area_glyphs (" [No completions]");
2056 internal_with_output_to_temp_buffer ("*Completions*",
2057 Fdisplay_completion_list
,
2058 Fsort (completions
, Qstring_lessp
));
2062 DEFUN ("self-insert-and-exit", Fself_insert_and_exit
, Sself_insert_and_exit
, 0, 0, "",
2063 "Terminate minibuffer input.")
2066 if (INTEGERP (last_command_char
))
2067 internal_self_insert (XINT (last_command_char
), 0);
2071 Fthrow (Qexit
, Qnil
);
2074 DEFUN ("exit-minibuffer", Fexit_minibuffer
, Sexit_minibuffer
, 0, 0, "",
2075 "Terminate this minibuffer argument.")
2078 Fthrow (Qexit
, Qnil
);
2081 DEFUN ("minibuffer-depth", Fminibuffer_depth
, Sminibuffer_depth
, 0, 0, 0,
2082 "Return current depth of activations of minibuffer, a nonnegative integer.")
2085 return make_number (minibuf_level
);
2088 DEFUN ("minibuffer-prompt", Fminibuffer_prompt
, Sminibuffer_prompt
, 0, 0, 0,
2089 "Return the prompt string of the currently-active minibuffer.\n\
2090 If no minibuffer is active, return nil.")
2093 return Fcopy_sequence (minibuf_prompt
);
2096 DEFUN ("minibuffer-prompt-width", Fminibuffer_prompt_width
,
2097 Sminibuffer_prompt_width
, 0, 0, 0,
2098 "Return the display width of the minibuffer prompt.\n\
2099 Return 0 if current buffer is not a mini-buffer.")
2103 if (NILP (current_buffer
->minibuffer_prompt_length
))
2104 width
= make_number (0);
2106 width
= make_number (current_buffer
->minibuffer_prompt_length
);
2111 DEFUN ("minibuffer-prompt-end", Fminibuffer_prompt_end
,
2112 Sminibuffer_prompt_end
, 0, 0, 0,
2113 "Return the end buffer position of the mini-buffer prompt.\n\
2114 Value is 0 if current buffer is not a mini-buffer.")
2117 return (NILP (current_buffer
->minibuffer_prompt_length
)
2119 : make_number (current_buffer
->minibuffer_prompt_length
));
2124 /* Temporarily display the string M at the end of the current
2125 minibuffer contents. This is used to display things like
2126 "[No Match]" when the user requests a completion for a prefix
2127 that has no possible completions, and other quick, unobtrusive
2131 temp_echo_area_glyphs (m
)
2135 int osize_byte
= ZV_BYTE
;
2137 int opoint_byte
= PT_BYTE
;
2138 Lisp_Object oinhibit
;
2139 oinhibit
= Vinhibit_quit
;
2141 /* Clear out any old echo-area message to make way for our new thing. */
2144 SET_PT_BOTH (osize
, osize_byte
);
2146 SET_PT_BOTH (opoint
, opoint_byte
);
2148 Fsit_for (make_number (2), Qnil
, Qnil
);
2149 del_range_both (osize
, osize_byte
, ZV
, ZV_BYTE
, 1);
2150 SET_PT_BOTH (opoint
, opoint_byte
);
2151 if (!NILP (Vquit_flag
))
2154 Vunread_command_events
= Fcons (make_number (quit_char
), Qnil
);
2156 Vinhibit_quit
= oinhibit
;
2159 DEFUN ("minibuffer-message", Fminibuffer_message
, Sminibuffer_message
,
2161 "Temporarily display STRING at the end of the minibuffer.\n\
2162 The text is displayed for two seconds,\n\
2163 or until the next input event arrives, whichever comes first.")
2167 temp_echo_area_glyphs (XSTRING (string
)->data
);
2172 init_minibuf_once ()
2174 Vminibuffer_list
= Qnil
;
2175 staticpro (&Vminibuffer_list
);
2182 minibuf_prompt
= Qnil
;
2183 staticpro (&minibuf_prompt
);
2185 minibuf_save_list
= Qnil
;
2186 staticpro (&minibuf_save_list
);
2188 Qread_file_name_internal
= intern ("read-file-name-internal");
2189 staticpro (&Qread_file_name_internal
);
2191 Qminibuffer_default
= intern ("minibuffer-default");
2192 staticpro (&Qminibuffer_default
);
2193 Fset (Qminibuffer_default
, Qnil
);
2195 Qminibuffer_completion_table
= intern ("minibuffer-completion-table");
2196 staticpro (&Qminibuffer_completion_table
);
2198 Qminibuffer_completion_confirm
= intern ("minibuffer-completion-confirm");
2199 staticpro (&Qminibuffer_completion_confirm
);
2201 Qminibuffer_completion_predicate
= intern ("minibuffer-completion-predicate");
2202 staticpro (&Qminibuffer_completion_predicate
);
2204 staticpro (&last_exact_completion
);
2205 last_exact_completion
= Qnil
;
2207 staticpro (&last_minibuf_string
);
2208 last_minibuf_string
= Qnil
;
2210 Quser_variable_p
= intern ("user-variable-p");
2211 staticpro (&Quser_variable_p
);
2213 Qminibuffer_history
= intern ("minibuffer-history");
2214 staticpro (&Qminibuffer_history
);
2216 Qbuffer_name_history
= intern ("buffer-name-history");
2217 staticpro (&Qbuffer_name_history
);
2218 Fset (Qbuffer_name_history
, Qnil
);
2220 Qminibuffer_setup_hook
= intern ("minibuffer-setup-hook");
2221 staticpro (&Qminibuffer_setup_hook
);
2223 Qminibuffer_exit_hook
= intern ("minibuffer-exit-hook");
2224 staticpro (&Qminibuffer_exit_hook
);
2226 Qhistory_length
= intern ("history-length");
2227 staticpro (&Qhistory_length
);
2229 Qcurrent_input_method
= intern ("current-input-method");
2230 staticpro (&Qcurrent_input_method
);
2232 Qactivate_input_method
= intern ("activate-input-method");
2233 staticpro (&Qactivate_input_method
);
2235 DEFVAR_LISP ("read-buffer-function", &Vread_buffer_function
,
2236 "If this is non-nil, `read-buffer' does its work by calling this function.");
2237 Vread_buffer_function
= Qnil
;
2239 DEFVAR_LISP ("minibuffer-setup-hook", &Vminibuffer_setup_hook
,
2240 "Normal hook run just after entry to minibuffer.");
2241 Vminibuffer_setup_hook
= Qnil
;
2243 DEFVAR_LISP ("minibuffer-exit-hook", &Vminibuffer_exit_hook
,
2244 "Normal hook run just after exit from minibuffer.");
2245 Vminibuffer_exit_hook
= Qnil
;
2247 DEFVAR_LISP ("history-length", &Vhistory_length
,
2248 "*Maximum length for history lists before truncation takes place.\n\
2249 A number means that length; t means infinite. Truncation takes place\n\
2250 just after a new element is inserted. Setting the history-length\n\
2251 property of a history variable overrides this default.");
2252 XSETFASTINT (Vhistory_length
, 30);
2254 DEFVAR_BOOL ("completion-auto-help", &auto_help
,
2255 "*Non-nil means automatically provide help for invalid completion input.");
2258 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case
,
2259 "Non-nil means don't consider case significant in completion.");
2260 completion_ignore_case
= 0;
2262 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers
,
2263 "*Non-nil means to allow minibuffer commands while in the minibuffer.\n\
2264 This variable makes a difference whenever the minibuffer window is active.");
2265 enable_recursive_minibuffers
= 0;
2267 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table
,
2268 "Alist or obarray used for completion in the minibuffer.\n\
2269 This becomes the ALIST argument to `try-completion' and `all-completion'.\n\
2271 The value may alternatively be a function, which is given three arguments:\n\
2272 STRING, the current buffer contents;\n\
2273 PREDICATE, the predicate for filtering possible matches;\n\
2274 CODE, which says what kind of things to do.\n\
2275 CODE can be nil, t or `lambda'.\n\
2276 nil means to return the best completion of STRING, or nil if there is none.\n\
2277 t means to return a list of all possible completions of STRING.\n\
2278 `lambda' means to return t if STRING is a valid completion as it stands.");
2279 Vminibuffer_completion_table
= Qnil
;
2281 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate
,
2282 "Within call to `completing-read', this holds the PREDICATE argument.");
2283 Vminibuffer_completion_predicate
= Qnil
;
2285 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm
,
2286 "Non-nil => demand confirmation of completion before exiting minibuffer.");
2287 Vminibuffer_completion_confirm
= Qnil
;
2289 DEFVAR_LISP ("minibuffer-completing-file-name",
2290 &Vminibuffer_completing_file_name
,
2291 "Non-nil means completing file names.");
2292 Vminibuffer_completing_file_name
= Qnil
;
2294 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form
,
2295 "Value that `help-form' takes on inside the minibuffer.");
2296 Vminibuffer_help_form
= Qnil
;
2298 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable
,
2299 "History list symbol to add minibuffer values to.\n\
2300 Each string of minibuffer input, as it appears on exit from the minibuffer,\n\
2302 (set minibuffer-history-variable\n\
2303 (cons STRING (symbol-value minibuffer-history-variable)))");
2304 XSETFASTINT (Vminibuffer_history_variable
, 0);
2306 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position
,
2307 "Current position of redoing in the history list.");
2308 Vminibuffer_history_position
= Qnil
;
2310 DEFVAR_BOOL ("minibuffer-auto-raise", &minibuffer_auto_raise
,
2311 "*Non-nil means entering the minibuffer raises the minibuffer's frame.\n\
2312 Some uses of the echo area also raise that frame (since they use it too).");
2313 minibuffer_auto_raise
= 0;
2315 DEFVAR_LISP ("completion-regexp-list", &Vcompletion_regexp_list
,
2316 "List of regexps that should restrict possible completions.");
2317 Vcompletion_regexp_list
= Qnil
;
2319 DEFVAR_BOOL ("minibuffer-allow-text-properties",
2320 &minibuffer_allow_text_properties
,
2321 "Non-nil means `read-from-minibuffer' should not discard text properties.\n\
2322 This also affects `read-string', but it does not affect `read-minibuffer',\n\
2323 `read-no-blanks-input', or any of the functions that do minibuffer input\n\
2324 with completion; they always discard text properties.");
2325 minibuffer_allow_text_properties
= 0;
2327 defsubr (&Sset_minibuffer_window
);
2328 defsubr (&Sread_from_minibuffer
);
2329 defsubr (&Seval_minibuffer
);
2330 defsubr (&Sread_minibuffer
);
2331 defsubr (&Sread_string
);
2332 defsubr (&Sread_command
);
2333 defsubr (&Sread_variable
);
2334 defsubr (&Sread_buffer
);
2335 defsubr (&Sread_no_blanks_input
);
2336 defsubr (&Sminibuffer_depth
);
2337 defsubr (&Sminibuffer_prompt
);
2338 defsubr (&Sminibuffer_prompt_width
);
2339 defsubr (&Sminibuffer_prompt_end
);
2341 defsubr (&Stry_completion
);
2342 defsubr (&Sall_completions
);
2343 defsubr (&Scompleting_read
);
2344 defsubr (&Sminibuffer_complete
);
2345 defsubr (&Sminibuffer_complete_word
);
2346 defsubr (&Sminibuffer_complete_and_exit
);
2347 defsubr (&Sdisplay_completion_list
);
2348 defsubr (&Sminibuffer_completion_help
);
2350 defsubr (&Sself_insert_and_exit
);
2351 defsubr (&Sexit_minibuffer
);
2353 defsubr (&Sminibuffer_message
);
2359 initial_define_key (Vminibuffer_local_map
, Ctl ('g'),
2360 "abort-recursive-edit");
2361 initial_define_key (Vminibuffer_local_map
, Ctl ('m'),
2363 initial_define_key (Vminibuffer_local_map
, Ctl ('j'),
2366 initial_define_key (Vminibuffer_local_ns_map
, Ctl ('g'),
2367 "abort-recursive-edit");
2368 initial_define_key (Vminibuffer_local_ns_map
, Ctl ('m'),
2370 initial_define_key (Vminibuffer_local_ns_map
, Ctl ('j'),
2373 initial_define_key (Vminibuffer_local_ns_map
, ' ',
2375 initial_define_key (Vminibuffer_local_ns_map
, '\t',
2377 initial_define_key (Vminibuffer_local_ns_map
, '?',
2378 "self-insert-and-exit");
2380 initial_define_key (Vminibuffer_local_completion_map
, Ctl ('g'),
2381 "abort-recursive-edit");
2382 initial_define_key (Vminibuffer_local_completion_map
, Ctl ('m'),
2384 initial_define_key (Vminibuffer_local_completion_map
, Ctl ('j'),
2387 initial_define_key (Vminibuffer_local_completion_map
, '\t',
2388 "minibuffer-complete");
2389 initial_define_key (Vminibuffer_local_completion_map
, ' ',
2390 "minibuffer-complete-word");
2391 initial_define_key (Vminibuffer_local_completion_map
, '?',
2392 "minibuffer-completion-help");
2394 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('g'),
2395 "abort-recursive-edit");
2396 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('m'),
2397 "minibuffer-complete-and-exit");
2398 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('j'),
2399 "minibuffer-complete-and-exit");
2400 initial_define_key (Vminibuffer_local_must_match_map
, '\t',
2401 "minibuffer-complete");
2402 initial_define_key (Vminibuffer_local_must_match_map
, ' ',
2403 "minibuffer-complete-word");
2404 initial_define_key (Vminibuffer_local_must_match_map
, '?',
2405 "minibuffer-completion-help");