>># 
>># Copyright 1990, 1991 by the Massachusetts Institute of Technology and
>># UniSoft Group Limited.
>># 
>># Permission to use, copy, modify, distribute, and sell this software and
>># its documentation for any purpose is hereby granted without fee,
>># provided that the above copyright notice appear in all copies and that
>># both that copyright notice and this permission notice appear in
>># supporting documentation, and that the names of MIT and UniSoft not be
>># used in advertising or publicity pertaining to distribution of the
>># software without specific, written prior permission.  MIT and UniSoft
>># make no representations about the suitability of this software for any
>># purpose.  It is provided "as is" without express or implied warranty.
>># 
>># $XConsortium: gtpntrmppn.m,v 1.7 92/06/11 17:14:23 rws Exp $
>># 
>>#
>>TITLE XGetPointerMapping CH07
>>ASSERTION B XGetPointerMapping-1
A call to XGetPointerMapping returns in map_return[i] the
logical button numbers of the physical buttons i+1.
>>STRATEGY
Call XGetPointerMapping to get pointer mapping.
If extension available:
  Create window and map it.
  Select for ButtonPress events.
  Warp into window.
  For i in 1..nphysbuttons
    Simulate pressing button i.
    Check for incoming ButtonPress event.
    Check that event.xbutton.button is map_return[i-1].
    Release all buttons.
else
  UNTESTED touch test only.
>>ASSERTION B XGetPointerMapping-2
A call to XGetPointerMapping returns the number of physical
buttons actually on the pointer.
>>STRATEGY
Call XGetPointerMapping to get number of buttons.
Check this lies within the protocol limit of 1..5.
If extension available:
  Simulate the pressing of buttons 1..5 and check that
    we got Success for buttons in the range returned by XGetPointerMapping, and
    we got BadValue for the rest.
  Release all buttons.
>>ASSERTION A XGetPointerMapping-3
When the nmap argument is less than the number of elements
in the pointer mapping, then only the first nmap elements
are returned in map_return.
>>STRATEGY
Set all elements of map_return to 255.
Set nmap to a value less than number of elements in the pointer mapping.
Call XGetPointerMapping.
Verify that elements of map_return beyond nmap-1 are still 255.
