titlesec (9sep19)

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

5 files changed, 48 insertions, 25 deletions

diff --git a/Master/texmf-dist/doc/latex/titlesec/README.md b/Master/texmf-dist/doc/latex/titlesec/README.md
index 1b9250a712e..2b917789388 100644
--- a/Master/texmf-dist/doc/latex/titlesec/README.md
+++ b/Master/texmf-dist/doc/latex/titlesec/README.md
@@ -28,6 +28,9 @@ mechanims is used, without intermediate `\leftmark`s or `\rightmark`s.
 ### Latest changes
 
 ```
+2.12  2019-09-09
+      - Fix - Partial TOCs were severely broken.
+      - Fix - An undefined section doesn't raise an error any more.
 2.11  2019-07-16
       - New license: MIT.
       - Option nostruts, to remove struts inserted by titlesec.
diff --git a/Master/texmf-dist/doc/latex/titlesec/titleps.pdf b/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
index cef3495fdf9..f3657fe272a 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
+++ b/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
diff --git a/Master/texmf-dist/doc/latex/titlesec/titleps.tex b/Master/texmf-dist/doc/latex/titlesec/titleps.tex
index 51149c9fa85..68116da571e 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titleps.tex
+++ b/Master/texmf-dist/doc/latex/titlesec/titleps.tex
@@ -7,8 +7,8 @@
 % Repository: https://github.com/jbezos/titlesec
 %
 
-\def\fileversion{2.11}
-\def\docdate{2019/07/16}
+\def\fileversion{2.12}
+\def\docdate{2019/09/09}
 
 \documentclass[a4paper]{ltxguide}
 \usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
index bf4525f3e9c..4cf1ccd3716 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
+++ b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
index d10da1e0401..619e043700d 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
+++ b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
@@ -7,14 +7,15 @@
 % Repository: https://github.com/jbezos/titlesec
 %
 
-\def\fileversion{2.11}
-\def\docdate{2019/07/16}
+\def\fileversion{2.12}
+\def\docdate{2019/09/09}
 
 \documentclass[a4paper]{ltxguide}
 \usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
-\usepackage{titletoc}
+\usepackage{titletoc,color}
 \def\gobble#1{}
 \def\cs#1{\expandafter\gobble\string\\#1}
+\definecolor{notes}{rgb}{.75, .3, .3}%
 \makeatletter
 \newenvironment{desc}
   {\if@nobreak
@@ -23,18 +24,21 @@
    \fi
    \decl}
   {\enddecl}
+\def\@begintheorem#1#2{%
+  \list{}{}%
+  \global\advance\@listdepth\m@ne
+  \item[{\sffamily\bfseries\color{notes}\MakeUppercase{#1}}]}%
+\newtheorem{warning}{Warning}
+\newtheorem{note}{Note}
+\newtheorem{example}{Example}
 \makeatother
 
-\usepackage{textcomp,pslatex}
+\usepackage{textcomp}
 \usepackage[linktocpage]{hyperref}
 
 \title{The \textsf{titlesec}, \textsf{titleps} and \textsf{titletoc} 
 Packages\footnote{The \textsf{titlesec} package is currently at 
-version 2.10.2.  \copyright{} 1998--2016 Javier Bezos.
-The \textsf{titletoc} package is currently at 
-version 1.6.  The \textsf{titleps} package is currently at version 
-1.1.1 \copyright{} 1999--2016 Javier Bezos.  All Rights 
-Reserved.}}
+version 2.12. \copyright{} 1998--2019 Javier Bezos.}}
 
 \author{Javier Bezos\footnote{For bug reports, comments and
 suggestions go to \href{http://www.tex-tipografia.com/contact.html}%
@@ -91,6 +95,14 @@ dotlessi, babeltools}.}}
 
 \maketitle
 \tableofcontents
+
+\begin{note}
+  Please, report any issues you find on
+  \texttt{https://github.com/jbezos/titlesec/issues}, which is better
+  than just complaining on an e-mail list or a web forum. Forking
+  and pull requests are welcome.
+\end{note}
+
 \section{Introduction}
 
 This package is essentially a replacement---partial or total---for the 
@@ -835,17 +847,24 @@ While the shapes and the like modify the behaviour of titles related
 to the surrounding text, title classes allow to change the generic
 behaviour of them.  With the help of classes you may insert, say, a
 new |subchapter| level between |chapter| and |section|, or creating a
-scheme of your own.  \emph{Making a consistent scheme and defining all
-of related stuff like counters, macros, format, spacing and, if there
-is a TOC, TOC format is left to the responsibility of the user.} There
-are three classes: |page| is like the book |\part|, in a single page,
-|top| is like |\chapter|, which begins a page and places the title at
-the top, and |straight| is intended for titles in the middle of
-text.\footnote{There is an further class named |part| to emulate the
-article |\cs{part}|, but you should not use it at all.  Use the
-|straight| class instead.  Remember some features rely in these
-classes and \textsf{titlesec} does not change by default the
-definition of \texttt{\string\part} and \texttt{\string\chapter}.}
+scheme of your own.
+
+There are three classes: |page| is like the book |\part|, in a single
+page, |top| is like |\chapter|, which begins a page and places the
+title at the top, and |straight| is intended for titles in the middle
+of text.\footnote{There is an further class named |part| to emulate the
+article |\cs{part}|, but you should not use it at all. Use the
+|straight| class instead. Remember some features rely in these classes
+and \textsf{titlesec} does not change by default the definition of
+\texttt{\string\part} and \texttt{\string\chapter}.}
+
+\begin{warning}
+  Making a consistent scheme and defining all of
+  related stuff like counters, macros, format, and spacing is left to the
+  responsibility of the user. If there is a TOC, also the TOC format,
+  which might require redefining the corresponding macros to change the
+  hardcoded value (either by hand or with \textsf{titletoc}).
+\end{warning}
 
 \begin{desc}
 |\titleclass{<name>}{<class>}|\\
@@ -1518,16 +1537,17 @@ A simple usage might look like (provided you are using
 \begin{verbatim}
 \titleformat{\chapter}[display]
   {...}{...}{...}  % Your definitions come here
-  [\vspace*{4pc}%
+  [{\vspace*{4pc}%
    \startcontents
-   \printcontents{l}{1}[2]{}]
+   \printcontents{l}{1}[2]{}}]
 
 \titlecontents*{lsection}[0pt]
   {\small\itshape}{}{}
   {}[ \textbullet\ ][.]
 \end{verbatim}
 The included entries are those in levels 1 to 2 inclusive (i.e., 1 
-and 2).
+and 2). Note the whole optional argument is enclosed in braces, because
+there is an internal \texttt{[]}.
 
 \subsection[Partial lists]{Partial lists \normalfont\normalsize\fbox{2.6}}