thumbs 2011/06/24, v1.0g

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

4 files changed, 119 insertions, 27 deletions

diff --git a/Master/texmf-dist/doc/latex/thumbs/README b/Master/texmf-dist/doc/latex/thumbs/README
index 40302d858ea..6c20a567bef 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/05/20, v1.0c
+README for thumbs package, 2011/06/24, v1.0g
 
 
 TABLE OF CONTENTS
@@ -92,7 +92,7 @@ e) Update the databases if necessary, e.g. for teTeX:
 
 Depending on the driver and option settings, thumbs loads
 other packages: kvoptions, atbegshi, xcolor, picture,
-alphalph, pagesLTS, rerunfilecheck, ifthen, and warning,
+alphalph, pagesLTS, rerunfilecheck, infwarerr, and atveryend,
 which again load other packages
 (see the result of the \listfiles command in the log-file
  of the example).
@@ -102,9 +102,10 @@ which again load other packages
 =======================
 
 thumbs should be loaded AFTER the required packages,
-but loding it before those packages schould be possible,
+but loding it before those packages should be possible,
 too.
-
+Thumbs MUST be loaded AFTER packages handling the page size,
+for example geometry.
 
 6 AUTHOR/MAINTAINER
 =====================
diff --git a/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf b/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf
index 215481bc532..d1c0d1ea958 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 109811e15fd..5cc130fbb6b 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/05/20 v1.0c
+%% Version: 2011/06/24 v1.0g
 %% 
 %% Copyright (C) 2010, 2011 by
 %%     H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
@@ -66,7 +66,7 @@
  linktoc=all]{hyperref}[2011/04/17]% v6.82g
 \usepackage[pagecolor=white,thumblink=rule,linefill=dots,height={auto},minheight={47pt},%
             width={auto},distance={2mm},topthumbmargin={auto},bottomthumbmargin={auto},%
-            verbose=true]{thumbs}[2011/05/20]% v1.0c
+            ignorehoffset=true,ignorevoffset=true,verbose=true]{thumbs}[2011/06/24]% v1.0g
 \gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
 \listfiles
 \begin{document}
@@ -76,13 +76,15 @@
 \markboth{Example for thumbs}{Example for thumbs}
 
 This example demonstrates the most common uses of package
-\textsf{thumbs}, v1.0c as of 2011/05/20 (HMM).
+\textsf{thumbs}, v1.0g as of 2011/06/24 (HMM).
 The used options were \texttt{pagecolor=white},
 \texttt{thumblink=rule}, \texttt{linefill=dots},
 \texttt{height=auto}, \texttt{minheight=\{47pt\}},
 width={auto}, \texttt{distance=\{2mm\}}, \texttt{topthumbmargin=\{auto\}},
-\texttt{bottomthumbmargin=\{auto\}}, and \texttt{verbose=true}.
-These are the default options, except \texttt{verbose=true}.
+\texttt{bottomthumbmargin=\{auto\}}, \texttt{ignorehoffset=true},
+\texttt{ignorevoffset=true},and \texttt{verbose=true}.
+
+\noindent These are the default options, except \texttt{verbose=true}.
 For more details please see the documentation!\newline
 
 \textbf{Hyperlinks or not:} If the \textsf{hyperref} package is loaded,
@@ -93,7 +95,39 @@ the references in the overview page for the thumb marks are also hyperlinked
 
 {\color{green} Save per page about $200\unit{ml}$ water, $2\unit{g}$ CO$_{2}$
 and $2\unit{g}$ wood:\newline
-Therefore please print only if this is really necessary.}
+Therefore please print only if this is really necessary.}\newline
+
+\bigskip
+
+\textbf{%
+For testing purpose page \pageref{greenpage} has been completely coloured!
+\newline
+Better exclude it from printing\ldots \newline}
+
+\bigskip
+
+Some thumb mark texts are too large for the thumb mark (especially when the
+paper size and therefore also the thumb mark size is decreased).
+When option \texttt{width=\{autoauto\}} would be used,
+the thumb mark width would be automatically increased.
+
+\bigskip
+
+For printing this example to another format of paper (e.\,g. A4)
+it is necessary to add the according option (e.\,g. \verb|a4paper|)
+to the document class and recompile it! (In that case the
+thumb marks column change will occure at another point, of course.)
+With paper format equal to document format the document can be printed
+without adapting the size, like e.\,g.
+\textquotedblleft shrink to page\textquotedblright .
+That would add a white border around the document
+and by moving the thumb marks from the edge of the paper they no longer appear
+at the side of the stack of paper. It is also necessary to use a printer
+capable of printing up to the border of the sheet of paper. Alternatively
+it is possible after the printing to cut the paper to the right size.
+While performing this manually is probably quite cumbersome,
+printing houses use paper, which is slightly larger than the
+desired format, and afterwards cut it to format.
 
 \newpage
 
@@ -224,22 +258,19 @@ and another.
 
 \addthumb{Huge Text}{\Huge{Huge Text}}{yellow}{green}
 
+\bigskip
+
+\textquotedblleft {\Huge{Huge Text}}\textquotedblright\ is too large for
+the thumb mark. When option \texttt{width=\{autoauto\}} would be used,
+the thumb mark width would be automatically increased.\label{HugeText}
+
 \addthumb{bold text }{\textbf{Bf Text}}{pink}{blue}
 
 \addthumb{Huge Bold Text}{\Huge{\textbf{HBT}}}{black}{yellow}
 
