From 0e3699334faf92f508b6c187a261548b656b0dd3 Mon Sep 17 00:00:00 2001 From: marha Date: Fri, 20 Apr 2012 17:07:15 +0200 Subject: fontconfig libX11 mesa pixman xserver git update 20 april 2012 --- libX11/specs/libX11/AppC.xml | 97 +++++++++++++++++++++++++------------------- libX11/specs/libX11/CH01.xml | 3 +- libX11/specs/libX11/CH09.xml | 3 +- 3 files changed, 60 insertions(+), 43 deletions(-) (limited to 'libX11') diff --git a/libX11/specs/libX11/AppC.xml b/libX11/specs/libX11/AppC.xml index c2e7f54fb..df250275e 100644 --- a/libX11/specs/libX11/AppC.xml +++ b/libX11/specs/libX11/AppC.xml @@ -37,9 +37,9 @@ and should use minor opcodes to distinguish the requests. The symbols and macros used for writing stubs to Xlib are listed in <X11/Xlibint.h>. - -Basic Protocol Support Routines + +Basic Protocol Support Routines The basic protocol requests for extensions are @@ -202,9 +202,10 @@ The function frees the memory allocated by . - -Hooking into Xlib + + +Hooking into Xlib These functions allow you to hook into the library. @@ -350,9 +351,9 @@ function allocates the structure, bumps the extension number count, and chains the extension onto the extension list. (This permits extensions to Xlib without requiring server extensions.) - -Hooks into the Library + +Hooks into the Library These functions allow you to define procedures that are to be @@ -1536,9 +1537,10 @@ The data argument specifies a portion of the outgoing data buffer, and its length in bytes is specified by the len argument. Your procedure must not alter the contents of the data and must not do additional protocol requests to the same display. - -Hooks onto Xlib Data Structures + + +Hooks onto Xlib Data Structures Various Xlib data structures have provisions for extension procedures @@ -1817,9 +1819,11 @@ To correctly handle automatic reuse of resource IDs, you must call when requesting multiple resource IDs. This call might generate protocol requests. - -GC Caching + + + +GC Caching GCs are cached by the library to allow merging of independent change @@ -1922,12 +1926,11 @@ Specifies the GC. - - -Graphics Batching - + + +Graphics Batching If you extend X to add more poly graphics primitives, you may be able to @@ -2010,9 +2013,10 @@ Note that is called before picking up the value of last_req, because it may modify this field. - -Writing Extension Stubs + + +Writing Extension Stubs All X requests always contain the length of the request, @@ -2023,10 +2027,11 @@ Some servers may not support single requests of such a length. The value of dpy->max_request_size contains the maximum length as defined by the server implementation. For further information, -see ``X Window System Protocol.'' - -Requests, Replies, and Xproto.h +see X Window System Protocol. + +Requests, Replies, and Xproto.h The @@ -2068,9 +2073,10 @@ that looks similar to this: In your extension header file, this will be a minor opcode, instead of a major opcode. - -Request Format + + +Request Format Every request contains an 8-bit major opcode and a 16-bit length field @@ -2269,9 +2275,10 @@ Instead, they use the xGenericReply structure, which contains only a type, length, and sequence number (and sufficient padding to make it 32 bytes long). - -Starting to Write a Stub Procedure + + +Starting to Write a Stub Procedure An Xlib stub procedure should start like this: @@ -2299,9 +2306,10 @@ The following is an example: xDoSomethingReply rep; - -Locking Data Structures + + +Locking Data Structures To lock the display structure for systems that @@ -2343,12 +2351,11 @@ Specifies the connection to the X server. - - -Sending the Protocol Request and Arguments - + + +Sending the Protocol Request and Arguments After the variable declarations, @@ -2462,9 +2469,10 @@ which is the same as except that it takes an additional argument (the number of extra bytes to allocate in the output buffer after the request structure). This number should always be a multiple of four. - -Variable Length Arguments + + +Variable Length Arguments Some protocol requests take additional variable-length data that @@ -2544,9 +2552,10 @@ copying it into the output buffer (which would later be flushed anyway by the following call on ), it is faster. - -Replies + + +Replies If the protocol request has a reply, @@ -2995,9 +3004,10 @@ reads and discards up to three additional pad bytes. Each protocol request is a little different. For further information, see the Xlib sources for examples. - -Synchronous Calling + + +Synchronous Calling Each procedure should have a call, just before returning to the user, @@ -3008,9 +3018,10 @@ If synchronous mode is enabled (see the request is sent immediately. The library, however, waits until any error the procedure could generate at the server has been handled. - -Allocating and Deallocating Memory + + +Allocating and Deallocating Memory To support the possible reentry of these procedures, @@ -3181,9 +3192,10 @@ Specifies the size of the buffer. You must pass back the same pointer and size that were returned by . - -Portability Considerations + + +Portability Considerations Many machine architectures, @@ -3252,9 +3264,10 @@ The PackData macro is a half-hearted attempt to deal with the possibility of 32 bit shorts. However, much more work is needed to make this work properly. - -Deriving the Correct Extension Opcode + + +Deriving the Correct Extension Opcode The remaining problem a writer of an extension stub procedure faces that @@ -3310,4 +3323,6 @@ structure. + + diff --git a/libX11/specs/libX11/CH01.xml b/libX11/specs/libX11/CH01.xml index 8d2092420..081e80c46 100644 --- a/libX11/specs/libX11/CH01.xml +++ b/libX11/specs/libX11/CH01.xml @@ -26,7 +26,8 @@ programming language. Other higher-level abstractions (for example, those provided by the toolkits for X) are built on top of the Xlib library. For further information about these higher-level libraries, see the appropriate toolkit documentation. -The X Window System Protocol provides the +The X Window System Protocol provides the definitive word on the behavior of X. Although additional information appears here, the protocol document is the ruling document. diff --git a/libX11/specs/libX11/CH09.xml b/libX11/specs/libX11/CH09.xml index e239db2e9..5636df149 100644 --- a/libX11/specs/libX11/CH09.xml +++ b/libX11/specs/libX11/CH09.xml @@ -1434,7 +1434,8 @@ setup. Servers also can implement other access control policies in addition to or in place of this host access facility. For further information about other access control implementations, -see ``X Window System Protocol.'' +see X Window System Protocol. Adding, Getting, or Removing Hosts -- cgit v1.2.3