comparison lisp/minibuf.el @ 765:a543dd3d410f

[xemacs-hg @ 2002-03-05 13:21:21 by stephent] <m3sn7fcm7w.fsf@mail.contactor.se> <q7u1yic5cj5.fsf@hw1020.wdf.sap-ag.de>
author stephent
date Tue, 05 Mar 2002 13:21:22 +0000
parents 685b588e92d8
children 943eaba38521
comparison
equal deleted inserted replaced
764:3c5d0bca9200 765:a543dd3d410f
762 initial-contents history default) 762 initial-contents history default)
763 "Read a string in the minibuffer, with completion. 763 "Read a string in the minibuffer, with completion.
764 Args: PROMPT, TABLE, PREDICATE, REQUIRE-MATCH, INITIAL-CONTENTS, HISTORY. 764 Args: PROMPT, TABLE, PREDICATE, REQUIRE-MATCH, INITIAL-CONTENTS, HISTORY.
765 PROMPT is a string to prompt with; normally it ends in a colon and a space. 765 PROMPT is a string to prompt with; normally it ends in a colon and a space.
766 TABLE is an alist whose elements' cars are strings, or an obarray. 766 TABLE is an alist whose elements' cars are strings, or an obarray.
767 TABLE can also be a function to do the completion itself.
767 PREDICATE limits completion to a subset of TABLE. 768 PREDICATE limits completion to a subset of TABLE.
768 See `try-completion' for more details on completion, TABLE, and PREDICATE. 769 See `try-completion' and `all-completions' for more details
770 on completion, TABLE, and PREDICATE.
771
769 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless 772 If REQUIRE-MATCH is non-nil, the user is not allowed to exit unless
770 the input is (or completes to) an element of TABLE or is null. 773 the input is (or completes to) an element of TABLE or is null.
771 If it is also not t, Return does not exit if it does non-null completion. 774 If it is also not t, Return does not exit if it does non-null completion.
772 If INITIAL-CONTENTS is non-nil, insert it in the minibuffer initially. 775 If INITIAL-CONTENTS is non-nil, insert it in the minibuffer initially.
773 If it is (STRING . POSITION), the initial input 776 If it is (STRING . POSITION), the initial input
774 is STRING, but point is placed POSITION characters into the string. 777 is STRING, but point is placed POSITION characters into the string.
778
775 HISTORY, if non-nil, specifies a history list 779 HISTORY, if non-nil, specifies a history list
776 and optionally the initial position in the list. 780 and optionally the initial position in the list.
777 It can be a symbol, which is the history list variable to use, 781 It can be a symbol, which is the history list variable to use,
778 or it can be a cons cell (HISTVAR . HISTPOS). 782 or it can be a cons cell (HISTVAR . HISTPOS).
779 In that case, HISTVAR is the history list variable to use, 783 In that case, HISTVAR is the history list variable to use,
780 and HISTPOS is the initial position (the position in the list 784 and HISTPOS is the initial position (the position in the list
781 which INITIAL-CONTENTS corresponds to). 785 which INITIAL-CONTENTS corresponds to).
782 If HISTORY is `t', no history will be recorded. 786 If HISTORY is `t', no history will be recorded.
783 Positions are counted starting from 1 at the beginning of the list. 787 Positions are counted starting from 1 at the beginning of the list.
784 DEFAULT, if non-nil, is the default value. 788 DEFAULT, if non-nil, will be returned when the user enters an empty
789 string.
790
785 Completion ignores case if the ambient value of 791 Completion ignores case if the ambient value of
786 `completion-ignore-case' is non-nil." 792 `completion-ignore-case' is non-nil."
787 (let ((minibuffer-completion-table table) 793 (let ((minibuffer-completion-table table)
788 (minibuffer-completion-predicate predicate) 794 (minibuffer-completion-predicate predicate)
789 (minibuffer-completion-confirm (if (eq require-match 't) nil t)) 795 (minibuffer-completion-confirm (if (eq require-match 't) nil t))