From 772976b31dcc12f45676b472887bd330bff5b9d7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 19 Oct 2011 22:28:08 +0000 Subject: thumbs (19oct11) git-svn-id: svn://tug.org/texlive/trunk@24332 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/thumbs/README | 34 ++++++++++++++------- .../texmf-dist/doc/latex/thumbs/thumbs-example.pdf | Bin 182358 -> 183129 bytes .../texmf-dist/doc/latex/thumbs/thumbs-example.tex | 27 +++++++++++----- Master/texmf-dist/doc/latex/thumbs/thumbs.pdf | Bin 488183 -> 494990 bytes 4 files changed, 43 insertions(+), 18 deletions(-) (limited to 'Master/texmf-dist/doc/latex/thumbs') 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 Binary files a/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf and b/Master/texmf-dist/doc/latex/thumbs/thumbs-example.pdf differ 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 @@ -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 Binary files a/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf and b/Master/texmf-dist/doc/latex/thumbs/thumbs.pdf differ -- cgit v1.2.3