[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

X Strike Force XFree86 SVN commit: r1958 - in trunk/debian: . local



Author: branden
Date: 2004-10-15 16:36:34 -0500 (Fri, 15 Oct 2004)
New Revision: 1958

Modified:
   trunk/debian/CHANGESETS
   trunk/debian/local/FAQ.xhtml
Log:
Improve discussion of Compose/Multi_key per Andrew Suffield.

Make some wording improvements.

Use the "kbd" element, not "code", for marking up keystroke sequences.


Modified: trunk/debian/CHANGESETS
===================================================================
--- trunk/debian/CHANGESETS	2004-10-15 20:57:56 UTC (rev 1957)
+++ trunk/debian/CHANGESETS	2004-10-15 21:36:34 UTC (rev 1958)
@@ -149,7 +149,7 @@
 Update FAQ entry: My keyboard configuration worked with XFree86 4.2; why
 is it messed up now?
 Update FAQ entry: How does the keyboard work in the X Window System?
-    1956
+    1956, 1958
 
 Apply patch (#036) submitted to XFree86 Bugzilla on 2003-04-03 by the DRI
 Developers to fix OpenGL application crashes with "Assertion `vb.context

Modified: trunk/debian/local/FAQ.xhtml
===================================================================
--- trunk/debian/local/FAQ.xhtml	2004-10-15 20:57:56 UTC (rev 1957)
+++ trunk/debian/local/FAQ.xhtml	2004-10-15 21:36:34 UTC (rev 1958)
@@ -882,7 +882,8 @@
 
 <p><em>It will take some time to write a comprehensive entry on this subject,
 but in the meantime it is hoped that the information presented here is useful.
-Thanks to Denis Barbier for his patience and his explanations.</em></p>
+Thanks to Denis Barbier and Andrew Suffield for their patience and
+explanations.</em></p>
 
 <h4>Glossary</h4>
 
@@ -890,9 +891,10 @@
   <dt><strong>compose key</strong></dt>
     <dd>a key which causes the next two keys pressed to be treated specially
     such that they cause a single character to be printed (this is implemented
-    in software); for example, pressing <kbd>Compose + A + E</kbd> would produce
-    the ae ligature (&aelig;); valid compose sequences are defined in
-    locale-specific data files such as <code
+    in software); for example, pressing and releasing <kbd>Compose</kbd>,
+    <kbd>A</kbd>, and then <kbd>E</kbd> in sequence would produce the ae
+    ligature (&aelig;); valid compose sequences are defined in locale-specific
+    data files such as <code
     class="filespec">/usr/X11R6/lib/X11/locale/en_US.UTF-8/Compose</code>; the X
     Window System's <strong>keysym</strong> for this key is
     <code>Multi_key</code></dd>
@@ -1019,15 +1021,15 @@
 gets you the first symbol in the group, and pressing the same key with the
 <code>Shift</code> key held down give you the second symbol in the group.</p>
 
-<p>A U.S. keyboard has only one group, which is sufficient to type all of the
-symbols in the ASCII character set.  Elsewhere in the world, however, keyboards
-frequently have keys engraved with more than two glyphs.  A third and often a
-fourth glyph appear.  These comprise the <em>alternate group</em>, which is
-usually accessed with a modifier key not found on most U.S. keyboards:
+<p>A U.S. keyboard has only one group &mdash; this is sufficient to type all of
+the symbols in the ASCII character set.  Elsewhere in the world, however,
+keyboards frequently have keys engraved with more than two glyphs.  A third and
+often a fourth glyph appear.  These comprise the <em>alternate group</em>, which
+is usually accessed with a modifier key not found on most U.S. keyboards:
 <code>AltGr</code>.  When the <code>AltGr</code> key is pressed, the third and
-fourth glyphs on the keycap can be entered: <code>AltGr + <em>key</em></code>
-gives you the third, and if a fourth is engraved, it is entered with <code>AltGr
-+ Shift + <em>key</em></code>.  For example, on many European keyboards, one can
+fourth glyphs on the keycap can be entered: <kbd>AltGr + <em>key</em></kbd>
+gives you the third, and if a fourth is engraved, it is entered with <kbd>AltGr
++ Shift + <em>key</em></kbd>.  For example, on many European keyboards, one can
 press <kbd>AltGr + E</kbd> to produce the Euro sign (&euro;).  Sometimes the
 <code>Alt</code> key on the right-hand side of the keyboard is used as
 <code>AltGr</code> if there is no key actually engraved with
@@ -1056,6 +1058,12 @@
 defined in software, so that "the keys know what to do" when the alternate group
 is activated or the level is changed.</p>
 
+<p>A separate approach to typing symbols not engraved on the keyboard is to use
+the <code>Multi_key</code>.  This enables you to use two keys to type any symbol
+defined by Compose sequences for your locale.  For most layouts, the
+<code>Multi_key</code> keysym is bound to <kbd>Shift + AltGr</kbd>.  Note that
+<kbd>AltGr + Shift</kbd> means something else; see above.</p>
+
 <h2><a id="specquest" class="bigtext">Specific Questions</a></h2>
 
 <h3><a id="custxsess">How do I customize my X session?</a></h3>
@@ -3117,7 +3125,8 @@
 <p>The author would like to thank Andreas Metzler, Guillem Jover, Ingo Saitz,
 Osamu Aoki, Matthew Arnison, Colin Walters, Steve Swales, Adam Jackson, Thomas
 Dickey, Paul Gotch, Albert Cahalan, Denis Barbier, Jeff Licquia, Fabio Massimo
-Di Nitto, and "ulisses" for their contributions to this document.</p>
+Di Nitto, Andrew Suffield, and "ulisses" for their contributions to this
+document.</p>
 
 <hr />
 <p class="x-small">$Id$</p>



Reply to: