upload tizen2.0 source

[framework/uifw/xorg/lib/libx11.git] / specs / libX11 / CH14.xml

diff --git a/specs/libX11/CH14.xml b/specs/libX11/CH14.xml
old mode 100755 (executable)
new mode 100644 (file)
index 78d0e3f..6dc947a
--- a/specs/libX11/CH14.xml
+++ b/specs/libX11/CH14.xml
@@ -1,24 +1,28 @@
 <?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="inter_client_communication_functions">
+<chapter id='Inter_Client_Communication_Functions'>
 <title>Inter-Client Communication Functions</title>
 <para>
-The Inter-Client Communication Conventions Manual, hereafter referred to as the <acronym>ICCCM</acronym>,
+The <citetitle>Inter-Client Communication Conventions Manual</citetitle>,
+hereafter referred to as the <acronym>ICCCM</acronym>,
 details the X Consortium approved conventions that govern inter-client communications. These
 conventions ensure peer-to-peer client cooperation in the use of selections, cut buffers, and shared
-resources as well as client cooperation with window and session managers. For further informa-
-tion, see the Inter-Client Communication Conventions Manual.
+resources as well as client cooperation with window and session managers. For further information,
+see the <olink targetdoc='icccm' targetptr='icccm'><citetitle>Inter-Client Communication Conventions Manual</citetitle></olink>.
 </para>
 <para>
-Xlib provides a number of standard properties and programming interfaces that are <acronym>ICCCM</acronym> com-
-pliant. The predefined atoms for some of these properties are defined in the &lt;X11/Xatom.h&gt;
-header file, where to avoid name conflicts with user symbols their #define name has an XA_ pre-
-fix. For further information about atoms and properties, see section 4.3.
+Xlib provides a number of standard properties and programming interfaces that are <acronym>ICCCM</acronym>
+compliant. The predefined atoms for some of these properties are defined in the &lt;X11/Xatom.h&gt;
+header file, where to avoid name conflicts with user symbols their #define name has an XA_ prefix.
+For further information about atoms and properties,
+see <link linkend="Properties_and_Atoms">section 4.3</link>.
 </para>
 <para>
 Xlib’s selection and cut buffer mechanisms provide the primary programming interfaces by which
-peer client applications communicate with each other (see sections 4.5 and 16.6). The functions
+peer client applications communicate with each other
+(see sections <link linkend="Selections">4.5</link> and
+<link linkend="Using_Cut_Buffers">16.6</link>). The functions
 discussed in this chapter provide the primary programming interfaces by which client applications
 communicate with their window and session managers as well as share standard colormaps.
 </para>
@@ -27,14 +31,15 @@ The standard properties that are of special interest for communicating with wind
 managers are:
 </para>
 
-<informaltable>
-  <tgroup cols='4' align='center'>
-  <colspec colname='c1'/>
-  <colspec colname='c2'/>
-  <colspec colname='c3'/>
-  <colspec colname='c4'/>
+<informaltable frame='topbot'>
+  <?dbfo keep-together="always" ?>
+  <tgroup cols='4' align='left' colsep='0' rowsep='0'>
+  <colspec colname='c1' colwidth='3.0*'/>
+  <colspec colname='c2' colwidth='2.3*'/>
+  <colspec colname='c3' colwidth='0.9*'/>
+  <colspec colname='c4' colwidth='2.7*'/>
   <thead>
-    <row>
+    <row rowsep='1'>
       <entry>Name</entry>
       <entry>Type</entry>
       <entry>Format</entry>
@@ -57,8 +62,7 @@ managers are:
       <entry>TEXT</entry>
       <entry></entry>
       <entry>The string name of the machine on
-      which the client application is run-
-      ning.
+      which the client application is running.
       </entry>
     </row>
     <row>
@@ -74,7 +78,7 @@ managers are:
       <entry><property>WM_COMMAND</property></entry>
       <entry>TEXT</entry>
       <entry></entry>
-      <entry>The command and arguments, null-
+      <entry>The command and arguments, null
       separated, used to invoke the application.
       </entry>
     </row>
@@ -134,8 +138,7 @@ managers are:
       <entry><property>WM_STATE</property></entry>
       <entry>32</entry>
       <entry>Intended for communication
-      between window and session man-
-      agers only.
+      between window and session managers only.
       </entry>
     </row>
     <row>
@@ -250,16 +253,18 @@ of top-level windows (that is, those that were created as children
 of the root window).
 Note that the subwindows that you create are ignored by window managers.
 Therefore,
-you should use the basic window functions described in chapter 3
+you should use the basic window functions described in
+<link linkend='Window_Functions'>chapter 3</link>
 to manipulate your application's subwindows.
 </para>
 <para>
 <!-- .LP -->
 To request that a top-level window be iconified, use
-<function>XIconifyWindow</function>.
+<xref linkend='XIconifyWindow' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XIconifyWindow</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XIconifyWindow'>
 <funcprototype>
   <funcdef>Status <function>XIconifyWindow</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -300,18 +305,18 @@ Specifies the appropriate screen number on the host server.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XIconifyWindow</function>
+<xref linkend='XIconifyWindow' xrefstyle='select: title'/>
 function sends a <property>WM_CHANGE_STATE</property> 
 <symbol>ClientMessage</symbol>
 event with a format of 32 and a first data element of 
 <symbol>IconicState</symbol>
-(as described in section 4.1.4 of the 
-<emphasis remap='I'>Inter-Client Communication Conventions Manual</emphasis>)
+(as described in <olink targetdoc='icccm' targetptr='Changing_Window_State'
+>section 4.1.4 of the
+<citetitle>Inter-Client Communication Conventions Manual</citetitle></olink>)
 and a window of w
 to the root window of the specified screen
 with an event mask set to
@@ -321,7 +326,7 @@ Window managers may elect to receive this message and
 if the window is in its normal state, 
 may treat it as a request to change the window's state from normal to iconic.
 If the <property>WM_CHANGE_STATE</property> property cannot be interned, 
-<function>XIconifyWindow</function>
+<xref linkend='XIconifyWindow' xrefstyle='select: title'/>
 does not send a message and returns a zero status.
 It returns a nonzero status if the client message is sent successfully;
 otherwise, it returns a zero status.
@@ -330,10 +335,11 @@ otherwise, it returns a zero status.
 <para>
 <!-- .LP -->
 To request that a top-level window be withdrawn, use
-<function>XWithdrawWindow</function>.
+<xref linkend='XWithdrawWindow' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XWithdrawWindow</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XWithdrawWindow'>
 <funcprototype>
   <funcdef>Status <function>XWithdrawWindow</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -374,12 +380,11 @@ Specifies the appropriate screen number on the host server.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XWithdrawWindow</function>
+<xref linkend='XWithdrawWindow' xrefstyle='select: title'/>
 function unmaps the specified window 
 and sends a synthetic 
 <symbol>UnmapNotify</symbol>
@@ -395,7 +400,7 @@ otherwise, it returns a zero status.
 </para>
 <para>
 <!-- .LP -->
-<function>XWithdrawWindow</function>
+<xref linkend='XWithdrawWindow' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -404,10 +409,11 @@ error.
 <para>
 <!-- .LP -->
 To request that a top-level window be reconfigured, use
-<function>XReconfigureWMWindow</function>.
+<xref linkend='XReconfigureWMWindow' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XReconfigureWMWindow</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XReconfigureWMWindow'>
 <funcprototype>
   <funcdef>Status <function>XReconfigureWMWindow</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -474,12 +480,11 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XReconfigureWMWindow</function>
+<xref linkend='XReconfigureWMWindow' xrefstyle='select: title'/>
 function issues a 
 <systemitem>ConfigureWindow</systemitem>
 request on the specified top-level window.
@@ -497,7 +502,7 @@ otherwise, it returns a zero status.
 </para>
 <para>
 <!-- .LP -->
-<function>XReconfigureWMWindow</function>
+<xref linkend='XReconfigureWMWindow' xrefstyle='select: title'/>
 can generate
 <errorname>BadValue</errorname>
 and 
