diff options
author | Karl Berry <karl@freefriends.org> | 2016-09-26 20:51:58 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-09-26 20:51:58 +0000 |
commit | bd713db34dad79c8efbc6a9c8bf3da575a090dc2 (patch) | |
tree | ad79f49de5d5ceee962dca21bab3897acd5b090d /Master/texmf-dist/doc/latex/etoc/README.md | |
parent | b94d33bd1a1cbb2e4f0d736d899f0b6e3c04d2ce (diff) |
etoc (26sep16)
git-svn-id: svn://tug.org/texlive/trunk@42150 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/etoc/README.md')
-rw-r--r-- | Master/texmf-dist/doc/latex/etoc/README.md | 136 |
1 files changed, 27 insertions, 109 deletions
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! |