[comp.windows.x] XSizeHints documentation bug

mouse@SHAMASH.MCRCIM.MCGILL.EDU (der Mouse) (09/13/90)

			  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:
    The description of the win_gravity member of the XSizeHints
    structure appears to be wrong.

DESCRIPTION:

    The Xlib documentation for the XSizeHints structure says

	typedef struct {
    ....
	     int win_gravity;
	} XSizeHints;
    ....
	desired size of the window.  The win_gravity member defines
	the region of the window that is to be retained when it is
	resized.

    But Tom LaStrange tells me that

	>>> By the time the window manager gets it, the coordinates
	>>> have been converted into positive coordinates.  There are
	>>> however, some hints also given to the window manager about
	>>> which corner/side the coordinates were specified relative
	>>> to.
	>> Where is this set?  None of the window-manager communication
	>> structures have anything of the sort, as far as I could
	>> find.
	> It is in the XSizeHints structure.  The member is
	> win_gravity.

    It appears to me that it is the Xlib documentation that is wrong,
    because (a) Tom L. is who he is, (b) the documented semantics for
    win_gravity strike me as slightly odd, and (c) the ICCCM document
    (which I did not bother to check before, assuming it would agree
    with the Xlib document) agrees with Tom.

REPEAT BY:
    Inspection.

SAMPLE FIX:
    None.  The semantics of this field should be more carefully
    described, or at least there should be a note to see the ICCCM for
    a proper description of the field - but that's a decision that
    should be made by the "owners" of the Xlib document.

					der Mouse

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