[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/commands.texi,v
From: |
Richard M. Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/commands.texi,v |
Date: |
Sat, 07 Apr 2007 01:48:49 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Richard M. Stallman <rms> 07/04/07 01:48:49
Index: commands.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/commands.texi,v
retrieving revision 1.102
retrieving revision 1.103
diff -u -b -r1.102 -r1.103
--- commands.texi 1 Apr 2007 18:11:15 -0000 1.102
+++ commands.texi 7 Apr 2007 01:48:49 -0000 1.103
@@ -116,13 +116,13 @@
@node Using Interactive
@subsection Using @code{interactive}
address@hidden arguments, interactive entry
This section describes how to write the @code{interactive} form that
makes a Lisp function an interactively-callable command, and how to
examine a command's @code{interactive} form.
@defspec interactive arg-descriptor
address@hidden argument descriptors
This special form declares that the function in which it appears is a
command, and that it may therefore be called interactively (via
@kbd{M-x} or by entering a key sequence bound to it). The argument
@@ -151,7 +151,6 @@
or more arguments.
@item
address@hidden argument prompt
It may be a string; then its contents should consist of a code character
followed by a prompt (which some code characters use and some ignore).
The prompt ends either with the end of the string or with a newline.
@@ -207,7 +206,6 @@
command. Usually this form will call various functions to read input
from the user, most often through the minibuffer (@pxref{Minibuffers})
or directly from the keyboard (@pxref{Reading Input}).
address@hidden argument evaluation form
Providing point or the mark as an argument value is also common, but
if you do this @emph{and} read input (whether using the minibuffer or
@@ -865,8 +863,8 @@
@node Adjusting Point
@section Adjusting Point After Commands
address@hidden adjust point
address@hidden invisible or intangible text, and point display
address@hidden adjusting point
address@hidden invisible/intangible text, and point
@cindex @code{display} property, and point display
@cindex @code{composition} property, and point display
@@ -1781,8 +1779,7 @@
@node Accessing Events
@subsection Accessing Events
address@hidden mouse events, accessing the data
address@hidden accessing data of mouse events
address@hidden mouse events, data in
This section describes convenient functions for accessing the data in
a mouse button or motion event.
@@ -1897,7 +1894,6 @@
is a buffer position, return the size of the character at that position.
@end defun
address@hidden mouse event, timestamp
@cindex timestamp of a mouse event
@defun posn-timestamp position
Return the timestamp in @var{position}. This is the time at which the
@@ -2113,7 +2109,6 @@
for example, @code{describe-key} uses it to read the key to describe.
@defun read-key-sequence prompt &optional continue-echo dont-downcase-last
switch-frame-ok command-loop
address@hidden key sequence
This function reads a key sequence and returns it as a string or
vector. It keeps reading events until it has accumulated a complete key
sequence; that is, enough to specify a non-prefix command using the
@@ -2546,7 +2541,6 @@
as the events will already have been added once as they were read for
the first time. An element of the form @code{(@code{t} . @var{event})}
forces @var{event} to be added to the current command's key sequence.
-
@end defvar
@defun listify-key-sequence key
@@ -2620,9 +2614,9 @@
@end defmac
@defun discard-input
address@hidden flush input
address@hidden discard input
address@hidden terminate keyboard macro
address@hidden flushing input
address@hidden discarding input
address@hidden keyboard macro, terminating
This function discards the contents of the terminal input buffer and
cancels any keyboard macro that might be in the process of definition.
It returns @code{nil}.
@@ -2668,7 +2662,6 @@
@node Waiting
@section Waiting for Elapsed Time or Input
address@hidden pausing
@cindex waiting
The wait functions are designed to wait for a certain amount of time
@@ -2775,7 +2768,7 @@
case of @code{read-quoted-char}, this is so that @kbd{C-q} can be used
to quote a @kbd{C-g}.
address@hidden prevent quitting
address@hidden preventing quitting
You can prevent quitting for a portion of a Lisp function by binding
the variable @code{inhibit-quit} to a address@hidden value. Then,
although @kbd{C-g} still sets @code{quit-flag} to @code{t} as usual, the