texlive[73302] Master/texmf-dist: titlesec (4jan25)
commits+karl at tug.org
commits+karl at tug.org
Sat Jan 4 21:46:46 CET 2025
Revision: 73302
https://tug.org/svn/texlive?view=revision&revision=73302
Author: karl
Date: 2025-01-04 21:46:46 +0100 (Sat, 04 Jan 2025)
Log Message:
-----------
titlesec (4jan25)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/titlesec/README.md
trunk/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
trunk/Master/texmf-dist/doc/latex/titlesec/titleps.tex
trunk/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
trunk/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
trunk/Master/texmf-dist/tex/latex/titlesec/titleps.sty
trunk/Master/texmf-dist/tex/latex/titlesec/titlesec.sty
trunk/Master/texmf-dist/tex/latex/titlesec/titletoc.sty
Modified: trunk/Master/texmf-dist/doc/latex/titlesec/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/titlesec/README.md 2025-01-04 20:46:37 UTC (rev 73301)
+++ trunk/Master/texmf-dist/doc/latex/titlesec/README.md 2025-01-04 20:46:46 UTC (rev 73302)
@@ -1,4 +1,4 @@
-2023-10-27
+2025-01-04
## Titlesec, Titletoc, Titleps
@@ -30,6 +30,9 @@
### Latest changes
```
+2.17 2025-01-04
+ Fix – leftlabels raised and error.
+
2.16 2023-10-27
Undo the fix for #64.
Modified: trunk/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/titlesec/titleps.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/titlesec/titleps.tex 2025-01-04 20:46:37 UTC (rev 73301)
+++ trunk/Master/texmf-dist/doc/latex/titlesec/titleps.tex 2025-01-04 20:46:46 UTC (rev 73302)
@@ -1,5 +1,5 @@
%
-% Copyright (C) 1998-2023 Javier Bezos http://www.texnia.com
+% Copyright (C) 1998-2025 Javier Bezos http://www.texnia.com
%
% This file may be distributed and/or modified under the conditions of
% the MIT License. A version can be found at the end of this file.
@@ -7,8 +7,8 @@
% Repository: https://github.com/jbezos/titlesec
%
-\def\fileversion{2.16}
-\def\docdate{2023/10/27}
+\def\fileversion{2.17}
+\def\docdate{2025/01/04}
\documentclass[a4paper]{ltxguide}
\usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
Modified: trunk/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/titlesec/titlesec.tex 2025-01-04 20:46:37 UTC (rev 73301)
+++ trunk/Master/texmf-dist/doc/latex/titlesec/titlesec.tex 2025-01-04 20:46:46 UTC (rev 73302)
@@ -1,5 +1,5 @@
%
-% Copyright (C) 1998-2023 Javier Bezos http://www.texnia.com
+% Copyright (C) 1998-2025 Javier Bezos http://www.texnia.com
%
% This file may be distributed and/or modified under the conditions of
% the MIT License. A version can be found at the end of this file.
@@ -7,8 +7,8 @@
% Repository: https://github.com/jbezos/titlesec
%
-\def\fileversion{2.16}
-\def\docdate{2023/10/27}
+\def\fileversion{2.17}
+\def\docdate{2025/01/04}
\documentclass[a4paper]{ltxguide}
\usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
@@ -38,7 +38,7 @@
\title{The \textsf{titlesec}, \textsf{titleps} and \textsf{titletoc}
Packages\footnote{The \textsf{titlesec} package is currently at
-version 2.16. \copyright{} 1998--2023 Javier Bezos.}}
+version 2.17. \copyright{} 1998--2025 Javier Bezos.}}
\author{Javier Bezos\footnote{For bug reports, comments and
suggestions go to \href{http://www.tex-tipografia.com/contact.html}%
@@ -134,19 +134,22 @@
entries of different levels in a paragraph or changing the format
of entries in the middle of a document.
\end{itemize}
-\textsf{Titlesec} works with the standard classes and with many
-others, including the AMS ones, and it runs smoothly with
-\textsf{hyperref}.
+At the time of this writing, \textsf{titlesec} works with the standard
+classes and should work with many others, including the AMS ones,
+although you should be aware the latter reimplement the original
+internal commands. These changes will be lost here.
\begin{warning}
- Be aware the AMS classes reimplement the original internal commands.
- These changes will be lost here. The compatibility with
- \textsf{hyperref} has been tested with \textsf{dvips}, \textsf{dvipdfm}
- and \textsf{pdftex} but it is an unsupported feature (for example,
- with |\titleclass| PDF bookmarks are not correctly nested). Please, check
- your version of \textsf{hyperref} is compatible with
- \textsf{titlesec}. Unfortunately, it is not compatible with
- \textsf{memoir} or \textsf{KOMA}, which provide their own tools.
+ Compatibility with \textsf{hyperref} has been tested in typical use
+ cases, but it is an unsupported feature. For instance, when
+ using |\titleclass|, PDF bookmarks may not be properly nested, and
+ |\nameref| might not function as expected. Furthermore, since
+ \textsc{hyperref} is actively developed, currently working features
+ may become non-functional over time. I regret these ‘known
+ issues’ are unlikely to be addressed in the near future.
+
+ It is not compatible with \textsf{memoir} or \textsf{KOMA}, which
+ provide their own tools.
\end{warning}
As usual, load the package in the standard way with
@@ -370,7 +373,6 @@
|\textcolor| or place the code inside a group.
\end{warning}
-
\begin{desc}
|\chaptertitlename|
\end{desc}
@@ -399,7 +401,10 @@
will start in the outer margin, as expected, but the subsequent lines
will not; worse, those lines will be shortened at the right margin.}
-\item |<before-sep>| is the vertical space before the title.
+\item |<before-sep>| is the vertical space before the title. The
+standard |\chapter| inserts it with a |\vspace*|, and so does
+\textsf{titlesec}; this means you have to take into account other
+possible spaces inserted by \LaTeX\ at the op of the page.
\item |<after-sep>| is the separation between title and text---vertical
with |hang|, |block|, and |display|, and horizontal with |runin|,
@@ -514,12 +519,13 @@
|aftersep largestsep| \quad (Package options)
\end{desc}
-By default, when there are two consecutive titles the |<after-sep>|
-space from the first one is used between them. Sometimes this is not
-the desired behaviour, especially when the |<before-sep>| space is much
-larger than the |<after-sep>| one (otherwise the default seems
-preferable). With |largestsep| the largest of them is used.
-Default is |aftersep|.
+By default, when there are two consecutive titles the |<after-sep>|
+space from the first one is used between them. Sometimes this is not
+the desired behaviour, especially when the |<before-sep>| space is much
+larger than the |<after-sep>| one (otherwise the default seems
+preferable). With |largestsep| the largest of them is used. Default is
+|aftersep|. [\textbf{Note.} |largestsep| may not work as documented.
+This is a known issue.]
\begin{desc}
|\\ \\*|\\
@@ -771,8 +777,9 @@
\end{desc}
\fbox{2.6} Replaces every occurrence of \verb|\\| or \verb|\\*| in
-titles by a space in running heads and TOC entries. This way, you
-do not have to repeat the title just to remove a formatting command.
+titles by a space in running heads and TOC entries. This way, you do
+not have to repeat the title just to remove a formatting command. Note
+with |\chapter| and |\part| you need to set the title class.
\begin{desc}
|notocpart*| \quad (Package option)
@@ -783,8 +790,7 @@
should be a contents entry for it. This is somewhat odd, indeed, but
the very fact is nobody has complained until now! On the other hand,
restoring the behaviour one could expect after 15 years doesn't seem a
-good idea. A new page/part style in on the way, but for the moment
-this option restores the standard behaviour.
+good idea. This option restores the standard behaviour.
\subsection{Extended Settings}
%~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1358,9 +1364,9 @@
Compare this definition with that given above and you will
understand how |\dottedcontents| is defined.
-Although standard classes use font dependent units (mainly em),
-it is recommended using absolute ones (pc, pt, etc.) to ensure
-they entries are aligned correctly.
+Although standard classes use font dependent units (mainly em), with
+|titletoc| you have to use absolute ones (pc, pt, etc.) to ensure they
+entries are aligned correctly.
\subsection{And more}
Modified: trunk/Master/texmf-dist/tex/latex/titlesec/titleps.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/titlesec/titleps.sty 2025-01-04 20:46:37 UTC (rev 73301)
+++ trunk/Master/texmf-dist/tex/latex/titlesec/titleps.sty 2025-01-04 20:46:46 UTC (rev 73302)
@@ -1,5 +1,5 @@
%
-% Copyright (C) 1998-2023 Javier Bezos http://www.texnia.com
+% Copyright (C) 1998-2025 Javier Bezos http://www.texnia.com
%
% This file may be distributed and/or modified under the conditions of
% the MIT License. A version can be found at the end of this file.
@@ -13,7 +13,7 @@
\ifx\ttl at coreps\@empty\else % START code for package
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{titleps}[2023/10/27 v2.16 Page styles]
+\ProvidesPackage{titleps}[2025/01/04 v2.17 Page styles]
% This package is mainly a wrapper for the pagestyle macros provided
% by titlesec, so that they can be used without it. Functionality is
Modified: trunk/Master/texmf-dist/tex/latex/titlesec/titlesec.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/titlesec/titlesec.sty 2025-01-04 20:46:37 UTC (rev 73301)
+++ trunk/Master/texmf-dist/tex/latex/titlesec/titlesec.sty 2025-01-04 20:46:46 UTC (rev 73302)
@@ -1,5 +1,5 @@
%
-% Copyright (C) 1998-2023 Javier Bezos http://www.texnia.com
+% Copyright (C) 1998-2025 Javier Bezos http://www.texnia.com
%
% This file may be distributed and/or modified under the conditions of
% the MIT License. A version can be found at the end of this file.
@@ -34,7 +34,7 @@
% ~~~~~~~
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{titlesec}[2023/10/27 v2.16 Sectioning titles]
+\ProvidesPackage{titlesec}[2025/01/04 v2.17 Sectioning titles]
% Initialization
% ~~~~~~~~~~~~~~
Modified: trunk/Master/texmf-dist/tex/latex/titlesec/titletoc.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/titlesec/titletoc.sty 2025-01-04 20:46:37 UTC (rev 73301)
+++ trunk/Master/texmf-dist/tex/latex/titlesec/titletoc.sty 2025-01-04 20:46:46 UTC (rev 73302)
@@ -1,5 +1,5 @@
%
-% Copyright (C) 1998-2023 Javier Bezos http://www.texnia.com
+% Copyright (C) 1998-2025 Javier Bezos http://www.texnia.com
%
% This file may be distributed and/or modified under the conditions of
% the MIT License. A version can be found at the end of this file.
@@ -7,7 +7,7 @@
% Repository: https://github.com/jbezos/titlesec
%
-\ProvidesPackage{titletoc}[2023/10/27 v2.16 TOC entries]
+\ProvidesPackage{titletoc}[2025/01/04 v2.17 TOC entries]
% The following tags are used:
% ttl@ : the generic one, shared with titlesec
@@ -102,22 +102,15 @@
\DeclareOption{rubberseps}{%
\def\ttl at contentsstretch{\vskip\z@\@plus.1\p@}}
+\newcommand\contentslabel{}
\DeclareOption{leftlabels}{%
\renewcommand\numberline[1]{\hb at xt@\@tempdima{#1\ttl at idot\hfil}}%
- \newcommand\contentslabel[2][\thecontentslabel\ttl at idot]{%
-% \let\ttl at a\thecontentslabel %%%%% For the star variant
-% \def\thecontentslabel{#2}% %%% To be fully implemented... when?
-% \setbox\z@\hbox{#1}%
-% \dimen@\wd\z@
-% \let\thecontentslabel\ttl at a
-% \hspace*{-\dimen@}\hb at xt@\dimen@{#1\hfil}
-% \show\ttl at b \show\ttl at a
+ \renewcommand\contentslabel[2][\thecontentslabel\ttl at idot]{%
\hspace*{-#2}\hb at xt@#2{#1\hfil}}}
\DeclareOption{rightlabels}{%
\renewcommand\numberline[1]{\hb at xt@\@tempdima{\hss#1\ttl at idot\enspace}}%
- \let\contentslabel\relax
- \newcommand\contentslabel[2][\thecontentslabel\ttl at idot\enspace]{%
+ \renewcommand\contentslabel[2][\thecontentslabel\ttl at idot\enspace]{%
\hspace*{-#2}\hb at xt@#2{\hfil#1}}}
\newcommand\contentspage[1][\thecontentspage]{%
More information about the tex-live-commits
mailing list.