From a3e65cf58603aec6b27742b833f880c0f3372020 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 15 Aug 2007 18:44:25 +0000 Subject: titlesec 2.7 (11aug07) git-svn-id: svn://tug.org/texlive/trunk@4731 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/titlesec/README | 105 +++++----- Master/texmf-dist/doc/latex/titlesec/titlesec.new | 16 -- Master/texmf-dist/doc/latex/titlesec/titlesec.pdf | Bin 230525 -> 230226 bytes Master/texmf-dist/doc/latex/titlesec/titlesec.tex | 220 +++++++++++---------- Master/texmf-dist/doc/latex/titlesec/titletoc.new | 67 ------- Master/texmf-dist/tex/latex/titlesec/block.tss | 21 +- Master/texmf-dist/tex/latex/titlesec/drop.tss | 21 +- Master/texmf-dist/tex/latex/titlesec/frame.tss | 21 +- .../texmf-dist/tex/latex/titlesec/leftmargin.tss | 24 ++- Master/texmf-dist/tex/latex/titlesec/margin.tss | 22 ++- .../texmf-dist/tex/latex/titlesec/rightmargin.tss | 22 ++- Master/texmf-dist/tex/latex/titlesec/titlesec.sty | 146 ++++++++++---- Master/texmf-dist/tex/latex/titlesec/titletoc.sty | 47 +++-- Master/texmf-dist/tex/latex/titlesec/ttlkeys.def | 23 ++- Master/texmf-dist/tex/latex/titlesec/ttlps.def | 21 +- Master/texmf-dist/tex/latex/titlesec/wrap.tss | 21 +- 16 files changed, 438 insertions(+), 359 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/titlesec/titlesec.new delete mode 100644 Master/texmf-dist/doc/latex/titlesec/titletoc.new diff --git a/Master/texmf-dist/doc/latex/titlesec/README b/Master/texmf-dist/doc/latex/titlesec/README index 117ac5fe87c..4a2a7e84717 100644 --- a/Master/texmf-dist/doc/latex/titlesec/README +++ b/Master/texmf-dist/doc/latex/titlesec/README @@ -1,52 +1,53 @@ -Titlesec package -~~~~~~~~~~~~~~~~ -This package allows to change the sectioning titles. Amongst its many -features it provides margin titles, different format in left and right -pages, rules above and below the title, etc. - -Titletoc package -~~~~~~~~~~~~~~~~ -For toc entries formatting, providing the possibility of changing -the format in the middle of a document, grouping the entries -in a single paragraph, pretty free-forms entries, partial tocs, etc. - -The titletoc.sty file is not part of the titlesec package; it's -an independent package, but it's described in titlesec.tex. - -Installation -~~~~~~~~~~~~ -No .ins/.dtx preinstalation is required. Move the files to a place -where LaTeX can find them and typeset titlesec.tex. All of files in -this directory are necessary for titlesec.sty to work, except the -manual titlesec.tex (and this 'readme' file). The manual requires -titlesec.sty and titletoc.sty, and hence all the .tss, .def -and .new files as well. - -Files with extension .new (titlesec.new and titletoc.new) -are patch files, ie, files with bug fixes, which are loaded -automatically. - -Web site, manual in PDF format and info -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -More details are available on - - http://texytipografia.com/titlesec.html - -Known problems -~~~~~~~~~~ -Some language styles (for babel) add the indentation -after a section in a so radical way that titlesec (which uses -the internal LaTeX macros) cannot supress it again. -For example, spanish (by myself) and frenchb. - -Changes -~~~~~~~~ -2005/05/19. Patch for titletoc (titletoc.new, level 1) to -fix a bug when partial tocs are used with \include'd -files (a partial toc could appear in the wrong context). - -2005/05/19 - -______________________________________________________________ -Javier Bezos | http://texytipografia.com -.............................................................. \ No newline at end of file +Titlesec package +~~~~~~~~~~~~~~~~ +This package allows to change the sectioning titles. Amongst its many +features it provides margin titles, different format in left and right +pages, rules above and below the title, etc. + +Current version is 2.8. + +Titletoc package +~~~~~~~~~~~~~~~~ +For toc entries formatting, providing the possibility of changing +the format in the middle of a document, grouping the entries +in a single paragraph, pretty free-forms entries, partial tocs, etc. + +The titletoc.sty file is not part of the titlesec package; it's +an independent package, but it's described in titlesec.tex. + +Installation +~~~~~~~~~~~~ +No .ins/.dtx preinstalation is required. Move the files to a place +where LaTeX can find them and typeset titlesec.tex. All of files in +this directory are necessary for titlesec.sty to work, except the +manual titlesec.tex (and this 'readme' file). The manual requires +titlesec.sty and titletoc.sty, and hence all the .tss and .def +files as well. + +Files with extension .new (titlesec.new and titletoc.new) +used to be patch files, ie, files with bug fixes, which were +loaded automatically. Since titlesec 2.7 (titletoc 1.6), these +files do not exist any more and should be removed (however, +they will be ignored if present). + +Web site, manual in PDF format and info +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +More details are available on + + http://www.texytipografia.com/titlesec.html + +Contact +~~~~~~~ +Please, for suggestions, bug reports, etc., go to + + http://www.texytipografia.com/contact.html + +Known problems +~~~~~~~~~~ +Some language styles (for babel) add the indentation +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. + +2007/08/12 + diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.new b/Master/texmf-dist/doc/latex/titlesec/titlesec.new deleted file mode 100644 index 3e6180f6524..00000000000 --- a/Master/texmf-dist/doc/latex/titlesec/titlesec.new +++ /dev/null @@ -1,16 +0,0 @@ -% titlesec 2.6, patch -% (c) Javier Bezos 2005, as stated in titlesec.sty -% -% Level 0 -% -%\def\ttl@a{2005/01/22 v2.6 Sectioning titles} -%\expandafter\ifx\csname ver@titlesec.sty\endcsname\ttl@a -% \message{*** titlesec 2.6, loading patch level 1 ***} -%\else -% \PackageError{titlesec}{Wrong patch version} -% {This patch is intended for titlesec v2.6\MessageBreak -% and you are using a different version. If you have -% installed a later release, please remove titlesec.new} -%\fi - -\endinput \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf index 1b7de55f85d..305b8f27081 100644 Binary files a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf and b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf differ diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex index 4f73ae70182..1817af2bb50 100644 --- a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex +++ b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex @@ -2,19 +2,26 @@ % | Typeset this file to get the documentation. | % +--------------------------------------------------+ % -% Copyright (c) 1998-2005 by Javier Bezos. +% Copyright (c) 1998-2007 by Javier Bezos. % All Rights Reserved. % -% This file is part of the titlesec distribution release 2.6 +% This file is part of the titlesec distribution release 2.8 % ----------------------------------------------------------- % -% This program can be redistributed and/or modified under the terms -% of the LaTeX Project Public License Distributed from CTAN -% archives in directory macros/latex/base/lppl.txt; either -% version 1 of the License, or any later version. +% It may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3 +% of this license or (at your option) any later version. +% 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 2003/12/01 or later. +% +% This work has the LPPL maintenance status "maintained". +% +% The Current Maintainer of this work is Javier Bezos. -\def\fileversion{2.6} -\def\docdate{January 22, 2005} +\def\fileversion{2.8} +\def\docdate{2007-08-12} \documentclass[a4paper]{ltxguide} \usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec} @@ -36,18 +43,17 @@ \title{The \textsf{titlesec} and \textsf{titletoc} Packages\footnote{The \textsf{titlesec} package is currently at -version 2.6. \copyright{} 1998--2005 Javier Bezos. +version 2.8. \copyright{} 1998--2007 Javier Bezos. The \textsf{titletoc} package is currently at -version 1.5. \copyright{} 1999--2005 Javier Bezos. All Rights +version 1.6. \copyright{} 1999--2007 Javier Bezos. All Rights Reserved.}} \author{Javier Bezos\footnote{For bug reports, comments and -suggestions go to \href{http://www.texytipografia.com/contact.php}% -{http://www.texytipografia.com/contact.php}, -or to my postal address: Apartado 116.035, E-28080 Madrid, Spain. -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{accents, tensind, esindex, +suggestions go to \href{http://www.texytipografia.com/contact.html}% +{http://www.texytipografia.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, dotlessi}.}} \date{\docdate} @@ -218,21 +224,21 @@ command, as for example: \section{Advanced Interface} %~~~~~~~~~~~~~~~~~~~~~~~~ -Two commands are provided to change the title format. The first one -is used for the ``internal'' format, i.~e., shape, font, label\dots, -the second one defines the ``external'' format, i.~e., spacing before -and after, indentation, etc. This scheme is intended to easy -definitions, since in most of cases you will want to modify either -spacing or format.\footnote{Information is ``extracted'' from the -class sectioning commands, except for chapter and part. Standard -definitions with |\cs{@startsection}| are presumed, and if an -special procedure was followed an arbitrary value is provided, which -you may change later. (Sadly, there is no way to catch the chapter or -part formats, and one similar to that of standard classes will be -used.)} That redefines existing sectioning commands, but -does not create \emph{new} ones. New sectioning levels can be -added with |\titleclass|, as described below, and then their format -can be set with the commands described here. +Two commands are provided to change the title format. The first one +is used for the ``internal'' format, i.~e., shape, font, label\dots, +the second one defines the ``external'' format, i.~e., spacing before +and after, indentation, etc. This scheme is intended to easy +definitions, since in most of cases you will want to modify either +spacing or format.\footnote{Information is ``extracted'' from the +class sectioning commands, except for chapter and part. Standard +definitions with |\cs{@startsection}| are presumed---if sections have +been defined without that macro, arbitrary values for the format an +the spacing are provided, which you may change later. (Sadly, there +is no way to catch the chapter or part formats, and one similar to +that of standard classes will be used.)} That redefines existing +sectioning commands, but does not create \emph{new} ones. New +sectioning levels can be added with |\titleclass|, as described below, +and then their format can be set with the commands described here. \subsection{Format} @@ -263,7 +269,7 @@ sometimes the title may stick out.} In this case you may increase the stretchability of the page elements, use |\raggedbottom| or use the package option |nobottomtitles| described below. Since the mechanism used is independent from that of the margin pars, they can overlap. -A synonymous is |margin|. +A deprecated synonymous is |margin|. \item[rightmargin] is like |leftmargin| but at the right margin. @@ -296,15 +302,15 @@ or |\subparagraph|. \item The paragraph shape is set by ||, whose possible values are those described above. -\item || is the format to be applied to the whole -title---label and text. This part can contain vertical material (but -not always horizontal) which is typeset just after the space above the -title. +\item || is the format to be applied to the whole +title---label and text. This part can contain vertical material (and +horizontal with some shapes) which is typeset just after the space +above the title. -\item The label is defined in |