[comp.windows.x] do-not-propagate mask documentation bug

mouse@LARRY.MCRCIM.MCGILL.EDU (10/06/90)

                     [being sent to both xbugs and xpert]

			  X Window System Bug Report
			    xbugs@expo.lcs.mit.edu


VERSION:
    R4

CLIENT MACHINE and OPERATING SYSTEM:
    N/A

DISPLAY TYPE:
    N/A

WINDOW MANAGER:
    N/A

AREA:
    Xlib documentation

SYNOPSIS:
    Section 3.2.7 (Event Mask and Do Not Propagate Mask Attributes)
    under section 3.2 (Window Attributes) does not sufficiently
    describe the do-not-propagate mask.

DESCRIPTION:

	3.2.7.  Event Mask and Do Not Propagate Mask Attributes
....
	event types, inferiors of that window).  The do-not-
	propagate-mask attribute defines which events should not be
	propagated to ancestor windows when no client has the event
	type selected in this InputOutput or InputOnly window.  Both
	masks are the bitwise inclusive OR of one or more of the
	valid event mask bits.  You can specify that no maskable
	events are reported by setting NoEventMask (default).

    However, according to the protocol document, the do-not-propagate
    mask is SETofDEVICEEVENT, not SETofEVENT.  (I tried to use
    EnterWindowMask and LeaveWindowMask in the do-not-propagate mask
    and had to go to the bible to figure out why I was getting this
    strange error....)  The documentation should describe what bits are
    allowed in the do-not-propagate mask; the paragraph I quoted above
    seems to me to clearly imply that the valid bits are the same for
    both masks, which is not true.

    I am not convinced the current behavior is correct, but I do not
    feel it is worth recommending a protocol change for.  (For that
    matter, why are EnterNotify and LeaveNotify not in DEVICEEVENT?)

REPEAT BY:
    Inspection.

SAMPLE FIX:
    None.  Phrase it your own way.

					der Mouse

			old: mcgill-vision!mouse
			new: mouse@larry.mcrcim.mcgill.edu