From 30a6366a3d9d1fe0b665b31e8d8b8eacf7558fd4 Mon Sep 17 00:00:00 2001 From: tomo Date: Wed, 19 Jan 2000 05:06:56 +0000 Subject: [PATCH] XEmacs 21.2.25 "Hephaestus". --- info/lispref.info-10 | 21 ++++++--- info/lispref.info-15 | 122 ++++++++++++++++++++++++------------------------ info/lispref.info-16 | 64 +++++++++++++++++++------ info/lispref.info-28 | 15 ++++-- info/lispref.info-44 | 10 ++-- info/xemacs-faq.info-4 | 12 ++--- 6 files changed, 145 insertions(+), 99 deletions(-) diff --git a/info/lispref.info-10 b/info/lispref.info-10 index 7667fa8..071f289 100644 --- a/info/lispref.info-10 +++ b/info/lispref.info-10 @@ -672,17 +672,22 @@ Mapping Functions ================= A "mapping function" applies a given function to each element of a -list or other collection. XEmacs Lisp has three such functions; -`mapcar' and `mapconcat', which scan a list, are described here. For -the third mapping function, `mapatoms', see *Note Creating Symbols::. +list or other collection. XEmacs Lisp has several such functions; +`mapcar' and `mapconcat', which scan a list, are described here. +*Note Creating Symbols::, for the function `mapatoms' which maps over +the symbols in an obarray. + + Mapping functions should never modify the sequence being mapped over. +The results are unpredictable. - Function: mapcar function sequence `mapcar' applies FUNCTION to each element of SEQUENCE in turn, and returns a list of the results. - The argument SEQUENCE may be a list, a vector, or a string. The - result is always a list. The length of the result is the same as - the length of SEQUENCE. + The argument SEQUENCE can be any kind of sequence; that is, a + list, a vector, a bit vector, or a string. The result is always a + list. The length of the result is the same as the length of + SEQUENCE. For example: @@ -718,7 +723,9 @@ the third mapping function, `mapatoms', see *Note Creating Symbols::. punctuation. The argument FUNCTION must be a function that can take one - argument and return a string. + argument and return a string. The argument SEQUENCE can be any + kind of sequence; that is, a list, a vector, a bit vector, or a + string. (mapconcat 'symbol-name '(The cat in the hat) diff --git a/info/lispref.info-15 b/info/lispref.info-15 index 21d545b..18fc766 100644 --- a/info/lispref.info-15 +++ b/info/lispref.info-15 @@ -613,6 +613,7 @@ for reading an argument. * Completion:: How to invoke and customize completion. * Yes-or-No Queries:: Asking a question with a simple answer. * Multiple Queries:: Asking a series of similar questions. +* Reading a Password:: Reading a password from the terminal. * Minibuffer Misc:: Various customization hooks and variables.  @@ -627,7 +628,7 @@ in a minibuffer. However, many operations for managing buffers do not apply to minibuffers. The name of a minibuffer always has the form ` *Minibuf-NUMBER', and it cannot be changed. Minibuffers are displayed only in special windows used only for minibuffers; these -windows always appear at the bottom of a frame. (Sometime frames have +windows always appear at the bottom of a frame. (Sometimes frames have no minibuffer window, and sometimes a special kind of frame contains nothing but a minibuffer window; see *Note Minibuffers and Frames::.) @@ -654,9 +655,6 @@ completion commands (*note Completion::). * `minibuffer-local-map' is for ordinary input (no completion). - * `minibuffer-local-ns-map' is similar, except that exits just - like . This is used mainly for Mocklisp compatibility. - * `minibuffer-local-completion-map' is for permissive completion. * `minibuffer-local-must-match-map' is for strict completion and for @@ -679,7 +677,7 @@ reading the arguments for a command, in the `interactive' spec. *Note Defining Commands::. - Function: read-from-minibuffer prompt-string &optional - initial-contents keymap read hist + initial-contents keymap read hist abbrev-table default This function is the most general way to get input through the minibuffer. By default, it accepts arbitrary text and returns it as a string; however, if READ is non-`nil', then it uses `read' to @@ -698,12 +696,25 @@ Defining Commands::. minibuffer but put point POSITION characters from the beginning, rather than at the end. + When the user types a command to exit the minibuffer, + `read-from-minibuffer' constructs the return value from the text in + the minibuffer. Normally it returns a string containing that text. + However, if READ is non-`nil', `read-from-minibuffer' reads the + text and returns the resulting Lisp object, unevaluated. (*Note + Input Functions::, for information about reading.) + + The argument DEFAULT specifies a default value to make available + through the history commands. It should be a string, or `nil'. + If KEYMAP is non-`nil', that keymap is the local keymap to use in the minibuffer. If KEYMAP is omitted or `nil', the value of `minibuffer-local-map' is used as the keymap. Specifying a keymap is the most important way to customize the minibuffer for various applications such as completion. + The argument ABBREV-TABLE specifies `local-abbrev-table' in the + minibuffer (*note Standard Abbrev Tables::). + The argument HIST specifies which history list variable to use for saving the input and for history commands used in the minibuffer. It defaults to `minibuffer-history'. *Note Minibuffer History::. @@ -715,13 +726,25 @@ Defining Commands::. reads the text and returns the resulting Lisp object, unevaluated. (*Note Input Functions::, for information about reading.) - - Function: read-string prompt &optional initial + *Usage note:* The INITIAL-CONTENTS argument and the DEFAULT + argument are two alternative features for more or less the same + job. It does not make sense to use both features in a single call + to `read-from-minibuffer'. In general, we recommend using + DEFAULT, since this permits the user to insert the default value + when it is wanted, but does not burden the user with deleting it + from the minibuffer on other occasions. However, if user is + supposed to edit default value, INITIAL-CONTENTS may be preferred. + + - Function: read-string prompt &optional initial history This function reads a string from the minibuffer and returns it. The arguments PROMPT and INITIAL are used as in `read-from-minibuffer'. The keymap used is `minibuffer-local-map'. - This is a simplified interface to the `read-from-minibuffer' - function: + The optional argument HISTORY, if non-nil, specifies a history + list and optionally the initial position in the list. + + This function is a simplified interface to the + `read-from-minibuffer' function: (read-string PROMPT INITIAL) == @@ -731,7 +754,7 @@ Defining Commands::. This is the default local keymap for reading from the minibuffer. By default, it makes the following bindings: - + `C-j' `exit-minibuffer' @@ -752,37 +775,6 @@ Defining Commands::. `M-s' `previous-matching-history-element' - - Function: read-no-blanks-input prompt &optional initial - This function reads a string from the minibuffer, but does not - allow whitespace characters as part of the input: instead, those - characters terminate the input. The arguments PROMPT and INITIAL - are used as in `read-from-minibuffer'. - - This is a simplified interface to the `read-from-minibuffer' - function, and passes the value of the `minibuffer-local-ns-map' - keymap as the KEYMAP argument for that function. Since the keymap - `minibuffer-local-ns-map' does not rebind `C-q', it _is_ possible - to put a space into the string, by quoting it. - - (read-no-blanks-input PROMPT INITIAL) - == - (read-from-minibuffer PROMPT INITIAL minibuffer-local-ns-map) - - - Variable: minibuffer-local-ns-map - This built-in variable is the keymap used as the minibuffer local - keymap in the function `read-no-blanks-input'. By default, it - makes the following bindings, in addition to those of - `minibuffer-local-map': - - - `exit-minibuffer' - - - `exit-minibuffer' - - `?' - `self-insert-and-exit' -  File: lispref.info, Node: Object from Minibuffer, Next: Minibuffer History, Prev: Text from Minibuffer, Up: Minibuffers @@ -793,9 +785,9 @@ Reading Lisp Objects with the Minibuffer minibuffer. - Function: read-minibuffer prompt &optional initial - This function reads a Lisp object in the minibuffer and returns it, - without evaluating it. The arguments PROMPT and INITIAL are used - as in `read-from-minibuffer'. + This function reads a Lisp object using the minibuffer, and + returns it without evaluating it. The arguments PROMPT and + INITIAL are used as in `read-from-minibuffer'. This is a simplified interface to the `read-from-minibuffer' function: @@ -820,9 +812,9 @@ minibuffer. default, or can edit the input. - Function: eval-minibuffer prompt &optional initial - This function reads a Lisp expression in the minibuffer, evaluates - it, then returns the result. The arguments PROMPT and INITIAL are - used as in `read-from-minibuffer'. + This function reads a Lisp expression using the minibuffer, + evaluates it, then returns the result. The arguments PROMPT and + INITIAL are used as in `read-from-minibuffer'. This function simply evaluates the result of a call to `read-minibuffer': @@ -842,10 +834,10 @@ minibuffer. The first thing `edit-and-eval-command' does is to activate the minibuffer with PROMPT as the prompt. Then it inserts the printed - representation of FORM in the minibuffer, and lets the user edit. - When the user exits the minibuffer, the edited text is read with - `read' and then evaluated. The resulting value becomes the value - of `edit-and-eval-command'. + representation of FORM in the minibuffer, and lets the user edit + it. When the user exits the minibuffer, the edited text is read + with `read' and then evaluated. The resulting value becomes the + value of `edit-and-eval-command'. In the following example, we offer the user an expression with initial text which is a valid form already: @@ -905,6 +897,8 @@ do to use a history list is to initialize it and to pass its name to the input functions when you wish. But it is safe to modify the list by hand when the minibuffer input functions are not using it. + Here are some of the standard minibuffer history list variables: + - Variable: minibuffer-history The default history list for minibuffer history input. @@ -1069,7 +1063,7 @@ that do use the minibuffer. - Function: all-completions string collection &optional predicate nospace This function returns a list of all possible completions of - STRING. The parameters to this function are the same as to + STRING. The arguments to this function are the same as those of `try-completion'. If COLLECTION is a function, it is called with three arguments: @@ -1106,7 +1100,7 @@ Completion and the Minibuffer minibuffer with completion. - Function: completing-read prompt collection &optional predicate - require-match initial hist + require-match initial hist default This function reads a string in the minibuffer, assisting the user by providing completion. It activates the minibuffer with prompt PROMPT, which must be a string. If INITIAL is non-`nil', @@ -1125,11 +1119,17 @@ minibuffer with completion. COLLECTION. If REQUIRE-MATCH is `nil', the exit commands work regardless of the input in the minibuffer. + However, empty input is always permitted, regardless of the value + of REQUIRE-MATCH; in that case, `completing-read' returns DEFAULT. + The value of DEFAULT (if non-`nil') is also available to the user + through the history commands. + The user can exit with null input by typing with an empty - minibuffer. Then `completing-read' returns `nil'. This is how - the user requests whatever default the command uses for the value - being read. The user can return using in this way regardless - of the value of REQUIRE-MATCH. + minibuffer. Then `completing-read' returns `""'. This is how the + user requests whatever default the command uses for the value being + read. The user can return using in this way regardless of + the value of REQUIRE-MATCH, and regardless of whether the empty + string is included in COLLECTION. The function `completing-read' works by calling `read-minibuffer'. It uses `minibuffer-local-completion-map' as the keymap if @@ -1210,7 +1210,7 @@ the minibuffer to do completion. `minibuffer-complete' - + `C-j' `minibuffer-complete-and-exit' @@ -1243,10 +1243,10 @@ the minibuffer to do completion. - Command: minibuffer-complete-and-exit This function completes the minibuffer contents, and exits if confirmation is not required, i.e., if - `minibuffer-completion-confirm' is non-`nil'. If confirmation - _is_ required, it is given by repeating this command - immediately--the command is programmed to work without confirmation - when run twice in succession. + `minibuffer-completion-confirm' is `nil'. If confirmation _is_ + required, it is given by repeating this command immediately--the + command is programmed to work without confirmation when run twice + in succession. - Variable: minibuffer-completion-confirm When the value of this variable is non-`nil', XEmacs asks for diff --git a/info/lispref.info-16 b/info/lispref.info-16 index 618b47f..1ba0d48 100644 --- a/info/lispref.info-16 +++ b/info/lispref.info-16 @@ -181,10 +181,10 @@ of the default directory. `default-directory'. If you specify INITIAL, that is an initial file name to insert in - the buffer (after with DIRECTORY, if that is inserted). In this - case, point goes at the beginning of INITIAL. The default for - INITIAL is `nil'--don't insert any file name. To see what INITIAL - does, try the command `C-x C-v'. + the buffer (after DIRECTORY, if that is inserted). In this case, + point goes at the beginning of INITIAL. The default for INITIAL + is `nil'--don't insert any file name. To see what INITIAL does, + try the command `C-x C-v'. Here is an example: @@ -267,8 +267,12 @@ function do all the work. * `nil' specifies `try-completion'. The completion function should return the completion of the specified string, or `t' if the - string is an exact match already, or `nil' if the string matches no - possibility. + string is a unique and exact match already, or `nil' if the string + matches no possibility. + + If the string is an exact match for one possibility, but also + matches other longer possibilities, the function should return the + string, not `t'. * `t' specifies `all-completions'. The completion function should return a list of all possible completions of the specified string. @@ -419,7 +423,7 @@ dialog boxes instead of minibuffer questions. dialog box or the minibuffer, as appropriate.  -File: lispref.info, Node: Multiple Queries, Next: Minibuffer Misc, Prev: Yes-or-No Queries, Up: Minibuffers +File: lispref.info, Node: Multiple Queries, Next: Reading a Password, Prev: Yes-or-No Queries, Up: Minibuffers Asking Multiple Y-or-N Questions ================================ @@ -506,7 +510,40 @@ facilities such as the ability to answer the whole series at once. on.  -File: lispref.info, Node: Minibuffer Misc, Prev: Multiple Queries, Up: Minibuffers +File: lispref.info, Node: Reading a Password, Next: Minibuffer Misc, Prev: Multiple Queries, Up: Minibuffers + +Reading a Password +================== + + To read a password to pass to another program, you can use the +function `read-passwd'. + + - Function: read-passwd prompt &optional confirm default + This function reads a password, prompting with PROMPT. It does + not echo the password as the user types it; instead, it echoes `.' + for each character in the password. + + The optional argument CONFIRM, if non-`nil', says to read the + password twice and insist it must be the same both times. If it + isn't the same, the user has to type it over and over until the + last two times match. + + The optional argument DEFAULT specifies the default password to + return if the user enters empty input. It is translated to `.' + and inserted in the minibuffer. If DEFAULT is `nil', then + `read-passwd' returns the null string in that case. + + - User Option: passwd-invert-frame-when-keyboard-grabbed + If non-nil swap the foreground and background colors of all faces + while reading a password. Default values is `t' unless feature + `infodock' is provided. + + - User Option: passwd-echo + This specifies the character echoed when typing a password. When + nil, nothing is echoed. + + +File: lispref.info, Node: Minibuffer Misc, Prev: Reading a Password, Up: Minibuffers Minibuffer Miscellany ===================== @@ -600,10 +637,10 @@ than one frame. - User Option: enable-recursive-minibuffers If this variable is non-`nil', you can invoke commands (such as - `find-file') that use minibuffers even while in the minibuffer - window. Such invocation produces a recursive editing level for a - new minibuffer. The outer-level minibuffer is invisible while you - are editing the inner one. + `find-file') that use minibuffers even while the minibuffer window + is active. Such invocation produces a recursive editing level for + a new minibuffer. The outer-level minibuffer is invisible while + you are editing the inner one. This variable only affects invoking the minibuffer while the minibuffer window is selected. If you switch windows while in the @@ -620,8 +657,7 @@ minibuffer. The minibuffer command `next-matching-history-element' want to explicitly set the value of `enable-recursive-minibuffers' in this fashion, just use an evaluated interactive spec and bind `enable-recursive-minibuffers' while reading from the minibuffer. See -the definition of `next-matching-history-element' in -`lisp/prim/minibuf.el'. +the definition of `next-matching-history-element' in `lisp/minibuf.el'.  File: lispref.info, Node: Command Loop, Next: Keymaps, Prev: Minibuffers, Up: Top diff --git a/info/lispref.info-28 b/info/lispref.info-28 index f4f4c69..e520b4f 100644 --- a/info/lispref.info-28 +++ b/info/lispref.info-28 @@ -951,12 +951,13 @@ omitted. (In FSF Emacs, and earlier versions of XEmacs, these functions usually did not have these optional BUFFER arguments and always operated on the current buffer.) - - Function: char-after position &optional buffer + - Function: char-after &optional position buffer This function returns the character in the buffer at (i.e., immediately after) position POSITION. If POSITION is out of range for this purpose, either before the beginning of the buffer, or at - or beyond the end, then the value is `nil'. If optional argument - BUFFER is `nil', the current buffer is assumed. + or beyond the end, then the value is `nil'. The default for + POSITION is point. If optional argument BUFFER is `nil', the + current buffer is assumed. In the following example, assume that the first character in the buffer is `@': @@ -964,6 +965,14 @@ operated on the current buffer.) (char-to-string (char-after 1)) => "@" + - Function: char-before &optional position buffer + This function returns the character in the current buffer + immediately before position POSITION. If POSITION is out of range + for this purpose, either at or before the beginning of the buffer, + or beyond the end, then the value is `nil'. The default for + POSITION is point. If optional argument BUFFER is `nil', the + current buffer is assumed. + - Function: following-char &optional buffer This function returns the character following point in the buffer. This is similar to `(char-after (point))'. However, if point is at diff --git a/info/lispref.info-44 b/info/lispref.info-44 index af17b43..917258b 100644 --- a/info/lispref.info-44 +++ b/info/lispref.info-44 @@ -100,13 +100,10 @@ Index * <: Comparison of Numbers. * <=: Comparison of Numbers. * : Functions for Key Lookup. -* in minibuffer: Text from Minibuffer. -* in minibuffer: Text from Minibuffer. * =: Comparison of Numbers. * >: Comparison of Numbers. * >=: Comparison of Numbers. * ? in character constant: Character Type. -* ? in minibuffer: Text from Minibuffer. * ? in regexp: Syntax of Regexps. * @ in interactive: Using Interactive. * [ in regexp: Syntax of Regexps. @@ -539,6 +536,7 @@ Index * changing window size: Resizing Windows. * char table type: Char Table Type. * char-after: Near Point. +* char-before: Near Point. * char-charset: MULE Characters. * char-equal: Text Comparison. * char-int: Character Codes. @@ -2120,7 +2118,6 @@ Index * minibuffer-local-map: Text from Minibuffer. * minibuffer-local-must-match-map <1>: Standard Keymaps. * minibuffer-local-must-match-map: Completion Commands. -* minibuffer-local-ns-map: Text from Minibuffer. * minibuffer-prompt: Minibuffer Misc. * minibuffer-prompt-width: Minibuffer Misc. * minibuffer-scroll-window: Minibuffer Misc. @@ -2299,6 +2296,9 @@ Index * parse-sexp-ignore-comments: Parsing Expressions. * parsing: Syntax Tables. * partial files: Partial Files. +* passwd-echo: Reading a Password. +* passwd-invert-frame-when-keyboard-grabbed: Reading a Password. +* passwords, reading: Reading a Password. * PATH environment variable: Subprocess Creation. * path-separator: System Environment. * pausing: Waiting. @@ -2519,9 +2519,9 @@ Index * read-from-string: Input Functions. * read-key-sequence: Key Sequence Input. * read-minibuffer: Object from Minibuffer. -* read-no-blanks-input: Text from Minibuffer. * read-only buffer: Read Only Buffers. * read-only buffers in interactive: Using Interactive. +* read-passwd: Reading a Password. * read-quoted-char: Quoted Character Input. * read-quoted-char quitting: Quitting. * read-shell-command-map: Standard Keymaps. diff --git a/info/xemacs-faq.info-4 b/info/xemacs-faq.info-4 index 769fb4c..b3e4406 100644 --- a/info/xemacs-faq.info-4 +++ b/info/xemacs-faq.info-4 @@ -956,15 +956,9 @@ File: xemacs-faq.info, Node: Q4.7.6, Prev: Q4.7.5, Up: Subsystems Q4.7.5: Is there a MatLab mode? ------------------------------- - Is there any way I can get syntax highlighting for MatLab .m files? -Can I "teach" emacs what words are MatLab commands, comments, etc. ? - - Ulrich Elsner writes: - One way to do this (and much more) is by using the matlab mode. - (If someone knows where this can be found, please contact the - XEmacs FAQ maintainer . - - Instructions on how to install this mode are included in this file. + Yes, a matlab mode and other items are available at the MathWorks' +emacs_add_ons ftp directory +(ftp://ftp.mathworks.com/pub/contrib/emacs_add_ons).  File: xemacs-faq.info, Node: Miscellaneous, Next: MS Windows, Prev: Subsystems, Up: Top -- 1.7.10.4