New param to control automatic links in index from see and

seealso to indexterm primary.

diff --git a/xsl/params/autolink.index.see.xml b/xsl/params/autolink.index.see.xml
new file mode 100755 (executable)
index 0000000..65af1a3
--- /dev/null
+++ b/xsl/params/autolink.index.see.xml
@@ -0,0 +1,59 @@
+<refentry xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xi="http://www.w3.org/2001/XInclude"
+          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
+          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+          version="5.0" xml:id="autolink.index.see">
+<refmeta>
+<refentrytitle>autolink.index.see</refentrytitle>
+<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>autolink.index.see</refname>
+<refpurpose>Link index see and seealso to index primary</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment xml:id="autolink.index.see.frag"><xsl:param name="autolink.index.see" select="1"/></src:fragment>
+</refsynopsisdiv>
+
+<refsection><info><title>Description</title></info>
+
+<para>If this param is set to a non-zero value,
+(default = 1), then the
+stylesheet will attempt for form a link between a 
+<tag>see</tag> or <tag>seealso</tag> element
+and a matching indexterm <tag>primary</tag> element.
+</para>
+
+<para>The stylesheet uses an exact text match after 
+applying the <literal>normalize-space()</literal> function.
+If the <tag>see</tag> or <tag>seealso</tag> text contains a comma,
+then only the text prior to the comma is used.
+This assumes the author is using the convention "see primary, secondary"
+to specify a subentry.  Thus links always land on the primary
+entry in the index, so the reader has to look down to see the
+secondary entry.</para>
+<para>If there is no match on a 
+<tag>primary</tag>, no link is formed, but the text
+still displays.</para>
+
+<para>No attempt is made to automatically link to text in
+<tag>secondary</tag> or <tag>tertiary</tag> elements.
+</para>
+
+<para>If this parameter is zero, then
+no automatic links from see and seealso
+are formed within the index. </para>
+
+<caution><para>?Trying to form manual links to indexterm
+child elements such as <tag>primary</tag> or
+<tag>secondary</tag> may produce erratic results.
+Duplicate entries in an index are merged during processing, and
+not all id attributes on those child elements are copied through
+to the output.
+</para></caution>
+
+
+</refsection>
+</refentry>