1 /* Minibuffer input and completion.
2 Copyright (C) 1985, 1986, 1993, 1994, 1995, 1996, 1997, 1998, 1999
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. */
29 #include "dispextern.h"
35 #define min(a, b) ((a) < (b) ? (a) : (b))
39 /* List of buffers for use as minibuffers.
40 The first element of the list is used for the outermost minibuffer
41 invocation, the next element is used for a recursive minibuffer
42 invocation, etc. The list is extended at the end as deeper
43 minibuffer recursions are encountered. */
45 Lisp_Object Vminibuffer_list
;
47 /* Data to remember during recursive minibuffer invocations */
49 Lisp_Object minibuf_save_list
;
51 /* Depth in minibuffer invocations. */
55 /* Nonzero means display completion help for invalid input. */
59 /* The maximum length of a minibuffer history. */
61 Lisp_Object Qhistory_length
, Vhistory_length
;
63 /* Fread_minibuffer leaves the input here as a string. */
65 Lisp_Object last_minibuf_string
;
67 /* Nonzero means let functions called when within a minibuffer
68 invoke recursive minibuffers (to read arguments, or whatever) */
70 int enable_recursive_minibuffers
;
72 /* Nonzero means don't ignore text properties
73 in Fread_from_minibuffer. */
75 int minibuffer_allow_text_properties
;
77 /* help-form is bound to this while in the minibuffer. */
79 Lisp_Object Vminibuffer_help_form
;
81 /* Variable which is the history list to add minibuffer values to. */
83 Lisp_Object Vminibuffer_history_variable
;
85 /* Current position in the history list (adjusted by M-n and M-p). */
87 Lisp_Object Vminibuffer_history_position
;
89 Lisp_Object Qminibuffer_history
, Qbuffer_name_history
;
91 Lisp_Object Qread_file_name_internal
;
93 /* Normal hooks for entry to and exit from minibuffer. */
95 Lisp_Object Qminibuffer_setup_hook
, Vminibuffer_setup_hook
;
96 Lisp_Object Qminibuffer_exit_hook
, Vminibuffer_exit_hook
;
98 /* Function to call to read a buffer name. */
99 Lisp_Object Vread_buffer_function
;
101 /* Nonzero means completion ignores case. */
103 int completion_ignore_case
;
105 /* List of regexps that should restrict possible completions. */
107 Lisp_Object Vcompletion_regexp_list
;
109 /* Nonzero means raise the minibuffer frame when the minibuffer
112 int minibuffer_auto_raise
;
114 /* If last completion attempt reported "Complete but not unique"
115 then this is the string completed then; otherwise this is nil. */
117 static Lisp_Object last_exact_completion
;
119 /* Non-nil means it is the window for C-M-v to scroll
120 when the minibuffer is selected. */
122 extern Lisp_Object Vminibuf_scroll_window
;
124 extern Lisp_Object Voverriding_local_map
;
126 Lisp_Object Quser_variable_p
;
128 Lisp_Object Qminibuffer_default
;
130 Lisp_Object Qcurrent_input_method
, Qactivate_input_method
;
132 extern Lisp_Object Qmouse_face
;
134 extern Lisp_Object Qfield
;
136 /* Put minibuf on currently selected frame's minibuffer.
137 We do this whenever the user starts a new minibuffer
138 or when a minibuffer exits. */
141 choose_minibuf_frame ()
143 if (FRAMEP (selected_frame
)
144 && FRAME_LIVE_P (XFRAME (selected_frame
))
145 && !EQ (minibuf_window
, XFRAME (selected_frame
)->minibuffer_window
))
147 struct frame
*sf
= XFRAME (selected_frame
);
150 /* I don't think that any frames may validly have a null minibuffer
152 if (NILP (sf
->minibuffer_window
))
155 /* Under X, we come here with minibuf_window being the
156 minibuffer window of the unused termcap window created in
157 init_window_once. That window doesn't have a buffer. */
158 buffer
= XWINDOW (minibuf_window
)->buffer
;
159 if (BUFFERP (buffer
))
160 Fset_window_buffer (sf
->minibuffer_window
, buffer
);
161 minibuf_window
= sf
->minibuffer_window
;
164 /* Make sure no other frame has a minibuffer as its selected window,
165 because the text would not be displayed in it, and that would be
166 confusing. Only allow the selected frame to do this,
167 and that only if the minibuffer is active. */
169 Lisp_Object tail
, frame
;
171 FOR_EACH_FRAME (tail
, frame
)
172 if (MINI_WINDOW_P (XWINDOW (FRAME_SELECTED_WINDOW (XFRAME (frame
))))
173 && !(EQ (frame
, selected_frame
)
174 && minibuf_level
> 0))
175 Fset_frame_selected_window (frame
, Fframe_first_window (frame
));
180 choose_minibuf_frame_1 (ignore
)
183 choose_minibuf_frame ();
187 DEFUN ("set-minibuffer-window", Fset_minibuffer_window
,
188 Sset_minibuffer_window
, 1, 1, 0,
189 "Specify which minibuffer window to use for the minibuffer.\n\
190 This effects where the minibuffer is displayed if you put text in it\n\
191 without invoking the usual minibuffer commands.")
195 CHECK_WINDOW (window
, 1);
196 if (! MINI_WINDOW_P (XWINDOW (window
)))
197 error ("Window is not a minibuffer window");
199 minibuf_window
= window
;
205 /* Actual minibuffer invocation. */
207 static Lisp_Object read_minibuf_unwind
P_ ((Lisp_Object
));
208 static Lisp_Object read_minibuf
P_ ((Lisp_Object
, Lisp_Object
,
209 Lisp_Object
, Lisp_Object
,
211 Lisp_Object
, Lisp_Object
,
214 /* Read from the minibuffer using keymap MAP, initial contents INITIAL
215 (a string), putting point minus BACKUP_N bytes from the end of INITIAL,
216 prompting with PROMPT (a string), using history list HISTVAR
217 with initial position HISTPOS. (BACKUP_N should be <= 0.)
219 Normally return the result as a string (the text that was read),
220 but if EXPFLAG is nonzero, read it and return the object read.
221 If HISTVAR is given, save the value read on that history only if it doesn't
222 match the front of that history list exactly. The value is pushed onto
223 the list as the string that was read.
225 DEFALT specifies te default value for the sake of history commands.
227 If ALLOW_PROPS is nonzero, we do not throw away text properties.
229 if INHERIT_INPUT_METHOD is nonzeor, the minibuffer inherit the
230 current input method. */
233 read_minibuf (map
, initial
, prompt
, backup_n
, expflag
,
234 histvar
, histpos
, defalt
, allow_props
, inherit_input_method
)
238 Lisp_Object backup_n
;
244 int inherit_input_method
;
247 int count
= specpdl_ptr
- specpdl
;
248 Lisp_Object mini_frame
, ambient_dir
, minibuffer
, input_method
;
249 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
250 Lisp_Object enable_multibyte
;
251 extern Lisp_Object Qread_only
, Qfront_sticky
;
252 extern Lisp_Object Qrear_nonsticky
;
254 specbind (Qminibuffer_default
, defalt
);
256 single_kboard_state ();
259 ambient_dir
= current_buffer
->directory
;
261 enable_multibyte
= Qnil
;
263 /* Don't need to protect PROMPT, HISTVAR, and HISTPOS because we
264 store them away before we can GC. Don't need to protect
265 BACKUP_N because we use the value only if it is an integer. */
266 GCPRO5 (map
, initial
, val
, ambient_dir
, input_method
);
268 if (!STRINGP (prompt
))
269 prompt
= build_string ("");
271 if (!enable_recursive_minibuffers
272 && minibuf_level
> 0)
274 if (EQ (selected_window
, minibuf_window
))
275 error ("Command attempted to use minibuffer while in minibuffer");
277 /* If we're in another window, cancel the minibuffer that's active. */
279 build_string ("Command attempted to use minibuffer while in minibuffer"));
282 /* Choose the minibuffer window and frame, and take action on them. */
284 choose_minibuf_frame ();
286 record_unwind_protect (choose_minibuf_frame_1
, Qnil
);
288 record_unwind_protect (Fset_window_configuration
,
289 Fcurrent_window_configuration (Qnil
));
291 /* If the minibuffer window is on a different frame, save that
292 frame's configuration too. */
293 mini_frame
= WINDOW_FRAME (XWINDOW (minibuf_window
));
294 if (!EQ (mini_frame
, selected_frame
))
295 record_unwind_protect (Fset_window_configuration
,
296 Fcurrent_window_configuration (mini_frame
));
298 /* If the minibuffer is on an iconified or invisible frame,
299 make it visible now. */
300 Fmake_frame_visible (mini_frame
);
302 if (minibuffer_auto_raise
)
303 Fraise_frame (mini_frame
);
305 /* We have to do this after saving the window configuration
306 since that is what restores the current buffer. */
308 /* Arrange to restore a number of minibuffer-related variables.
309 We could bind each variable separately, but that would use lots of
312 = Fcons (Voverriding_local_map
,
313 Fcons (minibuf_window
, minibuf_save_list
));
315 = Fcons (minibuf_prompt
,
316 Fcons (make_number (minibuf_prompt_width
),
318 Fcons (Vcurrent_prefix_arg
,
319 Fcons (Vminibuffer_history_position
,
320 Fcons (Vminibuffer_history_variable
,
321 minibuf_save_list
))))));
323 record_unwind_protect (read_minibuf_unwind
, Qnil
);
326 /* Now that we can restore all those variables, start changing them. */
328 minibuf_prompt_width
= 0;
329 minibuf_prompt
= Fcopy_sequence (prompt
);
330 Vminibuffer_history_position
= histpos
;
331 Vminibuffer_history_variable
= histvar
;
332 Vhelp_form
= Vminibuffer_help_form
;
334 if (inherit_input_method
)
336 /* `current-input-method' is buffer local. So, remeber it in
337 INPUT_METHOD before changing the current buffer. */
338 input_method
= Fsymbol_value (Qcurrent_input_method
);
339 enable_multibyte
= current_buffer
->enable_multibyte_characters
;
342 /* Switch to the minibuffer. */
344 minibuffer
= get_minibuffer (minibuf_level
);
345 Fset_buffer (minibuffer
);
347 /* The current buffer's default directory is usually the right thing
348 for our minibuffer here. However, if you're typing a command at
349 a minibuffer-only frame when minibuf_level is zero, then buf IS
350 the current_buffer, so reset_buffer leaves buf's default
351 directory unchanged. This is a bummer when you've just started
352 up Emacs and buf's default directory is Qnil. Here's a hack; can
353 you think of something better to do? Find another buffer with a
354 better directory, and use that one instead. */
355 if (STRINGP (ambient_dir
))
356 current_buffer
->directory
= ambient_dir
;
359 Lisp_Object buf_list
;
361 for (buf_list
= Vbuffer_alist
;
363 buf_list
= XCDR (buf_list
))
365 Lisp_Object other_buf
;
367 other_buf
= XCDR (XCAR (buf_list
));
368 if (STRINGP (XBUFFER (other_buf
)->directory
))
370 current_buffer
->directory
= XBUFFER (other_buf
)->directory
;
376 if (!EQ (mini_frame
, selected_frame
))
377 Fredirect_frame_focus (selected_frame
, mini_frame
);
379 Vminibuf_scroll_window
= selected_window
;
380 Fset_window_buffer (minibuf_window
, Fcurrent_buffer ());
381 Fselect_window (minibuf_window
);
382 XSETFASTINT (XWINDOW (minibuf_window
)->hscroll
, 0);
384 Fmake_local_variable (Qprint_escape_newlines
);
385 print_escape_newlines
= 1;
387 /* Erase the buffer. */
389 int count1
= specpdl_ptr
- specpdl
;
390 specbind (Qinhibit_read_only
, Qt
);
392 unbind_to (count1
, Qnil
);
395 if (!NILP (current_buffer
->enable_multibyte_characters
)
396 && ! STRING_MULTIBYTE (minibuf_prompt
))
397 minibuf_prompt
= Fstring_make_multibyte (minibuf_prompt
);
399 /* Insert the prompt, record where it ends. */
400 Finsert (1, &minibuf_prompt
);
403 Fput_text_property (make_number (BEG
), make_number (PT
),
404 Qfront_sticky
, Qt
, Qnil
);
405 Fput_text_property (make_number (BEG
), make_number (PT
),
406 Qrear_nonsticky
, Qt
, Qnil
);
407 Fput_text_property (make_number (BEG
), make_number (PT
),
409 Fput_text_property (make_number (BEG
), make_number (PT
),
410 Qread_only
, Qt
, Qnil
);
413 minibuf_prompt_width
= current_column ();
415 /* If appropriate, copy enable-multibyte-characters into the minibuffer. */
416 if (inherit_input_method
)
417 current_buffer
->enable_multibyte_characters
= enable_multibyte
;
419 /* Put in the initial input. */
422 Finsert (1, &initial
);
423 if (INTEGERP (backup_n
))
424 Fforward_char (backup_n
);
427 clear_message (1, 1);
428 current_buffer
->keymap
= map
;
430 /* Turn on an input method stored in INPUT_METHOD if any. */
431 if (STRINGP (input_method
) && !NILP (Ffboundp (Qactivate_input_method
)))
432 call1 (Qactivate_input_method
, input_method
);
434 /* Run our hook, but not if it is empty.
435 (run-hooks would do nothing if it is empty,
436 but it's important to save time here in the usual case). */
437 if (!NILP (Vminibuffer_setup_hook
) && !EQ (Vminibuffer_setup_hook
, Qunbound
)
438 && !NILP (Vrun_hooks
))
439 call1 (Vrun_hooks
, Qminibuffer_setup_hook
);
443 /* If cursor is on the minibuffer line,
444 show the user we have exited by putting it in column 0. */
445 if (XWINDOW (minibuf_window
)->cursor
.vpos
>= 0
448 XWINDOW (minibuf_window
)->cursor
.hpos
= 0;
449 XWINDOW (minibuf_window
)->cursor
.x
= 0;
450 XWINDOW (minibuf_window
)->must_be_updated_p
= 1;
451 update_frame (XFRAME (selected_frame
), 1, 1);
452 if (rif
&& rif
->flush_display
)
453 rif
->flush_display (XFRAME (XWINDOW (minibuf_window
)->frame
));
456 /* Make minibuffer contents into a string. */
457 Fset_buffer (minibuffer
);
458 val
= Ffield_string (make_number (ZV
), allow_props
? Qt
: Qnil
);
460 /* VAL is the string of minibuffer text. */
462 last_minibuf_string
= val
;
464 /* Add the value to the appropriate history list unless it is empty. */
465 if (XSTRING (val
)->size
!= 0
466 && SYMBOLP (Vminibuffer_history_variable
))
468 /* If the caller wanted to save the value read on a history list,
469 then do so if the value is not already the front of the list. */
472 /* If variable is unbound, make it nil. */
473 if (EQ (XSYMBOL (Vminibuffer_history_variable
)->value
, Qunbound
))
474 Fset (Vminibuffer_history_variable
, Qnil
);
476 histval
= Fsymbol_value (Vminibuffer_history_variable
);
478 /* The value of the history variable must be a cons or nil. Other
479 values are unacceptable. We silently ignore these values. */
482 && NILP (Fequal (last_minibuf_string
, Fcar (histval
)))))
486 histval
= Fcons (last_minibuf_string
, histval
);
487 Fset (Vminibuffer_history_variable
, histval
);
489 /* Truncate if requested. */
490 length
= Fget (Vminibuffer_history_variable
, Qhistory_length
);
491 if (NILP (length
)) length
= Vhistory_length
;
492 if (INTEGERP (length
))
494 if (XINT (length
) <= 0)
495 Fset (Vminibuffer_history_variable
, Qnil
);
500 temp
= Fnthcdr (Fsub1 (length
), histval
);
501 if (CONSP (temp
)) Fsetcdr (temp
, Qnil
);
507 /* If Lisp form desired instead of string, parse it. */
510 Lisp_Object expr_and_pos
;
513 if (STRINGP (val
) && XSTRING (val
)->size
== 0
517 expr_and_pos
= Fread_from_string (val
, Qnil
, Qnil
);
518 pos
= XINT (Fcdr (expr_and_pos
));
519 if (pos
!= XSTRING (val
)->size
)
521 /* Ignore trailing whitespace; any other trailing junk is an error. */
523 pos
= string_char_to_byte (val
, pos
);
524 for (i
= pos
; i
< STRING_BYTES (XSTRING (val
)); i
++)
526 int c
= XSTRING (val
)->data
[i
];
527 if (c
!= ' ' && c
!= '\t' && c
!= '\n')
528 error ("Trailing garbage following expression");
531 val
= Fcar (expr_and_pos
);
534 /* The appropriate frame will get selected
535 in set-window-configuration. */
536 RETURN_UNGCPRO (unbind_to (count
, val
));
539 /* Return a buffer to be used as the minibuffer at depth `depth'.
540 depth = 0 is the lowest allowed argument, and that is the value
541 used for nonrecursive minibuffer invocations */
544 get_minibuffer (depth
)
547 Lisp_Object tail
, num
, buf
;
549 extern Lisp_Object
nconc2 ();
551 XSETFASTINT (num
, depth
);
552 tail
= Fnthcdr (num
, Vminibuffer_list
);
555 tail
= Fcons (Qnil
, Qnil
);
556 Vminibuffer_list
= nconc2 (Vminibuffer_list
, tail
);
559 if (NILP (buf
) || NILP (XBUFFER (buf
)->name
))
561 sprintf (name
, " *Minibuf-%d*", depth
);
562 buf
= Fget_buffer_create (build_string (name
));
564 /* Although the buffer's name starts with a space, undo should be
566 Fbuffer_enable_undo (buf
);
572 int count
= specpdl_ptr
- specpdl
;
574 reset_buffer (XBUFFER (buf
));
575 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
577 Fkill_all_local_variables ();
578 unbind_to (count
, Qnil
);
584 /* This function is called on exiting minibuffer, whether normally or
585 not, and it restores the current window, buffer, etc. */
588 read_minibuf_unwind (data
)
591 Lisp_Object old_deactivate_mark
;
594 /* We are exiting the minibuffer one way or the other,
596 if (!NILP (Vminibuffer_exit_hook
) && !EQ (Vminibuffer_exit_hook
, Qunbound
)
597 && !NILP (Vrun_hooks
))
598 safe_run_hooks (Qminibuffer_exit_hook
);
600 /* If this was a recursive minibuffer,
601 tie the minibuffer window back to the outer level minibuffer buffer. */
604 window
= minibuf_window
;
605 /* To keep things predictable, in case it matters, let's be in the
606 minibuffer when we reset the relevant variables. */
607 Fset_buffer (XWINDOW (window
)->buffer
);
609 /* Restore prompt, etc, from outer minibuffer level. */
610 minibuf_prompt
= Fcar (minibuf_save_list
);
611 minibuf_save_list
= Fcdr (minibuf_save_list
);
612 minibuf_prompt_width
= XFASTINT (Fcar (minibuf_save_list
));
613 minibuf_save_list
= Fcdr (minibuf_save_list
);
614 Vhelp_form
= Fcar (minibuf_save_list
);
615 minibuf_save_list
= Fcdr (minibuf_save_list
);
616 Vcurrent_prefix_arg
= Fcar (minibuf_save_list
);
617 minibuf_save_list
= Fcdr (minibuf_save_list
);
618 Vminibuffer_history_position
= Fcar (minibuf_save_list
);
619 minibuf_save_list
= Fcdr (minibuf_save_list
);
620 Vminibuffer_history_variable
= Fcar (minibuf_save_list
);
621 minibuf_save_list
= Fcdr (minibuf_save_list
);
622 Voverriding_local_map
= Fcar (minibuf_save_list
);
623 minibuf_save_list
= Fcdr (minibuf_save_list
);
625 temp
= Fcar (minibuf_save_list
);
626 if (FRAME_LIVE_P (XFRAME (WINDOW_FRAME (XWINDOW (temp
)))))
627 minibuf_window
= temp
;
629 minibuf_save_list
= Fcdr (minibuf_save_list
);
631 /* Erase the minibuffer we were using at this level. */
633 int count
= specpdl_ptr
- specpdl
;
634 /* Prevent error in erase-buffer. */
635 specbind (Qinhibit_read_only
, Qt
);
636 old_deactivate_mark
= Vdeactivate_mark
;
638 Vdeactivate_mark
= old_deactivate_mark
;
639 unbind_to (count
, Qnil
);
642 /* When we get to the outmost level, make sure we resize the
643 mini-window back to its normal size. */
644 if (minibuf_level
== 0)
645 resize_mini_window (XWINDOW (window
), 0);
647 /* Make sure minibuffer window is erased, not ignored. */
648 windows_or_buffers_changed
++;
649 XSETFASTINT (XWINDOW (window
)->last_modified
, 0);
650 XSETFASTINT (XWINDOW (window
)->last_overlay_modified
, 0);
655 /* This comment supplies the doc string for read-from-minibuffer,
656 for make-docfile to see. We cannot put this in the real DEFUN
657 due to limits in the Unix cpp.
659 DEFUN ("read-from-minibuffer", Fread_from_minibuffer, Sread_from_minibuffer, 1, 7, 0,
660 "Read a string from the minibuffer, prompting with string PROMPT.\n\
661 If optional second arg INITIAL-CONTENTS is non-nil, it is a string\n\
662 to be inserted into the minibuffer before reading input.\n\
663 If INITIAL-CONTENTS is (STRING . POSITION), the initial input\n\
664 is STRING, but point is placed at position POSITION in the minibuffer.\n\
665 Third arg KEYMAP is a keymap to use whilst reading;\n\
666 if omitted or nil, the default is `minibuffer-local-map'.\n\
667 If fourth arg READ is non-nil, then interpret the result as a lisp object\n\
668 and return that object:\n\
669 in other words, do `(car (read-from-string INPUT-STRING))'\n\
670 Fifth arg HIST, if non-nil, specifies a history list\n\
671 and optionally the initial position in the list.\n\
672 It can be a symbol, which is the history list variable to use,\n\
673 or it can be a cons cell (HISTVAR . HISTPOS).\n\
674 In that case, HISTVAR is the history list variable to use,\n\
675 and HISTPOS is the initial position (the position in the list\n\
676 which INITIAL-CONTENTS corresponds to).\n\
677 Positions are counted starting from 1 at the beginning of the list.\n\
678 Sixth arg DEFAULT-VALUE is the default value. If non-nil, it is available\n\
679 for history commands; but `read-from-minibuffer' does NOT return DEFAULT-VALUE\n\
680 if the user enters empty input! It returns the empty string.\n\
681 Seventh arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
682 the current input method and the setting of enable-multibyte-characters.\n\
683 If the variable `minibuffer-allow-text-properties' is non-nil,\n\
684 then the string which is returned includes whatever text properties\n\
685 were present in the minibuffer. Otherwise the value has no text properties.")
686 (prompt, initial_contents, keymap, read, hist, default_value, inherit_input_method)
689 DEFUN ("read-from-minibuffer", Fread_from_minibuffer
, Sread_from_minibuffer
, 1, 7, 0,
690 0 /* See immediately above */)
691 (prompt
, initial_contents
, keymap
, read
, hist
, default_value
, inherit_input_method
)
692 Lisp_Object prompt
, initial_contents
, keymap
, read
, hist
, default_value
;
693 Lisp_Object inherit_input_method
;
696 Lisp_Object histvar
, histpos
, position
, val
;
701 CHECK_STRING (prompt
, 0);
702 if (!NILP (initial_contents
))
704 if (CONSP (initial_contents
))
706 position
= Fcdr (initial_contents
);
707 initial_contents
= Fcar (initial_contents
);
709 CHECK_STRING (initial_contents
, 1);
710 if (!NILP (position
))
712 CHECK_NUMBER (position
, 0);
713 /* Convert to distance from end of input. */
714 if (XINT (position
) < 1)
715 /* A number too small means the beginning of the string. */
716 pos
= - XSTRING (initial_contents
)->size
;
718 pos
= XINT (position
) - 1 - XSTRING (initial_contents
)->size
;
723 keymap
= Vminibuffer_local_map
;
725 keymap
= get_keymap (keymap
);
734 histvar
= Fcar_safe (hist
);
735 histpos
= Fcdr_safe (hist
);
738 histvar
= Qminibuffer_history
;
740 XSETFASTINT (histpos
, 0);
742 GCPRO1 (default_value
);
743 val
= read_minibuf (keymap
, initial_contents
, prompt
,
744 make_number (pos
), !NILP (read
),
745 histvar
, histpos
, default_value
,
746 minibuffer_allow_text_properties
,
747 !NILP (inherit_input_method
));
752 DEFUN ("read-minibuffer", Fread_minibuffer
, Sread_minibuffer
, 1, 2, 0,
753 "Return a Lisp object read using the minibuffer.\n\
754 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\
755 is a string to insert in the minibuffer before reading.")
756 (prompt
, initial_contents
)
757 Lisp_Object prompt
, initial_contents
;
759 CHECK_STRING (prompt
, 0);
760 if (!NILP (initial_contents
))
761 CHECK_STRING (initial_contents
, 1);
762 return read_minibuf (Vminibuffer_local_map
, initial_contents
,
763 prompt
, Qnil
, 1, Qminibuffer_history
,
764 make_number (0), Qnil
, 0, 0);
767 DEFUN ("eval-minibuffer", Feval_minibuffer
, Seval_minibuffer
, 1, 2, 0,
768 "Return value of Lisp expression read using the minibuffer.\n\
769 Prompt with PROMPT. If non-nil, optional second arg INITIAL-CONTENTS\n\
770 is a string to insert in the minibuffer before reading.")
771 (prompt
, initial_contents
)
772 Lisp_Object prompt
, initial_contents
;
774 return Feval (Fread_minibuffer (prompt
, initial_contents
));
777 /* Functions that use the minibuffer to read various things. */
779 DEFUN ("read-string", Fread_string
, Sread_string
, 1, 5, 0,
780 "Read a string from the minibuffer, prompting with string PROMPT.\n\
781 If non-nil, second arg INITIAL-INPUT is a string to insert before reading.\n\
782 The third arg HISTORY, if non-nil, specifies a history list\n\
783 and optionally the initial position in the list.\n\
784 See `read-from-minibuffer' for details of HISTORY argument.\n\
785 Fourth arg DEFAULT-VALUE is the default value. If non-nil, it is used\n\
786 for history commands, and as the value to return if the user enters\n\
788 Fifth arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
789 the current input method and the setting of enable-multibyte-characters.")
790 (prompt
, initial_input
, history
, default_value
, inherit_input_method
)
791 Lisp_Object prompt
, initial_input
, history
, default_value
;
792 Lisp_Object inherit_input_method
;
795 val
= Fread_from_minibuffer (prompt
, initial_input
, Qnil
,
796 Qnil
, history
, default_value
,
797 inherit_input_method
);
798 if (STRINGP (val
) && XSTRING (val
)->size
== 0 && ! NILP (default_value
))
803 DEFUN ("read-no-blanks-input", Fread_no_blanks_input
, Sread_no_blanks_input
, 1, 3, 0,
804 "Read a string from the terminal, not allowing blanks.\n\
805 Prompt with PROMPT, and provide INITIAL as an initial value of the input string.\n\
806 Third arg INHERIT-INPUT-METHOD, if non-nil, means the minibuffer inherits\n\
807 the current input method and the setting of enable-multibyte-characters.")
808 (prompt
, initial
, inherit_input_method
)
809 Lisp_Object prompt
, initial
, inherit_input_method
;
811 CHECK_STRING (prompt
, 0);
812 if (! NILP (initial
))
813 CHECK_STRING (initial
, 1);
815 return read_minibuf (Vminibuffer_local_ns_map
, initial
, prompt
, Qnil
,
816 0, Qminibuffer_history
, make_number (0), Qnil
, 0,
817 !NILP (inherit_input_method
));
820 DEFUN ("read-command", Fread_command
, Sread_command
, 1, 2, 0,
821 "Read the name of a command and return as a symbol.\n\
822 Prompts with PROMPT. By default, return DEFAULT-VALUE.")
823 (prompt
, default_value
)
824 Lisp_Object prompt
, default_value
;
826 Lisp_Object name
, default_string
;
828 if (NILP (default_value
))
829 default_string
= Qnil
;
830 else if (SYMBOLP (default_value
))
831 XSETSTRING (default_string
, XSYMBOL (default_value
)->name
);
833 default_string
= default_value
;
835 name
= Fcompleting_read (prompt
, Vobarray
, Qcommandp
, Qt
,
836 Qnil
, Qnil
, default_string
, Qnil
);
839 return Fintern (name
, Qnil
);
843 DEFUN ("read-function", Fread_function
, Sread_function
, 1, 1, 0,
844 "One arg PROMPT, a string. Read the name of a function and return as a symbol.\n\
845 Prompts with PROMPT.")
849 return Fintern (Fcompleting_read (prompt
, Vobarray
, Qfboundp
, Qt
, Qnil
, Qnil
, Qnil
, Qnil
),
854 DEFUN ("read-variable", Fread_variable
, Sread_variable
, 1, 2, 0,
855 "Read the name of a user variable and return it as a symbol.\n\
856 Prompts with PROMPT. By default, return DEFAULT-VALUE.\n\
857 A user variable is one whose documentation starts with a `*' character.")
858 (prompt
, default_value
)
859 Lisp_Object prompt
, default_value
;
861 Lisp_Object name
, default_string
;
863 if (NILP (default_value
))
864 default_string
= Qnil
;
865 else if (SYMBOLP (default_value
))
866 XSETSTRING (default_string
, XSYMBOL (default_value
)->name
);
868 default_string
= default_value
;
870 name
= Fcompleting_read (prompt
, Vobarray
,
871 Quser_variable_p
, Qt
,
872 Qnil
, Qnil
, default_string
, Qnil
);
875 return Fintern (name
, Qnil
);
878 DEFUN ("read-buffer", Fread_buffer
, Sread_buffer
, 1, 3, 0,
879 "One arg PROMPT, a string. Read the name of a buffer and return as a string.\n\
880 Prompts with PROMPT.\n\
881 Optional second arg DEF is value to return if user enters an empty line.\n\
882 If optional third arg REQUIRE-MATCH is non-nil, only existing buffer names are allowed.")
883 (prompt
, def
, require_match
)
884 Lisp_Object prompt
, def
, require_match
;
889 def
= XBUFFER (def
)->name
;
891 if (NILP (Vread_buffer_function
))
895 args
[0] = build_string ("%s(default %s) ");
898 prompt
= Fformat (3, args
);
901 return Fcompleting_read (prompt
, Vbuffer_alist
, Qnil
,
902 require_match
, Qnil
, Qbuffer_name_history
,
907 args
[0] = Vread_buffer_function
;
910 args
[3] = require_match
;
911 return Ffuncall(4, args
);
916 minibuf_conform_representation (string
, basis
)
917 Lisp_Object string
, basis
;
919 if (STRING_MULTIBYTE (string
) == STRING_MULTIBYTE (basis
))
922 if (STRING_MULTIBYTE (string
))
923 return Fstring_make_unibyte (string
);
925 return Fstring_make_multibyte (string
);
928 DEFUN ("try-completion", Ftry_completion
, Stry_completion
, 2, 3, 0,
929 "Return common substring of all completions of STRING in ALIST.\n\
930 Each car of each element of ALIST is tested to see if it begins with STRING.\n\
931 All that match are compared together; the longest initial sequence\n\
932 common to all matches is returned as a string.\n\
933 If there is no match at all, nil is returned.\n\
934 For an exact match, t is returned.\n\
936 ALIST can be an obarray instead of an alist.\n\
937 Then the print names of all symbols in the obarray are the possible matches.\n\
939 ALIST can also be a function to do the completion itself.\n\
940 It receives three arguments: the values STRING, PREDICATE and nil.\n\
941 Whatever it returns becomes the value of `try-completion'.\n\
943 If optional third argument PREDICATE is non-nil,\n\
944 it is used to test each possible match.\n\
945 The match is a candidate only if PREDICATE returns non-nil.\n\
946 The argument given to PREDICATE is the alist element\n\
947 or the symbol from the obarray.")
948 (string
, alist
, predicate
)
949 Lisp_Object string
, alist
, predicate
;
951 Lisp_Object bestmatch
, tail
, elt
, eltstring
;
952 /* Size in bytes of BESTMATCH. */
954 /* These are in bytes, too. */
955 int compare
, matchsize
;
956 int list
= CONSP (alist
) || NILP (alist
);
959 Lisp_Object bucket
, zero
, end
, tem
;
960 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
962 CHECK_STRING (string
, 0);
963 if (!list
&& !VECTORP (alist
))
964 return call3 (alist
, string
, predicate
, Qnil
);
968 /* If ALIST is not a list, set TAIL just for gc pro. */
973 obsize
= XVECTOR (alist
)->size
;
974 bucket
= XVECTOR (alist
)->contents
[index
];
979 /* Get the next element of the alist or obarray. */
980 /* Exit the loop if the elements are all used up. */
981 /* elt gets the alist element or symbol.
982 eltstring gets the name to check as a completion. */
989 eltstring
= Fcar (elt
);
994 if (XFASTINT (bucket
) != 0)
997 eltstring
= Fsymbol_name (elt
);
998 if (XSYMBOL (bucket
)->next
)
999 XSETSYMBOL (bucket
, XSYMBOL (bucket
)->next
);
1001 XSETFASTINT (bucket
, 0);
1003 else if (++index
>= obsize
)
1007 bucket
= XVECTOR (alist
)->contents
[index
];
1012 /* Is this element a possible completion? */
1014 if (STRINGP (eltstring
)
1015 && XSTRING (string
)->size
<= XSTRING (eltstring
)->size
1016 && (tem
= Fcompare_strings (eltstring
, make_number (0),
1017 make_number (XSTRING (string
)->size
),
1018 string
, make_number (0), Qnil
,
1019 completion_ignore_case
?Qt
: Qnil
),
1023 Lisp_Object regexps
;
1025 XSETFASTINT (zero
, 0);
1027 /* Ignore this element if it fails to match all the regexps. */
1028 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1029 regexps
= XCDR (regexps
))
1031 tem
= Fstring_match (XCAR (regexps
), eltstring
, zero
);
1035 if (CONSP (regexps
))
1038 /* Ignore this element if there is a predicate
1039 and the predicate doesn't like it. */
1041 if (!NILP (predicate
))
1043 if (EQ (predicate
, Qcommandp
))
1044 tem
= Fcommandp (elt
);
1047 GCPRO4 (tail
, string
, eltstring
, bestmatch
);
1048 tem
= call1 (predicate
, elt
);
1051 if (NILP (tem
)) continue;
1054 /* Update computation of how much all possible completions match */
1057 if (NILP (bestmatch
))
1059 bestmatch
= eltstring
;
1060 bestmatchsize
= XSTRING (eltstring
)->size
;
1064 compare
= min (bestmatchsize
, XSTRING (eltstring
)->size
);
1065 tem
= Fcompare_strings (bestmatch
, make_number (0),
1066 make_number (compare
),
1067 eltstring
, make_number (0),
1068 make_number (compare
),
1069 completion_ignore_case
? Qt
: Qnil
);
1071 matchsize
= compare
;
1072 else if (XINT (tem
) < 0)
1073 matchsize
= - XINT (tem
) - 1;
1075 matchsize
= XINT (tem
) - 1;
1078 matchsize
= compare
;
1079 if (completion_ignore_case
)
1081 /* If this is an exact match except for case,
1082 use it as the best match rather than one that is not an
1083 exact match. This way, we get the case pattern
1084 of the actual match. */
1085 if ((matchsize
== XSTRING (eltstring
)->size
1086 && matchsize
< XSTRING (bestmatch
)->size
)
1088 /* If there is more than one exact match ignoring case,
1089 and one of them is exact including case,
1091 /* If there is no exact match ignoring case,
1092 prefer a match that does not change the case
1094 ((matchsize
== XSTRING (eltstring
)->size
)
1096 (matchsize
== XSTRING (bestmatch
)->size
)
1097 && (tem
= Fcompare_strings (eltstring
, make_number (0),
1098 make_number (XSTRING (string
)->size
),
1099 string
, make_number (0),
1103 && (tem
= Fcompare_strings (bestmatch
, make_number (0),
1104 make_number (XSTRING (string
)->size
),
1105 string
, make_number (0),
1109 bestmatch
= eltstring
;
1111 bestmatchsize
= matchsize
;
1116 if (NILP (bestmatch
))
1117 return Qnil
; /* No completions found */
1118 /* If we are ignoring case, and there is no exact match,
1119 and no additional text was supplied,
1120 don't change the case of what the user typed. */
1121 if (completion_ignore_case
&& bestmatchsize
== XSTRING (string
)->size
1122 && XSTRING (bestmatch
)->size
> bestmatchsize
)
1123 return minibuf_conform_representation (string
, bestmatch
);
1125 /* Return t if the supplied string is an exact match (counting case);
1126 it does not require any change to be made. */
1127 if (matchcount
== 1 && bestmatchsize
== XSTRING (string
)->size
1128 && (tem
= Fcompare_strings (bestmatch
, make_number (0),
1129 make_number (bestmatchsize
),
1130 string
, make_number (0),
1131 make_number (bestmatchsize
),
1136 XSETFASTINT (zero
, 0); /* Else extract the part in which */
1137 XSETFASTINT (end
, bestmatchsize
); /* all completions agree */
1138 return Fsubstring (bestmatch
, zero
, end
);
1141 /* Compare exactly LEN chars of strings at S1 and S2,
1142 ignoring case if appropriate.
1143 Return -1 if strings match,
1144 else number of chars that match at the beginning. */
1148 register unsigned char *s1
, *s2
;
1151 register int l
= len
;
1153 if (completion_ignore_case
)
1155 while (l
&& DOWNCASE (*s1
++) == DOWNCASE (*s2
++))
1160 while (l
&& *s1
++ == *s2
++)
1167 int match
= len
- l
;
1169 /* Now *--S1 is the unmatching byte. If it is in the middle of
1170 multi-byte form, we must say that the multi-byte character
1171 there doesn't match. */
1172 while (match
&& *--s1
>= 0xA0) match
--;
1177 DEFUN ("all-completions", Fall_completions
, Sall_completions
, 2, 4, 0,
1178 "Search for partial matches to STRING in ALIST.\n\
1179 Each car of each element of ALIST is tested to see if it begins with STRING.\n\
1180 The value is a list of all the strings from ALIST that match.\n\
1182 ALIST can be an obarray instead of an alist.\n\
1183 Then the print names of all symbols in the obarray are the possible matches.\n\
1185 ALIST can also be a function to do the completion itself.\n\
1186 It receives three arguments: the values STRING, PREDICATE and t.\n\
1187 Whatever it returns becomes the value of `all-completion'.\n\
1189 If optional third argument PREDICATE is non-nil,\n\
1190 it is used to test each possible match.\n\
1191 The match is a candidate only if PREDICATE returns non-nil.\n\
1192 The argument given to PREDICATE is the alist element\n\
1193 or the symbol from the obarray.\n\
1195 If the optional fourth argument HIDE-SPACES is non-nil,\n\
1196 strings in ALIST that start with a space\n\
1197 are ignored unless STRING itself starts with a space.")
1198 (string
, alist
, predicate
, hide_spaces
)
1199 Lisp_Object string
, alist
, predicate
, hide_spaces
;
1201 Lisp_Object tail
, elt
, eltstring
;
1202 Lisp_Object allmatches
;
1203 int list
= CONSP (alist
) || NILP (alist
);
1205 Lisp_Object bucket
, tem
;
1206 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1208 CHECK_STRING (string
, 0);
1209 if (!list
&& !VECTORP (alist
))
1211 return call3 (alist
, string
, predicate
, Qt
);
1215 /* If ALIST is not a list, set TAIL just for gc pro. */
1220 obsize
= XVECTOR (alist
)->size
;
1221 bucket
= XVECTOR (alist
)->contents
[index
];
1226 /* Get the next element of the alist or obarray. */
1227 /* Exit the loop if the elements are all used up. */
1228 /* elt gets the alist element or symbol.
1229 eltstring gets the name to check as a completion. */
1236 eltstring
= Fcar (elt
);
1241 if (XFASTINT (bucket
) != 0)
1244 eltstring
= Fsymbol_name (elt
);
1245 if (XSYMBOL (bucket
)->next
)
1246 XSETSYMBOL (bucket
, XSYMBOL (bucket
)->next
);
1248 XSETFASTINT (bucket
, 0);
1250 else if (++index
>= obsize
)
1254 bucket
= XVECTOR (alist
)->contents
[index
];
1259 /* Is this element a possible completion? */
1261 if (STRINGP (eltstring
)
1262 && XSTRING (string
)->size
<= XSTRING (eltstring
)->size
1263 /* If HIDE_SPACES, reject alternatives that start with space
1264 unless the input starts with space. */
1265 && ((STRING_BYTES (XSTRING (string
)) > 0
1266 && XSTRING (string
)->data
[0] == ' ')
1267 || XSTRING (eltstring
)->data
[0] != ' '
1268 || NILP (hide_spaces
))
1269 && (tem
= Fcompare_strings (eltstring
, make_number (0),
1270 make_number (XSTRING (string
)->size
),
1271 string
, make_number (0),
1272 make_number (XSTRING (string
)->size
),
1273 completion_ignore_case
? Qt
: Qnil
),
1277 Lisp_Object regexps
;
1279 XSETFASTINT (zero
, 0);
1281 /* Ignore this element if it fails to match all the regexps. */
1282 for (regexps
= Vcompletion_regexp_list
; CONSP (regexps
);
1283 regexps
= XCDR (regexps
))
1285 tem
= Fstring_match (XCAR (regexps
), eltstring
, zero
);
1289 if (CONSP (regexps
))
1292 /* Ignore this element if there is a predicate
1293 and the predicate doesn't like it. */
1295 if (!NILP (predicate
))
1297 if (EQ (predicate
, Qcommandp
))
1298 tem
= Fcommandp (elt
);
1301 GCPRO4 (tail
, eltstring
, allmatches
, string
);
1302 tem
= call1 (predicate
, elt
);
1305 if (NILP (tem
)) continue;
1307 /* Ok => put it on the list. */
1308 allmatches
= Fcons (eltstring
, allmatches
);
1312 return Fnreverse (allmatches
);
1315 Lisp_Object Vminibuffer_completion_table
, Qminibuffer_completion_table
;
1316 Lisp_Object Vminibuffer_completion_predicate
, Qminibuffer_completion_predicate
;
1317 Lisp_Object Vminibuffer_completion_confirm
, Qminibuffer_completion_confirm
;
1318 Lisp_Object Vminibuffer_completing_file_name
;
1320 /* This comment supplies the doc string for completing-read,
1321 for make-docfile to see. We cannot put this in the real DEFUN
1322 due to limits in the Unix cpp.
1324 DEFUN ("completing-read", Fcompleting_read, Scompleting_read, 2, 8, 0,
1325 "Read a string in the minibuffer, with completion.\n\
1326 PROMPT is a string to prompt with; normally it ends in a colon and a space.\n\
1327 TABLE is an alist whose elements' cars are strings, or an obarray.\n\
1328 PREDICATE limits completion to a subset of TABLE.\n\
1329 See `try-completion' and `all-completions' for more details\n\
1330 on completion, TABLE, and PREDICATE.\n\
1332 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless\n\
1333 the input is (or completes to) an element of TABLE or is null.\n\
1334 If it is also not t, Return does not exit if it does non-null completion.\n\
1335 If the input is null, `completing-read' returns an empty string,\n\
1336 regardless of the value of REQUIRE-MATCH.\n\
1338 If INITIAL-INPUT is non-nil, insert it in the minibuffer initially.\n\
1339 If it is (STRING . POSITION), the initial input\n\
1340 is STRING, but point is placed POSITION characters into the string.\n\
1341 HIST, if non-nil, specifies a history list\n\
1342 and optionally the initial position in the list.\n\
1343 It can be a symbol, which is the history list variable to use,\n\
1344 or it can be a cons cell (HISTVAR . HISTPOS).\n\
1345 In that case, HISTVAR is the history list variable to use,\n\
1346 and HISTPOS is the initial position (the position in the list\n\
1347 which INITIAL-INPUT corresponds to).\n\
1348 Positions are counted starting from 1 at the beginning of the list.\n\
1349 DEF, if non-nil, is the default value.\n\
1351 If INHERIT-INPUT-METHOD is non-nil, the minibuffer inherits\n\
1352 the current input method and the setting of enable-multibyte-characters.\n\
1354 Completion ignores case if the ambient value of\n\
1355 `completion-ignore-case' is non-nil."
1357 DEFUN ("completing-read", Fcompleting_read
, Scompleting_read
, 2, 8, 0,
1358 0 /* See immediately above */)
1359 (prompt
, table
, predicate
, require_match
, init
, hist
, def
, inherit_input_method
)
1360 Lisp_Object prompt
, table
, predicate
, require_match
, init
, hist
, def
;
1361 Lisp_Object inherit_input_method
;
1363 Lisp_Object val
, histvar
, histpos
, position
;
1365 int count
= specpdl_ptr
- specpdl
;
1366 struct gcpro gcpro1
;
1370 specbind (Qminibuffer_completion_table
, table
);
1371 specbind (Qminibuffer_completion_predicate
, predicate
);
1372 specbind (Qminibuffer_completion_confirm
,
1373 EQ (require_match
, Qt
) ? Qnil
: Qt
);
1374 last_exact_completion
= Qnil
;
1381 position
= Fcdr (init
);
1384 CHECK_STRING (init
, 0);
1385 if (!NILP (position
))
1387 CHECK_NUMBER (position
, 0);
1388 /* Convert to distance from end of input. */
1389 pos
= XINT (position
) - XSTRING (init
)->size
;
1400 histvar
= Fcar_safe (hist
);
1401 histpos
= Fcdr_safe (hist
);
1404 histvar
= Qminibuffer_history
;
1406 XSETFASTINT (histpos
, 0);
1408 val
= read_minibuf (NILP (require_match
)
1409 ? Vminibuffer_local_completion_map
1410 : Vminibuffer_local_must_match_map
,
1411 init
, prompt
, make_number (pos
), 0,
1412 histvar
, histpos
, def
, 0,
1413 !NILP (inherit_input_method
));
1415 if (STRINGP (val
) && XSTRING (val
)->size
== 0 && ! NILP (def
))
1418 RETURN_UNGCPRO (unbind_to (count
, val
));
1421 Lisp_Object
Fminibuffer_completion_help ();
1422 Lisp_Object
assoc_for_completion ();
1424 /* Test whether TXT is an exact completion. */
1426 test_completion (txt
)
1431 if (CONSP (Vminibuffer_completion_table
)
1432 || NILP (Vminibuffer_completion_table
))
1433 return assoc_for_completion (txt
, Vminibuffer_completion_table
);
1434 else if (VECTORP (Vminibuffer_completion_table
))
1436 /* Bypass intern-soft as that loses for nil */
1437 tem
= oblookup (Vminibuffer_completion_table
,
1438 XSTRING (txt
)->data
,
1439 XSTRING (txt
)->size
,
1440 STRING_BYTES (XSTRING (txt
)));
1443 if (STRING_MULTIBYTE (txt
))
1444 txt
= Fstring_make_unibyte (txt
);
1446 txt
= Fstring_make_multibyte (txt
);
1448 tem
= oblookup (Vminibuffer_completion_table
,
1449 XSTRING (txt
)->data
,
1450 XSTRING (txt
)->size
,
1451 STRING_BYTES (XSTRING (txt
)));
1455 if (!NILP (Vminibuffer_completion_predicate
))
1456 return call1 (Vminibuffer_completion_predicate
, tem
);
1461 return call3 (Vminibuffer_completion_table
, txt
,
1462 Vminibuffer_completion_predicate
, Qlambda
);
1466 * 0 no possible completion
1467 * 1 was already an exact and unique completion
1468 * 3 was already an exact completion
1469 * 4 completed to an exact completion
1470 * 5 some completion happened
1471 * 6 no completion happened
1476 Lisp_Object completion
, tem
;
1479 struct gcpro gcpro1
, gcpro2
;
1481 completion
= Ftry_completion (Ffield_string (ZV
),
1482 Vminibuffer_completion_table
,
1483 Vminibuffer_completion_predicate
);
1484 last
= last_exact_completion
;
1485 last_exact_completion
= Qnil
;
1487 GCPRO2 (completion
, last
);
1489 if (NILP (completion
))
1492 temp_echo_area_glyphs (" [No match]");
1497 if (EQ (completion
, Qt
)) /* exact and unique match */
1504 tem
= Fstring_equal (completion
, Ffield_string(ZV
));
1505 completedp
= NILP (tem
);
1508 Ferase_field (make_number (ZV
)); /* Some completion happened */
1509 Finsert (1, &completion
);
1512 /* It did find a match. Do we match some possibility exactly now? */
1513 tem
= test_completion (Ffield_string(ZV
));
1516 /* not an exact match */
1521 Fminibuffer_completion_help ();
1523 temp_echo_area_glyphs (" [Next char not unique]");
1526 else if (completedp
)
1531 /* If the last exact completion and this one were the same,
1532 it means we've already given a "Complete but not unique"
1533 message and the user's hit TAB again, so now we give him help. */
1534 last_exact_completion
= completion
;
1537 tem
= Ffield_string (ZV
);
1538 if (!NILP (Fequal (tem
, last
)))
1539 Fminibuffer_completion_help ();
1545 /* Like assoc but assumes KEY is a string, and ignores case if appropriate. */
1548 assoc_for_completion (key
, list
)
1549 register Lisp_Object key
;
1552 register Lisp_Object tail
;
1554 for (tail
= list
; !NILP (tail
); tail
= Fcdr (tail
))
1556 register Lisp_Object elt
, tem
, thiscar
;
1558 if (!CONSP (elt
)) continue;
1559 thiscar
= Fcar (elt
);
1560 if (!STRINGP (thiscar
))
1562 tem
= Fcompare_strings (thiscar
, make_number (0), Qnil
,
1563 key
, make_number (0), Qnil
,
1564 completion_ignore_case
? Qt
: Qnil
);
1572 DEFUN ("minibuffer-complete", Fminibuffer_complete
, Sminibuffer_complete
, 0, 0, "",
1573 "Complete the minibuffer contents as far as possible.\n\
1574 Return nil if there is no valid completion, else t.\n\
1575 If no characters can be completed, display a list of possible completions.\n\
1576 If you repeat this command after it displayed such a list,\n\
1577 scroll the window of possible completions.")
1581 Lisp_Object window
, tem
;
1583 /* If the previous command was not this,
1584 mark the completion buffer obsolete. */
1585 if (! EQ (current_kboard
->Vlast_command
, Vthis_command
))
1586 Vminibuf_scroll_window
= Qnil
;
1588 window
= Vminibuf_scroll_window
;
1589 /* If there's a fresh completion window with a live buffer,
1590 and this command is repeated, scroll that window. */
1591 if (! NILP (window
) && ! NILP (XWINDOW (window
)->buffer
)
1592 && !NILP (XBUFFER (XWINDOW (window
)->buffer
)->name
))
1594 struct buffer
*obuf
= current_buffer
;
1596 Fset_buffer (XWINDOW (window
)->buffer
);
1597 tem
= Fpos_visible_in_window_p (make_number (ZV
), window
);
1599 /* If end is in view, scroll up to the beginning. */
1600 Fset_window_start (window
, make_number (BEGV
), Qnil
);
1602 /* Else scroll down one screen. */
1603 Fscroll_other_window (Qnil
);
1605 set_buffer_internal (obuf
);
1609 i
= do_completion ();
1616 temp_echo_area_glyphs (" [Sole completion]");
1620 temp_echo_area_glyphs (" [Complete, but not unique]");
1627 /* Subroutines of Fminibuffer_complete_and_exit. */
1629 /* This one is called by internal_condition_case to do the real work. */
1632 complete_and_exit_1 ()
1634 return make_number (do_completion ());
1637 /* This one is called by internal_condition_case if an error happens.
1638 Pretend the current value is an exact match. */
1641 complete_and_exit_2 (ignore
)
1644 return make_number (1);
1647 DEFUN ("minibuffer-complete-and-exit", Fminibuffer_complete_and_exit
,
1648 Sminibuffer_complete_and_exit
, 0, 0, "",
1649 "If the minibuffer contents is a valid completion then exit.\n\
1650 Otherwise try to complete it. If completion leads to a valid completion,\n\
1651 a repetition of this command will exit.")
1657 /* Allow user to specify null string */
1658 if (Ffield_beginning (ZV
, Qnil
) == ZV
)
1661 if (!NILP (test_completion (Ffield_string (ZV
))))
1664 /* Call do_completion, but ignore errors. */
1665 val
= internal_condition_case (complete_and_exit_1
, Qerror
,
1666 complete_and_exit_2
);
1676 if (!NILP (Vminibuffer_completion_confirm
))
1678 temp_echo_area_glyphs (" [Confirm]");
1688 Fthrow (Qexit
, Qnil
);
1692 DEFUN ("minibuffer-complete-word", Fminibuffer_complete_word
, Sminibuffer_complete_word
,
1694 "Complete the minibuffer contents at most a single word.\n\
1695 After one word is completed as much as possible, a space or hyphen\n\
1696 is added, provided that matches some possible completion.\n\
1697 Return nil if there is no valid completion, else t.")
1700 Lisp_Object completion
, tem
, tem1
;
1701 register int i
, i_byte
;
1702 register unsigned char *completion_string
;
1703 struct gcpro gcpro1
, gcpro2
;
1704 int prompt_end_charpos
;
1706 /* We keep calling Fbuffer_string rather than arrange for GC to
1707 hold onto a pointer to one of the strings thus made. */
1709 completion
= Ftry_completion (Ffield_string (ZV
),
1710 Vminibuffer_completion_table
,
1711 Vminibuffer_completion_predicate
);
1712 if (NILP (completion
))
1715 temp_echo_area_glyphs (" [No match]");
1718 if (EQ (completion
, Qt
))
1721 #if 0 /* How the below code used to look, for reference. */
1722 tem
= Ffield_string (ZV
);
1723 b
= XSTRING (tem
)->data
;
1724 i
= ZV
- 1 - XSTRING (completion
)->size
;
1725 p
= XSTRING (completion
)->data
;
1727 0 <= scmp (b
, p
, ZV
- 1))
1730 /* Set buffer to longest match of buffer tail and completion head. */
1731 while (0 <= scmp (b
+ i
, p
, ZV
- 1 - i
))
1733 del_range (1, i
+ 1);
1736 #else /* Rewritten code */
1738 int buffer_nchars
, completion_nchars
;
1740 CHECK_STRING (completion
, 0);
1741 tem
= Ffield_string (ZV
);
1742 GCPRO2 (completion
, tem
);
1743 /* If reading a file name,
1744 expand any $ENVVAR refs in the buffer and in TEM. */
1745 if (! NILP (Vminibuffer_completing_file_name
))
1747 Lisp_Object substituted
;
1748 substituted
= Fsubstitute_in_file_name (tem
);
1749 if (! EQ (substituted
, tem
))
1752 Ferase_field (make_number (ZV
));
1753 insert_from_string (tem
, 0, 0, XSTRING (tem
)->size
,
1754 STRING_BYTES (XSTRING (tem
)), 0);
1757 buffer_nchars
= XSTRING (tem
)->size
; /* ie ZV - BEGV */
1758 completion_nchars
= XSTRING (completion
)->size
;
1759 i
= buffer_nchars
- completion_nchars
;
1762 (tem1
= Fcompare_strings (tem
, make_number (0),
1763 make_number (buffer_nchars
),
1764 completion
, make_number (0),
1765 make_number (buffer_nchars
),
1766 completion_ignore_case
? Qt
: Qnil
),
1771 /* Set buffer to longest match of buffer tail and completion head. */
1777 tem1
= Fcompare_strings (tem
, make_number (start_pos
), Qnil
,
1778 completion
, make_number (0),
1779 make_number (buffer_nchars
),
1780 completion_ignore_case
? Qt
: Qnil
);
1787 del_range (1, i
+ 1);
1788 SET_PT_BOTH (ZV
, ZV_BYTE
);
1792 #endif /* Rewritten code */
1794 prompt_end_charpos
= Ffield_beginning (make_number (ZV
), Qnil
);
1797 int prompt_end_bytepos
;
1798 prompt_end_bytepos
= CHAR_TO_BYTE (prompt_end_charpos
);
1799 i
= ZV
- prompt_end_charpos
;
1800 i_byte
= ZV_BYTE
- prompt_end_bytepos
;
1803 /* If completion finds next char not unique,
1804 consider adding a space or a hyphen. */
1805 if (i
== XSTRING (completion
)->size
)
1807 GCPRO1 (completion
);
1808 tem
= Ftry_completion (concat2 (Ffield_string (ZV
), build_string (" ")),
1809 Vminibuffer_completion_table
,
1810 Vminibuffer_completion_predicate
);
1817 GCPRO1 (completion
);
1819 Ftry_completion (concat2 (Ffield_string (ZV
), build_string ("-")),
1820 Vminibuffer_completion_table
,
1821 Vminibuffer_completion_predicate
);
1829 /* Now find first word-break in the stuff found by completion.
1830 i gets index in string of where to stop completing. */
1833 int bytes
= STRING_BYTES (XSTRING (completion
));
1834 completion_string
= XSTRING (completion
)->data
;
1835 for (; i_byte
< STRING_BYTES (XSTRING (completion
)); i_byte
+= len
, i
++)
1837 c
= STRING_CHAR_AND_LENGTH (completion_string
+ i_byte
,
1840 if (SYNTAX (c
) != Sword
)
1849 /* If got no characters, print help for user. */
1851 if (i
== ZV
- prompt_end_charpos
)
1854 Fminibuffer_completion_help ();
1858 /* Otherwise insert in minibuffer the chars we got */
1860 Ferase_field (make_number (ZV
));
1861 insert_from_string (completion
, 0, 0, i
, i_byte
, 1);
1865 DEFUN ("display-completion-list", Fdisplay_completion_list
, Sdisplay_completion_list
,
1867 "Display the list of completions, COMPLETIONS, using `standard-output'.\n\
1868 Each element may be just a symbol or string\n\
1869 or may be a list of two strings to be printed as if concatenated.\n\
1870 `standard-output' must be a buffer.\n\
1871 The actual completion alternatives, as inserted, are given `mouse-face'\n\
1872 properties of `highlight'.\n\
1873 At the end, this runs the normal hook `completion-setup-hook'.\n\
1874 It can find the completion buffer in `standard-output'.")
1876 Lisp_Object completions
;
1878 Lisp_Object tail
, elt
;
1881 struct gcpro gcpro1
, gcpro2
;
1882 struct buffer
*old
= current_buffer
;
1885 /* Note that (when it matters) every variable
1886 points to a non-string that is pointed to by COMPLETIONS,
1887 except for ELT. ELT can be pointing to a string
1888 when terpri or Findent_to calls a change hook. */
1890 GCPRO2 (completions
, elt
);
1892 if (BUFFERP (Vstandard_output
))
1893 set_buffer_internal (XBUFFER (Vstandard_output
));
1895 if (NILP (completions
))
1896 write_string ("There are no possible completions of what you have typed.",
1900 write_string ("Possible completions are:", -1);
1901 for (tail
= completions
, i
= 0; !NILP (tail
); tail
= Fcdr (tail
), i
++)
1903 Lisp_Object tem
, string
;
1905 Lisp_Object startpos
, endpos
;
1908 /* Compute the length of this element. */
1912 CHECK_STRING (tem
, 0);
1913 length
= XSTRING (tem
)->size
;
1915 tem
= Fcar (XCDR (elt
));
1916 CHECK_STRING (tem
, 0);
1917 length
+= XSTRING (tem
)->size
;
1921 CHECK_STRING (elt
, 0);
1922 length
= XSTRING (elt
)->size
;
1925 /* This does a bad job for narrower than usual windows.
1926 Sadly, the window it will appear in is not known
1927 until after the text has been made. */
1929 if (BUFFERP (Vstandard_output
))
1930 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1932 /* If the previous completion was very wide,
1933 or we have two on this line already,
1934 don't put another on the same line. */
1935 if (column
> 33 || first
1936 /* If this is really wide, don't put it second on a line. */
1937 || (column
> 0 && length
> 45))
1942 /* Otherwise advance to column 35. */
1945 if (BUFFERP (Vstandard_output
))
1947 tem
= Findent_to (make_number (35), make_number (2));
1949 column
= XINT (tem
);
1955 write_string (" ", -1);
1958 while (column
< 35);
1962 if (BUFFERP (Vstandard_output
))
1964 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1965 Fset_text_properties (startpos
, endpos
,
1966 Qnil
, Vstandard_output
);
1969 /* Output this element.
1970 If necessary, convert it to unibyte or to multibyte first. */
1972 string
= Fcar (elt
);
1975 if (NILP (current_buffer
->enable_multibyte_characters
)
1976 && STRING_MULTIBYTE (string
))
1977 string
= Fstring_make_unibyte (string
);
1978 else if (!NILP (current_buffer
->enable_multibyte_characters
)
1979 && !STRING_MULTIBYTE (string
))
1980 string
= Fstring_make_multibyte (string
);
1982 if (BUFFERP (Vstandard_output
))
1984 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1986 Fprinc (string
, Qnil
);
1988 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
1990 Fput_text_property (startpos
, endpos
,
1991 Qmouse_face
, intern ("highlight"),
1996 Fprinc (string
, Qnil
);
1999 /* Output the annotation for this element. */
2002 if (BUFFERP (Vstandard_output
))
2004 XSETINT (startpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2006 Fprinc (Fcar (Fcdr (elt
)), Qnil
);
2008 XSETINT (endpos
, BUF_PT (XBUFFER (Vstandard_output
)));
2010 Fset_text_properties (startpos
, endpos
, Qnil
,
2015 Fprinc (Fcar (Fcdr (elt
)), Qnil
);
2020 /* Update COLUMN for what we have output. */
2023 /* If output is to a buffer, recompute COLUMN in a way
2024 that takes account of character widths. */
2025 if (BUFFERP (Vstandard_output
))
2027 tem
= Fcurrent_column ();
2028 column
= XINT (tem
);
2037 if (BUFFERP (Vstandard_output
))
2038 set_buffer_internal (old
);
2040 if (!NILP (Vrun_hooks
))
2041 call1 (Vrun_hooks
, intern ("completion-setup-hook"));
2046 DEFUN ("minibuffer-completion-help", Fminibuffer_completion_help
, Sminibuffer_completion_help
,
2048 "Display a list of possible completions of the current minibuffer contents.")
2051 Lisp_Object completions
;
2053 message ("Making completion list...");
2054 completions
= Fall_completions (Ffield_string (ZV
),
2055 Vminibuffer_completion_table
,
2056 Vminibuffer_completion_predicate
,
2058 clear_message (1, 0);
2060 if (NILP (completions
))
2063 temp_echo_area_glyphs (" [No completions]");
2066 internal_with_output_to_temp_buffer ("*Completions*",
2067 Fdisplay_completion_list
,
2068 Fsort (completions
, Qstring_lessp
));
2072 DEFUN ("self-insert-and-exit", Fself_insert_and_exit
, Sself_insert_and_exit
, 0, 0, "",
2073 "Terminate minibuffer input.")
2076 if (INTEGERP (last_command_char
))
2077 internal_self_insert (XINT (last_command_char
), 0);
2081 Fthrow (Qexit
, Qnil
);
2084 DEFUN ("exit-minibuffer", Fexit_minibuffer
, Sexit_minibuffer
, 0, 0, "",
2085 "Terminate this minibuffer argument.")
2088 Fthrow (Qexit
, Qnil
);
2091 DEFUN ("minibuffer-depth", Fminibuffer_depth
, Sminibuffer_depth
, 0, 0, 0,
2092 "Return current depth of activations of minibuffer, a nonnegative integer.")
2095 return make_number (minibuf_level
);
2098 DEFUN ("minibuffer-prompt", Fminibuffer_prompt
, Sminibuffer_prompt
, 0, 0, 0,
2099 "Return the prompt string of the currently-active minibuffer.\n\
2100 If no minibuffer is active, return nil.")
2103 return Fcopy_sequence (minibuf_prompt
);
2107 /* Temporarily display the string M at the end of the current
2108 minibuffer contents. This is used to display things like
2109 "[No Match]" when the user requests a completion for a prefix
2110 that has no possible completions, and other quick, unobtrusive
2114 temp_echo_area_glyphs (m
)
2118 int osize_byte
= ZV_BYTE
;
2120 int opoint_byte
= PT_BYTE
;
2121 Lisp_Object oinhibit
;
2122 oinhibit
= Vinhibit_quit
;
2124 /* Clear out any old echo-area message to make way for our new thing. */
2127 SET_PT_BOTH (osize
, osize_byte
);
2129 SET_PT_BOTH (opoint
, opoint_byte
);
2131 Fsit_for (make_number (2), Qnil
, Qnil
);
2132 del_range_both (osize
, osize_byte
, ZV
, ZV_BYTE
, 1);
2133 SET_PT_BOTH (opoint
, opoint_byte
);
2134 if (!NILP (Vquit_flag
))
2137 Vunread_command_events
= Fcons (make_number (quit_char
), Qnil
);
2139 Vinhibit_quit
= oinhibit
;
2142 DEFUN ("minibuffer-message", Fminibuffer_message
, Sminibuffer_message
,
2144 "Temporarily display STRING at the end of the minibuffer.\n\
2145 The text is displayed for two seconds,\n\
2146 or until the next input event arrives, whichever comes first.")
2150 temp_echo_area_glyphs (XSTRING (string
)->data
);
2155 init_minibuf_once ()
2157 Vminibuffer_list
= Qnil
;
2158 staticpro (&Vminibuffer_list
);
2165 minibuf_prompt
= Qnil
;
2166 staticpro (&minibuf_prompt
);
2168 minibuf_save_list
= Qnil
;
2169 staticpro (&minibuf_save_list
);
2171 Qread_file_name_internal
= intern ("read-file-name-internal");
2172 staticpro (&Qread_file_name_internal
);
2174 Qminibuffer_default
= intern ("minibuffer-default");
2175 staticpro (&Qminibuffer_default
);
2176 Fset (Qminibuffer_default
, Qnil
);
2178 Qminibuffer_completion_table
= intern ("minibuffer-completion-table");
2179 staticpro (&Qminibuffer_completion_table
);
2181 Qminibuffer_completion_confirm
= intern ("minibuffer-completion-confirm");
2182 staticpro (&Qminibuffer_completion_confirm
);
2184 Qminibuffer_completion_predicate
= intern ("minibuffer-completion-predicate");
2185 staticpro (&Qminibuffer_completion_predicate
);
2187 staticpro (&last_exact_completion
);
2188 last_exact_completion
= Qnil
;
2190 staticpro (&last_minibuf_string
);
2191 last_minibuf_string
= Qnil
;
2193 Quser_variable_p
= intern ("user-variable-p");
2194 staticpro (&Quser_variable_p
);
2196 Qminibuffer_history
= intern ("minibuffer-history");
2197 staticpro (&Qminibuffer_history
);
2199 Qbuffer_name_history
= intern ("buffer-name-history");
2200 staticpro (&Qbuffer_name_history
);
2201 Fset (Qbuffer_name_history
, Qnil
);
2203 Qminibuffer_setup_hook
= intern ("minibuffer-setup-hook");
2204 staticpro (&Qminibuffer_setup_hook
);
2206 Qminibuffer_exit_hook
= intern ("minibuffer-exit-hook");
2207 staticpro (&Qminibuffer_exit_hook
);
2209 Qhistory_length
= intern ("history-length");
2210 staticpro (&Qhistory_length
);
2212 Qcurrent_input_method
= intern ("current-input-method");
2213 staticpro (&Qcurrent_input_method
);
2215 Qactivate_input_method
= intern ("activate-input-method");
2216 staticpro (&Qactivate_input_method
);
2218 DEFVAR_LISP ("read-buffer-function", &Vread_buffer_function
,
2219 "If this is non-nil, `read-buffer' does its work by calling this function.");
2220 Vread_buffer_function
= Qnil
;
2222 DEFVAR_LISP ("minibuffer-setup-hook", &Vminibuffer_setup_hook
,
2223 "Normal hook run just after entry to minibuffer.");
2224 Vminibuffer_setup_hook
= Qnil
;
2226 DEFVAR_LISP ("minibuffer-exit-hook", &Vminibuffer_exit_hook
,
2227 "Normal hook run just after exit from minibuffer.");
2228 Vminibuffer_exit_hook
= Qnil
;
2230 DEFVAR_LISP ("history-length", &Vhistory_length
,
2231 "*Maximum length for history lists before truncation takes place.\n\
2232 A number means that length; t means infinite. Truncation takes place\n\
2233 just after a new element is inserted. Setting the history-length\n\
2234 property of a history variable overrides this default.");
2235 XSETFASTINT (Vhistory_length
, 30);
2237 DEFVAR_BOOL ("completion-auto-help", &auto_help
,
2238 "*Non-nil means automatically provide help for invalid completion input.");
2241 DEFVAR_BOOL ("completion-ignore-case", &completion_ignore_case
,
2242 "Non-nil means don't consider case significant in completion.");
2243 completion_ignore_case
= 0;
2245 DEFVAR_BOOL ("enable-recursive-minibuffers", &enable_recursive_minibuffers
,
2246 "*Non-nil means to allow minibuffer commands while in the minibuffer.\n\
2247 This variable makes a difference whenever the minibuffer window is active.");
2248 enable_recursive_minibuffers
= 0;
2250 DEFVAR_LISP ("minibuffer-completion-table", &Vminibuffer_completion_table
,
2251 "Alist or obarray used for completion in the minibuffer.\n\
2252 This becomes the ALIST argument to `try-completion' and `all-completion'.\n\
2254 The value may alternatively be a function, which is given three arguments:\n\
2255 STRING, the current buffer contents;\n\
2256 PREDICATE, the predicate for filtering possible matches;\n\
2257 CODE, which says what kind of things to do.\n\
2258 CODE can be nil, t or `lambda'.\n\
2259 nil means to return the best completion of STRING, or nil if there is none.\n\
2260 t means to return a list of all possible completions of STRING.\n\
2261 `lambda' means to return t if STRING is a valid completion as it stands.");
2262 Vminibuffer_completion_table
= Qnil
;
2264 DEFVAR_LISP ("minibuffer-completion-predicate", &Vminibuffer_completion_predicate
,
2265 "Within call to `completing-read', this holds the PREDICATE argument.");
2266 Vminibuffer_completion_predicate
= Qnil
;
2268 DEFVAR_LISP ("minibuffer-completion-confirm", &Vminibuffer_completion_confirm
,
2269 "Non-nil => demand confirmation of completion before exiting minibuffer.");
2270 Vminibuffer_completion_confirm
= Qnil
;
2272 DEFVAR_LISP ("minibuffer-completing-file-name",
2273 &Vminibuffer_completing_file_name
,
2274 "Non-nil means completing file names.");
2275 Vminibuffer_completing_file_name
= Qnil
;
2277 DEFVAR_LISP ("minibuffer-help-form", &Vminibuffer_help_form
,
2278 "Value that `help-form' takes on inside the minibuffer.");
2279 Vminibuffer_help_form
= Qnil
;
2281 DEFVAR_LISP ("minibuffer-history-variable", &Vminibuffer_history_variable
,
2282 "History list symbol to add minibuffer values to.\n\
2283 Each string of minibuffer input, as it appears on exit from the minibuffer,\n\
2285 (set minibuffer-history-variable\n\
2286 (cons STRING (symbol-value minibuffer-history-variable)))");
2287 XSETFASTINT (Vminibuffer_history_variable
, 0);
2289 DEFVAR_LISP ("minibuffer-history-position", &Vminibuffer_history_position
,
2290 "Current position of redoing in the history list.");
2291 Vminibuffer_history_position
= Qnil
;
2293 DEFVAR_BOOL ("minibuffer-auto-raise", &minibuffer_auto_raise
,
2294 "*Non-nil means entering the minibuffer raises the minibuffer's frame.\n\
2295 Some uses of the echo area also raise that frame (since they use it too).");
2296 minibuffer_auto_raise
= 0;
2298 DEFVAR_LISP ("completion-regexp-list", &Vcompletion_regexp_list
,
2299 "List of regexps that should restrict possible completions.");
2300 Vcompletion_regexp_list
= Qnil
;
2302 DEFVAR_BOOL ("minibuffer-allow-text-properties",
2303 &minibuffer_allow_text_properties
,
2304 "Non-nil means `read-from-minibuffer' should not discard text properties.\n\
2305 This also affects `read-string', but it does not affect `read-minibuffer',\n\
2306 `read-no-blanks-input', or any of the functions that do minibuffer input\n\
2307 with completion; they always discard text properties.");
2308 minibuffer_allow_text_properties
= 0;
2310 defsubr (&Sset_minibuffer_window
);
2311 defsubr (&Sread_from_minibuffer
);
2312 defsubr (&Seval_minibuffer
);
2313 defsubr (&Sread_minibuffer
);
2314 defsubr (&Sread_string
);
2315 defsubr (&Sread_command
);
2316 defsubr (&Sread_variable
);
2317 defsubr (&Sread_buffer
);
2318 defsubr (&Sread_no_blanks_input
);
2319 defsubr (&Sminibuffer_depth
);
2320 defsubr (&Sminibuffer_prompt
);
2322 defsubr (&Stry_completion
);
2323 defsubr (&Sall_completions
);
2324 defsubr (&Scompleting_read
);
2325 defsubr (&Sminibuffer_complete
);
2326 defsubr (&Sminibuffer_complete_word
);
2327 defsubr (&Sminibuffer_complete_and_exit
);
2328 defsubr (&Sdisplay_completion_list
);
2329 defsubr (&Sminibuffer_completion_help
);
2331 defsubr (&Sself_insert_and_exit
);
2332 defsubr (&Sexit_minibuffer
);
2334 defsubr (&Sminibuffer_message
);
2340 initial_define_key (Vminibuffer_local_map
, Ctl ('g'),
2341 "abort-recursive-edit");
2342 initial_define_key (Vminibuffer_local_map
, Ctl ('m'),
2344 initial_define_key (Vminibuffer_local_map
, Ctl ('j'),
2347 initial_define_key (Vminibuffer_local_ns_map
, Ctl ('g'),
2348 "abort-recursive-edit");
2349 initial_define_key (Vminibuffer_local_ns_map
, Ctl ('m'),
2351 initial_define_key (Vminibuffer_local_ns_map
, Ctl ('j'),
2354 initial_define_key (Vminibuffer_local_ns_map
, ' ',
2356 initial_define_key (Vminibuffer_local_ns_map
, '\t',
2358 initial_define_key (Vminibuffer_local_ns_map
, '?',
2359 "self-insert-and-exit");
2361 initial_define_key (Vminibuffer_local_completion_map
, Ctl ('g'),
2362 "abort-recursive-edit");
2363 initial_define_key (Vminibuffer_local_completion_map
, Ctl ('m'),
2365 initial_define_key (Vminibuffer_local_completion_map
, Ctl ('j'),
2368 initial_define_key (Vminibuffer_local_completion_map
, '\t',
2369 "minibuffer-complete");
2370 initial_define_key (Vminibuffer_local_completion_map
, ' ',
2371 "minibuffer-complete-word");
2372 initial_define_key (Vminibuffer_local_completion_map
, '?',
2373 "minibuffer-completion-help");
2375 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('g'),
2376 "abort-recursive-edit");
2377 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('m'),
2378 "minibuffer-complete-and-exit");
2379 initial_define_key (Vminibuffer_local_must_match_map
, Ctl ('j'),
2380 "minibuffer-complete-and-exit");
2381 initial_define_key (Vminibuffer_local_must_match_map
, '\t',
2382 "minibuffer-complete");
2383 initial_define_key (Vminibuffer_local_must_match_map
, ' ',
2384 "minibuffer-complete-word");
2385 initial_define_key (Vminibuffer_local_must_match_map
, '?',
2386 "minibuffer-completion-help");