aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--lispref/commands.texi21
1 files changed, 12 insertions, 9 deletions
diff --git a/lispref/commands.texi b/lispref/commands.texi
index 7a2cdb8edf9..aa05e0a48f2 100644
--- a/lispref/commands.texi
+++ b/lispref/commands.texi
@@ -150,18 +150,21 @@ It may be omitted or @code{nil}; then the command is called with no
150arguments. This leads quickly to an error if the command requires one 150arguments. This leads quickly to an error if the command requires one
151or more arguments. 151or more arguments.
152 152
153
153@item 154@item
154It may be a Lisp expression that is not a string; then it should be a 155It may be a Lisp expression that is not a string; then it should be a
155form that is evaluated to get a list of arguments to pass to the 156form that is evaluated to get a list of arguments to pass to the
156command. 157command. Usually this form will call various functions to read input
158from the user, most often through the minibuffer (@pxref{Minibuffer})
159or directly from the keyboard (@pxref{Reading Input}).
157@cindex argument evaluation form 160@cindex argument evaluation form
158 161
159If this expression reads keyboard input (this includes using the 162Providing point or the mark as an argument value is also common, but
160minibuffer), keep in mind that the integer value of point or the mark 163if you do this @emph{and} read input (whether using the minibuffer or
161before reading input may be incorrect after reading input. This is 164not), be sure to get the integer values of point or the mark after
162because the current buffer may be receiving subprocess output; 165reading. The current buffer may be receiving subprocess output; if
163if subprocess output arrives while the command is waiting for input, 166subprocess output arrives while the command is waiting for input, it
164it could relocate point and the mark. 167could relocate point and the mark.
165 168
166Here's an example of what @emph{not} to do: 169Here's an example of what @emph{not} to do:
167 170
@@ -172,8 +175,8 @@ Here's an example of what @emph{not} to do:
172@end smallexample 175@end smallexample
173 176
174@noindent 177@noindent
175Here's how to avoid the problem, by examining point and the mark only 178Here's how to avoid the problem, by examining point and the mark after
176after reading the keyboard input: 179reading the keyboard input:
177 180
178@smallexample 181@smallexample
179(interactive 182(interactive