summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html53
1 files changed, 53 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html
new file mode 100644
index 00000000000..f0a1f6ca76d
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html
@@ -0,0 +1,53 @@
+<head>
+<title>UK TeX FAQ -- question label makeindex</title>
+</head><body>
+<h3>Generating an index in (La)TeX</h3>
+<p/>Making an index is not trivial; what to index, and how to index it, is
+difficult to decide, and uniform implementation is difficult to
+achieve. You will need to mark all items to be indexed in your text
+(typically with <code>\</code><code>index</code> commands).
+<p/>It is not practical to sort a large index within TeX, so a
+post-processing program is used to sort the output of one TeX run,
+to be included into the document at the next run.
+<p/>The following programs are available:
+<dl>
+<dt>makeindex<dd> Comes with most distributions &mdash; a good workhorse,
+ but is not well-arranged to deal with other sort orders than the
+ canonical ASCII ordering.
+<p/> The <i>makeindex</i> documentation is a good source of
+ information on how to create your own index. <i>Makeindex</i> can
+ be used with some TeX
+ macro packages other than LaTeX, such as
+ <a href="FAQ-eplain.html">Eplain</a>, and TeX (whose macros can
+ be used independently with Plain TeX).
+<dt>idxtex<dd> for LaTeX under VMS, which comes with a
+ glossary-maker called <i>glotex</i>.
+<dt>texindex<dd> A witty little shell/<i>sed</i>-script-based
+ utility for LaTeX under Unix.
+<p/> The <a href="FAQ-texinfo.html">Texinfo</a> system also uses a program
+ <i>texindex</i>, whose source is to be found in the
+ <i>texinfo</i> distribution. The <i>ltxindex</i> package
+ provides macros to allow LaTeX users to use <em>this</em>
+ <i>texindex</i>.
+<dt>xindy<dd> arose from frustration at the difficulty of making a
+ multi-language version of <i>makeindex</i>. It is designed to
+ be a successor to <i>makeindex</i>, by a team that included the
+ then-current maintainer of <i>makeindex</i>. It successfully
+ addresses many of <i>makeindex</i>&rsquo;s shortcomings, including
+ difficulties with collation order in different languages, and it is
+ highly flexible. Sadly, its take-up is proving rather slow.
+</dl>
+<dl>
+<dt><tt><i>idxtex</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/indexing/glo+idxtex.zip">indexing/glo+idxtex</a> (<a href="ftp://cam.ctan.org/tex-archive/indexing/glo+idxtex.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/indexing/glo+idxtex/">browse</a>)
+<dt><tt><i>ltxindex.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/ltxindex.zip">macros/latex/contrib/ltxindex</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/ltxindex.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/ltxindex/">browse</a>)
+<dt><tt><i>makeindex</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/indexing/makeindex.zip">indexing/makeindex</a> (<a href="ftp://cam.ctan.org/tex-archive/indexing/makeindex.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/indexing/makeindex/">browse</a>)
+<dt><tt><i>makeindex (Macintosh)</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/systems/mac/macmakeindex2.12.sea.hqx">systems/mac/macmakeindex2.12.sea.hqx</a>
+<dt><tt><i>texindex (the script)</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/indexing/texindex.zip">indexing/texindex</a> (<a href="ftp://cam.ctan.org/tex-archive/indexing/texindex.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/indexing/texindex/">browse</a>)
+<dt><tt><i>texindex (the program)</i></tt><dd>Distributed
+ with <a href="ftp://cam.ctan.org/tex-archive/macros/texinfo/texinfo.zip">macros/texinfo/texinfo</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/texinfo/texinfo.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/texinfo/texinfo/">browse</a>)
+<dt><tt><i>texsis (system)</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/texsis.zip">macros/texsis</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/texsis.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/texsis/">browse</a>)
+<dt><tt><i>texsis (makeindex support)</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/texsis/index/index.tex">macros/texsis/index/index.tex</a>
+<dt><tt><i>xindy</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/support/xindy/">support/xindy/</a>
+</dl>
+<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=makeindex">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=makeindex</a>
+</body>