diff --git a/specs/sect1-9.xml b/specs/sect1-9.xml index a7063a5..524db52 100644 --- a/specs/sect1-9.xml +++ b/specs/sect1-9.xml @@ -1743,14 +1743,10 @@ red-mask, green-mask, and blue-mask. -Requests - - - - -CreateWindow -CreateWindow - + Requests +
+ CreateWindow + CreateWindow @@ -2336,10 +2332,10 @@ undefined effect on the window state. The server might or might not make a copy of the pixmap. - -ChangeWindowAttributes -ChangeWindowAttributes - +
+
+ ChangeWindowAttributes + ChangeWindowAttributes @@ -2456,10 +2452,10 @@ If an error is generated, a subset of the attributes may have been altered. - -GetWindowAttributes -GetWindowAttributes - +
+
+ GetWindowAttributes + GetWindowAttributes @@ -2580,10 +2576,10 @@ by clients. Your-event-mask is the event mask selected by the querying client. - -DestroyWindow -DestroyWindow - +
+
+ DestroyWindow + DestroyWindow @@ -2633,10 +2629,10 @@ If the window is a root window, this request has no effect. - -DestroySubwindows -DestroySubwindows - +
+
+ DestroySubwindows + DestroySubwindows @@ -2667,10 +2663,10 @@ This request performs a request on all children of the window, in bottom-to-top stacking order. - -ChangeSaveSet -ChangeSaveSet - +
+
+ ChangeSaveSet + ChangeSaveSet @@ -2718,10 +2714,10 @@ When windows are destroyed, the server automatically removes them from the save-set. - -ReparentWindow -ReparentWindow - +
+
+ ReparentWindow + ReparentWindow @@ -2798,10 +2794,10 @@ The window has a background, and the new parent is not the same depth as the window. - -MapWindow -MapWindow - +
+
+ MapWindow + MapWindow @@ -2855,10 +2851,10 @@ Otherwise, only visible regions may be reported. Similar tiling and exposure take place for any newly viewable inferiors. - -MapSubwindows -MapSubwindows - +
+
+ MapSubwindows + MapSubwindows @@ -2890,10 +2886,10 @@ request on all unmapped children of the window, in top-to-bottom stacking order. - -UnmapWindow -UnmapWindow - +
+
+ UnmapWindow + UnmapWindow @@ -2926,10 +2922,10 @@ event is generated. Normal exposure processing on formerly obscured windows is performed. - -UnmapSubwindows -UnmapSubwindows - +
+
+ UnmapSubwindows + UnmapSubwindows @@ -2961,10 +2957,10 @@ request on all mapped children of the window, in bottom-to-top stacking order. - -ConfigureWindow -ConfigureWindow - +
+
+ ConfigureWindow + ConfigureWindow @@ -3391,10 +3387,10 @@ the other arguments to the request), not to its initial geometry. Attempts to configure a root window have no effect. - -CirculateWindow -CirculateWindow - +
+
+ CirculateWindow + CirculateWindow @@ -3451,10 +3447,10 @@ the bottom of the stack. Exposure processing is performed on formerly obscured windows. - -GetGeometry -GetGeometry - +
+
+ GetGeometry + GetGeometry @@ -3521,10 +3517,10 @@ It is legal to pass an window as a drawable to this request. - -QueryTree -QueryTree - +
+
+ QueryTree + QueryTree @@ -3577,10 +3573,10 @@ This request returns the root, the parent, and the children of the window. The children are listed in bottom-to-top stacking order. - -InternAtom -InternAtom - +
+
+ InternAtom + InternAtom @@ -3637,10 +3633,10 @@ The lifetime of an atom is not tied to the interning client. Atoms remain defined until server reset (see section 10). - -GetAtomName -GetAtomName - +
+
+ GetAtomName + GetAtomName @@ -3681,10 +3677,10 @@ Errors: This request returns the name for the given atom. - -ChangeProperty -ChangeProperty - +
+
+ ChangeProperty + ChangeProperty @@ -3777,10 +3773,10 @@ or until server reset (see section 10). The maximum size of a property is server-dependent and may vary dynamically. - -DeleteProperty -DeleteProperty - +
+
+ DeleteProperty + DeleteProperty @@ -3818,10 +3814,10 @@ if the property exists and generates a event on the window unless the property does not exist. - -GetProperty -GetProperty - +
+
+ GetProperty + GetProperty @@ -3944,10 +3940,10 @@ and a event is generated on the window. - -RotateProperties -RotateProperties - +
+
+ RotateProperties + RotateProperties @@ -4011,10 +4007,10 @@ or error is generated, no properties are changed. - -ListProperties -ListProperties - +
+
+ ListProperties + ListProperties @@ -4055,10 +4051,10 @@ Errors: This request returns the atoms of properties currently defined on the window. - -SetSelectionOwner -SetSelectionOwner - +
+
+ SetSelectionOwner + SetSelectionOwner @@ -4143,10 +4139,10 @@ events. Selections are global to the server. - -GetSelectionOwner -GetSelectionOwner - +
+
+ GetSelectionOwner + GetSelectionOwner @@ -4192,10 +4188,10 @@ If is returned, then there is no owner for the selection. - -ConvertSelection -ConvertSelection - +
+
+ ConvertSelection + ConvertSelection @@ -4251,10 +4247,10 @@ event to the requestor with property The arguments are passed on unchanged in either of the events. - -SendEvent -SendEvent - +
+
+ SendEvent + SendEvent @@ -4351,10 +4347,10 @@ and to set the sequence number in the event correctly. Active grabs are ignored for this request. - -GrabPointer -GrabPointer - +
+
+ GrabPointer + GrabPointer @@ -4529,10 +4525,10 @@ Otherwise, the last-pointer-grab time is set to the specified time, with replaced by the current server time. - -UngrabPointer -UngrabPointer - +
+
+ UngrabPointer + UngrabPointer @@ -4576,11 +4572,11 @@ or if window reconfiguration causes the confine-to window to lie completely outside the boundaries of the root window. - -GrabButton -GrabButton -Buttongrabbing - +
+
+ GrabButton + GrabButton + Buttongrabbing @@ -4713,10 +4709,10 @@ error is generated if there is a conflicting grab for any combination. The request has no effect on an active grab. - -UngrabButton -UngrabButton - +
+
+ UngrabButton + UngrabButton @@ -4767,10 +4763,10 @@ is equivalent to issuing the request for all possible buttons. The request has no effect on an active grab. - -ChangeActivePointerGrab -ChangeActivePointerGrab - +
+
+ ChangeActivePointerGrab + ChangeActivePointerGrab @@ -4819,10 +4815,10 @@ with GrabButton. - -GrabKeyboard -GrabKeyboard - +
+
+ GrabKeyboard + GrabKeyboard @@ -4960,10 +4956,10 @@ Otherwise, the last-keyboard-grab time is set to the specified time with replaced by the current server time. - -UngrabKeyboard -UngrabKeyboard - +
+
+ UngrabKeyboard + UngrabKeyboard @@ -5005,10 +5001,10 @@ is performed automatically if the event window for an active keyboard grab becomes not viewable. - -GrabKey -GrabKey - +
+
+ GrabKey + GrabKey @@ -5125,10 +5121,10 @@ and an error is generated if there is a conflicting grab for any combination. - -UngrabKey -UngrabKey - +
+
+ UngrabKey + UngrabKey @@ -5179,10 +5175,10 @@ is equivalent to issuing the request for all possible keycodes. This request has no effect on an active grab. - -AllowEvents -AllowEvents - +
+
+ AllowEvents + AllowEvents @@ -5388,29 +5384,29 @@ If a device is frozen twice by a single client, then a single releases both. - -GrabServer -GrabServer -Servergrabbing - +
+
+ GrabServer + GrabServer + Servergrabbing This request disables processing of requests and close-downs on all connections other than the one this request arrived on. - -UngrabServer -UngrabServer - +
+
+ UngrabServer + UngrabServer This request restarts processing of requests and close-downs on other connections. - -QueryPointer -QueryPointer - +
+
+ QueryPointer + QueryPointer @@ -5488,10 +5484,10 @@ Note that the logical state of a device (as seen by means of the protocol) may lag the physical state if device event processing is frozen. - -GetMotionEvents -GetMotionEvents - +
+
+ GetMotionEvents + GetMotionEvents @@ -5566,10 +5562,10 @@ If the stop time is in the future, it is equivalent to specifying CurrentTime. - -TranslateCoordinates -TranslateCoordinates - +
+
+ TranslateCoordinates + TranslateCoordinates @@ -5634,10 +5630,10 @@ If the coordinates are contained in a mapped child of dst-window, then that child is returned. - -WarpPointer -WarpPointer - +
+
+ WarpPointer + WarpPointer @@ -5715,10 +5711,10 @@ This request will generate events just as if the user had instantaneously moved the pointer. - -SetInputFocus -SetInputFocus - +
+
+ SetInputFocus + SetInputFocus @@ -5825,10 +5821,10 @@ events are generated, but the last-focus-change time is not affected. - -GetInputFocus -GetInputFocus - +
+
+ GetInputFocus + GetInputFocus @@ -5865,10 +5861,10 @@ revert-to: This request returns the current focus state. - -QueryKeymap -QueryKeymap - +
+
+ QueryKeymap + QueryKeymap @@ -5900,10 +5896,10 @@ Note that the logical state of a device (as seen by means of the protocol) may lag the physical state if device event processing is frozen. - -OpenFont -OpenFont - +
+
+ OpenFont + OpenFont @@ -5954,10 +5950,10 @@ Fonts are not associated with a particular screen and can be stored as a component of any graphics context. - -CloseFont -CloseFont - +
+
+ CloseFont + CloseFont @@ -5987,10 +5983,10 @@ This request deletes the association between the resource ID and the font. The font itself will be freed when no other resource references it. - -QueryFont -QueryFont - +
+
+ QueryFont + QueryFont @@ -6215,10 +6211,10 @@ The interpretation of the per-character attributes field is server-dependent. - -QueryTextExtents -QueryTextExtents - +
+
+ QueryTextExtents + QueryTextExtents @@ -6329,10 +6325,10 @@ If the font has no defined default-char, then undefined characters in the string are also ignored. - -ListFonts -ListFonts - +
+
+ ListFonts + ListFonts @@ -6382,10 +6378,10 @@ of characters. The returned names are in lowercase. - -ListFontsWithInfo -ListFontsWithInfo - +
+
+ ListFontsWithInfo + ListFontsWithInfo @@ -6461,10 +6457,10 @@ a reply with a zero-length name is sent to indicate the end of the reply sequence. - -SetFontPath -SetFontPath - +
+
+ SetFontPath + SetFontPath @@ -6509,10 +6505,10 @@ for which there currently are no explicit resource IDs allocated. The meaning of an error from this request is system specific. - -GetFontPath -GetFontPath - +
+
+ GetFontPath + GetFontPath @@ -6538,10 +6534,10 @@ path: LISTofSTRING8 This request returns the current search path for fonts. - -CreatePixmap -CreatePixmap - +
+
+ CreatePixmap + CreatePixmap @@ -6601,10 +6597,10 @@ It is legal to pass an window as a drawable to this request. - -FreePixmap -FreePixmap - +
+
+ FreePixmap + FreePixmap @@ -6634,10 +6630,10 @@ This request deletes the association between the resource ID and the pixmap. The pixmap storage will be freed when no other resource references it. - -CreateGC -CreateGC - +
+
+ CreateGC + CreateGC @@ -7666,10 +7662,10 @@ identical state as significantly more expensive than making minor changes to a single gcontext. - -ChangeGC -ChangeGC - +
+
+ ChangeGC + ChangeGC @@ -7730,10 +7726,10 @@ If an error is generated, a subset of the components may have been altered. - -CopyGC -CopyGC - +
+
+ CopyGC + CopyGC @@ -7775,10 +7771,10 @@ The two gcontexts must have the same root and the same depth (or a error results). - -SetDashes -SetDashes - +
+
+ SetDashes + SetDashes @@ -7874,10 +7870,10 @@ if and only if the point lies inside the clipping region and the point would be included in the dash when drawn unclipped. - -SetClipRectangles -SetClipRectangles - +
+
+ SetClipRectangles + SetClipRectangles @@ -7970,10 +7966,10 @@ all rectangles that include that scanline have identical Y origins and Y extents. - -FreeGC -FreeGC - +
+
+ FreeGC + FreeGC @@ -8003,10 +7999,10 @@ This request deletes the association between the resource ID and the gcontext and destroys the gcontext. - -ClearArea -ClearArea - +
+
+ ClearArea + ClearArea @@ -8077,10 +8073,10 @@ error to use an window in this request. - -CopyArea -CopyArea - +
+
+ CopyArea + CopyArea @@ -8173,10 +8169,10 @@ GC components: function, plane-mask, subwindow-mode, graphics-exposures, clip-x-origin, clip-y-origin, clip-mask - -CopyPlane -CopyPlane - +
+
+ CopyPlane + CopyPlane @@ -8255,10 +8251,10 @@ subwindow-mode, graphics-exposures, clip-x-origin, clip-y-origin, clip-mask - -PolyPoint -PolyPoint - +
+
+ PolyPoint + PolyPoint @@ -8318,10 +8314,10 @@ GC components: function, plane-mask, foreground, subwindow-mode, clip-x-origin, clip-y-origin, clip-mask - -PolyLine -PolyLine - +
+
+ PolyLine + PolyLine @@ -8407,10 +8403,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes - -PolySegment -PolySegment - +
+
+ PolySegment + PolySegment @@ -8481,10 +8477,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes - -PolyRectangle -PolyRectangle - +
+
+ PolyRectangle + PolyRectangle @@ -8552,10 +8548,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes - -PolyArc -PolyArc - +
+
+ PolyArc + PolyArc @@ -8716,10 +8712,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes - -FillPoly -FillPoly - +
+
+ FillPoly + FillPoly @@ -8827,10 +8823,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin - -PolyFillRectangle -PolyFillRectangle - +
+
+ PolyFillRectangle + PolyFillRectangle @@ -8895,10 +8891,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin - -PolyFillArc -PolyFillArc - +
+
+ PolyFillArc + PolyFillArc @@ -8987,10 +8983,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin - -PutImage -PutImage - +
+
+ PutImage + PutImage @@ -9113,10 +9109,10 @@ clip-y-origin, clip-mask GC mode-dependent components: foreground, background - -GetImage -GetImage - +
+
+ GetImage + GetImage @@ -9242,10 +9238,10 @@ graphics-related requests. It is intended specifically for rudimentary hardcopy support. - -PolyText8 -PolyText8 - +
+
+ PolyText8 + PolyText8 @@ -9345,10 +9341,10 @@ GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin - -PolyText16 -PolyText16 - +
+
+ PolyText16 + PolyText16 @@ -9422,10 +9418,10 @@ has been transmitted most significant byte first (that is, byte1 of the CHAR2B is taken as the most significant byte). - -ImageText8 -ImageText8 - +
+
+ ImageText8 + ImageText8 @@ -9512,10 +9508,10 @@ GC components: plane-mask, foreground, background, font, subwindow-mode, clip-x-origin, clip-y-origin, clip-mask - -ImageText16 -ImageText16 - +
+
+ ImageText16 + ImageText16 @@ -9567,10 +9563,10 @@ has been transmitted most significant byte first (that is, byte1 of the CHAR2B is taken as the most significant byte). - -CreateColormap -CreateColormap - +
+
+ CreateColormap + CreateColormap @@ -9675,10 +9671,10 @@ in all cases, none of these entries can be freed with FreeColors. - -FreeColormap -FreeColormap - +
+
+ FreeColormap + FreeColormap @@ -9726,10 +9722,10 @@ The protocol does not define the colors displayed for a window with a colormap o This request has no effect on a default colormap for a screen. - -CopyColormapAndFree -CopyColormapAndFree - +
+
+ CopyColormapAndFree + CopyColormapAndFree @@ -9786,10 +9782,10 @@ or and that have not been freed since they were allocated. - -InstallColormap -InstallColormap - +
+
+ InstallColormap + InstallColormap @@ -9856,10 +9852,10 @@ Initially the default colormap for a screen is installed (but is not in the required list). - -UninstallColormap -UninstallColormap - +
+
+ UninstallColormap + UninstallColormap @@ -9906,10 +9902,10 @@ the request, a event is generated on every window having that colormap as an attribute. - -ListInstalledColormaps -ListInstalledColormaps - +
+
+ ListInstalledColormaps + ListInstalledColormaps @@ -9955,10 +9951,10 @@ and there is no explicit indication of the required list (see request). - -AllocColor -AllocColor - +
+
+ AllocColor + AllocColor @@ -10014,10 +10010,10 @@ Multiple clients requesting the same effective RGB values can be assigned the same read-only entry, allowing entries to be shared. - -AllocNamedColor -AllocNamedColor - +
+
+ AllocNamedColor + AllocNamedColor @@ -10083,10 +10079,10 @@ The exact RGB values specify the true values for the color, and the visual values specify the values actually used in the colormap. - -AllocColorCells -AllocColorCells - +
+
+ AllocColorCells + AllocColorCells @@ -10166,10 +10162,10 @@ and three contiguous sets of bits (one within each pixel subfield) for The RGB values of the allocated entries are undefined. - -AllocColorPlanes -AllocColorPlanes - +
+
+ AllocColorPlanes + AllocColorPlanes @@ -10257,10 +10253,10 @@ the pixel is decomposed according to the masks and the corresponding independent entries are updated. - -FreeColors -FreeColors - +
+
+ FreeColors + FreeColors @@ -10338,10 +10334,10 @@ If more than one pixel is in error, it is arbitrary as to which pixel is reported. - -StoreColors -StoreColors - +
+
+ StoreColors + StoreColors @@ -10424,10 +10420,10 @@ If more than one pixel is in error, it is arbitrary as to which pixel is reported. - -StoreNamedColor -StoreNamedColor - +
+
+ StoreNamedColor + StoreNamedColor @@ -10485,10 +10481,10 @@ errors are the same as in StoreColors. - -QueryColors -QueryColors - +
+
+ QueryColors + QueryColors @@ -10556,10 +10552,10 @@ If more than one pixel is in error, it is arbitrary as to which pixel is reported. - -LookupColor -LookupColor - +
+
+ LookupColor + LookupColor @@ -10616,10 +10612,10 @@ The name should use the ISO Latin-1 encoding, and uppercase and lowercase do not matter. - -CreateCursor -CreateCursor - +
+
+ CreateCursor + CreateCursor @@ -10715,10 +10711,10 @@ on the cursor. The server might or might not make a copy of the pixmap. - -CreateGlyphCursor -CreateGlyphCursor - +
+
+ CreateGlyphCursor + CreateGlyphCursor @@ -10803,10 +10799,10 @@ The fonts can be freed immediately if no further explicit references to them are to be made. - -FreeCursor -FreeCursor - +
+
+ FreeCursor + FreeCursor @@ -10836,10 +10832,10 @@ This request deletes the association between the resource ID and the cursor. The cursor storage will be freed when no other resource references it. - -RecolorCursor -RecolorCursor - +
+
+ RecolorCursor + RecolorCursor @@ -10880,10 +10876,10 @@ If the cursor is being displayed on a screen, the change is visible immediately. - -QueryBestSize -QueryBestSize - +
+
+ QueryBestSize + QueryBestSize @@ -10967,10 +10963,10 @@ or error results). - -QueryExtension -QueryExtension - +
+
+ QueryExtension + QueryExtension @@ -11034,10 +11030,10 @@ The extension name should use the ISO Latin-1 encoding, and uppercase and lowercase matter. - -ListExtensions -ListExtensions - +
+
+ ListExtensions + ListExtensions @@ -11062,10 +11058,10 @@ names: LISTofSTRING8 This request returns a list of all extensions supported by the server. - -SetModifierMapping -SetModifierMapping - +
+
+ SetModifierMapping + SetModifierMapping @@ -11169,10 +11165,10 @@ event on a status. - -GetModifierMapping -GetModifierMapping - +
+
+ GetModifierMapping + GetModifierMapping @@ -11222,10 +11218,10 @@ the use of the corresponding modifier has been disabled. The order of keycodes within each set is chosen arbitrarily by the server. - -ChangeKeyboardMapping -ChangeKeyboardMapping - +
+
+ ChangeKeyboardMapping + ChangeKeyboardMapping @@ -11310,10 +11306,10 @@ it is merely stored for reading and writing by clients (see section 5). - -GetKeyboardMapping -GetKeyboardMapping - +
+
+ GetKeyboardMapping + GetKeyboardMapping @@ -11397,10 +11393,10 @@ A special KEYSYM value of is used to fill in unused elements for individual keycodes. - -ChangeKeyboardControl -ChangeKeyboardControl - +
+
+ ChangeKeyboardControl + ChangeKeyboardControl @@ -11568,10 +11564,10 @@ If an error is generated, a subset of the controls may have been altered. - -GetKeyboardControl -GetKeyboardControl - +
+
+ GetKeyboardControl + GetKeyboardControl @@ -11637,10 +11633,10 @@ Byte N (from 0) contains the bits for keys 8N to 8N + 7, with the least significant bit in the byte representing key 8N. - -Bell -Bell - +
+
+ Bell + Bell @@ -11683,10 +11679,10 @@ base + [(base * percent) / 100] - -SetPointerMapping -SetPointerMapping - +
+
+ SetPointerMapping + SetPointerMapping @@ -11757,10 +11753,10 @@ event on a status. - -GetPointerMapping -GetPointerMapping - +
+
+ GetPointerMapping + GetPointerMapping @@ -11791,10 +11787,10 @@ The length of the list indicates the number of physical buttons. The nominal mapping for a pointer is the identity mapping: map[i]=i. - -ChangePointerControl -ChangePointerControl - +
+
+ ChangePointerControl + ChangePointerControl @@ -11843,10 +11839,10 @@ Other negative values generate a error, as does a zero value for acceleration-denominator. - -GetPointerControl -GetPointerControl - +
+
+ GetPointerControl + GetPointerControl @@ -11877,10 +11873,10 @@ threshold: CARD16 This request returns the current acceleration and threshold for the pointer. - -SetScreenSaver -SetScreenSaver - +
+
+ SetScreenSaver + SetScreenSaver @@ -11959,10 +11955,10 @@ tiling the screen with the root window background tile, randomly reorigined periodically. - -GetScreenSaver -GetScreenSaver - +
+
+ GetScreenSaver + GetScreenSaver @@ -12002,10 +11998,10 @@ allow-exposures: This request returns the current screen-saver control values. - -ForceScreenSaver -ForceScreenSaver - +
+
+ ForceScreenSaver + ForceScreenSaver @@ -12046,10 +12042,10 @@ and the activation timer is reset to its initial state as if device input had just been received. - -ChangeHosts -ChangeHosts - +
+
+ ChangeHosts + ChangeHosts @@ -12163,10 +12159,10 @@ secure forms of authentication, such as those based on shared secrets or public key encryption, are recommended. - -ListHosts -ListHosts - +
+
+ ListHosts + ListHosts @@ -12204,10 +12200,10 @@ enabled or disabled. Each HOST is padded to a multiple of four bytes. - -SetAccessControl -SetAccessControl - +
+
+ SetAccessControl + SetAccessControl @@ -12247,10 +12243,10 @@ to execute this request (or an error results). - -SetCloseDownMode -SetCloseDownMode - +
+
+ SetCloseDownMode + SetCloseDownMode @@ -12288,10 +12284,10 @@ The meaning of the close-down mode is described in section 10. - -KillClient -KillClient - +
+
+ KillClient + KillClient @@ -12335,10 +12331,10 @@ then the resources of all clients that have terminated in are destroyed. - -NoOperation -NoOperation - +
+
+ NoOperation + NoOperation This request has no arguments and no results, but the request length field @@ -12350,6 +12346,7 @@ This request can be used in its minimum four byte form as padding where necessary by client libraries that find it convenient to force requests to begin on 64-bit boundaries. +