(ibuffer-set-mark): Go back to the beginning of the line after setting
[bpt/emacs.git] / man / commands.texi
index 9d8ed27..d7bdb75 100644 (file)
@@ -68,15 +68,17 @@ are mentioned does not matter.
 @cindex @key{ESC} replacing @key{META} key
   Some terminals have a @key{META} key, and allow you to type Meta
 characters by holding this key down.  Thus, @kbd{Meta-a} is typed by
-holding down @key{META} and pressing @kbd{a}.  The @key{META} key works
-much like the @key{SHIFT} key.  Such a key is not always labeled
-@key{META}, however, as this function is often a special option for a key
-with some other primary purpose.@refill
+holding down @key{META} and pressing @kbd{a}.  The @key{META} key
+works much like the @key{SHIFT} key.  Such a key is not always labeled
+@key{META}, however, as this function is often a special option for a
+key with some other primary purpose.  Sometimes it is labeled
+@key{ALT} or @key{EDIT}; on a Sun keyboard, it may have a diamond on
+it.
 
   If there is no @key{META} key, you can still type Meta characters
-using two-character sequences starting with @key{ESC}.  Thus, to enter
-@kbd{M-a}, you could type @kbd{@key{ESC} a}.  To enter @kbd{C-M-a}, you
-would type @kbd{@key{ESC} C-a}.  @key{ESC} is allowed on terminals with
+using two-character sequences starting with @key{ESC}.  Thus, you can enter
+@kbd{M-a} by typing @kbd{@key{ESC} a}.  You can enter @kbd{C-M-a} by
+typing @kbd{@key{ESC} C-a}.  @key{ESC} is allowed on terminals with
 @key{META} keys, too, in case you have formed a habit of using it.
   
   The X Window System provides several other modifier keys that can be
@@ -116,10 +118,11 @@ gets to see them.
 @cindex key sequence
 @cindex key
   A @dfn{key sequence} (@dfn{key}, for short) is a sequence of input
-events that are meaningful as a unit---as ``a single command.''
-Some Emacs command sequences are just one character or one event; for
-example, just @kbd{C-f} is enough to move forward one character.  But
-Emacs also has commands that take two or more events to invoke.
+events that are meaningful as a unit---as ``a single command.''  Some
+Emacs command sequences are just one character or one event; for
+example, just @kbd{C-f} is enough to move forward one character in the
+buffer.  But Emacs also has commands that take two or more events to
+invoke.
 
 @cindex complete key
 @cindex prefix key
@@ -135,45 +138,44 @@ a complete key or a prefix key.
 command bindings.  A few of them are prefix keys.  A prefix key combines
 with the following input event to make a longer key sequence, which may
 itself be complete or a prefix.  For example, @kbd{C-x} is a prefix key,
-so @kbd{C-x} and the next input event combine to make a two-character
+so @kbd{C-x} and the next input event combine to make a two-event
 key sequence.  Most of these key sequences are complete keys, including
 @kbd{C-x C-f} and @kbd{C-x b}.  A few, such as @kbd{C-x 4} and @kbd{C-x
-r}, are themselves prefix keys that lead to three-character key
+r}, are themselves prefix keys that lead to three-event key
 sequences.  There's no limit to the length of a key sequence, but in
 practice people rarely use sequences longer than four events.
 
   By contrast, you can't add more events onto a complete key.  For
-example, the two-character sequence @kbd{C-f C-k} is not a key, because
+example, the two-event sequence @kbd{C-f C-k} is not a key, because
 the @kbd{C-f} is a complete key in itself.  It's impossible to give
 @kbd{C-f C-k} an independent meaning as a command.  @kbd{C-f C-k} is two
 key sequences, not one.@refill
 
   All told, the prefix keys in Emacs are @kbd{C-c}, @kbd{C-h},
 @kbd{C-x}, @kbd{C-x @key{RET}}, @kbd{C-x @@}, @kbd{C-x a}, @kbd{C-x n}, @w{@kbd{C-x
-r}}, @kbd{C-x v}, @kbd{C-x 4}, @kbd{C-x 5}, @kbd{C-x 6}, @key{ESC},
-@kbd{M-g} and @kbd{M-j}.  But this list is not cast in concrete; it is
+r}}, @kbd{C-x v}, @kbd{C-x 4}, @kbd{C-x 5}, @kbd{C-x 6}, @key{ESC}, and
+@kbd{M-g}.  But this list is not cast in concrete; it is
 just a matter of Emacs's standard key bindings.  If you customize Emacs,
 you can make new prefix keys, or eliminate these.  @xref{Key Bindings}.
 
   If you do make or eliminate prefix keys, that changes the set of
 possible key sequences.  For example, if you redefine @kbd{C-f} as a
 prefix, @kbd{C-f C-k} automatically becomes a key (complete, unless you
-define it too as a prefix).  Conversely, if you remove the prefix
+define that too as a prefix).  Conversely, if you remove the prefix
 definition of @kbd{C-x 4}, then @kbd{C-x 4 f} (or @kbd{C-x 4
 @var{anything}}) is no longer a key.
 
   Typing the help character (@kbd{C-h} or @key{F1}) after a prefix
-character displays a list of the commands starting with that prefix.
-There are a few prefix characters for which @kbd{C-h} does not
+key displays a list of the commands starting with that prefix.
+There are a few prefix keys for which @kbd{C-h} does not
 work---for historical reasons, they have other meanings for @kbd{C-h}
 which are not easy to change.  But @key{F1} should work for all prefix
-characters.
+keys.
   
 @node Commands, Text Characters, Keys, Top
 @section Keys and Commands
 
 @cindex binding
-@cindex function
 @cindex command
 @cindex function definition
   This manual is full of passages that tell you what particular keys
@@ -210,7 +212,7 @@ state the name of the command which really does the work in parentheses
 after mentioning the key that runs it.  For example, we will say that
 ``The command @kbd{C-n} (@code{next-line}) moves point vertically
 down,'' meaning that @code{next-line} is a command that moves vertically
-down and @kbd{C-n} is a key that is standardly bound to it.
+down, and @kbd{C-n} is a key that is normally bound to it.
 
   While we are on the subject of information for customization only,
 it's a good time to tell you about @dfn{variables}.  Often the