diff options
Diffstat (limited to 'doc/lispref')
| -rw-r--r-- | doc/lispref/compile.texi | 6 | ||||
| -rw-r--r-- | doc/lispref/minibuf.texi | 20 | ||||
| -rw-r--r-- | doc/lispref/variables.texi | 10 |
3 files changed, 23 insertions, 13 deletions
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 311b6f5b3fb..e979fda41eb 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -302,7 +302,7 @@ function is called, it reads the full definition from the file, to replace the place-holder. The advantage of dynamic function loading is that loading the file -becomes much faster. This is a good thing for a file which contains +should become faster. This is a good thing for a file which contains many separate user-callable functions, if using one of them does not imply you will probably also use the rest. A specialized mode which provides many keyboard commands often has that usage pattern: a user may @@ -326,6 +326,10 @@ installed Emacs files. But they are quite likely to happen with Lisp files that you are changing. The easiest way to prevent these problems is to reload the new compiled file immediately after each recompilation. + @emph{Experience shows that using dynamic function loading provides +benefits that are hardly measurable, so this feature is deprecated +since Emacs 27.1.} + The byte compiler uses the dynamic function loading feature if the variable @code{byte-compile-dynamic} is non-@code{nil} at compilation time. Do not set this variable globally, since dynamic loading is diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi index ac38b9d390d..2488fb37529 100644 --- a/doc/lispref/minibuf.texi +++ b/doc/lispref/minibuf.texi @@ -2236,16 +2236,16 @@ the end of @var{question}. The possible responses are provided in @noindent where @var{long-answer} is the complete text of the user response, a string; @var{short-answer} is a short form of the same response, a -single character; and @var{help-message} is the text that describes -the meaning of the answer. If the variable @code{read-answer-short} -is non-@code{nil}, the prompt will show the short variants of the -possible answers and the user is expected to type the single -characters shown in the prompt; otherwise the prompt will show the -long variants of the answers, and the user is expected to type the -full text of one of the answers and end by pressing @key{RET}. If -@code{use-dialog-box} is non-@code{nil}, and this function was invoked -by mouse events, the question and the answers will be displayed in a -GUI dialog box. +single character or a function key; and @var{help-message} is the text +that describes the meaning of the answer. If the variable +@code{read-answer-short} is non-@code{nil}, the prompt will show the +short variants of the possible answers and the user is expected to +type the single characters/keys shown in the prompt; otherwise the +prompt will show the long variants of the answers, and the user is +expected to type the full text of one of the answers and end by +pressing @key{RET}. If @code{use-dialog-box} is non-@code{nil}, and +this function was invoked by mouse events, the question and the +answers will be displayed in a GUI dialog box. The function returns the text of the @var{long-answer} selected by the user, regardless of whether long or short answers were shown in the diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi index 33897bb6336..abcd4bbd0f7 100644 --- a/doc/lispref/variables.texi +++ b/doc/lispref/variables.texi @@ -1187,8 +1187,14 @@ When evaluating Emacs Lisp code directly using an @code{eval} call, lexical binding is enabled if the @var{lexical} argument to @code{eval} is non-@code{nil}. @xref{Eval}. -Lexical binding is also enabled in Lisp Interaction and IELM -mode, used in the @file{*scratch*} and @file{*ielm*} buffers. +@findex eval-expression@r{, and }lexical-binding +Lexical binding is also enabled in Lisp Interaction and IELM mode, +used in the @file{*scratch*} and @file{*ielm*} buffers, and also when +evaluating expressions via @kbd{M-:} (@code{eval-expression}) and when +processing the @option{--eval} command-line options of Emacs +(@pxref{Action Arguments,,, emacs, The GNU Emacs Manual}) and +@command{emacsclient} (@pxref{emacsclient Options,,, emacs, The GNU +Emacs Manual}). @cindex special variables Even when lexical binding is enabled, certain variables will |