thumbs (19oct11)

git-svn-id: svn://tug.org/texlive/trunk@24332 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 43 insertions, 18 deletions

diff --git a/Master/texmf-dist/doc/latex/thumbs/README b/Master/texmf-dist/doc/latex/thumbs/README
index e33c28a20d4..3832f2b6f2d 100644
--- a/Master/texmf-dist/doc/latex/thumbs/README
+++ b/Master/texmf-dist/doc/latex/thumbs/README
@@ -1,4 +1,4 @@
-README for thumbs package, 2011/08/22, v1.0i
+README for thumbs package, 2011/10/19, v1.0j
 
 
 TABLE OF CONTENTS
@@ -76,17 +76,28 @@ Manual installation
 a) Download the thumbs files from CTAN or the TUG server.
    If necessary, unpack them.
 b) Generate the package and driver files:
-     tex thumbs.ins
+     tex thumbs.dtx
 c) Install the file `*.sty' in your TDS tree:
      cp *.sty TDS:tex/latex/thumbs/
    Replace `TDS:' by the prefix of your TDS tree
    (texmf directory).
-d) Copy the documentation files to
+d) Create the documentation, e.g.
+     pdflatex thumbs.dtx
+     makeindex -s gind.ist thumbs.idx
+     pdflatex thumbs.dtx
+     makeindex -s gind.ist thumbs.idx
+     pdflatex thumbs.dtx
+e) Update the databases if necessary, e.g. for teTeX:
+     mktexlsr .../texmf
+f) Create the thumbs-example.pdf, e.g.
+     pdflatex thumbs-example.tex
+     pdflatex thumbs-example.tex
+     pdflatex thumbs-example.tex
+     pdflatex thumbs-example.tex
+g) Copy the documentation files to
    "TDS:doc/latex/thumbs/":
    README, thumbs.pdf, thumbs-example.tex,
    thumbs-example.pdf.
-e) Update the databases if necessary, e.g. for teTeX:
-     mktexlsr .../texmf
 
 
 4 ADDITIONAL PACKAGES
@@ -122,15 +133,15 @@ for example geometry.
 A bug report should contain:
 * Comprehensive problem description. This includes error or
   warning messages.
-  * \errorcontextlines=\maxdimen can be added in the
-    TeX code to get more information in TeX error messages.
+* \errorcontextlines=\maxdimen can be added in the
+  TeX code to get more information in TeX error messages.
 * Minimal test file that shows the problem, but does not
   contain any unnecessary packages and code.
 * Used drivers/programs.
 * Version information about used packages and programs.
-  * If you are using LaTeX, then add "\listfiles". Then
-    a list of version information is printed at the end
-    of the LaTeX run.
+* If you are using LaTeX, then add "\listfiles". Then
+  a list of version information is printed at the end
+  of the LaTeX run.
 * Please no other files than the minimal test file.
   The other files .log, .dvi, .ps, .pdf are seldom
   necessary, so send them only on request.
@@ -149,4 +160,5 @@ Bug reports can be send to the maintainer:
 TeX 2011/06/27 has changed \enddocument and
 thus broken the \AtVeryVeryEnd command/hooking
 of atveryend package as of 2011/04/23, v1.7.
-Until it is fixed, \AtEndAfterFileList is used.
+Until its fixed version (2011/06/30, v1.8) is
+available at CTAN, \AtEndAfterFileList is used.
diff --git a/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf b/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf
index 90058e69362..b52465f59a0 100644
--- a/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf
+++ b/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf
diff --git a/Master/texmf-dist/doc/latex/thumbs/thumbs-example.tex b/Master/texmf-dist/doc/latex/thumbs/thumbs-example.tex
index 493a60cd6bf..ddec0e914c0 100644
--- a/Master/texmf-dist/doc/latex/thumbs/thumbs-example.tex
+++ b/Master/texmf-dist/doc/latex/thumbs/thumbs-example.tex
@@ -9,7 +9,7 @@
 %% This is a generated file.
 %% 
 %% Project: thumbs
-%% Version: 2011/08/22 v1.0i
+%% Version: 2011/10/19 v1.0j
 %% 
 %% Copyright (C) 2010, 2011 by
 %%     H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
@@ -63,11 +63,11 @@
  pdfsubject={Example for the thumbs package},%
  pdfkeywords={LaTeX, thumbs, thumb marks, Hans-Martin Muench},%
  pdfview=Fit,pdfstartview=Fit,%
- linktoc=all]{hyperref}[2011/04/17]% v6.82g
+ linktoc=all]{hyperref}[2011/10/01]% v6.82j
 \usepackage[thumblink=rule,linefill=dots,height={auto},minheight={47pt},%
             width={auto},distance={2mm},topthumbmargin={auto},bottomthumbmargin={auto},%
-            ignorehoffset=true,ignorevoffset=true,final=true,hidethumbs=false,%
-            verbose=true]{thumbs}[2011/08/22]% v1.0i
+            nophantomsection=false,ignorehoffset=true,ignorevoffset=true,final=true,%
+            hidethumbs=false,verbose=true]{thumbs}[2011/10/19]% v1.0j
 \nopagecolor% use \pagecolor{white} if \nopagecolor does not work
 \gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
 \makeatletter
@@ -84,11 +84,12 @@
 \markboth{Example for thumbs}{Example for thumbs}
 
 This example demonstrates the most common uses of package
-\textsf{thumbs}, v1.0i as of 2011/08/22 (HMM).
+\textsf{thumbs}, v1.0j as of 2011/10/19 (HMM).
 The used options were \texttt{thumblink=rule}, \texttt{linefill=dots},
 \texttt{height=auto}, \texttt{minheight=\{47pt\}}, \texttt{width={auto}},
 \texttt{distance=\{2mm\}}, \newline
-\texttt{topthumbmargin=\{auto\}}, \texttt{bottomthumbmargin=\{auto\}},
+\texttt{topthumbmargin=\{auto\}}, \texttt{bottomthumbmargin=\{auto\}}, \newline
+\texttt{nophantomsection=false},
 \texttt{ignorehoffset=true}, \texttt{ignorevoffset=true},
 \texttt{final=true},\texttt{hidethumbs=false}, and \texttt{verbose=true}.
 
@@ -162,6 +163,18 @@ To include an overview page for the thumb marks,
 is used, where \textbackslash addthumbsoverviewtocontents adds the thumb
 marks overview page to the table of contents.
 
+\smallskip
+
+Generally it is desirable to have a hyperlink from the thumbs overview page
+to lead to the thumb mark and not to some earlier place. Therefore automatically
+a \verb|\phantomsection| is placed before each thumb mark. But for example when
+using the thumb mark after a \verb|\chapter{...}| command, it is probably nicer
+to have the link point at the top of that chapter's title (instead of the line
+below it). The automatical placeing of the \verb|\phantomsection| can be disabled
+either globally by using option \texttt{nophantomsection}, or locally for the next
+thumb mark by the command \verb|\thumbsnophantom|. (When disabled globally,
+still manual use of \verb|\phantomsection| is possible.)
+
 \addthumbsoverviewtocontents{section}{Thumb marks overview}%
 \thumbsoverview{Table of Thumbs}
 
@@ -217,7 +230,7 @@ And you do not need to have a section to add a thumb:
 
 This is still the third section, but there is a new thumb mark.
 
-On the other hand, you can even get rid of the the thumb marks
+On the other hand, you can even get rid of the thumb marks
 for some page(s):
 
 \newpage
diff --git a/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf b/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf
index 49e40abc94a..561a6abbd75 100644
--- a/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf
+++ b/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf