From d041f30777c09f07ac79fface61bfbfa654306f2 Mon Sep 17 00:00:00 2001 From: Peter Hutterer Date: Thu, 14 May 2009 10:29:49 +1000 Subject: [PATCH] Add an introduction to XI2proto.txt --- XI2proto.txt | 29 +++++++++++++++++++++++------ 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/XI2proto.txt b/XI2proto.txt index 61d91b6..3287c48 100644 --- a/XI2proto.txt +++ b/XI2proto.txt @@ -1,10 +1,10 @@ - The X Input Extension - Version 2.0 + The X Input Extension + Version 2.0 - Peter Hutterer - peter.hutterer@redhat.com - Red Hat, Inc. + Peter Hutterer + peter.hutterer@redhat.com + Red Hat, Inc. @@ -13,7 +13,24 @@ The X Input Extension version 2.0 (XI2) is the second major release of the X Input Extension. -FIXME +XI2 provides a number of enhancements over version 1.5, including: +- use of XGE and GenericEvents. GenericEvents are of flexible length with a + minimum length of 32 bytes. +- explicit device hierarchy of master and slave devices. See Section 4. +- use of multiple independent master devices (Multi-Poiner X or MPX). +- the ability for devices to change capabilities at runtime. +- raw device events + +XI2's intent is to replace both core input processing and prior versions of +the X Input Extension. Historically, the majority of applications employed the +core protocol requests and events to handle user input. The core protocol does +not provide information about which device generated the event. The X Input +Extension version up to 1.5 requires the differentiation between core and +extended devices. Extended devices may not be core devices and thus cannot be +used on applications employing the core protocol. XI2 addresses both of these +issues by enabling devices to be both extended and core devices and providing +device information in each event (with the exception of core events). + ❧❧❧❧❧❧❧❧❧❧❧ 2. Notations used in this document -- 2.7.4