diff options
author | Karl Berry <karl@freefriends.org> | 2013-10-14 22:29:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-10-14 22:29:17 +0000 |
commit | 74e3ca017b02a77b352d7696a8ca4e253e843d2b (patch) | |
tree | 30f978a8b1787186dd7c9d794180c947c30e9f9d /Master/texmf-dist/doc/latex/etoc | |
parent | 9f85f95eb8ea005052f16a229098bf48ada96635 (diff) |
etoc (14oct13)
git-svn-id: svn://tug.org/texlive/trunk@31904 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/etoc')
-rw-r--r-- | Master/texmf-dist/doc/latex/etoc/README | 196 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/etoc/etoc.pdf | bin | 257856 -> 277593 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/etoc/etoc.tex | 25 |
3 files changed, 88 insertions, 133 deletions
diff --git a/Master/texmf-dist/doc/latex/etoc/README b/Master/texmf-dist/doc/latex/etoc/README index 5c09f2f9709..7ae6716ecdf 100644 --- a/Master/texmf-dist/doc/latex/etoc/README +++ b/Master/texmf-dist/doc/latex/etoc/README @@ -1,156 +1,86 @@ -version 1.07f dated 2013/03/07 -documentation dated 2013/05/14 - -Package `etoc' -Completely customisable TOCs -Copyright (C) 2012, 2013 by Jean-Francois Burnol - -LICENSE -======= - - The copyright and license statement applies to `etoc.dtx' and to - its derived files. - - 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 - http://www.latex-project.org/lppl/lppl-1-3c.txt - and the latest version of this license is in - http://www.latex-project.org/lppl.txt - and version 1.3 or later is part of all distributions of - LaTeX version 2005/12/01 or later. +% +% Package: etoc +% Version: 2013/10/13 v1.07g +% Copyright (C) 2012-2013 by Jean-Francois Burnol <jfbu at free dot fr> +% + 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 + http://www.latex-project.org/lppl/lppl-1-3c.txt + and the latest version of this license is in + http://www.latex-project.org/lppl.txt + and version 1.3 or later is part of all distributions of + LaTeX version 2005/12/01 or later. + + This Work has the LPPL maintenance status Author-Maintained. + + The Author of this Work is Jean-Francois Burnol <jfbu at free dot fr>. - The author of this work is Jean-Francois Burnol <jfbu at free dot fr>. - This work has the LPPL maintenance status `author-maintained'. - -INSTALLATION -============ - - `latex etoc.dtx' --> this extracts the style file `etoc.sty' - - `latex etoc.dtx' (twice more) finishes producing the documentation - - Move `etoc.sty' to a suitable location within the TeX installation: - etoc.sty -> <TDS>/tex/latex/etoc/etoc.sty - - The generated auxiliary files may be discarded. + This Work consists of the main source file etoc.dtx and the + derived files etoc.sty, etoc.ins, etoc.tex, etoc.dvi, etoc.pdf + ABSTRACT ======== The etoc package gives to the user complete control on how the entries of the table of contents should be constituted - from the name, number, and page number of each sectioning - unit. This goes via the definition of line styles for each - sectioning level used in the document. The package provides - its own custom line styles. Simpler ones are given as - examples in the documentation. The simplest usage will be to - take advantage of the layout facilities of packages dealing - with list environments. - - The \tableofcontents command may be used arbitrarily many - times and it has a variant \localtableofcontents which - prints tables of contents `local' to the current surrounding - document unit. An extension of the \label/\ref syntax allows - to reproduce (with another layout) a TOC defined somewhere - else in the document. + from the {name}, {number}, and {page number} + of each sectioning unit. This goes via the definition of + {line styles} for each sectioning level used in the + document. The package provides its own custom line styles. + Simpler ones are given as examples in the documentation. The + simplest usage will be to take advantage of the layout facilities + of packages dealing with list environments. + + The \tableofcontents command may be used arbitrarily + many times and it has a variant \localtableofcontents + which prints tables of contents `local' to the current + surrounding document unit. An extension of the + \label/\ref syntax allows to reproduce (with another + layout) a TOC defined somewhere else in the document. The formatting inherited (and possibly customized by other packages) from the document class may also be used in - compatibility mode. Regarding the global toc display, etoc - provides pre-defined styles based on a multi-column format, - optionally with a frame or a ruled title. + {compatibility mode}. Regarding the {global toc + display}, etoc provides pre-defined styles based on a + multi-column format, optionally with a frame or a ruled + title. As the assignment of levels to the sectioning units can be changed at any time, etoc can be used in a quite general - manner to also create custom "lists of", additionally to the - tables of contents related to the document sectioning units. - No auxiliary file is used apart from the usual .toc file. - - -Change log -========== - - v1.07f [2013/03/07] - - new macros \etocthelinkedname, \etocthelinkednumber, - \etocthelinkedpage, and \etocthelink. - - - v1.07e [2013/03/01] - - improvements in the package own line styles with - regards to penalties and vertical spaces. - - addition to the documentation of an example of - a tree-like table of contents (uses tikz). - - more such examples added 2013/03/03. - - - v1.07d [2013/02/24] - - minor code improvements and new documentation - section "Another compatibility mode". + manner to also create custom ``lists of'', additionally to + the tables of contents related to the document sectioning + units. No auxiliary file is used additionally to the + standard .toc file. - v1.07b [2013/02/02] - - removal of the \xspace from the macros \etocname, - \etocnumber, \etocpage. - - additional examples in the documentation. - - - v1.07 [2013/01/29] - - new commands: - - \etocthename, \etocthenumber, \etocthepage, \etoclink, - - \etoctoccontentsline, \etoctoccontentsline* - - \etocnopar, \etocaftercontentshook - - modified command: \etocmulticolstyle - - new documentation section "Surprising uses of etoc" which - explains how to do "Lists of arbitrary things", in - addition to the tables of contents. - - - v1.06 [2012/12/07] - - the standard macros \l@section etc... are modified only - during the calls to \tableofcontents; they can thus be - customized as will by the user (with the help of a - package like tocloft) and this will be taken into account - by etoc for the TOCs typeset in compatibility mode. - - - v1.05 [2012/12/01] - - \localtableofcontents replaces \tableofcontents* (for - compatibility with the memoir class). +INSTALLATION +============ - compatibility with KOMA-script and memoir document - classes. + Extraction of the package (.sty) and driver (.tex) files: + - if etoc.ins is present: tex etoc.ins + - without etoc.ins: tex etoc.dtx + It is also possible to run latex/pdflatex directly on etoc.dtx - v1.04 [2012/11/24] + At least three ways to produce etoc.pdf: + (1) latex etoc.dtx (three times), then dvips, then ps2pdf + (2) pdflatex etoc.dtx (three times) + (3) latex etoc.tex (three times), then dvipdfmx - a (possibly local) table of contents can be labeled: - - \tableofcontents \label{toc:1} + 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/pdflatex. - and reproduced elsewhere in the document (with a possibly - completely different layout): - - \tableofcontents \ref{toc:1} + Installation: - - v1.02 [2012/11/18] + etoc.sty->TDS:tex/latex/etoc/etoc.sty + etoc.dtx->TDS:source/latex/etoc/etoc.dtx + etoc.pdf->TDS:doc/latex/etoc/etoc.pdf - initial version. + etoc.tex, etoc.ins, etoc.aux, etoc.toc, etc... may be discarded diff --git a/Master/texmf-dist/doc/latex/etoc/etoc.pdf b/Master/texmf-dist/doc/latex/etoc/etoc.pdf Binary files differindex a4d73e5fff0..232b58a2c1f 100644 --- a/Master/texmf-dist/doc/latex/etoc/etoc.pdf +++ b/Master/texmf-dist/doc/latex/etoc/etoc.pdf diff --git a/Master/texmf-dist/doc/latex/etoc/etoc.tex b/Master/texmf-dist/doc/latex/etoc/etoc.tex new file mode 100644 index 00000000000..225306b0ed1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/etoc/etoc.tex @@ -0,0 +1,25 @@ +\def\pkgname {etoc} \def\pkgdate {2013/10/13} \def\pkgversion {v1.07g} +\def\pkgdescription {Completely customisable TOCs (jfB)} +\def\doctimestamp {Time-stamp <13-10-2013 23:44:43 CEST *>} +%% +%% Package: etoc +%% Version: 2013/10/13 v1.07g +%% Copyright (C) 2012-2013 by Jean-Francois Burnol <jfbu at free dot fr> +%% +%% run latex thrice on this file etoc.tex then dvipdfmx on etoc.dvi +%% to produce the documentation etoc.pdf, with source code included. +%% +%% customize as desired the class options and the two toggles below. +%% +\NeedsTeXFormat{LaTeX2e} +\ProvidesFile{etoc.tex}[\pkgdate\space\pkgversion\space\pkgdescription]% +\PassOptionsToClass{a4paper,11pt}{scrdoc} +\chardef\Withdvipdfmx 1 % replace 1 by 0 for using latex/pdflatex, rather. +\chardef\NoSourceCode 0 % replace 0 by 1 for the doc *without* the source code +\input etoc.dtx +%%% Local Variables: +%%% mode: latex +%%% End: +\endinput +%% +%% End of file `etoc.tex'. |