diff options
72 files changed, 208 insertions, 109 deletions
diff --git a/man/XAddConnectionWatch.man b/man/XAddConnectionWatch.man index f34b12f8..7dc66eef 100644 --- a/man/XAddConnectionWatch.man +++ b/man/XAddConnectionWatch.man @@ -81,10 +81,12 @@ Specifies the procedure to be called. The .B XAddConnectionWatch function registers a procedure to be called each time Xlib opens or closes an -internal connection for the specified display. The procedure is passed the +internal connection for the specified display. +The procedure is passed the display, the specified client_data, the file descriptor for the connection, a Boolean indicating whether the connection is being opened or closed, and a -pointer to a location for private watch data. If opening is +pointer to a location for private watch data. +If opening is .BR True , the procedure can store a pointer to private data in the location pointed to by watch_data; diff --git a/man/XAddHost.man b/man/XAddHost.man index 4bb93b4f..03b9fd4d 100644 --- a/man/XAddHost.man +++ b/man/XAddHost.man @@ -257,8 +257,10 @@ typedef struct { .EE .LP The type and value members point to strings representing the type and value of -the server interpreted entry. These strings may not be NULL-terminated so care -should be used when accessing them. The typelength and valuelength members +the server interpreted entry. +These strings may not be NULL-terminated so care +should be used when accessing them. +The typelength and valuelength members specify the length in byte of the type and value strings. .SH DIAGNOSTICS .TP 1i @@ -270,7 +272,8 @@ to modify the access control list from other than the local .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XFree(__libmansuffix__) diff --git a/man/XAllocColor.man b/man/XAllocColor.man index 1a669079..d7ff5e98 100644 --- a/man/XAllocColor.man +++ b/man/XAllocColor.man @@ -343,7 +343,8 @@ A value for a Colormap argument does not name a defined Colormap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCreateColormap(__libmansuffix__), diff --git a/man/XAllocWMHints.man b/man/XAllocWMHints.man index 22ebb227..c27b2567 100644 --- a/man/XAllocWMHints.man +++ b/man/XAllocWMHints.man @@ -288,9 +288,11 @@ rather than just the one window. The .B UrgencyHint flag, if set in the flags field, indicates that the client deems the window -contents to be urgent, requiring the timely response of the user. The +contents to be urgent, requiring the timely response of the user. +The window manager will make some effort to draw the user's attention to this -window while this flag is set. The client must provide some means by which the +window while this flag is set. +The client must provide some means by which the user can cause the urgency flag to be cleared (either mitigating the condition that made the window urgent or merely shutting off the alarm) or the window to be withdrawn. diff --git a/man/XAllowEvents.man b/man/XAllowEvents.man index 4b958039..3f1ee9ef 100644 --- a/man/XAllowEvents.man +++ b/man/XAllowEvents.man @@ -89,7 +89,8 @@ error. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" \fI\*(xL\fP diff --git a/man/XChangeKeyboardControl.man b/man/XChangeKeyboardControl.man index 5acf4aeb..d1b1775b 100644 --- a/man/XChangeKeyboardControl.man +++ b/man/XChangeKeyboardControl.man @@ -341,7 +341,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XChangeKeyboardMapping(__libmansuffix__), diff --git a/man/XChangeKeyboardMapping.man b/man/XChangeKeyboardMapping.man index cdc066e6..f9305182 100644 --- a/man/XChangeKeyboardMapping.man +++ b/man/XChangeKeyboardMapping.man @@ -341,7 +341,8 @@ The server failed to allocate the requested resource or server memory. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XFree(__libmansuffix__), diff --git a/man/XChangePointerControl.man b/man/XChangePointerControl.man index 718a40a4..871d3285 100644 --- a/man/XChangePointerControl.man +++ b/man/XChangePointerControl.man @@ -114,7 +114,8 @@ and acceleration threshold. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" \fI\*(xL\fP diff --git a/man/XChangeSaveSet.man b/man/XChangeSaveSet.man index b2ae79b1..0b7df0c5 100644 --- a/man/XChangeSaveSet.man +++ b/man/XChangeSaveSet.man @@ -121,7 +121,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XChangeWindowAttributes.man b/man/XChangeWindowAttributes.man index 65573c48..395920f1 100644 --- a/man/XChangeWindowAttributes.man +++ b/man/XChangeWindowAttributes.man @@ -294,7 +294,8 @@ A value for a Pixmap argument does not name a defined Pixmap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XClearArea.man b/man/XClearArea.man index 1a538934..64759c4c 100644 --- a/man/XClearArea.man +++ b/man/XClearArea.man @@ -151,7 +151,8 @@ window is used as a Drawable. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XConfigureWindow.man b/man/XConfigureWindow.man index f7e617ca..dff2371b 100644 --- a/man/XConfigureWindow.man +++ b/man/XConfigureWindow.man @@ -342,7 +342,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XCopyArea.man b/man/XCopyArea.man index 369992ef..25f9ed9b 100644 --- a/man/XCopyArea.man +++ b/man/XCopyArea.man @@ -203,7 +203,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XClearArea(__libmansuffix__) diff --git a/man/XCreateColormap.man b/man/XCreateColormap.man index 1678f945..b9004c55 100644 --- a/man/XCreateColormap.man +++ b/man/XCreateColormap.man @@ -254,7 +254,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XCreateFontCursor.man b/man/XCreateFontCursor.man index 552e45be..587d1cfd 100644 --- a/man/XCreateFontCursor.man +++ b/man/XCreateFontCursor.man @@ -212,7 +212,8 @@ A value for a Pixmap argument does not name a defined Pixmap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XDefineCursor(__libmansuffix__), diff --git a/man/XCreateGC.man b/man/XCreateGC.man index c9c1eacf..3f391a5a 100644 --- a/man/XCreateGC.man +++ b/man/XCreateGC.man @@ -1034,7 +1034,8 @@ A value for a Pixmap argument does not name a defined Pixmap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" AllPlanes(__libmansuffix__), diff --git a/man/XCreatePixmap.man b/man/XCreatePixmap.man index 93e8d994..39c1c390 100644 --- a/man/XCreatePixmap.man +++ b/man/XCreatePixmap.man @@ -127,7 +127,8 @@ A value for a Pixmap argument does not name a defined Pixmap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCopyArea(__libmansuffix__) diff --git a/man/XCreateWindow.man b/man/XCreateWindow.man index aa8f58e6..2585cc4a 100644 --- a/man/XCreateWindow.man +++ b/man/XCreateWindow.man @@ -382,7 +382,8 @@ A value for a Pixmap argument does not name a defined Pixmap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XDrawArc.man b/man/XDrawArc.man index ec7c7520..fcb67b5a 100644 --- a/man/XDrawArc.man +++ b/man/XDrawArc.man @@ -138,7 +138,8 @@ corresponding to the tangent of the circle/ellipse at the endpoint. For an arc specified as % [ ~x, ~y, ~width, ~height, ~angle1, ~angle2 ]%, the angles must be specified in the effectively skewed coordinate system of the ellipse (for a -circle, the angles and coordinate systems are identical). The +circle, the angles and coordinate systems are identical). +The relationship between these angles and angles expressed in the normal coordinate system of the screen (as measured with a protractor) is as follows: diff --git a/man/XDrawLine.man b/man/XDrawLine.man index 2d985340..0ca10e86 100644 --- a/man/XDrawLine.man +++ b/man/XDrawLine.man @@ -202,7 +202,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XDrawArc(__libmansuffix__), diff --git a/man/XDrawPoint.man b/man/XDrawPoint.man index dd75b692..7b028c2c 100644 --- a/man/XDrawPoint.man +++ b/man/XDrawPoint.man @@ -146,7 +146,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XDrawArc(__libmansuffix__), diff --git a/man/XFillRectangle.man b/man/XFillRectangle.man index 06b91dcd..042d106c 100644 --- a/man/XFillRectangle.man +++ b/man/XFillRectangle.man @@ -289,7 +289,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XDrawArc(__libmansuffix__), diff --git a/man/XGetEventData.man b/man/XGetEventData.man index 09e7c430..393ee53e 100644 --- a/man/XGetEventData.man +++ b/man/XGetEventData.man @@ -58,7 +58,8 @@ Some extension require additional memory to store information. For these events, the library returns a .B XGenericEventCookie -with a token ('cookie') unique to this event. The +with a token ('cookie') unique to this event. +The .BR XGenericEventCookie 's data pointer is undefined until .B XGetEventData @@ -66,16 +67,20 @@ is called. The .B XGetEventData -function retrieves this extra data for the given cookie. No round-trip to -the server is required. If the cookie is invalid or the +function retrieves this extra data for the given cookie. +No round-trip to +the server is required. +If the cookie is invalid or the event is not an event handled by cookie handlers, .B False -is returned. If +is returned. +If .B XGetEventData returns .BR True , the cookie's data pointer points to the memory containing the event -information. A client must call +information. +A client must call .B XFreeEventData to free this memory. .B XGetEventData @@ -85,7 +90,8 @@ for multiple calls for the same event cookie. The .B XFreeEventData -function frees the data associated with a cookie. A client must call +function frees the data associated with a cookie. +A client must call .B XFreeEventData for each cookie claimed with .BR XGetEventData . diff --git a/man/XGetWindowAttributes.man b/man/XGetWindowAttributes.man index 7b9a36bf..47357af1 100644 --- a/man/XGetWindowAttributes.man +++ b/man/XGetWindowAttributes.man @@ -96,7 +96,8 @@ The .B XGetWindowAttributes function returns the current attributes for the specified window to an .B XWindowAttributes -structure. It returns a nonzero status on success; otherwise, it returns a +structure. +It returns a nonzero status on success; otherwise, it returns a zero status. .LP .B XGetWindowAttributes diff --git a/man/XGetWindowProperty.man b/man/XGetWindowProperty.man index be05d428..70df3249 100644 --- a/man/XGetWindowProperty.man +++ b/man/XGetWindowProperty.man @@ -119,9 +119,11 @@ Specifies the rotation amount. .IP \fIprop_return\fP 1i Returns the data in the specified format. If the returned format is 8, the returned data is represented as a -char array. If the returned format is 16, the returned data is +char array. +If the returned format is 16, the returned data is represented as a array of short int type and should be cast to that -type to obtain the elements. If the returned format is 32, the +type to obtain the elements. +If the returned format is 32, the property data will be stored as an array of longs (which in a 64-bit application will be 64-bit values that are padded in the upper 4 bytes). .IP \fIproperty\fP 1i @@ -369,7 +371,8 @@ A value for an Atom argument does not name a defined Atom. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XGetXCBConnection.man b/man/XGetXCBConnection.man index 940030bc..9c3696a1 100644 --- a/man/XGetXCBConnection.man +++ b/man/XGetXCBConnection.man @@ -32,7 +32,8 @@ xcb_connection_t *XGetXCBConnection(Display *\fIdpy\fP); Specifies the connection to the X server. .SH DESCRIPTION The \fIXGetXCBConnection\fP function returns the XCB connection associated with -an Xlib Display. Clients can use this XCB connection with functions from the +an Xlib Display. +Clients can use this XCB connection with functions from the XCB library, just as they would with an XCB connection created with XCB. Callers of this function must link to libX11-xcb and a version of Xlib built with XCB support. diff --git a/man/XGrabButton.man b/man/XGrabButton.man index 65260d2e..0244961a 100644 --- a/man/XGrabButton.man +++ b/man/XGrabButton.man @@ -203,7 +203,8 @@ A value for a Cursor argument does not name a defined Cursor. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XGrabKey.man b/man/XGrabKey.man index 3ba990f9..2bc231fb 100644 --- a/man/XGrabKey.man +++ b/man/XGrabKey.man @@ -190,7 +190,8 @@ to grab a key/button combination already grabbed by another client. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XGrabKeyboard.man b/man/XGrabKeyboard.man index 13e2f26a..60cad668 100644 --- a/man/XGrabKeyboard.man +++ b/man/XGrabKeyboard.man @@ -189,7 +189,8 @@ active keyboard grab becomes not viewable. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XGrabPointer.man b/man/XGrabPointer.man index f72aebab..fb10a6a5 100644 --- a/man/XGrabPointer.man +++ b/man/XGrabPointer.man @@ -257,7 +257,8 @@ A value for a Cursor argument does not name a defined Cursor. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XIconifyWindow.man b/man/XIconifyWindow.man index 2a0adc44..29908669 100644 --- a/man/XIconifyWindow.man +++ b/man/XIconifyWindow.man @@ -145,7 +145,8 @@ errors. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XInitImage.man b/man/XInitImage.man index c624e26d..beb6b0ee 100644 --- a/man/XInitImage.man +++ b/man/XInitImage.man @@ -136,7 +136,8 @@ Image structures created or returned by Xlib do not need to be initialized in this fashion. .LP This function returns a nonzero status if initialization of the -structure is successful. It returns zero if it detected some error +structure is successful. +It returns zero if it detected some error or inconsistency in the structure, in which case the image is not changed. .LP The diff --git a/man/XInitThreads.man b/man/XInitThreads.man index 8c5a6de3..4ae95228 100644 --- a/man/XInitThreads.man +++ b/man/XInitThreads.man @@ -70,7 +70,8 @@ successful; otherwise, it returns zero. On systems that do not support threads, this function always returns zero. .LP It is only necessary to call this function if multiple threads -might use Xlib concurrently. If all calls to Xlib functions +might use Xlib concurrently. +If all calls to Xlib functions are protected by some other access mechanism (for example, a mutual exclusion lock in a toolkit or through explicit client programming), Xlib thread initialization is not required. diff --git a/man/XInternAtom.man b/man/XInternAtom.man index 1340a390..6cd6374d 100644 --- a/man/XInternAtom.man +++ b/man/XInternAtom.man @@ -172,7 +172,8 @@ A value for an Atom argument does not name a defined Atom. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XFree(__libmansuffix__), diff --git a/man/XListFonts.man b/man/XListFonts.man index 6c99f31a..6dd1c9e9 100644 --- a/man/XListFonts.man +++ b/man/XListFonts.man @@ -161,7 +161,8 @@ to close the font. .LP Note that .B XListFontsWithInfo -is not thread-safe. If other threads make X requests on the same +is not thread-safe. +If other threads make X requests on the same .BR Display , then this function's behavior is undefined. .SH "SEE ALSO" diff --git a/man/XMapEvent.man b/man/XMapEvent.man index 34e5669d..8ee240ef 100644 --- a/man/XMapEvent.man +++ b/man/XMapEvent.man @@ -116,7 +116,7 @@ typedef struct { int request; /\&* one of MappingModifier, MappingKeyboard, MappingPointer */ int first_keycode; /\&* first keycode */ - int count; /\&* defines range of change w. first_keycode*/ + int count; /\&* defines range of change with first_keycode*/ } XMappingEvent; .EE .LP diff --git a/man/XPutImage.man b/man/XPutImage.man index 08def67c..d88bd268 100644 --- a/man/XPutImage.man +++ b/man/XPutImage.man @@ -302,7 +302,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" \fI\*(xL\fP diff --git a/man/XQueryBestSize.man b/man/XQueryBestSize.man index fecf27a1..db950ac2 100644 --- a/man/XQueryBestSize.man +++ b/man/XQueryBestSize.man @@ -178,7 +178,8 @@ window. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCreateGC(__libmansuffix__), diff --git a/man/XQueryColor.man b/man/XQueryColor.man index 9fbb8189..c25dbc57 100644 --- a/man/XQueryColor.man +++ b/man/XQueryColor.man @@ -240,7 +240,8 @@ A value for a Colormap argument does not name a defined Colormap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XAllocColor(__libmansuffix__), diff --git a/man/XQueryExtension.man b/man/XQueryExtension.man index e23075f5..4331fe37 100644 --- a/man/XQueryExtension.man +++ b/man/XQueryExtension.man @@ -43,25 +43,35 @@ Specifies the list of extension names. .SH DESCRIPTION .LP The \fIXQueryExtension\fP function determines if the named extension is -present. If the extension is not present, \fIXQueryExtension\fP returns +present. +If the extension is not present, \fIXQueryExtension\fP returns \fIFalse\fP; otherwise, it returns \fITrue\fP. If the extension is present, \fIXQueryExtension\fP returns the major opcode for the extension to -major_opcode_return; otherwise, it returns zero. Any minor opcode and the -request formats are specific to the extension. If the extension involves +major_opcode_return; otherwise, it returns zero. +Any minor opcode and the +request formats are specific to the extension. +If the extension involves additional event types, \fIXQueryExtension\fP returns the base event type code -to first_event_return; otherwise, it returns zero. The format of the events is -specific to the extension. If the extension involves additional error codes, +to first_event_return; otherwise, it returns zero. +The format of the events is +specific to the extension. +If the extension involves additional error codes, \fIXQueryExtension\fP returns the base error code to first_error_return; -otherwise, it returns zero. The format of additional data in the errors is -specific to the extension. If the extension name is not in the Host Portable -Character Encoding the result is implementation-dependent. Uppercase and +otherwise, it returns zero. +The format of additional data in the errors is +specific to the extension. +If the extension name is not in the Host Portable +Character Encoding the result is implementation-dependent. +Uppercase and lowercase matter; the strings \*(lqthing\*(rq, \*(lqThing\*(rq, and \*(lqthinG\*(rq are all considered different names. .LP The \fIXListExtensions\fP function returns a list of all extensions supported -by the server. If the data returned by the server is in the Latin Portable +by the server. +If the data returned by the server is in the Latin Portable Character Encoding, then the returned strings are in the Host Portable -Character Encoding. Otherwise, the result is implementation-dependent. +Character Encoding. +Otherwise, the result is implementation-dependent. .LP The \fIXFreeExtensionList\fP function frees the memory allocated by \fIXListExtensions\fP. diff --git a/man/XRaiseWindow.man b/man/XRaiseWindow.man index 9991b5bc..70190e7b 100644 --- a/man/XRaiseWindow.man +++ b/man/XRaiseWindow.man @@ -236,7 +236,8 @@ error. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XSendEvent.man b/man/XSendEvent.man index d72a90c4..a1aa493e 100644 --- a/man/XSendEvent.man +++ b/man/XSendEvent.man @@ -203,7 +203,8 @@ of the specified window. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XSetArcMode.man b/man/XSetArcMode.man index 65c59e86..81afb132 100644 --- a/man/XSetArcMode.man +++ b/man/XSetArcMode.man @@ -132,7 +132,8 @@ A value for a GContext argument does not name a defined GContext. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCopyArea(__libmansuffix__), diff --git a/man/XSetClipOrigin.man b/man/XSetClipOrigin.man index 6e35c744..207de4cc 100644 --- a/man/XSetClipOrigin.man +++ b/man/XSetClipOrigin.man @@ -184,7 +184,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCreateGC(__libmansuffix__), diff --git a/man/XSetCloseDownMode.man b/man/XSetCloseDownMode.man index 18d34bc2..7c63f6cd 100644 --- a/man/XSetCloseDownMode.man +++ b/man/XSetCloseDownMode.man @@ -120,7 +120,8 @@ error. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" \fI\*(xL\fP diff --git a/man/XSetEventQueueOwner.man b/man/XSetEventQueueOwner.man index 4ae2fd73..cc332497 100644 --- a/man/XSetEventQueueOwner.man +++ b/man/XSetEventQueueOwner.man @@ -35,19 +35,25 @@ Specifies the event queue ownership: .RS .TP \fIXlibOwnsEventQueue\fP (default) -Xlib owns the event queue. Use the Xlib event-handling functions. Do not +Xlib owns the event queue. +Use the Xlib event-handling functions. +Do not call the XCB event-handling functions. .TP \fIXCBOwnsEventQueue\fP -XCB owns the event queue. Use the XCB event-handling functions. Do not call +XCB owns the event queue. +Use the XCB event-handling functions. +Do not call the Xlib event-handling functions. .RE .SH DESCRIPTION While a client using Xlib/XCB can issue requests and handle their replies or errors with either Xlib or XCB, only one can own and handle the event queue. By default, Xlib must own the event queue, for compatibility with legacy Xlib -clients. Clients can call \fIXSetEventQueueOwner\fP immediately after -\fIXOpenDisplay\fP to let XCB own the event queue instead. Clients may not +clients. +Clients can call \fIXSetEventQueueOwner\fP immediately after +\fIXOpenDisplay\fP to let XCB own the event queue instead. +Clients may not call \fIXSetEventQueueOwner\fP at any other time, as this will potentially lose responses. .SH "SEE ALSO" diff --git a/man/XSetFillStyle.man b/man/XSetFillStyle.man index 0ad0ff8d..cea178de 100644 --- a/man/XSetFillStyle.man +++ b/man/XSetFillStyle.man @@ -109,7 +109,8 @@ A value for a GContext argument does not name a defined GContext. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCreateGC(__libmansuffix__), diff --git a/man/XSetFontPath.man b/man/XSetFontPath.man index 0515d6e3..08603930 100644 --- a/man/XSetFontPath.man +++ b/man/XSetFontPath.man @@ -110,7 +110,8 @@ frees the data allocated by .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XListFont(__libmansuffix__), diff --git a/man/XSetInputFocus.man b/man/XSetInputFocus.man index 258c8a9a..b0584b80 100644 --- a/man/XSetInputFocus.man +++ b/man/XSetInputFocus.man @@ -170,7 +170,8 @@ function returns the focus window and the current focus state. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XSetLineAttributes.man b/man/XSetLineAttributes.man index aa7245b5..6a0d4a97 100644 --- a/man/XSetLineAttributes.man +++ b/man/XSetLineAttributes.man @@ -158,7 +158,8 @@ A value for a GContext argument does not name a defined GContext. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCreateGC(__libmansuffix__), diff --git a/man/XSetPointerMapping.man b/man/XSetPointerMapping.man index de1b23ab..d52ff308 100644 --- a/man/XSetPointerMapping.man +++ b/man/XSetPointerMapping.man @@ -114,7 +114,8 @@ in map_return. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XChangeKeyboardControl(__libmansuffix__), diff --git a/man/XSetState.man b/man/XSetState.man index 3cfda708..e8478a8f 100644 --- a/man/XSetState.man +++ b/man/XSetState.man @@ -147,7 +147,8 @@ A value for a GContext argument does not name a defined GContext. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XCreateGC(__libmansuffix__), diff --git a/man/XSetTextProperty.man b/man/XSetTextProperty.man index 6d2eddda..9b2605c8 100644 --- a/man/XSetTextProperty.man +++ b/man/XSetTextProperty.man @@ -150,7 +150,8 @@ A value for an Atom argument does not name a defined Atom. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .TP 1i .B BadWindow diff --git a/man/XSetWMProperties.man b/man/XSetWMProperties.man index 400b0d4a..0587c12a 100644 --- a/man/XSetWMProperties.man +++ b/man/XSetWMProperties.man @@ -237,8 +237,9 @@ errors. .LP The function .B Xutf8SetWMProperties -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH PROPERTIES diff --git a/man/XStoreBytes.man b/man/XStoreBytes.man index d842e5ea..e2dd461f 100644 --- a/man/XStoreBytes.man +++ b/man/XStoreBytes.man @@ -150,7 +150,8 @@ to match in some other way required by the request. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XFree(__libmansuffix__) diff --git a/man/XStoreColors.man b/man/XStoreColors.man index 45e124e0..cd585ee8 100644 --- a/man/XStoreColors.man +++ b/man/XStoreColors.man @@ -199,7 +199,8 @@ A font or color of the specified name does not exist. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XAllocColor(__libmansuffix__), diff --git a/man/XStringToKeysym.man b/man/XStringToKeysym.man index a1e6c37f..14bc0d62 100644 --- a/man/XStringToKeysym.man +++ b/man/XStringToKeysym.man @@ -108,7 +108,8 @@ If no symbol is defined, returns .BR NoSymbol . .B XKeycodeToKeysym -predates the XKB extension. If you want to lookup a KeySym while +predates the XKB extension. +If you want to lookup a KeySym while using XKB you have to use .BR XkbKeycodeToKeysym . .LP diff --git a/man/XSupportsLocale.man b/man/XSupportsLocale.man index ea7d92e1..348aa09d 100644 --- a/man/XSupportsLocale.man +++ b/man/XSupportsLocale.man @@ -107,7 +107,8 @@ current modifiers are changed. .LP At program startup, the modifiers that are in effect are unspecified until -the first successful call to set them. Whenever the locale is changed, the +the first successful call to set them. +Whenever the locale is changed, the modifiers that are in effect become unspecified until the next successful call to set them. Clients should always call diff --git a/man/XcmsCCCOfColormap.man b/man/XcmsCCCOfColormap.man index b8a3a6ca..145e83e2 100644 --- a/man/XcmsCCCOfColormap.man +++ b/man/XcmsCCCOfColormap.man @@ -81,7 +81,8 @@ If they are not used again in the application, CCCs should be freed by calling .BR XcmsFreeCCC . Several colormaps may share the same CCC without restriction; this -includes the CCCs generated by Xlib with each colormap. Xlib, however, +includes the CCCs generated by Xlib with each colormap. +Xlib, however, creates a new CCC with each new colormap. .SH "SEE ALSO" DisplayOfCCC(__libmansuffix__), diff --git a/man/XcmsQueryColor.man b/man/XcmsQueryColor.man index b49af0bc..6a1099fc 100644 --- a/man/XcmsQueryColor.man +++ b/man/XcmsQueryColor.man @@ -161,7 +161,8 @@ A value for a Colormap argument does not name a defined Colormap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XcmsAllocColor(__libmansuffix__), diff --git a/man/XcmsStoreColor.man b/man/XcmsStoreColor.man index be1880a4..39cbaca0 100644 --- a/man/XcmsStoreColor.man +++ b/man/XcmsStoreColor.man @@ -203,7 +203,8 @@ A value for a Colormap argument does not name a defined Colormap. .B BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, the full range defined -by the argument's type is accepted. Any argument defined as a set of +by the argument's type is accepted. +Any argument defined as a set of alternatives can generate this error. .SH "SEE ALSO" XcmsAllocColor(__libmansuffix__), diff --git a/man/XmbDrawImageString.man b/man/XmbDrawImageString.man index 379d8456..406645fd 100644 --- a/man/XmbDrawImageString.man +++ b/man/XmbDrawImageString.man @@ -107,8 +107,9 @@ The behavior for an invalid codepoint is undefined. .LP The function .B Xutf8TextExtents -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XmbDrawString.man b/man/XmbDrawString.man index e8a056ed..da48940d 100644 --- a/man/XmbDrawString.man +++ b/man/XmbDrawString.man @@ -98,8 +98,9 @@ The behavior for an invalid codepoint is undefined. .LP The function .B Xutf8DrawString -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XmbDrawText.man b/man/XmbDrawText.man index 7288b6da..8cfca06c 100644 --- a/man/XmbDrawText.man +++ b/man/XmbDrawText.man @@ -119,8 +119,9 @@ The behavior for an invalid codepoint is undefined. .LP The function .B Xutf8DrawText -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH STRUCTURES diff --git a/man/XmbLookupString.man b/man/XmbLookupString.man index a46968b9..68d2cf5e 100644 --- a/man/XmbLookupString.man +++ b/man/XmbLookupString.man @@ -204,8 +204,9 @@ even though it does not have any more keyboard focus. .LP The function .B Xutf8LookupString -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XmbResetIC.man b/man/XmbResetIC.man index d6617fe1..30d1c33f 100644 --- a/man/XmbResetIC.man +++ b/man/XmbResetIC.man @@ -104,8 +104,9 @@ The client should free the returned string by calling .LP The function .B Xutf8ResetIC -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XmbTextEscapement.man b/man/XmbTextEscapement.man index 43c83ec9..5391f68b 100644 --- a/man/XmbTextEscapement.man +++ b/man/XmbTextEscapement.man @@ -86,8 +86,9 @@ the escapement is always positive. .LP The function .B Xutf8TextEscapement -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XmbTextExtents.man b/man/XmbTextExtents.man index 9409c1bc..01ae8e58 100644 --- a/man/XmbTextExtents.man +++ b/man/XmbTextExtents.man @@ -121,8 +121,9 @@ The behavior for an invalid codepoint is undefined. .LP The function .B Xutf8TextExtents -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XmbTextListToTextProperty.man b/man/XmbTextListToTextProperty.man index 542f9c53..e9763659 100644 --- a/man/XmbTextListToTextProperty.man +++ b/man/XmbTextListToTextProperty.man @@ -110,7 +110,8 @@ and functions set the specified .B XTextProperty value to a set of null-separated elements representing the concatenation -of the specified list of null-terminated text strings. The input text +of the specified list of null-terminated text strings. +The input text strings must be given in the current locale encoding (for .B XmbTextListToTextProperty and @@ -134,8 +135,9 @@ If the style .B XUTF8StringStyle is specified, this encoding is \*(lqUTF8_STRING\*(rq. -(This is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is indicated by the macro +(This is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING .) If the style .B XTextStyle @@ -184,7 +186,8 @@ and functions return a list of text strings representing the null-separated elements of the specified .B XTextProperty -structure. The returned strings are encoded using the current locale encoding +structure. +The returned strings are encoded using the current locale encoding (for .B XmbTextPropertyToTextList and @@ -298,8 +301,9 @@ The functions .B Xutf8TextListToTextProperty and .B Xutf8TextPropertyToTextList -are extensions introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Their presence is +are extensions introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Their presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH STRUCTURES diff --git a/man/XmbTextPerCharExtents.man b/man/XmbTextPerCharExtents.man index 33b35451..eaa771c1 100644 --- a/man/XmbTextPerCharExtents.man +++ b/man/XmbTextPerCharExtents.man @@ -151,8 +151,9 @@ or .LP The function .B Xutf8TextPerCharExtents -is an extension introduced by The XFree86 Project, Inc. in their 4.0.2 -release. Its presence is +is an extension introduced by The XFree86 Project, Inc., in their 4.0.2 +release. +Its presence is indicated by the macro .BR X_HAVE_UTF8_STRING . .SH "SEE ALSO" diff --git a/man/XrmEnumerateDatabase.man b/man/XrmEnumerateDatabase.man index a84e0227..da803ccb 100644 --- a/man/XrmEnumerateDatabase.man +++ b/man/XrmEnumerateDatabase.man @@ -96,7 +96,8 @@ The order in which resources are found is implementation-dependent. If mode is .BR XrmEnumOneLevel , a resource must match the given name/class prefix with -just a single name and class appended. If mode is +just a single name and class appended. +If mode is .BR XrmEnumAllLevels , the resource must match the given name/class prefix with one or more names and classes appended. diff --git a/man/XrmGetFileDatabase.man b/man/XrmGetFileDatabase.man index 15b26141..5cbad899 100644 --- a/man/XrmGetFileDatabase.man +++ b/man/XrmGetFileDatabase.man @@ -198,7 +198,8 @@ if the sequence contains only \*(lq\&.\*(rq characters; otherwise, the sequence will be replaced with a single \*(lq*\*(rq character. .LP A resource database never contains more than one entry for a given -ResourceName. If a resource file contains multiple lines with the +ResourceName. +If a resource file contains multiple lines with the same ResourceName, the last line in the file is used. .LP Any white space characters before or after the name or colon in a ResourceSpec |