From fa2daaceb0fe5324589b9fca9d156b41697d3a52 Mon Sep 17 00:00:00 2001 From: Alan Coopersmith Date: Sat, 4 Dec 2010 16:06:37 -0800 Subject: spec: Make request names in text hyperlinks to request definition sections Same basic process as previous commit for event names Signed-off-by: Alan Coopersmith --- specs/encoding.xml | 240 +++++++++++++++++++++++----------------------- specs/sect1-9.xml | 272 ++++++++++++++++++++++++++--------------------------- 2 files changed, 256 insertions(+), 256 deletions(-) (limited to 'specs') diff --git a/specs/encoding.xml b/specs/encoding.xml index 8161dc7..970b3a8 100644 --- a/specs/encoding.xml +++ b/specs/encoding.xml @@ -936,7 +936,7 @@ VISUALTYPE Requests -CreateWindow +CreateWindow 1 1 opcode 1 CARD8 depth 2 8+n request length @@ -996,7 +996,7 @@ VISUALTYPE 4 CURSOR cursor 0 None -ChangeWindowAttributes +ChangeWindowAttributes 1 2 opcode 1 unused 2 3+n request length @@ -1006,7 +1006,7 @@ VISUALTYPE 4n LISTofVALUE value-list encodings are the same as for CreateWindow -GetWindowAttributes +GetWindowAttributes 1 3 opcode 1 unused 2 2 request length @@ -1042,19 +1042,19 @@ VISUALTYPE 2 SETofDEVICEEVENT do-not-propagate-mask 2 unused -DestroyWindow +DestroyWindow 1 4 opcode 1 unused 2 2 request length 4 WINDOW window -DestroySubwindows +DestroySubwindows 1 5 opcode 1 unused 2 2 request length 4 WINDOW window -ChangeSaveSet +ChangeSaveSet 1 6 opcode 1 mode 0 Insert @@ -1062,7 +1062,7 @@ VISUALTYPE 2 2 request length 4 WINDOW window -ReparentWindow +ReparentWindow 1 7 opcode 1 unused 2 4 request length @@ -1071,31 +1071,31 @@ VISUALTYPE 2 INT16 x 2 INT16 y -MapWindow +MapWindow 1 8 opcode 1 unused 2 2 request length 4 WINDOW window -MapSubwindows +MapSubwindows 1 9 opcode 1 unused 2 2 request length 4 WINDOW window -UnmapWindow +UnmapWindow 1 10 opcode 1 unused 2 2 request length 4 WINDOW window -UnmapSubwindows +UnmapSubwindows 1 11 opcode 1 unused 2 2 request length 4 WINDOW window -ConfigureWindow +ConfigureWindow 1 12 opcode 1 unused 2 3+n request length @@ -1125,7 +1125,7 @@ VISUALTYPE 3 BottomIf 4 Opposite -CirculateWindow +CirculateWindow 1 13 opcode 1 direction 0 RaiseLowest @@ -1133,7 +1133,7 @@ VISUALTYPE 2 2 request length 4 WINDOW window -GetGeometry +GetGeometry 1 14 opcode 1 unused 2 2 request length @@ -1152,7 +1152,7 @@ VISUALTYPE 2 CARD16 border-width 10 unused -QueryTree +QueryTree 1 15 opcode 1 unused 2 2 request length @@ -1170,7 +1170,7 @@ VISUALTYPE 14 unused 4n LISTofWINDOW children -InternAtom +InternAtom 1 16 opcode 1 BOOL only-if-exists 2 2+(n+p)/4 request length @@ -1188,7 +1188,7 @@ VISUALTYPE 0 None 20 unused -GetAtomName +GetAtomName 1 17 opcode 1 unused 2 2 request length @@ -1204,7 +1204,7 @@ VISUALTYPE n STRING8 name p unused, p=pad(n) -ChangeProperty +ChangeProperty 1 18 opcode 1 mode 0 Replace @@ -1226,14 +1226,14 @@ VISUALTYPE p unused, p=pad(n) -DeleteProperty +DeleteProperty 1 19 opcode 1 unused 2 3 request length 4 WINDOW window 4 ATOM property -GetProperty +GetProperty 1 20 opcode 1 BOOL delete 2 6 request length @@ -1264,7 +1264,7 @@ VISUALTYPE (n is a multiple of 4 for format = 32) p unused, p=pad(n) -ListProperties +ListProperties 1 21 opcode 1 unused 2 2 request length @@ -1279,7 +1279,7 @@ VISUALTYPE 22 unused 4n LISTofATOM atoms -SetSelectionOwner +SetSelectionOwner 1 22 opcode 1 unused 2 4 request length @@ -1289,7 +1289,7 @@ VISUALTYPE 4 TIMESTAMP time 0 CurrentTime -GetSelectionOwner +GetSelectionOwner 1 23 opcode 1 unused 2 2 request length @@ -1304,7 +1304,7 @@ VISUALTYPE 0 None 20 unused -ConvertSelection +ConvertSelection 1 24 opcode 1 unused 2 6 request length @@ -1316,7 +1316,7 @@ VISUALTYPE 4 TIMESTAMP time 0 CurrentTime -SendEvent +SendEvent 1 25 opcode 1 BOOL propagate 2 11 requestlength @@ -1327,7 +1327,7 @@ VISUALTYPE 32 event standard event format (see the Events section) -GrabPointer +GrabPointer 1 26 opcode 1 BOOL owner-events 2 6 request length @@ -1358,14 +1358,14 @@ VISUALTYPE 4 0 reply length 24 unused -UngrabPointer +UngrabPointer 1 27 opcode 1 unused 2 2 request length 4 TIMESTAMP time 0 CurrentTime -GrabButton +GrabButton 1 28 opcode 1 BOOL owner-events 2 6 request length @@ -1387,7 +1387,7 @@ VISUALTYPE 2 SETofKEYMASK modifiers #x8000 AnyModifier -UngrabButton +UngrabButton 1 29 opcode 1 BUTTON button 0 AnyButton @@ -1397,7 +1397,7 @@ VISUALTYPE #x8000 AnyModifier 2 unused -ChangeActivePointerGrab +ChangeActivePointerGrab 1 30 opcode 1 unused 2 4 request length @@ -1408,7 +1408,7 @@ VISUALTYPE 2 SETofPOINTEREVENT event-mask 2 unused -GrabKeyboard +GrabKeyboard 1 31 opcode 1 BOOL owner-events 2 4 request length @@ -1435,14 +1435,14 @@ VISUALTYPE 4 0 reply length 24 unused -UngrabKeyboard +UngrabKeyboard 1 32 opcode 1 unused 2 2 request length 4 TIMESTAMP time 0 CurrentTime -GrabKey +GrabKey 1 33 opcode 1 BOOL owner-events 2 4 request length @@ -1459,7 +1459,7 @@ VISUALTYPE 1 Asynchronous 3 unused -UngrabKey +UngrabKey 1 34 opcode 1 KEYCODE key 0 AnyKey @@ -1469,7 +1469,7 @@ VISUALTYPE #x8000 AnyModifier 2 unused -AllowEvents +AllowEvents 1 35 opcode 1 mode 0 AsyncPointer @@ -1484,17 +1484,17 @@ VISUALTYPE 4 TIMESTAMP time 0 CurrentTime -GrabServer +GrabServer 1 36 opcode 1 unused 2 1 request length -UngrabServer +UngrabServer 1 37 opcode 1 unused 2 1 request length -QueryPointer +QueryPointer 1 38 opcode 1 unused 2 2 request length @@ -1515,7 +1515,7 @@ VISUALTYPE 2 SETofKEYBUTMASK mask 6 unused -GetMotionEvents +GetMotionEvents 1 39 opcode 1 unused 2 4 request length @@ -1539,7 +1539,7 @@ VISUALTYPE 2 INT16 x 2 INT16 y -TranslateCoordinates +TranslateCoordinates 1 40 opcode 1 unused 2 4 request length @@ -1558,7 +1558,7 @@ VISUALTYPE 2 INT16 dst-y 16 unused -WarpPointer +WarpPointer 1 41 opcode 1 unused 2 6 request length @@ -1573,7 +1573,7 @@ VISUALTYPE 2 INT16 dst-x 2 INT16 dst-y -SetInputFocus +SetInputFocus 1 42 opcode 1 revert-to 0 None @@ -1586,7 +1586,7 @@ VISUALTYPE 4 TIMESTAMP time 0 CurrentTime -GetInputFocus +GetInputFocus 1 43 opcode 1 unused 2 1 request length @@ -1604,7 +1604,7 @@ VISUALTYPE 1 PointerRoot 20 unused -QueryKeymap +QueryKeymap 1 44 opcode 1 unused 2 1 request length @@ -1616,7 +1616,7 @@ VISUALTYPE 4 2 reply length 32 LISTofCARD8 keys -OpenFont +OpenFont 1 45 opcode 1 unused 2 3+(n+p)/4 request length @@ -1626,13 +1626,13 @@ VISUALTYPE n STRING8 name p unused, p=pad(n) -CloseFont +CloseFont 1 46 opcode 1 unused 2 2 request length 4 FONT font -QueryFont +QueryFont 1 47 opcode 1 unused 2 2 request length @@ -1675,7 +1675,7 @@ VISUALTYPE 2 INT16 descent 2 CARD16 attributes -QueryTextExtents +QueryTextExtents 1 48 opcode 1 BOOL odd length, True if p = 2 2 2+(2n+p)/4 request length @@ -1699,7 +1699,7 @@ VISUALTYPE 4 INT32 overall-right 4 unused -ListFonts +ListFonts 1 49 opcode 1 unused 2 2+(n+p)/4 request length @@ -1718,7 +1718,7 @@ VISUALTYPE n LISTofSTR names p unused, p=pad(n) -ListFontsWithInfo +ListFontsWithInfo 1 50 opcode 1 unused 2 2+(n+p)/4 request length @@ -1766,7 +1766,7 @@ VISUALTYPE 4 7 reply length 52 unused -SetFontPath +SetFontPath 1 51 opcode 1 unused 2 2+(n+p)/4 request length @@ -1775,7 +1775,7 @@ VISUALTYPE n LISTofSTR path p unused, p=pad(n) -GetFontPath +GetFontPath 1 52 opcode 1 unused 2 1 request list @@ -1790,7 +1790,7 @@ VISUALTYPE n LISTofSTR path p unused, p=pad(n) -CreatePixmap +CreatePixmap 1 53 opcode 1 CARD8 depth 2 4 request length @@ -1799,13 +1799,13 @@ VISUALTYPE 2 CARD16 width 2 CARD16 height -FreePixmap +FreePixmap 1 54 opcode 1 unused 2 2 request length 4 PIXMAP pixmap -CreateGC +CreateGC 1 55 opcode 1 unused 2 4+n request length @@ -1899,7 +1899,7 @@ VISUALTYPE 0 Chord 1 PieSlice -ChangeGC +ChangeGC 1 56 opcode 1 unused 2 3+n request length @@ -1909,7 +1909,7 @@ VISUALTYPE 4n LISTofVALUE value-list encodings are the same as for CreateGC -CopyGC +CopyGC 1 57 opcode 1 unused 2 4 request length @@ -1918,7 +1918,7 @@ VISUALTYPE 4 BITMASK value-mask encodings are the same as for CreateGC -SetDashes +SetDashes 1 58 opcode 1 unused 2 3+(n+p)/4 request length @@ -1928,7 +1928,7 @@ VISUALTYPE n LISTofCARD8 dashes p unused, p=pad(n) -SetClipRectangles +SetClipRectangles 1 59 opcode 1 ordering 0 UnSorted @@ -1941,13 +1941,13 @@ VISUALTYPE 2 INT16 clip-y-origin 8n LISTofRECTANGLE rectangles -FreeGC +FreeGC 1 60 opcode 1 unused 2 2 request length 4 GCONTEXT gc -ClearArea +ClearArea 1 61 opcode 1 BOOL exposures 2 4 request length @@ -1957,7 +1957,7 @@ VISUALTYPE 2 CARD16 width 2 CARD16 height -CopyArea +CopyArea 1 62 opcode 1 unused 2 7 request length @@ -1971,7 +1971,7 @@ VISUALTYPE 2 CARD16 width 2 CARD16 height -CopyPlane +CopyPlane 1 63 opcode 1 unused 2 8 request length @@ -1986,7 +1986,7 @@ VISUALTYPE 2 CARD16 height 4 CARD32 bit-plane -PolyPoint +PolyPoint 1 64 opcode 1 coordinate-mode 0 Origin @@ -1996,7 +1996,7 @@ VISUALTYPE 4 GCONTEXT gc 4n LISTofPOINT points -PolyLine +PolyLine 1 65 opcode 1 coordinate-mode 0 Origin @@ -2006,7 +2006,7 @@ VISUALTYPE 4 GCONTEXT gc 4n LISTofPOINT points -PolySegment +PolySegment 1 66 opcode 1 unused 2 3+2n request length @@ -2020,7 +2020,7 @@ VISUALTYPE 2 INT16 x2 2 INT16 y2 -PolyRectangle +PolyRectangle 1 67 opcode 1 unused 2 3+2n request length @@ -2028,7 +2028,7 @@ VISUALTYPE 4 GCONTEXT gc 8n LISTofRECTANGLE rectangles -PolyArc +PolyArc 1 68 opcode 1 unused 2 3+3n request length @@ -2036,7 +2036,7 @@ VISUALTYPE 4 GCONTEXT gc 12n LISTofARC arcs -FillPoly +FillPoly 1 69 opcode 1 unused 2 4+n request length @@ -2052,7 +2052,7 @@ VISUALTYPE 2 unused 4n LISTofPOINT points -PolyFillRectangle +PolyFillRectangle 1 70 opcode 1 unused 2 3+2n request length @@ -2060,7 +2060,7 @@ VISUALTYPE 4 GCONTEXT gc 8n LISTofRECTANGLE rectangles -PolyFillArc +PolyFillArc 1 71 opcode 1 unused 2 3+3n request length @@ -2068,7 +2068,7 @@ VISUALTYPE 4 GCONTEXT gc 12n LISTofARC arcs -PutImage +PutImage 1 72 opcode 1 format 0 Bitmap @@ -2087,7 +2087,7 @@ VISUALTYPE n LISTofBYTE data p unused, p=pad(n) -GetImage +GetImage 1 73 opcode 1 format 1 XYPixmap @@ -2111,7 +2111,7 @@ VISUALTYPE n LISTofBYTE data p unused, p=pad(n) -PolyText8 +PolyText8 1 74 opcode 1 unused 2 4+(n+p)/4 request length @@ -2134,7 +2134,7 @@ VISUALTYPE 1 font byte 1 1 font byte 0 (least-significant) -PolyText16 +PolyText16 1 75 opcode 1 unused 2 4+(n+p)/4 request length @@ -2158,7 +2158,7 @@ VISUALTYPE 1 font byte 1 1 font byte 0 (least-significant) -ImageText8 +ImageText8 1 76 opcode 1 n length of string 2 4+(n+p)/4 request length @@ -2169,7 +2169,7 @@ VISUALTYPE n STRING8 string p unused, p=pad(n) -ImageText16 +ImageText16 1 77 opcode 1 n number of CHAR2Bs in string 2 4+(2n+p)/4 request length @@ -2180,7 +2180,7 @@ VISUALTYPE 2n STRING16 string p unused, p=pad(2n) -CreateColormap +CreateColormap 1 78 opcode 1 alloc 0 None @@ -2190,32 +2190,32 @@ VISUALTYPE 4 WINDOW window 4 VISUALID visual -FreeColormap +FreeColormap 1 79 opcode 1 unused 2 2 request length 4 COLORMAP cmap -CopyColormapAndFree +CopyColormapAndFree 1 80 opcode 1 unused 2 3 request length 4 COLORMAP mid 4 COLORMAP src-cmap -InstallColormap +InstallColormap 1 81 opcode 1 unused 2 2 request length 4 COLORMAP cmap -UninstallColormap +UninstallColormap 1 82 opcode 1 unused 2 2 request length 4 COLORMAP cmap -ListInstalledColormaps +ListInstalledColormaps 1 83 opcode 1 unused 2 2 request length @@ -2230,7 +2230,7 @@ VISUALTYPE 22 unused 4n LISTofCOLORMAP cmaps -AllocColor +AllocColor 1 84 opcode 1 unused 2 4 request length @@ -2252,7 +2252,7 @@ VISUALTYPE 4 CARD32 pixel 12 unused -AllocNamedColor +AllocNamedColor 1 85 opcode 1 unused 2 3+(n+p)/4 request length @@ -2276,7 +2276,7 @@ VISUALTYPE 2 CARD16 visual-blue 8 unused -AllocColorCells +AllocColorCells 1 86 opcode 1 BOOL contiguous 2 3 request length @@ -2295,7 +2295,7 @@ VISUALTYPE 4n LISTofCARD32 pixels 4m LISTofCARD32 masks -AllocColorPlanes +AllocColorPlanes 1 87 opcode 1 BOOL contiguous 2 4 request length @@ -2318,7 +2318,7 @@ VISUALTYPE 8 unused 4n LISTofCARD32 pixels -FreeColors +FreeColors 1 88 opcode 1 unused 2 3+n request length @@ -2326,7 +2326,7 @@ VISUALTYPE 4 CARD32 plane-mask 4n LISTofCARD32 pixels -StoreColors +StoreColors 1 89 opcode 1 unused 2 2+3n request length @@ -2345,7 +2345,7 @@ VISUALTYPE #xF8 unused 1 unused -StoreNamedColor +StoreNamedColor 1 90 opcode 1 do-red, do-green, do-blue #x01 do-red (1 is True, 0 is False) @@ -2360,7 +2360,7 @@ VISUALTYPE n STRING8 name p unused, p=pad(n) -QueryColors +QueryColors 1 91 opcode 1 unused 2 2+n request length @@ -2382,7 +2382,7 @@ VISUALTYPE 2 CARD16 blue 2 unused -LookupColor +LookupColor 1 92 opcode 1 unused 2 3+(n+p)/4 request length @@ -2405,7 +2405,7 @@ VISUALTYPE 2 CARD16 visual-blue 12 unused -CreateCursor +CreateCursor 1 93 opcode 1 unused 2 8 request length @@ -2422,7 +2422,7 @@ VISUALTYPE 2 CARD16 x 2 CARD16 y -CreateGlyphCursor +CreateGlyphCursor 1 94 opcode 1 unused 2 8 request length @@ -2439,13 +2439,13 @@ VISUALTYPE 2 CARD16 back-green 2 CARD16 back-blue -FreeCursor +FreeCursor 1 95 opcode 1 unused 2 2 request length 4 CURSOR cursor -RecolorCursor +RecolorCursor 1 96 opcode 1 unused 2 5 request length @@ -2457,7 +2457,7 @@ VISUALTYPE 2 CARD16 back-green 2 CARD16 back-blue -QueryBestSize +QueryBestSize 1 97 opcode 1 class 0 Cursor @@ -2477,7 +2477,7 @@ VISUALTYPE 2 CARD16 height 20 unused -QueryExtension +QueryExtension 1 98 opcode 1 unused 2 2+(n+p)/4 request length @@ -2497,7 +2497,7 @@ VISUALTYPE 1 CARD8 first-error 20 unused -ListExtensions +ListExtensions 1 99 opcode 1 unused 2 1 request length @@ -2511,7 +2511,7 @@ VISUALTYPE n LISTofSTR names p unused, p=pad(n) -ChangeKeyboardMapping +ChangeKeyboardMapping 1 100 opcode 1 n keycode-count 2 2+nm request length @@ -2520,7 +2520,7 @@ VISUALTYPE 2 unused 4nm LISTofKEYSYM keysyms -GetKeyboardMapping +GetKeyboardMapping 1 101 opcode 1 unused 2 2 request length @@ -2537,7 +2537,7 @@ VISUALTYPE 24 unused 4nm LISTofKEYSYM keysyms -ChangeKeyboardControl +ChangeKeyboardControl 1 102 opcode 1 unused 2 2+n request length @@ -2567,7 +2567,7 @@ VISUALTYPE 1 On 2 Default -GetKeyboardControl +GetKeyboardControl 1 103 opcode 1 unused 2 1 request length @@ -2587,12 +2587,12 @@ VISUALTYPE 2 unused 32 LISTofCARD8 auto-repeats -Bell +Bell 1 104 opcode 1 INT8 percent 2 1 request length -ChangePointerControl +ChangePointerControl 1 105 opcode 1 unused 2 3 request length @@ -2602,7 +2602,7 @@ VISUALTYPE 1 BOOL do-acceleration 1 BOOL do-threshold -GetPointerControl +GetPointerControl 1 106 opcode 1 unused 2 1 request length @@ -2617,7 +2617,7 @@ VISUALTYPE 2 CARD16 threshold 18 unused -SetScreenSaver +SetScreenSaver 1 107 opcode 1 unused 2 3 request length @@ -2633,7 +2633,7 @@ VISUALTYPE 2 Default 2 unused -GetScreenSaver +GetScreenSaver 1 108 opcode 1 unused 2 1 request length @@ -2653,7 +2653,7 @@ VISUALTYPE 1 Yes 18 unused -ChangeHosts +ChangeHosts 1 109 opcode 1 mode 0 Insert @@ -2668,7 +2668,7 @@ VISUALTYPE n LISTofCARD8 address p unused, p=pad(n) -ListHosts +ListHosts 1 110 opcode 1 unused 2 1 request length @@ -2684,14 +2684,14 @@ VISUALTYPE 22 unused n LISTofHOST hosts (n always a multiple of 4) -SetAccessControl +SetAccessControl 1 111 opcode 1 mode 0 Disable 1 Enable 2 1 request length -SetCloseDownMode +SetCloseDownMode 1 112 opcode 1 mode 0 Destroy @@ -2699,14 +2699,14 @@ VISUALTYPE 2 RetainTemporary 2 1 request length -KillClient +KillClient 1 113 opcode 1 unused 2 2 request length 4 CARD32 resource 0 AllTemporary -RotateProperties +RotateProperties 1 114 opcode 1 unused 2 3+n request length @@ -2715,14 +2715,14 @@ VISUALTYPE 2 INT16 delta 4n LISTofATOM properties -ForceScreenSaver +ForceScreenSaver 1 115 opcode 1 mode 0 Reset 1 Activate 2 1 request length -SetPointerMapping +SetPointerMapping 1 116 opcode 1 n length of map 2 1+(n+p)/4 request length @@ -2738,7 +2738,7 @@ VISUALTYPE 4 0 reply length 24 unused -GetPointerMapping +GetPointerMapping 1 117 opcode 1 unused 2 1 request length @@ -2752,7 +2752,7 @@ VISUALTYPE n LISTofCARD8 map p unused, p=pad(n) -SetModifierMapping +SetModifierMapping 1 118 opcode 1 n keycodes-per-modifier 2 1+2n request length @@ -2768,7 +2768,7 @@ VISUALTYPE 4 0 reply length 24 unused -GetModifierMapping +GetModifierMapping 1 119 opcode 1 unused 2 1 request length @@ -2781,7 +2781,7 @@ VISUALTYPE 24 unused 8n LISTofKEYCODE keycodes -NoOperation +NoOperation 1 127 opcode 1 unused 2 1+n request length diff --git a/specs/sect1-9.xml b/specs/sect1-9.xml index 134f131..4ee67b6 100644 --- a/specs/sect1-9.xml +++ b/specs/sect1-9.xml @@ -166,7 +166,7 @@ Unused bytes within an error are not guaranteed to be zero. Unused bytes within an event are not guaranteed to be zero. Every event contains an 8-bit type code. The most significant bit in this code is set if the event was generated from a -SendEvent +SendEvent request. Event codes 64 through 127 are reserved for extensions, although the core protocol does not define a mechanism for selecting interest in such events. @@ -633,14 +633,14 @@ request). In general, when a request terminates with an error, the request has no side effects (that is, there is no partial execution). The only requests for which this is not true are -ChangeWindowAttributes -ChangeGC, -PolyText8, -PolyText16, -FreeColors, -StoreColors +ChangeWindowAttributes, +ChangeGC, +PolyText8, +PolyText16, +FreeColors, +StoreColors and -ChangeKeyboardControl. +ChangeKeyboardControl. @@ -1037,7 +1037,7 @@ Buttons are always numbered starting with one. Predefined atoms are not strictly necessary and may not be useful in all Atompredefined environments, but they will eliminate many -InternAtom +InternAtom requests in most applications. Note that they are predefined only in the sense of having numeric values, not in the sense of having required semantics. @@ -1545,7 +1545,7 @@ finer granularity than is reported by MotionNotify events. The -GetMotionEvents +GetMotionEvents request makes such history available. The motion-buffer-size gives the approximate maximum number of elements in the history buffer. @@ -1626,7 +1626,7 @@ unspecified two-color pattern using black-pixel and white-pixel. Min-installed-maps specifies the number of maps that can be guaranteed to be installed simultaneously (with -InstallColormap), +InstallColormap), regardless of the number of entries allocated in each map. Max-installed-maps specifies the maximum number of maps that might possibly be installed simultaneously, depending on their allocations. @@ -1642,14 +1642,14 @@ windows it can support at once. If save-unders is True, the server can support the save-under mode in -CreateWindow +CreateWindow and -ChangeWindowAttributes, +ChangeWindowAttributes, although again it may be storage limited. The current-input-events is what -GetWindowAttributes +GetWindowAttributes would return for the all-event-masks for the root window. @@ -2282,7 +2282,7 @@ The colormap specifies the colormap that best reflects the true colors of the window. Servers capable of supporting multiple hardware colormaps may use this information, and window managers may use it for -InstallColormap +InstallColormap requests. The colormap must have the same visual type and root as the window (or a Match @@ -2379,7 +2379,7 @@ Errors: The value-mask and value-list specify which attributes are to be changed. The values and restrictions are the same as for -CreateWindow. +CreateWindow. Setting a new background, whether by background-pixmap or @@ -2438,7 +2438,7 @@ changing the contents of the existing map) generates a event. Changing the colormap of a visible window might have no immediate effect on the screen (see -InstallColormap +InstallColormap request). @@ -2607,7 +2607,7 @@ Errors: If the argument window is mapped, an -UnmapWindow +UnmapWindow request is performed automatically. The window and all inferiors are then destroyed, and a DestroyNotify @@ -2659,7 +2659,7 @@ Errors: This request performs a -DestroyWindow +DestroyWindow request on all children of the window, in bottom-to-top stacking order. @@ -2751,7 +2751,7 @@ Errors: If the window is mapped, an -UnmapWindow +UnmapWindow request is performed automatically first. The window is then removed from its current position in the hierarchy and is inserted as a child of the specified parent. @@ -2768,7 +2768,7 @@ a value of True indicates that a window manager should not tamper with this window. Finally, if the window was originally mapped, a -MapWindow +MapWindow request is performed automatically. @@ -2881,7 +2881,7 @@ Errors: This request performs a -MapWindow +MapWindow request on all unmapped children of the window, in top-to-bottom stacking order. @@ -2952,7 +2952,7 @@ Errors: This request performs an -UnmapWindow +UnmapWindow request on all mapped children of the window, in bottom-to-top stacking order. @@ -4128,7 +4128,7 @@ but the last-change time is not affected. The selection atom is uninterpreted by the server. The owner window is returned by the -GetSelectionOwner +GetSelectionOwner request and is reported in SelectionRequest and @@ -4459,7 +4459,7 @@ If pointer-mode is the state of the pointer (as seen by means of the protocol) appears to freeze, and no further pointer events are generated by the server until the grabbing client issues a releasing -AllowEvents +AllowEvents request or until the pointer grab is released. Actual pointer changes are not lost while the pointer is frozen. They are simply queued for later processing. @@ -4549,9 +4549,9 @@ replaced by the current server time. This request releases the pointer if this client has it actively grabbed (from either -GrabPointer +GrabPointer or -GrabButton +GrabButton or from a normal button press) and releases any queued events. The request has no effect if the specified time is earlier than the last-pointer-grab time or is later than the current server time. @@ -4565,7 +4565,7 @@ events. An -UngrabPointer +UngrabPointer request is performed automatically if the event window or confine-to window for an active pointer grab becomes not viewable or if window reconfiguration causes the confine-to window to lie @@ -4650,7 +4650,7 @@ This request establishes a passive grab. Passive grabpointer In the future, the pointer is actively grabbed as described in -GrabPointer, +GrabPointer, the last-pointer-grab time is set to the time at which the button was pressed (as transmitted in the ButtonPress @@ -4671,7 +4671,7 @@ on any ancestor of grab-window. The interpretation of the remaining arguments is the same as for -GrabPointer. +GrabPointer. The active grab is terminated automatically when the logical state of the pointer has all buttons released, independent of the logical state of modifier keys. @@ -4809,10 +4809,10 @@ This request changes the specified dynamic parameters if the pointer is actively grabbed by the client and the specified time is no earlier than the last-pointer-grab time and no later than the current server time. The interpretation of event-mask and cursor are the same as in -GrabPointer. +GrabPointer. This request has no effect on the parameters of any passive grabs established with -GrabButton. +GrabButton. @@ -4911,7 +4911,7 @@ If keyboard-mode is the state of the keyboard (as seen by means of the protocol) appears to freeze. No further keyboard events are generated by the server until the grabbing client issues a releasing -AllowEvents +AllowEvents request or until the keyboard grab is released. Actual keyboard changes are not lost while the keyboard is frozen. They are simply queued for later processing. @@ -4925,7 +4925,7 @@ If pointer-mode is the state of the pointer (as seen by means of the protocol) appears to freeze. No further pointer events are generated by the server until the grabbing client issues a releasing -AllowEvents +AllowEvents request or until the keyboard grab is released. Actual pointer changes are not lost while the pointer is frozen. They are simply queued for later processing. @@ -4980,9 +4980,9 @@ replaced by the current server time. This request releases the keyboard if this client has it actively grabbed (as a result of either -GrabKeyboard +GrabKeyboard or -GrabKey) +GrabKey) and releases any queued events. The request has no effect if the specified time is earlier than the last-keyboard-grab time or is later than the current server time. @@ -4996,7 +4996,7 @@ events. An -UngrabKeyboard +UngrabKeyboard is performed automatically if the event window for an active keyboard grab becomes not viewable. @@ -5060,7 +5060,7 @@ This request establishes a passive grab on the keyboard. Passive grabkeyboard In the future, the keyboard is actively grabbed as described in -GrabKeyboard, +GrabKeyboard, the last-keyboard-grab time is set to the time at which the key was pressed (as transmitted in the KeyPress @@ -5081,7 +5081,7 @@ on any ancestor of grab-window. The interpretation of the remaining arguments is the same as for -GrabKeyboard. +GrabKeyboard. The active grab is terminated automatically when the logical state of the keyboard has the specified key released, independent of the logical state of modifier keys. @@ -5262,13 +5262,13 @@ For if the pointer is actively grabbed by the client and is frozen as the result of an event having been sent to the client (either from the activation of a -GrabButton +GrabButton or from a previous AllowEvents with mode SyncPointer but not from a -GrabPointer), +GrabPointer), then the pointer grab is released and that event is completely reprocessed, this time ignoring any passive grabs at or above (towards the root) the grab-window of the grab just released. @@ -5309,13 +5309,13 @@ For if the keyboard is actively grabbed by the client and is frozen as the result of an event having been sent to the client (either from the activation of a -GrabKey +GrabKey or from a previous AllowEvents with mode SyncKeyboard but not from a -GrabKeyboard), +GrabKeyboard), then the keyboard grab is released and that event is completely reprocessed, this time ignoring any passive grabs at or above (towards the root) the grab-window of the grab just released. @@ -6300,7 +6300,7 @@ If a gcontext is given for font, the currently contained font is used. The draw-direction, font-ascent, and font-descent are the same as described in -QueryFont. +QueryFont. The overall-ascent is the maximum of the ascent metrics of all characters in the string, and the overall-descent is the maximum of the descent metrics. The overall-width is the sum of the character-width metrics of all characters @@ -6431,7 +6431,7 @@ where: FONTINFO: <same type definition as in -QueryFont> +QueryFont> @@ -6441,10 +6441,10 @@ FONTINFO: <same type definition as in This request is similar to -ListFonts, +ListFonts, but it also returns information about each font. The information returned for each font is identical to what -QueryFont +QueryFont would return except that the per-character metrics are not returned. Note that this request can generate multiple replies. With each reply, @@ -7318,19 +7318,19 @@ although some sizes may be faster to use than others. The fill-style defines the contents of the source for line, text, and fill requests. For all text and fill requests (for example, -PolyText8, -PolyText16, -PolyFillRectangle, -FillPoly, +PolyText8, +PolyText16, +PolyFillRectangle, +FillPoly, and -PolyFillArc) +PolyFillArc) as well as for line requests with line-style Solid, (for example, -PolyLine, -PolySegment, -PolyRectangle, -PolyArc ) +PolyLine, +PolySegment, +PolyRectangle, +PolyArc ) and for the even dashes for line requests with line-style OnOffDash or @@ -7418,15 +7418,15 @@ For the odd dashes for line requests with line-style The dashes value allowed here is actually a simplified form of the more general patterns that can be set with -SetDashes. +SetDashes. Specifying a value of N here is equivalent to specifying the two element list [N, N] in -SetDashes. +SetDashes. The value must be nonzero (or a Value error results). The meaning of dash-offset and dashes are explained in the -SetDashes +SetDashes request. @@ -7446,7 +7446,7 @@ If clip-mask is None, then pixels are always drawn, regardless of the clip origin. The clip-mask can also be set with the -SetClipRectangles +SetClipRectangles request. @@ -7469,7 +7469,7 @@ but the semantics is undefined by the core protocol. The fill-rule defines what pixels are inside (that is, are drawn) for paths given in -FillPoly +FillPoly requests. EvenOdd means a point is inside if an infinite ray with the point as origin crosses @@ -7500,16 +7500,16 @@ and are inside if and only if the polygon interior is immediately below The arc-mode controls filling in the -PolyFillArc +PolyFillArc request. The graphics-exposures flag controls GraphicsExposure event generation for -CopyArea +CopyArea and -CopyPlane +CopyPlane requests (and any similar requests defined by extensions). @@ -7710,14 +7710,14 @@ This request changes components in gc. The value-mask and value-list specify which components are to be changed. The values and restrictions are the same as for -CreateGC. +CreateGC. Changing the clip-mask also overrides any previous -SetClipRectangles +SetClipRectangles request on the context. Changing dash-offset or dashes overrides any previous -SetDashes +SetDashes request on the context. @@ -7765,7 +7765,7 @@ Errors: This request copies components from src-gc to dst-gc. The value-mask specifies which components to copy, as for -CreateGC. +CreateGC. The two gcontexts must have the same root and the same depth (or a Match error results). @@ -7934,9 +7934,9 @@ which effectively disables output. This is the opposite of passing None as the clip-mask in -CreateGC +CreateGC and -ChangeGC. +ChangeGC. If known by the client, @@ -8238,7 +8238,7 @@ by the source region is formed using the foreground/background pixels in gc (foreground everywhere the bit-plane in src-drawable contains a bit set to 1, background everywhere the bit-plane contains a bit set to 0), and the equivalent of a -CopyArea +CopyArea is performed, with all the same exposure semantics. This can also be thought of as using the specified region of the source bit-plane as a stipple with a fill-style of @@ -8519,7 +8519,7 @@ Errors: This request draws the outlines of the specified rectangles, as if a five-point -PolyLine +PolyLine were specified for each rectangle: @@ -8865,7 +8865,7 @@ Errors: This request fills the specified rectangles, as if a four-point -FillPoly +FillPoly were specified for each rectangle: [x,y] [x+width,y] [x+width,y+height] [x,y+height] @@ -8954,7 +8954,7 @@ they are not truncated to discrete coordinates. The arc angles are interpreted as specified in the -PolyArc +PolyArc request. When the angle of an arc face is not an integral multiple of 90 degrees, then the precise endpoint on the arc is implementation dependent. However, for @@ -9410,7 +9410,7 @@ Errors: This request is similar to -PolyText8, +PolyText8, except 2-byte (or 16-bit) characters are used. For fonts defined with linear indexing rather than 2-byte matrix indexing, the server will interpret each CHAR2B as a 16-bit number that @@ -9488,7 +9488,7 @@ font-ascent + font-descent The overall-width, font-ascent, and font-descent are as they would be returned by a -QueryTextExtents +QueryTextExtents call using gc and string. @@ -9555,7 +9555,7 @@ Errors: This request is similar to -ImageText8, +ImageText8, except 2-byte (or 16-bit) characters are used. For fonts defined with linear indexing rather than 2-byte matrix indexing, the server will interpret each CHAR2B as a 16-bit number that @@ -9656,19 +9656,19 @@ For and PseudoColor, the effect is as if an -AllocColorCells +AllocColorCells request returned all pixel values from zero to N - 1, where N is the colormap-entries value in the specified visual. For DirectColor, the effect is as if an -AllocColorPlanes +AllocColorPlanes request returned a pixel value of zero and red-mask, green-mask, and blue-mask values containing the same bits as the corresponding masks in the specified visual. However, in all cases, none of these entries can be freed with -FreeColors. +FreeColors. @@ -9707,9 +9707,9 @@ it is uninstalled (see UninstallColormap request). If the colormap is defined as the colormap for a window (by means of -CreateWindow +CreateWindow or -ChangeWindowAttributes), +ChangeWindowAttributes), the colormap for the window is changed to None, and a @@ -9774,11 +9774,11 @@ If src-cmap was not created by the client with alloc All, then the allocations to be moved are all those pixels and planes that have been allocated by the client using either -AllocColor, -AllocNamedColor, -AllocColorCells, +AllocColor, +AllocNamedColor, +AllocColorCells, or -AllocColorPlanes +AllocColorPlanes and that have not been freed since they were allocated. @@ -9841,7 +9841,7 @@ When a colormap is an explicit argument to it is added to the head of the list; the list is truncated at the tail, if necessary, to keep the length of the list to at most M. When a colormap is an explicit argument to -UninstallColormap +UninstallColormap and it is in the required list, it is removed from the list. A colormap is not added to the required list when it is installed implicitly by the server, and the server cannot implicitly uninstall a colormap that is @@ -10071,7 +10071,7 @@ Errors: This request looks up the named color with respect to the screen associated with the colormap. Then, it does an -AllocColor +AllocColor on cmap. The name should use the ISO Latin-1 encoding, and uppercase and lowercase do not matter. @@ -10246,9 +10246,9 @@ and C*%2 sup B% independent blue entries. This is true even for PseudoColor. When the colormap entry for a pixel value is changed using -StoreColors +StoreColors or -StoreNamedColor, +StoreNamedColor, the pixel is decomposed according to the masks and the corresponding independent entries are updated. @@ -10300,14 +10300,14 @@ The set of all pixels is produced by ORing together subsets of plane-mask with the pixels. The request frees all of these pixels that were allocated by the client (using -AllocColor, -AllocNamedColor, -AllocColorCells, +AllocColor, +AllocNamedColor, +AllocColorCells, and -AllocColorPlanes). +AllocColorPlanes). Note that freeing an individual pixel obtained from -AllocColorPlanes +AllocColorPlanes may not actually allow it to be reused until all of its related pixels are also freed. Similarly, a read-only entry is not actually freed until it has been @@ -10329,7 +10329,7 @@ or if the colormap was created with all entries writable (using an alloc value of All in -CreateColormap). +CreateColormap). If more than one pixel is in error, it is arbitrary as to which pixel is reported. @@ -10469,7 +10469,7 @@ Errors: This request looks up the named color with respect to the screen associated with cmap and then does a -StoreColors +StoreColors in cmap. The name should use the ISO Latin-1 encoding, and uppercase and lowercase do not matter. @@ -10770,7 +10770,7 @@ Errors: This request is similar to -CreateCursor, +CreateCursor, except the source and mask bitmaps are obtained from the specified font glyphs. The source-char must be a defined glyph in source-font, and if mask-font is given, mask-char must be a defined glyph in mask-font @@ -11725,7 +11725,7 @@ Errors: This request sets the mapping of the pointer. Elements of the list are indexed starting from one. The length of the list must be the same as -GetPointerMapping +GetPointerMapping would return (or a Value error results). @@ -11940,7 +11940,7 @@ the screen is changed in a server-dependent fashion to avoid phosphor burn. Otherwise, the state of the screens does not change, and screen-saver is not activated. At the next keyboard or pointer input or at the next -ForceScreenSaver +ForceScreenSaver with mode Reset, screen-saver is deactivated, and all screen states are restored. @@ -12315,7 +12315,7 @@ Errors: If a valid resource is specified, -KillClient +KillClient forces a close-down of the client that created the resource. If the client has already terminated in either RetainPermanent @@ -12358,14 +12358,14 @@ to begin on 64-bit boundaries. At connection close, all event selections made by the client are discarded. If the client has the pointer actively grabbed, an -UngrabPointer +UngrabPointer is performed. If the client has the keyboard actively grabbed, an -UngrabKeyboard +UngrabKeyboard is performed. All passive grabs by the client are released. If the client has the server grabbed, an -UngrabServer +UngrabServer is performed. All selections (see SetSelectionOwner @@ -12392,7 +12392,7 @@ if the window is an inferior of a window created by the client, the save-set window is reparented to the closest ancestor such that the save-set window is not an inferior of a window created by the client. If the save-set window is unmapped, a -MapWindow +MapWindow request is performed on it (even if it was not an inferior of a window created by the client). The reparenting leaves unchanged the absolute coordinates @@ -12450,7 +12450,7 @@ If no matching passive grab on the button exists, then an active grab is started automatically for the client receiving the event, and the last-pointer-grab time is set to the current server time. The effect is essentially equivalent to a -GrabButton +GrabButton with arguments: @@ -12512,9 +12512,9 @@ selected on the event window, otherwise The grab is terminated automatically when the logical state of the pointer has all buttons released. -UngrabPointer +UngrabPointer and -ChangeActivePointerGrab +ChangeActivePointerGrab can both be used to modify the active grab. @@ -12709,9 +12709,9 @@ to the client for the event window until either the key or button state changes, the pointer leaves the event window, or the client issues a -QueryPointer +QueryPointer or -GetMotionEvents +GetMotionEvents request. @@ -13141,7 +13141,7 @@ and are reported to clients selecting FocusChange on the window. Events generated by -SetInputFocus +SetInputFocus when the keyboard is not grabbed have mode Normal. Events generated by @@ -13617,7 +13617,7 @@ above) as if the focus were to change from G to F. The value is a bit vector as described in -QueryKeymap. +QueryKeymap. This event is reported to clients selecting KeymapState on a window and is generated immediately after every @@ -13802,9 +13802,9 @@ The width and height specify the extent of the rectangle. The major and minor opcodes identify the graphics request used. For the core protocol, major-opcode is always -CopyArea +CopyArea or -CopyPlane, +CopyPlane, and minor-opcode is always zero. @@ -13856,9 +13856,9 @@ The drawable specifies the destination used for the graphics request. The major and minor opcodes identify the graphics request used. For the core protocol, major-opcode is always -CopyArea +CopyArea or -CopyPlane, +CopyPlane, and the minor-opcode is always zero. @@ -14001,7 +14001,7 @@ This event is reported to clients selecting on the parent and is generated when the window is created. The arguments are as in the -CreateWindow +CreateWindow request. @@ -14168,7 +14168,7 @@ The override-redirect flag is from the window's attribute. This event is reported to the client selecting SubstructureRedirect on the parent and is generated when a -MapWindow +MapWindow request is issued on an unmapped window with an override-redirect attribute of False. @@ -14276,7 +14276,7 @@ on the window and to clients selecting SubstructureNotify on the parent. It is generated when a -ConfigureWindow +ConfigureWindow request actually changes the state of the window. The event is the window on which the event was generated, and the window is the window that is changed. @@ -14368,7 +14368,7 @@ and specify the position of the upper-left outer corner of the window. This event is reported to the client selecting ResizeRedirect on the window and is generated when a -ConfigureWindow +ConfigureWindow request by some other client on the window attempts to change the size of the window. The width and height are the requested inside size, not including the border. @@ -14434,7 +14434,7 @@ The width and height are the requested inside size, not including the border. This event is reported to the client selecting SubstructureRedirect on the parent and is generated when a -ConfigureWindow +ConfigureWindow request is issued on the window by some other client. The value-mask indicates which components were specified in the request. The value-mask and the corresponding values are reported as given @@ -14487,7 +14487,7 @@ on the window and to clients selecting SubstructureNotify on the parent. It is generated when the window is actually restacked from a -CirculateWindow +CirculateWindow request. The event is the window on which the event was generated, and the window is the window that is restacked. @@ -14533,7 +14533,7 @@ Otherwise, it is below all siblings. This event is reported to the client selecting SubstructureRedirect on the parent and is generated when a -CirculateWindow +CirculateWindow request is issued on the parent and a window actually needs to be restacked. The window specifies the window to be restacked, and the place specifies what the new position in the stacking order should be. @@ -14587,9 +14587,9 @@ This event is reported to clients selecting on the window and is generated with state NewValue when a property of the window is changed using -ChangeProperty +ChangeProperty or -RotateProperties, +RotateProperties, even when adding zero-length data using ChangeProperty and when replacing all or part of a property with identical data using @@ -14600,9 +14600,9 @@ It is generated with state Deleted when a property of the window is deleted using request -DeleteProperty +DeleteProperty or -GetProperty. +GetProperty. The timestamp indicates the server time when the property was changed. @@ -14644,7 +14644,7 @@ The timestamp indicates the server time when the property was changed. This event is reported to the current owner of a selection and is generated when a new owner is being defined by means of -SetSelectionOwner. +SetSelectionOwner. The timestamp is the last-change time recorded for the selection. The owner argument is the window that was specified by the current owner in its SetSelectionOwner @@ -14706,10 +14706,10 @@ request. This event is reported to the owner of a selection and is generated when a client issues a -ConvertSelection +ConvertSelection request. The owner argument is the window that was specified in the -SetSelectionOwner +SetSelectionOwner request. The remaining arguments are as in the ConvertSelection @@ -14768,11 +14768,11 @@ standard Inter-Client Communication Conventions Manual. This event is generated by the server in response to a -ConvertSelection +ConvertSelection request when there is no owner for the selection. When there is an owner, it should be generated by the owner using -SendEvent. +SendEvent. The owner of a selection should send this event to a requestor either when a selection has been converted and stored as a property or when a selection conversion could not be performed (indicated with property @@ -14875,14 +14875,14 @@ There is no mechanism to express disinterest in this event. The detail indicates the kind of change that occurred: Modifiers for a successful -SetModifierMapping, +SetModifierMapping, Keyboard for a successful -ChangeKeyboardMapping, +ChangeKeyboardMapping, and Pointer for a successful -SetPointerMapping. +SetPointerMapping. If the detail is Keyboard, then first-keycode and count indicate the range of altered keycodes. @@ -14930,7 +14930,7 @@ then first-keycode and count indicate the range of altered keycodes. This event is only generated by clients using -SendEvent. +SendEvent. The type specifies how the data is to be interpreted by the receiving client; the server places no interpretation on the type or the data. The format specifies whether the data should be viewed as a list of 8-bit, -- cgit v1.2.1