remove tool dirctories - these have been moved to a new github dirctory
[Evergreen-DocBook.git] / stylesheets / styleguide / docbook-xsl-1.75.2 / params / make.index.markup.xml
diff --git a/stylesheets/styleguide/docbook-xsl-1.75.2/params/make.index.markup.xml b/stylesheets/styleguide/docbook-xsl-1.75.2/params/make.index.markup.xml
deleted file mode 100755 (executable)
index 74b4f4d..0000000
+++ /dev/null
@@ -1,73 +0,0 @@
-<refentry xmlns="http://docbook.org/ns/docbook"\r
-          xmlns:xlink="http://www.w3.org/1999/xlink"\r
-          xmlns:xi="http://www.w3.org/2001/XInclude"\r
-          xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
-          xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
-          version="5.0" xml:id="make.index.markup">\r
-<refmeta>\r
-<refentrytitle>make.index.markup</refentrytitle>\r
-<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
-</refmeta>\r
-<refnamediv>\r
-<refname>make.index.markup</refname>\r
-<refpurpose>Generate XML index markup in the index?</refpurpose>\r
-</refnamediv>\r
-\r
-<refsynopsisdiv>\r
-<src:fragment xml:id="make.index.markup.frag">\r
-<xsl:param name="make.index.markup" select="0"/>\r
-</src:fragment>\r
-</refsynopsisdiv>\r
-\r
-<refsection><info><title>Description</title></info>\r
-\r
-<para>This parameter enables a very neat trick for getting properly\r
-merged, collated back-of-the-book indexes. G. Ken Holman suggested\r
-this trick at Extreme Markup Languages 2002 and I'm indebted to him\r
-for it.</para>\r
-\r
-<para>Jeni Tennison's excellent code in\r
-<filename>autoidx.xsl</filename> does a great job of merging and\r
-sorting <tag>indexterm</tag>s in the document and building a\r
-back-of-the-book index. However, there's one thing that it cannot\r
-reasonably be expected to do: merge page numbers into ranges. (I would\r
-not have thought that it could collate and suppress duplicate page\r
-numbers, but in fact it appears to manage that task somehow.)</para>\r
-\r
-<para>Ken's trick is to produce a document in which the index at the\r
-back of the book is <quote>displayed</quote> in XML. Because the index\r
-is generated by the FO processor, all of the page numbers have been resolved.\r
-It's a bit hard to explain, but what it boils down to is that instead of having\r
-an index at the back of the book that looks like this:</para>\r
-\r
-<blockquote>\r
-<formalpara><info><title>A</title></info>\r
-<para>ap1, 1, 2, 3</para>\r
-</formalpara>\r
-</blockquote>\r
-\r
-<para>you get one that looks like this:</para>\r
-\r
-<blockquote>\r
-<programlisting>&lt;indexdiv&gt;A&lt;/indexdiv&gt;\r
-&lt;indexentry&gt;\r
-&lt;primaryie&gt;ap1&lt;/primaryie&gt;,\r
-&lt;phrase role="pageno"&gt;1&lt;/phrase&gt;,\r
-&lt;phrase role="pageno"&gt;2&lt;/phrase&gt;,\r
-&lt;phrase role="pageno"&gt;3&lt;/phrase&gt;\r
-&lt;/indexentry&gt;</programlisting>\r
-</blockquote>\r
-\r
-<para>After building a PDF file with this sort of odd-looking index, you can\r
-extract the text from the PDF file and the result is a proper index expressed in\r
-XML.</para>\r
-\r
-<para>Now you have data that's amenable to processing and a simple Perl script\r
-(such as <filename>fo/pdf2index</filename>) can\r
-merge page ranges and generate a proper index.</para>\r
-\r
-<para>Finally, reformat your original document using this literal index instead of\r
-an automatically generated one and <quote>bingo</quote>!</para>\r
-\r
-</refsection>\r
-</refentry>\r