man pages for XSelectInput and XMapWindow should document ordering issue
Submitted by Alan Coopersmith
Assigned to Xorg Project Team
The man pages for XSelectInput and XMapWindow should indicate that XSelectInput should be called before XMapWindow, to avoid losing Expose events. See O'Reilly, for example, in volume 2 man page for XMapWindow:
"The client should call XSelectInput() for exposure events, then map, then process input events. The client's normal response to an Expose event should be to repaint the window. If you fail to wait for the Expose event before drawing, the drawing may not appear in the window."
[Originally reported to Sun as Sun bug id #4333109.]