@@ -575,13 +580,14 @@ typedef enum {
 To convert a list of text strings to an 
 <structname>XTextProperty</structname>
 structure, use
-<function>XmbTextListToTextProperty</function>
+<xref linkend='XmbTextListToTextProperty' xrefstyle='select: title'/>
 or
-<function>XwcTextListToTextProperty</function>.
+<xref linkend='XwcTextListToTextProperty' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XmbTextListToTextProperty</primary></indexterm>
 <indexterm significance="preferred"><primary>XwcTextListToTextProperty</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XmbTextListToTextProperty'>
 <funcprototype>
   <funcdef>int <function>XmbTextListToTextProperty</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -592,7 +598,7 @@ or
 </funcprototype>
 </funcsynopsis>
 <!-- .FN -->
-<funcsynopsis>
+<funcsynopsis id='XwcTextListToTextProperty'>
 <funcprototype>
   <funcdef>int <function>XwcTextListToTextProperty</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -657,14 +663,13 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XmbTextListToTextProperty</function>
+<xref linkend='XmbTextListToTextProperty' xrefstyle='select: title'/>
 and
-<function>XwcTextListToTextProperty</function>
+<xref linkend='XwcTextListToTextProperty' xrefstyle='select: title'/>
 functions set the specified 
 <structname>XTextProperty</structname>
 value to a set of null-separated elements representing the concatenation
@@ -729,7 +734,7 @@ is guaranteed.
 <para>
 <!-- .LP -->
 To free the storage for the value field, use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 <!-- .sp -->
 </para>
 <para>
@@ -737,13 +742,14 @@ To free the storage for the value field, use
 To obtain a list of text strings from an 
 <structname>XTextProperty</structname>
 structure, use
-<function>XmbTextPropertyToTextList</function>
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>
 or
-<function>XwcTextPropertyToTextList</function>.
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XmbTextPropertyToTextList</primary></indexterm>
 <indexterm significance="preferred"><primary>XwcTextPropertyToTextList</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XmbTextPropertyToTextList'>
 <funcprototype>
   <funcdef>int <function>XmbTextPropertyToTextList</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -753,7 +759,7 @@ or
 </funcprototype>
 </funcsynopsis>
 <!-- .FN -->
-<funcsynopsis>
+<funcsynopsis id='XwcTextPropertyToTextList'>
 <funcprototype>
   <funcdef>int <function>XwcTextPropertyToTextList</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -808,14 +814,13 @@ Returns the number of (Cn.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XmbTextPropertyToTextList</function>
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>
 and 
-<function>XwcTextPropertyToTextList</function>
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>
 functions return a list of text strings in the current locale representing the
 null-separated elements of the specified
 <structname>XTextProperty</structname>
@@ -832,9 +837,9 @@ any terminating null should not be included in text_prop.nitems.
 <para>
 <!-- .LP -->
 If insufficient memory is available for the list and its elements,
-<function>XmbTextPropertyToTextList</function>
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>
 and
-<function>XwcTextPropertyToTextList</function>
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>
 return 
 <symbol>XNoMemory</symbol>.
 If the current locale is not supported,
@@ -859,9 +864,9 @@ the functions do not set any return values.
 <para>
 <!-- .LP -->
 Otherwise, 
-<function>XmbTextPropertyToTextList</function>
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>
 and
-<function>XwcTextPropertyToTextList</function>
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>
 return the list of null-terminated text strings to list_return
 and the number of text strings to count_return.
 </para>
@@ -876,32 +881,33 @@ To obtain the value of this string,
 use
 <function>XDefaultString</function>.
 Otherwise,
-<function>XmbTextPropertyToTextList</function>
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>
 and
-<function>XwcTextPropertyToTextList</function>
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>
 return 
 <symbol>Success</symbol>.
 </para>
 <para>
 <!-- .LP -->
 To free the storage for the list and its contents returned by
-<function>XmbTextPropertyToTextList</function>,
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>,
 use
-<function>XFreeStringList</function>.
+<xref linkend='XFreeStringList' xrefstyle='select: title'/>.
 To free the storage for the list and its contents returned by
-<function>XwcTextPropertyToTextList</function>,
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>,
 use
-<function>XwcFreeStringList</function>.
+<xref linkend='XwcFreeStringList' xrefstyle='select: title'/>.
 <!-- .sp -->
 </para>
 <para>
 <!-- .LP -->
 To free the in-memory data associated with the specified
 wide character string list, use
-<function>XwcFreeStringList</function>.
+<xref linkend='XwcFreeStringList' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XwcFreeStringList</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XwcFreeStringList'>
 <funcprototype>
   <funcdef>void <function>XwcFreeStringList</function></funcdef>
   <paramdef>wchar_t<parameter> **list</parameter></paramdef>
@@ -920,14 +926,13 @@ Specifies the list of strings to be freed.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XwcFreeStringList</function>
+<xref linkend='XwcFreeStringList' xrefstyle='select: title'/>
 function frees memory allocated by
-<function>XwcTextPropertyToTextList</function>.
+<xref linkend='XwcTextPropertyToTextList' xrefstyle='select: title'/>.
 <!-- .sp -->
 </para>
 <para>
@@ -944,7 +949,7 @@ The
 <function>XDefaultString</function>
 function returns the default string used by Xlib for text conversion
 (for example, in 
-<function>XmbTextPropertyToTextList</function>).
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>).
 The default string is the string in the current locale that is output 
 when an unconvertible character is found during text conversion.
 If the string returned by
@@ -960,7 +965,7 @@ The string returned by
 <function>XDefaultString</function>
 is independent of the default string for text drawing;
 see 
-<function>XCreateFontSet</function>
+<xref linkend='XCreateFontSet' xrefstyle='select: title'/>
 to obtain the default string for an
 <type>XFontSet</type>.
 </para>
@@ -982,10 +987,11 @@ Until freed, it will not be modified by Xlib.
 To set the specified list of strings in the STRING encoding to a 
 <structname>XTextProperty</structname>
 structure, use
-<function>XStringListToTextProperty</function>.
+<xref linkend='XStringListToTextProperty' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XStringListToTextProperty</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XStringListToTextProperty'>
 <funcprototype>
   <funcdef>Status <function>XStringListToTextProperty</function></funcdef>
   <paramdef>char<parameter> **list</parameter></paramdef>
@@ -1029,12 +1035,11 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XStringListToTextProperty</function>
+<xref linkend='XStringListToTextProperty' xrefstyle='select: title'/>
 function sets the specified 
 <structname>XTextProperty</structname>
 to be of type STRING (format 8) with a value representing the
@@ -1043,13 +1048,13 @@ An extra null byte (which is not included in the nitems member)
 is stored at the end of the value field of text_prop_return.
 The strings are assumed (without verification) to be in the STRING encoding.
 If insufficient memory is available for the new value string, 
-<function>XStringListToTextProperty</function>
+<xref linkend='XStringListToTextProperty' xrefstyle='select: title'/>
 does not set any fields in the
 <structname>XTextProperty</structname>
 structure and returns a zero status.
 Otherwise, it returns a nonzero status.
 To free the storage for the value field, use 
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 <!-- .sp -->
 </para>
 <para>
@@ -1057,10 +1062,11 @@ To free the storage for the value field, use
 To obtain a list of strings from a specified
 <structname>XTextProperty</structname>
 structure in the STRING encoding, use
-<function>XTextPropertyToStringList</function>.
+<xref linkend='XTextPropertyToStringList' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XTextPropertyToStringList</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XTextPropertyToStringList'>
 <funcprototype>
   <funcdef>Status <function>XTextPropertyToStringList</function></funcdef>
   <paramdef>XTextProperty<parameter> *text_prop</parameter></paramdef>
@@ -1104,12 +1110,11 @@ Returns the number of (Cn.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XTextPropertyToStringList</function>
+<xref linkend='XTextPropertyToStringList' xrefstyle='select: title'/>
 function returns a list of strings representing the null-separated elements 
 of the specified
 <structname>XTextProperty</structname>
@@ -1120,20 +1125,21 @@ Multiple elements of the property
 are separated by NULL (encoding 0).
 The contents of the property are not null-terminated.
 If insufficient memory is available for the list and its elements, 
-<function>XTextPropertyToStringList</function>
+<xref linkend='XTextPropertyToStringList' xrefstyle='select: title'/>
 sets no return values and returns a zero status.
 Otherwise, it returns a nonzero status.
 To free the storage for the list and its contents, use 
-<function>XFreeStringList</function>.
+<xref linkend='XFreeStringList' xrefstyle='select: title'/>.
 <!-- .sp -->
 </para>
 <para>
 <!-- .LP -->
 To free the in-memory data associated with the specified string list, use
-<function>XFreeStringList</function>.
+<xref linkend='XFreeStringList' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XFreeStringList</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XFreeStringList'>
 <funcprototype>
   <funcdef>void <function>XFreeStringList</function></funcdef>
   <paramdef>char<parameter> **list</parameter></paramdef>
@@ -1152,18 +1158,17 @@ Specifies the list of strings to be freed.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XFreeStringList</function>
+<xref linkend='XFreeStringList' xrefstyle='select: title'/>
 function releases memory allocated by 
-<function>XmbTextPropertyToTextList</function>
+<xref linkend='XmbTextPropertyToTextList' xrefstyle='select: title'/>
 and
-<function>XTextPropertyToStringList</function>
+<xref linkend='XTextPropertyToStringList' xrefstyle='select: title'/>
 and the missing charset list allocated by 
-<function>XCreateFontSet</function>.
+<xref linkend='XCreateFontSet' xrefstyle='select: title'/>.
 </para>
 </sect2>
 <sect2 id="Setting_and_Reading_Text_Properties">
@@ -1181,16 +1186,22 @@ In addition,
 Xlib provides separate convenience functions that you can use to set each 
 of these properties.
 For further information about these convenience functions,
-see sections 14.1.4, 14.1.5, 14.2.1, and 14.2.2, respectively.
+see sections
+<link linkend="Setting_and_Reading_the_WM_NAME_Property">14.1.4</link>,
+<link linkend="Setting_and_Reading_the_WM_ICON_NAME_Property">14.1.5</link>,
+<link linkend="Setting_and_Reading_the_WM_COMMAND_Property">14.2.1</link>, and
+<link linkend="Setting_and_Reading_the_WM_CLIENT_MACHINE_Property">14.2.2</link>,
+respectively.
 <!-- .sp -->
 </para>
 <para>
 <!-- .LP -->
 To set one of a window's text properties, use
-<function>XSetTextProperty</function>.
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetTextProperty</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetTextProperty'>
 <funcprototype>
   <funcdef>void <function>XSetTextProperty</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1244,12 +1255,11 @@ Specifies the property name.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetTextProperty</function>
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>
 function replaces the existing specified property for the named window 
 with the data, type, format, and number of items determined 
 by the value field, the encoding field, the format field, 
@@ -1257,12 +1267,12 @@ and the nitems field, respectively, of the specified
 <structname>XTextProperty</structname>
 structure.
 If the property does not already exist,
-<function>XSetTextProperty</function>
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>
 sets it for the specified window.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetTextProperty</function>
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>,
 <errorname>BadAtom</errorname>,
@@ -1275,10 +1285,11 @@ errors.
 <para>
 <!-- .LP -->
 To read one of a window's text properties, use
-<function>XGetTextProperty</function>.
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetTextProperty</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetTextProperty'>
 <funcprototype>
   <funcdef>Status <function>XGetTextProperty</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1332,12 +1343,11 @@ Specifies the property name.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 function reads the specified property from the window
 and stores the data in the returned
 <structname>XTextProperty</structname>
@@ -1351,7 +1361,7 @@ is stored at the end of the value field of text_prop_return.
 The particular interpretation of the property's encoding 
 and data as text is left to the calling application.
 If the specified property does not exist on the window,
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 sets the value field to NULL, 
 the encoding field to
 <symbol>None</symbol>,
@@ -1363,13 +1373,13 @@ and the nitems field to zero.
 If it was able to read and store the data in the
 <structname>XTextProperty</structname>
 structure,
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 returns a nonzero status; 
 otherwise, it returns a zero status.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 can generate
 <errorname>BadAtom</errorname>
 and 
@@ -1391,10 +1401,11 @@ the <property>WM_NAME</property> property for a given window.
 <para>
 <!-- .LP -->
 To set a window's <property>WM_NAME</property> property with the supplied convenience function, use
-<function>XSetWMName</function>.
+<xref linkend='XSetWMName' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMName'>
 <funcprototype>
   <funcdef>void <function>XSetWMName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1437,24 +1448,24 @@ structure to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetWMName</function>
+<xref linkend='XSetWMName' xrefstyle='select: title'/>
 convenience function calls
-<function>XSetTextProperty</function>
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>
 to set the <property>WM_NAME</property> property.
 <!-- .sp -->
 </para>
 <para>
 <!-- .LP -->
 To read a window's <property>WM_NAME</property> property with the supplied convenience function, use
-<function>XGetWMName</function>.
+<xref linkend='XGetWMName' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMName'>
 <funcprototype>
   <funcdef>Status <function>XGetWMName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1497,14 +1508,13 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetWMName</function>
+<xref linkend='XGetWMName' xrefstyle='select: title'/>
 convenience function calls
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 to obtain the <property>WM_NAME</property> property.
 It returns a nonzero status on success;
 otherwise, it returns a zero status.
@@ -1512,9 +1522,9 @@ otherwise, it returns a zero status.
 <para>
 <!-- .LP -->
 The following two functions have been superseded by
-<function>XSetWMName</function>
+<xref linkend='XSetWMName' xrefstyle='select: title'/>
 and
-<function>XGetWMName</function>,
+<xref linkend='XGetWMName' xrefstyle='select: title'/>,
 respectively. 
 You can use these additional convenience functions 
 for window names that are encoded as STRING properties.
@@ -1523,11 +1533,12 @@ for window names that are encoded as STRING properties.
 <para>
 <!-- .LP -->
 To assign a name to a window, use
-<function>XStoreName</function>.
+<xref linkend='XStoreName' xrefstyle='select: title'/>.
+</para>
 <indexterm><primary>Window</primary><secondary>name</secondary></indexterm>
 <indexterm significance="preferred"><primary>XStoreName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XStoreName'>
 <funcprototype>
   <funcdef><function>XStoreName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1569,12 +1580,11 @@ which should be a null-terminated string.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XStoreName</function>
+<xref linkend='XStoreName' xrefstyle='select: title'/>
 function assigns the name passed to window_name to the specified window.
 A window manager can display the window name in some prominent
 place, such as the title bar, to allow users to identify windows easily.
@@ -1586,7 +1596,7 @@ the result is implementation-dependent.
 </para>
 <para>
 <!-- .LP -->
-<function>XStoreName</function>
+<xref linkend='XStoreName' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -1597,10 +1607,11 @@ errors.
 <!-- .LP -->
 <!-- .sp -->
 To get the name of a window, use
-<function>XFetchName</function>.
+<xref linkend='XFetchName' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XFetchName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XFetchName'>
 <funcprototype>
   <funcdef>Status <function>XFetchName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1641,30 +1652,29 @@ Returns the window name, which is a null-terminated string.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XFetchName</function>
+<xref linkend='XFetchName' xrefstyle='select: title'/>
 function returns the name of the specified window.
 If it succeeds,
 it returns a nonzero status; 
 otherwise, no name has been set for the window,
 and it returns zero.
 If the <property>WM_NAME</property> property has not been set for this window,
-<function>XFetchName</function>
+<xref linkend='XFetchName' xrefstyle='select: title'/>
 sets window_name_return to NULL.
 If the data returned by the server is in the Latin Portable Character Encoding,
 then the returned string is in the Host Portable Character Encoding.
 Otherwise, the result is implementation-dependent.
 When finished with it, a client must free
 the window name string using
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
-<function>XFetchName</function>
+<xref linkend='XFetchName' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -1685,10 +1695,11 @@ the <property>WM_ICON_NAME</property> property for a given window.
 <!-- .sp -->
 To set a window's <property>WM_ICON_NAME</property> property,
 use
-<function>XSetWMIconName</function>.
+<xref linkend='XSetWMIconName' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMIconName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMIconName'>
 <funcprototype>
   <funcdef>void <function>XSetWMIconName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1731,14 +1742,13 @@ structure to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetWMIconName</function>
+<xref linkend='XSetWMIconName' xrefstyle='select: title'/>
 convenience function calls
-<function>XSetTextProperty</function>
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>
 to set the <property>WM_ICON_NAME</property> property.
 <!-- .sp -->
 </para>
@@ -1746,10 +1756,11 @@ to set the <property>WM_ICON_NAME</property> property.
 <!-- .LP -->
 To read a window's <property>WM_ICON_NAME</property> property,
 use
-<function>XGetWMIconName</function>.
+<xref linkend='XGetWMIconName' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMIconName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMIconName'>
 <funcprototype>
   <funcdef>Status <function>XGetWMIconName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1792,14 +1803,13 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetWMIconName</function>
+<xref linkend='XGetWMIconName' xrefstyle='select: title'/>
 convenience function calls
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 to obtain the <property>WM_ICON_NAME</property> property.
 It returns a nonzero status on success;
 otherwise, it returns a zero status.
@@ -1807,9 +1817,9 @@ otherwise, it returns a zero status.
 <para>
 <!-- .LP -->
 The next two functions have been superseded by
-<function>XSetWMIconName</function>
+<xref linkend='XSetWMIconName' xrefstyle='select: title'/>
 and
-<function>XGetWMIconName</function>,
+<xref linkend='XGetWMIconName' xrefstyle='select: title'/>,
 respectively.
 You can use these additional convenience functions 
 for window names that are encoded as STRING properties.
@@ -1819,11 +1829,12 @@ for window names that are encoded as STRING properties.
 <!-- .LP -->
 <!-- .sp -->
 To set the name to be displayed in a window's icon, use
-<function>XSetIconName</function>.
+<xref linkend='XSetIconName' xrefstyle='select: title'/>.
+</para>
 <indexterm><primary>Window</primary><secondary>icon name</secondary></indexterm>
 <indexterm significance="preferred"><primary>XSetIconName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetIconName'>
 <funcprototype>
   <funcdef><function>XSetIconName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1865,13 +1876,12 @@ which should be a null-terminated string.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 If the string is not in the Host Portable Character Encoding,
 the result is implementation-dependent.
-<function>XSetIconName</function>
+<xref linkend='XSetIconName' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -1882,10 +1892,11 @@ errors.
 <!-- .LP -->
 <!-- .sp -->
 To get the name a window wants displayed in its icon, use
-<function>XGetIconName</function>.
+<xref linkend='XGetIconName' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetIconName</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetIconName'>
 <funcprototype>
   <funcdef>Status <function>XGetIconName</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -1927,29 +1938,28 @@ which is a null-terminated string.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetIconName</function>
+<xref linkend='XGetIconName' xrefstyle='select: title'/>
 function returns the name to be displayed in the specified window's icon.
 If it succeeds, it returns a nonzero status; otherwise, 
 if no icon name has been set for the window,
 it returns zero.
 If you never assigned a name to the window,
-<function>XGetIconName</function>
+<xref linkend='XGetIconName' xrefstyle='select: title'/>
 sets icon_name_return to NULL.
 If the data returned by the server is in the Latin Portable Character Encoding,
 then the returned string is in the Host Portable Character Encoding.
 Otherwise, the result is implementation-dependent.
 When finished with it, a client must free
 the icon name string using
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetIconName</function>
+<xref linkend='XGetIconName' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -2002,7 +2012,7 @@ If insufficient memory is available,
 returns NULL.
 To free the memory allocated to this structure,
 use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
@@ -2120,10 +2130,11 @@ or the window to be withdrawn.
 <!-- .LP -->
 <!-- .sp -->
 To set a window's <property>WM_HINTS</property> property, use
-<function>XSetWMHints</function>.
+<xref linkend='XSetWMHints' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMHints</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMHints'>
 <funcprototype>
   <funcdef><function>XSetWMHints</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2166,19 +2177,18 @@ structure to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetWMHints</function>
+<xref linkend='XSetWMHints' xrefstyle='select: title'/>
 function sets the window manager hints that include icon information and location,
 the initial state of the window, and whether the application relies on the
 window manager to get keyboard input.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetWMHints</function>
+<xref linkend='XSetWMHints' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -2189,10 +2199,11 @@ errors.
 <!-- .LP -->
 <!-- .sp -->
 To read a window's <property>WM_HINTS</property> property, use
-<function>XGetWMHints</function>.
+<xref linkend='XGetWMHints' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMHints</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMHints'>
 <funcprototype>
   <funcdef>XWMHints *<function>XGetWMHints</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2222,12 +2233,11 @@ Specifies the window.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetWMHints</function>
+<xref linkend='XGetWMHints' xrefstyle='select: title'/>
 function reads the window manager hints and 
 returns NULL if no <property>WM_HINTS</property> property was set on the window 
 or returns a pointer to an 
@@ -2235,11 +2245,11 @@ or returns a pointer to an
 structure if it succeeds.
 When finished with the data,
 free the space used for it by calling
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetWMHints</function>
+<xref linkend='XGetWMHints' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -2303,7 +2313,7 @@ If insufficient memory is available,
 returns NULL.
 To free the memory allocated to this structure,
 use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
@@ -2386,10 +2396,11 @@ macro is highly discouraged.
 <para>
 <!-- .LP -->
 To set a window's <property>WM_NORMAL_HINTS</property> property, use
-<function>XSetWMNormalHints</function>.
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMNormalHints</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMNormalHints'>
 <funcprototype>
   <funcdef>void <function>XSetWMNormalHints</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2430,22 +2441,21 @@ Specifies the size hints for the window in its normal state.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XSetWMNormalHints</function>
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>
 function replaces the size hints for the <property>WM_NORMAL_HINTS</property> property 
 on the specified window.
 If the property does not already exist,
-<function>XSetWMNormalHints</function>
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>
 sets the size hints for the <property>WM_NORMAL_HINTS</property> property on the specified window.
 The property is stored with a type of <property>WM_SIZE_HINTS</property> and a format of 32.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetWMNormalHints</function>
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -2456,10 +2466,11 @@ errors.
 <para>
 <!-- .LP -->
 To read a window's <property>WM_NORMAL_HINTS</property> property, use
-<function>XGetWMNormalHints</function>.
+<xref linkend='XGetWMNormalHints' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMNormalHints</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMNormalHints'>
 <funcprototype>
   <funcdef>Status <function>XGetWMNormalHints</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2511,18 +2522,17 @@ Returns the hints that were supplied by the user.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetWMNormalHints</function>
+<xref linkend='XGetWMNormalHints' xrefstyle='select: title'/>
 function returns the size hints stored in the <property>WM_NORMAL_HINTS</property> property 
 on the specified window.
 If the property is of type <property>WM_SIZE_HINTS</property>, is of format 32,
 and is long enough to contain either an old (pre-<acronym>ICCCM</acronym>) 
 or new size hints structure, 
-<function>XGetWMNormalHints</function>
+<xref linkend='XGetWMNormalHints' xrefstyle='select: title'/>
 sets the various fields of the 
 <structname>XSizeHints</structname>
 structure, sets the supplied_return argument to the list of fields 
@@ -2533,7 +2543,7 @@ Otherwise, it returns a zero status.
 <para>
 <!-- .LP -->
 If 
-<function>XGetWMNormalHints</function>
+<xref linkend='XGetWMNormalHints' xrefstyle='select: title'/>
 returns successfully and a pre-<acronym>ICCCM</acronym> size hints property is read, 
 the supplied_return argument will contain the following bits:
 </para>
@@ -2558,7 +2568,7 @@ PBaseSize|PWinGravity
 </para>
 <para>
 <!-- .LP -->
-<function>XGetWMNormalHints</function>
+<xref linkend='XGetWMNormalHints' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -2567,10 +2577,11 @@ error.
 <para>
 <!-- .LP -->
 To set a window's <property>WM_SIZE_HINTS</property> property, use
-<function>XSetWMSizeHints</function>.
+<xref linkend='XSetWMSizeHints' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMSizeHints</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMSizeHints'>
 <funcprototype>
   <funcdef>void <function>XSetWMSizeHints</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2624,27 +2635,26 @@ Specifies the property name.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XSetWMSizeHints</function>
+<xref linkend='XSetWMSizeHints' xrefstyle='select: title'/>
 function replaces the size hints for the specified property 
 on the named window.
 If the specified property does not already exist,
-<function>XSetWMSizeHints</function>
+<xref linkend='XSetWMSizeHints' xrefstyle='select: title'/>
 sets the size hints for the specified property
 on the named window.
 The property is stored with a type of <property>WM_SIZE_HINTS</property> and a format of 32.
 To set a window's normal size hints, 
 you can use the 
-<function>XSetWMNormalHints</function>
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>
 function.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetWMSizeHints</function>
+<xref linkend='XSetWMSizeHints' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>,
 <errorname>BadAtom</errorname>,
@@ -2656,10 +2666,11 @@ errors.
 <para>
 <!-- .LP -->
 To read a window's <property>WM_SIZE_HINTS</property> property, use
-<function>XGetWMSizeHints</function>.
+<xref linkend='XGetWMSizeHints' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMSizeHints</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMSizeHints'>
 <funcprototype>
   <funcdef>Status <function>XGetWMSizeHints</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2724,18 +2735,17 @@ Specifies the property name.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetWMSizeHints</function>
+<xref linkend='XGetWMSizeHints' xrefstyle='select: title'/>
 function returns the size hints stored in the specified property 
 on the named window.
 If the property is of type <property>WM_SIZE_HINTS</property>, is of format 32, 
 and is long enough to contain either an old (pre-<acronym>ICCCM</acronym>) 
 or new size hints structure, 
-<function>XGetWMSizeHints</function>
+<xref linkend='XGetWMSizeHints' xrefstyle='select: title'/>
 sets the various fields of the 
 <structname>XSizeHints</structname>
 structure, sets the supplied_return argument to the
@@ -2745,13 +2755,13 @@ and returns a nonzero status.
 Otherwise, it returns a zero status.
 To get a window's normal size hints, 
 you can use the 
-<function>XGetWMNormalHints</function>
+<xref linkend='XGetWMNormalHints' xrefstyle='select: title'/>
 function.
 </para>
 <para>
 <!-- .LP -->
 If 
-<function>XGetWMSizeHints</function>
+<xref linkend='XGetWMSizeHints' xrefstyle='select: title'/>
 returns successfully and a pre-<acronym>ICCCM</acronym> size hints property is read, 
 the supplied_return argument will contain the following bits:
 </para>
@@ -2776,7 +2786,7 @@ PBaseSize|PWinGravity
 </para>
 <para>
 <!-- .LP -->
-<function>XGetWMSizeHints</function>
+<xref linkend='XGetWMSizeHints' xrefstyle='select: title'/>
 can generate
 <errorname>BadAtom</errorname>
 and 
@@ -2833,7 +2843,7 @@ If insufficient memory is available,
 returns NULL.
 To free the memory allocated to this structure,
 use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
@@ -2872,10 +2882,11 @@ resource database.
 <!-- .LP -->
 <!-- .sp -->
 To set a window's <property>WM_CLASS</property> property, use
-<function>XSetClassHint</function>.
+<xref linkend='XSetClassHint' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetClassHint</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetClassHint'>
 <funcprototype>
   <funcdef><function>XSetClassHint</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2918,19 +2929,18 @@ structure that is to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetClassHint</function>
+<xref linkend='XSetClassHint' xrefstyle='select: title'/>
 function sets the class hint for the specified window.
 If the strings are not in the Host Portable Character Encoding,
 the result is implementation-dependent.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetClassHint</function>
+<xref linkend='XSetClassHint' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -2941,10 +2951,11 @@ errors.
 <!-- .LP -->
 <!-- .sp -->
 To read a window's <property>WM_CLASS</property> property, use
-<function>XGetClassHint</function>.
+<xref linkend='XGetClassHint' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetClassHint</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetClassHint'>
 <funcprototype>
   <funcdef>Status <function>XGetClassHint</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -2987,12 +2998,11 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetClassHint</function>
+<xref linkend='XGetClassHint' xrefstyle='select: title'/>
 function returns the class hint of the specified window to the members
 of the supplied structure.
 If the data returned by the server is in the Latin Portable Character Encoding,
@@ -3002,12 +3012,12 @@ It returns a nonzero status on success;
 otherwise, it returns a zero status.
 To free res_name and res_class when finished with the strings,
 use
-<function>XFree</function>
+<xref linkend='XFree' xrefstyle='select: title'/>
 on each individually.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetClassHint</function>
+<xref linkend='XGetClassHint' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -3027,10 +3037,11 @@ the <property>WM_TRANSIENT_FOR</property> property for a given window.
 <!-- .LP -->
 <!-- .sp -->
 To set a window's <property>WM_TRANSIENT_FOR</property> property, use
-<function>XSetTransientForHint</function>.
+<xref linkend='XSetTransientForHint' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetTransientForHint</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetTransientForHint'>
 <funcprototype>
   <funcdef><function>XSetTransientForHint</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3071,18 +3082,17 @@ Specifies the window that the <property>WM_TRANSIENT_FOR</property> property is
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetTransientForHint</function>
+<xref linkend='XSetTransientForHint' xrefstyle='select: title'/>
 function sets the <property>WM_TRANSIENT_FOR</property> property of the specified window to the 
 specified prop_window.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetTransientForHint</function>
+<xref linkend='XSetTransientForHint' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -3093,10 +3103,11 @@ errors.
 <!-- .LP -->
 <!-- .sp -->
 To read a window's <property>WM_TRANSIENT_FOR</property> property, use
-<function>XGetTransientForHint</function>.
+<xref linkend='XGetTransientForHint' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetTransientForHint</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetTransientForHint'>
 <funcprototype>
   <funcdef>Status <function>XGetTransientForHint</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3137,19 +3148,18 @@ Returns the <property>WM_TRANSIENT_FOR</property> property of the specified wind
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetTransientForHint</function>
+<xref linkend='XGetTransientForHint' xrefstyle='select: title'/>
 function returns the <property>WM_TRANSIENT_FOR</property> property for the specified window.
 It returns a nonzero status on success;
 otherwise, it returns a zero status.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetTransientForHint</function>
+<xref linkend='XGetTransientForHint' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -3169,10 +3179,11 @@ the <property>WM_PROTOCOLS</property> property for a given window.
 <!-- .LP -->
 <!-- .sp -->
 To set a window's <property>WM_PROTOCOLS</property> property, use
-<function>XSetWMProtocols</function>.
+<xref linkend='XSetWMProtocols' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMProtocols</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMProtocols'>
 <funcprototype>
   <funcdef>Status <function>XSetWMProtocols</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3225,27 +3236,26 @@ Specifies the number of (Cn.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XSetWMProtocols</function>
+<xref linkend='XSetWMProtocols' xrefstyle='select: title'/>
 function replaces the <property>WM_PROTOCOLS</property> property on the specified window 
 with the list of atoms specified by the protocols argument.
 If the property does not already exist,
-<function>XSetWMProtocols</function>
+<xref linkend='XSetWMProtocols' xrefstyle='select: title'/>
 sets the <property>WM_PROTOCOLS</property> property on the specified window
 to the list of atoms specified by the protocols argument.
 The property is stored with a type of ATOM and a format of 32.
 If it cannot intern the <property>WM_PROTOCOLS</property> atom, 
-<function>XSetWMProtocols</function>
+<xref linkend='XSetWMProtocols' xrefstyle='select: title'/>
 returns a zero status.
 Otherwise, it returns a nonzero status.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetWMProtocols</function>
+<xref linkend='XSetWMProtocols' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -3256,10 +3266,11 @@ errors.
 <para>
 <!-- .LP -->
 To read a window's <property>WM_PROTOCOLS</property> property, use
-<function>XGetWMProtocols</function>.
+<xref linkend='XGetWMProtocols' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMProtocols</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMProtocols'>
 <funcprototype>
   <funcdef>Status <function>XGetWMProtocols</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3312,30 +3323,29 @@ Returns the number of (Cn.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetWMProtocols</function>
+<xref linkend='XGetWMProtocols' xrefstyle='select: title'/>
 function returns the list of atoms stored in the <property>WM_PROTOCOLS</property> property 
 on the specified window.
 These atoms describe window manager protocols in which the owner 
 of this window is willing to participate.
 If the property exists, is of type ATOM, is of format 32, 
 and the atom <property>WM_PROTOCOLS</property> can be interned, 
-<function>XGetWMProtocols</function>
+<xref linkend='XGetWMProtocols' xrefstyle='select: title'/>
 sets the protocols_return argument to a list of atoms, 
 sets the count_return argument to the number of elements in the list, 
 and returns a nonzero status.
 Otherwise, it sets neither of the return arguments
 and returns a zero status.
 To release the list of atoms, use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetWMProtocols</function>
+<xref linkend='XGetWMProtocols' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -3355,10 +3365,11 @@ the <property>WM_COLORMAP_WINDOWS</property> property for a given window.
 <para>
 <!-- .LP -->
 To set a window's <property>WM_COLORMAP_WINDOWS</property> property, use
-<function>XSetWMColormapWindows</function>.
+<xref linkend='XSetWMColormapWindows' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMColormapWindows</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMColormapWindows'>
 <funcprototype>
   <funcdef>Status <function>XSetWMColormapWindows</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3411,27 +3422,26 @@ Specifies the number of (Cn.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XSetWMColormapWindows</function>
+<xref linkend='XSetWMColormapWindows' xrefstyle='select: title'/>
 function replaces the <property>WM_COLORMAP_WINDOWS</property> property on the specified
 window with the list of windows specified by the colormap_windows argument.
 If the property does not already exist,
-<function>XSetWMColormapWindows</function>
+<xref linkend='XSetWMColormapWindows' xrefstyle='select: title'/>
 sets the <property>WM_COLORMAP_WINDOWS</property> property on the specified
 window to the list of windows specified by the colormap_windows argument.
 The property is stored with a type of WINDOW and a format of 32.
 If it cannot intern the <property>WM_COLORMAP_WINDOWS</property> atom,
-<function>XSetWMColormapWindows</function>
+<xref linkend='XSetWMColormapWindows' xrefstyle='select: title'/>
 returns a zero status.
 Otherwise, it returns a nonzero status.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetWMColormapWindows</function>
+<xref linkend='XSetWMColormapWindows' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -3442,10 +3452,11 @@ errors.
 <para>
 <!-- .LP -->
 To read a window's <property>WM_COLORMAP_WINDOWS</property> property, use
-<function>XGetWMColormapWindows</function>.
+<xref linkend='XGetWMColormapWindows' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMColormapWindows</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMColormapWindows'>
 <funcprototype>
   <funcdef>Status <function>XGetWMColormapWindows</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3498,30 +3509,29 @@ Returns the number of (Cn.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetWMColormapWindows</function>
+<xref linkend='XGetWMColormapWindows' xrefstyle='select: title'/>
 function returns the list of window identifiers stored 
 in the <property>WM_COLORMAP_WINDOWS</property> property on the specified window.
 These identifiers indicate the colormaps that the window manager
 may need to install for this window.
 If the property exists, is of type WINDOW, is of format 32, 
 and the atom <property>WM_COLORMAP_WINDOWS</property> can be interned, 
-<function>XGetWMColormapWindows</function>
+<xref linkend='XGetWMColormapWindows' xrefstyle='select: title'/>
 sets the windows_return argument to a list of window identifiers, 
 sets the count_return argument to the number of elements in the list, 
 and returns a nonzero status.
 Otherwise, it sets neither of the return arguments
 and returns a zero status.
 To release the list of window identifiers, use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetWMColormapWindows</function>
+<xref linkend='XGetWMColormapWindows' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -3575,7 +3585,7 @@ If insufficient memory is available,
 returns NULL.
 To free the memory allocated to this structure,
 use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
@@ -3607,10 +3617,11 @@ sizes (minimum to maximum) that represent the supported icon sizes.
 <!-- .LP -->
 <!-- .sp -->
 To set a window's <property>WM_ICON_SIZE</property> property, use
-<function>XSetIconSizes</function>.
+<xref linkend='XSetIconSizes' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetIconSizes</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetIconSizes'>
 <funcprototype>
   <funcdef><function>XSetIconSizes</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3662,17 +3673,16 @@ Specifies the number of items in the size list.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetIconSizes</function>
+<xref linkend='XSetIconSizes' xrefstyle='select: title'/>
 function is used only by window managers to set the supported icon sizes.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetIconSizes</function>
+<xref linkend='XSetIconSizes' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -3683,10 +3693,11 @@ errors.
 <!-- .LP -->
 <!-- .sp -->
 To read a window's <property>WM_ICON_SIZE</property> property, use
-<function>XGetIconSizes</function>.
+<xref linkend='XGetIconSizes' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetIconSizes</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetIconSizes'>
 <funcprototype>
   <funcdef>Status <function>XGetIconSizes</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3738,29 +3749,28 @@ Returns the number of items in the size list.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetIconSizes</function>
+<xref linkend='XGetIconSizes' xrefstyle='select: title'/>
 function returns zero if a window manager has not set icon sizes;
 otherwise, it returns nonzero.
-<function>XGetIconSizes</function>
+<xref linkend='XGetIconSizes' xrefstyle='select: title'/>
 should be called by an application that
 wants to find out what icon sizes would be most appreciated by the
 window manager under which the application is running.
 The application
 should then use
-<function>XSetWMHints</function>
+<xref linkend='XSetWMHints' xrefstyle='select: title'/>
 to supply the window manager with an icon pixmap or window in one of the
 supported sizes.
 To free the data allocated in size_list_return, use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetIconSizes</function>
+<xref linkend='XGetIconSizes' xrefstyle='select: title'/>
 can generate a
 <errorname>BadWindow</errorname>
 error.
@@ -3774,16 +3784,17 @@ error.
 <para>
 <!-- .LP -->
 The 
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 function stores the standard set of window manager properties,
 with text properties in standard encodings
 for internationalized text communication.
 The standard window manager properties for a given window are
 <property>WM_NAME</property>, <property>WM_ICON_NAME</property>, <property>WM_HINTS</property>, <property>WM_NORMAL_HINTS</property>, <property>WM_CLASS</property>,
 <property>WM_COMMAND</property>, <property>WM_CLIENT_MACHINE</property>, and <property>WM_LOCALE_NAME</property>.
+</para>
 <indexterm significance="preferred"><primary>XmbSetWMProperties</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XmbSetWMProperties'>
 <funcprototype>
   <funcdef>void <function>XmbSetWMProperties</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -3896,12 +3907,11 @@ structure to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 convenience function provides a simple programming interface 
 for setting those essential window properties that are used 
 for communicating with other clients
@@ -3910,10 +3920,10 @@ for communicating with other clients
 <para>
 <!-- .LP -->
 If the window_name argument is non-NULL,
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 sets the <property>WM_NAME</property> property.
 If the icon_name argument is non-NULL,
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 sets the <property>WM_ICON_NAME</property> property.
 The window_name and icon_name arguments are null-terminated strings
 in the encoding of the current locale.
@@ -3925,33 +3935,35 @@ and the properties are created with type ``COMPOUND_TEXT''.
 <para>
 <!-- .LP -->
 If the normal_hints argument is non-NULL,
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetWMNormalHints</function>,
-which sets the <property>WM_NORMAL_HINTS</property> property (see section 14.1.7).
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>,
+which sets the <property>WM_NORMAL_HINTS</property> property
+(see <link linkend="Setting_and_Reading_the_WM_NORMAL_HINTS_Property">section 14.1.7</link>).
 If the wm_hints argument is non-NULL, 
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetWMHints</function>,
-which sets the <property>WM_HINTS</property> property (see section 14.1.6).
+<xref linkend='XSetWMHints' xrefstyle='select: title'/>,
+which sets the <property>WM_HINTS</property> property
+(see <link linkend="Setting_and_Reading_the_WM_HINTS_Property">section 14.1.6</link>).
 </para>
 <para>
 <!-- .LP -->
 If the argv argument is non-NULL,
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 sets the <property>WM_COMMAND</property> property from argv and argc.
 An argc of zero indicates a zero-length command.
 </para>
 <para>
 <!-- .LP -->
 The hostname of the machine is stored using 
-<function>XSetWMClientMachine</function>
-(see section 14.2.2).
+<xref linkend='XSetWMClientMachine' xrefstyle='select: title'/>
+(see <link linkend="Setting_and_Reading_the_WM_CLIENT_MACHINE_Property">section 14.2.2</link>).
 </para>
 <para>
 <!-- .LP -->
 If the class_hints argument is non-NULL,
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 sets the <property>WM_CLASS</property> property.
 If the res_name member in the 
 <structname>XClassHint</structname>
@@ -3976,14 +3988,14 @@ No encoding conversion is performed prior to storage in the properties.
 <para>
 <!-- .LP -->
 For clients that need to process the property text in a locale,
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 sets the <property>WM_LOCALE_NAME</property> property to be the name of the current locale.
 The name is assumed to be in the Host Portable Character Encoding
 and is converted to STRING for storage in the property.
 </para>
 <para>
 <!-- .LP -->
-<function>XmbSetWMProperties</function>
+<xref linkend='XmbSetWMProperties' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -3995,13 +4007,14 @@ errors.
 <!-- .LP -->
 To set a window's standard window manager properties
 with strings in client-specified encodings, use
-<function>XSetWMProperties</function>.
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>.
 The standard window manager properties for a given window are
 <property>WM_NAME</property>, <property>WM_ICON_NAME</property>, <property>WM_HINTS</property>, <property>WM_NORMAL_HINTS</property>, <property>WM_CLASS</property>,
 <property>WM_COMMAND</property>, and <property>WM_CLIENT_MACHINE</property>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMProperties</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMProperties'>
 <funcprototype>
   <funcdef>void <function>XSetWMProperties</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -4114,12 +4127,11 @@ structure to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 convenience function provides a single programming interface 
 for setting those essential window properties that are used 
 for communicating with other clients (particularly window and session
@@ -4128,45 +4140,51 @@ managers).
 <para>
 <!-- .LP -->
 If the window_name argument is non-NULL, 
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetWMName</function>,
-which, in turn, sets the <property>WM_NAME</property> property (see section 14.1.4).
+<xref linkend='XSetWMName' xrefstyle='select: title'/>,
+which, in turn, sets the <property>WM_NAME</property> property
+(see <link linkend="Setting_and_Reading_the_WM_NAME_Property">section 14.1.4</link>).
 If the icon_name argument is non-NULL,
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetWMIconName</function>,
-which sets the <property>WM_ICON_NAME</property> property (see section 14.1.5).
+<xref linkend='XSetWMIconName' xrefstyle='select: title'/>,
+which sets the <property>WM_ICON_NAME</property> property
+(see <link linkend="Setting_and_Reading_the_WM_ICON_NAME_Property">section 14.1.5</link>).
 If the argv argument is non-NULL, 
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetCommand</function>,
-which sets the <property>WM_COMMAND</property> property (see section 14.2.1).
+<xref linkend='XSetCommand' xrefstyle='select: title'/>,
+which sets the <property>WM_COMMAND</property> property
+(see <link linkend="Setting_and_Reading_the_WM_COMMAND_Property">section 14.2.1</link>).
 Note that an argc of zero is allowed to indicate a zero-length command.
 Note also that the hostname of this machine is stored using
-<function>XSetWMClientMachine</function>
-(see section 14.2.2).
+<xref linkend='XSetWMClientMachine' xrefstyle='select: title'/>
+(see <link linkend="Setting_and_Reading_the_WM_CLIENT_MACHINE_Property">section 14.2.2</link>).
 </para>
 <para>
 <!-- .LP -->
 If the normal_hints argument is non-NULL, 
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetWMNormalHints</function>,
-which sets the <property>WM_NORMAL_HINTS</property> property (see section 14.1.7).
+<xref linkend='XSetWMNormalHints' xrefstyle='select: title'/>,
+which sets the <property>WM_NORMAL_HINTS</property> property
+(see <link linkend="Setting_and_Reading_the_WM_NORMAL_HINTS_Property">section 14.1.7</link>).
 If the wm_hints argument is non-NULL, 
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetWMHints</function>,
-which sets the <property>WM_HINTS</property> property (see section 14.1.6).
+<xref linkend='XSetWMHints' xrefstyle='select: title'/>,
+which sets the <property>WM_HINTS</property> property
+(see <link linkend="Setting_and_Reading_the_WM_HINTS_Property">section 14.1.6</link>).
 </para>
 <para>
 <!-- .LP -->
 If the class_hints argument is non-NULL, 
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 calls
-<function>XSetClassHint</function>,
-which sets the <property>WM_CLASS</property> property (see section 14.1.8).
+<xref linkend='XSetClassHint' xrefstyle='select: title'/>,
+which sets the <property>WM_CLASS</property> property
+(see <link linkend="Setting_and_Reading_the_WM_CLASS_Property">section 14.1.8</link>).
 If the res_name member in the
 <structname>XClassHint</structname>
 structure is set to the NULL pointer and the RESOURCE_NAME environment 
@@ -4180,7 +4198,7 @@ any directory prefixes, is substituted for res_name.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetWMProperties</function>
+<xref linkend='XSetWMProperties' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -4224,10 +4242,11 @@ the <property>WM_COMMAND</property> property for a given window.
 <para>
 <!-- .LP -->
 To set a window's <property>WM_COMMAND</property> property, use
-<function>XSetCommand</function>.
+<xref linkend='XSetCommand' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetCommand</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetCommand'>
 <funcprototype>
   <funcdef><function>XSetCommand</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -4279,12 +4298,11 @@ Specifies the number of arguments.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetCommand</function>
+<xref linkend='XSetCommand' xrefstyle='select: title'/>
 function sets the command and arguments used to invoke the
 application.
 (Typically, argv is the argv array of your main program.)
@@ -4293,7 +4311,7 @@ the result is implementation-dependent.
 </para>
 <para>
 <!-- .LP -->
-<function>XSetCommand</function>
+<xref linkend='XSetCommand' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>
 and
@@ -4304,10 +4322,11 @@ errors.
 <para>
 <!-- .LP -->
 To read a window's <property>WM_COMMAND</property> property, use
-<function>XGetCommand</function>.
+<xref linkend='XGetCommand' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetCommand</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetCommand'>
 <funcprototype>
   <funcdef>Status <function>XGetCommand</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -4359,18 +4378,17 @@ Returns the number of arguments returned.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetCommand</function>
+<xref linkend='XGetCommand' xrefstyle='select: title'/>
 function reads the <property>WM_COMMAND</property> property from the specified window 
 and returns a string list.
 If the <property>WM_COMMAND</property> property exists, 
 it is of type STRING and format 8.
 If sufficient memory can be allocated to contain the string list, 
-<function>XGetCommand</function>
+<xref linkend='XGetCommand' xrefstyle='select: title'/>
 fills in the argv_return and argc_return arguments
 and returns a nonzero status.
 Otherwise, it returns a zero status.
@@ -4378,7 +4396,7 @@ If the data returned by the server is in the Latin Portable Character Encoding,
 then the returned strings are in the Host Portable Character Encoding.
 Otherwise, the result is implementation-dependent.
 To free the memory allocated to the string list, use
-<function>XFreeStringList</function>.
+<xref linkend='XFreeStringList' xrefstyle='select: title'/>.
 </para>
 </sect2>
 <sect2 id="Setting_and_Reading_the_WM_CLIENT_MACHINE_Property">
@@ -4395,10 +4413,11 @@ the <property>WM_CLIENT_MACHINE</property> property for a given window.
 <para>
 <!-- .LP -->
 To set a window's <property>WM_CLIENT_MACHINE</property> property, use
-<function>XSetWMClientMachine</function>.
+<xref linkend='XSetWMClientMachine' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetWMClientMachine</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetWMClientMachine'>
 <funcprototype>
   <funcdef>void <function>XSetWMClientMachine</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -4441,24 +4460,24 @@ structure to be used.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XSetWMClientMachine</function>
+<xref linkend='XSetWMClientMachine' xrefstyle='select: title'/>
 convenience function calls
-<function>XSetTextProperty</function>
+<xref linkend='XSetTextProperty' xrefstyle='select: title'/>
 to set the <property>WM_CLIENT_MACHINE</property> property.
 <!-- .sp -->
 </para>
 <para>
 <!-- .LP -->
 To read a window's <property>WM_CLIENT_MACHINE</property> property, use
-<function>XGetWMClientMachine</function>.
+<xref linkend='XGetWMClientMachine' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetWMClientMachine</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetWMClientMachine'>
 <funcprototype>
   <funcdef>Status <function>XGetWMClientMachine</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -4501,14 +4520,13 @@ structure.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The
-<function>XGetWMClientMachine</function>
+<xref linkend='XGetWMClientMachine' xrefstyle='select: title'/>
 convenience function performs an 
-<function>XGetTextProperty</function>
+<xref linkend='XGetTextProperty' xrefstyle='select: title'/>
 on the <property>WM_CLIENT_MACHINE</property> property.
 It returns a nonzero status on success;
 otherwise, it returns a zero status.
@@ -4644,7 +4662,7 @@ If insufficient memory is available,
 returns NULL.
 To free the memory allocated to this structure,
 use
-<function>XFree</function>.
+<xref linkend='XFree' xrefstyle='select: title'/>.
 </para>
 <para>
 <!-- .LP -->
@@ -4677,7 +4695,7 @@ typedef struct {
 <!-- .LP -->
 <!-- .eM -->
 The colormap member is the colormap created by the
-<function>XCreateColormap</function>
+<xref linkend='XCreateColormap' xrefstyle='select: title'/>
 function.
 The red_max, green_max, and blue_max members give the maximum
 red, green, and blue values, respectively.  
@@ -4705,7 +4723,7 @@ green_mult might be 6, and blue_mult might be 1.
 The base_pixel member gives the base pixel value used to
 compose a full pixel value.  
 Usually, the base_pixel is obtained from a call to the 
-<function>XAllocColorPlanes</function>
+<xref linkend='XAllocColorPlanes' xrefstyle='select: title'/>
 function.  
 Given integer red, green, and blue coefficients in their appropriate 
 ranges, one then can compute a corresponding pixel value by
@@ -4756,7 +4774,7 @@ colormap was created.
 The killid member gives a resource ID that indicates whether
 the cells held by this standard colormap are to be released 
 by freeing the colormap ID or by calling the
-<function>XKillClient</function>
+<xref linkend='XKillClient' xrefstyle='select: title'/>
 function on the indicated resource.
 (Note that this method is necessary for allocating out of an existing colormap.)
 </para>
@@ -4917,10 +4935,11 @@ structure.
 To set an
 <structname>XStandardColormap</structname>
 structure, use
-<function>XSetRGBColormaps</function>.
+<xref linkend='XSetRGBColormaps' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XSetRGBColormaps</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XSetRGBColormaps'>
 <funcprototype>
   <funcdef>void <function>XSetRGBColormaps</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -4986,16 +5005,15 @@ Specifies the property name.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XSetRGBColormaps</function>
+<xref linkend='XSetRGBColormaps' xrefstyle='select: title'/>
 function replaces the <acronym>RGB</acronym> colormap definition in the specified property 
 on the named window.
 If the property does not already exist,
-<function>XSetRGBColormaps</function>
+<xref linkend='XSetRGBColormaps' xrefstyle='select: title'/>
 sets the <acronym>RGB</acronym> colormap definition in the specified property
 on the named window.
 The property is stored with a type of RGB_COLOR_MAP and a format of 32.
@@ -5005,7 +5023,7 @@ restriction that only RGB_DEFAULT_MAP contain more than one definition.
 <para>
 <!-- .LP -->
 The
-<function>XSetRGBColormaps</function>
+<xref linkend='XSetRGBColormaps' xrefstyle='select: title'/>
 function usually is only used by window or session managers.
 To create a standard colormap, 
 follow this procedure:
@@ -5051,7 +5069,7 @@ Allocate cells in the colormap (or create it with
   <listitem>
     <para>
 Call 
-<function>XStoreColors</function>
+<xref linkend='XStoreColors' xrefstyle='select: title'/>
 to store appropriate color values in the colormap.
     </para>
   </listitem>
@@ -5070,7 +5088,7 @@ Attach the property to the root window.
   <listitem>
     <para>
 Use
-<function>XSetCloseDownMode</function>
+<xref linkend='XSetCloseDownMode' xrefstyle='select: title'/>
 to make the resource permanent.
 <!-- .RE -->
     </para>
@@ -5083,7 +5101,7 @@ Ungrab the server.
 </itemizedlist>
 <para>
 <!-- .LP -->
-<function>XSetRGBColormaps</function>
+<xref linkend='XSetRGBColormaps' xrefstyle='select: title'/>
 can generate
 <errorname>BadAlloc</errorname>,
 <errorname>BadAtom</errorname>,
@@ -5097,10 +5115,11 @@ errors.
 To obtain the 
 <structname>XStandardColormap</structname>
 structure associated with the specified property, use
-<function>XGetRGBColormaps</function>.
+<xref linkend='XGetRGBColormaps' xrefstyle='select: title'/>.
+</para>
 <indexterm significance="preferred"><primary>XGetRGBColormaps</primary></indexterm>
 <!-- .sM -->
-<funcsynopsis>
+<funcsynopsis id='XGetRGBColormaps'>
 <funcprototype>
   <funcdef>Status <function>XGetRGBColormaps</function></funcdef>
   <paramdef>Display<parameter> *display</parameter></paramdef>
@@ -5166,35 +5185,34 @@ Specifies the property name.
   </listitem>
   </varlistentry>
 </variablelist>
-</para>
 <para>
 <!-- .LP -->
 <!-- .eM -->
 The 
-<function>XGetRGBColormaps</function>
+<xref linkend='XGetRGBColormaps' xrefstyle='select: title'/>
 function returns the <acronym>RGB</acronym> colormap definitions stored 
 in the specified property on the named window.
 If the property exists, is of type RGB_COLOR_MAP, is of format 32, 
 and is long enough to contain a colormap definition,
-<function>XGetRGBColormaps</function>
+<xref linkend='XGetRGBColormaps' xrefstyle='select: title'/>
 allocates and fills in space for the returned colormaps
 and returns a nonzero status.
 If the visualid is not present, 
-<function>XGetRGBColormaps</function>
+<xref linkend='XGetRGBColormaps' xrefstyle='select: title'/>
 assumes the default visual for the screen on which the window is located; 
 if the killid is not present, 
 <symbol>None</symbol>
 is assumed, which indicates that the resources cannot be released.
 Otherwise, 
 none of the fields are set, and 
-<function>XGetRGBColormaps</function>
+<xref linkend='XGetRGBColormaps' xrefstyle='select: title'/>
 returns a zero status.
 Note that it is the caller's responsibility to honor the <acronym>ICCCM</acronym>
 restriction that only RGB_DEFAULT_MAP contain more than one definition.
 </para>
 <para>
 <!-- .LP -->
-<function>XGetRGBColormaps</function>
+<xref linkend='XGetRGBColormaps' xrefstyle='select: title'/>
 can generate
 <errorname>BadAtom</errorname>
 and