diff options
Diffstat (limited to 'libX11/specs/libX11/CH09.xml')
| -rw-r--r-- | libX11/specs/libX11/CH09.xml | 232 |
1 files changed, 116 insertions, 116 deletions
diff --git a/libX11/specs/libX11/CH09.xml b/libX11/specs/libX11/CH09.xml index d37e0863a..e239db2e9 100644 --- a/libX11/specs/libX11/CH09.xml +++ b/libX11/specs/libX11/CH09.xml @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"> -<chapter id="window_and_session_manager_functions"> +<chapter id='Window_and_Session_Manager_Functions'> <title>Window and Session Manager Functions</title> <para> @@ -31,12 +31,12 @@ management functions to: <para> <!-- .LP --> To change a window's parent to another window on the same screen, use -<function>XReparentWindow</function>. +<xref linkend='XReparentWindow' xrefstyle='select: title'/>. There is no way to move a window between screens. </para> <indexterm significance="preferred"><primary>XReparentWindow</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xreparentwindow'> +<funcsynopsis id='XReparentWindow'> <funcprototype> <funcdef><function>XReparentWindow</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -104,7 +104,7 @@ Specify the x and y coordinates(Xy. <!-- .LP --> <!-- .eM --> If the specified window is mapped, -<function>XReparentWindow</function> +<xref linkend='XReparentWindow' xrefstyle='select: title'/> automatically performs an <systemitem>UnmapWindow</systemitem> request on it, removes it from its current position in the hierarchy, @@ -115,7 +115,7 @@ sibling windows. <para> <!-- .LP --> After reparenting the specified window, -<function>XReparentWindow</function> +<xref linkend='XReparentWindow' xrefstyle='select: title'/> causes the X server to generate a <symbol>ReparentNotify</symbol> event. @@ -175,7 +175,7 @@ specified window. </itemizedlist> <para> <!-- .LP --> -<function>XReparentWindow</function> +<xref linkend='XReparentWindow' xrefstyle='select: title'/> can generate <errorname>BadMatch</errorname> and @@ -194,7 +194,7 @@ The save-set of a client is a list of other clients' windows that, if they are inferiors of one of the client's windows at connection close, should not be destroyed and should be remapped if they are unmapped. For further information about close-connection processing, -see <link linkend="Using_X_Server_Connection_Close_Operations_">section 2.6</link>. +see <link linkend='Using_X_Server_Connection_Close_Operations'>section 2.6</link>. To allow an application's window to survive when a window manager that has reparented a window fails, Xlib provides the save-set functions that you can @@ -216,11 +216,11 @@ when they are destroyed. <!-- .LP --> <!-- .sp --> To add or remove a window from the client's save-set, use -<function>XChangeSaveSet</function>. +<xref linkend='XChangeSaveSet' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XChangeSaveSet</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xchangesaveset'> +<funcsynopsis id='XChangeSaveSet'> <funcprototype> <funcdef><function>XChangeSaveSet</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -270,7 +270,7 @@ or <!-- .LP --> <!-- .eM --> Depending on the specified mode, -<function>XChangeSaveSet</function> +<xref linkend='XChangeSaveSet' xrefstyle='select: title'/> either inserts or deletes the specified window from the client's save-set. The specified window must have been created by some other client, or a @@ -279,7 +279,7 @@ error results. </para> <para> <!-- .LP --> -<function>XChangeSaveSet</function> +<xref linkend='XChangeSaveSet' xrefstyle='select: title'/> can generate <errorname>BadMatch</errorname>, <errorname>BadValue</errorname>, @@ -291,11 +291,11 @@ errors. <!-- .LP --> <!-- .sp --> To add a window to the client's save-set, use -<function>XAddToSaveSet</function>. +<xref linkend='XAddToSaveSet' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XAddToSaveSet</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xaddtosaveset'> +<funcsynopsis id='XAddToSaveSet'> <funcprototype> <funcdef><function>XAddToSaveSet</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -330,7 +330,7 @@ Specifies the window (Wi. <!-- .LP --> <!-- .eM --> The -<function>XAddToSaveSet</function> +<xref linkend='XAddToSaveSet' xrefstyle='select: title'/> function adds the specified window to the client's save-set. The specified window must have been created by some other client, or a @@ -339,7 +339,7 @@ error results. </para> <para> <!-- .LP --> -<function>XAddToSaveSet</function> +<xref linkend='XAddToSaveSet' xrefstyle='select: title'/> can generate <errorname>BadMatch</errorname> and @@ -350,11 +350,11 @@ errors. <!-- .LP --> <!-- .sp --> To remove a window from the client's save-set, use -<function>XRemoveFromSaveSet</function>. +<xref linkend='XRemoveFromSaveSet' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XRemoveFromSaveSet</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xremovefromsaveset'> +<funcsynopsis id='XRemoveFromSaveSet'> <funcprototype> <funcdef><function>XRemoveFromSaveSet</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -389,7 +389,7 @@ Specifies the window (Wi. <!-- .LP --> <!-- .eM --> The -<function>XRemoveFromSaveSet</function> +<xref linkend='XRemoveFromSaveSet' xrefstyle='select: title'/> function removes the specified window from the client's save-set. The specified window must have been created by some other client, or a @@ -398,7 +398,7 @@ error results. </para> <para> <!-- .LP --> -<function>XRemoveFromSaveSet</function> +<xref linkend='XRemoveFromSaveSet' xrefstyle='select: title'/> can generate <errorname>BadMatch</errorname> and @@ -430,12 +430,12 @@ where M is the minimum number of installed colormaps specified for the screen in the connection setup. The required list is maintained as follows. When a colormap is specified to -<function>XInstallColormap</function>, +<xref linkend='XInstallColormap' xrefstyle='select: title'/>, it is added to the head of the list; the list is truncated at the tail, if necessary, to keep its length to at most M. When a colormap is specified to -<function>XUninstallColormap</function> +<xref linkend='XUninstallColormap' xrefstyle='select: title'/> and it is in the required list, it is removed from the list. A colormap is not added to the required list when it is implicitly installed @@ -447,11 +447,11 @@ required list. <!-- .LP --> <!-- .sp --> To install a colormap, use -<function>XInstallColormap</function>. +<xref linkend='XInstallColormap' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XInstallColormap</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xinstallcolormap'> +<funcsynopsis id='XInstallColormap'> <funcprototype> <funcdef><function>XInstallColormap</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -485,16 +485,16 @@ Specifies the colormap. <!-- .LP --> <!-- .eM --> The -<function>XInstallColormap</function> +<xref linkend='XInstallColormap' xrefstyle='select: title'/> function installs the specified colormap for its associated screen. All windows associated with this colormap immediately display with true colors. You associated the windows with this colormap when you created them by calling -<function>XCreateWindow</function>, -<function>XCreateSimpleWindow</function>, -<function>XChangeWindowAttributes</function>, +<xref linkend='XCreateWindow' xrefstyle='select: title'/>, +<xref linkend='XCreateSimpleWindow' xrefstyle='select: title'/>, +<xref linkend='XChangeWindowAttributes' xrefstyle='select: title'/>, or -<function>XSetWindowColormap</function>. +<xref linkend='XSetWindowColormap' xrefstyle='select: title'/>. </para> <para> <!-- .LP --> @@ -504,14 +504,14 @@ the X server generates a event on each window that has that colormap. In addition, for every other colormap that is installed as a result of a call to -<function>XInstallColormap</function>, +<xref linkend='XInstallColormap' xrefstyle='select: title'/>, the X server generates a <symbol>ColormapNotify</symbol> event on each window that has that colormap. </para> <para> <!-- .LP --> -<function>XInstallColormap</function> +<xref linkend='XInstallColormap' xrefstyle='select: title'/> can generate a <errorname>BadColor</errorname> error. @@ -520,11 +520,11 @@ error. <!-- .LP --> <!-- .sp --> To uninstall a colormap, use -<function>XUninstallColormap</function>. +<xref linkend='XUninstallColormap' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XUninstallColormap</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xuninstallcolormap'> +<funcsynopsis id='XUninstallColormap'> <funcprototype> <funcdef><function>XUninstallColormap</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -558,7 +558,7 @@ Specifies the colormap. <!-- .LP --> <!-- .eM --> The -<function>XUninstallColormap</function> +<xref linkend='XUninstallColormap' xrefstyle='select: title'/> function removes the specified colormap from the required list for its screen. As a result, @@ -575,14 +575,14 @@ the X server generates a event on each window that has that colormap. In addition, for every other colormap that is installed or uninstalled as a result of a call to -<function>XUninstallColormap</function>, +<xref linkend='XUninstallColormap' xrefstyle='select: title'/>, the X server generates a <symbol>ColormapNotify</symbol> event on each window that has that colormap. </para> <para> <!-- .LP --> -<function>XUninstallColormap</function> +<xref linkend='XUninstallColormap' xrefstyle='select: title'/> can generate a <errorname>BadColor</errorname> error. @@ -591,11 +591,11 @@ error. <!-- .LP --> <!-- .sp --> To obtain a list of the currently installed colormaps for a given screen, use -<function>XListInstalledColormaps</function>. +<xref linkend='XListInstalledColormaps' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XListInstalledColormaps</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xlistinstalledcolormaps'> +<funcsynopsis id='XListInstalledColormaps'> <funcprototype> <funcdef>Colormap *<function>XListInstalledColormaps</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -641,18 +641,18 @@ Returns the number of currently installed colormaps. <!-- .LP --> <!-- .eM --> The -<function>XListInstalledColormaps</function> +<xref linkend='XListInstalledColormaps' xrefstyle='select: title'/> function returns a list of the currently installed colormaps for the screen of the specified window. The order of the colormaps in the list is not significant and is no explicit indication of the required list. When the allocated list is no longer needed, free it by using -<function>XFree</function>. +<xref linkend='XFree' xrefstyle='select: title'/>. </para> <para> <!-- .LP --> -<function>XListInstalledColormaps</function> +<xref linkend='XListInstalledColormaps' xrefstyle='select: title'/> can generate a <errorname>BadWindow</errorname> error. @@ -673,11 +673,11 @@ search path for a server. <!-- .LP --> <!-- .sp --> To set the font search path, use -<function>XSetFontPath</function>. +<xref linkend='XSetFontPath' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XSetFontPath</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xsetfontpath'> +<funcsynopsis id='XSetFontPath'> <funcprototype> <funcdef><function>XSetFontPath</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -724,7 +724,7 @@ Specifies the number of directories in the path. <!-- .LP --> <!-- .eM --> The -<function>XSetFontPath</function> +<xref linkend='XSetFontPath' xrefstyle='select: title'/> function defines the directory search path for font lookup. There is only one search path per X server, not one per client. The encoding and interpretation of the strings are implementation-dependent, @@ -742,7 +742,7 @@ The meaning of an error from this request is implementation-dependent. </para> <para> <!-- .LP --> -<function>XSetFontPath</function> +<xref linkend='XSetFontPath' xrefstyle='select: title'/> can generate a <errorname>BadValue</errorname> error. @@ -751,11 +751,11 @@ error. <!-- .LP --> <!-- .sp --> To get the current font search path, use -<function>XGetFontPath</function>. +<xref linkend='XGetFontPath' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XGetFontPath</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xgetfontpath'> +<funcsynopsis id='XGetFontPath'> <funcprototype> <funcdef>char **<function>XGetFontPath</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -789,25 +789,25 @@ Returns the number of strings in the font path array. <!-- .LP --> <!-- .eM --> The -<function>XGetFontPath</function> +<xref linkend='XGetFontPath' xrefstyle='select: title'/> function allocates and returns an array of strings containing the search path. The contents of these strings are implementation-dependent and are not intended to be interpreted by client applications. When it is no longer needed, the data in the font path should be freed by using -<function>XFreeFontPath</function>. +<xref linkend='XFreeFontPath' xrefstyle='select: title'/>. </para> <para> <!-- .LP --> <!-- .sp --> To free data returned by -<function>XGetFontPath</function>, +<xref linkend='XGetFontPath' xrefstyle='select: title'/>, use -<function>XFreeFontPath</function>. +<xref linkend='XFreeFontPath' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XFreeFontPath</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xfreefontpath'> +<funcsynopsis id='XFreeFontPath'> <funcprototype> <funcdef><function>XFreeFontPath</function></funcdef> <paramdef>char<parameter> **list</parameter></paramdef> @@ -830,14 +830,14 @@ Specifies the array of strings you want to free. <!-- .LP --> <!-- .eM --> The -<function>XFreeFontPath</function> +<xref linkend='XFreeFontPath' xrefstyle='select: title'/> function frees the data allocated by -<function>XGetFontPath</function>. +<xref linkend='XGetFontPath' xrefstyle='select: title'/>. </para> </sect1> -<sect1 id="Grabbing_the_Server_"> -<title>Grabbing the Server </title> +<sect1 id='Grabbing_the_Server'> +<title>Grabbing the Server</title> <!-- .XS --> <!-- (SN Grabbing the Server --> <!-- .XE --> @@ -857,13 +857,13 @@ Although grabbing the server is highly discouraged, it is sometimes necessary. <!-- .LP --> <!-- .sp --> To grab the server, use -<function>XGrabServer</function>. +<xref linkend='XGrabServer' xrefstyle='select: title'/>. </para> <indexterm><primary>Server</primary><secondary>grabbing</secondary></indexterm> <indexterm><primary>Grabbing</primary><secondary>server</secondary></indexterm> <indexterm significance="preferred"><primary>XGrabServer</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xgrabserver'> +<funcsynopsis id='XGrabServer'> <funcprototype> <funcdef><function>XGrabServer</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -886,7 +886,7 @@ Specifies the connection to the X server. <!-- .LP --> <!-- .eM --> The -<function>XGrabServer</function> +<xref linkend='XGrabServer' xrefstyle='select: title'/> function disables processing of requests and close downs on all other connections than the one this request arrived on. You should not grab the X server any more than is absolutely necessary. @@ -895,11 +895,11 @@ You should not grab the X server any more than is absolutely necessary. <!-- .LP --> <!-- .sp --> To ungrab the server, use -<function>XUngrabServer</function>. +<xref linkend='XUngrabServer' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XUngrabServer</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xungrabserver'> +<funcsynopsis id='XUngrabServer'> <funcprototype> <funcdef><function>XUngrabServer</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -922,7 +922,7 @@ Specifies the connection to the X server. <!-- .LP --> <!-- .eM --> The -<function>XUngrabServer</function> +<xref linkend='XUngrabServer' xrefstyle='select: title'/> function restarts processing of requests and close downs on other connections. You should avoid grabbing the X server as much as possible. </para> @@ -937,11 +937,11 @@ You should avoid grabbing the X server as much as possible. Xlib provides a function to cause the connection to a client to be closed and its resources to be destroyed. To destroy a client, use -<function>XKillClient</function>. +<xref linkend='XKillClient' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XKillClient</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xkillclient'> +<funcsynopsis id='XKillClient'> <funcprototype> <funcdef><function>XKillClient</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -976,7 +976,7 @@ Specifies any resource associated with the client that you want to destroy or <!-- .LP --> <!-- .eM --> The -<function>XKillClient</function> +<xref linkend='XKillClient' xrefstyle='select: title'/> function forces a close down of the client that created the resource @@ -1003,14 +1003,14 @@ and use the window manager to destroy the zombie windows. </para> <para> <!-- .LP --> -<function>XKillClient</function> +<xref linkend='XKillClient' xrefstyle='select: title'/> can generate a <errorname>BadValue</errorname> error. </para> </sect1> -<sect1 id="Controlling_the_Screen_Saver_"> -<title>Controlling the Screen Saver </title> +<sect1 id='Controlling_the_Screen_Saver'> +<title>Controlling the Screen Saver</title> <!-- .XS --> <!-- (SN Controlling the Screen Saver --> <!-- .XE --> @@ -1024,11 +1024,11 @@ or to obtain the current screen saver values. <!-- .LP --> <!-- .sp --> To set the screen saver mode, use -<function>XSetScreenSaver</function>. +<xref linkend='XSetScreenSaver' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XSetScreenSaver</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xsetscreensaver'> +<funcsynopsis id='XSetScreenSaver'> <funcprototype> <funcdef><function>XSetScreenSaver</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1111,7 +1111,7 @@ Other negative values generate a <errorname>BadValue</errorname> error. If the timeout value is nonzero, -<function>XSetScreenSaver</function> +<xref linkend='XSetScreenSaver' xrefstyle='select: title'/> enables the screen saver. An interval of 0 disables the random-pattern motion. If no input from devices (keyboard, mouse, and so on) is generated @@ -1134,7 +1134,7 @@ and the screen saver is not activated. The screen saver is deactivated, and all screen states are restored at the next keyboard or pointer input or at the next call to -<function>XForceScreenSaver</function> +<xref linkend='XForceScreenSaver' xrefstyle='select: title'/> with mode <symbol>ScreenSaverReset</symbol>. </para> @@ -1150,7 +1150,7 @@ periodically. </para> <para> <!-- .LP --> -<function>XSetScreenSaver</function> +<xref linkend='XSetScreenSaver' xrefstyle='select: title'/> can generate a <errorname>BadValue</errorname> error. @@ -1159,11 +1159,11 @@ error. <!-- .LP --> <!-- .sp --> To force the screen saver on or off, use -<function>XForceScreenSaver</function>. +<xref linkend='XForceScreenSaver' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XForceScreenSaver</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xforcescreensaver'> +<funcsynopsis id='XForceScreenSaver'> <funcprototype> <funcdef><function>XForceScreenSaver</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1203,20 +1203,20 @@ or If the specified mode is <symbol>ScreenSaverActive</symbol> and the screen saver currently is deactivated, -<function>XForceScreenSaver</function> +<xref linkend='XForceScreenSaver' xrefstyle='select: title'/> activates the screen saver even if the screen saver had been disabled with a timeout of zero. If the specified mode is <symbol>ScreenSaverReset</symbol> and the screen saver currently is enabled, -<function>XForceScreenSaver</function> +<xref linkend='XForceScreenSaver' xrefstyle='select: title'/> deactivates the screen saver if it was activated, and the activation timer is reset to its initial state (as if device input had been received). </para> <para> <!-- .LP --> -<function>XForceScreenSaver</function> +<xref linkend='XForceScreenSaver' xrefstyle='select: title'/> can generate a <errorname>BadValue</errorname> error. @@ -1225,11 +1225,11 @@ error. <!-- .LP --> <!-- .sp --> To activate the screen saver, use -<function>XActivateScreenSaver</function>. +<xref linkend='XActivateScreenSaver' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XActivateScreenSaver</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xactivatescreensaver'> +<funcsynopsis id='XActivateScreenSaver'> <funcprototype> <funcdef><function>XActivateScreenSaver</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1253,11 +1253,11 @@ Specifies the connection to the X server. <!-- .eM --> <!-- .sp --> To reset the screen saver, use -<function>XResetScreenSaver</function>. +<xref linkend='XResetScreenSaver' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XResetScreenSaver</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xresetscreensaver'> +<funcsynopsis id='XResetScreenSaver'> <funcprototype> <funcdef><function>XResetScreenSaver</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1281,11 +1281,11 @@ Specifies the connection to the X server. <!-- .eM --> <!-- .sp --> To get the current screen saver values, use -<function>XGetScreenSaver</function>. +<xref linkend='XGetScreenSaver' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XGetScreenSaver</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xgetscreensaver'> +<funcsynopsis id='XGetScreenSaver'> <funcprototype> <funcdef><function>XGetScreenSaver</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1528,11 +1528,11 @@ specify the length in byte of the type and value strings. <!-- .LP --> <!-- .sp --> To add a single host, use -<function>XAddHost</function>. +<xref linkend='XAddHost' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XAddHost</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xaddhost'> +<funcsynopsis id='XAddHost'> <funcprototype> <funcdef><function>XAddHost</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1567,7 +1567,7 @@ Specifies the host that is to be (Ho. <!-- .LP --> <!-- .eM --> The -<function>XAddHost</function> +<xref linkend='XAddHost' xrefstyle='select: title'/> function adds the specified host to the access control list for that display. The server must be on the same host as the client issuing the command, or a <errorname>BadAccess</errorname> @@ -1575,7 +1575,7 @@ error results. </para> <para> <!-- .LP --> -<function>XAddHost</function> +<xref linkend='XAddHost' xrefstyle='select: title'/> can generate <errorname>BadAccess</errorname> and @@ -1586,11 +1586,11 @@ errors. <!-- .LP --> <!-- .sp --> To add multiple hosts at one time, use -<function>XAddHosts</function>. +<xref linkend='XAddHosts' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XAddHosts</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xaddhosts'> +<funcsynopsis id='XAddHosts'> <funcprototype> <funcdef><function>XAddHosts</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1636,7 +1636,7 @@ Specifies the number of hosts. <!-- .LP --> <!-- .eM --> The -<function>XAddHosts</function> +<xref linkend='XAddHosts' xrefstyle='select: title'/> function adds each specified host to the access control list for that display. The server must be on the same host as the client issuing the command, or a <errorname>BadAccess</errorname> @@ -1644,7 +1644,7 @@ error results. </para> <para> <!-- .LP --> -<function>XAddHosts</function> +<xref linkend='XAddHosts' xrefstyle='select: title'/> can generate <errorname>BadAccess</errorname> and @@ -1655,11 +1655,11 @@ errors. <!-- .LP --> <!-- .sp --> To obtain a host list, use -<function>XListHosts</function>. +<xref linkend='XListHosts' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XListHosts</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xlisthosts'> +<funcsynopsis id='XListHosts'> <funcprototype> <funcdef>XHostAddress *<function>XListHosts</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1704,26 +1704,26 @@ Returns the state of the access control. <!-- .LP --> <!-- .eM --> The -<function>XListHosts</function> +<xref linkend='XListHosts' xrefstyle='select: title'/> function returns the current access control list as well as whether the use of the list at connection setup was enabled or disabled. -<function>XListHosts</function> +<xref linkend='XListHosts' xrefstyle='select: title'/> allows a program to find out what machines can make connections. It also returns a pointer to a list of host structures that were allocated by the function. When no longer needed, this memory should be freed by calling -<function>XFree</function>. +<xref linkend='XFree' xrefstyle='select: title'/>. </para> <para> <!-- .LP --> <!-- .sp --> To remove a single host, use -<function>XRemoveHost</function>. +<xref linkend='XRemoveHost' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XRemoveHost</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xremovehost'> +<funcsynopsis id='XRemoveHost'> <funcprototype> <funcdef><function>XRemoveHost</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1758,7 +1758,7 @@ Specifies the host that is to be (Ho. <!-- .LP --> <!-- .eM --> The -<function>XRemoveHost</function> +<xref linkend='XRemoveHost' xrefstyle='select: title'/> function removes the specified host from the access control list for that display. The server must be on the same host as the client process, or a @@ -1770,7 +1770,7 @@ and this operation cannot be reversed unless you reset the server. </para> <para> <!-- .LP --> -<function>XRemoveHost</function> +<xref linkend='XRemoveHost' xrefstyle='select: title'/> can generate <errorname>BadAccess</errorname> and @@ -1781,11 +1781,11 @@ errors. <!-- .LP --> <!-- .sp --> To remove multiple hosts at one time, use -<function>XRemoveHosts</function>. +<xref linkend='XRemoveHosts' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XRemoveHosts</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xremovehosts'> +<funcsynopsis id='XRemoveHosts'> <funcprototype> <funcdef><function>XRemoveHosts</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1831,7 +1831,7 @@ Specifies the number of hosts. <!-- .LP --> <!-- .eM --> The -<function>XRemoveHosts</function> +<xref linkend='XRemoveHosts' xrefstyle='select: title'/> function removes each specified host from the access control list for that display. The X server must be on the same host as the client process, or a @@ -1843,7 +1843,7 @@ and this operation cannot be reversed unless you reset the server. </para> <para> <!-- .LP --> -<function>XRemoveHosts</function> +<xref linkend='XRemoveHosts' xrefstyle='select: title'/> can generate <errorname>BadAccess</errorname> and @@ -1872,11 +1872,11 @@ at connection setup. <!-- .LP --> <!-- .sp --> To change access control, use -<function>XSetAccessControl</function>. +<xref linkend='XSetAccessControl' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XSetAccessControl</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xsetaccesscontrol'> +<funcsynopsis id='XSetAccessControl'> <funcprototype> <funcdef><function>XSetAccessControl</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1914,13 +1914,13 @@ or <!-- .LP --> <!-- .eM --> The -<function>XSetAccessControl</function> +<xref linkend='XSetAccessControl' xrefstyle='select: title'/> function either enables or disables the use of the access control list at each connection setup. </para> <para> <!-- .LP --> -<function>XSetAccessControl</function> +<xref linkend='XSetAccessControl' xrefstyle='select: title'/> can generate <errorname>BadAccess</errorname> and @@ -1931,11 +1931,11 @@ errors. <!-- .LP --> <!-- .sp --> To enable access control, use -<function>XEnableAccessControl</function>. +<xref linkend='XEnableAccessControl' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XEnableAccessControl</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xenableaccesscontrol'> +<funcsynopsis id='XEnableAccessControl'> <funcprototype> <funcdef><function>XEnableAccessControl</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1958,12 +1958,12 @@ Specifies the connection to the X server. <!-- .LP --> <!-- .eM --> The -<function>XEnableAccessControl</function> +<xref linkend='XEnableAccessControl' xrefstyle='select: title'/> function enables the use of the access control list at each connection setup. </para> <para> <!-- .LP --> -<function>XEnableAccessControl</function> +<xref linkend='XEnableAccessControl' xrefstyle='select: title'/> can generate a <errorname>BadAccess</errorname> error. @@ -1972,11 +1972,11 @@ error. <!-- .LP --> <!-- .sp --> To disable access control, use -<function>XDisableAccessControl</function>. +<xref linkend='XDisableAccessControl' xrefstyle='select: title'/>. </para> <indexterm significance="preferred"><primary>XDisableAccessControl</primary></indexterm> <!-- .sM --> -<funcsynopsis id='xdisableaccesscontrol'> +<funcsynopsis id='XDisableAccessControl'> <funcprototype> <funcdef><function>XDisableAccessControl</function></funcdef> <paramdef>Display<parameter> *display</parameter></paramdef> @@ -1999,12 +1999,12 @@ Specifies the connection to the X server. <!-- .LP --> <!-- .eM --> The -<function>XDisableAccessControl</function> +<xref linkend='XDisableAccessControl' xrefstyle='select: title'/> function disables the use of the access control list at each connection setup. </para> <para> <!-- .LP --> -<function>XDisableAccessControl</function> +<xref linkend='XDisableAccessControl' xrefstyle='select: title'/> can generate a <errorname>BadAccess</errorname> error. |