-When there is more than one thumb mark at one page, this is no problem.
-When more than six (6) thumb marks are at one (1) page,
-only the first six will be shown,
-while all will appear in the thumbs overview page.
-On the following pages the correct, last thumb mark will appear.
-More than one thumb mark at one page probably does not make much sense.
-This package was not created to create decorations at the page margin,
-but if you really need more than six thumb marks at one page,
-feel free to send an e-mail to the maintainer.
-If you have got an idea how to dynamically create thumb
-\textquotedblleft registers\textquotedblright\ (thereby overcomming
-this limitation), please send an e-mail to the maintainer, too.
+\bigskip
+
+When there is more than one thumb mark at one page, this is also no problem.
 
 \newpage
 
@@ -261,6 +292,9 @@ Some text
 It is probably a good idea to have a look at the \textsf{xcolor} package
 and use other colours than used in this example.
 
+(About automatically increasing the thumb mark width to the thumb mark text
+width please see the note at page~\pageref{HugeText}.)
+
 \newpage
 
 \addthumb{A mark}{\Huge{\textbf{A}}}{lime}{darkgray}
@@ -270,14 +304,14 @@ I just need to add further thumb marks to get them reaching the bottom of the pa
 Generally the vertical size of the thumb marks is set to the value given in the
 height option. If it is \texttt{auto}, the size of the thumb marks is decreased,
 so that they fit all on one page. But when they get smaller than \texttt{minheight},
-instead of decreasing their size further, a~new thumbs colum is started
+instead of decreasing their size further, a~new thumbs column is started
 (which will happen here).
 
 \newpage
 
 \addthumb{B mark}{\Huge{\textbf{B}}}{brown}{pink}
 
-There! A new thumb colum was started automatically!
+There! A new thumb column was started automatically!
 
 \newpage
 
@@ -315,7 +349,7 @@ Some text.
 \thumbnewcolumn
 \addthumb{New thumb marks column}{\Huge{\textit{NC}}}{magenta}{black}
 
-There! A new thumb colum was started manually!
+There! A new thumb column was started manually!
 
 \newpage
 
@@ -329,9 +363,66 @@ I just added another thumb mark.
 
 \newpage
 
-Well, I think that are enough thumb marks.
+\pagecolor{green}
+
+\makeatletter
+ \@ifundefined{Hy@Warning}{% hyperref not loaded
+     \let\url\verb%
+   }{% hyperref loaded
+     \phantomsection%
+    }%
+\makeatother
+
+\label{greenpage}
+
+Some faulty pdf-viewer sometimes (for the same document!)
+adds a white line at the bottom and right side of the document
+when presenting it. This does not change the printed version.
+To test for this problem, this page has been completely coloured.
+(Probably better exclude this page from printing\ldots{})
+
+\textsc{Heiko Oberdiek} wrote at Tue, 26 Apr 2011 14:13:29 +0200
+in the \newline
+comp.text.tex newsgroup (see e.\,g. \newline
+\url{http://groups.google.com/group/de.comp.text.tex/msg/b3aea4a60e1c3737}):\newline
+\textquotedblleft Der Ursprung ist 0 0,
+da gibt es nicht viel zu runden; bei den anderen Seiten
+werden pt als bp in die PDF-Datei geschrieben, d.h.
+der Balken ist um 72.27/72 zu gro\ss{}, das
+sollte auch Rundungsfehler abdecken.\textquotedblright
+
+(The origin is 0 0, there is not much to be rounded;
+for the other sides the $\unit{pt}$ are written as $\unit{bp}$ into
+the pdf-file, i.\,e. the rule is too large by $72.27/72$, which
+should cover also rounding errors.)
+
+The thumb marks are also too large - on purpose! This has been done
+to assure, that they cover the page up to its (paper) border,
+therefore they are placed a little bit over the paper margin.
+
+Now I red somwhere in the net (should have remembered to note the url),
+that white margins are presented, whenever there is some object outside
+of the page. Thus, it is a feature, not a bug?!
+What I do not understand: The same version of the viewer (at same operating
+system) at one PC shows white margins, and at another one does not. Strange.
+Even stranger: The same document sometimes is presented with white lines
+and sometimes without.\newline
+But at least it does not influence the printed version.
+
+\newpage
+
+\pagecolor{white}
+
+It is possible to use the Table of Thumbs more than once (for example
+at the beginning and the end of the document) and to refer to them via e.\,g.
+\verb|\pageref{TableOfThumbs1}, \pageref{TableOfThumbs2}|,... ,
+here: page \pageref{TableOfThumbs1}, page \pageref{TableOfThumbs2},
+and via e.\,g. \verb|\pageref{TableOfThumbs}| it is referred to the last used
+Table of Thumbs (for compatibility with older package versions).
+If there is only one Table of Thumbs, this one is also the last one, of course.
+Here it is at page \pageref{TableOfThumbs}.
 
-Good bye!
+\thumbsoverview{Table of Thumbs again}
 
 \end{document}
 
diff --git a/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf b/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf
index 7ee1d36634e..072268c79d5 100644
--- a/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf
+++ b/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf