specs: fixup some more xrefs & links

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>

8 files changed, 41 insertions, 66 deletions

diff --git a/specs/CH1.xml b/specs/CH1.xml
index 449cfd7..2dada9e 100644
--- a/specs/CH1.xml
+++ b/specs/CH1.xml
@@ -428,48 +428,12 @@ desired information.
 <!-- .LP -->
 The first few pages of every chapter give an overview of the widgets
 in that section.  Widgets are grouped into chapters by functionality.
-<variablelist>
-  <varlistentry>
-    <term>
-      "Chapter <!-- xref -->
-    </term>
-    <listitem>
-      <para>
-Simple Widgets
-      </para>
-    </listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>
-      "Chapter <!-- xref -->
-    </term>
-    <listitem>
-      <para>
-Menus
-      </para>
-    </listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>
-      "Chapter <!-- xref -->
-    </term>
-    <listitem>
-      <para>
-Text Widgets
-      </para>
-    </listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>
-      "Chapter <!-- xref -->
-    </term>
-    <listitem>
-      <para>
-Composite and Constraint Widget
-    </para>
-  </listitem>
-  </varlistentry>
-</variablelist>
+<itemizedlist>
+  <listitem><para><xref linkend='Simple_Widgets'/></para></listitem>
+  <listitem><para><xref linkend='Menus'/></para></listitem>
+  <listitem><para><xref linkend='Text_Widgets'/></para></listitem>
+  <listitem><para><xref linkend='Composite_and_Constraint_Widgets'/></para></listitem>
+</itemizedlist>
 </para>
 <para>
 <!-- .LP -->
diff --git a/specs/CH5.xml b/specs/CH5.xml
index 03ec8e4..caa9dfa 100644
--- a/specs/CH5.xml
+++ b/specs/CH5.xml
@@ -13,8 +13,9 @@ ease customization.  The AsciiText widget class (actually not limited to
 ASCII but so named for compatibility) is be general enough to most
 needs.  If more flexibility, special features, or extra functionality is
 needed, they can be added by implementing a new TextSource or TextSink, or
-by subclassing the Text Widget (See Section 5.8 for customization
-details.) <!-- xref -->
+by subclassing the Text Widget
+(<link linkend='Customizing_the_Text_Widget'>See Section 5.8</link>
+for customization details.)
 </para>
 <para>
 The words <emphasis remap='I'>insertion point</emphasis> are used in this chapter to refer to the text
diff --git a/specs/Repeater.xml b/specs/Repeater.xml
index 0300d3d..bca5b18 100644
--- a/specs/Repeater.xml
+++ b/specs/Repeater.xml
@@ -21,8 +21,9 @@ Superclass	Command
 </literallayout>
 <para>
 <!-- .LP -->
-The Repeater widget is a subclass of the Command widget; see the <!-- xref -->
-Command documentation for details.  The difference is that the Repeater can call its
+The Repeater widget is a subclass of the Command widget; see the
+<link linkend='Command_Widget'>Command documentation</link>
+for details.  The difference is that the Repeater can call its
 registered callbacks repeatedly, at an increasing rate.  The default translation
 does so for the duration the user holds down pointer button 1 while the pointer
 is on the Repeater.
diff --git a/specs/Scrollbar.xml b/specs/Scrollbar.xml
index cc32791..961a049 100644
--- a/specs/Scrollbar.xml
+++ b/specs/Scrollbar.xml
@@ -389,8 +389,8 @@ used to draw the thumb.
     <listitem>
       <para>
 All functions on this callback list are called when the
-<function>NotifyThumb</function> action is invoked.  See the <function>Scrollbar
-Actions</function> section for details.
+<function>NotifyThumb</function> action is invoked.  See
+<xref linkend="Scrollbar_Actions" /> for details.
       </para>
     </listitem>
   </varlistentry>
@@ -463,8 +463,8 @@ This cursor is used when scrolling forward in a horizontal scrollbar.
     <listitem>
       <para>
 All functions on this callback list may be called when the
-<function>NotifyScroll</function> action is invoked.  See the \fBScrollbar
-Actions\fP section for details.
+<function>NotifyScroll</function> action is invoked.  See
+<xref linkend="Scrollbar_Actions" /> for details.
       </para>
     </listitem>
   </varlistentry>
diff --git a/specs/TextActions.xml b/specs/TextActions.xml
index 2a0f80f..c5b3713 100644
--- a/specs/TextActions.xml
+++ b/specs/TextActions.xml
@@ -363,8 +363,8 @@ triggered by a button event) or text cursor location (if triggered by
 a key event).  It
 will then begin a selection at this location.  If many of these
 selection actions occur quickly in succession then the selection count
