[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/commands.texi
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/commands.texi |
Date: |
Sun, 02 Nov 2003 01:30:20 -0500 |
Index: emacs/lispref/commands.texi
diff -c emacs/lispref/commands.texi:1.43 emacs/lispref/commands.texi:1.44
*** emacs/lispref/commands.texi:1.43 Fri Sep 26 05:58:11 2003
--- emacs/lispref/commands.texi Sun Nov 2 01:29:56 2003
***************
*** 340,346 ****
specification. If the key sequence that invoked the command has
@var{n} events that are lists, the @var{n}th @samp{e} provides the
@var{n}th such event. Events that are not lists, such as function keys
! and @sc{ascii} characters, do not count where @samp{e} is concerned.
@item f
A file name of an existing file (@pxref{File Names}). The default
--- 340,346 ----
specification. If the key sequence that invoked the command has
@var{n} events that are lists, the @var{n}th @samp{e} provides the
@var{n}th such event. Events that are not lists, such as function keys
! and @acronym{ASCII} characters, do not count where @samp{e} is concerned.
@item f
A file name of an existing file (@pxref{File Names}). The default
***************
*** 797,803 ****
@end example
@noindent
! The value is 5 because that is the @sc{ascii} code for @kbd{C-e}.
The alias @code{last-command-char} exists for compatibility with
Emacs version 18.
--- 797,803 ----
@end example
@noindent
! The value is 5 because that is the @acronym{ASCII} code for @kbd{C-e}.
The alias @code{last-command-char} exists for compatibility with
Emacs version 18.
***************
*** 916,929 ****
@ifnottex
2**26
@end ifnottex
! bit in the character code indicates a address@hidden
control character.
@sc{ascii} control characters such as @kbd{C-a} have special basic
codes of their own, so Emacs needs no special bit to indicate them.
Thus, the code for @kbd{C-a} is just 1.
! But if you type a control combination not in @sc{ascii}, such as
@kbd{%} with the control key, the numeric value you get is the code
for @kbd{%} plus
@tex
--- 916,929 ----
@ifnottex
2**26
@end ifnottex
! bit in the character code indicates a address@hidden
control character.
@sc{ascii} control characters such as @kbd{C-a} have special basic
codes of their own, so Emacs needs no special bit to indicate them.
Thus, the code for @kbd{C-a} is just 1.
! But if you type a control combination not in @acronym{ASCII}, such as
@kbd{%} with the control key, the numeric value you get is the code
for @kbd{%} plus
@tex
***************
*** 932,938 ****
@ifnottex
2**26
@end ifnottex
! (assuming the terminal supports address@hidden
control characters).
@item shift
--- 932,938 ----
@ifnottex
2**26
@end ifnottex
! (assuming the terminal supports address@hidden
control characters).
@item shift
***************
*** 943,955 ****
@ifnottex
2**25
@end ifnottex
! bit in the character code indicates an @sc{ascii} control
character typed with the shift key held down.
For letters, the basic code itself indicates upper versus lower case;
for digits and punctuation, the shift key selects an entirely different
character with a different basic code. In order to keep within the
! @sc{ascii} character set whenever possible, Emacs avoids using the
@tex
@math{2^{25}}
@end tex
--- 943,955 ----
@ifnottex
2**25
@end ifnottex
! bit in the character code indicates an @acronym{ASCII} control
character typed with the shift key held down.
For letters, the basic code itself indicates upper versus lower case;
for digits and punctuation, the shift key selects an entirely different
character with a different basic code. In order to keep within the
! @acronym{ASCII} character set whenever possible, Emacs avoids using the
@tex
@math{2^{25}}
@end tex
***************
*** 958,964 ****
@end ifnottex
bit for those characters.
! However, @sc{ascii} provides no way to distinguish @kbd{C-A} from
@kbd{C-a}, so Emacs uses the
@tex
@math{2^{25}}
--- 958,964 ----
@end ifnottex
bit for those characters.
! However, @acronym{ASCII} provides no way to distinguish @kbd{C-A} from
@kbd{C-a}, so Emacs uses the
@tex
@math{2^{25}}
***************
*** 1032,1041 ****
@table @asis
@item @code{backspace}, @code{tab}, @code{newline}, @code{return},
@code{delete}
! These keys correspond to common @sc{ascii} control characters that have
special keys on most keyboards.
! In @sc{ascii}, @kbd{C-i} and @key{TAB} are the same character. If the
terminal can distinguish between them, Emacs conveys the distinction to
Lisp programs by representing the former as the integer 9, and the
latter as the symbol @code{tab}.
--- 1032,1041 ----
@table @asis
@item @code{backspace}, @code{tab}, @code{newline}, @code{return},
@code{delete}
! These keys correspond to common @acronym{ASCII} control characters that have
special keys on most keyboards.
! In @acronym{ASCII}, @kbd{C-i} and @key{TAB} are the same character. If the
terminal can distinguish between them, Emacs conveys the distinction to
Lisp programs by representing the former as the integer 9, and the
latter as the symbol @code{tab}.
***************
*** 1047,1053 ****
symbols in this group. The function @code{read-char} likewise converts
these events into characters.
! In @sc{ascii}, @key{BS} is really @kbd{C-h}. But @code{backspace}
converts into the character code 127 (@key{DEL}), not into code 8
(@key{BS}). This is what most users prefer.
--- 1047,1053 ----
symbols in this group. The function @code{read-char} likewise converts
these events into characters.
! In @acronym{ASCII}, @key{BS} is really @kbd{C-h}. But @code{backspace}
converts into the character code 127 (@key{DEL}), not into code 8
(@key{BS}). This is what most users prefer.
***************
*** 1096,1102 ****
Emacs supports four kinds of mouse events: click events, drag events,
button-down events, and motion events. All mouse events are represented
! as lists. The @sc{car} of the list is the event type; this says which
mouse button was involved, and which modifier keys were used with it.
The event type can also distinguish double or triple button presses
(@pxref{Repeat Events}). The rest of the list elements give position
--- 1096,1102 ----
Emacs supports four kinds of mouse events: click events, drag events,
button-down events, and motion events. All mouse events are represented
! as lists. The @acronym{CAR} of the list is the event type; this says which
mouse button was involved, and which modifier keys were used with it.
The event type can also distinguish double or triple button presses
(@pxref{Repeat Events}). The rest of the list elements give position
***************
*** 1521,1527 ****
key binding purposes. For a keyboard event, the event type equals the
event value; thus, the event type for a character is the character, and
the event type for a function key symbol is the symbol itself. For
! events that are lists, the event type is the symbol in the @sc{car} of
the list. Thus, the event type is always a symbol or a character.
Two events of the same type are equivalent where key bindings are
--- 1521,1527 ----
key binding purposes. For a keyboard event, the event type equals the
event value; thus, the event type for a character is the character, and
the event type for a function key symbol is the symbol itself. For
! events that are lists, the event type is the symbol in the @acronym{CAR} of
the list. Thus, the event type is always a symbol or a character.
Two events of the same type are equivalent where key bindings are
***************
*** 1810,1816 ****
can include these codes.
@item
! address@hidden characters above 256 can be included in a multibyte string.
@item
Other keyboard character events cannot fit in a string. This includes
--- 1810,1816 ----
can include these codes.
@item
! address@hidden characters above 256 can be included in a multibyte string.
@item
Other keyboard character events cannot fit in a string. This includes
***************
*** 1979,1985 ****
If @var{inherit-input-method} is address@hidden, then the current input
method (if any) is employed to make it possible to enter a
! address@hidden character. Otherwise, input method handling is disabled
for reading this event.
If @code{cursor-in-echo-area} is address@hidden, then @code{read-event}
--- 1979,1985 ----
If @var{inherit-input-method} is address@hidden, then the current input
method (if any) is employed to make it possible to enter a
! address@hidden character. Otherwise, input method handling is disabled
for reading this event.
If @code{cursor-in-echo-area} is address@hidden, then @code{read-event}
***************
*** 2009,2015 ****
function key event), @code{read-char} signals an error. The arguments
work as in @code{read-event}.
! In the first example, the user types the character @kbd{1} (@sc{ascii}
code 49). The second example shows a keyboard macro definition that
calls @code{read-char} from the minibuffer using @code{eval-expression}.
@code{read-char} reads the keyboard macro's very next character, which
--- 2009,2015 ----
function key event), @code{read-char} signals an error. The arguments
work as in @code{read-event}.
! In the first example, the user types the character @kbd{1} (@acronym{ASCII}
code 49). The second example shows a keyboard macro definition that
calls @code{read-char} from the minibuffer using @code{eval-expression}.
@code{read-char} reads the keyboard macro's very next character, which
***************
*** 2189,2195 ****
as part of a command or explicitly by a Lisp program.
In the example below, the Lisp program reads the character @kbd{1},
! @sc{ascii} code 49. It becomes the value of @code{last-input-event},
while @kbd{C-e} (we assume @kbd{C-x C-e} command is used to evaluate
this expression) remains the value of @code{last-command-event}.
--- 2189,2195 ----
as part of a command or explicitly by a Lisp program.
In the example below, the Lisp program reads the character @kbd{1},
! @acronym{ASCII} code 49. It becomes the value of @code{last-input-event},
while @kbd{C-e} (we assume @kbd{C-x C-e} command is used to evaluate
this expression) remains the value of @code{last-command-event}.
***************
*** 2513,2519 ****
value, @var{arg}. The argument may be a symbol, a number, or a list.
If it is @code{nil}, the value 1 is returned; if it is @code{-}, the
value @minus{}1 is returned; if it is a number, that number is returned;
! if it is a list, the @sc{car} of that list (which should be a number) is
returned.
@end defun
--- 2513,2519 ----
value, @var{arg}. The argument may be a symbol, a number, or a list.
If it is @code{nil}, the value 1 is returned; if it is @code{-}, the
value @minus{}1 is returned; if it is a number, that number is returned;
! if it is a list, the @acronym{CAR} of that list (which should be a number) is
returned.
@end defun
- [Emacs-diffs] Changes to emacs/lispref/commands.texi,
Eli Zaretskii <=