diff options
Diffstat (limited to 'lib/libX11/man')
56 files changed, 294 insertions, 262 deletions
diff --git a/lib/libX11/man/AllPlanes.man b/lib/libX11/man/AllPlanes.man index 70d837e87..3532bef55 100644 --- a/lib/libX11/man/AllPlanes.man +++ b/lib/libX11/man/AllPlanes.man @@ -63,7 +63,7 @@ Colormap DefaultColormap\^(\^Display *\fIdisplay\fP\^, int DefaultDepth\^(\^Display *\fIdisplay\fP\^, \^int \fIscreen_number\fP\^); .HP int *XListDepths\^(\^Display *\fIdisplay\fP, int \fIscreen_number\fP, int -\fIcount_return\fP\^); +*\fIcount_return\fP\^); .HP GC DefaultGC\^(\^Display *\fIdisplay\fP\^, \^int \fIscreen_number\fP\^); .HP @@ -82,9 +82,9 @@ int DisplayPlanes\^(\^Display *\fIdisplay\fP\^, \^int \fIscreen_number\fP\^); .HP char *DisplayString\^(\^Display *\fIdisplay\fP\^); .HP -long XMaxRequestSize(\^Display *\fIdisplay\fP\^) +long XMaxRequestSize(\^Display *\fIdisplay\fP\^); .HP -long XExtendedMaxRequestSize(\^Display *\fIdisplay\fP\^) +long XExtendedMaxRequestSize(\^Display *\fIdisplay\fP\^); .HP unsigned long LastKnownRequestProcessed\^(\^Display *\fIdisplay\fP\^); .HP @@ -103,9 +103,9 @@ int ScreenCount\^(\^Display *\fIdisplay\fP\^); Screen *ScreenOfDisplay\^(\^Display *\fIdisplay\fP, int \fIscreen_number\fP\^); .HP -char *ServerVendor\^(\^Display *\fIdisplay\fP\^) +char *ServerVendor\^(\^Display *\fIdisplay\fP\^); .HP -int VendorRelease\^(\^Display *\fIdisplay\fP\^) +int VendorRelease\^(\^Display *\fIdisplay\fP\^); .SH ARGUMENTS .IP \fIdisplay\fP 1i Specifies the connection to the X server. diff --git a/lib/libX11/man/Makefile.in b/lib/libX11/man/Makefile.in index 25dcb0189..b7d4591d0 100644 --- a/lib/libX11/man/Makefile.in +++ b/lib/libX11/man/Makefile.in @@ -54,9 +54,10 @@ subdir = man DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_define_dir.m4 \ - $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ - $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ - $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/configure.ac + $(top_srcdir)/m4/ax_gcc_builtin.m4 $(top_srcdir)/m4/libtool.m4 \ + $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ + $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ + $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) mkinstalldirs = $(install_sh) -d @@ -326,6 +327,7 @@ pdfdir = @pdfdir@ prefix = @prefix@ program_transform_name = @program_transform_name@ psdir = @psdir@ +runstatedir = @runstatedir@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ srcdir = @srcdir@ diff --git a/lib/libX11/man/XAddConnectionWatch.man b/lib/libX11/man/XAddConnectionWatch.man index 7dc66eef2..b776092dd 100644 --- a/lib/libX11/man/XAddConnectionWatch.man +++ b/lib/libX11/man/XAddConnectionWatch.man @@ -54,10 +54,10 @@ typedef void (*XConnectionWatchProc)\^(\^Display *\fIdisplay\fP\^, XPointer \fIclient_data\fP\^, int \fIfd\fP\^, Bool \fIopening\fP\^, XPointer *\fIwatch_data\fP\^); .HP -Status XAddConnectionWatch\^(\^Display *\fIdisplay\fP\^, XWatchProc +Status XAddConnectionWatch\^(\^Display *\fIdisplay\fP\^, XConnectionWatchProc \fIprocedure\fP\^, XPointer \fIclient_data\fP\^); .HP -Status XRemoveConnectionWatch\^(\^Display *\fIdisplay\fP\^, XWatchProc +void XRemoveConnectionWatch\^(\^Display *\fIdisplay\fP\^, XConnectionWatchProc \fIprocedure\fP\^, XPointer \fIclient_data\fP\^); .HP void XProcessInternalConnection\^(\^Display *\fIdisplay\fP\^, int \fIfd\fP\^); diff --git a/lib/libX11/man/XAddHost.man b/lib/libX11/man/XAddHost.man index 03b9fd4d6..bb75aa2d5 100644 --- a/lib/libX11/man/XAddHost.man +++ b/lib/libX11/man/XAddHost.man @@ -82,7 +82,7 @@ int XAddHosts\^(\^Display *\fIdisplay\fP, XHostAddress *\fIhosts\fP, int \fInum_hosts\fP\^); .HP XHostAddress *XListHosts\^(\^Display *\fIdisplay\fP, int *\fInhosts_return\fP, -Bool \fIstate_return\fP\^); +Bool *\fIstate_return\fP\^); .HP int XRemoveHost\^(\^Display *\fIdisplay\fP, XHostAddress *\fIhost\fP\^); .HP diff --git a/lib/libX11/man/XAllocColor.man b/lib/libX11/man/XAllocColor.man index d7ff5e986..aa051ed97 100644 --- a/lib/libX11/man/XAllocColor.man +++ b/lib/libX11/man/XAllocColor.man @@ -56,7 +56,7 @@ Status XAllocColor\^(\^Display *\fIdisplay\fP, Colormap \fIcolormap\fP\^, XColor *\fIscreen_in_out\fP\^); .HP Status XAllocNamedColor\^(\^Display *\fIdisplay\fP, Colormap \fIcolormap\fP\^, -char *\fIcolor_name\fP\^, XColor *\fIscreen_def_return\fP\^, XColor +_Xconst char *\fIcolor_name\fP\^, XColor *\fIscreen_def_return\fP\^, XColor *\fIexact_def_return\fP\^); .HP Status XAllocColorCells\^(\^Display *\fIdisplay\fP, Colormap \fIcolormap\fP\^, diff --git a/lib/libX11/man/XAllocIconSize.man b/lib/libX11/man/XAllocIconSize.man index ae5162ff2..36c09cfca 100644 --- a/lib/libX11/man/XAllocIconSize.man +++ b/lib/libX11/man/XAllocIconSize.man @@ -55,7 +55,7 @@ int XSetIconSizes\^(\^Display *\fIdisplay\fP, Window \fIw\fP, XIconSize *\fIsize_list\fP, int \fIcount\fP\^); .LP Status XGetIconSizes\^(\^Display *\fIdisplay\fP, Window \fIw\fP, XIconSize -**\fIsize_list_return\fP, int \fIcount_return\fP\^); +**\fIsize_list_return\fP, int *\fIcount_return\fP\^); .SH ARGUMENTS .IP \fIdisplay\fP 1i Specifies the connection to the X server. diff --git a/lib/libX11/man/XCopyArea.man b/lib/libX11/man/XCopyArea.man index 25f9ed9bc..0ac299c44 100644 --- a/lib/libX11/man/XCopyArea.man +++ b/lib/libX11/man/XCopyArea.man @@ -57,7 +57,7 @@ int \fIwidth\fP\^, unsigned \fIheight\fP\^, int \fIdest_x\fP\^, int .HP int XCopyPlane\^(\^Display *\fIdisplay\fP\^, Drawable \fIsrc\fP\^, Drawable \fIdest\fP\^, GC \fIgc\fP\^, int \fIsrc_x\fP\^, int \fIsrc_y\fP\^, unsigned -\fIwidth\fP\^, int \fIheight\fP\^, int \fIdest_x\fP\^, int \fIdest_y\fP\^, +\fIwidth\fP\^, unsigned \fIheight\fP\^, int \fIdest_x\fP\^, int \fIdest_y\fP\^, unsigned long \fIplane\fP\^); .SH ARGUMENTS .IP \fIdest_x\fP 1i diff --git a/lib/libX11/man/XCreateFontCursor.man b/lib/libX11/man/XCreateFontCursor.man index 587d1cfd6..977795ff2 100644 --- a/lib/libX11/man/XCreateFontCursor.man +++ b/lib/libX11/man/XCreateFontCursor.man @@ -60,8 +60,8 @@ Cursor XCreatePixmapCursor\^(\^Display *\fIdisplay\fP\^, Pixmap .HP Cursor XCreateGlyphCursor\^(\^Display *\fIdisplay\fP\^, Font \fIsource_font\fP\^, Font \fImask_font\fP\^, unsigned int \fIsource_char\fP\^, -unsigned int \fImask_char\fP\^, XColor *\fIforeground_color\fP\^, XColor -*\fIbackground_color\fP\^); +unsigned int \fImask_char\fP\^, XColor _Xconst *\fIforeground_color\fP\^, XColor +_Xconst *\fIbackground_color\fP\^); .SH ARGUMENTS .IP \fIbackground_color\fP 1i Specifies the RGB values for the background of the source. diff --git a/lib/libX11/man/XCreateFontSet.man b/lib/libX11/man/XCreateFontSet.man index d2111eb35..3b102cfe3 100644 --- a/lib/libX11/man/XCreateFontSet.man +++ b/lib/libX11/man/XCreateFontSet.man @@ -50,7 +50,7 @@ XCreateFontSet, XFreeFontSet \- create and free an international text drawing font set .SH SYNTAX .HP -XFontSet XCreateFontSet\^(\^Display *\fIdisplay\fP\^, char +XFontSet XCreateFontSet\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIbase_font_name_list\fP\^, char ***\fImissing_charset_list_return\fP\^, int *\fImissing_charset_count_return\fP\^, char **\fIdef_string_return\fP\^); .HP diff --git a/lib/libX11/man/XCreateGC.man b/lib/libX11/man/XCreateGC.man index e737f98ae..0c7674f7d 100644 --- a/lib/libX11/man/XCreateGC.man +++ b/lib/libX11/man/XCreateGC.man @@ -178,7 +178,7 @@ If the valuemask contains a valid set of GC mask bits .BR GCSubwindowMode , .BR GCGraphicsExposures , .BR GCClipXOrigin , -.BR GCCLipYOrigin , +.BR GCClipYOrigin , .BR GCDashOffset , or .BR GCArcMode ) diff --git a/lib/libX11/man/XCreateOC.man b/lib/libX11/man/XCreateOC.man index 8b2644b76..22f484ae6 100644 --- a/lib/libX11/man/XCreateOC.man +++ b/lib/libX11/man/XCreateOC.man @@ -50,7 +50,7 @@ XCreateOC, XDestroyOC, XSetOCValues, XGetOCValues, XOMOfOC \- create output contexts .SH SYNTAX .HP -XOC XCreateOC\^(\^XOM \fIom\fP\^); +XOC XCreateOC\^(\^XOM \fIom\fP\^, ...); .HP void XDestroyOC\^(\^XOC \fIoc\fP\^); .HP diff --git a/lib/libX11/man/XDrawImageString.man b/lib/libX11/man/XDrawImageString.man index 9f2cffcad..fb741deea 100644 --- a/lib/libX11/man/XDrawImageString.man +++ b/lib/libX11/man/XDrawImageString.man @@ -51,11 +51,11 @@ XDrawImageString, XDrawImageString16 \- draw image text .SH SYNTAX .HP int XDrawImageString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, GC -\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, char *\fIstring\fP\^, int +\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, _Xconst char *\fIstring\fP\^, int \fIlength\fP\^); .HP int XDrawImageString16\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, GC -\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, XChar2b *\fIstring\fP\^, int +\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, _Xconst XChar2b *\fIstring\fP\^, int \fIlength\fP\^); .SH ARGUMENTS .IP \fId\fP 1i @@ -149,6 +149,13 @@ window is used as a Drawable. .B BadMatch Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request. +.SH NOTES +Unlike XDrawString and XDrawString16, +these functions send no more than 255 characters at a time to the server. +When the total number of characters to be sent is larger than 255, +these functions split the string into chunks up to 255 characters. +After sending each chunk, +these functions query the server to determine the actual text extent. .SH "SEE ALSO" XDrawString(__libmansuffix__), XDrawText(__libmansuffix__), diff --git a/lib/libX11/man/XDrawString.man b/lib/libX11/man/XDrawString.man index 97844ee16..295c1a368 100644 --- a/lib/libX11/man/XDrawString.man +++ b/lib/libX11/man/XDrawString.man @@ -51,11 +51,11 @@ XDrawString, XDrawString16 \- draw text characters .SH SYNTAX .HP int XDrawString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, GC -\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, char *\fIstring\fP\^, int +\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, _Xconst char *\fIstring\fP\^, int \fIlength\fP\^); .HP int XDrawString16\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, GC -\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, XChar2b *\fIstring\fP\^, int +\fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, _Xconst XChar2b *\fIstring\fP\^, int \fIlength\fP\^); .SH ARGUMENTS .IP \fId\fP 1i diff --git a/lib/libX11/man/XGetWindowProperty.man b/lib/libX11/man/XGetWindowProperty.man index 70df32498..b297ffff8 100644 --- a/lib/libX11/man/XGetWindowProperty.man +++ b/lib/libX11/man/XGetWindowProperty.man @@ -61,7 +61,7 @@ Atom *XListProperties\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, int .HP int XChangeProperty\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, Atom \fIproperty\fP\^, Atom \fItype\fP\^, int \fIformat\fP\^, int \fImode\fP\^, -unsigned char *\fIdata\fP\^, int \fInelements\fP\^); +_Xconst unsigned char *\fIdata\fP\^, int \fInelements\fP\^); .HP int XRotateWindowProperties\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, Atom \fIproperties\fP\^[]\^, int \fInum_prop\fP\^, int \fInpositions\fP\^); diff --git a/lib/libX11/man/XInternAtom.man b/lib/libX11/man/XInternAtom.man index 6cd6374d6..c9b962171 100644 --- a/lib/libX11/man/XInternAtom.man +++ b/lib/libX11/man/XInternAtom.man @@ -50,7 +50,7 @@ XInternAtom, XInternAtoms, XGetAtomName, XGetAtomNames \- create or return atom names .SH SYNTAX .HP -Atom XInternAtom\^(\^Display *\fIdisplay\fP\^, char *\fIatom_name\fP\^, Bool +Atom XInternAtom\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIatom_name\fP\^, Bool \fIonly_if_exists\fP\^); .HP Status XInternAtoms\^(\^Display *\fIdisplay\fP\^, char **\fInames\fP\^, int diff --git a/lib/libX11/man/XListFonts.man b/lib/libX11/man/XListFonts.man index 6dd1c9e9c..ed3213a64 100644 --- a/lib/libX11/man/XListFonts.man +++ b/lib/libX11/man/XListFonts.man @@ -50,12 +50,12 @@ XListFonts, XFreeFontNames, XListFontsWithInfo, XFreeFontInfo \- obtain or free font names and information .SH SYNTAX .HP -char **XListFonts\^(\^Display *\^\fIdisplay\fP\^, char *\^\fIpattern\fP\^, int +char **XListFonts\^(\^Display *\^\fIdisplay\fP\^, _Xconst char *\^\fIpattern\fP\^, int \fImaxnames\fP\^, int *\^\fIactual_count_return\fP\^); .HP int XFreeFontNames\^(\^char *\fIlist\fP\^[\^]\^); .HP -char **XListFontsWithInfo\^(\^Display *\fIdisplay\fP\^, char *\fIpattern\fP\^, +char **XListFontsWithInfo\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIpattern\fP\^, int \fImaxnames\fP\^, int *\fIcount_return\fP\^, XFontStruct **\fIinfo_return\fP\^); .HP diff --git a/lib/libX11/man/XLoadFont.man b/lib/libX11/man/XLoadFont.man index b4c023ef6..4fc237ba0 100644 --- a/lib/libX11/man/XLoadFont.man +++ b/lib/libX11/man/XLoadFont.man @@ -60,11 +60,11 @@ XLoadFont, XQueryFont, XLoadQueryFont, XFreeFont, XGetFontProperty, XUnloadFont, XCharStruct, XFontProp, XChar2b, XFontStruct \- load or unload fonts and font metric structures .SH SYNTAX .HP -Font XLoadFont\^(\^Display *\fIdisplay\fP\^, char *\fIname\fP\^); +Font XLoadFont\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIname\fP\^); .HP XFontStruct *XQueryFont\^(\^Display *\fIdisplay\fP\^, XID \fIfont_ID\fP\^); .HP -XFontStruct *XLoadQueryFont\^(\^Display *\fIdisplay\fP\^, char +XFontStruct *XLoadQueryFont\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIname\fP\^); .HP int XFreeFont\^(\^Display *\fIdisplay\fP\^, XFontStruct *\fIfont_struct\fP\^); diff --git a/lib/libX11/man/XLookupKeysym.man b/lib/libX11/man/XLookupKeysym.man index 2f54a49e6..05204b7dc 100644 --- a/lib/libX11/man/XLookupKeysym.man +++ b/lib/libX11/man/XLookupKeysym.man @@ -59,7 +59,7 @@ int XLookupString(\^XKeyEvent *\fIevent_struct\fP\^, char *\fIkeysym_return\fP\^, XComposeStatus *\fIstatus_in_out\fP\^); .HP int XRebindKeysym(\^Display *\fIdisplay\fP\^, KeySym \fIkeysym\fP\^, KeySym -\fIlist\fP\^[\^]\^, int \fImod_count\fP\^, unsigned char *\fIstring\fP\^, int +\fIlist\fP\^[\^]\^, int \fImod_count\fP\^, _Xconst unsigned char *\fIstring\fP\^, int \fInum_bytes\fP\^); .SH ARGUMENTS .IP \fIbuffer_return\fP 1i diff --git a/lib/libX11/man/XOpenDisplay.man b/lib/libX11/man/XOpenDisplay.man index 68faefbec..c385057b5 100644 --- a/lib/libX11/man/XOpenDisplay.man +++ b/lib/libX11/man/XOpenDisplay.man @@ -50,7 +50,7 @@ XOpenDisplay, XCloseDisplay \- connect or disconnect to X server .SH SYNTAX .HP -Display *XOpenDisplay\^(\^char *\fIdisplay_name\fP\^); +Display *XOpenDisplay\^(\^_Xconst char *\fIdisplay_name\fP\^); .HP int XCloseDisplay\^(Display *\fIdisplay\fP\^); .SH ARGUMENTS diff --git a/lib/libX11/man/XOpenOM.man b/lib/libX11/man/XOpenOM.man index 275589c9e..637b850e9 100644 --- a/lib/libX11/man/XOpenOM.man +++ b/lib/libX11/man/XOpenOM.man @@ -56,9 +56,9 @@ XOM XOpenOM\^(\^Display *\fIdisplay\fP\^, XrmDatabase \fIdb\fP\^, char .HP Status XCloseOM\^(\^XOM \fIom\fP\^); .HP -char *XSetOMValues\^(\^XOM \fIom\fP\^); +char *XSetOMValues\^(\^XOM \fIom\fP, ...\^); .HP -char *XGetOMValues\^(\^XOM \fIom\fP\^); +char *XGetOMValues\^(\^XOM \fIom\fP, ...\^); .HP Display *XDisplayOfOM\^(\^XOM \fIom\fP\^); .HP diff --git a/lib/libX11/man/XParseGeometry.man b/lib/libX11/man/XParseGeometry.man index ed4a9070c..8fc042db1 100644 --- a/lib/libX11/man/XParseGeometry.man +++ b/lib/libX11/man/XParseGeometry.man @@ -50,12 +50,12 @@ XParseGeometry, XWMGeometry \- parse window geometry .SH SYNTAX .HP -int XParseGeometry\^(\^char *\fIparsestring\fP\^, int *\fIx_return\fP\^, int +int XParseGeometry\^(\^_Xconst char *\fIparsestring\fP\^, int *\fIx_return\fP\^, int *\fIy_return\fP\^, unsigned int *\fIwidth_return\fP\^, unsigned int *\fIheight_return\fP\^); .HP -int XWMGeometry\^(\^Display *\fIdisplay\fP\^, int \fIscreen\fP\^, char -*\fIuser_geom\fP\^, char *\fIdef_geom\fP\^, unsigned int \fIbwidth\fP\^, +int XWMGeometry\^(\^Display *\fIdisplay\fP\^, int \fIscreen\fP\^, _Xconst char +*\fIuser_geom\fP\^, _Xconst char *\fIdef_geom\fP\^, unsigned int \fIbwidth\fP\^, XSizeHints *\fIhints\fP\^, int *\fIx_return\fP, int *\fIy_return\fP\^, int *\fIwidth_return\fP\^, int *\fIheight_return\fP\^, int *\fIgravity_return\fP\^); diff --git a/lib/libX11/man/XQueryColor.man b/lib/libX11/man/XQueryColor.man index c25dbc577..b5111e7bc 100644 --- a/lib/libX11/man/XQueryColor.man +++ b/lib/libX11/man/XQueryColor.man @@ -58,11 +58,11 @@ int XQueryColors\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, XColor \fIdefs_in_out\fP[\^]\^, int \fIncolors\fP\^); .HP Status XLookupColor\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, -char *\fIcolor_name\fP\^, XColor *\fIexact_def_return\fP\^, XColor +_Xconst char *\fIcolor_name\fP\^, XColor *\fIexact_def_return\fP\^, XColor *\fIscreen_def_return\fP\^); .HP Status XParseColor\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, -char *\fIspec\fP\^, XColor *\fIexact_def_return\fP\^); +_Xconst char *\fIspec\fP\^, XColor *\fIexact_def_return\fP\^); .SH ARGUMENTS .IP \fIcolormap\fP 1i Specifies the colormap. diff --git a/lib/libX11/man/XReadBitmapFile.man b/lib/libX11/man/XReadBitmapFile.man index 4d43ef4fc..520be3521 100644 --- a/lib/libX11/man/XReadBitmapFile.man +++ b/lib/libX11/man/XReadBitmapFile.man @@ -50,16 +50,16 @@ XReadBitmapFile, XReadBitmapFileData, XWriteBitmapFile, XCreatePixmapFromBitmapData, XCreateBitmapFromData \- manipulate bitmaps .SH SYNTAX .HP -int XReadBitmapFile(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, char +int XReadBitmapFile(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, _Xconst char *\fIfilename\fP\^, unsigned int *\fIwidth_return\fP, unsigned int *\fIheight_return\fP\^, Pixmap *\fIbitmap_return\fP\^, int *\fIx_hot_return\fP, int *\fIy_hot_return\fP\^); .HP -int XReadBitmapFileData(\^char *\fIfilename\fP\^, unsigned int +int XReadBitmapFileData(\^_Xconst char *\fIfilename\fP\^, unsigned int *\fIwidth_return\fP, unsigned int *\fIheight_return\fP\^, unsigned char -*\fIdata_return\fP\^, int *\fIx_hot_return\fP, int *\fIy_hot_return\fP\^); +**\fIdata_return\fP\^, int *\fIx_hot_return\fP, int *\fIy_hot_return\fP\^); .HP -int XWriteBitmapFile(\^Display *\fIdisplay\fP\^, char *\fIfilename\fP\^, +int XWriteBitmapFile(\^Display *\fIdisplay\fP\^, _Xconst char *\fIfilename\fP\^, Pixmap \fIbitmap\fP\^, unsigned int \fIwidth\fP, unsigned int \fIheight\fP\^, int \fIx_hot\fP, int \fIy_hot\fP\^); .HP @@ -69,7 +69,7 @@ Pixmap XCreatePixmapFromBitmapData\^(\^Display *\fIdisplay\fP\^, Drawable \fIdepth\fP\^); .HP Pixmap XCreateBitmapFromData(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, -char *\fIdata\fP\^, unsigned int \fIwidth\fP, unsigned int \fIheight\fP\^); +_Xconst char *\fIdata\fP\^, unsigned int \fIwidth\fP, unsigned int \fIheight\fP\^); .SH ARGUMENTS .IP \fIbitmap\fP 1i Specifies the bitmap. diff --git a/lib/libX11/man/XSaveContext.man b/lib/libX11/man/XSaveContext.man index 58782811a..999649274 100644 --- a/lib/libX11/man/XSaveContext.man +++ b/lib/libX11/man/XSaveContext.man @@ -51,7 +51,7 @@ XSaveContext, XFindContext, XDeleteContext, XUniqueContext \- associative look-u .SH SYNTAX .HP int XSaveContext(\^Display *\fIdisplay\fP\^, XID \fIrid\fP\^, XContext -\fIcontext\fP\^, XPointer \fIdata\fP\^); +\fIcontext\fP\^, _Xconst char *\fIdata\fP\^); .HP int XFindContext(\^Display *\fIdisplay\fP\^, XID \fIrid\fP\^, XContext \fIcontext\fP\^, XPointer *\fIdata_return\fP\^); diff --git a/lib/libX11/man/XSetErrorHandler.man b/lib/libX11/man/XSetErrorHandler.man index f04b3b491..2f30420fc 100644 --- a/lib/libX11/man/XSetErrorHandler.man +++ b/lib/libX11/man/XSetErrorHandler.man @@ -47,7 +47,7 @@ .ds xC Inter-Client Communication Conventions Manual .TH XSetErrorHandler __libmansuffix__ __xorgversion__ "XLIB FUNCTIONS" .SH NAME -XSetErrorHandler, XGetErrorText, XDisplayName, XSetIOErrorHandler, XGetErrorDatabaseText \- default error handlers +XSetErrorHandler, XGetErrorText, XDisplayName, XSetIOErrorHandler, XSetIOErrorExitHandler, XGetErrorDatabaseText \- default error handlers .SH SYNTAX .HP int (*XSetErrorHandler\^(\^int (\^*\^\fIhandler\fP\^)\^(Display *, XErrorEvent @@ -56,13 +56,17 @@ int (*XSetErrorHandler\^(\^int (\^*\^\fIhandler\fP\^)\^(Display *, XErrorEvent int XGetErrorText\^(\^Display *\fIdisplay\fP\^, int \fIcode\fP\^, char *\fIbuffer_return\fP\^, int \fIlength\fP\^); .HP -char *XDisplayName\^(\^char *\fIstring\fP\^); +char *XDisplayName\^(\^_Xconst char *\fIstring\fP\^); .HP int (*XSetIOErrorHandler\^(\^int (\^*\^\fIhandler\fP\^)(Display *)\^)\^)\^(\^); .HP -int XGetErrorDatabaseText\^(\^Display *\fIdisplay\fP\^, char *\fIname\fP, char -*\fImessage\fP\^, char *\fIdefault_string\fP\^, char *\fIbuffer_return\fP\^, +void (*XSetIOErrorExitHandler\^(Display +*\fIdisplay\fP\^, void (\^*\^\fIhandler\fP\^)(Display *, void +*)\^, void *\fIuser_data\fP)\^)\^(\^); +.HP +int XGetErrorDatabaseText\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIname\fP, _Xconst char +*\fImessage\fP\^, _Xconst char *\fIdefault_string\fP\^, char *\fIbuffer_return\fP\^, int \fIlength\fP\^); .SH ARGUMENTS .IP \fIbuffer_return\fP 1i @@ -136,9 +140,11 @@ sets the fatal I/O error handler. Xlib calls the program's supplied error handler if any sort of system call error occurs (for example, the connection to the server was lost). This is assumed to be a fatal condition, -and the called routine should not return. +and the called routine should normally not return. If the I/O error handler does return, -the client process exits. +the client process exits by default, this behavior may be altered with the +.BR XSetIOErrorExitHandler +function. .LP Note that the previous error handler is returned. .LP diff --git a/lib/libX11/man/XSetLineAttributes.man b/lib/libX11/man/XSetLineAttributes.man index 6a0d4a973..3e34711d1 100644 --- a/lib/libX11/man/XSetLineAttributes.man +++ b/lib/libX11/man/XSetLineAttributes.man @@ -55,7 +55,7 @@ int \fIline_width\fP\^, int \fIline_style\fP\^, int \fIcap_style\fP\^, int \fIjoin_style\fP\^); .HP int XSetDashes\^(\^Display *\fIdisplay\fP\^, GC \fIgc\fP\^, int -\fIdash_offset\fP\^, char \fIdash_list\fP[]\^, int \fIn\fP\^); +\fIdash_offset\fP\^, _Xconst char \fIdash_list\fP[]\^, int \fIn\fP\^); .SH ARGUMENTS .IP \fIcap_style\fP 1i Specifies the line-style and cap-style you want to set for the specified GC. diff --git a/lib/libX11/man/XSetPointerMapping.man b/lib/libX11/man/XSetPointerMapping.man index d52ff3080..8cbdf1d2f 100644 --- a/lib/libX11/man/XSetPointerMapping.man +++ b/lib/libX11/man/XSetPointerMapping.man @@ -50,7 +50,7 @@ XSetPointerMapping, XGetPointerMapping \- manipulate pointer settings .SH SYNTAX .HP -int XSetPointerMapping\^(\^Display *\fIdisplay\fP\^, unsigned char +int XSetPointerMapping\^(\^Display *\fIdisplay\fP\^, _Xconst unsigned char \fImap\fP\^[]\^, int \fInmap\fP\^); .HP int XGetPointerMapping\^(\^Display *\fIdisplay\fP\^, unsigned char diff --git a/lib/libX11/man/XSetState.man b/lib/libX11/man/XSetState.man index e8478a8f5..aee921c28 100644 --- a/lib/libX11/man/XSetState.man +++ b/lib/libX11/man/XSetState.man @@ -51,7 +51,7 @@ XSetState, XSetFunction, XSetPlaneMask, XSetForeground, XSetBackground \- GC con .SH SYNTAX .HP int XSetState\^(\^Display *\fIdisplay\fP\^, GC \fIgc\fP\^, unsigned long -\fIforeground\fP\^, unsigned int \fIbackground\fP\^, int \fIfunction\fP\^, +\fIforeground\fP\^, unsigned long \fIbackground\fP\^, int \fIfunction\fP\^, unsigned long \fIplane_mask\fP\^); .HP int XSetFunction\^(\^Display *\fIdisplay\fP\^, GC \fIgc\fP\^, int diff --git a/lib/libX11/man/XSetWMIconName.man b/lib/libX11/man/XSetWMIconName.man index 382b3d1d5..738bc30a7 100644 --- a/lib/libX11/man/XSetWMIconName.man +++ b/lib/libX11/man/XSetWMIconName.man @@ -56,7 +56,7 @@ XTextProperty *\fItext_prop\fP\^); Status XGetWMIconName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, XTextProperty *\fItext_prop_return\fP\^); .HP -int XSetIconName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, char +int XSetIconName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, _Xconst char *\fIicon_name\fP\^); .HP Status XGetIconName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, char diff --git a/lib/libX11/man/XSetWMName.man b/lib/libX11/man/XSetWMName.man index 064fe1596..5e191ce95 100644 --- a/lib/libX11/man/XSetWMName.man +++ b/lib/libX11/man/XSetWMName.man @@ -56,7 +56,7 @@ void XSetWMName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, XTextProperty Status XGetWMName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, XTextProperty *\fItext_prop_return\fP\^); .HP -int XStoreName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, char +int XStoreName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, _Xconst char *\fIwindow_name\fP\^); .HP Status XFetchName\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, char diff --git a/lib/libX11/man/XSetWMProperties.man b/lib/libX11/man/XSetWMProperties.man index 0587c12ac..840bbff37 100644 --- a/lib/libX11/man/XSetWMProperties.man +++ b/lib/libX11/man/XSetWMProperties.man @@ -56,13 +56,13 @@ XTextProperty *\fIwindow_name\fP\^, XTextProperty *\fIicon_name\fP\^, char **\fIargv\fP\^, int \fIargc\fP\^, XSizeHints *\fInormal_hints\fP\^, XWMHints *\fIwm_hints\fP\^, XClassHint *\fIclass_hints\fP\^); .HP -void XmbSetWMProperties\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, char -*\fIwindow_name\fP\^, char *\fIicon_name\fP\^, char *\fIargv\fP\^[], int +void XmbSetWMProperties\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, _Xconst char +*\fIwindow_name\fP\^, _Xconst char *\fIicon_name\fP\^, char *\fIargv\fP\^[], int \fIargc\fP\^, XSizeHints *\fInormal_hints\fP\^, XWMHints *\fIwm_hints\fP\^, XClassHint *\fIclass_hints\fP\^); .HP -void Xutf8SetWMProperties\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, char -*\fIwindow_name\fP\^, char *\fIicon_name\fP\^, char *\fIargv\fP\^[], int +void Xutf8SetWMProperties\^(\^Display *\fIdisplay\fP\^, Window \fIw\fP\^, _Xconst char +*\fIwindow_name\fP\^, _Xconst char *\fIicon_name\fP\^, char *\fIargv\fP\^[], int \fIargc\fP\^, XSizeHints *\fInormal_hints\fP\^, XWMHints *\fIwm_hints\fP\^, XClassHint *\fIclass_hints\fP\^); .SH ARGUMENTS diff --git a/lib/libX11/man/XStoreBytes.man b/lib/libX11/man/XStoreBytes.man index e2dd461f6..dc78170f7 100644 --- a/lib/libX11/man/XStoreBytes.man +++ b/lib/libX11/man/XStoreBytes.man @@ -50,10 +50,10 @@ XStoreBytes, XStoreBuffer, XFetchBytes, XFetchBuffer, XRotateBuffers \- manipulate cut and paste buffers .SH SYNTAX .HP -int XStoreBytes\^(\^Display *\fIdisplay\fP\^, char *\fIbytes\fP\^, int +int XStoreBytes\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIbytes\fP\^, int \^\fInbytes\fP\^); .HP -int XStoreBuffer\^(\^Display *\fIdisplay\fP\^, char *\fIbytes\fP\^, int +int XStoreBuffer\^(\^Display *\fIdisplay\fP\^, _Xconst char *\fIbytes\fP\^, int \^\fInbytes\fP\^, int \fIbuffer\fP\^); .HP char *XFetchBytes\^(\^Display *\fIdisplay\fP\^, int *\fInbytes_return\fP\^); diff --git a/lib/libX11/man/XStoreColors.man b/lib/libX11/man/XStoreColors.man index cd585ee8e..e27d9ed73 100644 --- a/lib/libX11/man/XStoreColors.man +++ b/lib/libX11/man/XStoreColors.man @@ -57,7 +57,7 @@ int XStoreColor\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, XColor *\fIcolor\fP\^); .HP int XStoreNamedColor\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, -char *\^\fIcolor\fP\^, unsigned long \fIpixel\fP\^, int \fIflags\fP\^); +_Xconst char *\^\fIcolor\fP\^, unsigned long \fIpixel\fP\^, int \fIflags\fP\^); .SH ARGUMENTS .IP \fIcolor\fP 1i Specifies the pixel and RGB values or the color name string (for example, red). diff --git a/lib/libX11/man/XStringToKeysym.man b/lib/libX11/man/XStringToKeysym.man index 14bc0d627..86dcda76e 100644 --- a/lib/libX11/man/XStringToKeysym.man +++ b/lib/libX11/man/XStringToKeysym.man @@ -50,7 +50,7 @@ XStringToKeysym, XKeysymToString, XKeycodeToKeysym, XKeysymToKeycode, XConvertCase \- convert keysyms .SH SYNTAX .HP -KeySym XStringToKeysym\^(\^char *\fIstring\fP\^); +KeySym XStringToKeysym\^(\^_Xconst char *\fIstring\fP\^); .HP char *XKeysymToString\^(\^KeySym \fIkeysym\fP\^); .HP diff --git a/lib/libX11/man/XSupportsLocale.man b/lib/libX11/man/XSupportsLocale.man index 348aa09dc..2fe659a69 100644 --- a/lib/libX11/man/XSupportsLocale.man +++ b/lib/libX11/man/XSupportsLocale.man @@ -53,7 +53,7 @@ XSupportsLocale, XSetLocaleModifiers \- determine locale support and configure l .HP Bool XSupportsLocale\^(void); .HP -char *XSetLocaleModifiers\^(\^char *\fImodifier_list\fP\^); +char *XSetLocaleModifiers\^(\^_Xconst char *\fImodifier_list\fP\^); .SH ARGUMENTS .IP \fImodifier_list\fP 1i Specifies the modifiers. diff --git a/lib/libX11/man/XTextExtents.man b/lib/libX11/man/XTextExtents.man index 752fa2c5c..c5109a6e4 100644 --- a/lib/libX11/man/XTextExtents.man +++ b/lib/libX11/man/XTextExtents.man @@ -50,23 +50,23 @@ XTextExtents, XTextExtents16, XQueryTextExtents, XQueryTextExtents16 \- compute or query text extents .SH SYNTAX .HP -int XTextExtents\^(\^XFontStruct *\fIfont_struct\fP\^, char *\fIstring\fP\^, +int XTextExtents\^(\^XFontStruct *\fIfont_struct\fP\^, _Xconst char *\fIstring\fP\^, int \fInchars\fP\^, int *\fIdirection_return\fP\^, int *\fIfont_ascent_return\fP, int *\fIfont_descent_return\fP\^, XCharStruct *\fIoverall_return\fP\^); .HP -int XTextExtents16\^(\^XFontStruct *\fIfont_struct\fP\^, XChar2b +int XTextExtents16\^(\^XFontStruct *\fIfont_struct\fP\^, _Xconst XChar2b *\fIstring\fP\^, int \fInchars\fP\^, int *\fIdirection_return\fP\^, int *\fIfont_ascent_return\fP, int *\fIfont_descent_return\fP\^, XCharStruct *\fIoverall_return\fP\^); .HP -int XQueryTextExtents\^(\^Display *\fIdisplay\fP\^, XID \fIfont_ID\fP\^, char +int XQueryTextExtents\^(\^Display *\fIdisplay\fP\^, XID \fIfont_ID\fP\^, _Xconst char *\fIstring\fP\^, int \fInchars\fP\^, int *\fIdirection_return\fP\^, int *\fIfont_ascent_return\fP, int *\fIfont_descent_return\fP\^, XCharStruct *\fIoverall_return\fP\^); .HP int XQueryTextExtents16\^(\^Display *\fIdisplay\fP\^, XID \fIfont_ID\fP\^, -XChar2b *\fIstring\fP\^, int \fInchars\fP\^, int *\fIdirection_return\fP\^, +_Xconst XChar2b *\fIstring\fP\^, int \fInchars\fP\^, int *\fIdirection_return\fP\^, int *\fIfont_ascent_return\fP, int *\fIfont_descent_return\fP\^, XCharStruct *\fIoverall_return\fP\^); .SH ARGUMENTS diff --git a/lib/libX11/man/XTextWidth.man b/lib/libX11/man/XTextWidth.man index 5985bcbc1..e9aa1ca38 100644 --- a/lib/libX11/man/XTextWidth.man +++ b/lib/libX11/man/XTextWidth.man @@ -50,10 +50,10 @@ XTextWidth, XTextWidth16 \- compute text width .SH SYNTAX .HP -int XTextWidth\^(\^XFontStruct *\fIfont_struct\fP\^, char *\fIstring\fP\^, +int XTextWidth\^(\^XFontStruct *\fIfont_struct\fP\^, _Xconst char *\fIstring\fP\^, int \fIcount\fP\^); .HP -int XTextWidth16\^(\^XFontStruct *\fIfont_struct\fP\^, XChar2b +int XTextWidth16\^(\^XFontStruct *\fIfont_struct\fP\^, _Xconst XChar2b *\fIstring\fP\^, int \fIcount\fP\^); .SH ARGUMENTS .IP \fIcount\fP 1i diff --git a/lib/libX11/man/XcmsAllocColor.man b/lib/libX11/man/XcmsAllocColor.man index c8346e322..9ae80fb88 100644 --- a/lib/libX11/man/XcmsAllocColor.man +++ b/lib/libX11/man/XcmsAllocColor.man @@ -54,7 +54,7 @@ Status XcmsAllocColor\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, XcmsColor *\fIcolor_in_out\fP\^, XcmsColorFormat \fIresult_format\fP\^); .HP Status XcmsAllocNamedColor\^(\^Display *\fIdisplay\fP\^, Colormap -\fIcolormap\fP\^, char *\fIcolor_string\fP\^, XcmsColor +\fIcolormap\fP\^, _Xconst char *\fIcolor_string\fP\^, XcmsColor *\fIcolor_screen_return\fP\^, XcmsColor *\fIcolor_exact_return\fP\^, XcmsColorFormat \fIresult_format\fP\^); .SH ARGUMENTS .IP \fIdisplay\fP 1i diff --git a/lib/libX11/man/XcmsQueryColor.man b/lib/libX11/man/XcmsQueryColor.man index 6a1099fcb..00117ea38 100644 --- a/lib/libX11/man/XcmsQueryColor.man +++ b/lib/libX11/man/XcmsQueryColor.man @@ -58,7 +58,7 @@ Status XcmsQueryColors\^(\^Display *\fIdisplay\fP\^, Colormap \fIncolors\fP\^, XcmsColorFormat \fIresult_format\fP\^); .HP Status XcmsLookupColor\^(\^Display *\fIdisplay\fP\^, Colormap -\fIcolormap\fP\^, char *\fIcolor_string\fP\^, XcmsColor +\fIcolormap\fP\^, _Xconst char *\fIcolor_string\fP\^, XcmsColor *\fIcolor_exact_return\fP\^, XcmsColor *\fIcolor_screen_return\fP\^, XcmsColorFormat \fIresult_format\fP\^); .SH ARGUMENTS diff --git a/lib/libX11/man/XcmsStoreColor.man b/lib/libX11/man/XcmsStoreColor.man index 39cbaca05..c31646c25 100644 --- a/lib/libX11/man/XcmsStoreColor.man +++ b/lib/libX11/man/XcmsStoreColor.man @@ -53,9 +53,11 @@ XcmsStoreColor, XcmsStoreColors \- set colors Status XcmsStoreColor\^(\^Display *\fIdisplay\fP\^, Colormap \fIcolormap\fP\^, XcmsColor *\fIcolor\fP\^); .HP -Status XcmsStoreColors\^(\^Display *\fIdisplay\fP\^, Colormap -\fIcolormap\fP\^, XcmsColor \fIcolors\fP\^[\^]\^, int \fIncolors\fP\^, Bool -\fIcompression_flags_return\fP\^[\^]\^); +Status XcmsStoreColors\^(\^Display *\fIdisplay\fP\^, +Colormap \fIcolormap\fP\^, +XcmsColor *\fIcolors\fP\^, +unsigned \fIncolors\fP\^, +Bool *\fIcompression_flags_return\fP\^); .SH ARGUMENTS .IP \fIdisplay\fP 1i Specifies the connection to the X server. diff --git a/lib/libX11/man/XmbDrawImageString.man b/lib/libX11/man/XmbDrawImageString.man index 406645fdf..8a0b78007 100644 --- a/lib/libX11/man/XmbDrawImageString.man +++ b/lib/libX11/man/XmbDrawImageString.man @@ -52,16 +52,16 @@ XmbDrawImageString, XwcDrawImageString, Xutf8DrawImageString \- draw image text .SH SYNTAX .HP void XmbDrawImageString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, -XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, char -*\fIstring\fP\^, int \fInum_bytes\fP\^); +XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^); .HP void XwcDrawImageString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, -wchar_t *\fIstring\fP\^, int \fInum_wchars\fP\^); +_Xconst wchar_t *\fIstring\fP\^, int \fInum_wchars\fP\^); .HP void Xutf8DrawImageString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, -XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, char -*\fIstring\fP\^, int \fInum_bytes\fP\^); +XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^); .SH ARGUMENTS .IP \fId\fP 1i Specifies the drawable. diff --git a/lib/libX11/man/XmbDrawString.man b/lib/libX11/man/XmbDrawString.man index da48940dc..74de253b4 100644 --- a/lib/libX11/man/XmbDrawString.man +++ b/lib/libX11/man/XmbDrawString.man @@ -52,16 +52,16 @@ XmbDrawString, XwcDrawString, Xutf8DrawString \- draw text using a single font s .SH SYNTAX .HP void XmbDrawString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, XFontSet -\fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, char -*\fIstring\fP\^, int \fInum_bytes\fP\^); +\fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^); .HP void XwcDrawString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, XFontSet -\fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, wchar_t -*\fIstring\fP\^, int \fInum_wchars\fP\^); +\fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, +_Xconst wchar_t *\fIstring\fP\^, int \fInum_wchars\fP\^); .HP void Xutf8DrawString\^(\^Display *\fIdisplay\fP\^, Drawable \fId\fP\^, -XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, char -*\fIstring\fP\^, int \fInum_bytes\fP\^); +XFontSet \fIfont_set\fP\^, GC \fIgc\fP\^, int \fIx\fP\^, int \fIy\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^); .SH ARGUMENTS .IP \fId\fP 1i Specifies the drawable. diff --git a/lib/libX11/man/XmbTextEscapement.man b/lib/libX11/man/XmbTextEscapement.man index 5391f68b4..e91263777 100644 --- a/lib/libX11/man/XmbTextEscapement.man +++ b/lib/libX11/man/XmbTextEscapement.man @@ -51,13 +51,16 @@ XmbTextEscapement, XwcTextEscapement, Xutf8TextEscapement \- obtain the escapement of text .SH SYNTAX .HP -int XmbTextEscapement\^(\^XFontSet \fIfont_set\fP\^, char *\fIstring\fP\^, int +int XmbTextEscapement\^(\^XFontSet \fIfont_set\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^); .HP -int XwcTextEscapement\^(\^XFontSet \fIfont_set\fP\^, wchar_t *\fIstring\fP\^, +int XwcTextEscapement\^(\^XFontSet \fIfont_set\fP\^, +_Xconst wchar_t *\fIstring\fP\^, int \fInum_wchars\fP\^); .HP -int Xutf8TextEscapement\^(\^XFontSet \fIfont_set\fP\^, char *\fIstring\fP\^, +int Xutf8TextEscapement\^(\^XFontSet \fIfont_set\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^); .SH ARGUMENTS .IP \fIfont_set\fP 1i diff --git a/lib/libX11/man/XmbTextExtents.man b/lib/libX11/man/XmbTextExtents.man index 01ae8e581..aaa8643ef 100644 --- a/lib/libX11/man/XmbTextExtents.man +++ b/lib/libX11/man/XmbTextExtents.man @@ -51,15 +51,18 @@ XmbTextExtents, XwcTextExtents, Xutf8TextExtents \- compute text extents .SH SYNTAX .HP -int XmbTextExtents\^(\^XFontSet \fIfont_set\fP\^, char *\fIstring\fP\^, int +int XmbTextExtents\^(\^XFontSet \fIfont_set\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^, XRectangle *\fIoverall_ink_return\fP\^, XRectangle *\fIoverall_logical_return\fP\^); .HP -int XwcTextExtents\^(\^XFontSet \fIfont_set\fP\^, wchar_t *\fIstring\fP\^, int +int XwcTextExtents\^(\^XFontSet \fIfont_set\fP\^, +_Xconst wchar_t *\fIstring\fP\^, int \fInum_wchars\fP\^, XRectangle *\fIoverall_ink_return\fP\^, XRectangle *\fIoverall_logical_return\fP\^); .HP -int Xutf8TextExtents\^(\^XFontSet \fIfont_set\fP\^, char *\fIstring\fP\^, int +int Xutf8TextExtents\^(\^XFontSet \fIfont_set\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^, XRectangle *\fIoverall_ink_return\fP\^, XRectangle *\fIoverall_logical_return\fP\^); .SH ARGUMENTS diff --git a/lib/libX11/man/XmbTextListToTextProperty.man b/lib/libX11/man/XmbTextListToTextProperty.man index e97636597..fabcc00d3 100644 --- a/lib/libX11/man/XmbTextListToTextProperty.man +++ b/lib/libX11/man/XmbTextListToTextProperty.man @@ -65,14 +65,17 @@ int Xutf8TextListToTextProperty\^(\^Display *\fIdisplay\fP\^, char **\fIlist\fP\^, int \fIcount\fP\^, XICCEncodingStyle \fIstyle\fP\^, XTextProperty *\fItext_prop_return\fP\^); .HP -int XmbTextPropertyToTextList\^(\^Display *\fIdisplay\fP\^, XTextProperty +int XmbTextPropertyToTextList\^(\^Display *\fIdisplay\fP\^, +_Xconst XTextProperty *\fItext_prop\fP\^, char ***\fIlist_return\fP\^, int *\fIcount_return\fP\^); .HP -int XwcTextPropertyToTextList\^(\^Display *\fIdisplay\fP\^, XTextProperty +int XwcTextPropertyToTextList\^(\^Display *\fIdisplay\fP\^, +_Xconst XTextProperty *\fItext_prop\fP\^, wchar_t ***\fIlist_return\fP\^, int *\fIcount_return\fP\^); .HP -int Xutf8TextPropertyToTextList\^(\^Display *\fIdisplay\fP\^, XTextProperty +int Xutf8TextPropertyToTextList\^(\^Display *\fIdisplay\fP\^, +_Xconst XTextProperty *\fItext_prop\fP\^, char ***\fIlist_return\fP\^, int *\fIcount_return\fP\^); .HP void XwcFreeStringList\^(\^wchar_t **\fIlist\fP\^); diff --git a/lib/libX11/man/XmbTextPerCharExtents.man b/lib/libX11/man/XmbTextPerCharExtents.man index eaa771c1a..f4ecb52a7 100644 --- a/lib/libX11/man/XmbTextPerCharExtents.man +++ b/lib/libX11/man/XmbTextPerCharExtents.man @@ -51,19 +51,22 @@ XmbTextPerCharExtents, XwcTextPerCharExtents, Xutf8TextPerCharExtents \- obtain per-character information for a text string .SH SYNTAX .HP -Status XmbTextPerCharExtents\^(\^XFontSet \fIfont_set\fP\^, char +Status XmbTextPerCharExtents\^(\^XFontSet \fIfont_set\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^, XRectangle *\fIink_array_return\fP\^, XRectangle *\fIlogical_array_return\fP\^, int \fIarray_size\fP\^, int *\fInum_chars_return\fP\^, XRectangle *\fIoverall_ink_return\fP\^, XRectangle *\fIoverall_logical_return\fP\^); .HP -Status XwcTextPerCharExtents\^(\^XFontSet \fIfont_set\fP\^, wchar_t +Status XwcTextPerCharExtents\^(\^XFontSet \fIfont_set\fP\^, +_Xconst wchar_t *\fIstring\fP\^, int \fInum_wchars\fP\^, XRectangle *\fIink_array_return\fP\^, XRectangle *\fIlogical_array_return\fP, int \fIarray_size\fP\^, int *\fInum_chars_return\fP\^, XRectangle *\fIoverall_ink_return\fP\^, XRectangle *\fIoverall_logical_return\fP\^); .HP -Status Xutf8TextPerCharExtents\^(\^XFontSet \fIfont_set\fP\^, char +Status Xutf8TextPerCharExtents\^(\^XFontSet \fIfont_set\fP\^, +_Xconst char *\fIstring\fP\^, int \fInum_bytes\fP\^, XRectangle *\fIink_array_return\fP\^, XRectangle *\fIlogical_array_return\fP\^, int \fIarray_size\fP\^, int *\fInum_chars_return\fP\^, XRectangle *\fIoverall_ink_return\fP\^, XRectangle diff --git a/lib/libX11/man/XrmGetFileDatabase.man b/lib/libX11/man/XrmGetFileDatabase.man index 5cbad8995..dc26ac77b 100644 --- a/lib/libX11/man/XrmGetFileDatabase.man +++ b/lib/libX11/man/XrmGetFileDatabase.man @@ -64,12 +64,12 @@ XrmGetFileDatabase, XrmPutFileDatabase, XrmGetStringDatabase, XrmLocaleOfDatabas .HP XrmDatabase XrmGetFileDatabase\^(\^char *\fIfilename\fP\^); .HP -void XrmPutFileDatabase\^(\^XrmDatabase \fIdatabase\fP\^, char -*\fIstored_db\fP\^); +void XrmPutFileDatabase\^(\^XrmDatabase \fIdatabase\fP\^, +_Xconst char *\fIstored_db\fP\^); .HP -XrmDatabase XrmGetStringDatabase\^(\^char *\fIdata\fP\^); +XrmDatabase XrmGetStringDatabase\^(\^_Xconst char *\fIdata\fP\^); .HP -char *XrmLocaleOfDatabase\^(\^XrmDatabase \fIdatabase\fP\^); +const char *XrmLocaleOfDatabase\^(\^XrmDatabase \fIdatabase\fP\^); .HP XrmDatabase XrmGetDatabase\^(\^Display *\fIdisplay\fP\^); .HP diff --git a/lib/libX11/man/XrmInitialize.man b/lib/libX11/man/XrmInitialize.man index 683ae650a..d674cfef0 100644 --- a/lib/libX11/man/XrmInitialize.man +++ b/lib/libX11/man/XrmInitialize.man @@ -55,7 +55,8 @@ XrmInitialize, XrmParseCommand, XrmValue, XrmOptionKind, XrmOptionDescRec \- ini void XrmInitialize\^(void\^); .HP void XrmParseCommand\^(\^XrmDatabase *\fIdatabase\fP\^, XrmOptionDescList -\fItable\fP\^, int \fItable_count\fP\^, char *\fIname\fP\^, int +\fItable\fP\^, int \fItable_count\fP\^, +_Xconst char *\fIname\fP\^, int *\fIargc_in_out\fP\^, char **\fIargv_in_out\fP\^); .SH ARGUMENTS .IP \fIargc_in_out\fP 1i diff --git a/lib/libX11/man/XrmMergeDatabases.man b/lib/libX11/man/XrmMergeDatabases.man index 2a6ada2f0..db7442ff1 100644 --- a/lib/libX11/man/XrmMergeDatabases.man +++ b/lib/libX11/man/XrmMergeDatabases.man @@ -58,7 +58,7 @@ void XrmMergeDatabases(\^XrmDatabase \fIsource_db\fP, XrmDatabase void XrmCombineDatabase(\^XrmDatabase \fIsource_db\fP, XrmDatabase *\fItarget_db\fP, Bool \fIoverride\fP\^); .HP -Status XrmCombineFileDatabase(\^char *\fIfilename\fP, XrmDatabase +Status XrmCombineFileDatabase(\^_Xconst char *\fIfilename\fP, XrmDatabase *\fItarget_db\fP\^, Bool \fIoverride\fP); .SH ARGUMENTS .IP \fIsource_db\fP 1i diff --git a/lib/libX11/man/XrmPutResource.man b/lib/libX11/man/XrmPutResource.man index 86258f58a..caba2316c 100644 --- a/lib/libX11/man/XrmPutResource.man +++ b/lib/libX11/man/XrmPutResource.man @@ -59,13 +59,13 @@ void XrmQPutResource\^(\^XrmDatabase *\fIdatabase\fP\^, XrmBindingList \fIbindings\fP\^, XrmQuarkList \fIquarks\fP\^, XrmRepresentation \fItype\fP\^, XrmValue *\fIvalue\fP\^); .HP -void XrmPutStringResource\^(\^XrmDatabase *\fIdatabase\fP\^, char -*\fIspecifier\fP\^, char *\fIvalue\fP\^); +void XrmPutStringResource\^(\^XrmDatabase *\fIdatabase\fP\^, _Xconst char +*\fIspecifier\fP\^, _Xconst char *\fIvalue\fP\^); .HP void XrmQPutStringResource\^(\^XrmDatabase *\fIdatabase\fP\^, XrmBindingList -\fIbindings\fP\^, XrmQuarkList \fIquarks\fP\^, char *\fIvalue\fP\^); +\fIbindings\fP\^, XrmQuarkList \fIquarks\fP\^, _Xconst char *\fIvalue\fP\^); .HP -void XrmPutLineResource\^(\^XrmDatabase *\fIdatabase\fP\^, char +void XrmPutLineResource\^(\^XrmDatabase *\fIdatabase\fP\^, _Xconst char *\fIline\fP\^); .SH ARGUMENTS .IP \fIbindings\fP 1i diff --git a/lib/libX11/man/XrmUniqueQuark.man b/lib/libX11/man/XrmUniqueQuark.man index 544ffced6..0be61ea36 100644 --- a/lib/libX11/man/XrmUniqueQuark.man +++ b/lib/libX11/man/XrmUniqueQuark.man @@ -62,7 +62,7 @@ XrmQuark XrmUniqueQuark\^(void); .HP int XrmQuark XrmStringToQuark\^(\^char *\fIstring\fP\^); .HP -XrmQuark XrmPermStringToQuark\^(\^char *\fIstring\fP\^); +XrmQuark XrmPermStringToQuark\^(\^_Xconst char *\fIstring\fP\^); .LP \&#define XrmStringToName(string) XrmStringToQuark(string) .br @@ -72,7 +72,7 @@ XrmQuark XrmPermStringToQuark\^(\^char *\fIstring\fP\^); .HP XrmQuark XrmStringToQuark\^(\^char *\fIstring\fP\^); .HP -XrmQuark XrmPermStringToQuark\^(\^char *\fIstring\fP\^); +XrmQuark XrmPermStringToQuark\^(\^_Xconst char *\fIstring\fP\^); .LP \&#define XrmNameToString(name) XrmQuarkToString(name) .br @@ -90,7 +90,7 @@ char *XrmQuarkToString\^(\^XrmQuark \fIquark\fP\^); void XrmStringToQuarkList\^(\^char *\fIstring\fP\^, XrmQuarkList \fIquarks_return\fP\^); .HP -XrmStringToBindingQuarkList\^(\^char *\fIstring\fP\^, XrmBindingList +void XrmStringToBindingQuarkList\^(\^_Xconst char *\fIstring\fP\^, XrmBindingList \fIbindings_return\fP\^, XrmQuarkList \fIquarks_return\fP\^); .SH ARGUMENTS .IP \fIbindings_return\fP 1i diff --git a/lib/libX11/man/xkb/Makefile.in b/lib/libX11/man/xkb/Makefile.in index 67547df82..54bc6eb5a 100644 --- a/lib/libX11/man/xkb/Makefile.in +++ b/lib/libX11/man/xkb/Makefile.in @@ -54,9 +54,10 @@ subdir = man/xkb DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 am__aclocal_m4_deps = $(top_srcdir)/m4/ax_define_dir.m4 \ - $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \ - $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \ - $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/configure.ac + $(top_srcdir)/m4/ax_gcc_builtin.m4 $(top_srcdir)/m4/libtool.m4 \ + $(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \ + $(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \ + $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) mkinstalldirs = $(install_sh) -d @@ -286,6 +287,7 @@ pdfdir = @pdfdir@ prefix = @prefix@ program_transform_name = @program_transform_name@ psdir = @psdir@ +runstatedir = @runstatedir@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ srcdir = @srcdir@ diff --git a/lib/libX11/man/xkb/XkbAddGeomOverlayRow.man b/lib/libX11/man/xkb/XkbAddGeomOverlayRow.man index 499224e75..6970faf90 100644 --- a/lib/libX11/man/xkb/XkbAddGeomOverlayRow.man +++ b/lib/libX11/man/xkb/XkbAddGeomOverlayRow.man @@ -36,7 +36,7 @@ XkbAddGeomOverlayRow \- Add a row to an existing overlay overlay to be updated .TP .I \- row_under -row to be overlayed in the section overlay overlays +row to be overlaid in the section overlay overlays .TP .I \- sz_keys number of keys to reserve in the row diff --git a/lib/libX11/man/xkb/XkbGetAccessXTimeout.man b/lib/libX11/man/xkb/XkbGetAccessXTimeout.man index 9eb9fd4fa..7378599af 100644 --- a/lib/libX11/man/xkb/XkbGetAccessXTimeout.man +++ b/lib/libX11/man/xkb/XkbGetAccessXTimeout.man @@ -21,7 +21,7 @@ .\" .TH XkbGetAccessXTimeout __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" .SH NAME -XkbGetAccessXTimeout \- Queries the current AccessXTimeout options for a +XkbGetAccessXTimeout \- Queries the current AccessXTimeout options for a keyboard device .SH SYNOPSIS .HP @@ -41,7 +41,7 @@ keyboard device unsigned short .TP .I \- device_spec -device to query, or XkbUseCoreKbd +device to query, or XkbUseCoreKbd .TP .I \- timeout_rtrn delay until AccessXTimeout, seconds @@ -59,51 +59,51 @@ backfilled with ax_options to modify backfilled with values for ax_options .SH DESCRIPTION .LP -In environments where computers are shared, features such as SlowKeys present a -problem: if -SlowKeys is on, the keyboard can appear to be unresponsive because keys are not -accepted -until they are held for a certain period of time. To help solve this problem, -Xkb provides -an AccessXTimeout control to automatically change the enabled/disabled state of -any boolean -controls and to change the value of the AccessXKeys and AccessXFeedback control -attributes +In environments where computers are shared, features such as SlowKeys present a +problem: if +SlowKeys is on, the keyboard can appear to be unresponsive because keys are not +accepted +until they are held for a certain period of time. To help solve this problem, +Xkb provides +an AccessXTimeout control to automatically change the enabled/disabled state of +any boolean +controls and to change the value of the AccessXKeys and AccessXFeedback control +attributes if the keyboard is idle for a specified period of time. -When a timeout as specified by AccessXTimeout occurs and a control is -consequently modified, +When a timeout as specified by AccessXTimeout occurs and a control is +consequently modified, Xkb generates an XkbControlsNotify event. -.I XkbGetAccessXTimeout -sends a request to the X server to obtain the current values for the -AccessXTimeout attributes, waits for a reply, and backfills the values into the -appropriate arguments. The parameters -.I options_mask_rtrn -and -.I options_values_rtrn -are backfilled with the options to modify and the values for -.I ax_options, +.I XkbGetAccessXTimeout +sends a request to the X server to obtain the current values for the +AccessXTimeout attributes, waits for a reply, and backfills the values into the +appropriate arguments. The parameters +.I options_mask_rtrn +and +.I options_values_rtrn +are backfilled with the options to modify and the values for +.I ax_options, which is a field in the XkbControlsRec structure. -.I XkbGetAccessXTimeout -returns True if successful; if a compatible version of the Xkb extension is not -available in the server, -.I XkbGetAccessXTimeout +.I XkbGetAccessXTimeout +returns True if successful; if a compatible version of the Xkb extension is not +available in the server, +.I XkbGetAccessXTimeout returns False. .SH "RETURN VALUES" .TP 15 True -The -.I XkbGetAccessXTimeout -returns True when it successfully sends a request to the X server to obtain the -current values for the AccessXTimeout attributes, waits for a reply, and +The +.I XkbGetAccessXTimeout +returns True when it successfully sends a request to the X server to obtain the +current values for the AccessXTimeout attributes, waits for a reply, and backfills the values into the appropriate arguments. .TP 15 False -The -.I XkbGetAccessXTimeout -funtion returns False if a compatible version of the Xkb extension is not -available in the +The +.I XkbGetAccessXTimeout +function returns False if a compatible version of the Xkb extension is not +available in the server. .SH STRUCTURES .LP @@ -112,7 +112,7 @@ The XkbControlsRec structure is defined as follows: \&#define XkbMaxLegalKeyCode 255 \&#define XkbPerKeyBitArraySize ((XkbMaxLegalKeyCode+1)/8) - + typedef struct { unsigned char mk_dflt_btn; /\(** default button for keyboard driven mouse */ unsigned char num_groups; /\(** number of keyboard groups */ diff --git a/lib/libX11/man/xkb/XkbInitCanonicalKeyTypes.man b/lib/libX11/man/xkb/XkbInitCanonicalKeyTypes.man index 6925becd8..45dde7bcc 100644 --- a/lib/libX11/man/xkb/XkbInitCanonicalKeyTypes.man +++ b/lib/libX11/man/xkb/XkbInitCanonicalKeyTypes.man @@ -22,7 +22,7 @@ .\" .TH XkbInitCanonicalKeyTypes __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" .SH NAME -XkbInitCanonicalKeyTypes \- Set the definitions of the canonical key types in a +XkbInitCanonicalKeyTypes \- Set the definitions of the canonical key types in a client map to their default values .SH SYNOPSIS .HP @@ -44,39 +44,39 @@ mask of types to initialize index of NumLock virtual modifier .SH DESCRIPTION .LP -.I XkbInitCanonicalKeyTypes -initializes the first XkbNumRequiredTypes key types of the keyboard specified by -the -.I xkb -parameter to their default values. The -.I which -parameter specifies what canonical key types to initialize and is a bitwise -inclusive OR of the following masks: XkbOneLevelMask, XkbTwoLevelMask, -XkbAlphabeticMask, and XkbKeypadMask. Only those canonical types specified by -the -.I which +.I XkbInitCanonicalKeyTypes +initializes the first XkbNumRequiredTypes key types of the keyboard specified by +the +.I xkb +parameter to their default values. The +.I which +parameter specifies what canonical key types to initialize and is a bitwise +inclusive OR of the following masks: XkbOneLevelMask, XkbTwoLevelMask, +XkbAlphabeticMask, and XkbKeypadMask. Only those canonical types specified by +the +.I which mask are initialized. -If XkbKeypadMask is set in the -.I which -parameter, -.I XkbInitCanonicalKeyTypes -looks up the NumLock named virtual modifier to determine which virtual modifier -to use when initializing the KEYPAD key type. If the NumLock virtual modifier -does not exist, -.I XkbInitCanonicalKeyTypes +If XkbKeypadMask is set in the +.I which +parameter, +.I XkbInitCanonicalKeyTypes +looks up the NumLock named virtual modifier to determine which virtual modifier +to use when initializing the KEYPAD key type. If the NumLock virtual modifier +does not exist, +.I XkbInitCanonicalKeyTypes creates it. -.I XkbInitCanonicalKeyTypes -normally returns Success. It returns BadAccess if the Xkb extension has not been -properly initialized, and BadAccess if the +.I XkbInitCanonicalKeyTypes +normally returns Success. It returns BadAccess if the Xkb extension has not been +properly initialized, and BadAccess if the xkb parameter is not valid. .SH "RETURN VALUES" .TP 15 Success -The -.I XkbInitCanonicalKeyTypes -funtion return Success if the Xkb extension has been properly initialized and +The +.I XkbInitCanonicalKeyTypes +function return Success if the Xkb extension has been properly initialized and the xkb parameter is valid. .SH DIAGNOSTICS .TP 15 diff --git a/lib/libX11/man/xkb/XkbSelectEvents.man b/lib/libX11/man/xkb/XkbSelectEvents.man index 27ff98b83..09999b923 100644 --- a/lib/libX11/man/xkb/XkbSelectEvents.man +++ b/lib/libX11/man/xkb/XkbSelectEvents.man @@ -22,8 +22,8 @@ .\" .TH XkbSelectEvents __libmansuffix__ __xorgversion__ "XKB FUNCTIONS" .SH NAME -XkbSelectEvents \- Selects and / or deselects for delivery of one or more Xkb -events and has them delivered under all conditions +XkbSelectEvents \- Selects and / or deselects for delivery of one or more Xkb +events and has them delivered under all conditions .SH SYNOPSIS .HP .B Bool XkbSelectEvents @@ -36,7 +36,7 @@ events and has them delivered under all conditions .SH ARGUMENTS .TP .I display -connection to the X server +connection to the X server .TP .I device_spec device ID, or XkbUseCoreKbd @@ -48,68 +48,68 @@ determines events to be selected / deselected 1=>select, 0->deselect; for events in bits_to_change .SH DESCRIPTION .LP -Xkb events are selected using an event mask, much the same as normal core X -events are selected. However, unlike selecting core X events, where you must -specify the selection status (on or off) for all possible event types whenever -you wish to change the selection criteria for any one event, Xkb allows you to -restrict the specification to only the event types you wish to change. This -means that you do not need to remember the event selection values for all +Xkb events are selected using an event mask, much the same as normal core X +events are selected. However, unlike selecting core X events, where you must +specify the selection status (on or off) for all possible event types whenever +you wish to change the selection criteria for any one event, Xkb allows you to +restrict the specification to only the event types you wish to change. This +means that you do not need to remember the event selection values for all possible types each time you want to change one of them. -Many Xkb event types are generated under several different circumstances. When -selecting to receive an Xkb event, you may specify either that you want it -delivered under all circumstances, or that you want it delivered only for a -subset of the possible circumstances. +Many Xkb event types are generated under several different circumstances. When +selecting to receive an Xkb event, you may specify either that you want it +delivered under all circumstances, or that you want it delivered only for a +subset of the possible circumstances. -You can also deselect an event type that was previously selected for, using the +You can also deselect an event type that was previously selected for, using the same granularity. -Xkb provides two functions to select and deselect delivery of Xkb events. -.I XkbSelectEvents -allows you to select or deselect delivery of more than one Xkb -event type at once. Events selected using -.I XkbSelectEvents -are delivered to your program under all circumstances that generate the events. -To restrict delivery of an event to a subset of the conditions under which it -occurs, use -.I XkbSelectEventDetails. XkbSelectEventDetails -only allows you to change the selection conditions for a single event at a time, -but it provides a means of fine-tuning the conditions under which the event is +Xkb provides two functions to select and deselect delivery of Xkb events. +.I XkbSelectEvents +allows you to select or deselect delivery of more than one Xkb +event type at once. Events selected using +.I XkbSelectEvents +are delivered to your program under all circumstances that generate the events. +To restrict delivery of an event to a subset of the conditions under which it +occurs, use +.I XkbSelectEventDetails. XkbSelectEventDetails +only allows you to change the selection conditions for a single event at a time, +but it provides a means of fine-tuning the conditions under which the event is delivered. -This request changes the Xkb event selection mask for the keyboard specified by +This request changes the Xkb event selection mask for the keyboard specified by .I device_spec. Each Xkb event that can be selected is represented by a bit in the -.I bits_to_change -and -.I values_for_bits -masks. Only the event selection bits specified by the -.I bits_to_change -parameter are affected; any unspecified bits are left unchanged. To turn on -event selection for an event, set the bit for the event in the -.I bits_to_change -parameter and set the corresponding bit in the -.I values_for_bits -parameter. To turn off event selection for an event, set the bit for the event -in the -.I bits_to_change -parameter and do not set the corresponding bit in the -.I values_for_bits -parameter. The valid values for both of these parameters are an inclusive -bitwise OR of the masks shown in Table 1. There is no interface to return your -client's current event selection mask. Clients cannot set other clients' event +.I bits_to_change +and +.I values_for_bits +masks. Only the event selection bits specified by the +.I bits_to_change +parameter are affected; any unspecified bits are left unchanged. To turn on +event selection for an event, set the bit for the event in the +.I bits_to_change +parameter and set the corresponding bit in the +.I values_for_bits +parameter. To turn off event selection for an event, set the bit for the event +in the +.I bits_to_change +parameter and do not set the corresponding bit in the +.I values_for_bits +parameter. The valid values for both of these parameters are an inclusive +bitwise OR of the masks shown in Table 1. There is no interface to return your +client's current event selection mask. Clients cannot set other clients' event selection masks. -The X server reports the events defined by Xkb to your client application only -if you have requested them via a call to -.I XkbSelectEvents -or -.I XkbSelectEventDetails. +The X server reports the events defined by Xkb to your client application only +if you have requested them via a call to +.I XkbSelectEvents +or +.I XkbSelectEventDetails. Specify the event types in which you are interested in a mask. -Table 1 lists the event mask constants that can be specified with the -.I XkbSelectEvents +Table 1 lists the event mask constants that can be specified with the +.I XkbSelectEvents request and the circumstances in which the mask should be specified. .TS @@ -120,51 +120,51 @@ Table 1 XkbSelectEvents Mask Constants _ Event Mask Value Notification Wanted _ -XkbNewKeyboardNotifyMask (1L<<0) Keyboard geometry change -XkbMapNotifyMask (1L<<1) Keyboard mapping change -XkbStateNotifyMask (1L<<2) Keyboard state change -XkbControlsNotifyMask (1L<<3) Keyboard control change -XkbIndicatorStateNotifyMask (1L<<4) Keyboard indicator state change -XkbIndicatorMapNotifyMask (1L<<5) Keyboard indicator map change -XkbNamesNotifyMask (1L<<6) Keyboard name change -XkbCompatMapNotifyMask (1L<<7) Keyboard compat map change -XkbBellNotifyMask (1L<<8) Bell -XkbActionMessageMask (1L<<9) Action message -XkbAccessXNotifyMask (1L<<10) AccessX features -XkbExtensionDeviceNotifyMask (1L<<11) Extension device +XkbNewKeyboardNotifyMask (1L<<0) Keyboard geometry change +XkbMapNotifyMask (1L<<1) Keyboard mapping change +XkbStateNotifyMask (1L<<2) Keyboard state change +XkbControlsNotifyMask (1L<<3) Keyboard control change +XkbIndicatorStateNotifyMask (1L<<4) Keyboard indicator state change +XkbIndicatorMapNotifyMask (1L<<5) Keyboard indicator map change +XkbNamesNotifyMask (1L<<6) Keyboard name change +XkbCompatMapNotifyMask (1L<<7) Keyboard compat map change +XkbBellNotifyMask (1L<<8) Bell +XkbActionMessageMask (1L<<9) Action message +XkbAccessXNotifyMask (1L<<10) AccessX features +XkbExtensionDeviceNotifyMask (1L<<11) Extension device XkbAllEventsMask (0xFFF) All Xkb events .TE - -If a bit is not set in the -.I bits_to_change -parameter, but the corresponding bit is set in the -.I values_for_bits -parameter, a BadMatch protocol error results. If an undefined bit is set in -either the -.I bits_to_change -or the -.I values_for_bits + +If a bit is not set in the +.I bits_to_change +parameter, but the corresponding bit is set in the +.I values_for_bits +parameter, a BadMatch protocol error results. If an undefined bit is set in +either the +.I bits_to_change +or the +.I values_for_bits parameter, a BadValue protocol error results. -All event selection bits are initially zero for clients using the Xkb extension. -Once you set some bits, they remain set for your client until you clear them via -another call to -.I XkbSelectEvents. +All event selection bits are initially zero for clients using the Xkb extension. +Once you set some bits, they remain set for your client until you clear them via +another call to +.I XkbSelectEvents. -.I XkbSelectEvents -returns False if the Xkb extension has not been initilialized and True +.I XkbSelectEvents +returns False if the Xkb extension has not been initialized and True otherwise. .SH "RETURN VALUES" .TP 15 True -The -.I XkbSelectEvents -function returns True if the Xkb extension has been initilialized. +The +.I XkbSelectEvents +function returns True if the Xkb extension has been initialized. .TP 15 False -The -.I XkbSelectEvents -function returns False if the Xkb extension has not been initilialized. +The +.I XkbSelectEvents +function returns False if the Xkb extension has not been initialized. .SH "SEE ALSO" .BR XkbSelectEventDetails (__libmansuffix__), .BR XkbUseCoreKbd (__libmansuffix__) |