diff options
Diffstat (limited to 'specs/appB')
| -rw-r--r-- | specs/appB | 66 |
1 files changed, 33 insertions, 33 deletions
@@ -1,7 +1,7 @@ .\" $Xorg: appB,v 1.3 2000/08/17 19:42:48 cpqbld Exp $ .\" Copyright \(co 1985, 1986, 1987, 1988, 1991, 1994 .\" X Consortium -.\" +.\" .\" Permission is hereby granted, free of charge, to any person obtaining .\" a copy of this software and associated documentation files (the .\" "Software"), to deal in the Software without restriction, including @@ -9,10 +9,10 @@ .\" distribute, sublicense, and/or sell copies of the Software, and to .\" permit persons to whom the Software is furnished to do so, subject to .\" the following conditions: -.\" +.\" .\" The above copyright notice and this permission notice shall be included .\" in all copies or substantial portions of the Software. -.\" +.\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. @@ -20,15 +20,15 @@ .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR .\" OTHER DEALINGS IN THE SOFTWARE. -.\" +.\" .\" Except as contained in this notice, the name of the X Consortium shall .\" not be used in advertising or otherwise to promote the sale, use or .\" other dealings in this Software without prior written authorization .\" from the X Consortium. -.\" +.\" .\" Copyright \(co 1985, 1986, 1987, 1988, 1991, 1994 .\" Digital Equipment Corporation, Maynard, Massachusetts. -.\" +.\" .\" Permission to use, copy, modify and distribute this documentation for any .\" purpose and without fee is hereby granted, provided that the above copyright .\" notice appears in all copies and that both that copyright notice and this @@ -109,27 +109,27 @@ Modifier Names .LP The modifier field is used to specify standard X keyboard and button modifier mask bits. -Modifiers are legal on event types +Modifiers are legal on event types .PN KeyPress , -.PN KeyRelease , +.PN KeyRelease , .PN ButtonPress , .PN ButtonRelease , .PN MotionNotify , .PN EnterNotify , .PN LeaveNotify , and their abbreviations. -An error is generated when a translation table +An error is generated when a translation table that contains modifiers for any other events is parsed. .IP \(bu 5 If the modifier list has no entries and is not ``None'', it means ``don't care'' on all modifiers. .IP \(bu 5 -If an exclamation point (!) is specified at the beginning +If an exclamation point (!) is specified at the beginning of the modifier list, it means that the listed modifiers must be in the correct state and no other modifiers can be asserted. .IP \(bu 5 -If any modifiers are specified +If any modifiers are specified and an exclamation point (!) is not specified, it means that the listed modifiers must be in the correct state and ``don't care'' about any other modifiers. @@ -142,12 +142,12 @@ If ``None'' is specified, it means no modifiers can be asserted. If a colon (:) is specified at the beginning of the modifier list, it directs the \*(xI to apply any standard modifiers in the event to map the event keycode into a KeySym. -The default standard modifiers are Shift and Lock, +The default standard modifiers are Shift and Lock, with the interpretation as defined in \fI\*(xP\fP, Section 5. The resulting KeySym must exactly match the specified KeySym, and the nonstandard modifiers in the event must match the modifier list. -For example, ``:<Key>a'' is distinct from ``:<Key>A'', +For example, ``:<Key>a'' is distinct from ``:<Key>A'', and ``:Shift<Key>A'' is distinct from ``:<Key>A''. .IP \(bu 5 If both an exclamation point (!) and a colon (:) are specified at @@ -162,9 +162,9 @@ Then, for example, ``<Key>A'' and ``<Key>a'' are equivalent. .LP In key sequences, a circumflex (^) is an abbreviation for the Control modifier, -a dollar sign ($) is an abbreviation for Meta, +a dollar sign ($) is an abbreviation for Meta, and a backslash (\\) can be used to quote any -character, in particular a double quote ("), a circumflex (^), +character, in particular a double quote ("), a circumflex (^), a dollar sign ($), and another backslash (\\). Briefly: .LP @@ -216,13 +216,13 @@ _ .IN "key modifier" A key modifier is any modifier bit one of whose corresponding KeyCodes contains the corresponding left or right KeySym. -For example, -``m'' or ``Meta'' means any modifier bit mapping to a KeyCode +For example, +``m'' or ``Meta'' means any modifier bit mapping to a KeyCode whose KeySym list contains XK_Meta_L or XK_Meta_R. -Note that this interpretation is for each display, +Note that this interpretation is for each display, not global or even for each application context. The Control, Shift, and Lock modifier names refer -explicitly to the corresponding modifier bits; +explicitly to the corresponding modifier bits; there is no additional interpretation of KeySyms for these modifiers. .LP Because it is possible to associate arbitrary KeySyms with modifiers, the set of @@ -232,19 +232,19 @@ modifier bit whose corresponding KeyCode contains the specified KeySym name. A modifier_list/KeySym combination in a translation matches a modifiers/KeyCode combination in an event in the following ways: .IP 1. 5 -If a colon (:) is used, the \*(xI call the display's -.PN XtKeyProc +If a colon (:) is used, the \*(xI call the display's +.PN XtKeyProc with the KeyCode and modifiers. To match, (\fImodifiers\fP & ~\fImodifiers_return\fP) must equal \fImodifier_list\fP, and \fIkeysym_return\fP must equal the given KeySym. .IP 2. 5 -If (:) is not used, the \*(xI mask off all don't-care bits from the +If (:) is not used, the \*(xI mask off all don't-care bits from the modifiers. This value must be equal to \fImodifier_list\fP. Then, for each possible combination of -don't-care modifiers in the modifier list, the \*(xI call the display's +don't-care modifiers in the modifier list, the \*(xI call the display's .PN XtKeyProc -with the KeyCode and that combination ORed with the cared-about modifier bits +with the KeyCode and that combination ORed with the cared-about modifier bits from the event. \fIKeysym_return\fP must match the KeySym in the translation. .SH @@ -517,14 +517,14 @@ or the numeric values may be specified. If no detail field is specified, then any value in the event detail is accepted as a match. .LP -A KeySym can be specified as any of the standard KeySym names, -a hexadecimal number prefixed with ``0x'' or ``0X'', +A KeySym can be specified as any of the standard KeySym names, +a hexadecimal number prefixed with ``0x'' or ``0X'', an octal number prefixed with ``0'', or a decimal number. A KeySym expressed as a single digit is interpreted as the corresponding Latin 1 KeySym, for example, ``0'' is the KeySym XK_0. Other single character KeySyms are treated as literal constants from Latin 1, for example, ``!'' is treated as 0x21. -Standard KeySym names are as defined in +Standard KeySym names are as defined in .Pn < X11/keysymdef.h > with the ``XK_'' prefix removed. .LP @@ -675,7 +675,7 @@ For double-click on Button1 Up with Shift, use this specification: Shift<Btn1Up>(2) : and() .DE .IP -This is equivalent to the following line with appropriate timers set +This is equivalent to the following line with appropriate timers set between events: .IP .Ds @@ -747,7 +747,7 @@ within the multi-click time interval. For example: Shift <Btn1Up>(2+) : and() .De .IP \(bu 5 -To indicate +To indicate .PN EnterNotify with any modifiers, use this specification: .IP @@ -755,7 +755,7 @@ with any modifiers, use this specification: <Enter> : gimble() .De .IP \(bu 5 -To indicate +To indicate .PN EnterNotify with no modifiers, use this specification: .IP @@ -763,8 +763,8 @@ with no modifiers, use this specification: None <Enter> : in() .De .IP \(bu 5 -To indicate -.PN EnterNotify +To indicate +.PN EnterNotify with Button1 Down and Button2 Up and ``don't care'' about the other modifiers, use this specification: .IP @@ -772,7 +772,7 @@ the other modifiers, use this specification: Button1 ~Button2 <Enter> : the() .De .IP \(bu 5 -To indicate +To indicate .PN EnterNotify with Button1 down and Button2 down exclusively, use this specification: .IP |