From eee32e88a91aef246b8148f2efeb9c21f1316b2e Mon Sep 17 00:00:00 2001 From: marha Date: Tue, 20 Jul 2010 08:30:40 +0000 Subject: xserver libX11 git update 20/7/2010 --- libX11/specs/libX11/AppA.xml | 3 + libX11/specs/libX11/AppB.xml | 3 + libX11/specs/libX11/AppC.xml | 298 ++++++++--------- libX11/specs/libX11/AppD.xml | 131 ++++---- libX11/specs/libX11/CH01.xml | 705 ++++++++++++++++++++------------------- libX11/specs/libX11/CH02.xml | 8 +- libX11/specs/libX11/CH03.xml | 12 +- libX11/specs/libX11/CH04.xml | 375 +++++++-------------- libX11/specs/libX11/CH05.xml | 3 + libX11/specs/libX11/CH06.xml | 35 +- libX11/specs/libX11/CH07.xml | 20 +- libX11/specs/libX11/CH08.xml | 8 +- libX11/specs/libX11/CH09.xml | 5 +- libX11/specs/libX11/CH10.xml | 26 +- libX11/specs/libX11/CH11.xml | 5 +- libX11/specs/libX11/CH12.xml | 13 +- libX11/specs/libX11/CH13.xml | 3 + libX11/specs/libX11/CH14.xml | 262 ++++++++------- libX11/specs/libX11/CH15.xml | 20 +- libX11/specs/libX11/CH16.xml | 60 +++- libX11/specs/libX11/credits.xml | 3 + libX11/specs/libX11/glossary.xml | 19 +- libX11/specs/libX11/libX11.xml | 2 +- 23 files changed, 998 insertions(+), 1021 deletions(-) (limited to 'libX11/specs') diff --git a/libX11/specs/libX11/AppA.xml b/libX11/specs/libX11/AppA.xml index a59bda63b..fca0003c0 100644 --- a/libX11/specs/libX11/AppA.xml +++ b/libX11/specs/libX11/AppA.xml @@ -1,3 +1,6 @@ + + Xlib Functions and Protocol Requests diff --git a/libX11/specs/libX11/AppB.xml b/libX11/specs/libX11/AppB.xml index 8d9886aac..ca435fb01 100644 --- a/libX11/specs/libX11/AppB.xml +++ b/libX11/specs/libX11/AppB.xml @@ -1,3 +1,6 @@ + + X Font Cursors diff --git a/libX11/specs/libX11/AppC.xml b/libX11/specs/libX11/AppC.xml index 69838dc8b..16f7dfddb 100644 --- a/libX11/specs/libX11/AppC.xml +++ b/libX11/specs/libX11/AppC.xml @@ -1,3 +1,6 @@ + + Extensions @@ -239,16 +242,16 @@ and is defined in XExtCodes - + typedef struct _XExtCodes { /* public to extension, cannot be changed */ - int extension; /* extension number */ + int extension; /* extension number */ int major_opcode; /* major op-code assigned by server */ int first_event; /* first event number for the extension */ int first_error; /* first error number for the extension */ } XExtCodes; - + @@ -428,12 +431,14 @@ When is called, your procedure is called with these arguments: + + + int (*proc) + Display *display + XExtCodes *codes + + - -(*proc)(display, codes) - Display *display; - XExtCodes *codes; - XESetCreateGC @@ -492,16 +497,16 @@ It returns any previously defined procedure, usually NULL. When a GC is created, your procedure is called with these arguments: - - - -(*proc)(display, gc, codes) - Display *display; - GC gc; - XExtCodes *codes; - + + + int (*proc) + Display *display + GC gc + XExtCodes *codes + + XESetCopyGC @@ -559,13 +564,15 @@ It returns any previously defined procedure, usually NULL. When a GC is copied, your procedure is called with these arguments: + + + int (*proc) + Display *display + GC gc + XExtCodes *codes + + - -(*proc)(display, gc, codes) - Display *display; - GC gc; - XExtCodes *codes; - int *XESetFreeGC @@ -619,19 +626,19 @@ It returns any previously defined procedure, usually NULL. When a GC is freed, your procedure is called with these arguments: - - - -(*proc)(display, gc, codes) - Display *display; - GC gc; - XExtCodes *codes; - + + + int (*proc) + Display *display + GC gc + XExtCodes *codes + + @@ -700,19 +707,19 @@ or XQueryFont is called, your procedure is called with these arguments: - - - -(*proc)(display, fs, codes) - Display *display; - XFontStruct *fs; - XExtCodes *codes; - + + + int (*proc) + Display *display + XFontStruct *fs + XExtCodes *codes + + @@ -776,19 +783,19 @@ It returns any previously defined procedure, usually NULL. When XFreeFont is called, your procedure is called with these arguments: - - - -(*proc)(display, fs, codes) - Display *display; - XFontStruct *fs; - XExtCodes *codes; - + + + int (*proc) + Display *display + XFontStruct *fs + XExtCodes *codes + + @@ -895,21 +902,19 @@ and modify it before being placed in the queue or otherwise examined. When Xlib needs to convert an event from wire format to host format, your procedure is called with these arguments: - - - -Status (*proc)(display, re, event) - Display *display; - XEvent *re; - xEvent *event; - - - + + + int (*proc) + Display *display + XEvent *re + xEvent *event + + Your procedure must return status to indicate if the conversion succeeded. @@ -1053,21 +1058,19 @@ and modify it before being sent to another client. When Xlib needs to convert an event from host format to wire format, your procedure is called with these arguments: - - - -(*proc)(display, re, event) - Display *display; - XEvent *re; - xEvent *event; - - - + + + int (*proc) + Display *display + XEvent *re + xEvent *event + + The re argument is a pointer to the host format event, @@ -1146,21 +1149,19 @@ X error before it is otherwise examined. When Xlib needs to convert an error from wire format to host format, the procedure is called with these arguments: - - - -Bool (*proc)(display, he, we) - Display *display; - XErrorEvent *he; - xError *we; - - - + + + int (*proc) + Display *display + XErrorEvent *he + xError *we + + The he argument is a pointer to where the host format error should be stored. @@ -1234,22 +1235,20 @@ case, and are typically programmed to be synchronous). When Xlib detects a protocol error in _XReply, it calls your procedure with these arguments: - - - -int (*proc)(display, err, codes, ret_code) - Display *display; - xError *err; - XExtCodes *codes; - int *ret_code; - - - + + + int (*proc) + Display *display + xError *err + XExtCodes *codes + int *ret_code + + The err argument is a pointer to the 32-byte wire format error. @@ -1326,19 +1325,19 @@ The following is an example. - -(*proc)(display, code, codes, buffer, nbytes) - Display *display; - int code; - XExtCodes *codes; - char *buffer; - int nbytes; - - - + + + int (*proc) + Display *display + int code + XExtCodes *codes + char *buffer + int nbytes + + Your procedure is called with the error code for every error detected. @@ -1403,21 +1402,19 @@ It returns any previously defined procedure. When Xlib needs to print an error, the procedure is called with these arguments: - - - -void (*proc)(display, ev, fp) - Display *display; - XErrorEvent *ev; - void *fp; - - - + + + void (*proc) + Display *display + XErrorEvent *ev + void *fp + + The structure pointed at by ev is guaranteed to be as large as an @@ -1532,22 +1529,20 @@ The function defines a procedure to be called when data is about to be sent to the server. When data is about to be sent, your procedure is called one or more times with these arguments: - - - -void (*proc)(display, codes, data, len) - Display *display; - XExtCodes *codes; - char *data; - long len; - - - + + + void (*proc) + Display *display + XExtCodes *codes + char *data + long len + + The data argument specifies a portion of the outgoing data buffer, @@ -1583,16 +1578,16 @@ and is defined in XExtData - + typedef struct _XExtData { int number; /* number returned by XInitExtension */ struct _XExtData *next; /* next item on list of data for structure */ int (*free_private)(); /* if defined, called to free private */ XPointer private_data; /* data private to this extension. */ } XExtData; - + @@ -1606,16 +1601,16 @@ and the structure itself. - + union { Display *display; GC gc; Visual *visual; Screen *screen; ScreenFormat *pixmap_format; XFontStruct *font } XEDataObject; - + @@ -1971,12 +1966,9 @@ For example, here is the source for the stub. (Writing extension stubs is discussed in the next section.) - - - - + #include <X11/Xlibint.h> /* precompute the maximum size of batching request allowed */ @@ -2020,10 +2012,8 @@ XDrawPoint(dpy, d, gc, x, y) UnlockDisplay(dpy); SyncHandle(); } + - - - @@ -2088,10 +2078,10 @@ that looks similar to this: - + #define X_DoSomething 42 - + In your extension header file, this will be a minor opcode, instead of a major opcode. @@ -2151,18 +2141,18 @@ which looks like: xDoSomethingReq - + typedef struct _DoSomethingReq { - CARD8 reqType; /* X_DoSomething */ + CARD8 reqType; /* X_DoSomething */ CARD8 someDatum; /* used differently in different requests */ CARD16 length B16; /* total # of bytes in request, divided by 4 */ ... /* request-specific data */ ... } xDoSomethingReq; - + @@ -2189,16 +2179,16 @@ or xResourceReq - + typedef struct _ResourceReq { CARD8 reqType; /* the request type, e.g. X_DoSomething */ BYTE pad; /* not used */ CARD16 length B16; /* 2 (= total # of bytes in request, divided by 4) */ CARD32 id B32; /* the Window, Drawable, Font, GContext, etc. */ } xResourceReq; - + @@ -2239,9 +2229,9 @@ also contains a reply structure typedef: xDoSomethingReply - + typedef struct _DoSomethingReply { BYTE type; /* always X_Reply */ BYTE someDatum; /* used differently in different requests */ @@ -2251,7 +2241,7 @@ typedef struct _DoSomethingReply { /* request-specific data */ ... } xDoSomethingReply; - + @@ -2305,8 +2295,8 @@ An Xlib stub procedure should start like this: - + #include "<X11/Xlibint.h> XDoSomething (arguments, ... ) @@ -2315,17 +2305,17 @@ XDoSomething (arguments, ... ) register XDoSomethingReq *req; ... - + If the protocol request has a reply, then the variable declarations should include the reply structure for the request. The following is an example: - + xDoSomethingReply rep; - + Locking Data Structures @@ -2408,10 +2398,10 @@ then use - + GetEmptyReq (DoSomething, req); - + If the protocol request has a single 32-bit argument (such as a Pixmap, Window, @@ -2426,10 +2416,10 @@ is a good example. - + GetResReq (DoSomething, rid, req); - + The rid argument is the Pixmap, Window, @@ -2447,14 +2437,14 @@ usually from arguments to the stub procedure. - + GetReq (DoSomething, req); /* fill in arguments here */ req->arg1 = arg1; req->arg2 = arg2; ... - + A few stub procedures (such as XCreateGC and @@ -2468,12 +2458,12 @@ that were assigned to this client when it opened the connection. - + rid = req->rid = XAllocID(); ... return (rid); - + Finally, some stub procedures transmit a fixed amount of variable-length data after the request. Typically, these procedures (such as @@ -2515,10 +2505,10 @@ then you must round the length up and shift it before adding: - + req->length += (nbytes+3)>>2; - + To transmit variable-length data, use the Data macros. @@ -2736,8 +2726,8 @@ data, you write something like: - + _XReply(display, (xReply *)&rep, 0, True); *ret1 = rep.ret1; *ret2 = rep.ret2; @@ -2747,7 +2737,7 @@ UnlockDisplay(dpy); SyncHandle(); return (rep.ret4); } - + If there is variable-length data after the reply, change the True diff --git a/libX11/specs/libX11/AppD.xml b/libX11/specs/libX11/AppD.xml index 40778f124..0d060069e 100644 --- a/libX11/specs/libX11/AppD.xml +++ b/libX11/specs/libX11/AppD.xml @@ -1,17 +1,17 @@ + + Compatibility Functions - The X Version 11 and X Version 10 functions discussed in this appendix are obsolete, have been superseded by newer X Version 11 functions, and are maintained for compatibility reasons only. - -X Version 11 Compatibility Functions + +X Version 11 Compatibility Functions - You can use the X Version 11 compatibility functions to: - @@ -38,21 +38,21 @@ Parse window geometry Get X environment defaults - -Setting Standard Properties + + +Setting Standard Properties - To specify a minimum set of properties describing the simplest application, use XSetStandardProperties. This function has been superseded by XSetWMProperties and sets all or portions of the -WM_NAME, WM_ICON_NAME, WM_HINTS, WM_COMMAND, -and WM_NORMAL_HINTS properties. +WM_NAME, WM_ICON_NAME, WM_HINTS, WM_COMMAND, +and WM_NORMAL_HINTS properties. XSetStandardProperties @@ -180,19 +180,20 @@ can generate and BadWindow errors. - + + +Setting and Getting Window Sizing Hints -Setting and Getting Window Sizing Hints - - - Xlib provides functions that you can use to set or get window sizing hints. The functions discussed in this section use the flags and the XSizeHints structure, as defined in the -<X11/Xutil.h> -header file and use the WM_NORMAL_HINTS property. +<X11/Xutil.h> +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> +header file and use the WM_NORMAL_HINTS property. @@ -353,7 +354,7 @@ error. -The next two functions set and read the WM_ZOOM_HINTS property. +The next two functions set and read the WM_ZOOM_HINTS property. @@ -494,7 +495,7 @@ error. -To set the value of any property of type WM_SIZE_HINTS, use +To set the value of any property of type WM_SIZE_HINTS, use XSetSizeHints. This function has been superseded by XSetWMSizeHints. @@ -565,7 +566,7 @@ This is used by XSetNormalHints and XSetZoomHints -and can be used to set the value of any property of type WM_SIZE_HINTS. +and can be used to set the value of any property of type WM_SIZE_HINTS. Thus, it may be useful if other properties of that type get defined. @@ -581,7 +582,7 @@ errors. -To read the value of any property of type WM_SIZE_HINTS, use +To read the value of any property of type WM_SIZE_HINTS, use XGetSizeHints. This function has been superseded by XGetWMSizeHints. @@ -653,7 +654,7 @@ This is used by and XGetZoomHints. It also can be used to retrieve the value of any property of type -WM_SIZE_HINTS. +WM_SIZE_HINTS. Thus, it may be useful if other properties of that type get defined. XGetSizeHints returns a nonzero status if a size hint was defined @@ -667,11 +668,11 @@ can generate and BadWindow errors. - -Getting and Setting an XStandardColormap Structure + + +Getting and Setting an XStandardColormap Structure - To get the XStandardColormap structure associated with one of the described atoms, use @@ -749,19 +750,9 @@ colormap for a display, you use XGetStandardColormap with the following syntax: - - - - - - - + XGetStandardColormap(dpy, DefaultRootWindow(dpy), &cmap, XA_RGB_GRAY_MAP); - - - - - + See section 14.3 for the semantics of standard colormaps. @@ -852,11 +843,11 @@ can generate and BadWindow errors. - -Parsing Window Geometry + + +Parsing Window Geometry - To parse window geometry given a user-specified position and a default position, use XGeometry. @@ -1051,13 +1042,11 @@ The x and y coordinates are computed by using the border width, the screen width and height, padding as specified by xadder and yadder, and the fheight and fwidth times the width and height from the geometry specifications. - - - -Getting the X Environment Defaults + + +Getting the X Environment Defaults - The XGetDefault function provides a primitive interface to the resource manager facilities @@ -1161,13 +1150,13 @@ looks for "$HOME/.Xdefaults-name" , where name specifies the name of the machine on which the application is running. - -X Version 10 Compatibility Functions + + + +X Version 10 Compatibility Functions - You can use the X Version 10 compatibility functions to: - @@ -1177,11 +1166,12 @@ Draw and fill polygons and curves Associate user data with a value - -Drawing and Filling Polygons and Curves + + +Drawing and Filling Polygons and Curves Xlib provides functions that you can use to draw or fill @@ -1339,25 +1329,18 @@ vertex structure. Each Vertex, as defined in -<X11/X10.h>, +<X11/X10.h>, +X11/X10.h +Files<X11/X10.h> +Headers<X11/X10.h> is a structure with the following members: - - - Vertex - - - - + typedef struct _Vertex { short x,y; unsigned short flags; } Vertex; - - - - - + The x and y members are the coordinates of the vertex that are relative to either the upper left inside corner of the drawable (if @@ -1369,7 +1352,10 @@ is one). The flags, as defined in -<X11/X10.h>, +<X11/X10.h>, +X11/X10.h +Files<X11/X10.h> +Headers<X11/X10.h> are as follows: VertexRelative VertexDontDraw @@ -1377,15 +1363,14 @@ are as follows: VertexStartClosed VertexEndClosed - - + VertexRelative 0x0001 /* else absolute */ VertexDontDraw 0x0002 /* else draw */ VertexCurved 0x0004 /* else straight */ VertexStartClosed 0x0008 /* else not */ VertexEndClosed 0x0010 /* else not */ - + @@ -1449,6 +1434,7 @@ and successor vertices for the spline algorithm. + This function uses these GC components: @@ -1555,9 +1541,10 @@ It also uses these GC mode-dependent components: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dash-list, fill-style, and fill-rule. - -Associating User Data with a Value + + +Associating User Data with a Value These functions have been superseded by the context management functions @@ -1865,7 +1852,7 @@ function deletes an association in an XAssocTable keyed on its XID. Redundant deletes (and deletes of nonexistent XIDs) are ignored. -Deleting associations in no way impairs the performance of an +Deleting associations in no way impairs the performance of an XAssocTable. @@ -1897,4 +1884,6 @@ Specifies the assoc table. + + diff --git a/libX11/specs/libX11/CH01.xml b/libX11/specs/libX11/CH01.xml index 523eedad0..c8d8dcc6c 100644 --- a/libX11/specs/libX11/CH01.xml +++ b/libX11/specs/libX11/CH01.xml @@ -1,70 +1,74 @@ -Introduction to Xlib + + +Introduction to Xlib - -The X Window System is a network-transparent window system that was designed at MIT. X -display servers run on computers with either monochrome or color bitmap display hardware. The -server distributes user input to and accepts output requests from various client programs located -either on the same machine or elsewhere in the network. Xlib is a C subroutine library that appli- -cation programs (clients) use to interface with the window system by means of a stream connec- -tion. Although a client usually runs on the same machine as the X server it is talking to, this need -not be the case. - - -Xlib − C Language X Interface is a reference guide to the low-level C language interface to the X -Window System protocol. It is neither a tutorial nor a user’s guide to programming the X Win- -dow System. Rather, it provides a detailed description of each function in the library as well as a -discussion of the related background information. Xlib − C Language X Interface assumes a -basic understanding of a graphics window system and of the C 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 definitive word on the behavior of -X. Although additional information appears here, the protocol document is the ruling document. - - + +The X Window System is a network-transparent window system that was +designed at MIT. X display servers run on computers with either +monochrome or color bitmap display hardware. The server distributes +user input to and accepts output requests from various client programs +located either on the same machine or elsewhere in the network. Xlib +is a C subroutine library that application programs (clients) use to +interface with the window system by means of a stream connection. +Although a client usually runs on the same machine as the X server +it is talking to, this need not be the case. + + +Xlib − C Language X Interface is a reference +guide to the low-level C language interface to the X Window System +protocol. It is neither a tutorial nor a user’s guide to programming +the X Window System. Rather, it provides a detailed description of +each function in the library as well as a discussion of the related +background information. Xlib − C Language X Interface +assumes a basic understanding of a graphics window system and of the C +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 +definitive word on the behavior of X. +Although additional information appears here, the protocol document is +the ruling document. + + To provide an introduction to X programming, this chapter discusses: - - - Overview of the X Window System - Errors - Standard header files - Generic values and types - Naming and argument conventions within Xlib - Programming considerations - Character sets and encodings - Formatting conventions - + + Overview of the X Window System + Errors + Standard header files + Generic values and types + Naming and argument conventions within Xlib + Programming considerations + Character sets and encodings + Formatting conventions + + - - -Overview of the X Window System - - - - - + + Overview of the X Window System + Some of the terms used in this book are unique to X, -and other terms that are common to other window systems -have different meanings in X. -You may find it helpful to refer to the glossary, +and other terms that are common to other window systems +have different meanings in X. You may find it helpful to refer to +the glossary, which is located at the end of the book. - - - + + The X Window System supports one or more screens containing overlapping windows or subwindows. -A screen is a physical monitor and hardware +Screen +A screen is a physical monitor and hardware that can be color, grayscale, or monochrome. There can be multiple screens for each display or workstation. A single X server can provide display services for any number of screens. A set of screens for a single user with one keyboard and one pointer -(usually a mouse) is called a display. - - - -Screen +(usually a mouse) is called a display. + + All the windows in an X server are arranged in strict hierarchies. -At the top of each hierarchy is a root window, +At the top of each hierarchy is a root window, which covers each of the display screens. Each root window is partially or completely covered by child windows. All windows, except for root windows, have parents. @@ -72,29 +76,27 @@ There is usually at least one window for each application program. Child window Parent Window Child windows may in turn have their own children. -In this way, -an application program can create an arbitrarily deep tree +In this way, +an application program can create an arbitrarily deep tree on each screen. X provides graphics, text, and raster operations for windows. - - - -A child window can be larger than its parent. + + +A child window can be larger than its parent. That is, part or all of the child window can extend beyond the boundaries of the parent, but all output to a window is clipped by its parent. Stacking order -If several children of a window have overlapping locations, +If several children of a window have overlapping locations, one of the children is considered to be on top of or raised over the others, thus obscuring them. Output to areas covered by other windows is suppressed by the window system unless the window has backing store. -If a window is obscured by a second window, +If a window is obscured by a second window, the second window obscures only those ancestors of the second window that are also ancestors of the first window. - - - + + Window A window has a border zero or more pixels in width, which can be any pattern (pixmap) or solid color you like. @@ -103,43 +105,40 @@ which will be repainted by the window system when uncovered. Child windows obscure their parents, and graphic operations in the parent window usually are clipped by the children. - - - + + Each window and pixmap has its own coordinate system. The coordinate system has the X axis horizontal and the Y axis vertical with the origin [0, 0] at the upper-left corner. Coordinates are integral, in terms of pixels, and coincide with pixel centers. -For a window, +For a window, the origin is inside the border at the inside, upper-left corner. - - - -X does not guarantee to preserve the contents of windows. + + +X does not guarantee to preserve the contents of windows. When part or all of a window is hidden and then brought back onto the screen, -its contents may be lost. +its contents may be lost. The server then sends the client program an -Expose +Expose event to notify it that part or all of the window needs to be repainted. Programs must be prepared to regenerate the contents of windows on demand. - - - + + Pixmap Drawable Tile Bitmap X also provides off-screen storage of graphics objects, -called pixmaps. -Single plane (depth 1) pixmaps are sometimes referred to as bitmaps. +called pixmaps. +Single plane (depth 1) pixmaps are sometimes referred to as +bitmaps. Pixmaps can be used in most graphics functions interchangeably with windows and are used in various graphics operations to define patterns or tiles. Windows and pixmaps together are referred to as drawables. - - - + + Most of the functions in Xlib just add requests to an output buffer. These requests later execute asynchronously on the X server. Functions that return values of information stored in @@ -147,39 +146,41 @@ the server do not return (that is, they block) until an explicit reply is received or an error occurs. You can provide an error handler, which will be called when the error is reported. - - - + + XSync -If a client does not want a request to execute asynchronously, -it can follow the request with a call to +If a client does not want a request to execute asynchronously, +it can follow the request with a call to XSync, which blocks until all previously buffered asynchronous events have been sent and acted on. -As an important side effect, +As an important side effect, the output buffer in Xlib is always flushed by a call to any function that returns a value from the server or waits for input. - - - + + Resource IDs Resource IDsWindow Resource IDsFont Resource IDsPixmap +Resource IDsColormap Resource IDsCursor Resource IDsGContext Many Xlib functions will return an integer resource ID, which allows you to refer to objects stored on the X server. -These can be of type +These can be of type Window, Font, Pixmap, Colormap, Cursor, -and +and GContext, as defined in the file -<X11/X.h>. +<X11/X.h>. +X11/X.h +Files<X11/X.h> +Headers<X11/X.h> These resources are created by requests and are destroyed (or freed) by requests or when connections are closed. Most of these resources are potentially sharable between @@ -189,23 +190,21 @@ Fonts and cursors are shared automatically across multiple screens. Fonts are loaded and unloaded as needed and are shared by multiple clients. Fonts are often cached in the server. Xlib provides no support for sharing graphics contexts between applications. - - - + + Event Client programs are informed of events. Events may either be side effects of a request (for example, restacking windows -generates -Expose +generates +Expose events) or completely asynchronous (for example, from the keyboard). A client program asks to be informed of events. Because other applications can send events to your application, programs must be prepared to handle (or ignore) events of all types. - - - -Input events (for example, a key pressed or the pointer moved) -arrive asynchronously from the server and are queued until they are + + +Input events (for example, a key pressed or the pointer moved) +arrive asynchronously from the server and are queued until they are requested by an explicit call (for example, XNextEvent or @@ -213,7 +212,7 @@ or In addition, some library functions (for example, XRaiseWindow) -generate +generate Expose and ConfigureRequest @@ -223,70 +222,66 @@ These events also arrive asynchronously, but the client may wish to explicitly wait for them by calling XSync after calling a function that can cause the server to generate events. - - - -Errors - - - - - -Some functions return + + + + + Errors + + +Some functions return Status, an integer error indication. If the function fails, it returns a zero. If the function returns a status of zero, it has not updated the return arguments. Status -Because C does not provide multiple return values, -many functions must return their results by writing into client-passed storage. +Because C does not provide multiple return values, +many functions must return their results by writing into client-passed storage. Errorhandling By default, errors are handled either by a standard library function or by one that you provide. Functions that return pointers to strings return NULL pointers if the string does not exist. - - - + + The X server reports protocol errors at the time that it detects them. If more than one error could be generated for a given request, the server can report any of them. - - - + + Because Xlib usually does not transmit requests to the server immediately (that is, it buffers them), errors can be reported much later than they actually occur. For debugging purposes, however, -Xlib provides a mechanism for forcing synchronous behavior +Xlib provides a mechanism for forcing synchronous behavior (see section 11.8.1). -When synchronization is enabled, +When synchronization is enabled, errors are reported as they are generated. - - - + + When Xlib detects an error, it calls an error handler, which your program can provide. If you do not provide an error handler, the error is printed, and your program terminates. - - - -Standard Header Files - - - - - + + + + + Standard Header Files + + The following include files are part of the Xlib standard: - +Headers - - <X11/Xlib.h> + + <X11/Xlib.h> + X11/Xlib.h + Files<X11/Xlib.h> + Headers<X11/Xlib.h> This is the main header file for Xlib. The majority of all Xlib symbols are declared by including this file. @@ -298,212 +293,262 @@ This symbol is defined to have the 6 in this release of the standard. - - <X11/X.h> + + <X11/X.h> + X11/X.h + Files<X11/X.h> + Headers<X11/X.h> This file declares types and constants for the X protocol that are to be used by applications. It is included automatically from ->X11/Xlib.h< so application code should never need to +<X11/Xlib.h> +so application code should never need to reference this file directly. - - <X11/Xcms.h> + + <X11/Xcms.h> + X11/Xcms.h + Files<X11/Xcms.h> + Headers<X11/Xcms.h> This file contains symbols for much of the color management facilities -described in chapter 6. All functions, types, and symbols with the +described in chapter 6. All functions, types, and symbols with the prefix "Xcms", plus the Color Conversion Contexts macros, are declared in this file. -<X11/Xlib.h> must be included before including this file. +<X11/Xlib.h> +must be included before including this file. - - <X11/Xutil.h> + + <X11/Xutil.h> + X11/Xutil.h + Files<X11/Xutil.h> + Headers<X11/Xutil.h> This file declares various functions, types, and symbols used for inter-client communication and application utility functions, which are described in chapters 14 and 16. -<X11/Xlib.h> must be included before including this file. +<X11/Xlib.h> must be included before including this file. - - <X11/Xresource.h> + + <X11/Xresource.h> + X11/Xresource.h + Files<X11/Xresource.h> + Headers<X11/Xresource.h> This file declares all functions, types, and symbols for the resource manager facilities, which are described in chapter 15. -<X11/Xlib.h> +<X11/Xlib.h> must be included before including this file. - - <X11/Xatom.h> + + <X11/Xatom.h> + X11/Xatom.h + Files<X11/Xatom.h> + Headers<X11/Xatom.h> -This file declares all predefined atoms, +This file declares all predefined atoms, which are symbols with the prefix "XA_". - - <X11/cursorfont.h> + + <X11/cursorfont.h> + X11/cursorfont.h + Files<X11/cursorfont.h> + Headers<X11/cursorfont.h> This file declares the cursor symbols for the standard cursor font, -which are listed in appendix B. +which are listed in Appendix B. All cursor symbols have the prefix "XC_". - - <X11/keysymdef.h> + + <X11/keysymdef.h> + X11/keysymdef.h + Files<X11/keysymdef.h> + Headers<X11/keysymdef.h> This file declares all standard KeySym values, which are symbols with the prefix "XK_". The KeySyms are arranged in groups, and a preprocessor symbol controls inclusion of each group. The preprocessor symbol must be defined prior to inclusion of the file to obtain the associated values. -The preprocessor symbols are XK_MISCELLANY, XK_XKB_KEYS, XK_3270, -XK_LATIN1, XK_LATIN2, XK_LATIN3, XK_LATIN4, XK_KATAKANA, XK_ARABIC, -XK_CYRILLIC, XK_GREEK, XK_TECHNICAL, XK_SPECIAL, XK_PUBLISHING, XK_APL, -XK_HEBREW, XK_THAI, and XK_KOREAN. +The preprocessor symbols are +XK_MISCELLANY, +XK_XKB_KEYS, +XK_3270, +XK_LATIN1, +XK_LATIN2, +XK_LATIN3, +XK_LATIN4, +XK_KATAKANA, +XK_ARABIC, +XK_CYRILLIC, +XK_GREEK, +XK_TECHNICAL, +XK_SPECIAL, +XK_PUBLISHING, +XK_APL, +XK_HEBREW, +XK_THAI, and +XK_KOREAN. - - <X11/keysym.h> + + <X11/keysym.h> + X11/keysym.h + Files<X11/keysym.h> + Headers<X11/keysym.h> This file defines the preprocessor symbols -XK_MISCELLANY, XK_XKB_KEYS, XK_LATIN1, XK_LATIN2, XK_LATIN3, -XK_LATIN4, and XK_GREEK -and then includes <X11/keysymdef.h> +XK_MISCELLANY, +XK_XKB_KEYS, +XK_LATIN1, +XK_LATIN2, +XK_LATIN3, +XK_LATIN4, and +XK_GREEK +and then includes <X11/keysymdef.h>. - - <X11/Xlibint.h> + + <X11/Xlibint.h> + X11/Xlibint.h + Files<X11/Xlibint.h> + Headers<X11/Xlibint.h> This file declares all the functions, types, and symbols used for -extensions, which are described in appendix C. +extensions, which are described in Appendix C. This file automatically includes -<X11/Xlib.h<. +<X11/Xlib.h>. - - <X11/Xproto.h> + + <X11/Xproto.h> + X11/Xproto.h + Files<X11/Xproto.h> + Headers<X11/Xproto.h> This file declares types and symbols for the basic X protocol, for use in implementing extensions. It is included automatically from -<X11/Xlibint.h<, +<X11/Xlibint.h>, so application and extension code should never need to reference this file directly. - - <X11/Xprotostr.h> + + <X11/Xprotostr.h> + X11/Xprotostr.h + Files<X11/Xprotostr.h> + Headers<X11/Xprotostr.h> This file declares types and symbols for the basic X protocol, for use in implementing extensions. It is included automatically from -<X11/Xproto.h<, +<X11/Xproto.h>, so application and extension code should never need to reference this file directly. - - <X11/X10.h> + + <X11/X10.h> + X11/X10.h + Files<X11/X10.h> + Headers<X11/X10.h> This file declares all the functions, types, and symbols used for the -X10 compatibility functions, which are described in appendix D. +X10 compatibility functions, which are described in +Appendix D. - - + + + + Generic Values and Types - -Generic Values and Types - - - - - + The following symbols are defined by Xlib and used throughout the manual: -Bool -True -False - +Bool +True +False Xlib defines the type Bool and the Boolean values True and False. -None +None None is the universal null resource ID or atom. -XID +XID The type XID is used for generic resource IDs. -XPointer -The type -XPointer -is defined to be char\^* and is used as a generic opaque pointer to data. +XPointer +The type XPointer is defined to be char * +and is used as a generic opaque pointer to data. - - -Naming and Argument Conventions within Xlib - - - - - + + + + + Naming and Argument Conventions within Xlib + + Xlib follows a number of conventions for the naming and syntax of the functions. Given that you remember what information the function requires, -these conventions are intended to make the syntax of the functions more +these conventions are intended to make the syntax of the functions more predictable. - - - + + The major naming conventions are: - @@ -591,16 +636,14 @@ the mask always precedes the pointer to the structure in the argument list. - - -Programming Considerations - - - - - + + + + + Programming Considerations + + The major programming considerations are: - @@ -638,133 +681,111 @@ What you do inside of your top-level window, however, is up to your application. For further information, see chapter 14 -and the Inter-Client Communication Conventions Manual. +and the Inter-Client Communication Conventions Manual. - - -Character Sets and Encodings - - - - - + + + + + Character Sets and Encodings + + Some of the Xlib functions make reference to specific character sets and character encodings. The following are the most common: - - - - -X Portable Character Set - - - - -A basic set of 97 characters, + + + + X Portable Character Set + +A basic set of 97 characters, which are assumed to exist in all locales supported by Xlib. This set contains the following characters: - - - - + a..z A..Z 0..9 !"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~ <space>, <tab>, and <newline> - - - - + + + This set is the left/lower half of the graphic character set of ISO8859-1 plus space, tab, and newline. It is also the set of graphic characters in 7-bit ASCII plus the same three control characters. The actual encoding of these characters on the host is system dependent. - - - - -Host Portable Character Encoding - - - - + + + + + Host Portable Character Encoding + + The encoding of the X Portable Character Set on the host. The encoding itself is not defined by this standard, but the encoding must be the same in all locales supported by Xlib on the host. If a string is said to be in the Host Portable Character Encoding, then it only contains characters from the X Portable Character Set, in the host encoding. - - - - -Latin-1 - - - - + + + + + Latin-1 + + The coded character set defined by the ISO8859-1 standard. - - - - -Latin Portable Character Encoding - - - - + + + + + Latin Portable Character Encoding + + The encoding of the X Portable Character Set using the Latin-1 codepoints plus ASCII control characters. If a string is said to be in the Latin Portable Character Encoding, then it only contains characters from the X Portable Character Set, not all of Latin-1. - - - - -STRING Encoding - - - - + + + + + STRING Encoding + + Latin-1, plus tab and newline. - - - - -POSIX Portable Filename Character Set - - - - -The set of 65 characters, + + + + + POSIX Portable Filename Character Set + + +The set of 65 characters, which can be used in naming files on a POSIX-compliant host, that are correctly processed in all locales. The set is: - - - - - + a..z A..Z 0..9 ._- + + + + - - - - -Formatting Conventions - - - - - -Xlib \- C Language X Interface uses the following conventions: - - - + + + + Formatting Conventions + -Global symbols are printed in + Xlib − C Language X Interface uses the + following conventions: + + + + +Global symbols are printed in this special font. @@ -774,11 +795,11 @@ When declared and defined, function arguments are printed in italics. In the explanatory text that follows, they usually are printed in regular type. - - - - -Each function is introduced by a general discussion that + + + + +Each function is introduced by a general discussion that distinguishes it from other functions. The function declaration itself follows, and each argument is specifically explained. @@ -787,36 +808,36 @@ Xlib header files normally declare functions using function prototypes in ANSI C environments. General discussion of the function, if any is required, follows the arguments. -Where applicable, -the last paragraph of the explanation lists the possible +Where applicable, +the last paragraph of the explanation lists the possible Xlib error codes that the function can generate. For a complete discussion of the Xlib error codes, see section 11.8.2. - - - - -To eliminate any ambiguity between those arguments that you pass and those that + + + + +To eliminate any ambiguity between those arguments that you pass and those that a function returns to you, the explanations for all arguments that you pass start with the word -specifies or, in the case of multiple arguments, the word specify\^. +specifies or, in the case of multiple arguments, the word specify. The explanations for all arguments that are returned to you start with the -word returns or, in the case of multiple arguments, the word return\^. +word returns or, in the case of multiple arguments, the word return. The explanations for all arguments that you can pass and are returned start -with the words specifies and returns\^. - - - - -Any pointer to a structure that is used to return a value is designated as +with the words specifies and returns. + + + + +Any pointer to a structure that is used to return a value is designated as such by the _return suffix as part of its name. All other pointers passed to these functions are used for reading only. A few arguments use pointers to structures that are used for both input and output and are indicated by using the _in_out suffix. - + + + - - - + diff --git a/libX11/specs/libX11/CH02.xml b/libX11/specs/libX11/CH02.xml index b6623cbcc..a00b7c283 100644 --- a/libX11/specs/libX11/CH02.xml +++ b/libX11/specs/libX11/CH02.xml @@ -1,3 +1,6 @@ + + Display Functions @@ -219,7 +222,10 @@ returns a pointer to a Display structure, which is defined in -<X11/Xlib.h>. +<X11/Xlib.h>. +X11/Xlib.h +Files<X11/Xlib.h> +Headers<X11/Xlib.h> If XOpenDisplay does not succeed, it returns NULL. diff --git a/libX11/specs/libX11/CH03.xml b/libX11/specs/libX11/CH03.xml index 8b6fb3478..c6f1c86a1 100644 --- a/libX11/specs/libX11/CH03.xml +++ b/libX11/specs/libX11/CH03.xml @@ -1,3 +1,6 @@ + + Window Functions Visual Types @@ -176,7 +179,7 @@ use VisualID XVisualIDFromVisual - Visual *\^visual + Visual *visual @@ -750,7 +753,7 @@ change of width and height, the (x, y) pairs are defined: - + @@ -819,9 +822,9 @@ A bit-gravity of indicates that the contents or origin should not move relative to the origin of the root window. If the change in size of the window is coupled with a change in position (x, y), -then for bit-gravity the change in position of each pixel is (\-x, \-y), and for +then for bit-gravity the change in position of each pixel is (−x, −y), and for win-gravity the change in position of a child when its parent is so resized is -(\-x, \-y). +(−x, −y). Note that StaticGravity still only takes effect when the width or height of the window is changed, @@ -3386,7 +3389,6 @@ To restack a set of windows from top to bottom, use XRestackWindows - XRestackWindows\^(\^display,windows, \^nwindows) Display *display Window windows[] int nwindows diff --git a/libX11/specs/libX11/CH04.xml b/libX11/specs/libX11/CH04.xml index dc611aef5..119e86a2e 100644 --- a/libX11/specs/libX11/CH04.xml +++ b/libX11/specs/libX11/CH04.xml @@ -1,3 +1,6 @@ + + Window Information Functions @@ -253,73 +256,38 @@ or The bit_gravity member is set to the window's bit gravity and can be one of the following: + + ForgetGravity + NorthWestGravity + NorthGravity + NorthEastGravity + WestGravity + + EastGravity + SouthWestGravity + SouthGravity + SouthEastGravity + StaticGravity + - - - - - - - ForgetGravity - EastGravity - - - NorthWestGravity - SouthWestGravity - - - NorthGravity - SouthGravity - - - NorthEastGravity - SouthEastGravity - - - WestGravity - StaticGravity - - - - - The win_gravity member is set to the window's window gravity and can be one of the following: - + + UnmapGravity + NorthWestGravity + NorthGravity + NorthEastGravity + WestGravity - - - - - - - UnmapGravity - EastGravity - - - NorthWestGravity - SouthWestGravity - - - NorthGravity - SouthGravity - - - NorthEastGravity - SouthEastGravity - - - WestGravity - StaticGravity - - - CenterGravity - - - - - + EastGravity + SouthWestGravity + SouthGravity + SouthEastGravity + StaticGravity + CenterGravity + + For additional information on gravity, @@ -910,7 +878,10 @@ arbitrary extension in this type scheme. Certain property names are predefined in the server for commonly used functions. The atoms for these properties are defined in -<X11/Xatom.h>. +<X11/Xatom.h>. +X11/Xatom.h +Files<X11/Xatom.h> +Headers<X11/Xatom.h> To avoid name clashes with user symbols, the #define name for each atom has the XA_ prefix. @@ -973,206 +944,98 @@ event (none are built into the X server) The built-in selection property names are: - - - - - - - -PRIMARY -SECONDARY - + + PRIMARY + SECONDARY + The built-in property names are: - - - - - - - lw(2i) lw(2i). - - - CUT_BUFFER0 - RESOURCE_MANAGER - - - CUT_BUFFER1 - WM_CLASS - - - CUT_BUFFER2 - WM_CLIENT_MACHINE - - - CUT_BUFFER3 - WM_COLORMAP_WINDOWS - - - CUT_BUFFER4 - WM_COMMAND - - - CUT_BUFFER5 - WM_HINTS - - - CUT_BUFFER6 - WM_ICON_NAME - - - CUT_BUFFER7 - WM_ICON_SIZE - - - RGB_BEST_MAP - WM_NAME - - - RGB_BLUE_MAP - WM_NORMAL_HINTS - - - RGB_DEFAULT_MAP - WM_PROTOCOLS - - - RGB_GRAY_MAP - WM_STATE - - - RGB_GREEN_MAP - WM_TRANSIENT_FOR - - - RGB_RED_MAP - WM_ZOOM_HINTS - - - - + + CUT_BUFFER0 + CUT_BUFFER1 + CUT_BUFFER2 + CUT_BUFFER3 + CUT_BUFFER4 + CUT_BUFFER5 + CUT_BUFFER6 + CUT_BUFFER7 + RGB_BEST_MAP + RGB_BLUE_MAP + RGB_DEFAULT_MAP + RGB_GRAY_MAP + RGB_GREEN_MAP + RGB_RED_MAP + + RESOURCE_MANAGER + WM_CLASS + WM_CLIENT_MACHINE + WM_COLORMAP_WINDOWS + WM_COMMAND + WM_HINTS + WM_ICON_NAME + WM_ICON_SIZE + WM_NAME + WM_NORMAL_HINTS + WM_PROTOCOLS + WM_STATE + WM_TRANSIENT_FOR + WM_ZOOM_HINTS + - The built-in property types are: + + ARC + ATOM + BITMAP + CARDINAL + COLORMAP + CURSOR + DRAWABLE + FONT + INTEGER + PIXMAP + POINT + RGB_COLOR_MAP + RECTANGLE + STRING + VISUALID + WINDOW + WM_HINTS + WM_SIZE_HINTS + - - - - - - - - lw(2i) lw(2i). - - - ARC - POINT - - - ATOM - RGB_COLOR_MAP - - - BITMAP - RECTANGLE - - - CARDINAL - STRING - - - COLORMAP - VISUALID - - - CURSOR - WINDOW - - - DRAWABLE - WM_HINTS - - - FONT - WM_SIZE_HINTS - - - INTEGER - - - PIXMAP - - - - - - - The built-in font property names are: - - - - - - - lw(2i) lw(2i). - - - MIN_SPACE - STRIKEOUT_DESCENT - - - NORM_SPACE - STRIKEOUT_ASCENT - - - MAX_SPACE - ITALIC_ANGLE - - - END_SPACE - X_HEIGHT - - - SUPERSCRIPT_X - QUAD_WIDTH - - - SUPERSCRIPT_Y - WEIGHT - - - SUBSCRIPT_X - POINT_SIZE - - - SUBSCRIPT_Y - RESOLUTION - - - UNDERLINE_POSITION - COPYRIGHT - - - UNDERLINE_THICKNESS - NOTICE - - - FONT_NAME - FAMILY_NAME - - - FULL_NAME - CAP_HEIGHT - - - - + + MIN_SPACE + NORM_SPACE + MAX_SPACE + END_SPACE + SUPERSCRIPT_X + SUPERSCRIPT_Y + SUBSCRIPT_X + SUBSCRIPT_Y + UNDERLINE_POSITION + UNDERLINE_THICKNESS + FONT_NAME + FULL_NAME + + STRIKEOUT_DESCENT + STRIKEOUT_ASCENT + ITALIC_ANGLE + X_HEIGHT + QUAD_WIDTH + WEIGHT + POINT_SIZE + RESOLUTION + COPYRIGHT + NOTICE + FAMILY_NAME + CAP_HEIGHT + @@ -1549,7 +1412,7 @@ To obtain the type, format, and value of a property of a given window, use int XGetWindowProperty - \^display + display w property long_offset @@ -2105,7 +1968,7 @@ To rotate a window's property list, use XRotateWindowProperties Display *display Window w - Atom properties[]\^ + Atom properties[] int num_prop int npositions @@ -2176,7 +2039,7 @@ events. If the property names in the properties array are viewed as being numbered starting from zero and if there are num_prop property names in the list, then the value associated with property name I becomes the value associated -with property name (I + npositions) mod N for all I from zero to N \- 1. +with property name (I + npositions) mod N for all I from zero to N − 1. The effect is to rotate the states by npositions places around the virtual ring of property names (right for positive npositions, left for negative npositions). diff --git a/libX11/specs/libX11/CH05.xml b/libX11/specs/libX11/CH05.xml index d4a3ff1a0..08d78d666 100644 --- a/libX11/specs/libX11/CH05.xml +++ b/libX11/specs/libX11/CH05.xml @@ -1,3 +1,6 @@ + + Pixmap and Cursor Functions diff --git a/libX11/specs/libX11/CH06.xml b/libX11/specs/libX11/CH06.xml index 070898dd3..f60053b93 100644 --- a/libX11/specs/libX11/CH06.xml +++ b/libX11/specs/libX11/CH06.xml @@ -1,3 +1,6 @@ + + Color Management Functions @@ -77,9 +80,15 @@ Add new color spaces All functions, types, and symbols in this chapter with the prefix ``Xcms'' are defined in -<X11/Xcms.h>. +<X11/Xcms.h>. +X11/Xcms.h +Files<X11/Xcms.h> +Headers<X11/Xcms.h> The remaining functions and types are defined in -<X11/Xlib.h>. +<X11/Xlib.h>. +X11/Xlib.h +Files<X11/Xlib.h> +Headers<X11/Xlib.h> @@ -1994,9 +2003,6 @@ pixels_return array. - -delim %% - The XAllocColorCells function allocates read/write color cells. @@ -2010,7 +2016,8 @@ and nplane plane masks are returned. No mask will have any bits set to 1 in common with any other mask or with any of the pixels. By ORing together each pixel with zero or more masks, -ncolors * %2 sup nplanes% distinct pixels can be produced. +ncolors × 2nplanes +distinct pixels can be produced. All of these are allocated writable by the request. For @@ -2197,9 +2204,6 @@ Return bit masks for the red, green, and blue planes. - -delim %% - The specified ncolors must be positive; and nreds, ngreens, and nblues must be nonnegative, or a @@ -2220,12 +2224,17 @@ each mask will lie within the corresponding pixel subfield. By ORing together subsets of masks with each pixel value, -ncolors * %2 sup (nreds+ngreens+nblues)% distinct pixel values can be produced. +ncolors × 2(nreds+ngreens+nblues) +distinct pixel values can be produced. All of these are allocated by the request. However, in the -colormap, there are only ncolors * %2 sup nreds% independent red entries, -ncolors * %2 sup ngreens% independent green entries, -and ncolors * %2 sup nblues% independent blue entries. +colormap, there are only +ncolors × 2nreds +independent red entries, +ncolors × 2ngreens +independent green entries, and +ncolors × 2nblues +independent blue entries. This is true even for PseudoColor. When the colormap entry of a pixel diff --git a/libX11/specs/libX11/CH07.xml b/libX11/specs/libX11/CH07.xml index ae977b365..14d4bd4ed 100644 --- a/libX11/specs/libX11/CH07.xml +++ b/libX11/specs/libX11/CH07.xml @@ -1,3 +1,6 @@ + + Graphics Context Functions @@ -269,7 +272,10 @@ is typically the most useful because it will work on a color display, but special applications may use other functions, particularly in concert with particular planes of a color display. The 16 GC functions, defined in -<X11/X.h>, +<X11/X.h>, +X11/X.h +Files<X11/X.h> +Headers<X11/X.h> are: @@ -962,10 +968,10 @@ depth of drawable, use GC XCreateGC - Display *display + Display *display Drawable d unsignedlong valuemask - XGCValues *\^values + XGCValues *values @@ -1139,7 +1145,7 @@ To change the components in a given GC, use Display *display GC gc unsignedlong valuemask - XGCValues *\^values + XGCValues *values @@ -1976,7 +1982,7 @@ To set the dash-offset and dash-list for dashed line styles of a given GC, use Display *display GC gc int dash_offset - char dash_list[]\^ + char dash_list[] int n @@ -2074,7 +2080,7 @@ are only required to match this ideal for horizontal and vertical lines. Failing the ideal semantics, it is suggested that the length be measured along the major axis of the line. The major axis is defined as the x axis for lines drawn at an angle of between -\-45 and +45 degrees or between 135 and 225 degrees from the x axis. +−45 and +45 degrees or between 135 and 225 degrees from the x axis. For all other lines, the major axis is the y axis. @@ -3037,7 +3043,7 @@ To set the clip-mask of a given GC to the specified list of rectangles, use Display *display GC gc intclip_x_origin, clip_y_origin - XRectangle rectangles[]\^ + XRectangle rectangles[] int n int ordering diff --git a/libX11/specs/libX11/CH08.xml b/libX11/specs/libX11/CH08.xml index d1e0b36d5..de768f448 100644 --- a/libX11/specs/libX11/CH08.xml +++ b/libX11/specs/libX11/CH08.xml @@ -1,3 +1,6 @@ + + Graphics Functions @@ -3341,7 +3344,10 @@ if the property was not defined or if it was defined. A set of predefined atoms exists for font properties, which can be found in -<X11/Xatom.h>. +<X11/Xatom.h>. +X11/Xatom.h +Files<X11/Xatom.h> +Headers<X11/Xatom.h> This set contains the standard properties associated with a font. Although it is not guaranteed, diff --git a/libX11/specs/libX11/CH09.xml b/libX11/specs/libX11/CH09.xml index 60bf08e68..bcb7366fd 100644 --- a/libX11/specs/libX11/CH09.xml +++ b/libX11/specs/libX11/CH09.xml @@ -1,3 +1,6 @@ + + Window and Session Manager Functions @@ -1102,7 +1105,7 @@ or Timeout and interval are specified in seconds. A timeout of 0 disables the screen saver (but an activated screen saver is not deactivated), -and a timeout of \-1 restores the default. +and a timeout of −1 restores the default. Other negative values generate a BadValue error. diff --git a/libX11/specs/libX11/CH10.xml b/libX11/specs/libX11/CH10.xml index e00b517e7..d94ff212b 100644 --- a/libX11/specs/libX11/CH10.xml +++ b/libX11/specs/libX11/CH10.xml @@ -1,3 +1,6 @@ + + Events @@ -58,7 +61,10 @@ events are always sent to all clients. An event type describes a specific event generated by the X server. For each event type, a corresponding constant name is defined in -<X11/X.h>, +<X11/X.h>, +X11/X.h +Files<X11/X.h> +Headers<X11/X.h> which is used when referring to an event type. Eventcategories The following table lists the event category @@ -171,7 +177,10 @@ The processing associated with these events is discussed in section 10.5. For each event type, a corresponding structure is declared in -<X11/Xlib.h>. +<X11/Xlib.h>. +X11/Xlib.h +Files<X11/Xlib.h> +Headers<X11/Xlib.h> All the event structures have the following common members: @@ -313,7 +322,10 @@ Clients select event reporting of most events relative to a window. To do this, pass an event mask to an Xlib event-handling function that takes an event_mask argument. The bits of the event mask are defined in -<X11/X.h>. +<X11/X.h>. +X11/X.h +Files<X11/X.h> +Headers<X11/X.h> Each bit in the event mask maps to an event mask name, which describes the event or events you want the X server to return to a client application. @@ -1052,8 +1064,7 @@ masks bits in the event-mask attribute of the window. -Button1MotionMask \ \- -Button5MotionMask +Button1MotionMask - Button5MotionMask @@ -2932,7 +2943,10 @@ a call to XCopyPlane initiated the request. These constants are defined in -<X11/Xproto.h>. +<X11/Xproto.h>. +X11/Xproto.h +Files<X11/Xproto.h> +Headers<X11/Xproto.h> The minor_code member, like the major_code member, indicates which graphics request was initiated by diff --git a/libX11/specs/libX11/CH11.xml b/libX11/specs/libX11/CH11.xml index 2cfae3aad..c8031649a 100644 --- a/libX11/specs/libX11/CH11.xml +++ b/libX11/specs/libX11/CH11.xml @@ -1,3 +1,6 @@ + + Event Handling Functions @@ -2436,7 +2439,7 @@ the major request protocol number is used for the message argument. For an extension request, the extension name (as given by InitExtension) -followed by a period (\.) and the minor request protocol number +followed by a period (.) and the minor request protocol number is used for the message argument. If no string is found in the error database, the default_string is returned to the buffer argument. diff --git a/libX11/specs/libX11/CH12.xml b/libX11/specs/libX11/CH12.xml index dabf2b04b..bfde8d927 100644 --- a/libX11/specs/libX11/CH12.xml +++ b/libX11/specs/libX11/CH12.xml @@ -1,3 +1,6 @@ + + Input Device Functions @@ -3035,14 +3038,20 @@ standards. In areas where no standards exist, some of these sets are derived from Digital Equipment Corporation standards. The list of defined symbols can be found in -<X11/keysymdef.h>. +<X11/keysymdef.h>. +X11/keysymdef.h +Files<X11/keysymdef.h> +Headers<X11/keysymdef.h> Unfortunately, some C preprocessors have limits on the number of defined symbols. If you must use KeySyms not in the Latin 1-4, Greek, and miscellaneous classes, you may have to define a symbol for those sets. Most applications usually only include -<X11/keysym.h>, +<X11/keysym.h>, +X11/keysym.h +Files<X11/keysym.h> +Headers<X11/keysym.h> which defines symbols for ISO Latin 1-4, Greek, and miscellaneous. diff --git a/libX11/specs/libX11/CH13.xml b/libX11/specs/libX11/CH13.xml index f7809f665..be0918adb 100644 --- a/libX11/specs/libX11/CH13.xml +++ b/libX11/specs/libX11/CH13.xml @@ -1,3 +1,6 @@ + + Locales and Internationalized Text Functions diff --git a/libX11/specs/libX11/CH14.xml b/libX11/specs/libX11/CH14.xml index 4221e9b01..9bfbc4f1b 100644 --- a/libX11/specs/libX11/CH14.xml +++ b/libX11/specs/libX11/CH14.xml @@ -1,3 +1,6 @@ + + Inter-Client Communication Functions @@ -40,7 +43,7 @@ managers are: - WM_CLASS + WM_CLASS STRING 8 Set by application programs to allow @@ -50,7 +53,7 @@ managers are: - WM_CLIENT_MACHINE + WM_CLIENT_MACHINE TEXT The string name of the machine on @@ -59,7 +62,7 @@ managers are: - WM_COLORMAP_WINDOWS + WM_COLORMAP_WINDOWS WINDOWS 32 The list of window IDs that may @@ -68,7 +71,7 @@ managers are: - WM_COMMAND + WM_COMMAND TEXT The command and arguments, null- @@ -76,8 +79,8 @@ managers are: - WM_HINTS - WM_HINTS + WM_HINTS + WM_HINTS 32 Additional hints set by the client for use by the window manager. The C @@ -85,14 +88,14 @@ managers are: - WM_ICON_NAME + WM_ICON_NAME TEXT The name to be used in an icon. - WM_ICON_SIZE - WM_ICON_SIZE + WM_ICON_SIZE + WM_ICON_SIZE 32 The window manager may set this property on the root window to @@ -102,14 +105,14 @@ managers are: - WM_NAME + WM_NAME TEXT The name of the application. - WM_NORMAL_HINTS - WM_NORMAL_HINTS + WM_NORMAL_HINTS + WM_NORMAL_HINTS 32 Size hints for a window in its normal state. The C type of this @@ -117,7 +120,7 @@ managers are: - WM_PROTOCOLS + WM_PROTOCOLS ATOM 32 List of atoms that identify the @@ -127,8 +130,8 @@ managers are: - WM_STATE - WM_STATE + WM_STATE + WM_STATE 32 Intended for communication between window and session man- @@ -136,7 +139,7 @@ managers are: - WM_TRANSIENT_FOR + WM_TRANSIENT_FOR WINDOW 32 Set by application programs to @@ -186,47 +189,47 @@ Set and read text properties -Set and read the WM_NAME property +Set and read the WM_NAME property -Set and read the WM_ICON_NAME property +Set and read the WM_ICON_NAME property -Set and read the WM_HINTS property +Set and read the WM_HINTS property -Set and read the WM_NORMAL_HINTS property +Set and read the WM_NORMAL_HINTS property -Set and read the WM_CLASS property +Set and read the WM_CLASS property -Set and read the WM_TRANSIENT_FOR property +Set and read the WM_TRANSIENT_FOR property -Set and read the WM_PROTOCOLS property +Set and read the WM_PROTOCOLS property -Set and read the WM_COLORMAP_WINDOWS property +Set and read the WM_COLORMAP_WINDOWS property -Set and read the WM_ICON_SIZE property +Set and read the WM_ICON_SIZE property @@ -303,7 +306,7 @@ Specifies the appropriate screen number on the host server. The XIconifyWindow -function sends a WM_CHANGE_STATE +function sends a WM_CHANGE_STATE ClientMessage event with a format of 32 and a first data element of IconicState @@ -317,7 +320,7 @@ with an event mask set to Window managers may elect to receive this message and if the window is in its normal state, may treat it as a request to change the window's state from normal to iconic. -If the WM_CHANGE_STATE property cannot be interned, +If the WM_CHANGE_STATE property cannot be interned, XIconifyWindow does not send a message and returns a zero status. It returns a nonzero status if the client message is sent successfully; @@ -1173,7 +1176,7 @@ and the missing charset list allocated by Xlib provides two functions that you can use to set and read the text properties for a given window. You can use these functions to set and read those properties of type TEXT -(WM_NAME, WM_ICON_NAME, WM_COMMAND, and WM_CLIENT_MACHINE). +(WM_NAME, WM_ICON_NAME, WM_COMMAND, and WM_CLIENT_MACHINE). In addition, Xlib provides separate convenience functions that you can use to set each of these properties. @@ -1382,12 +1385,12 @@ errors. Xlib provides convenience functions that you can use to set and read -the WM_NAME property for a given window. +the WM_NAME property for a given window. -To set a window's WM_NAME property with the supplied convenience function, use +To set a window's WM_NAME property with the supplied convenience function, use XSetWMName. XSetWMName @@ -1442,12 +1445,12 @@ The XSetWMName convenience function calls XSetTextProperty -to set the WM_NAME property. +to set the WM_NAME property. -To read a window's WM_NAME property with the supplied convenience function, use +To read a window's WM_NAME property with the supplied convenience function, use XGetWMName. XGetWMName @@ -1502,7 +1505,7 @@ The XGetWMName convenience function calls XGetTextProperty -to obtain the WM_NAME property. +to obtain the WM_NAME property. It returns a nonzero status on success; otherwise, it returns a zero status. @@ -1649,7 +1652,7 @@ If it succeeds, it returns a nonzero status; otherwise, no name has been set for the window, and it returns zero. -If the WM_NAME property has not been set for this window, +If the WM_NAME property has not been set for this window, XFetchName sets window_name_return to NULL. If the data returned by the server is in the Latin Portable Character Encoding, @@ -1675,12 +1678,12 @@ error. Xlib provides convenience functions that you can use to set and read -the WM_ICON_NAME property for a given window. +the WM_ICON_NAME property for a given window. -To set a window's WM_ICON_NAME property, +To set a window's WM_ICON_NAME property, use XSetWMIconName. XSetWMIconName @@ -1736,12 +1739,12 @@ The XSetWMIconName convenience function calls XSetTextProperty -to set the WM_ICON_NAME property. +to set the WM_ICON_NAME property. -To read a window's WM_ICON_NAME property, +To read a window's WM_ICON_NAME property, use XGetWMIconName. XGetWMIconName @@ -1797,7 +1800,7 @@ The XGetWMIconName convenience function calls XGetTextProperty -to obtain the WM_ICON_NAME property. +to obtain the WM_ICON_NAME property. It returns a nonzero status on success; otherwise, it returns a zero status. @@ -1960,11 +1963,14 @@ error. Xlib provides functions that you can use to set and read -the WM_HINTS property for a given window. +the WM_HINTS property for a given window. These functions use the flags and the XWMHints structure, as defined in the -<X11/Xutil.h> +<X11/Xutil.h> +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> header file. @@ -2113,7 +2119,7 @@ or the window to be withdrawn. -To set a window's WM_HINTS property, use +To set a window's WM_HINTS property, use XSetWMHints. XSetWMHints @@ -2182,7 +2188,7 @@ errors. -To read a window's WM_HINTS property, use +To read a window's WM_HINTS property, use XGetWMHints. XGetWMHints @@ -2223,7 +2229,7 @@ Specifies the window. The XGetWMHints function reads the window manager hints and -returns NULL if no WM_HINTS property was set on the window +returns NULL if no WM_HINTS property was set on the window or returns a pointer to an XWMHints structure if it succeeds. @@ -2247,11 +2253,14 @@ error. Xlib provides functions that you can use to set or read -the WM_NORMAL_HINTS property for a given window. +the WM_NORMAL_HINTS property for a given window. The functions use the flags and the XSizeHints structure, as defined in the -<X11/Xutil.h> +<X11/Xutil.h> +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> header file. @@ -2376,7 +2385,7 @@ macro is highly discouraged. -To set a window's WM_NORMAL_HINTS property, use +To set a window's WM_NORMAL_HINTS property, use XSetWMNormalHints. XSetWMNormalHints @@ -2427,12 +2436,12 @@ Specifies the size hints for the window in its normal state. The XSetWMNormalHints -function replaces the size hints for the WM_NORMAL_HINTS property +function replaces the size hints for the WM_NORMAL_HINTS property on the specified window. If the property does not already exist, XSetWMNormalHints -sets the size hints for the WM_NORMAL_HINTS property on the specified window. -The property is stored with a type of WM_SIZE_HINTS and a format of 32. +sets the size hints for the WM_NORMAL_HINTS property on the specified window. +The property is stored with a type of WM_SIZE_HINTS and a format of 32. @@ -2446,7 +2455,7 @@ errors. -To read a window's WM_NORMAL_HINTS property, use +To read a window's WM_NORMAL_HINTS property, use XGetWMNormalHints. XGetWMNormalHints @@ -2508,9 +2517,9 @@ Returns the hints that were supplied by the user. The XGetWMNormalHints -function returns the size hints stored in the WM_NORMAL_HINTS property +function returns the size hints stored in the WM_NORMAL_HINTS property on the specified window. -If the property is of type WM_SIZE_HINTS, is of format 32, +If the property is of type WM_SIZE_HINTS, is of format 32, and is long enough to contain either an old (pre-ICCCM) or new size hints structure, XGetWMNormalHints @@ -2557,7 +2566,7 @@ error. -To set a window's WM_SIZE_HINTS property, use +To set a window's WM_SIZE_HINTS property, use XSetWMSizeHints. XSetWMSizeHints @@ -2627,7 +2636,7 @@ If the specified property does not already exist, XSetWMSizeHints sets the size hints for the specified property on the named window. -The property is stored with a type of WM_SIZE_HINTS and a format of 32. +The property is stored with a type of WM_SIZE_HINTS and a format of 32. To set a window's normal size hints, you can use the XSetWMNormalHints @@ -2646,7 +2655,7 @@ errors. -To read a window's WM_SIZE_HINTS property, use +To read a window's WM_SIZE_HINTS property, use XGetWMSizeHints. XGetWMSizeHints @@ -2723,7 +2732,7 @@ The XGetWMSizeHints function returns the size hints stored in the specified property on the named window. -If the property is of type WM_SIZE_HINTS, is of format 32, +If the property is of type WM_SIZE_HINTS, is of format 32, and is long enough to contain either an old (pre-ICCCM) or new size hints structure, XGetWMSizeHints @@ -2783,11 +2792,14 @@ errors. Xlib provides functions that you can use to set and get -the WM_CLASS property for a given window. +the WM_CLASS property for a given window. These functions use the XClassHint structure, which is defined in the -<X11/Xutil.h> +<X11/Xutil.h> +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> header file. @@ -2847,19 +2859,19 @@ typedef struct { The res_name member contains the application name, and the res_class member contains the application class. -Note that the name set in this property may differ from the name set as WM_NAME. -That is, WM_NAME specifies what should be displayed in the title bar and, +Note that the name set in this property may differ from the name set as WM_NAME. +That is, WM_NAME specifies what should be displayed in the title bar and, therefore, can contain temporal information (for example, the name of a file currently in an editor's buffer). On the other hand, -the name specified as part of WM_CLASS is the formal name of the application +the name specified as part of WM_CLASS is the formal name of the application that should be used when retrieving the application's resources from the resource database. -To set a window's WM_CLASS property, use +To set a window's WM_CLASS property, use XSetClassHint. XSetClassHint @@ -2928,7 +2940,7 @@ errors. -To read a window's WM_CLASS property, use +To read a window's WM_CLASS property, use XGetClassHint. XGetClassHint @@ -3009,12 +3021,12 @@ error. Xlib provides functions that you can use to set and read -the WM_TRANSIENT_FOR property for a given window. +the WM_TRANSIENT_FOR property for a given window. -To set a window's WM_TRANSIENT_FOR property, use +To set a window's WM_TRANSIENT_FOR property, use XSetTransientForHint. XSetTransientForHint @@ -3054,7 +3066,7 @@ Specifies the window. -Specifies the window that the WM_TRANSIENT_FOR property is to be set to. +Specifies the window that the WM_TRANSIENT_FOR property is to be set to. @@ -3065,7 +3077,7 @@ Specifies the window that the WM_TRANSIENT_FOR property is to be set to. The XSetTransientForHint -function sets the WM_TRANSIENT_FOR property of the specified window to the +function sets the WM_TRANSIENT_FOR property of the specified window to the specified prop_window. @@ -3080,7 +3092,7 @@ errors. -To read a window's WM_TRANSIENT_FOR property, use +To read a window's WM_TRANSIENT_FOR property, use XGetTransientForHint. XGetTransientForHint @@ -3120,7 +3132,7 @@ Specifies the window. -Returns the WM_TRANSIENT_FOR property of the specified window. +Returns the WM_TRANSIENT_FOR property of the specified window. @@ -3131,7 +3143,7 @@ Returns the WM_TRANSIENT_FOR property of the specified window. The XGetTransientForHint -function returns the WM_TRANSIENT_FOR property for the specified window. +function returns the WM_TRANSIENT_FOR property for the specified window. It returns a nonzero status on success; otherwise, it returns a zero status. @@ -3151,12 +3163,12 @@ error. Xlib provides functions that you can use to set and read -the WM_PROTOCOLS property for a given window. +the WM_PROTOCOLS property for a given window. -To set a window's WM_PROTOCOLS property, use +To set a window's WM_PROTOCOLS property, use XSetWMProtocols. XSetWMProtocols @@ -3219,14 +3231,14 @@ Specifies the number of (Cn. The XSetWMProtocols -function replaces the WM_PROTOCOLS property on the specified window +function replaces the WM_PROTOCOLS property on the specified window with the list of atoms specified by the protocols argument. If the property does not already exist, XSetWMProtocols -sets the WM_PROTOCOLS property on the specified window +sets the WM_PROTOCOLS property on the specified window to the list of atoms specified by the protocols argument. The property is stored with a type of ATOM and a format of 32. -If it cannot intern the WM_PROTOCOLS atom, +If it cannot intern the WM_PROTOCOLS atom, XSetWMProtocols returns a zero status. Otherwise, it returns a nonzero status. @@ -3243,7 +3255,7 @@ errors. -To read a window's WM_PROTOCOLS property, use +To read a window's WM_PROTOCOLS property, use XGetWMProtocols. XGetWMProtocols @@ -3306,12 +3318,12 @@ Returns the number of (Cn. The XGetWMProtocols -function returns the list of atoms stored in the WM_PROTOCOLS property +function returns the list of atoms stored in the WM_PROTOCOLS property on the specified window. These atoms describe window manager protocols in which the owner of this window is willing to participate. If the property exists, is of type ATOM, is of format 32, -and the atom WM_PROTOCOLS can be interned, +and the atom WM_PROTOCOLS can be interned, XGetWMProtocols sets the protocols_return argument to a list of atoms, sets the count_return argument to the number of elements in the list, @@ -3337,12 +3349,12 @@ error. Xlib provides functions that you can use to set and read -the WM_COLORMAP_WINDOWS property for a given window. +the WM_COLORMAP_WINDOWS property for a given window. -To set a window's WM_COLORMAP_WINDOWS property, use +To set a window's WM_COLORMAP_WINDOWS property, use XSetWMColormapWindows. XSetWMColormapWindows @@ -3405,14 +3417,14 @@ Specifies the number of (Cn. The XSetWMColormapWindows -function replaces the WM_COLORMAP_WINDOWS property on the specified +function replaces the WM_COLORMAP_WINDOWS property on the specified window with the list of windows specified by the colormap_windows argument. If the property does not already exist, XSetWMColormapWindows -sets the WM_COLORMAP_WINDOWS property on the specified +sets the WM_COLORMAP_WINDOWS property on the specified window to the list of windows specified by the colormap_windows argument. The property is stored with a type of WINDOW and a format of 32. -If it cannot intern the WM_COLORMAP_WINDOWS atom, +If it cannot intern the WM_COLORMAP_WINDOWS atom, XSetWMColormapWindows returns a zero status. Otherwise, it returns a nonzero status. @@ -3429,7 +3441,7 @@ errors. -To read a window's WM_COLORMAP_WINDOWS property, use +To read a window's WM_COLORMAP_WINDOWS property, use XGetWMColormapWindows. XGetWMColormapWindows @@ -3493,11 +3505,11 @@ Returns the number of (Cn. The XGetWMColormapWindows function returns the list of window identifiers stored -in the WM_COLORMAP_WINDOWS property on the specified window. +in the WM_COLORMAP_WINDOWS property on the specified window. These identifiers indicate the colormaps that the window manager may need to install for this window. If the property exists, is of type WINDOW, is of format 32, -and the atom WM_COLORMAP_WINDOWS can be interned, +and the atom WM_COLORMAP_WINDOWS can be interned, XGetWMColormapWindows sets the windows_return argument to a list of window identifiers, sets the count_return argument to the number of elements in the list, @@ -3523,12 +3535,15 @@ error. Xlib provides functions that you can use to set and read -the WM_ICON_SIZE property for a given window. +the WM_ICON_SIZE property for a given window. These functions use the XIconSize XIconSize structure, which is defined in the -<X11/Xutil.h> +<X11/Xutil.h> +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> header file. @@ -3591,7 +3606,7 @@ sizes (minimum to maximum) that represent the supported icon sizes. -To set a window's WM_ICON_SIZE property, use +To set a window's WM_ICON_SIZE property, use XSetIconSizes. XSetIconSizes @@ -3667,7 +3682,7 @@ errors. -To read a window's WM_ICON_SIZE property, use +To read a window's WM_ICON_SIZE property, use XGetIconSizes. XGetIconSizes @@ -3764,8 +3779,8 @@ function stores the standard set of window manager properties, with text properties in standard encodings for internationalized text communication. The standard window manager properties for a given window are -WM_NAME, WM_ICON_NAME, WM_HINTS, WM_NORMAL_HINTS, WM_CLASS, -WM_COMMAND, WM_CLIENT_MACHINE, and WM_LOCALE_NAME. +WM_NAME, WM_ICON_NAME, WM_HINTS, WM_NORMAL_HINTS, WM_CLASS, +WM_COMMAND, WM_CLIENT_MACHINE, and WM_LOCALE_NAME. XmbSetWMProperties @@ -3896,10 +3911,10 @@ for communicating with other clients If the window_name argument is non-NULL, XmbSetWMProperties -sets the WM_NAME property. +sets the WM_NAME property. If the icon_name argument is non-NULL, XmbSetWMProperties -sets the WM_ICON_NAME property. +sets the WM_ICON_NAME property. The window_name and icon_name arguments are null-terminated strings in the encoding of the current locale. If the arguments can be fully converted to the STRING encoding, @@ -3913,18 +3928,18 @@ If the normal_hints argument is non-NULL, XmbSetWMProperties calls XSetWMNormalHints, -which sets the WM_NORMAL_HINTS property (see section 14.1.7). +which sets the WM_NORMAL_HINTS property (see section 14.1.7). If the wm_hints argument is non-NULL, XmbSetWMProperties calls XSetWMHints, -which sets the WM_HINTS property (see section 14.1.6). +which sets the WM_HINTS property (see section 14.1.6). If the argv argument is non-NULL, XmbSetWMProperties -sets the WM_COMMAND property from argv and argc. +sets the WM_COMMAND property from argv and argc. An argc of zero indicates a zero-length command. @@ -3937,7 +3952,7 @@ The hostname of the machine is stored using If the class_hints argument is non-NULL, XmbSetWMProperties -sets the WM_CLASS property. +sets the WM_CLASS property. If the res_name member in the XClassHint structure is set to the NULL pointer and the RESOURCE_NAME @@ -3954,7 +3969,7 @@ It is assumed that the supplied class_hints.res_name and argv, the RESOURCE_NAME environment variable, and the hostname of the machine are in the encoding of the locale announced for the LC_CTYPE category (on POSIX-compliant systems, the LC_CTYPE, else LANG environment variable). -The corresponding WM_CLASS, WM_COMMAND, and WM_CLIENT_MACHINE properties +The corresponding WM_CLASS, WM_COMMAND, and WM_CLIENT_MACHINE properties are typed according to the local host locale announcer. No encoding conversion is performed prior to storage in the properties. @@ -3962,7 +3977,7 @@ No encoding conversion is performed prior to storage in the properties. For clients that need to process the property text in a locale, XmbSetWMProperties -sets the WM_LOCALE_NAME property to be the name of the current locale. +sets the WM_LOCALE_NAME property to be the name of the current locale. The name is assumed to be in the Host Portable Character Encoding and is converted to STRING for storage in the property. @@ -3982,8 +3997,8 @@ To set a window's standard window manager properties with strings in client-specified encodings, use XSetWMProperties. The standard window manager properties for a given window are -WM_NAME, WM_ICON_NAME, WM_HINTS, WM_NORMAL_HINTS, WM_CLASS, -WM_COMMAND, and WM_CLIENT_MACHINE. +WM_NAME, WM_ICON_NAME, WM_HINTS, WM_NORMAL_HINTS, WM_CLASS, +WM_COMMAND, and WM_CLIENT_MACHINE. XSetWMProperties @@ -4116,17 +4131,17 @@ If the window_name argument is non-NULL, XSetWMProperties calls XSetWMName, -which, in turn, sets the WM_NAME property (see section 14.1.4). +which, in turn, sets the WM_NAME property (see section 14.1.4). If the icon_name argument is non-NULL, XSetWMProperties calls XSetWMIconName, -which sets the WM_ICON_NAME property (see section 14.1.5). +which sets the WM_ICON_NAME property (see section 14.1.5). If the argv argument is non-NULL, XSetWMProperties calls XSetCommand, -which sets the WM_COMMAND property (see section 14.2.1). +which sets the WM_COMMAND property (see section 14.2.1). Note that an argc of zero is allowed to indicate a zero-length command. Note also that the hostname of this machine is stored using XSetWMClientMachine @@ -4138,12 +4153,12 @@ If the normal_hints argument is non-NULL, XSetWMProperties calls XSetWMNormalHints, -which sets the WM_NORMAL_HINTS property (see section 14.1.7). +which sets the WM_NORMAL_HINTS property (see section 14.1.7). If the wm_hints argument is non-NULL, XSetWMProperties calls XSetWMHints, -which sets the WM_HINTS property (see section 14.1.6). +which sets the WM_HINTS property (see section 14.1.6). @@ -4151,7 +4166,7 @@ If the class_hints argument is non-NULL, XSetWMProperties calls XSetClassHint, -which sets the WM_CLASS property (see section 14.1.8). +which sets the WM_CLASS property (see section 14.1.8). If the res_name member in the XClassHint structure is set to the NULL pointer and the RESOURCE_NAME environment @@ -4186,12 +4201,12 @@ This section discusses how to: -Set and read the WM_COMMAND property +Set and read the WM_COMMAND property -Set and read the WM_CLIENT_MACHINE property +Set and read the WM_CLIENT_MACHINE property @@ -4203,12 +4218,12 @@ Set and read the WM_CLIENT_MACHINE property Xlib provides functions that you can use to set and read -the WM_COMMAND property for a given window. +the WM_COMMAND property for a given window. -To set a window's WM_COMMAND property, use +To set a window's WM_COMMAND property, use XSetCommand. XSetCommand @@ -4288,7 +4303,7 @@ errors. -To read a window's WM_COMMAND property, use +To read a window's WM_COMMAND property, use XGetCommand. XGetCommand @@ -4350,9 +4365,9 @@ Returns the number of arguments returned. The XGetCommand -function reads the WM_COMMAND property from the specified window +function reads the WM_COMMAND property from the specified window and returns a string list. -If the WM_COMMAND property exists, +If the WM_COMMAND property exists, it is of type STRING and format 8. If sufficient memory can be allocated to contain the string list, XGetCommand @@ -4374,12 +4389,12 @@ To free the memory allocated to the string list, use Xlib provides functions that you can use to set and read -the WM_CLIENT_MACHINE property for a given window. +the WM_CLIENT_MACHINE property for a given window. -To set a window's WM_CLIENT_MACHINE property, use +To set a window's WM_CLIENT_MACHINE property, use XSetWMClientMachine. XSetWMClientMachine @@ -4434,12 +4449,12 @@ The XSetWMClientMachine convenience function calls XSetTextProperty -to set the WM_CLIENT_MACHINE property. +to set the WM_CLIENT_MACHINE property. -To read a window's WM_CLIENT_MACHINE property, use +To read a window's WM_CLIENT_MACHINE property, use XGetWMClientMachine. XGetWMClientMachine @@ -4494,7 +4509,7 @@ The XGetWMClientMachine convenience function performs an XGetTextProperty -on the WM_CLIENT_MACHINE property. +on the WM_CLIENT_MACHINE property. It returns a nonzero status on success; otherwise, it returns a zero status. @@ -4772,7 +4787,10 @@ and each such property is identified by an atom. The following list names the atoms and describes the colormap associated with each one. The -<X11/Xatom.h> +<X11/Xatom.h> +X11/Xatom.h +Files<X11/Xatom.h> +Headers<X11/Xatom.h> header file contains the definitions for each of the following atoms, which are prefixed with XA_. diff --git a/libX11/specs/libX11/CH15.xml b/libX11/specs/libX11/CH15.xml index 844f1d204..753dff177 100644 --- a/libX11/specs/libX11/CH15.xml +++ b/libX11/specs/libX11/CH15.xml @@ -1,3 +1,6 @@ + + Resource Manager Functions @@ -123,7 +126,10 @@ value for that entry. The definitions for the resource manager are contained in -<X11/Xresource.h>. +<X11/Xresource.h>. +X11/Xresource.h +Files<X11/Xresource.h> +Headers<X11/Xresource.h> Resource File Syntax @@ -1484,9 +1490,6 @@ otherwise, they return - - - Most applications and toolkits do not make random probes into a resource database to fetch resources. The X toolkit access pattern for a resource database is quite stylized. @@ -1494,7 +1497,8 @@ A series of from 1 to 20 probes is made with only the last name/class differing in each probe. The XrmGetResource -function is at worst a %2 sup n% algorithm, +function is at worst a +2n algorithm, where n is the length of the name/class list. This can be improved upon by the application programmer by prefetching a list of database levels that might match the first part of a name/class list. @@ -1595,8 +1599,10 @@ otherwise, it returns The size of the search list that the caller must allocate is dependent upon the number of levels and wildcards in the resource specifiers that are stored in the database. -The worst case length is %3 sup n%, -where n is the number of name or class components in names or classes. +The worst case length is +3n, +where n is the number of name or class +components in names or classes. diff --git a/libX11/specs/libX11/CH16.xml b/libX11/specs/libX11/CH16.xml index c3751cc09..9c7bf8c01 100644 --- a/libX11/specs/libX11/CH16.xml +++ b/libX11/specs/libX11/CH16.xml @@ -1,3 +1,6 @@ + + Application Utility Functions @@ -394,7 +397,10 @@ Specifies the name of the KeySym that is to be converted. Standard KeySym names are obtained from -<X11/keysymdef.h> +<X11/keysymdef.h> +X11/keysymdef.h +Files<X11/keysymdef.h> +Headers<X11/keysymdef.h> by removing the XK_ prefix from each name. KeySyms that are not part of the Xlib standard also may be obtained with this function. @@ -792,7 +798,7 @@ use XRebindKeysym Display *display KeySym keysym - KeySym list[\^]\^ + KeySym list[ ] int mod_count unsignedchar *string int num_bytes @@ -1011,8 +1017,8 @@ Specifically, this function lets you parse strings of the form: The fields map into the arguments associated with this function. -(Items enclosed in <\^> are integers, items in [\^] are optional, and -items enclosed in {\^} indicate ``choose one of.'' +(Items enclosed in < > are integers, items in [ ] are optional, and +items enclosed in { } indicate ``choose one of.'' Note that the brackets should not appear in the actual string.) If the string is not in the Host Portable Character Encoding, the result is implementation-dependent. @@ -1024,7 +1030,7 @@ The function returns a bitmask that indicates which of the four values (width, height, xoffset, and yoffset) were actually found in the string and whether the x and y values are negative. -By convention, \-0 is not equal to +0, because the user needs to +By convention, −0 is not equal to +0, because the user needs to be able to say ``position the window relative to the right or bottom edge.'' For each value found, the corresponding argument is updated. For each value not found, the argument is left unchanged. @@ -1037,7 +1043,10 @@ The bits are represented by or YNegative and are defined in -<X11/Xutil.h>. +<X11/Xutil.h>. +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> They will be set whenever one of the values is defined or one of the signs is set. @@ -1196,7 +1205,7 @@ The function combines any geometry information (given in the format used by XParseGeometry) specified by the user and by the calling program with size hints -(usually the ones to be stored in WM_NORMAL_HINTS) and returns the position, +(usually the ones to be stored in WM_NORMAL_HINTS) and returns the position, size, and gravity (NorthWestGravity, NorthEastGravity, @@ -1239,7 +1248,10 @@ Xlib provides functions for manipulating regions. The opaque type Region is defined in -<X11/Xutil.h>. +<X11/Xutil.h>. +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> Xlib provides functions that you can use to manipulate regions. This section discusses how to: @@ -2144,7 +2156,7 @@ To store data in cut buffer 0, use XStoreBytes Display *display char *bytes - int \^nbytes + int nbytes @@ -2209,7 +2221,7 @@ To store data in a specified cut buffer, use XStoreBuffer Display *display char *bytes - int \^nbytes + int nbytes int buffer @@ -2456,7 +2468,10 @@ The functions in this section use the visual information masks and the XVisualInfo structure, which is defined in -<X11/Xutil.h> +<X11/Xutil.h> +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> and contains: @@ -2675,7 +2690,10 @@ All operations on images are defined using an XImage structure, as defined in -<X11/Xlib.h>. +<X11/Xlib.h>. +X11/Xlib.h +Files<X11/Xlib.h> +Headers<X11/Xlib.h> Because the number of different types of image formats can be very large, this hides details of image storage properly from applications. @@ -2900,7 +2918,10 @@ The basic functions used to get a pixel, set a pixel, create a subimage, and add a constant value to an image are defined in the image object. The functions in this section are really macro invocations of the functions in the image object and are defined in -<X11/Xutil.h>. +<X11/Xutil.h>. +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> @@ -3180,7 +3201,7 @@ use XDestroyImage - XImage *\^ximage + XImage *ximage @@ -3400,7 +3421,7 @@ when finished. If name_x_hot and name_y_hot exist, XReadBitmapFile returns them to x_hot_return and y_hot_return; -otherwise, it returns \-1,\-1. +otherwise, it returns −1,−1. @@ -3597,7 +3618,7 @@ Specify the width and height. -Specify where to place the hotspot coordinates (or \-1,\-1 if none are present) +Specify where to place the hotspot coordinates (or −1,−1 if none are present) in the file. @@ -3623,7 +3644,7 @@ returns otherwise, on no error, it returns BitmapSuccess. -If x_hot and y_hot are not \-1, \-1, +If x_hot and y_hot are not −1, −1, XWriteBitmapFile writes them out as the hotspot coordinates for the bitmap. @@ -3909,7 +3930,10 @@ Xlib provides context management functions with which you can save data values, get data values, delete entries, and create a unique context type. The symbols used are in -<X11/Xutil.h>. +<X11/Xutil.h>. +X11/Xutil.h +Files<X11/Xutil.h> +Headers<X11/Xutil.h> diff --git a/libX11/specs/libX11/credits.xml b/libX11/specs/libX11/credits.xml index 17713d3cb..13c8c055e 100644 --- a/libX11/specs/libX11/credits.xml +++ b/libX11/specs/libX11/credits.xml @@ -1,3 +1,6 @@ + + Acknowledgments diff --git a/libX11/specs/libX11/glossary.xml b/libX11/specs/libX11/glossary.xml index 4202e9a9d..6f909b2b0 100644 --- a/libX11/specs/libX11/glossary.xml +++ b/libX11/specs/libX11/glossary.xml @@ -1,3 +1,6 @@ + + Glossary @@ -1065,12 +1068,10 @@ displayed. Pixmap Pixmap - - A pixmap is a three-dimensional array of bits. A pixmap is normally thought of as a two-dimensional array of pixels, -where each pixel can be a value from 0 to %2 sup N %\-1, +where each pixel can be a value from 0 to 2N-1, and where N is the depth (z axis) of the pixmap. A pixmap can also be thought of as a stack of N bitmaps. A pixmap can only be used on the screen that it was created in. @@ -1667,19 +1668,11 @@ Manipulation of windows on the screen and much of the user interface A basic set of 97 characters which are assumed to exist in all locales supported by Xlib. This set contains the following characters: - - - - - - - + a..z A..Z 0..9 !"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~ <space>, <tab>, and <newline> - - - + This is the left/lower half (also called the G0 set) diff --git a/libX11/specs/libX11/libX11.xml b/libX11/specs/libX11/libX11.xml index 40a1d95ec..50da9e620 100644 --- a/libX11/specs/libX11/libX11.xml +++ b/libX11/specs/libX11/libX11.xml @@ -2,7 +2,7 @@ - + Xlib - C Language X Interface -- cgit v1.2.3