-mechanism will be invoked (see the section titled \fBText Selections for
-Application Programmers\fP for details).  <!-- xref -->
+mechanism will be invoked (see
+<xref linkend="Text_Selections_for_Application_Programmers"/> for details).
       </para>
     </listitem>
   </varlistentry>
diff --git a/specs/TextActions_text_widget_actions.xml b/specs/TextActions_text_widget_actions.xml
index 165a8c2..bf264bd 100644
--- a/specs/TextActions_text_widget_actions.xml
+++ b/specs/TextActions_text_widget_actions.xml
@@ -363,8 +363,9 @@ triggered by a button event) or text cursor location (if triggered by
 a key event).  It
 will then begin a selection at this location.  If many of these
 selection actions occur quickly in succession then the selection count
-mechanism will be invoked (see the section titled \fBText Selections for
-Application Programmers\fP for details).  <!-- xref -->
+mechanism will be invoked (see
+<xref linkend="Text_Selections_for_Application_Programmers"/>
+for details).
       </para>
     </listitem>
   </varlistentry>
diff --git a/specs/TextFuncs.xml b/specs/TextFuncs.xml
index 538eca4..61ae5ab 100644
--- a/specs/TextFuncs.xml
+++ b/specs/TextFuncs.xml
@@ -152,7 +152,8 @@ Specifies the character position at which the selection ends.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function>.  <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function>.
 If redisplay is enabled, this function highlights the text and
 makes it the <function>PRIMARY</function> selection.  This function does not have any
 effect on <function>CUT_BUFFER0</function>.
@@ -239,7 +240,8 @@ Returns the end of the text selection.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function>. <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function>.
 If the returned values are equal, no text is currently selected.
 </para>
 </sect2>
@@ -309,7 +311,8 @@ be able to append text to an append-only text widget.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function> and <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function> and
 <function>XawTextBlock</function>.
 </para>
 <para>
@@ -418,7 +421,8 @@ Specifies a text block structure that contains the text to search for.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function> and <function>XawTextBlock</function>. <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link> for a description of
+<function>XawTextPosition</function> and <function>XawTextBlock</function>.
 The <xref linkend='XawTextSearch' xrefstyle='select: title'/> function will begin at the insertion point
 and search in the
 direction specified for a string that matches the one passed in
@@ -476,7 +480,8 @@ Specifies the end of the text to redisplay.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function>. <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function>.
 The <xref linkend='XawTextInvalidate' xrefstyle='select: title'/>
 function causes the specified range of characters to be redisplayed
 immediately if redisplay is enabled or the next time that redisplay is
@@ -635,8 +640,8 @@ Specifies the Text widget.
     </term>
     <listitem>
       <para>
-Specifies a selection array as defined in the section called \fBText
-Selections for Application Programmers\fP.
+Specifies a selection array as defined in
+<xref linkend="Text_Selections_for_Application_Programmers"/>.
     </para>
   </listitem>
   </varlistentry>
@@ -686,7 +691,8 @@ Specifies the new position for the insertion point.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function>. <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function>.
 The text will be scrolled vertically if necessary to make the line
 containing the insertion point visible.  Calling this function is
 equivalent to setting the <function>insertPosition</function> resource.
@@ -719,7 +725,8 @@ Specifies the Text widget.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function>. <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function>.
 The result is equivalent to retrieving the value of the
 <function>insertPosition</function> resource.
 </para>
@@ -774,7 +781,8 @@ of the displayed text.  This is usually set to zero.
 </para>
 <para>
 <!-- .LP -->
-See section 5.4 for a description of <function>XawTextPosition</function>. <!-- xref -->
+<link linkend="Text_Functions">See section 5.4</link>
+for a description of <function>XawTextPosition</function>.
 A display update will be performed if redisplay is enabled.
 </para>
 <para>
diff --git a/specs/Tree.xml b/specs/Tree.xml
index 71cadd1..65bc944 100644
--- a/specs/Tree.xml
+++ b/specs/Tree.xml
@@ -152,7 +152,7 @@ retrieved from the argument list or from the resource database:
       <entry>Height</entry>
       <entry>Dimension</entry>
       <entry>A</entry>
-      <entry>see <function>Layout Semantics</function></entry> <!-- xref -->
+      <entry>see <xref linkend='Tree::Layout_Semantics'/></entry>
     </row>
     <row>
       <entry>hSpace</entry>
@@ -215,7 +215,7 @@ retrieved from the argument list or from the resource database:
       <entry>Width</entry>
       <entry>Dimension</entry>
       <entry>A</entry>
-      <entry>see <function>Layout Semantics</function></entry> <!-- xref -->
+      <entry>see <xref linkend='Tree::Layout_Semantics'/></entry>
     </row>
     <row>
       <entry>x</entry>