Updated documentation about keyboard modifiers

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/gui/trunk@10931 72102866-910b-0410-8b05-ffd578937521

ChangeLog

@@ -1,3 +1,9 @@
+Mon Sep 17 11:17:46 2001  Nicola Pero  <n.pero@mi.flashnet.it>
+
+	* Documentation/gnustep-gui.texi (Keyboard Modifiers): Updated for
+	the change in xgps/xdps, where we now use Mode_switch as default
+	for ALTERNATE if Alt_R is not on the keyboard.
+
 2001-09-15  Fred Kiefer <FredKiefer@gmx.de>
 
 	* Header/gnustep/gui/NSApplication.h

Documentation/gnustep-gui.texi

@@ -59,7 +59,7 @@ Free Software Foundation instead of in the original English.
 @title GNUstep GUI Library
 @sp 3
 @subtitle Version @value{GNUSTEP-GUI-VERSION}
-@author Adam Fedor (fedor@@gnu.org)
+@author A. Fedor (fedor@@gnu.org), N. Pero (n.pero@@mi.flashnet.it)
 @page
 @vskip 0pt plus 1filll
 Copyright @copyright{} 1999 Free Software Foundation, Inc.
@@ -1268,15 +1268,16 @@ by lines; you have to press @key{ALTERNATE} while acting on a scrollbar
 with the mouse. 
 @end itemize
 @c
-By default, GNUstep uses @code{Control_L} (left Ctrl) 
+By default, GNUstep uses @code{Control_L} (left Ctrl) and
-and @code{Control_R} (right Ctrl) 
+@code{Control_R} (right Ctrl) as @key{CONTROL}, @code{Alt_L} (left alt)
-as @key{CONTROL}, @code{Alt_L} (left alt) as @key{COMMAND}, 
+as @key{COMMAND}, and @code{Alt_R} (right alt, sometimes called AltGr)
-and @code{Alt_R} (right alt, sometimes called AltGr) as @key{ALTERNATE}.  
+as @key{ALTERNATE}.  As a special exception, if @code{Alt_R} is not
+bound to any key on your keyboard, GNUstep will try to use
+@code{Mode_switch} for @key{ALTERNATE} instead.
 
-If this layout does not work for you, because your keyboard 
+If this layout does not work for you, because your keyboard misses some
-misses some of these keys, or they have different X names 
+of these keys, or they have different X names or they conflict heavily
-or they conflict heavily with your window manager shortcuts 
+with your window manager shortcuts (or for any other reason), read on.
-(or for any other reason), read on.  
 
 @subsection Changing the Default Settings
 Under GNUstep, you may change the default as you wish: 
@@ -1325,21 +1326,20 @@ its default value.  The default values are:
 @item GSSecondControlKey
 @code{Control_R}
 @item GSFirstCommandKey
-@code{Alt_L}
+@code{Alt_L} 
 @item GSSecondCommandKey
 @code{NoSymbol}
 @item GSFirstAlternateKey
-@code{Alt_R}
+@code{Alt_R} (or @code{Mode_switch} if there is no @code{Alt_R})
 @item GSSecondAlternateKey
 @code{NoSymbol}
 @end table
 
-What could go wrong is for example that you don't have 
+What could go wrong is for example that you don't have an @code{Alt_L}
-an @code{Alt_L} key.  With the default settings, 
+key.  With the default settings, you will not be able to enter the
-you will not be able to enter the @key{COMMAND} key 
+@key{COMMAND} key (which is quite an important key).  What you can do in
-(which is quite an important key).  
+this case is to use @code{Control_R} as @key{COMMAND}, giving the
-What you can do in this case is to use @code{Control_R} as @key{COMMAND}, 
+following commands (from the command line):
-giving the following commands (from the command line): 
 
 @smallexample
 defaults write NSGlobalDomain GSFirstCommandKey Control_R
@@ -1349,13 +1349,13 @@ defaults write NSGlobalDomain GSSecondControlKey NoSymbol
 These commands write in the GNUstep user database; 
 the information will be used every time you start a GNUstep application. 
 
-The first line sets @code{GSFirstCommandKey} to @code{Control_R}, 
+The first line sets @code{GSFirstCommandKey} to @code{Control_R}, which
-which makes @code{Control_R} to be read as @key{COMMAND}.  
+makes @code{Control_R} to be read as @key{COMMAND}.
 
-The second line disables the second control key, 
+The second line disables the second control key, which would otherwise
-which would otherwise be bound to @code{Control_R} by default. 
+be bound to @code{Control_R} by default. If you omit it,
-If you omit it, @code{Control_R} will be used at the same time 
+@code{Control_R} will be used at the same time as @key{COMMAND} and as
-as @key{COMMAND} and as @key{CONTROL}, which is not very useful. 
+@key{CONTROL}, which is not very useful.
 
 To delete these preferences and restore the defaults, use 
 @smallexample
@@ -1373,18 +1373,17 @@ setting for the @code{GSFirstCommandKey}, for example:
 defaults read | grep GSFirstCommandKey
 @end smallexample
 
-A thing which could go wrong if you are trying to use 
+A thing which could go wrong if you are trying to use a setting
-a setting different from the default, and you do not know much 
+different from the default, and you do not know much about X, is that
-about X, is that you can't find out the name of one of your key.  
+you can't find out the name of one of your key.  In this case, you may
-In this case, you may try having a look at the output of programs 
+try having a look at the output of programs like @code{xmodmap} or
-like @code{xmodmap} or @code{xkeycaps}; even if you do not 
+@code{xkeycaps}; even if you do not understand it completely, the output
-understand it completely, the output can inspire the right guessing.
+can inspire the right guessing.
 
-A problem you are likely to encounter is that of conflicts 
+A problem you are likely to encounter is that of conflicts with the
-with the window manager keyboard shortcuts.  
+window manager keyboard shortcuts.  Good window managers let you change
-Good window managers let you change the keyboard shortcuts, 
+the keyboard shortcuts, so you may move the wm shortcuts that you do not
-so you may move the wm shortcuts that you do not use to keys 
+use to keys which do not conflict (at least not too much) with GNUstep.
-which do not conflict (at least not too much) with GNUstep.  
 
 @node Window Manager,  , Keyboard Modifiers, Setup
 @section Window Manager Recommended Configuration