etoc (26sep16)

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

4 files changed, 54 insertions, 216 deletions

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 <start> 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
 
 > <http://www.latex-project.org/lppl/lppl-1-3c.txt>
 
@@ -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 `<start>`
-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
--- a/Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf
+++ b/Master/texmf-dist/doc/latex/etoc/etoc-DE.pdf
diff --git a/Master/texmf-dist/doc/latex/etoc/etoc.pdf b/Master/texmf-dist/doc/latex/etoc/etoc.pdf
index 2ddf239be25..b653ebea429 100644
--- a/Master/texmf-dist/doc/latex/etoc/etoc.pdf
+++ b/Master/texmf-dist/doc/latex/etoc/etoc.pdf