summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/titlesec
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-12-17 00:59:21 +0000
committerKarl Berry <karl@freefriends.org>2011-12-17 00:59:21 +0000
commitbb697854fb4e6eca8595e8c660b3a8aaffa47b06 (patch)
treefe48672d2ddf634c75efa2c4e9d5a7ffc4b67a52 /Master/texmf-dist/doc/latex/titlesec
parentb85dc708bbe89bd54f2e998e166032f5d35a7e6a (diff)
titlesec/titleps 1.1.0 (15dec11)
git-svn-id: svn://tug.org/texlive/trunk@24852 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/titlesec')
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/CHANGES486
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/README144
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titleps.pdfbin0 -> 116637 bytes
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titleps.tex791
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titlesec.pdfbin195605 -> 181154 bytes
-rw-r--r--Master/texmf-dist/doc/latex/titlesec/titlesec.tex403
6 files changed, 1150 insertions, 674 deletions
diff --git a/Master/texmf-dist/doc/latex/titlesec/CHANGES b/Master/texmf-dist/doc/latex/titlesec/CHANGES
index cc5f4e48410..ebe6031d2ab 100644
--- a/Master/texmf-dist/doc/latex/titlesec/CHANGES
+++ b/Master/texmf-dist/doc/latex/titlesec/CHANGES
@@ -1,244 +1,244 @@
-Titlesec changes
-
-History of v1.0
-~~~~~~~~~~~~~~~
-1998/02/25 Added nops option
-1998/02/28 Added \@mkboth stuff in \setmarks
-1998/03/01 Changed test in \ttl@secnum
-1998/03/03 Corrected some \fil... commands
-1998/03/03 Replaced the faulty \@hangfrom by new commands
-1998/03/03 Some \def replaced by \newcommand
-1998/03/04 .dtx/.ins scheme finally rejected. Useless
- for users, obtrusive for `readers' and proned
- to errors
-1998/03/04 Tidied up documentation
-1998/03/06 \wordsep renamed and documented
-1998/03/06 Added dummy asignation in \ttl@chap.
-1998/03/06 Removed \ttl@xsect and merged into \tl@sect
-1998/03/06 Added \ProvidesPackage
-
-History of v1.1
-~~~~~~~~~~~~~~~~
-1998/03/25 \chapter corrected, as well as the size options
-1998/03/26 Added compact option
-1998/03/26 Added flushleft, flushright and center options
-1998/04/08 Changed all instances of \noindent by \parindent\z@
-1998/04/14 Added \filinner, \filouter
-1998/04/14 Added drop shape
-1998/05/01 Added rightmargin shape (and margin renamed to
- leftmargin)
-1998/05/03 Added \setheadindent
-
-History of v1.2 (unreleased)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-1998/06/01 Compatibility with AMS classes
-1998/06/08 On-demand loading of shapes
-1998/06/11 Frame shape. Some \fil... command
- modified to work in the label of this
- chapter shape.
-1998/07/03 Bottomtitle option (at last...)
-1998/07/14 ...margin styles bug fixed using a method
- similar to bottomtitle.
-1998/07/29 \titleline
-
-====================
-
-History of v2.0
-~~~~~~~~~~~~~~~~
-
-1998/08/05 to
-1998/08/29 Fully reimplemented
-
-History of v2.1
-~~~~~~~~~~~~~~~~
-1999/01/05 We define in this file the three basic shapes.
- Additional ones remain defined in external files.
- Unified the shapes for sections and chapters.
-1999/01/05 \ttl@shape merged into \ttl@format@iii.
-1999/01/05 \titlerule
-1999/01/07 \ttl@defkeys splitted from \ttl@keys
-1999/01/10 Added the \part stuff, including a definition of \@openright
-1999/01/11 Removed unnecessary \ttl@numsecfalse in \ttl@sect@i.
-1999/01/14 Optimized \titlerule
-1999/01/27 Changed \titleline to correct the spacing at the
- top page and to fix a bug which changed the mode
- to horizontal, thus introducing unwanted space
- (\makebox -> \@makebox).
-1999/02/02 \ttl@secnum renamed to \ttl@write and introduced the
- \ttl@savewrite mechanism to sincronize the toc/marks
- with the title in case there is a \newpage in <after>.
-1999/02/03 wrap shape
-1999/02/03 Added a \kern\z@ for not to avoid hyphenation
- of the last word. Not strictly necessary, but
- it is more LaTeX-like.
-1999/02/05 \partmark defined (and in \setmarks, too).
-1999/02/08 \ttl@row@i simplified.
-1999/02/08 \ttl@savefn mechanism.
-1999/02/10 Removed extra \leavevmode in display
-1999/02/13 Now \titleline doesn't add the width. It's set.
-1999/02/17 The part mark is catched, even if unused.
-1999/02/17 old/newparttoc added.
-1999/02/18 Changed many TeX assignments to the LaTeX
- counterpart.
-1999/02/19 Introduced \ttl@startargs.
-
-History of v2.1.1
-~~~~~~~~~~~~~~~~~
-1999/08/04 Moved misplaced lines in \ttl@makeboth
-
-History of v2.2 (unreleased)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-1999/11/03 We load titleps if pagestyles are required, but
- some old definitions are restored.
-1999/11/06 Improved outermarks test in \ttl@sect@i. Formerly
- the section number could be printed if a page ended
- with an unnumebered section followed by a numbered one.
-1999/11/06 \ttl@startargs now adds (and passes) automatically the
- section name. Involved macros modified accordingly.
-1999/11/06 Replaced explicit part names by the parameter in
- \ttl@part@i. The same for chapter.
-1999/11/21 \ttl@try's are not given explicitly, but built by
- \ttl@setkeys. Intruduced the \ttl@key@... and
- \ttl@extra@... commands.
-1999/11/23 Minor problems with keys fixed.
-1999/12/10 Added the nobottomtitles* option and \ttl@addstretch.
-2000/01/07 First steps towards the calcwidth feature (basic code).
-2000/01/08 (Continued.) \titleline* for rules of width \titlewidth.
- Option calcwidth implemented.
-2000/01/12 Finished with changes in wrap.tss (no longer
- "experimental" :-) )
-
-History of v2.3
-~~~~~~~~~~~~~~~
-2000/01/19 All keys are grouped in a single file tttkeys. Removed
- page.tsk and deleted the corresponding code in the sty.
-2000/01/19 Classes begun.
-2000/01/19 The level numbers are stored in \ttll@ macros, and not
- passed as arguments.
-2000/01/21 Introduced the new mark scheme. It's mostly compatible
- with the old one, but a compatibility mode seems
- imposible (it was introduced in a preliminary test
- but eventually removed).
-2000/01/23 loadonly package option.
-2000/02/01 Classes finished. Many things had to be rewritten.
-2000/02/02 Made partially compatible with hyperref (dvips).
-2000/02/08 \ttl@savewrite moved from shapes to classes. But
- explicit page breaks expand it, too, to avoid wrong
- toc entries.
-2000/02/18 A new box named \ttl@box stores the title in runin
- leftmargin etc shapes, to increase reliability.
-
-(2.3.1 -- 2.3.3 No changes on this file)
-
-History of v2.3.4
-~~~~~~~~~~~~~~~~~
-2000/05/12 nonindentfirst redefine \titlespacing instead of
- \@afterindent... so that they don't interfere with
- the first entry in tocs.
-2000/05/17 The marks in \ttl@select are protected to prevent
- endless loop if the title is expanded, say, by
- \MakeUppercase.
-
-History of v2.3.5
-~~~~~~~~~~~~~~~~~
-2000/05/21 Restores missing test for secnumdepth in \ttl@mkchap,
- and instead of setting \ttl@toclevel in ttlps now is
- done in \secdef. Except inside the macros, \ttl@toclevel
- is false, so that an explicit \...mark works.
-2000/06/04 \partmark defined with \providecommand
-2000/06/14 A patch mechanism added, for small bug fixes.
-
-History of v2.4
-~~~~~~~~~~~~~~~~
-2001/01/18 Minor changes in code. Essentialy an incremental
- update.
-2001/01/22 \titleformat has a new "easy" starred variant.
-
-History of v2.5
-~~~~~~~~~~~~~~~
-2002/01/02 New macros for \ttl@assign. Now * length allow
- non integer values.
-2002/03/22 Added \ttl@calc and \ttl@calcneg to make titlesec
- calc-savvy.
- - Merged bug fixes of .new into this file.
- - Bugs in frame fixed -- gap in lines, misplaced
- label, wrong margins (sometimes),
- - \leftskip, \rightskip and \linewidth (re)set in
- margin shapes.
- - Removed obsolete flush... options.
- - indentafter and noindentafter, new names for
- indentfirst and nonindentfirst.
- - A new level (\titleclass) without its "location"
- now raises a meaningful error.
- - Bug in top-level \titleclass fixed.
-2002/03/23 Tests for undefined and unformatted sectioning levels,
- and horizontal material in <format>.
- - Missing \if@openright inside \if@twoside in
- page class added.
- - Removed extra (but inoffensive) \expandafter
- in \ttl@class@iii.
-2002/03/27 Added \titlewidthfirst and ...last
- - "Not definable" gives a more meaningful message in
- the context of the package.
-
-History of v.2.6
-~~~~~~~~~~~~~~~~
-2004/08/30 Corrected typo in margin \hsiz -> \hsize.
-2004/10/17 Added a couple of missing \noexpand's in drop.
-2004/12/01 Removed the error about the mode in block because this
- style is general purpose.
-2005/01/16 Missing braces around #2 in the last else part of
- \ttl@headinline added
- - Replaced explicit \makeatother's by a saved value as
- the macros can be used in a class/package file.
-2005/01/18 newlinetospace mechanism
- - // does not break pages; option pageatnewline to
- restore the LaTeX behaviour.
-2005/01/19 \...break in top shape.
- - Renumbered several scratch registers to follow the
- TeXbook (p. 346), with \ttl@box in a few cases. In
- wrap \titlewidthfirst and \titlewidthlast made global.
- - Float heads and foots have now a further argument for
- additional stuff (eg, to remove rules). Option is now
- psfloats while floatps enters in compatibility mode.
- - \ttl@savetitle in all classes. Option toctitles.
-2005/01/21 Changed pageatnewline to make it compatible with
- titletoc, with \ttl@changecentercr.
-2005/01/22 \...tolist in top class.
-
-History of v.2.7
-~~~~~~~~~~~~~~~~
-2007-03-27 Added the `explicit' option.
- - Added \titlepagestyle.
-2007-03-29 Fixed wrong number for chapter in log
- - Patch file named .270 instead of .new
-2007-05-09 Added <after> to leftmargin, so that you can add stuff
- at the beginning of the paragraph, eg, the sec number.
-2007-07-07 Removed the patch mechanism.
-2007-08-07 `explicit' improved.
-
-History of v.2.8
-~~~~~~~~~~~~~~~~
-2007-08-12 \titlepagestyle already used by KOMA-Script. Renamed
- to \assignpagestyle.
-
-History of v.2.9
-~~~~~~~~~~~~~~~~
-2010-05-04 Add \nobreak in \ttl@addcontentsline, to prevent the title
- going to footnotes (!) in runin style in some (rare) cases.
-2010-05-06 Option uppercase (and \ttl@case).
-2011-02-25 \iftitlemeasuring test
-2011-07-14 Fixed \assignpagestyle
-2011-07-15 Introduced the \scantokens mechanism to make sure section
- names are 'letters' and not 'others'
-2011-07-18 Removed \if@nobreak test in wrap/drop, which added a line
- to the title after another section (why?)
-
-History of v.2.9.1
-~~~~~~~~~~~~~~~~~~
-2011-08-28 Removed a spurious > in wrap.tss
-
-History of v.2.9.2
-~~~~~~~~~~~~~~~~~~
+Titlesec changes
+
+History of v1.0
+~~~~~~~~~~~~~~~
+1998/02/25 Added nops option
+1998/02/28 Added \@mkboth stuff in \setmarks
+1998/03/01 Changed test in \ttl@secnum
+1998/03/03 Corrected some \fil... commands
+1998/03/03 Replaced the faulty \@hangfrom by new commands
+1998/03/03 Some \def replaced by \newcommand
+1998/03/04 .dtx/.ins scheme finally rejected. Useless
+ for users, obtrusive for `readers' and proned
+ to errors
+1998/03/04 Tidied up documentation
+1998/03/06 \wordsep renamed and documented
+1998/03/06 Added dummy asignation in \ttl@chap.
+1998/03/06 Removed \ttl@xsect and merged into \tl@sect
+1998/03/06 Added \ProvidesPackage
+
+History of v1.1
+~~~~~~~~~~~~~~~~
+1998/03/25 \chapter corrected, as well as the size options
+1998/03/26 Added compact option
+1998/03/26 Added flushleft, flushright and center options
+1998/04/08 Changed all instances of \noindent by \parindent\z@
+1998/04/14 Added \filinner, \filouter
+1998/04/14 Added drop shape
+1998/05/01 Added rightmargin shape (and margin renamed to
+ leftmargin)
+1998/05/03 Added \setheadindent
+
+History of v1.2 (unreleased)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1998/06/01 Compatibility with AMS classes
+1998/06/08 On-demand loading of shapes
+1998/06/11 Frame shape. Some \fil... command
+ modified to work in the label of this
+ chapter shape.
+1998/07/03 Bottomtitle option (at last...)
+1998/07/14 ...margin styles bug fixed using a method
+ similar to bottomtitle.
+1998/07/29 \titleline
+
+====================
+
+History of v2.0
+~~~~~~~~~~~~~~~~
+
+1998/08/05 to
+1998/08/29 Fully reimplemented
+
+History of v2.1
+~~~~~~~~~~~~~~~~
+1999/01/05 We define in this file the three basic shapes.
+ Additional ones remain defined in external files.
+ Unified the shapes for sections and chapters.
+1999/01/05 \ttl@shape merged into \ttl@format@iii.
+1999/01/05 \titlerule
+1999/01/07 \ttl@defkeys splitted from \ttl@keys
+1999/01/10 Added the \part stuff, including a definition of \@openright
+1999/01/11 Removed unnecessary \ttl@numsecfalse in \ttl@sect@i.
+1999/01/14 Optimized \titlerule
+1999/01/27 Changed \titleline to correct the spacing at the
+ top page and to fix a bug which changed the mode
+ to horizontal, thus introducing unwanted space
+ (\makebox -> \@makebox).
+1999/02/02 \ttl@secnum renamed to \ttl@write and introduced the
+ \ttl@savewrite mechanism to sincronize the toc/marks
+ with the title in case there is a \newpage in <after>.
+1999/02/03 wrap shape
+1999/02/03 Added a \kern\z@ for not to avoid hyphenation
+ of the last word. Not strictly necessary, but
+ it is more LaTeX-like.
+1999/02/05 \partmark defined (and in \setmarks, too).
+1999/02/08 \ttl@row@i simplified.
+1999/02/08 \ttl@savefn mechanism.
+1999/02/10 Removed extra \leavevmode in display
+1999/02/13 Now \titleline doesn't add the width. It's set.
+1999/02/17 The part mark is catched, even if unused.
+1999/02/17 old/newparttoc added.
+1999/02/18 Changed many TeX assignments to the LaTeX
+ counterpart.
+1999/02/19 Introduced \ttl@startargs.
+
+History of v2.1.1
+~~~~~~~~~~~~~~~~~
+1999/08/04 Moved misplaced lines in \ttl@makeboth
+
+History of v2.2 (unreleased)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1999/11/03 We load titleps if pagestyles are required, but
+ some old definitions are restored.
+1999/11/06 Improved outermarks test in \ttl@sect@i. Formerly
+ the section number could be printed if a page ended
+ with an unnumebered section followed by a numbered one.
+1999/11/06 \ttl@startargs now adds (and passes) automatically the
+ section name. Involved macros modified accordingly.
+1999/11/06 Replaced explicit part names by the parameter in
+ \ttl@part@i. The same for chapter.
+1999/11/21 \ttl@try's are not given explicitly, but built by
+ \ttl@setkeys. Intruduced the \ttl@key@... and
+ \ttl@extra@... commands.
+1999/11/23 Minor problems with keys fixed.
+1999/12/10 Added the nobottomtitles* option and \ttl@addstretch.
+2000/01/07 First steps towards the calcwidth feature (basic code).
+2000/01/08 (Continued.) \titleline* for rules of width \titlewidth.
+ Option calcwidth implemented.
+2000/01/12 Finished with changes in wrap.tss (no longer
+ "experimental" :-) )
+
+History of v2.3
+~~~~~~~~~~~~~~~
+2000/01/19 All keys are grouped in a single file tttkeys. Removed
+ page.tsk and deleted the corresponding code in the sty.
+2000/01/19 Classes begun.
+2000/01/19 The level numbers are stored in \ttll@ macros, and not
+ passed as arguments.
+2000/01/21 Introduced the new mark scheme. It's mostly compatible
+ with the old one, but a compatibility mode seems
+ imposible (it was introduced in a preliminary test
+ but eventually removed).
+2000/01/23 loadonly package option.
+2000/02/01 Classes finished. Many things had to be rewritten.
+2000/02/02 Made partially compatible with hyperref (dvips).
+2000/02/08 \ttl@savewrite moved from shapes to classes. But
+ explicit page breaks expand it, too, to avoid wrong
+ toc entries.
+2000/02/18 A new box named \ttl@box stores the title in runin
+ leftmargin etc shapes, to increase reliability.
+
+(2.3.1 -- 2.3.3 No changes on this file)
+
+History of v2.3.4
+~~~~~~~~~~~~~~~~~
+2000/05/12 nonindentfirst redefine \titlespacing instead of
+ \@afterindent... so that they don't interfere with
+ the first entry in tocs.
+2000/05/17 The marks in \ttl@select are protected to prevent
+ endless loop if the title is expanded, say, by
+ \MakeUppercase.
+
+History of v2.3.5
+~~~~~~~~~~~~~~~~~
+2000/05/21 Restores missing test for secnumdepth in \ttl@mkchap,
+ and instead of setting \ttl@toclevel in ttlps now is
+ done in \secdef. Except inside the macros, \ttl@toclevel
+ is false, so that an explicit \...mark works.
+2000/06/04 \partmark defined with \providecommand
+2000/06/14 A patch mechanism added, for small bug fixes.
+
+History of v2.4
+~~~~~~~~~~~~~~~~
+2001/01/18 Minor changes in code. Essentialy an incremental
+ update.
+2001/01/22 \titleformat has a new "easy" starred variant.
+
+History of v2.5
+~~~~~~~~~~~~~~~
+2002/01/02 New macros for \ttl@assign. Now * length allow
+ non integer values.
+2002/03/22 Added \ttl@calc and \ttl@calcneg to make titlesec
+ calc-savvy.
+ - Merged bug fixes of .new into this file.
+ - Bugs in frame fixed -- gap in lines, misplaced
+ label, wrong margins (sometimes),
+ - \leftskip, \rightskip and \linewidth (re)set in
+ margin shapes.
+ - Removed obsolete flush... options.
+ - indentafter and noindentafter, new names for
+ indentfirst and nonindentfirst.
+ - A new level (\titleclass) without its "location"
+ now raises a meaningful error.
+ - Bug in top-level \titleclass fixed.
+2002/03/23 Tests for undefined and unformatted sectioning levels,
+ and horizontal material in <format>.
+ - Missing \if@openright inside \if@twoside in
+ page class added.
+ - Removed extra (but inoffensive) \expandafter
+ in \ttl@class@iii.
+2002/03/27 Added \titlewidthfirst and ...last
+ - "Not definable" gives a more meaningful message in
+ the context of the package.
+
+History of v.2.6
+~~~~~~~~~~~~~~~~
+2004/08/30 Corrected typo in margin \hsiz -> \hsize.
+2004/10/17 Added a couple of missing \noexpand's in drop.
+2004/12/01 Removed the error about the mode in block because this
+ style is general purpose.
+2005/01/16 Missing braces around #2 in the last else part of
+ \ttl@headinline added
+ - Replaced explicit \makeatother's by a saved value as
+ the macros can be used in a class/package file.
+2005/01/18 newlinetospace mechanism
+ - // does not break pages; option pageatnewline to
+ restore the LaTeX behaviour.
+2005/01/19 \...break in top shape.
+ - Renumbered several scratch registers to follow the
+ TeXbook (p. 346), with \ttl@box in a few cases. In
+ wrap \titlewidthfirst and \titlewidthlast made global.
+ - Float heads and foots have now a further argument for
+ additional stuff (eg, to remove rules). Option is now
+ psfloats while floatps enters in compatibility mode.
+ - \ttl@savetitle in all classes. Option toctitles.
+2005/01/21 Changed pageatnewline to make it compatible with
+ titletoc, with \ttl@changecentercr.
+2005/01/22 \...tolist in top class.
+
+History of v.2.7
+~~~~~~~~~~~~~~~~
+2007-03-27 Added the `explicit' option.
+ - Added \titlepagestyle.
+2007-03-29 Fixed wrong number for chapter in log
+ - Patch file named .270 instead of .new
+2007-05-09 Added <after> to leftmargin, so that you can add stuff
+ at the beginning of the paragraph, eg, the sec number.
+2007-07-07 Removed the patch mechanism.
+2007-08-07 `explicit' improved.
+
+History of v.2.8
+~~~~~~~~~~~~~~~~
+2007-08-12 \titlepagestyle already used by KOMA-Script. Renamed
+ to \assignpagestyle.
+
+History of v.2.9
+~~~~~~~~~~~~~~~~
+2010-05-04 Add \nobreak in \ttl@addcontentsline, to prevent the title
+ going to footnotes (!) in runin style in some (rare) cases.
+2010-05-06 Option uppercase (and \ttl@case).
+2011-02-25 \iftitlemeasuring test
+2011-07-14 Fixed \assignpagestyle
+2011-07-15 Introduced the \scantokens mechanism to make sure section
+ names are 'letters' and not 'others'
+2011-07-18 Removed \if@nobreak test in wrap/drop, which added a line
+ to the title after another section (why?)
+
+History of v.2.9.1
+~~~~~~~~~~~~~~~~~~
+2011-08-28 Removed a spurious > in wrap.tss
+
+History of v.2.9.2
+~~~~~~~~~~~~~~~~~~
2011-11-11 Fixed a typo in ttlps.def (\MessageBreag) \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/titlesec/README b/Master/texmf-dist/doc/latex/titlesec/README
index dfb3c519d4d..cd36dc30329 100644
--- a/Master/texmf-dist/doc/latex/titlesec/README
+++ b/Master/texmf-dist/doc/latex/titlesec/README
@@ -1,70 +1,74 @@
-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.9.2.
-
-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.
-
-Titleps
-~~~~~~~
-With this package you have access to most (but not all) of the
-features provided by titlesec for page styles.
-
-What's new (2.9)
-~~~~~~~~~~~~~~~~
-
-- Fixed \assignpagestyle, which did not work except in a
-few cases.
-- Fixed an incompatibility with hyperref (wrong appendix
-name).
-- Added \iftitlemeasuring
-- Added package option uppercase
-- Fixed a bug when reckoning the number of lines in wrap/drop.
-
-2.9.1: Fixed a typo (a spurious > in wrap.tss).
-2.9.2: Fixed another typo (\MessageBreag in ttlps.def)
-
-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.
-
-Formerly there were files with extension .new (titlesec.new and
-titletoc.new) used to patch the packages, but if present should be
-removed (they will be ignored, however).
-
-Web site, manual in PDF format and info
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-More details are available on
-
- http://www.tex-tipografia.com/titlesec.html
-
-Contact
-~~~~~~~
-Please, for suggestions, bug reports, etc., go to
-
- http://www.tex-tipografia.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.
-
-2011/11/17
-
+This directory holds 3 packages for sectioning titles -- when used as
+such (titlesec), in headers and footers (titleps) and in tables of
+contents (titletoc). They can be used separately, but you will get
+most of them when used together.
+
+Titlesec
+~~~~~~~~
+Sectioning titles, including margin and `wrap' titles, different
+format in odd and even pages, rules above and below the title,
+adding new sectioning levels, measuring the width of the title, etc.
+
+Titletoc
+~~~~~~~~
+TOC entries, with 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. It's described in titlesec.pdf
+(or .tex).
+
+Titleps
+~~~~~~~
+Page styles with working top marks, access to top, first and bot marks
+in a single header/footer, rules, headers/footers for specific floats
+(kinda \thispagestyle), multiple sets of marks, etc. An one-stage
+mechanims is used, without intermediate \leftmark's or \rightmark's.
+
+What's new (2.9. 2.10)
+~~~~~~~~~~~~~~~~
+
+- Fixed \assignpagestyle, which did not work except in a
+few cases.
+- Fixed an incompatibility with hyperref (wrong appendix
+name).
+- Added \iftitlemeasuring
+- Added package option uppercase
+- Fixed a bug when reckoning the number of lines in wrap/drop.
+
+2.9.1: Fixed a typo (a spurious > in wrap.tss).
+2.9.2: Fixed another typo (\MessageBreag in ttlps.def)
+2.10.0: New features in titleps also available in titlesec
+
+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.
+
+Formerly there were files with extension .new (titlesec.new and
+titletoc.new) used to patch the packages, but if present should be
+removed (they will be ignored, however).
+
+Web site, manual in PDF format and info
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Further details are available on
+
+ http://www.tex-tipografia.com/titlesec.html
+
+Contact
+~~~~~~~
+Please, for suggestions, bug reports, etc., go to
+More
+ http://www.tex-tipografia.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.
+
+2011/12/15
+
diff --git a/Master/texmf-dist/doc/latex/titlesec/titleps.pdf b/Master/texmf-dist/doc/latex/titlesec/titleps.pdf
new file mode 100644
index 00000000000..b4f8bd4f65d
--- /dev/null
+++ 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
new file mode 100644
index 00000000000..5dab28b7eab
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/titlesec/titleps.tex
@@ -0,0 +1,791 @@
+% +--------------------------------------------------+
+% | Typeset this file to get the documentation. |
+% +--------------------------------------------------+
+%
+% Copyright (c) 1998-2011 by Javier Bezos.
+% All Rights Reserved.
+%
+% This file is part of the titlesec distribution release 2.10.0
+% -----------------------------------------------------------
+%
+% 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{1.1.0}
+\def\docdate{2011-12-15}
+
+\documentclass[a4paper]{ltxguide}
+\usepackage[sf,bf,compact,topmarks,calcwidth,pagestyles]{titlesec}
+\usepackage{titletoc}
+\def\gobble#1{}
+\def\cs#1{\expandafter\gobble\string\\#1}
+\makeatletter
+\newenvironment{desc}
+ {\if@nobreak
+ \vskip-\lastskip
+ \vspace*{-2.5ex}%
+ \fi
+ \decl}
+ {\enddecl}
+\makeatother
+
+\usepackage{textcomp,pslatex}
+\usepackage[linktocpage]{hyperref}
+
+\title{Headers and footers with \textsf{titleps}\footnote{The
+\textsf{titleps} package is currently at version \fileversion.
+\copyright{} 2011 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
+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}
+
+\widenhead{2.1pc}{0pc}
+\titlelabel{\thetitle.\quad}
+
+\renewpagestyle{plain}[\small\sffamily\slshape]{
+ \footrule
+ \setfoot{}{\thepage}{}}
+
+\newpagestyle{myps}[\small\sffamily\slshape]{
+ \headrule
+ \sethead{titlesec -- titleps}{\sectiontitle}{\thepage}}
+
+\pagestyle{myps}
+
+\newcommand{\examplesep}{%
+ \begin{center}%
+ \rule{4pt}{4pt}%
+ \end{center}}
+
+\contentsmargin{0pt}
+
+\titlecontents*{section}[0pt]%[1.8pc]
+ {}
+ {\thecontentslabel. }
+ {}
+ {, \thecontentspage}
+ [. --- ][.]
+
+\addtolength{\topmargin}{-3pc}
+\addtolength{\textwidth}{6pc}
+\addtolength{\oddsidemargin}{-2pc}
+\addtolength{\textheight}{7pc}
+
+\raggedright
+\parindent1em
+\parskip0pt
+
+\begin{document}
+
+\maketitle
+\tableofcontents
+\section{Introduction}
+
+The \textsf{titleps} package provides tools for one-stage setting of
+page styles (headlines and footlines). A higher-level interface is
+used, where the mark mechanism is hidden and there is no need to deal
+with |\leftmark|s and |\rightmark|s -- just use a command or variable
+registered as a ``mark'' as the expected value will be returned, i.e.,
+those when the mark was emitted, either by a sectioning command or
+explicitly with |\chaptermark|, |\sectionmark|, etc. A simple
+example, whose meaning should be obvious, is:
+\begin{verbatim}
+\newpagestyle{main}{
+ \sethead[\thepage][\chaptertitle][(\thesection] % even
+ {\thesection)}{\sectiontitle}{\thepage}} % odd
+\pagestyle{main}
+\end{verbatim}
+
+Other features are:
+\begin{itemize}
+\item Working top marks, compatible with floats (unlike the standard
+|\topmark|, which does not work correctly in \LaTeX{}).
+\item Access to top, first and botttom marks in a single headline/footline
+(e.g., the first and last section numbers).
+\item Marks for more than 2 sectioning levels.
+\item Auto-defining of suitable |\sectionmark| and the like.
+\item Simple (and not so simple) headrules and footrules.
+\item Headlines and footlines for pages with floats.
+\item Headlines and footlines for specific floats (a sort of
+|\thispagestyle| for floats).
+\item Multiple sets of marks (named here \emph{markset}s and
+\textit{extra marks}).
+\end{itemize}
+
+It can be used without \textsf{titlesec}, but you will get most of
+it when used together. To load it as a separate package, use the
+customary \verb|\usepackage{titleps}|, but with \textsf{titlesec} you
+have to load it with:
+\begin{verbatim}
+\usepackage[pagestyles]{titlesec}
+\end{verbatim}
+
+Specific tools for sectioning command marks are provided, which are
+considered the main \textit{markset} (unnamed) and carry out some
+internal task. However, \textsf{titleps} can be used as well for
+headers with the first an last entry of a page in a dictionary or index,
+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{%
+Two columns layout requires the \textsf{fix2col} package by David
+Carlisle.}
+
+Once loaded the package, you can define your own page styles and then
+activate them, but note page styles so defined cannot be used with
+\verb|\thispagestyle| except if the surrounding page style has been
+defined with \textsf{titleps}, too.
+
+%%%% empty ? plain ?
+
+\section{Defining Page Styles}
+
+\begin{desc}
+|\newpagestyle{<name>}[<global-style>]{<commands>}|\\
+|\renewpagestyle{<name>}[<global-style>]{<commands>}|
+\end{desc}
+
+Defines a new style or redefines an existing one, named |<name>|. For
+convenience, spaces and end of lines are ignored, and you need not
+``hide'' them with |%|.\footnote{Even if marks should be reserved
+to pass information
+to headers, some classes, like the AMS ones, introduce additional
+code. When redefining the |plain| style of AMS classes, you must add
+the following line: |\cs{global}\cs{topskip}\cs{normaltopskip}|.}
+
+|<global-style>| is any command to be applied to both footlines and
+headlines. Fragile commands are allowed.
+
+In |<commands>| you can use:
+
+
+\begin{desc}
+|\sethead[<even-left>][<even-center>][<even-right>]|\\
+| {<odd-left>}{<odd-center>}{<odd-right>}|\\
+|\setfoot[<even-left>][<even-center>][<even-right>]|\\
+| {<odd-left>}{<odd-center>}{<odd-right>}|
+\end{desc}
+
+Set the corresponding part in headlines and footlines (note the
+``visual'' layout of parameters). The optional arguments are the
+three or none. If no optional arguments are given the odd-page
+settings applies to both even and odd pages. A couple of starred
+variant (|\setfoot*|, |\sethead*|) reverses the order of the settings
+for even pages (obviously, with them the optional arguments are not
+allowed). If |\sethead| is not given, then the headline it is left
+empty, and same for |\setfoot| and the footline.
+
+In the arguments of |\sethead|/|\setfoot| and because of its one-stage
+mechanism, we must distinguish between two groups of commands:
+\begin{itemize}
+\item The first one includes those saved when the marks are emitted,
+with information related to sections, and includes:
+\begin{itemize}
+\item |\thechapter|, |\thesection|, |\thesubsection|\dots{}
+\item |\chaptertitle|, |\sectiontitle|, |\subsectiontitle|\dots{} which print the
+chapter, section\dots{} title.
+\item (Only \textsf{titlesec}. Not in \textsf{titleps}.)
+|\ifthechapter{<true>}{<false>}|, |\ifthesection{<true>}{<false>}|,
+|\ifthesubsection{<true>}{<false>}|\dots{} which expands to |<true>|
+except if the corresponding title lacks of label or there is no title
+yet after the superior level (for example, between |\chapter| and a
+subsequent |\section|).
+\item Any other command or value ``registered'' as ``mark.'' (See below.)
+\end{itemize}
+They are ordinary commands, with no internal marks at all, and you can
+test if, for example, they are empty.
+
+\item The second group are those expanded on every page, and includes:
+\begin{itemize}
+\item |\thepage|.
+\item Any other command not included in the previous items.
+\end{itemize}
+\end{itemize}
+
+\begin{desc}
+|\settitlemarks{<level-name>,<sublevel-name>,<subsublevel-name>...}|\\
+|\settitlemarks*{<level-name>,<sublevel-name>,<subsublevel-name>...}|
+\end{desc}
+Sets which |\...title| commands are to be defined, and when the marks
+are emitted; any number of levels is allowed (1, 2, 3...). For example
+|\settitlemarks{chapter,section}|
+means that:
+\begin{itemize}
+\item |\chaptertitle| and |\sectiontitle| are the allowed titles in
+ headlines,
+\item |\sectiontitle| is reset in |\chapter|,
+\item (Only \textsf{titlesec}. Not in \textsf{titleps}.)
+|\ifthechapter| and |\ifthesection| are valid tests.
+\item Marks are updated in |\chapter| and |\section|.
+\end{itemize}
+Default is |\settitlemarks{chapter,section}|, but
+|\settitlemarks{section,subsection}| in \textsf{article} class.
+|\settitlemarks| may be used outside |\(re)newpagestyle| to set the
+default to be used in newly defined and redefined page styles -- it is
+used in |\pagestyle|.\footnote{The command \texttt{\string\setmarks} is
+deprecated. Now
+\texttt{\string\setmarks\string{<primary>\string}\string{<secondary>\string}}is
+\texttt{\string\settitlemarks\allowbreak\string{<primary>,\allowbreak<secundary>\string}}.}
+
+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>}|
+\end{desc}
+
+If you want a rule below the headline and above the footline. You may
+also set their width directly with the commands |\setheadrule| and
+|\setfootrule|. (For instance, |\setheadrule{.4pt}| which is, by the
+way, the default value.)
+
+These commands are local to a page style, i.e., defining them directly
+in the preamble will not work because the page style settings will
+override them.
+
+\begin{desc}
+|\makeheadrule \makefootrule|
+\end{desc}
+
+These commands are used by \textsf{titleps} to typeset the rules.
+If there is no rule, both commands are empty (this value is the
+default).
+|\setheadrule{|\emph{dim}|}| just stands for
+\begin{verbatim}
+\renewcommand{\makeheadrule}{\rule[-.3\baselineskip]{\linewidth}{<dim>}}
+\end{verbatim}
+unless if \emph{dim} is 0 pt, which empties
+|\makeheadrule| (and similarly |\setfootrule|).
+
+You can access the total header/footer width with |\linewidth|
+but the box enclosing the rule is in fact dimensionless. Hence,
+you must be concerned with the rule placement only. Its
+baseline is the same as that of the header/footer. That means the
+material to be used as rule should be raised or lowered with
+|\raisebox|, the lifting argument in |\rule| or by using sensible
+coordinates in |picture|, for instance. That makes easy to
+place material above \emph{and} below. For instance,
+the following code creates a headline with a black bold line
+above and a red rule below (the \textsf{color} package is required):
+\begin{verbatim}
+\renewcommand{\makeheadrule}{%
+ \makebox[0pt][l]{\rule[.7\baselineskip]{\linewidth}{0.8pt}}%
+ \color[named]{Red}%
+ \rule[-.3\baselineskip]{\linewidth}{0.4pt}}
+\end{verbatim}
+
+Of course, the material to be used as rule is not restricted to actual
+rules; pictures and leaders, for instance, are allowed, too.
+
+\section{Headline/footline width}
+
+\begin{desc}
+|\widenhead[<even-left>][<even-right>]{<odd-left>}{<odd-right>}|\\
+|\widenhead*{<even-right/odd-left>}{<even-left/odd-right>}|
+\end{desc}
+
+Makes the headlines/footlines lines wider. The extra width is
+asymmetrically added and hence the two [four] arguments. Like
+|\sethead|, the starred version reverses the setting for even
+pages---for example, |\widenhead*{0pt}{6pc}| is the same as
+|\widenhead[6pc][0pt]{0pt}{6pc}|.
+
+To be used outside |\(re)newpagestyle|.
+
+\begin{desc}
+|nopatches| \qquad (package option)
+\end{desc}
+
+By default, sectioning commands are patched slightly for top marks
+and |\@mkboth| to work, so that page styles behave like standard
+|headings|. However, if you want to be explicit, like with standard
+|myheadings|, and emit premarks and, if necessary, marks by yourself,
+set this package option. Remenber you have to use |\sectionmark| and
+the like, and not |\markboth| or |\markright|.
+
+You might also prefer to patch the sectioning commands by yourself,
+either with low-level definitions or with the provided
+|\TitlepsPatchSection| (with a starred version which adds no premark
+and intended mainly for chapters). For example:
+\begin{verbatim}
+\TitlepsPatchSection*{chapter} % patches \chapter
+\TitlepsPatchSection{section} % patches \section
+\end{verbatim}
+(In standard classes |\part| emits no mark, and therefore it is not
+patched by default.)
+
+\section{Marks}
+
+Marks can be retrieved in 4 ways:
+\begin{description}
+\item[top marks] If a page begins with text, they are the marks
+belonging to the sectioning unit of that text. If a page begin with a
+sectioning title, they are the marks of that title. In other words,
+top marks refer to the section immediately adjacent to the
+headline.
+\item[first marks] The marks of the very first sectioning title.
+\item[botttom marks] The marks of the very last (bottom) sectioning
+title (also known as \textit{bot marks}).
+\item[next top marks] A botttom mark with the values of the top mark of
+the next page (only |straight| class or equivalent); by picking some
+value from it and comparing it with the corresponding value from the
+botttom marks you may know if a section continues in the next page.
+Of course, it will not be used very often.
+\end{description}
+Standard \LaTeX{} provides only first and bottom marks. As you see, with
+\textsf{titleps} you have two additional marks, namely, top and next
+top marks.
+
+It should be stressed top marks are not the same as the primitive
+\verb|\topmark| (which, in fact, is not used internally at all). They
+are true top marks, returning the expected result when the title is at
+the top of the page. Further, they are compatible with floats, which
+is not true with \verb|\topmark|s. However, they fail with explicit
+page breaks, but you can use \verb|\pretitlemark| as described
+below.
+
+\begin{desc}
+|outermarks innermarks topmarks botmarks| \qquad (package options)
+\end{desc}
+
+|innermarks| is the default in \LaTeX, with bottom marks in even pages
+and first marks in odd pages. More convenient is |outermarks|, with
+top marks in even pages and bottom marks in odd pages; it is the more
+usual system in classic scientific literature and it is described in
+\textit{The \TeX{}book}, p.~259.\footnote{|outermarks| may not work
+well in conjunction with explicit |\string\<section>mark| commands} Both of them are intended for two side printing;
+|topmarks|/|botmarks| are intended for one side printing with top/bot
+marks in every page (they can be used in two side printing as well).
+
+\begin{desc}
+|\bottitlemarks \toptitlemarks \firsttitlemarks \nexttoptitlemarks|\\
+|\outertitlemarks \innertitlemarks|
+\end{desc}
+
+These commands set which mark the values of the subsequent
+|\thesection|, |\sectiontitle|, etc., will be taken from.
+These macros are switches, and therefore subsequent commands and
+variables are taken from the selected mark. The following is valid:
+\begin{verbatim}
+\toptitlemarks\textbf{\thesection.} \sectiontitle --
+\bottitlemarks\textbf{\thesection.} \sectiontitle
+\end{verbatim}
+
+You can use them freely in your headers;\,%
+\footnote{Not exactly: top marks must not be used in the page where a
+chapter begins, except by overriding the default definition and making
+it of |top| class.} just for fun, the following header shows the
+section label from three of these marks:
+\begin{verbatim}
+\newpagestyle{funny}{
+ \sethead{\toptitlemarks Top is \thesection}
+ {\firsttitlemarks First is \thesection}
+ {\bottitlemarks Bot is \thesection}}
+\end{verbatim}
+
+In multilingual documents, the language in force is that corresponding
+to the package options -- command versions does not switch the
+language, but you can do it easily with the help a new title mark and
+then switching the language, as explained below.
+
+\begin{desc}
+|\newtitlemark{<command-name>}|\\
+|\newtitlemark*{<variable-name>}|
+\end{desc}
+
+Add a command or a variable to the list of ``marks'' to be emitted at
+a sectioning command. The macro must be parameterless, and the
+variable is either a length, if it has the form \verb|\<name>|, or a
+counter, if it has the form \verb|<name>| (i. e., a string).
+For example, if you write (with \textsf{babel}):
+\begin{verbatim}
+\newtitlemark{\languagename}
+\end{verbatim}
+then a |\languagename| in the head/foot will contain the language when
+the corresponding mark was emitted; unfortunately, \textsf{babel}
+does not allow |\languagename| as the first argument of
+|\foreignlanguage| (it enters in a infinite loop), but there is a
+simple trick -- just use an intermediate command:
+\begin{verbatim}
+\newcommand\titlelanguage{\languagename}
+\newtitlemark{\titlelanguage}
+\end{verbatim}
+(What is saved is the expansion of |\titlelanguage|, which is turn is
+the expansion of |\languagename|. Alternatively, you can create the
+intermediate command with |\let| in the header itself.)
+
+Marks to be emitted at other places (not sectioning commands) are
+handled with extra marks and \textit{marksets} (see below).
+
+Commands must be robust, but not protected, or the value returned will
+not be the right one. Remember there are two kinds of robust commands
+-- those containing in turn robust commands and those protected with,
+say, |\DeclareRobustCommand|.\footnote{Unfortunately,
+\texttt{\string\DeclareRobustCommand} has a misleading name, because a
+command created with \texttt{\string\newcommand} can be robust, too.
+A better name would have been
+\texttt{\string\DeclareProtectedCommand}.} An example of how to use
+protected commands is a layout used sometimes if sections are long as
+well as their titles, where the title is splitted across the left and
+the right pages. Here is how this can be carried out:
+\begin{verbatim}
+\DeclareRobustCommand\splitheader[2]{#1 #2}
+\def\contsplitheader{}
+
+\def\dosplitheader{%
+ \gdef\contsplitheader{}%
+ \DeclareRobustCommand\splitheader[2]{##1\gdef\contsplitheader{##2}}}
+
+\renewpagestyle{headings}{
+ \sethead[\thepage]
+ []
+ [\dosplitheader\sectiontitle]
+ {\contsplitheader}
+ {}
+ {\thepage}
+}
+
+\pagestyle{headings}
+\end{verbatim}
+(Note the header also uses |\DeclareRobustCommand|.)
+
+\begin{desc}
+|\pretitlemark{<section>}{<text>}|\\
+|\pretitlemark*{<section>}{<text>}|
+\end{desc}
+
+Top marks require in fact two marks, one before the page break and
+other after it. This is done by \textsf{titlesec}, while
+\textsf{titleps} patches the sectioning commands as described above.
+
+However, if you need an explicit page break you can emit the mark
+with |\pretitlemark|. For example:
+\begin{verbatim}
+\pretitlemark{section}{Performing Brahms}
+\newpage
+\section{Performing Brahms}
+\end{verbatim}
+Note the text in the premark is the title of the next section. The
+counter is advanced temporarily, so that it has the right value, but
+if for some reason you do not want that, just use
+\verb|\pretitlemark*|.
+
+\begin{desc}
+|\ifsamemark{<group>}{<command>}{<true>}{<false>}|
+\end{desc}
+
+One of the disavantaged of the switching mechanism is that comparing
+a command from, say, the top marks and the botttom marks is not
+trivial.
+This macro just makes it simpler. If you want to compare the
+currect \verb|\thesection| with that in the top mark, write:
+\begin{verbatim}
+\ifsamemark\toptitlemarks\thesection{<true>}{<false>}
+\end{verbatim}
+
+\section{Running heads with floats}
+
+\begin{desc}
+|psfloats| \qquad (package option)
+\end{desc}
+
+This package option activates the commands described in this section.%
+\footnote{It redefines some internal \LaTeX{} commands and there could be
+incompatibilities with other packages modifying the same commands. That's
+the very reason these commands are loaded only optionally. As of
+version 2.6 the syntax was extended with a new argument to allow
+extra stuff in running heads/foots. This change is backward
+compatible---just preserve the old name \verb|floatps|, which
+is deprecated, if you want the pre-2.6 behaviour.}
+
+\begin{desc}
+|\setfloathead*{.}{.}{.}{<extra>}[<which-floats>]|\\
+|\setfloathead[.][.][.]{.}{.}{.}{<extra>}[<which-floats>]|\\
+(Similarly |\setfloatfoot|.)
+\end{desc}
+
+The arguments with a dot are similar to those of |\sethead|. The final
+argument says the head is used when there is a float of
+the specified types (default is |tp| in headers, and |bp| in footers).
+For example:
+\begin{verbatim}
+\newpagestyle{main}{%
+ \sethead ... your definition
+ \setfoot ... your definition
+ \headrule
+ \footrule
+ \setfloathead{}{}{}{\setheadrule{0pt}}[p]
+ \setfloatfoot{}{}{}{\setfootrule{0pt}}[p]}
+\end{verbatim}
+removes the header/footer on float pages, including the rules.
+
+\begin{desc}
+|\nextfloathead*{.}{.}{.}{<extra>}[<which-floats>]|\\
+|\nextfloathead[.][.][.]{.}{.}{.}{<extra>}[<which-floats>]|\\
+(Similarly |\nextfloatfoot|.)
+\end{desc}
+
+You may force a header (respectively footer) when a certain float is
+the first top one (respectively last bottom) with those commands just
+before the corresponding float, where the arguments with a dot are
+similar to those of |\sethead|. Those commands are used by
+themselves, without putting them inside |\(re)newpagestyle|. So, to
+empty the headline when a certain figure is placed at the top (because
+it is a bleed, for example):
+\begin{verbatim}
+\nextfloathead{}{}{}{}[t]
+\begin{figure}
+...
+\end{figure}
+\end{verbatim}
+
+\section{Extra marks}
+
+Both \textsf{titlesec} and \textsf{titleps} provide tools for handling
+extra marks, if you are using an $\epsilon$-\TeX{} based engine
+(currently most of them) and load the \textsf{etex} package or
+equivalent. The way they work are conceptually similar to the title
+marks described above -- you set which commands or variables are to
+get synchronized in heads and foots. To use extra marks, you have to
+load them with the following package option:
+
+\begin{desc}
+|extramarks| \qquad (package option)
+\end{desc}
+
+Extra marks are subsidiary. If page styles are modified internally by
+another package and the document does not make use of sectioning
+commands, you might still need an empty title mark (like
+\verb|\sectionmark{}|), as well as to synchronize the language by
+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
+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
+
+\newcommand\lemma[1]{%
+ \renewcommand\lemmatitle{#1}%
+ \preshortmark\lemmatitle % if you want top marks
+ \pagebreak[2]%
+ \vspace{1em}%
+ \textbf{#1}\enspace
+ \shortmark\lemmatitle}
+
+\newpagestyle{main}{
+ \sethead{}{\topshortmark\lemmatitle
+ --\firstshortmark\lemmatitle
+ --\botshortmark\lemmatitle
+ --\nexttopshortmark\lemmatitle}{}}
+
+\pagestyle{main}
+\end{verbatim}
+
+Top marks require emitting the marks before the page break -- just use
+the command \verb|\preshortmark| as shown above. Otherwise, you may
+omit it. Unlike title marks and extra marks, the selector of short
+marks (\verb|\topshortmark|, \verb|\firstshortmark|,
+\verb|\botshortmark|, \verb|\nexttopshortmark|), is \textit{not} a
+switch and must be always immediately followed by the command to be
+retrieved.
+
+For a more general approach use the following tools.
+
+\begin{desc}
+|\newmarkset{<markset>}|
+\end{desc}
+
+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).
+
+\begin{desc}
+|\newextramark{<markset>}{<macro-name>}|\\
+|\newextramark*{<markset>}{<variable-name>}|
+\end{desc}
+
+Add to a \textit{markset} a command or a variable to be synchronized .
+They are identical to \verb|\newtitlemark| and \verb|\newtitlemark*|,
+except for the additional parameter with the \textit{markset} name.
+
+\begin{desc}
+|\botextramarks{<markset>} \topextramarks{<markset>}|\\
+|\firstextramarks{<markset>} \nexttopextramarks{<markset>}|\\
+|\outerextramarks{<markset>} \innerextramarks{<markset>}|
+\end{desc}
+
+The \verb|extra| counterparts of the \verb|title| commands described
+above, with the same behaviour. For example:
+\begin{verbatim}
+\newcommand{\lemmatitle}{}
+\newcounter{lemma}
+
+\newmarkset{lemma}
+\newextramark{lemma}{\lemmatitle}
+\newextramark*{lemma}{lemma} % ie, the counter `lemma'
+
+\newcommand{\lemma}[1]{%
+ \renewcommand{\lemmatitle}{#1}%
+ \stepcounter{lemma}%
+ \preextramark{lemma}%
+ \pagebreak[2]%
+ \vspace{1em}%
+ \textbf{(\arabic{lemma}) #1}\enspace
+ \extramark{lemma}}
+
+\newpagestyle{main}{
+ \sethead{}
+ {\topextramarks{lemma}(\arabic{lemma}) \textbf{\lemmatitle}}
+ {}}
+
+\pagestyle{main}
+\end{verbatim}
+
+\begin{desc}
+|\settitlemarks*{<level-name>,<sublevel-name>,<subsublevel-name>...}|
+\end{desc}
+
+By default, \LaTeX{} and \textsf{titleps} use a single \textit{markset} for
+all sectioning levels. This is problematic, for example, in the
+\textsf{article} class, because sections does not start a new page.
+Consider the following piece of code:
+\begin{verbatim}
+\section{A section}
+\subsection{A subsection}
+\end{verbatim}
+On odd pages with first marks and subsection titles, the head has
+no title, because \verb|\subsection| is the second mark, not the
+first one.
+
+To overcome this limitation, you can use the starred version of
+\verb|\settitlemarks|, which creates parallel \textit{marksets} (one per
+level) synchonized with the main \textit{markset}. They are retrieved like
+other extra marks, but they are special in that you cannot emit them
+by yourself -- they are always emitted by the corresponding
+sectioning mark. So, with
+\begin{verbatim}
+\settitlemarks*{section,subsection}
+\end{verbatim}
+and a page style containing
+\begin{verbatim}
+\firstextramarks{subsection}\subsectiontitle
+\end{verbatim}
+you retrieve the mark emitted by the first \verb|\subsection|, even
+if preceded by a \verb|\section|. (Top marks are best retrieved from
+the main \textit{markset}.)
+
+They are extra marks, and therefore language synchronization has to be
+done by hand -- add \verb|\languagename| or an intermediate command to
+the main \textit{markset} with \verb|\newtitlemark| and, if you want,
+define a command. For example:
+\begin{verbatim}
+% use an intermediate command because we'll need \foreignlanguage
+\newcommand\titlelanguage{\languagename}
+\newtitlemark{\titlelanguage}
+
+% define a command to ease defining page styles
+\newcommand{\toplang}[1]{%
+ {\topextramarks{section}%
+ \foreignlanguage{\titlelanguage}{#1}}}
+\end{verbatim}
+
+\section{A couple of examples}
+
+Because of the way marks are handled, special constructions like this are
+allowed:
+\begin{verbatim}
+\newpagestyle{main}[\small\sffamily]{
+ \sethead[\textbf{\thepage}]
+ [\textsl{\chaptertitle}]
+ [[\toptitlemarks\thesection--\bottitlemarks\thesection]
+ {\toptitlemarks\thesection--\bottitlemarks\thesection]}
+ {\textsl{\sectiontitle}}
+ {\textbf{\thepage}}}
+\end{verbatim}
+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.
+
+In this document, the following styles are used:
+\begin{verbatim}
+\widenhead{2.1pc}{0pc}
+\renewpagestyle{plain}[\small\sffamily\slshape]{
+ \footrule
+ \setfoot{}{\thepage}{}}
+\newpagestyle{myps}[\small\sffamily\slshape]{
+ \headrule
+ \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):
+\begin{verbatim}
+\widenhead*{0pt}{\marginparsep + \marginparwidth} % symmetrically
+\renewpagestyle{plain}{}
+\newpagestyle{latex}[\bfseries]{
+ \headrule
+ \sethead[\thepage][][\chaptertitle]
+ {\thesection\ \sectiontitle}{}{\thepage}}
+\pagestyle{latex}
+\end{verbatim}
+
+% \section{Remarks}
+%
+% Page styles in standard \LaTeX{} are somewhat rudimentary. For
+% example |\thispagestyle| is not always correctly synchronized with
+% sectioning marks, and if you set |\pagestyle{plain}| and then
+% |\thispagestyle{headings}|, its behaviour is not the expected one.
+% The same happens if a page style defined in \textsf{titleps} is used
+% in a |\thispagestyle| in the context of a standard page style -- you
+% have to define the main one as well.
+
+% \section{Some tips and tricks}
+%
+% star |\*|
+%
+% split heads
+%
+% bible
+
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf b/Master/texmf-dist/doc/latex/titlesec/titlesec.pdf
index 95b0ba3f955..5c8c11e2511 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 29d2a6ef517..463ae8e711e 100644
--- a/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
+++ b/Master/texmf-dist/doc/latex/titlesec/titlesec.tex
@@ -5,7 +5,7 @@
% Copyright (c) 1998-2011 by Javier Bezos.
% All Rights Reserved.
%
-% This file is part of the titlesec distribution release 2.9.2
+% This file is part of the titlesec distribution release 2.10.0
% -----------------------------------------------------------
%
% 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.9.2}
-\def\docdate{2011-11-17}
+\def\fileversion{2.10.0}
+\def\docdate{2011-12-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.9.2. \copyright{} 1998--2011 Javier Bezos.
+version 2.10.0. \copyright{} 1998--2011 Javier Bezos.
The \textsf{titletoc} package is currently at
version 1.6. The \textsf{titleps} package is currently at version
-1.0. \copyright{} 1999--2011 Javier Bezos. All Rights
+1.1.0 \copyright{} 1999--2011 Javier Bezos. All Rights
Reserved.}}
\author{Javier Bezos\footnote{For bug reports, comments and
@@ -55,7 +55,7 @@ suggestions go to \href{http://www.tex-tipografia.com/contact.html}%
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}.}}
+dotlessi, babeltools}.}}
\date{\docdate}
@@ -113,7 +113,9 @@ contents. The goal is to provide new features unavailable in current
standard \LaTeX{} but without changing the way \LaTeX{} works you may
consider using \textsf{fancyhdr}, by Piet van Oostrum, \textsf{sectsty},
by Rowland McDonnell, and \textsf{tocloft}, by Peter Wilson, which you
-can make pretty things with.
+can make pretty things with.\footnote{Since the sectioning commands
+are rewritten, their behaviour could be somewhat different
+in some cases.}
Some of the new features provided are:
\begin{itemize}
@@ -1025,370 +1027,49 @@ underlining), you can say:
However, you might prefer the package option \texttt{explicit}.
-\section{Page Styles}
+\section{\textsf{titleps} and Page Styles}
%~~~~~~~~~~~~~~~~~~~
-As a part of this package a set of commands are provided for one-step
-headline and footline settings. Those page styles has been designed to work
-with sectioning related information; you shouldn't use to create
-headers with the first an last entry of a page in a dictionary,
-for example (you could, but it is more complicated than with
-\textsf{fancyhdr}). Most of these features (but not all) are also
-available as a separate package named \texttt{titleps} -- see below
-for further details.
-
-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{%
-Two columns layout requires the
-\textsf{fix2col} package by David Carlisle.} For using them,
-set the following package option:\footnote{The
-way page styles works was reimplemented in full in release 2.3.
-However, in most of cases you won't notice it at all.}
-\begin{desc}
-|pagestyles|
-\end{desc}
-
-Once this has been done, you can define your own page styles
-and then activate them.\footnote{Page styles so defined cannot
-be used with \texttt{\string\thispagestyle} except if the surrounding
-page style has been defined with \textsf{titlesec}, too.}
-
-\subsection{Defining Page Styles}
-
-\begin{desc}
-|\newpagestyle{<name>}[<global-style>]{<commands>}|\\
-|\renewpagestyle{<name>}[<global-style>]{<commands>}|
-\end{desc}
-
-Defines a new style or redefines an existing one, named |<name>|.
-For convenience, end of lines are ignored, and you need not ``hide''
-them with |%|.\footnote{Even if marks should be reserved to
-pass information to headers, some classes, like AMS ones, introduce additional
-code. When redefining the |plain| style of AMS classes, you must add the
-following line:
-|\cs{global}\cs{topskip}\cs{normaltopskip}|.}
-
-|<global-style>| is any command to be applied to both footlines and
-headlines. Fragile commands are allowed.
-
-In |<commands>| you can use
-
-\begin{desc}
-|\headrule \footrule|\\
-|\setheadrule{<length>} \setfootrule{<length>}|
-\end{desc}
-
-If you want a rule below the headline and above the footline. You may
-also set their width directly with the commands |\setheadrule| and
-|\setfootrule|. (For instance, |\setheadrule{.4pt}| which is, by the
-way, the default value.)
-
-These commands are local to a page
-style, i.e., defining them directly in the preamble will
-not work because the page style settings will override them.
-
-\begin{desc}
-|\makeheadrule \makefootrule|
-\end{desc}
-
-These commands are used by \textsf{titlesec} to typeset the rules.
-If there is no rule, both commands are empty (this value is the
-default).
-|\setheadrule{|\emph{dim}|}| just stands for
-\begin{verbatim}
-\renewcommand{\makeheadrule}{\rule[-.3\baselineskip]{\linewidth}{<dim>}}
-\end{verbatim}
-unless if \emph{dim} is 0 pt, which empties
-|\makeheadrule| (and similarly |\setfootrule|).
-
-You can access the total head/foot width with |\linewidth|
-but the box enclosing the rule is in fact dimensionless. Hence,
-you must be concerned with the rule placement only. Its
-baseline is the same as that of the head/foot. That means the
-material to be used as rule should be raised or lowered with
-|\raisebox|, the lifting argument in |\rule| or by using sensible
-coordinates in |picture|, for instance. That makes easy to
-place material above \emph{and} below. For instance,
-the following code creates a headline with a black bold line
-above and a red rule below (the \textsf{color} package is required):
-\begin{verbatim}
-\renewcommand{\makeheadrule}{%
- \makebox[0pt][l]{\rule[.7\baselineskip]{\linewidth}{0.8pt}}%
- \color[named]{Red}%
- \rule[-.3\baselineskip]{\linewidth}{0.4pt}}
-\end{verbatim}
-
-Of course, the material to be used
-as rule is not restricted to actual rules; pictures and leaders, for
-instance, are allowed, too.
-
-\begin{desc}
-|\sethead[<even-left>][<even-center>][<even-right>]|\\
-| {<odd-left>}{<odd-center>}{<odd-right>}|\\
-|\setfoot[<even-left>][<even-center>][<even-right>]|\\
-| {<odd-left>}{<odd-center>}{<odd-right>}|
-\end{desc}
-
-Set the corresponding part in heads and foots. The optional arguments
-are all or none. If no optional arguments are given the odd-page
-settings applies to both even and odd pages. A couple of starred
-variant (|\setfoot*|, |\sethead*|) reverses the order of the settings
-for even pages (obviously, with them the optional arguments are
-not allowed). In the arguments of |\sethead|/|\setfoot| and because
-of its one-step mechanism, we must distinguish between two groups of
-commands. The first one includes those saved when the marks are sent, with
-information related to sections, and includes:
-\begin{itemize}
-\item |\thechapter|, |\thesection|\dots{}
-\item |\chaptertitle|, |\sectiontitle|\dots{} which print the
-chapter,
-section\dots{} title.
-\item |\ifthechapter{<true>}{<false>}|,
- |\ifthesection{<true>}{<false>}|\dots{} which expands to |<true>|
- except if the corresponding title lacks of label or there is
- no title yet after the superior level (for example, between
- |\chapter| and a subsequent |\section|).
-\item Any other command or value ``registered'' as ``mark.'' (See below.)
-\end{itemize}
-The second group are those expanded in every page, and includes:
-\begin{itemize}
-\item |\thepage|.
-\item Any other command not included in the previous items.
-\end{itemize}
-
-\begin{desc}
-|\setmarks{<primary>}{<secondary>}|
-\end{desc}
-Sets which |\...title| commands are to be defined, and when the marks
-are updated. For example
-|\setmarks{chapter}{section}|
-means that:
-\begin{itemize}
-\item |\chaptertitle| and |\sectiontitle| are the allowed titles in
- heads,
-\item |\sectiontitle| is reset in |\chapter|,
-\item |\ifthechapter| and |\ifthesection| are valid tests, and
-\item Marks are updated in |\chapter| and |\section|.
-\end{itemize}
-By default it is
-|\setmarks{chapter}{section}| but |\setmarks{section}{subsection}| in
-\textsf{article} class. |\setmarks| may be used outside |\(re)newpagestyle|
-to set the default to be used in newly defined and redefined page styles.
-Use it before |\pagestyle|.
-
-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 sec.~\ref{s:starred}) but if you need them, you may use them
-as in:
-\begin{verbatim}
-\chapter*{My Chapter}
-\chaptermark{My Chapter}
-\end{verbatim}
-
-\subsection{Additional Settings}
-
-\begin{desc}
-|\widenhead[<even-left>][<even-right>]{<odd-left>}{<odd-right>}|\\
-|\widenhead*{<even-right>/<odd-left>}{<even-left>/<odd-right>}|
-\end{desc}
-
-Makes the head/foot lines wider. The extra width is asymmetrically
-added and hence the two [four] arguments. Like |\sethead|, the
-starred version reverses the setting for even pages---for example,
-|\widenhead*{0pt}{6pc}| is the same as
-|\widenhead[6pc][0pt]{0pt}{6pc}|.
-
-\subsection{Running heads with floats}
-
-\begin{desc}
-|psfloats| \quad (Package option.)
-\end{desc}
-
-This package option activates the commands described in this section.%
-\footnote{It redefines some internal \LaTeX{} commands and there could be
-incompatibilities with other packages modifying the same commands. That's
-the very reason these commands are loaded only optionally. As of
-version 2.6 the syntax was extended with a new argument to allow
-extra stuff in running heads/foots. This change was backward
-compatible---just preserve the old name \verb|floatps|, which
-is deprecated, if you want the pre-2.6 behaviour.}
-
-
-\begin{desc}
-|\setfloathead*{.}{.}{.}{<extra>}[<which-floats>]|\\
-|\setfloathead[.][.][.]{.}{.}{.}{<extra>}[<which-floats>]|\\
-(Similarly |\setfloatfoot|.)
-\end{desc}
-
-The arguments with a dot are similar to those of |\sethead|. The final
-argument says the head is used when there is a float of
-the specified types (default is |tp| in headers, and |bp| in footers).
-For example:
-\begin{verbatim}
-\newpagestyle{main}{%
- \sethead ... your definition
- \setfoot ... your definition
- \headrule
- \footrule
- \setfloathead{}{}{}{\setheadrule{0pt}}[p]
- \setfloatfoot{}{}{}{\setfootrule{0pt}}[p]}
-\end{verbatim}
-removes the header/footer on float pages, including the rules.
-
-\begin{desc}
-|\nextfloathead*{.}{.}{.}{<extra>}[<which-floats>]|\\
-|\nextfloathead[.][.][.]{.}{.}{.}{<extra>}[<which-floats>]|\\
-(Similarly |\nextfloatfoot|.)
-\end{desc}
-
-You may force a header (respectively footer) when a certain
-float is the first top one (respectively last bottom) with
-those commands, where the arguments with a dot are similar to
-those of |\sethead|, just before the corresponding float.
-Those commands are used by themselves, without putting them
-inside |\(re)newpagestyle|.
-
-\subsection{Marks}
-
-\begin{desc}
-|outermarks innermarks topmarks botmarks| \quad (Package options)
-\end{desc}
-
-|innermarks| is the default in \LaTeX, with bottom marks in even pages
-and first marks in odd pages. More convenient is |outermarks|, with
-top marks in even pages and bottom marks in odd pages; it is the more
-usual system in classic scientific literature and it is described in
-\textit{The \TeX{}book}, p.~259. Both of them are intended for two
-side printing; |topmarks|/|botmarks| are intended for one side
-printing with top/bot marks in every page (they can be used in two
-side printing as well).%
-\footnote{|outermarks| does not work well in conjunction with explicit
-|\string\<section>mark| commands. The top marks mechanism fails just
-after explicit page breaks.}
-
-\begin{desc}
-|\bottitlemarks \toptitlemarks \firsttitlemarks \nexttoptitlemark|\\
-|\outertitlemarks \innertitlemarks|
-\end{desc}
-
-One of the cooler features added to page styles is the possibility of
-selecting which marks are used in subsequent macros. These commands
-set which mark the values of |\thesection|, |\sectiontitle|,
-etc., will be taken from. You can use freely in your headers;\,%
-\footnote{Not exactly: top marks must not be used in the page where a
-chapter begins, except by overriding the default definition and making
-it of |top| class.} just for fun, the following header shows the
-section label from three of these marks:
-\begin{verbatim}
-\newpagestyle{funny}{
- \sethead{Top~is~\toptitlemarks\thesection}
- {First~is~\firsttitlemarks\thesection}
- {Bot~is~\bottitlemarks\thesection}}
-\end{verbatim}
-
-|\outertitlemarks| is the default value when the |outermarks| package
-option is set, |\toptitlemarks| when |topmarks| is set, and so on.
-|\innertitlemarks| is the default value in \LaTeX{} and in this
-package if none of those option is used. A further set of marks is
-provided with |\nexttoptitlemarks| which provides a bottom mark with
-the values of the top mark of the next page (straight class only); by
-picking some value from it and comparing with the corresponding value
-of the |\bottitlemarks| you may know if a section continues in the
-next page. Of course, these commands will not be used very often.
-
-\begin{desc}
-|\newtitlemark{<macro-name>}|\\
-|\newtitlemark*{<variable-name>}|
-\end{desc}
-
-Add a macro or a variable to the list of ``marks'' to be saved.
-The macro must be parameterless, and the variable should be in \TeX{}
-form (which is the same in lengths but not in counters---the latter
-take the form |\c@<counter>|).
-
-\subsection{A couple of examples}
-
-Because of the way marks are handled, special constructions like this are
-allowed:
-\begin{verbatim}
-\newpagestyle{main}[\small\sffamily]{
- \sethead [\textbf{\thepage}]
- [\textsl{\chaptertitle}]
- [[\toptitlemarks\thesection--\bottitlemarks\thesection]
- {\toptitlemarks\thesection--\bottitlemarks\thesection]}
- {\textsl{\sectiontitle}}
- {\textbf{\thepage}}}
-\end{verbatim}
-As you can see, the range of sections in a page |\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, but it gives
-a hint of how to get stunning headers.
-
-In this document, the following styles are used:
-\begin{verbatim}
-\widenhead{2.1pc}{0pc}
-\renewpagestyle{plain}[\small\sffamily\slshape]{
- \footrule
- \setfoot{}{\thepage}{}}
-\newpagestyle{myps}[\small\sffamily\slshape]{
- \headrule
- \sethead{Titlesec}{\sectiontitle}{\thepage}}
-\end{verbatim}
-
-The following definitions provide page styles similar to
-those of Lamport's \LaTeX\ book (with the \textsf{calc}
-package):
-\begin{verbatim}
-\widenhead*{0pt}{\marginparsep + \marginparwidth} % symmetrically
-\renewpagestyle{plain}{}
-\newpagestyle{latex}[\bfseries]{
- \headrule
- \sethead[\thepage][][\chaptertitle]
- {\thesection\ \sectiontitle}{}{\thepage}}
-\pagestyle{latex}
+The \textsf{titleps} package provides tools for one-stage setting of
+page styles (headlines and footlines). A higher-level interface is
+used, where the mark mechanism is hidden and there is no need to deal
+with |\leftmark|s and |\rightmark|s -- just use a command or variable
+registered as a ``mark'' as the expected value will be returned, i.e.,
+those when the mark was emitted, either by a sectioning command or
+explicitly with |\chaptermark|, |\sectionmark|, etc. A simple
+example, whose meaning should be obvious, is:
+\begin{verbatim}
+\newpagestyle{main}{
+ \sethead[\thepage][\chaptertitle][(\thesection] % even
+ {\thesection)}{\sectiontitle}{\thepage}} % odd
+\pagestyle{main}
\end{verbatim}
-\subsection{\textsf{titleps}}
-
-With this package you have access to most of the features described in
-this section without having to load \textsf{titlesec}. The following
-are not supported:
+Other features are:
\begin{itemize}
-\item top marks, and related options -- only first and bottom marks
-are allowed;
-\item |\ifthechapter|, |\ifthesection|, |\ifthesubsection|, etc.;
-\item being a new package, the deprecated option |floatps| is not
-available, but only |psfloats|.
+\item Working top marks, compatible with floats (unlike the standard
+|\topmark|, which does not work correctly in \LaTeX{}).
+\item Access to top, first and bot marks in a single headline/footline
+(e.g., the first and last section numbers).
+\item Marks for more than 2 sectioning levels.
+\item Simple (and not so simple) headrules and footrules.
+\item Headlines and footlines for pages with floats.
+\item Headlines and footlines for specific floats (a sort of
+|\thispagestyle| for floats).
+\item Multiple sets of marks (named here \emph{markset}s and
+\textit{extra marks}).
\end{itemize}
-
-\section{Final comments}
-%~~~~~~~~~~~~~~~~~~~~~
-
-\begin{itemize}
-
-\item Only a |\footnote| command is allowed in titles, but it
-will work. However, the footnote mark is not removed from
-toc entries or running headings; for that use
+It can be used without \textsf{titlesec}, but you will get most of
+it when used together. To load it as a separate package, use the
+customary \verb|\usepackage{titleps}|, but with \textsf{titlesec} you
+have to load it with:
\begin{verbatim}
-\usepackage[stable]{footmisc}
+\usepackage[pagestyles]{titlesec}
\end{verbatim}
-\item The page styles have been reimplemented in full in version 2.3.
-Most of previous definition will work with the current code, even if
-many things have changed. In particular, headers using just |\the...|
-and |\...title| commands, besides |\usepage| and formatting commands
-still work. Now, pagestyles should be loaded explicitly with the
-|pagestyles| option, but if it is not given and the three basic
-commands are used, the page styles macros are loaded with a warning.
-The new code overcomes the limitations of previous releases, fixes
-some bugs (the incompatibility between top marks and floats, for
-example), and adds new features.
-\end{itemize}
+Please, read |titleps.pdf| (or typeset |titleps.tex|) for further
+information.
\section{Contents: The \textsf{titletoc} package}
% ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~