summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/robustindex/robustmanual.tex')
-rw-r--r--Master/texmf-dist/doc/latex/robustindex/robustmanual.tex58
1 files changed, 46 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex b/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex
index 9f1b76b1595..103733c2580 100644
--- a/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex
+++ b/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex
@@ -1,12 +1,12 @@
-% robustmanual.tex
+% robustmanual.tex 2017/09/29
\documentclass{article}
\usepackage{makeidx}
-\usepackage{robustindex}
+\usepackage[multind]{robustindex}
\usepackage[hyperindex=false]{hyperref}
\title {Manual of robustindex package}
-\author{Wilberd van der Kallen\index{Wilberd}}
+\author{Wilberd van der Kallen\index{wilberd@Wilberd}}
\date{2017}
\makeindex % obligatory with robustindex
@@ -84,10 +84,6 @@ If you want a page range in the index you have to use
the \emph{explicit} page range mechanism of makeindex as in
$$\verb!\index{discussion|(}!$$% used above
-%\index{discussion}% inside range, hence would be suppressed.
-
-%\index{discussion|blah}% inside range, hence would be suppressed.
-
@@ -101,11 +97,21 @@ somewhere before the \verb!\printindex!.
\index{alpha!see beta}
Before discussing the \verb|multind| option we now use $\verb!\printindex!$ to get an index (on a new page).
+
\printindex
\section*{The \texttt{multind} option}
The \verb!multind! option provides
-support for multiple indexes, albeit in a plain index style.
+support for multiple indexes. For the package to function properly we now require that
+the argument to an \verb!\index! command starts with at least two lower case
+letters or with the symbol \verb!<!.
+So use \verb!\index{new york@New York}! instead of \verb!\index{New York}!, \verb!\index{za@z}!
+instead of \verb!\index{z}!.
+
+If you have an entry that should go before the letter a, then start the argument of \verb!\index! with \verb!<!,
+as in \index{<@$<$ comes before alphabet}\verb!\index{<@$<$ comes before alphabet}!.
+
+
Suppose the preamble contains \verb!\usepackage[multind]{robustindex}!.
Let us say we want to use four indexes. First we choose tags to identify them.
@@ -119,12 +125,21 @@ Thus \verb!\setindex{bis}! tells \LaTeX\ that the active index is now the index
If a tag has not been encountered
before, then a new index with that tag is created.
The \verb!\index! command and
-the \verb|\printindex| commands write to/from the active index.
-This is all you need to know about option \verb!multind!.\\
+the \verb|\printindex| commands write to/from the active index. All indexes are hidden in one
+big index file and \LaTeX\ knows how to find the active index in there.
+
+If you wish you may use \verb!\sindex[bis]{!\emph{entry}\verb!}! as shorthand for\\
+
+\hspace{5em} \verb!\setindex{bis}\index{!\emph{entry}\verb!}!\\
+
+and \verb!\sindex{!\emph{entry}\verb!}! as shorthand for\\
+
+ \hspace{5em} \verb!\setindex{main}\index{!\emph{entry}\verb!}!.\\
+
-To see how option \verb!multind! may be used, you may also compare the file
-\verb|multisample.tex| with the output after
+The compilation sequence does not change. That is the main point of all our hacking.
+For instance, the file \verb!multisample.tex! produces multiple indexes and is processed like this
latex multisample.tex
@@ -134,7 +149,26 @@ latex multisample.tex
latex multisample.tex
+\subsection*{Embellishment}
+One may embellish an index with headings, like this.
+\verb!\setindex{main}!
+
+\verb!\renewcommand{\indexname}{Embellished Index}!
+
+\verb!\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}!%
+
+\verb!\printindex! \\
+
+\noindent This gives
+
+\setindex{main}
+
+\renewcommand{\indexname}{Embellished Index}
+
+\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}%
+
+\printindex
\end{document}