diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/robustindex/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/robustindex/README | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/robustindex/README b/Master/texmf-dist/doc/latex/robustindex/README new file mode 100644 index 00000000000..0fb91812887 --- /dev/null +++ b/Master/texmf-dist/doc/latex/robustindex/README @@ -0,0 +1,45 @@ + Package robustindex.sty, Wilberd van der Kallen Feb 2005. + http://www.math.uu.nl/people/vdkallen/stind.html + + This package addresses two issues. + + 1. Third parties often change the page numbers without rerunning makeindex. + (Yes, it happened also to my 1993 book.) + + One would like to make the page numbers in the index entries more robust. + We use the \pageref mechanism for that. Only after adding, deleting or + otherwise modifying an \index{entry}, or after changing the order of the + index entries, does one have to rerun makeindex. + Other changes do not matter, as long as one runs LaTeX or pdflatex twice. + + 2. The theindex environment does not create a hyperref destination. + + Therefore we introduce \indexincontents. + It does what \addcontentsline{toc}{chapter}{Index} or + \addcontentsline{toc}{section}{Index} should have done in the first place: + When one clicks on the link that displays the word Index, one actually ends + up in the index. + + Our package performs no miracles. But in simple situations all you need is + adding the \usepackage{robustindex} to the preamble. + + The implicit page range formation of makeindex is disabled. + Commands of the type \index{entry|editing command} are supported, + but much more naively than in the encapsulating mechanism of makeindex. + + If you use hyperref, choose the option hyperindex=false, because our method + to set up these hyperlinked indices is different. + We tested a little with + + \usepackage[plainpages=false,hyperindex=false]{hyperref} + + See robustsample.tex for more details and illustrations. + + There you find examples like + + \index{alpha!see beta} + \index{alpha!see also gamma\gobblepageref} + + \indexincontents % always put this before the index. + + See also robustglossary.sty |