# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1026080907 0
# Node ID b77938fad6d0c4bc9dd407b61cace7bb7ff33f56
# Parent  5b2dc288dca5e0a2f34e228885e6eee1a6072755
Add x-*-keysym.

diff -r 5b2dc288dca5 -r b77938fad6d0 lispref/os.texi
--- a/lispref/os.texi	Sun Jul 07 21:48:12 2002 +0000
+++ b/lispref/os.texi	Sun Jul 07 22:28:27 2002 +0000
@@ -28,7 +28,7 @@
 * Terminal Input::      Recording terminal input for debugging.
 * Terminal Output::     Recording terminal output for debugging.
 * Sound Output::        Playing sounds on the computer's speaker.
-* Special Keysyms::     Defining system-specific key symbols for X.
+* X11 Keysyms::         Operating on key symbols for X Windows
 * Flow Control::        How to turn output flow control on or off.
 * Batch Mode::          Running Emacs without terminal interaction.
 * Session Management::  Saving and restoring state with X Session Management.
@@ -1848,8 +1848,8 @@
 is called with one argument, a property list that describes the sound.
 @end defvar
 
-@node Special Keysyms
-@section System-Specific X11 Keysyms
+@node X11 Keysyms
+@section Operating on X11 Keysyms
 
 To define system-specific X11 keysyms, set the variable
 @code{system-key-alist}.
@@ -1885,6 +1885,21 @@
 buffer-local.  @xref{Multiple Displays}.
 @end defvar
 
+You can specify which keysyms Emacs should use for the Meta, Alt, Hyper, and Super modifiers by setting these variables:
+
+@defvar x-alt-keysym
+@defvarx x-meta-keysym
+@defvarx x-hyper-keysym
+@defvarx x-super-keysym
+The name of the keysym that should stand for the Alt modifier
+(respectively, for Meta, Hyper, and Super).  For example, here is
+how to swap the Meta and Alt modifiers within Emacs:
+@lisp
+(setq x-alt-keysym 'meta)
+(setq x-meta-keysym 'alt)
+@end lisp
+@end defvar
+
 @node Flow Control
 @section Flow Control
 @cindex flow control characters