From bd713db34dad79c8efbc6a9c8bf3da575a090dc2 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 26 Sep 2016 20:51:58 +0000 Subject: etoc (26sep16) git-svn-id: svn://tug.org/texlive/trunk@42150 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/etoc/README | 134 ++++++-------------------- Master/texmf-dist/doc/latex/etoc/README.md | 136 ++++++--------------------- Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf | Bin 441267 -> 574280 bytes Master/texmf-dist/doc/latex/etoc/etoc.pdf | Bin 485394 -> 605873 bytes 4 files changed, 54 insertions(+), 216 deletions(-) (limited to 'Master/texmf-dist/doc/latex/etoc') diff --git a/Master/texmf-dist/doc/latex/etoc/README b/Master/texmf-dist/doc/latex/etoc/README index ee8b177fe72..ad22a4463e5 100644 --- a/Master/texmf-dist/doc/latex/etoc/README +++ b/Master/texmf-dist/doc/latex/etoc/README @@ -1,8 +1,8 @@ - Source: etoc.dtx (v1.08g 2015/08/29 -- doc 2016/09/09) + Source: etoc.dtx (v1.08h-2016/09/25) Author: Jean-Francois Burnol Author: Christine Roemer et al. (German tranlation) Info: Completely customisable TOCs - License: LPPL 1.3c or later + License: LPPL 1.3c Copyright (C) 2012-2016 Jean-Francois Burnol. Copyright (C) 2014-2016 Christine Roemer and collaborators for the translation into German of the documentation. @@ -64,28 +64,19 @@ etoc.dtx: It is also possible to run latex or pdflatex directly on etoc.dtx. -At least three ways to produce etoc.pdf (method (3) is preferred): +To produce etoc.pdf one can run pdflatex (thrice) directly on etoc.dtx +or on the file etoc.tex which was extracted from previous step. -1. latex etoc.dtx (thrice), then dvips, then ps2pdf -2. pdflatex etoc.dtx (thrice) -3. latex etoc.tex (thrice), then dvipdfmx - -Method (3) produces the smallest pdf files. Options can be set in -etoc.tex: +Options can be set in etoc.tex: - scrdoc class options (paper size, font size, ...) - with or without source code, - with dvipdfmx or with latex+dvips or pdflatex. -To produce etoc-DE.pdf (German documentation) run etex on etoc.ins or -etoc.dtx to produce etoc-DE.tex, then compile etoc-DE.tex with latex -(thrice) then dvipdmx, or set first to 0 \Withdvipdfmx in etoc-DE.tex to -allow compilation with pdflatex. - -Um etoc-DE.pdf zu erzeugen ist latex dreimal mit etoc-DE.tex laufen zu -lassen, dann dvipdfmx mit etoc-DE.dvi. Im Falle von Problemen mit -dvipdfmx ist \Withdvidpdfmx auf 0 in etoc-DE.tex zu setzen, dann ist -pdflatex dreimal mit etoc-DE.tex laufen zu lassen. +Release 1.08h sets pdflatex as default in etoc.tex (prior it was +latex+dvipdfmx as it produces smaller PDFs) in order to allow inclusion +via the use of package attachfile of about 25 code samples as file +attachment annotations. Installation: @@ -103,8 +94,8 @@ LICENSE This Work may be distributed and/or modified under the conditions of the -LaTeX Project Public License, either version 1.3c of this license or (at -your option) any later version. This version of this license is in +LaTeX Project Public License, in its version 1.3c. This version of this +license is in http://www.latex-project.org/lppl/lppl-1-3c.txt @@ -131,6 +122,22 @@ etoc.dvi, etoc-DE.dvi. RECENT CHANGES +v1.08h [2016/09/25] + +New functioning of \etocsetnexttocdepth: the tocdepth counter is +modified only at the time of the table of contents, not before. This +fixes an issue which arose when \etocsetnexttocdepth was used multiple +times with no intervening table of contents. + +The PDF documentation includes about 25 LaTeX code snippets also as file +attachment annotations, additionally to their verbatim typesetting. The +ordering of the documentation contents has been slightly re-organized. + +A previous documentation-only update on 2016/09/09 added a new section +with the (approximate) translation into etoc lingua of the book class +toc style, for easy customizability. + + v1.08g [2015/08/29] Downgraded to a mere info message the etoc-issued warning (relative to @@ -172,90 +179,3 @@ Translation into German of the additions made to the documentation for the 1.08x series of releases. Thanks to Christine Römer! - - -v1.08c [2015/03/30] - -- removed a few unneeded \long from the code. -- removed use of \arabic at one location of the code, as it may get - redefined by some language modules for babel or polyglossia. - - -v1.08b [2015/03/18] - -Bug fixes: - -- extra space token removed from \localtableofcontents (showed only - for inline TOCs.) -- \etocpartname (a macro used by the package own default line styles) - was defined to be \partname, but this is not compatible at least - with babel+french context. Now simply expands to Part. -- some problems fixed in the German documentation. -- [2015/03/28] some more problems fixed in the documentation. Added - mention of \etocarticlestyle and \etocbookstyle. - - -v1.08a [2015/03/13] - -\etocname, \etocnumber and \etocpage are now the robust variants of -\etocthelinkedname, \etocthelinkednumber and \etocthelinkedpage. This -should arguably have been done since the addition of the latter to etoc -with v1.07f [2013/03/07]. The earlier robust commands \etocname etc... -contained the hyperlink destination only in an unexpanded form. - -The documentation has a brand new title page and a new section _The TOC -as a TikZ mind map_ both illustrating further uses of etoc to display -tables of contents as trees in an automatic manner. - - -v1.08 [2015/03/10] - -\etocskipfirstprefix may now appear anywhere in the part of a -level style. - -New commands \etociffirst, \etocxiffirst, \etocxifnumbered, -\etocglobaldefs and \etoclocaldefs. - -It is now possible to issue line style specifications directly with & -and \\ tokens, in order to typeset a TOC as a tabular or longtable with -the opening for example in the first argument of \etocsettocstyle and -the closing in its second argument. - -It is mandatory for such uses to issue \etocglobaldefs which tells etoc -to proceed globally for certain definitions. This is also useful in the -context of the inline environments of package enumitem. - -On this occasion, various old parts of the code have been improved. - - -v1.07n [2015/03/05] - -No more use of \toks@ when etoc constructs \etocthelinkedname etc... -Thus \toks@ can be put in the line styles in order to accumulate -information. Only useful if it is certain nothing else will change -\toks@ either. - -In the documentation: list of main commands now in alphabetic order. - - -v1.07m [2015/01/23] - -Reading of .toc file is delayed to \begin{document} to account for -possible Babel active characters used therein. Thanks to Denis Bitouzé -who reported a Babel related problem. - -Improved global toc display emulation under KOMA-script classes. - -New command \etocbeforetitlehook. New command \etocdisplay. - - -v1.07l [doc of 2014/04/29] - -Added to the documentation an example of use of \etocthelinkedname -together with an enumitem inline itemize* environment; moved main TOC to -immediately after the title, and license to the first pages. - -Incorporation of the translation into German done on the initiative of -Christine Römer by Felix Baral-Weber, Jenny Rothkrämer-Vogt, Daniel -Büttner, Claudia Dahl, Christian Otto and Christine Römer (FSU Jena). My -grateful thanks to all! diff --git a/Master/texmf-dist/doc/latex/etoc/README.md b/Master/texmf-dist/doc/latex/etoc/README.md index 38292880792..1c241f9cc47 100644 --- a/Master/texmf-dist/doc/latex/etoc/README.md +++ b/Master/texmf-dist/doc/latex/etoc/README.md @@ -1,10 +1,10 @@ - Source: etoc.dtx (v1.08g 2015/08/29 -- doc 2016/09/09) + Source: etoc.dtx (v1.08h-2016/09/25) Author: Jean-Francois Burnol Author: Christine Roemer et al. (German tranlation) Info: Completely customisable TOCs - License: LPPL 1.3c or later + License: LPPL 1.3c Copyright (C) 2012-2016 Jean-Francois Burnol. Copyright (C) 2014-2016 Christine Roemer and collaborators for the translation into German of the documentation. @@ -62,28 +62,19 @@ Else, to extract the package (.sty) and driver (.tex) files from etoc.dtx: It is also possible to run latex or pdflatex directly on etoc.dtx. -At least three ways to produce etoc.pdf (method (3) is preferred): +To produce etoc.pdf one can run pdflatex (thrice) directly on etoc.dtx or on +the file etoc.tex which was extracted from previous step. -1. latex etoc.dtx (thrice), then dvips, then ps2pdf -2. pdflatex etoc.dtx (thrice) -3. latex etoc.tex (thrice), then dvipdfmx - -Method (3) produces the smallest pdf files. Options can be set in etoc.tex: - scrdoc class options (paper size, font size, ...) - with or without source code, - with dvipdfmx or with latex+dvips or pdflatex. -To produce etoc-DE.pdf (German documentation) run etex on etoc.ins -or etoc.dtx to produce etoc-DE.tex, then compile etoc-DE.tex with -latex (thrice) then dvipdmx, or set first to 0 `\Withdvipdfmx` in -etoc-DE.tex to allow compilation with pdflatex. - -Um etoc-DE.pdf zu erzeugen ist latex dreimal mit etoc-DE.tex laufen -zu lassen, dann dvipdfmx mit etoc-DE.dvi. Im Falle von Problemen -mit dvipdfmx ist `\Withdvidpdfmx` auf 0 in etoc-DE.tex zu setzen, -dann ist pdflatex dreimal mit etoc-DE.tex laufen zu lassen. +Release 1.08h sets pdflatex as default in etoc.tex (prior it was +latex+dvipdfmx as it produces smaller PDFs) in order to allow +inclusion via the use of package `attachfile` of about 25 code +samples as file attachment annotations. Installation: @@ -99,9 +90,8 @@ LICENSE ======= This Work may be distributed and/or modified under the -conditions of the LaTeX Project Public License, either -version 1.3c of this license or (at your option) any later -version. This version of this license is in +conditions of the LaTeX Project Public License, in its +version 1.3c. This version of this license is in > @@ -126,6 +116,23 @@ etoc.pdf, etoc-DE.pdf, etoc.dvi, etoc-DE.dvi. RECENT CHANGES ============== +v1.08h \[2016/09/25\] +--------------------- + +New functioning of `\etocsetnexttocdepth`: the tocdepth counter is +modified only at the time of the table of contents, not before. +This fixes an issue which arose when `\etocsetnexttocdepth` was used +multiple times with no intervening table of contents. + +The PDF documentation includes about 25 LaTeX code snippets also +as file attachment annotations, additionally to their verbatim +typesetting. The ordering of the documentation contents has been +slightly re-organized. + +A previous documentation-only update on 2016/09/09 added a new +section with the (approximate) translation into etoc lingua of the +book class toc style, for easy customizability. + v1.08g \[2015/08/29\] --------------------- @@ -171,92 +178,3 @@ for the 1.08x series of releases. Thanks to Christine Römer! -v1.08c \[2015/03/30\] ---------------------- - -- removed a few unneeded `\long` from the code. -- removed use of `\arabic` at one location of the code, as it may get - redefined by some language modules for `babel` or `polyglossia`. - -v1.08b \[2015/03/18\] ---------------------- - -Bug fixes: - -- extra space token removed from `\localtableofcontents` (showed - only for inline TOCs.) -- `\etocpartname` (a macro used by the package own default line - styles) was defined to be `\partname`, but this is not compatible - at least with `babel+french` context. Now simply expands to Part. -- some problems fixed in the German documentation. -- \[2015/03/28\] some more problems fixed in the documentation. Added - mention of `\etocarticlestyle` and `\etocbookstyle`. - -v1.08a \[2015/03/13\] ---------------------- - -`\etocname`, `\etocnumber` and `\etocpage` are now the robust -variants of `\etocthelinkedname`, `\etocthelinkednumber` and -`\etocthelinkedpage`. This should arguably have been done since -the addition of the latter to etoc with v1.07f \[2013/03/07\]. -The earlier robust commands `\etocname` etc... contained the -hyperlink destination only in an unexpanded form. - -The documentation has a brand new title page and a new section -*The TOC as a TikZ mind map* both illustrating further uses of -etoc to display tables of contents as trees in an automatic -manner. - -v1.08 \[2015/03/10\] --------------------- - -`\etocskipfirstprefix` may now appear anywhere in the `` -part of a level style. - -New commands `\etociffirst`, `\etocxiffirst`, `\etocxifnumbered`, -`\etocglobaldefs` and `\etoclocaldefs`. - -It is now possible to issue line style specifications directly -with `&` and `\\` tokens, in order to typeset a TOC as a tabular -or longtable with the opening for example in the first argument of -`\etocsettocstyle` and the closing in its second argument. - -It is mandatory for such uses to issue `\etocglobaldefs` which -tells etoc to proceed globally for certain definitions. This is -also useful in the context of the inline environments of package -enumitem. - -On this occasion, various old parts of the code have been improved. - -v1.07n \[2015/03/05\] ---------------------- - -No more use of `\toks@` when etoc constructs `\etocthelinkedname` -etc... Thus `\toks@` can be put in the line styles in order to -accumulate information. Only useful if it is certain nothing else -will change `\toks@` either. - -In the documentation: list of main commands now in alphabetic order. - -v1.07m \[2015/01/23\] ---------------------- - -Reading of .toc file is delayed to `\begin{document}` to account for -possible Babel active characters used therein. Thanks to Denis -Bitouzé who reported a Babel related problem. - -Improved global toc display emulation under KOMA-script classes. - -New command `\etocbeforetitlehook`. New command `\etocdisplay`. - -v1.07l \[doc of 2014/04/29\] ----------------------------- - -Added to the documentation an example of use of `\etocthelinkedname` -together with an enumitem inline itemize\* environment; moved main -TOC to immediately after the title, and license to the first pages. - -Incorporation of the translation into German done on the initiative -of Christine Römer by Felix Baral-Weber, Jenny Rothkrämer-Vogt, -Daniel Büttner, Claudia Dahl, Christian Otto and Christine Römer (FSU -Jena). My grateful thanks to all! diff --git a/Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf b/Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf index af114696196..93700ed79d1 100644 Binary files a/Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf and b/Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf differ diff --git a/Master/texmf-dist/doc/latex/etoc/etoc.pdf b/Master/texmf-dist/doc/latex/etoc/etoc.pdf index 2ddf239be25..b653ebea429 100644 Binary files a/Master/texmf-dist/doc/latex/etoc/etoc.pdf and b/Master/texmf-dist/doc/latex/etoc/etoc.pdf differ -- cgit v1.2.3