summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/titlesec
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-03-16 22:33:36 +0000
committerKarl Berry <karl@freefriends.org>2016-03-16 22:33:36 +0000
commit4c11a739919c6fe82bd1e3890115da2a7b447bee (patch)
tree52f12b4a0a273d23c0829596222f7c3b7041bf82 /Master/texmf-dist/doc/latex/titlesec
parent0633160feb499eda3f63828de6cc6301911627b9 (diff)
titlesec (16mar16)
git-svn-id: svn://tug.org/texlive/trunk@40048 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/titlesec')
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/CHANGES19
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/README6
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titleps.pdfbin116637 -> 132752 bytes
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titleps.tex98
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titlesec.pdfbin181154 -> 180358 bytes
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titlesec.tex33
6 files changed, 112 insertions, 44 deletions
diff --git a/Master/texmf-dist/doc/latex/titlesec/CHANGES b/Master/texmf-dist/doc/latex/titlesec/CHANGES
index ebe6031d2ab..3cbfae5c8a3 100644
--- a/Master/texmf-dist/doc/latex/titlesec/CHANGES
+++ b/Master/texmf-dist/doc/latex/titlesec/CHANGES
@@ -241,4 +241,21 @@ History of v.2.9.1
History of v.2.9.2
~~~~~~~~~~~~~~~~~~
-2011-11-11 Fixed a typo in ttlps.def (\MessageBreag) \ No newline at end of file
+2011-11-11 Fixed a typo in ttlps.def (\MessageBreag)
+
+History of v.2.10.0
+~~~~~~~~~~~~~~~~~~~~
+
+2011-12-15 Split titlesp
+
+History of v.2.10.1
+~~~~~~~~~~~~~~~~~~~~
+
+2015-02-27 Fix: An explict \newpage in 'after' wrote the toc entry twice
+2015-03-09 Fix (partial): A list containing just a sectioning command
+ raised an error
+
+History of titleps v.1.1.1
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+2016-03-15 New macro \setmarkboth for compatibility
+
diff --git a/Master/texmf-dist/doc/latex/titlesec/README b/Master/texmf-dist/doc/latex/titlesec/README
index cd36dc30329..66725fe563b 100644
--- a/Master/texmf-dist/doc/latex/titlesec/README
+++ b/Master/texmf-dist/doc/latex/titlesec/README
@@ -55,13 +55,13 @@ Web site, manual in PDF format and info
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Further details are available on
- http://www.tex-tipografia.com/titlesec.html
+ http://www.texnia.com/titlesec.html
Contact
~~~~~~~
Please, for suggestions, bug reports, etc., go to
More
- http://www.tex-tipografia.com/contact.html
+ http://www.texnia.com/contact.html
Known problems
~~~~~~~~~~
@@ -70,5 +70,5 @@ after a section in a so radical way that titlesec (which
uses the internal LaTeX macros) cannot supress it again.
For example, spanish (fixed in version 5.0) and frenchb.
-2011/12/15
+2016/03/15
diff --git a/Master/texmf-dist/doc/latex/titlesec/titleps.pdf b/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
index b4f8bd4f65d..37626bbceed 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
+++ b/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/titlesec/titleps.tex b/Master/texmf-dist/doc/latex/titlesec/titleps.tex
index 5dab28b7eab..6cea538de5c 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titleps.tex
+++ b/Master/texmf-dist/doc/latex/titlesec/titleps.tex
@@ -2,10 +2,10 @@
% | Typeset this file to get the documentation. |
% +--------------------------------------------------+
%
-% Copyright (c) 1998-2011 by Javier Bezos.
+% Copyright (c) 1998-2016 by Javier Bezos.
% All Rights Reserved.
%
-% This file is part of the titlesec distribution release 2.10.0
+% This file is part of the titlesec distribution release 2.10.1
% -----------------------------------------------------------
%
% It may be distributed and/or modified under the
@@ -20,14 +20,14 @@
%
% The Current Maintainer of this work is Javier Bezos.
-\def\fileversion{1.1.0}
-\def\docdate{2011-12-15}
+\def\fileversion{1.1.1}
+\def\docdate{2016-03-15}
\documentclass[a4paper]{ltxguide}
\usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
\usepackage{titletoc}
\def\gobble#1{}
-\def\cs#1{\expandafter\gobble\string\\#1}
+\DeclareRobustCommand\cs[1]{\expandafter\gobble\string\\#1}
\makeatletter
\newenvironment{desc}
{\if@nobreak
@@ -43,11 +43,11 @@
\title{Headers and footers with \textsf{titleps}\footnote{The
\textsf{titleps} package is currently at version \fileversion.
-\copyright{} 2011 Javier Bezos. All Rights Reserved.}}
+\copyright{} 2016 Javier Bezos. All Rights Reserved.}}
\author{Javier Bezos\footnote{For bug reports, comments and
-suggestions go to \href{http://www.tex-tipografia.com/contact.html}%
-{\texttt{http://www.tex-tipografia.com/contact.html}}. English
+suggestions go to \href{http://www.texnia.com/contact.html}%
+{\texttt{http://www.texnia.com/contact.html}}. English
is not my strong point, so contact me when you find mistakes in the
manual. Other packages by the same author: \textsf{gloss} (with
Jos\'e Luis D\'{\i}az), \textsf{enumitem, accents, tensind, esindex,
@@ -144,7 +144,8 @@ for example, thank to the \textit{extra marks} described below.
It works with standard classes and many others; however, additional
\LaTeX{} layout adjustments could be necessary in some of them (for
-instance the \textsc{AMS} classes).\footnote{%
+instance the \textsc{AMS} classes) and several packages emitting marks
+directly with \verb|\markboth| and \verb|\markleft|.\footnote{%
Two columns layout requires the \textsf{fix2col} package by David
Carlisle.}
@@ -247,15 +248,6 @@ deprecated. Now
The starred version |\settitlemarks*| creates parallel extra marks
as described below.
-Note |\markboth| is a command to set the |myheadings| marks and
-here does not make sense. In fact, using it can lead to unpredictable
-results. Anyway, using directly the marking commands is discouraged
-(see |titlesec.pdf|), but if you need them, you may write:
-\begin{verbatim}
-\chapter*{My Chapter}
-\chaptermark{My Chapter}
-\end{verbatim}
-
\begin{desc}
|\headrule \footrule|\\
|\setheadrule{<length>} \setfootrule{<length>}|
@@ -304,6 +296,49 @@ above and a red rule below (the \textsf{color} package is required):
Of course, the material to be used as rule is not restricted to actual
rules; pictures and leaders, for instance, are allowed, too.
+\section{On \texttt{\cs{markboth}} and \texttt{\cs{markleft}}}
+
+As \textit{The \LaTeX{} Companion explains} ``Leslie Lamport had a
+specific marking scheme in mind when he designed those
+commands''. They are clearly intended for the \verb|heading| and
+\verb|myheading| pagestyles, with a \textit{main-mark} on the left
+page and a \textit{sub-mark} on the right one.
+
+In order to provide the functionality offered by \textsf{titleps}, a
+more general, less specific mechanism is devised, which means
+|\markboth| here does not make sense, because it doesn't work like in
+standard \LaTeX, and in fact, can lead to unpredictable results.
+
+Therefore, using directly the marking commands is discouraged (see
+|titlesec.pdf|), but if you need them, you may write:
+\begin{verbatim}
+\chapter*{My Chapter}
+\chaptermark{My Chapter}
+\end{verbatim}
+
+But some issues remain, because there are a number of packages
+assuming the pagestyle is \verb|heading| or \verb|myheading|. This is,
+of course, a reasonable guess, but not always correct (even if
+\textsf{titleps} is not used at all). Most of them do the right thing
+-- \verb|\markboth| is encapsulated into a macro easily redefinable so
+that the user can modify it if necessary. This is true, for example,
+for \textsf{biblatex}, but unfortunately not for \textsf{endnotes}.
+When this happens, you can resort to the following macro.
+
+\begin{desc}
+|\setmarkboth{<code-to-use>}|
+\end{desc}
+
+From this point on, \verb|\markboth| behaves as defined. It doesn't
+redefine directly the command, but rather provides a replacement code
+(you can use |#1| and |#2| for the two arguments). With
+|\resetmarkboth| (which can be used inside |\setmarkboth|) the
+original definition will be again in force. For example, to cancel the
+next |\markboth|:
+\begin{verbatim}
+\setmarkboth{\resetmarkboth\markboth{}{}}
+\end{verbatim}
+
\section{Headline/footline width}
\begin{desc}
@@ -587,14 +622,14 @@ commands, you might still need an empty title mark (like
hand.
In many cases, the following “short” marks mechanism will be enough.
-With it, you simply say with \verb|\setshormark| the name of a command
+With it, you simply say with \verb|\newshormark| the name of a command
to be used in heads or foots, and then emit the mark at appropiated
places (short marks for variables are not available). An example
illustrates how this is carried out:
\begin{verbatim}
\newcommand\lemmatitle{}
-\setshortmark\lemmatitle
+\newshortmark\lemmatitle
\newcommand\lemma[1]{%
\renewcommand\lemmatitle{#1}%
@@ -629,13 +664,12 @@ For a more general approach use the following tools.
A \textit{markset} contains a set of related commands and variables
intended to be emitted simultaneously as marks, so that their values
-can be retrieved in heads/foots. A typical \textit{markset} could be a
-title and its counter (and perhaps, in a multilingual document, the
-active language, i.e., \verb|\languagename| in \textsf{babel}, or an
-intermediate command). There
-is always a special unnamed \textit{markset} for sectioning marks, which is
-the main one and handled with the tools described above (with |title|
-in their names).
+can be retrieved in heads/foots. A typical \textit{markset} could be
+a title and its counter (and perhaps, in a multilingual document, the
+active language, i.e., \verb|\languagename| in \textsf{babel}, or an
+intermediate command). There is always a special unnamed
+\textit{markset} for sectioning marks, which is the main one and
+handled with the tools described above (with |title| in their names).
\begin{desc}
|\newextramark{<markset>}{<macro-name>}|\\
@@ -729,7 +763,7 @@ define a command. For example:
\section{A couple of examples}
-Because of the way marks are handled, special constructions like this are
+Because of the way marks are handled, special constructs like this are
allowed:
\begin{verbatim}
\newpagestyle{main}[\small\sffamily]{
@@ -743,7 +777,8 @@ allowed:
As you can see, the range of sections in a page with |\thesection| is
printed in both left and right heads. Of course, this example should
be fine tuned to collapse the ranges if there is a single section in a
-page (with |\ifsamemark|), but it gives a hint of how to get stunning headers.
+page (with |\ifsamemark|), but it gives a hint of how to get stunning
+headers.
In this document, the following styles are used:
\begin{verbatim}
@@ -756,9 +791,8 @@ In this document, the following styles are used:
\sethead{titlesec -- titleps}{\sectiontitle}{\thepage}}
\end{verbatim}
-The following definitions provide page styles similar to
-those in Lamport's \textit{The \LaTeX\ book} (with the \textsf{calc}
-package):
+The following definitions provide page styles similar to those in
+Lamport's \textit{The \LaTeX\ book} (with the \textsf{calc} package):
\begin{verbatim}
\widenhead*{0pt}{\marginparsep + \marginparwidth} % symmetrically
\renewpagestyle{plain}{}
diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
index 5c8c11e2511..60e026ffeb9 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
+++ b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
index 463ae8e711e..823ca55c46b 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
+++ b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
@@ -2,10 +2,10 @@
% | Typeset this file to get the documentation. |
% +--------------------------------------------------+
%
-% Copyright (c) 1998-2011 by Javier Bezos.
+% Copyright (c) 1998-2016 by Javier Bezos.
% All Rights Reserved.
%
-% This file is part of the titlesec distribution release 2.10.0
+% This file is part of the titlesec distribution release 2.10.1
% -----------------------------------------------------------
%
% It may be distributed and/or modified under the
@@ -20,8 +20,8 @@
%
% The Current Maintainer of this work is Javier Bezos.
-\def\fileversion{2.10.0}
-\def\docdate{2011-12-15}
+\def\fileversion{2.10.1}
+\def\docdate{2016-03-15}
\documentclass[a4paper]{ltxguide}
\usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
@@ -43,10 +43,10 @@
\title{The \textsf{titlesec}, \textsf{titleps} and \textsf{titletoc}
Packages\footnote{The \textsf{titlesec} package is currently at
-version 2.10.0. \copyright{} 1998--2011 Javier Bezos.
+version 2.10.1. \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.0 \copyright{} 1999--2011 Javier Bezos. All Rights
+1.1.1 \copyright{} 1999--2016 Javier Bezos. All Rights
Reserved.}}
\author{Javier Bezos\footnote{For bug reports, comments and
@@ -273,7 +273,15 @@ lines long and the \texttt{hang} shape is used, except with explicit
\item[display] puts the label in a separate paragraph. (Like the
standard |\chapter|.)
-\item[runin] A run-in title. (Like the standard |\paragraph|.)
+\item[runin] A run-in title, like the standard
+ |\paragraph|.\footnote{Well, not quite. The title is first boxed to
+ avoid some unexpected results if, for example, there is a
+ \texttt{\string\color} between the title and the
+ text. Unfortunately, due to an optimization done by \TeX{}
+ discretionaries may be lost. I have found no solution, except using
+ \textsf{luatex}, which works as one could expect. Anyway, if the
+ title doesn't contain hyphen or dashes, this is not usually a real
+ problem.}
\item[leftmargin] puts the title at the left margin. Titles at the
very end of a page will be moved to the next one and will not stick
@@ -731,8 +739,17 @@ TOC entries, which will be based on the full title.
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.
+\begin{desc}
+|notocpart*| \quad (Package option)
+\end{desc}
-
+\fbox{2.10.1} Long ago (by the year 2000) I decided for some reason
+\verb|\part*| would behave like the AMS classes and therefore there
+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.
\subsection{Extended Settings}
%~~~~~~~~~~~~~~~~~~~~~~~~~