comparison man/custom.texi @ 39161:10b97dddcb68

Show how to put more special ASCII characters in strings and vectors.

39160:851d0426c8a4

@example
(global-set-key "\C-x\t" 'indent-rigidly)
@end example

  When the key sequence includes function keys or mouse button events,
or non-ASCII characters such as @code{C-=} or @code{H-a}, you must use
the more general method of rebinding, which uses a vector to specify the
key sequence.

(global-set-key [?\H-a] 'make-symbolic-link)
(global-set-key [f7] 'make-symbolic-link)
(global-set-key [C-mouse-1] 'make-symbolic-link)
@end example

  You can use a vector for the simple cases too.  Here's how to rewrite
the first three examples, above, using vectors:

@example
(global-set-key [?\C-z] 'shell)
(global-set-key [?\C-x ?l] 'make-symbolic-link)
(global-set-key [?\C-x ?\t] 'indent-rigidly)
@end example

@node Function Keys
@subsection Rebinding Function Keys

  Key sequences can contain function keys as well as ordinary

39161:10b97dddcb68

@example
(global-set-key "\C-x\t" 'indent-rigidly)
@end example

  These examples show how to write some other special ASCII characters
in strings for key bindings:

@example
(global-set-key "\r" 'newline)               ;; @key{RET}
(global-set-key "\d" 'delete-backward-char)  ;; @key{DEL}
(global-set-key "\C-x\e\e" 'repeat-complex-command)  ;; @key{ESC}
@end example

  When the key sequence includes function keys or mouse button events,
or non-ASCII characters such as @code{C-=} or @code{H-a}, you must use
the more general method of rebinding, which uses a vector to specify the
key sequence.

(global-set-key [?\H-a] 'make-symbolic-link)
(global-set-key [f7] 'make-symbolic-link)
(global-set-key [C-mouse-1] 'make-symbolic-link)
@end example

  You can use a vector for the simple cases too.  Here's how to
rewrite the first three examples above, using vectors to bind
@kbd{C-z}, @kbd{C-x l}, and @kbd{C-x @key{TAB}}:

@example
(global-set-key [?\C-z] 'shell)
(global-set-key [?\C-x ?l] 'make-symbolic-link)
(global-set-key [?\C-x ?\t] 'indent-rigidly)
(global-set-key [?\r] 'newline)
(global-set-key [?\d] 'delete-backward-char)
(global-set-key [?\C-x ?\e ?\e] 'repeat-complex-command)
@end example

@noindent
As you see, you represent a multi-character key sequence with a vector
by listing each of the characters within the square brackets that
delimit the vector.

@node Function Keys
@subsection Rebinding Function Keys

  Key sequences can contain function keys as well as ordinary