summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2007-12-25 09:56:00 +0000
committerNorbert Preining <preining@logic.at>2007-12-25 09:56:00 +0000
commit49de519af20c652c3b3cfe9ba1dd4df1de06bde8 (patch)
treee97133a8a2f4e7b1924d35a76d87837d23d918c9
parent9d2ebf24951017e4a930651f26e118128d9003a1 (diff)
caption update 07-12-25
git-svn-id: svn://tug.org/texlive/trunk@5898 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/caption/README27
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption-deu.pdfbin319741 -> 301230 bytes
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption-deu.tex107
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption-eng.pdfbin333306 -> 366539 bytes
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption-eng.tex1755
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption.pdfbin356408 -> 347050 bytes
-rw-r--r--Master/texmf-dist/doc/latex/caption/caption2.pdfbin139207 -> 136128 bytes
-rw-r--r--Master/texmf-dist/doc/latex/caption/ltcaption.pdfbin121528 -> 116692 bytes
-rw-r--r--Master/texmf-dist/doc/latex/caption/subcaption.pdfbin0 -> 133171 bytes
-rw-r--r--Master/texmf-dist/source/latex/caption/caption.dtx1005
-rw-r--r--Master/texmf-dist/source/latex/caption/caption.ins9
-rw-r--r--Master/texmf-dist/source/latex/caption/caption2.dtx50
-rw-r--r--Master/texmf-dist/source/latex/caption/ltcaption.dtx14
-rw-r--r--Master/texmf-dist/source/latex/caption/subcaption.dtx868
-rw-r--r--Master/texmf-dist/tex/latex/caption/caption.sty281
-rw-r--r--Master/texmf-dist/tex/latex/caption/caption2.sty18
-rw-r--r--Master/texmf-dist/tex/latex/caption/caption3.sty325
-rw-r--r--Master/texmf-dist/tex/latex/caption/ltcaption.sty6
-rw-r--r--Master/texmf-dist/tex/latex/caption/subcaption.sty104
19 files changed, 3552 insertions, 1017 deletions
diff --git a/Master/texmf-dist/doc/latex/caption/README b/Master/texmf-dist/doc/latex/caption/README
index c325886fd90..a2d9db5b84e 100644
--- a/Master/texmf-dist/doc/latex/caption/README
+++ b/Master/texmf-dist/doc/latex/caption/README
@@ -1,4 +1,6 @@
-The caption package bundle
+==========================================================================
+
+The `caption' package bundle
Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de)
License: LPPL = LaTeX Project Public Licence
@@ -6,34 +8,43 @@ Maintenance Status: maintained (by Axel Sommerfeldt)
If you need help for installation please visit:
http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages
+http://www.tex.ac.uk/cgi-bin/texfaq2html?label=miktexinst
+http://www.tex.ac.uk/cgi-bin/texfaq2html?label=privinst
--------------------------------------------------------------------------
-The caption package v3.1 offers customization of captions in floating
-environments such figure and table and cooperates with the packages
+The `caption' package v3.1 offers customization of captions in floating
+environments such `figure' and `table' and cooperates with the packages
float, floatflt, fltpage, hyperref, hypcap, listings, longtable,
picinpar, picins, rotating, sidecap, subfigure, supertabular,
threeparttable, and wrapfig.
Furthermore the `floatrow' and the `subfig' package supports the
-caption package and use its \captionsetup interface.
+`caption' package and use its \captionsetup interface.
User Manual: caption-eng.pdf (English)
- caption-rus.pdf (Russian)
+ caption-rus.pdf (Russian, outdated)
caption-deu.pdf (German)
--------------------------------------------------------------------------
-The ltcaption package v1.1 fixes caption problems with other-than-centered
-aligned longtables. (solving LaTeX PR `tools/3387')
+The `ltcaption' package v1.1 fixes caption problems with
+other-than-centered aligned longtables. (solving LaTeX PR `tools/3387')
A bonus feature is the addition of the environment longtable* which does
not increment the table counter.
-This package will be loaded by the caption package v3.1 automatically,
+This package will be loaded by the `caption' package v3.1 automatically,
but can be used without the caption package, too.
User Manual: ltcaption.pdf (English)
--------------------------------------------------------------------------
+
+The `subcaption' package v0.3 is a tiny experimental package to
+demonstrate the sub-caption feature of the `caption' package.
+
+User Manual: subcaption.pdf (English)
+
+==========================================================================
diff --git a/Master/texmf-dist/doc/latex/caption/caption-deu.pdf b/Master/texmf-dist/doc/latex/caption/caption-deu.pdf
index 9a48e17cebe..9c1f186b09e 100644
--- a/Master/texmf-dist/doc/latex/caption/caption-deu.pdf
+++ b/Master/texmf-dist/doc/latex/caption/caption-deu.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/caption/caption-deu.tex b/Master/texmf-dist/doc/latex/caption/caption-deu.tex
index 3fdede6fb56..a4cd8cedece 100644
--- a/Master/texmf-dist/doc/latex/caption/caption-deu.tex
+++ b/Master/texmf-dist/doc/latex/caption/caption-deu.tex
@@ -18,9 +18,9 @@
% This Current Maintainer of this work is Axel Sommerfeldt.
%
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-% caption-eng.tex, and caption-rus.tex.
+% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesFile{caption-deu.tex}[2007/10/02 v3.1c Das caption-Paket]
@@ -45,8 +45,9 @@
{\usepackage[latin1]{inputenc}}
\usepackage{longtable,setspace}
-\usepackage{hypdoc}\hypersetup{german}
-\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartview={}}
+\usepackage{hypdoc}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{german,pdfkeywords={LaTeX, package, caption},pdfstartpage={},pdfstartview={}}
\usepackage[listof=0,hypcap=false]{caption}[2007/09/01]
\DeclareRobustCommand*\eTeX{\texorpdfstring
@@ -196,11 +197,11 @@ Gestaltungsmerkmale einfließen lassen.
\clearpage
\section*{Vorläufige Dokumentation}
-Diese Anleitung ist leider teilweise inkonsistent und insbesondere noch nicht
-fertiggestellt.
+Diese Anleitung ist (im Gegensatz zur englischensprachigen Anleitung) leider
+noch an einigen Stellen inkonsistent und insbesondere noch nicht fertiggestellt.
Ich werde mich bemühen, sie in den nächsten Monaten zu vervollständigen;
die aktuelle Interimsversion kann immer
-\href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf}%
+\href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/caption/caption-deu.pdf}%
{hier} bezogen werden.\par\bigskip
% --------------------------------------------------------------------------- %
@@ -1631,7 +1632,7 @@ den Anker bei der Beschriftung.
hingegen plaziert den Anker an den Anfang der |minipage|.
\item{\cs{caption}\csoarg{}\csmarg\ldots\ vs.
- \cs{captionsetup}\csmarg{listof=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
+ \cs{captionsetup}\csmarg{list=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
Wiederum bekommen Sie ohne geladenes \package{hyperref}"=Paket identische Resultate.
Aber mit \package{hyperref} geladen liegen die Unterschiede in den Feinheiten.
So wird z.B.~das optionale Argument von \cs{caption} auch in die |aux|-Datei
@@ -1639,7 +1640,7 @@ geschrieben und vom \cs{nameref} Befehl verwendet.
Wenn Sie also \cs{caption} mit leerem Argument angeben, wird ein auf diese
Abbildung oder Tabelle angewandtes \cs{nameref} nicht das erwünschte,
nämlich ein leeres Resultat zur Folge haben.
-Daher ist es besser \cs{captionsetup}\csmarg{listof=false} zu verwenden,
+Daher ist es besser \cs{captionsetup}\csmarg{list=false} zu verwenden,
wenn Sie keinen Eintrag in dem Abbildungs- oder Tabellenverzeichnis wünschen.
\end{description}
@@ -2150,7 +2151,6 @@ Befehl & & Abschnitt \\
|\belowcaptionskip| & & \ref{skips} \\
|\caption| & & \ref{commands} \\
|\caption*| & & \ref{commands} \\
-|\captionbox| & & \ref{x} \\
|\captionof| & & \ref{commands} \\
|\captionof*| & & \ref{commands} \\
|\captionsetup| & & \ref{commands} \\
@@ -2167,11 +2167,12 @@ Befehl & & Abschnitt \\
|\DeclareCaptionLabelFormat| & & \ref{declare} \\
|\DeclareCaptionLabelSeparator| & & \ref{declare} \\
|\DeclareCaptionLabelSeparator*| & & \ref{declare} \\
-|\DeclareCaptionListOfFormat| & & \ref{declare} \\
+|\DeclareCaptionListFormat| & & \ref{declare} \\
|\DeclareCaptionOption| & & \ref{declare} \\
|\DeclareCaptionStyle| & & \ref{declare} \\
+|\DeclareCaptionSubType| & & \ref{DeclareCaptionType} \\
|\DeclareCaptionTextFormat| & & \ref{declare} \\
-|\DeclareFloatingEnvironment| & & \ref{DeclareFloatingEnvironment} \\
+|\DeclareCaptionType| & & \ref{DeclareCaptionType} \\
|\showcaptionsetup| & & \ref{commands} \\
\end{longtable}
@@ -2187,7 +2188,7 @@ Option & Kurzbeschreibung & Abschnitt \\
|belowskip| & setzt den Abstand unter der Beschriftung & \ref{skips} \\
|compatibility|\preambleoption & erzwingt (Nicht-)Kompatibilität & \ref{classes} \\
%|config| & & \ref{x} \\
-|figurename|\preambleoption & setzt den Abbildungsnamen & \ref{x} \\
+|figurename| & setzt den Abbildungsnamen & \ref{x} \\
|figureposition|\preambleoption & gibt einen Hinweis auf die Position & \ref{skips} \\
|font| & wählt den Zeichensatz & \ref{fonts} \\
|format| & wählt das Format & \ref{formats} \\
@@ -2202,12 +2203,13 @@ Option & Kurzbeschreibung & Abschnitt \\
|labelformat| & wählt das Format des Bezeichners & \ref{formats} \\
|labelsep| & wählt den Trenner zw. Bezeichner$+$Text & \ref{formats} \\
|labelseparator| & wählt den Trenner zw. Bezeichner$+$Text & \ref{formats} \\
-|listof| & schaltet die Listeneinträge an bzw. aus & \ref{listof} \\
-|listofformat| & wählt das Listenformat & \ref{listof} \\
+|list| & schaltet die Listeneinträge an bzw. aus & \ref{list} \\
+|listformat| & wählt das Listenformat & \ref{list} \\
|margin| & setzt den Rand bzw. die Ränder & \ref{margins} \\
|margin*| & setzt den Rand, sofern keine Breite gesetzt ist & \ref{margins} \\
|maxmargin| & setzt den max. zu verwendenen Rand & \ref{margins} \\
|minmargin| & setzt den min. zu verwendenen Rand & \ref{margins} \\
+|oneside| & wählt den einseitigen Modus & \ref{x} \\
|options| & führt die angegebene Optionsliste aus & \ref{x} \\
|parindent| & setzt den Absatzeinzug & \ref{margins} \\
|parskip| & setzt den Absatzabstand & \ref{margins} \\
@@ -2217,7 +2219,7 @@ Option & Kurzbeschreibung & Abschnitt \\
|skip| & setzt den Abstand zwischen Inhalt \& Beschriftung & \ref{skips} \\
|strut| & schaltet die Verwendung von |\strut| ein bzw. aus & \ref{formats} \\
|style| & wählt einen kompletten Stil aus & \ref{style} \\
-|tablename|\preambleoption & setzt den Tabellennamen & \ref{x} \\
+|tablename| & setzt den Tabellennamen & \ref{x} \\
|tableposition|\preambleoption & gibt einen Hinweis auf die Position & \ref{skips} \\
|textfont| & wählt den Zeichensatz des Textes & \ref{fonts} \\
|textformat| & wählt das Format des Textes & \ref{formats} \\
@@ -2240,17 +2242,27 @@ Option & Kurzbeschreibung & Abschnitt \\
\begin{Warnings}
\Message
+ |\caption outside box or environment.|
+\Or
+ |\captionsetup{type=...} outside box or environment.|
+\Or
+ |\captionsetup{type*=...} or \captionof outside box or environment.|
+\Description
+ |\caption|, |\captionof| sowie |\captionsetup{|\xx|type=|\xx\meta{type}|}|
+ sind nur für die Anwendung innerhalb einer Box, Gruppe oder Umgebung konzipiert.
+ \par\See{\Ref{commands}}
+
+\Message
|\caption will not be redefined since it's already|\\
|redefined by a document class or package which is|\\
- |unknown to the caption package.|\\
- |As a result some features will not work as expected.|
+ |unknown to the caption package.|
\Description
Wenn \thispackage\ eine vorhandene (und unbekannte) Erweiterung des Befehls
|\caption| erkannt hat, definiert es |\caption| nicht erneut um, da dies
unweigerlich den Verlust der ursprünglichen Erweiterung zur Folge hätte.
Daher funktionieren manche Features, wie |\caption*|,
|\ContinuedFloat|, das optionale Argument von |\captionsetup|,
- sowie die Optionen |listof=| und |hypcap=| nicht mehr; sie werden
+ sowie die Optionen |list=| und |hypcap=| nicht mehr; sie werden
entweder ignoriert oder arbeiten nicht erwartungsgemäß.\par
Wenn Sie an der ursprünglichen Erweiterung nicht interessiert sind
und stattdessen den vollen Umfang des \package{caption}"=Paketes
@@ -2260,21 +2272,9 @@ Option & Kurzbeschreibung & Abschnitt \\
\par\See{\Ref{classes}}
\Message
- |Caption type was already set to `|\meta{type}|'.|
-\Description
- Diese Warnung informiert Sie über vermische \package{caption}"=Optionen.
- Wenn Sie z.B.~ein |\captionof|\xx|{table}|\xx|{|\ldots|}| in einer |figure|
- Umgebung verwenden, werden beide Optionensätze, sowohl derjenige für |figure|
- (mittels |\captionsetup|\xx|[figure]|\xx|{|\ldots|}| angegeben) als auch
- derjenige für |table| (mittels |\captionsetup|\xx|[table]|\xx|{|\ldots|}|
- angegeben), angewandt.
- \par\See{\Ref{commands}}
-
-\Message
|Forced redefinition of \caption since the|\\
|unsupported(!) package option `compatibility=false'|\\
- |was given. Please fasten your seat belts, as we may|\\
- |experience turbulence!|
+ |was given.|
\Description
Da Sie so mutig waren, die Option |compatibility=false| zu probieren,
wird \thispackage\ sein bestes geben, um diesen Wunsch zu erfüllen.
@@ -2395,6 +2395,17 @@ Option & Kurzbeschreibung & Abschnitt \\
\par\See{\Ref{margins}}
\Message
+ |The caption type was already set to `|\meta{type}|'.|
+\Description
+ Diese Warnung informiert Sie über vermische \package{caption}"=Optionen.
+ Wenn Sie z.B.~ein |\captionof|\xx|{table}|\xx|{|\ldots|}| in einer |figure|
+ Umgebung verwenden, werden beide Optionensätze, sowohl derjenige für |figure|
+ (mittels |\captionsetup|\xx|[figure]|\xx|{|\ldots|}| angegeben) als auch
+ derjenige für |table| (mittels |\captionsetup|\xx|[table]|\xx|{|\ldots|}|
+ angegeben), angewandt.
+ \par\See{\Ref{commands}}
+
+\Message
|The option `hypcap=true' will be ignored for this|\\
|particular \caption.|
\Description
@@ -2420,7 +2431,7 @@ Option & Kurzbeschreibung & Abschnitt \\
\Message
|Unsupported document class (or package) detected,|\\
- |usage of the caption package is *not* recommended.|
+ |usage of the caption package is not recommended.|
\Description
Entweder ist die verwendete Dokumentenklasse dem \package{caption}"=Paket
unbekannt, oder aber Sie haben ein Paket in Ihrem Dokument eingebunden,
@@ -2448,7 +2459,7 @@ Option & Kurzbeschreibung & Abschnitt \\
\Message
|Usage of the |\meta{package}| package together with the|\\
- |caption package is strongly *not* recommended.|\\
+ |caption package is strongly not recommended.|\\
|Instead of loading the |\meta{package}| package you should|\\
|use the caption package option `tableposition=top'.|
\Description
@@ -2475,7 +2486,7 @@ Option & Kurzbeschreibung & Abschnitt \\
als optionales Argument bei |\caption| bzw. |\captionof| mit angegeben
werden muß, auch wenn Ihr Dokument gar kein Abbildungs- oder
Tabellenverzeichnis beeinhaltet.
- \par\See{\Ref{commands}, \Ref{listof} und \Ref{hyperref}\,}
+ \par\See{\Ref{commands}, \Ref{list} und \Ref{hyperref}\,}
\Message
|\caption outside float.|
@@ -2489,17 +2500,6 @@ Option & Kurzbeschreibung & Abschnitt \\
\par\See{\Ref{commands}}
\Message
- |\caption outside box or environment.|
-\Or
- |\captionsetup{type=...} outside box or environment.|
-\Or
- |\captionsetup{type*=...} or \captionof outside box or environment.|
-\Description
- |\caption|, |\captionof| sowie |\captionsetup{|\xx|type=|\xx\meta{type}|}|
- sind nur für die Anwendung innerhalb einer Box, Gruppe oder Umgebung konzipiert.
- \par\See{\Ref{commands}}
-
-\Message
|\ContinuedFloat outside float.|
\Description
|\ContinuedFloat| ist nur für die Anwendung innerhalb einer gleitenden
@@ -2558,6 +2558,11 @@ Option & Kurzbeschreibung & Abschnitt \\
einen Fehlerbericht per E-Mail.
\Message
+ |No float type '|\meta{Typ}|' defined.|
+\Description
+ \TODO
+
+\Message
|Not allowed in longtable* environment.|
\Description
Der Befehl |\caption| ist nicht immerhalb einer |longtable*| Umgebung
@@ -2602,7 +2607,7 @@ Option & Kurzbeschreibung & Abschnitt \\
Argument bei |\caption| bzw. |\captionof| mit angegeben werden muß,
auch wenn Ihr Dokument gar kein Abbildungs- oder Tabellenverzeichnis
beeinhaltet.
- \par\See{\Ref{commands}, \Ref{listof} und \Ref{hyperref}\,}
+ \par\See{\Ref{commands}, \Ref{list} und \Ref{hyperref}\,}
\iffalse % was removed in v3.1b
\Message
@@ -2685,11 +2690,11 @@ Option & Kurzbeschreibung & Abschnitt \\
\par\See{\Ref{formats}}
\Message
- |Undefined list-of format `|\meta{name}|'.|
+ |Undefined list format `|\meta{name}|'.|
\Description
Es wurde versucht, ein Listenformat auszuwählen, welches nicht
definiert ist. Vielleicht ein Schreibfehler!?
- \par\See{\Ref{listof}}
+ \par\See{\Ref{list}}
\Message
|Undefined position `|\meta{name}|'.|
@@ -2882,7 +2887,7 @@ f"ur ihre Hilfe beim stetigen Verbessern dieses Paketes bedanken.
\href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.pdf}%
{\emph{Hypertext marks in \LaTeX}},\\
- June 14, 2007
+ November 12, 2007
\bibitem{hypcap}
Heiko Oberdiek:\\
diff --git a/Master/texmf-dist/doc/latex/caption/caption-eng.pdf b/Master/texmf-dist/doc/latex/caption/caption-eng.pdf
index f15a0c73908..a832f54c6e8 100644
--- a/Master/texmf-dist/doc/latex/caption/caption-eng.pdf
+++ b/Master/texmf-dist/doc/latex/caption/caption-eng.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/caption/caption-eng.tex b/Master/texmf-dist/doc/latex/caption/caption-eng.tex
index e17786049cf..b19056d6b16 100644
--- a/Master/texmf-dist/doc/latex/caption/caption-eng.tex
+++ b/Master/texmf-dist/doc/latex/caption/caption-eng.tex
@@ -18,18 +18,19 @@
% This Current Maintainer of this work is Axel Sommerfeldt.
%
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-% caption-eng.tex, and caption-rus.tex.
+% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesFile{caption-eng.tex}[2007/11/04 v3.1e The caption package]
+\ProvidesFile{caption-eng.tex}[2007/12/23 v3.1f The caption package]
\hbadness=9999 \newcount\hbadness \hfuzz=20pt % Make TeX shut up.
%\errorcontextlines=3
\documentclass{ltxdoc}
\setlength\parindent{0pt}
\setlength\parskip{\smallskipamount}
+\setlength\leftmargini{2em}% default = 2.5em
\usepackage{ifpdf}
\ifpdf
@@ -40,9 +41,16 @@
\usepackage[USenglish]{babel}
\usepackage{longtable,setspace}
+\IfFileExists{cat.eps}%
+ {\usepackage{graphicx}}%
+ {\IfFileExists{test/tlc2/cat.eps}%
+ {\usepackage{graphicx}\graphicspath{{test/tlc2/}}}%
+ {\usepackage[demo]{graphicx}}}
\usepackage{hypdoc}
-\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartview={}}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartpage={},pdfstartview={}}
+\hypersetup{breaklinks=true}
\usepackage[listof=0,hypcap=false]{caption}[2007/09/01]
\DeclareRobustCommand*\eTeX{\texorpdfstring
@@ -57,30 +65,43 @@
\DeclareRobustCommand*\NTG{NTG}
\DeclareRobustCommand*\SmF{SMF}
-\newcommand\NEW[2]{\hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft#1\\#2}}
+\newcommand\NEW[2]{}%\hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft#1\\#2}}
\usepackage{marvosym}
\makeatletter
\newcommand*\INFO{\@ifstar{\@INFO{}}{\@INFO{\vbox to \ht\strutbox}}}
-\newcommand*\@INFO[1]{\MARGINSYM{#1{\Huge\Info}}}
+\newcommand*\@INFO[1]{\MARGINSYM{#1{\LARGE\Info}}}
\makeatother
\font\manual=manfnt
\newcommand*\DANGER{\MARGINSYM{\manual\char127}}
\newcommand*\MARGINSYM[1]{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{#1}}}}
+% \ContinuedFloat
+\DeclareCaptionLabelFormat{continued}{Continued #1~#2}
+% \DeclareCaptionLabelFormat
+\DeclareCaptionLabelFormat{bf-parens}{(\textbf{#2})}
+% \DeclareCaptionStyle
+\DeclareCaptionStyle{mystyle}[margin=5mm,justification=centering]%
+ {font=footnotesize,labelfont=sc,margin={10mm,0mm}}
+% Example 1
\DeclareCaptionFormat{myformat1}{#1#2\\#3}
\newlength\myindention
\DeclareCaptionFormat{myformat2}{#1#2\\\hspace*\myindention#3}
\DeclareCaptionOption{myindention}{\setlength\myindention{#1}}
+% Example 2
\DeclareCaptionFormat{reverse}{#3#2#1}
-\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}
\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{~}#2)}
\DeclareCaptionLabelSeparator{fill}{\hfill}
+% Example 3
+\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}
+\DeclareCaptionFormat{llapx}{\llap{\makebox[5em][l]{#1}}#3\par}
+% Example 4
+\DeclareCaptionLabelFormat{andtable}{#1~#2 \& \tablename~\thetable}
\newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}}
\newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}}
\newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}}
-\let\package\puresf
+\let\class\puresf \let\package\puresf
\let\env\purett \let\opt\purett
\newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}}
@@ -100,7 +121,10 @@
\newenvironment{Example}%
{\ifvmode\else\unskip\par\fi
\minipage{\linewidth}\smallskip}%
- {\smallskip\endminipage}
+ {\smallskip\endminipage\par}
+
+\newenvironment{Expert}%
+ {\footnotesize\ignorespaces}{\par}
\makeatletter
\newcommand\example{\@ifstar
@@ -129,18 +153,16 @@
\newcommand*\Ref{\@ifstar{\@Ref\ref}{\@Ref\autoref}}
\newcommand*\@Ref[2]{#1{#2}: \textit{\nameref{#2}}}
\makeatother
-\newcommand*\See[1]{\nopagebreak{\small (See #1)}}
+\newcommand*\See[1]{\nopagebreak{\small(See #1)}}
\newcommand*\SeeUserDefined[1][]{\See{\Ref{declare}#1}}
-%\def\TODO{\emph{-- Some information is missing here --}}
-
% --------------------------------------------------------------------------- %
\GetFileInfo{caption-eng.tex}
\let\docdate\filedate
\GetFileInfo{caption.sty}
-\title{Typesetting captions with the caption package\texorpdfstring{\thanks{%
+\title{Customizing captions in floating environments\texorpdfstring{\thanks{%
This package has version number \fileversion,
last revised \filedate.}}{}}
\author{Axel Sommerfeldt\\
@@ -153,9 +175,7 @@
\begin{abstract}
\Thispackage\ offers customization of captions
in floating environments such |figure| and |table| and cooperates with
-many other packages.\footnote{A complete re-work of the user interface
-done with Steven D. Cochran and Frank Mittelbach has lead to
-the enhanced version $3.0$.}
+many other packages.
\end{abstract}
\newcommand\exampletext{%
@@ -168,14 +188,14 @@ the enhanced version $3.0$.}
\section*{Introduction}
-Within the standard \LaTeX\ classes captions haven't received the attention
-they deserve. Simply typeset as an ordinary paragraph there is no
+Within the standard \LaTeX\ document classes captions haven't received the
+attention they deserve. Simply typeset as an ordinary paragraph there is no
remarkable visual difference from the rest of the text, like here:
\example*{size=normalsize,margin=0pt}{\exampletext}
There should be possibilities to change this; for example, it would be nice
-if you could make the text of the caption a little bit smaller as the normal
+to make the text of the caption a little bit smaller as the normal
text, add an extra margin, typeset the caption label with the same font
family and shape as your headings etc. Just like this one:
@@ -184,23 +204,30 @@ family and shape as your headings etc. Just like this one:
You can do this easily with this package as there are many ready-to-use
caption formatting options, but you are free to define your very own stuff, too.
-% --------------------------------------------------------------------------- %
+\bigskip
-\section*{PRELIMINARY DOCUMENTATION}%Preliminary documentation}
+\INFO
+Please note that \thispackage\ is only controlling the look \& feel of the
+captions. It does \emph{not} control the placement of the captions.
+% --------------------------------------------------------------------------- %
+
+\iffalse
+\section*{PRELIMINARY DOCUMENTATION}
Please note that this document is inconsistent and not finished yet.
It'll try to update it within the next months; the actual version can always be found
\href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf}%
{here}.\par\bigskip
+\fi
% --------------------------------------------------------------------------- %
-\clearpage
+\vfill\clearpage
\tableofcontents
% --------------------------------------------------------------------------- %
-\clearpage
+\vfill\clearpage
\section{Using this package}
\label{usage}
@@ -210,7 +237,7 @@ Insert
|\usepackage|\oarg{options}|{caption}[|\texttt{\filedate}|]|
\end{quote}
into the preamble of your document, i.e.~the part of your document
-between |\documentclass| and |\begin{document}|.
+between |\document|\x|class| and |\begin{doc|\x|u|\x|ment}|.
The options control how your captions will look like; e.g.,
\begin{quote}
|\usepackage[margin=10pt,font=small,labelfont=bf,|\\
@@ -222,7 +249,7 @@ would result in captions looking like the second one in the introduction.
\DescribeMacro{\captionsetup}
For a later change of options \thispackage\ provides the command
\begin{quote}
- |\captionsetup|\oarg{float type}\marg{options}
+ |\captionsetup|\oarg{float type}\marg{options}\quad.
\end{quote}
So
\begin{quote}
@@ -247,15 +274,16 @@ For example
| \caption{|\ldots|}|\\
|\end{figure}|
\end{quote}
-switches the single-line-check off, but only for this |figure| so all
-the other captions remain untouched.
+switches the single-line-check off, but only for this |figure|,
+so all the other captions remain untouched.
+
+\smallskip
-(For a description of the optional parameter \meta{float type} see
- \Ref{commands}.)
+{\small(For a detailed description of |\captionsetup| see \Ref{captionsetup}.)}
% --------------------------------------------------------------------------- %
-\pagebreak[4]
+\vfill\clearpage
\section{Options}
\label{options}
@@ -277,7 +305,7 @@ from the label.
The \textit{caption format} determines how this information will be presented;
it is specified with the option
\begin{quote}
- |format=|\meta{format name}\quad ,
+ |format=|\meta{format name}\quad,
\end{quote}
having the name of the caption format as its argument.
@@ -294,7 +322,7 @@ There are two standard caption formats:
Indents the caption text, so it will `hang' under the first line of the text.
\item[\UserDefined]
- Own formats can be defined using |\DeclareCaptionFormat|.\\
+ Own formats can be defined using |\Declare|\x|Caption|\x|Format|.\\
\SeeUserDefined
\end{Options}
@@ -307,12 +335,13 @@ There are two standard caption formats:
\example{format=hang}{\exampletext}
\end{Example}
+\pagebreak[3]
\DescribeMacro{indention=}
For both formats (\texttt{plain} and \texttt{hang}) you can setup an extra
indention starting at the second line of the caption. You do this with the
option
\begin{quote}
- |indention=|\meta{amount}.
+ |indention=|\meta{amount}\quad.
\end{quote}
Two examples:
@@ -321,7 +350,7 @@ Two examples:
\begin{quote}
|format=plain,indention=.5cm|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{format=plain,indention=.5cm}{\exampletext}
\end{Example}
@@ -329,10 +358,12 @@ Two examples:
\begin{quote}
|format=hang,indention=-0.5cm|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{format=hang,indention=-0.5cm}{\exampletext}
\end{Example}
+\bigskip
+
\pagebreak[3]
\DescribeMacro{labelformat=}
With the option
@@ -343,7 +374,7 @@ With the option
\nopagebreak[3]
%\NEWdescription{v3.0e}
you specify how the caption label will be typeset.
-There are four standard caption label formats:
+There are five standard caption label formats:
\begin{Options}{\OptionLabel}
\item[default]
@@ -352,29 +383,44 @@ There are four standard caption label formats:
(This is the default behaviour.)
\item[empty]
- The caption label will be empty. (This option makes sense when used
- together with other options like \texttt{labelsep=none}.)
+ The caption label will be empty.
+\iffalse
+ (This option makes sense when used together with other options like
+ \texttt{labelsep=none}.)
+\fi
\item[simple]
The caption label will be typeset as a name and a number.
+ \item[brace]\NEWfeature{v3.1f}
+ The caption label will be closed with a single (right) brace.
+
\item[parens]
The number of the caption label will be typeset in parentheses.
\item[\UserDefined]
- Own label formats can be defined using |\DeclareCaptionLabelFormat|.\\
+ Own label formats can be defined using |\Declare|\x|Caption|\x|Label|\x|Format|.
\SeeUserDefined
\end{Options}
\begin{Example}
An example: Using the options
\begin{quote}
- |labelformat=parens,labelsep=quad|
+ |format=plain,labelformat=parens,labelsep=quad|
\end{quote}
gives captions like this one:
- \example{labelformat=parens,labelsep=quad}{\exampletext}
+ \example{format=plain,labelformat=parens,labelsep=quad}{\exampletext}
\end{Example}
+\medskip
+
+\emph{Note:} Some environments, e.g.~the \env{algorithm} environment offered
+by the \package{algorithm2e} package, might react allergic to a change of the
+caption label format.
+
+\bigskip
+
+\pagebreak[3]
\DescribeMacro{labelsep=}
With the option
\begin{quote}
@@ -385,8 +431,11 @@ You can choose one of the following:
\begin{Options}{\OptionLabel}
\item[none]
- There is no caption separator. (This option makes sense when used
- together with other options like \texttt{labelformat=empty}.)
+ There is no caption separator.
+\iffalse
+ (This option makes sense when used together with other options like
+ \texttt{labelformat=empty}.)
+\fi
\item[colon]
The caption label and text will be separated by a colon and a space.
@@ -402,43 +451,74 @@ You can choose one of the following:
\item[newline]
The caption label and text will be separated by a line break (|\\|).
+ Please note that this separator does not work with all caption
+ formats (e.g.~|format=|\xx|hang|), and you'll get an error message
+ trying such combination of options.
- \item[endash]%\NEWfeature{v3.0h}
+ \item[endash]\NEWfeature{v3.0h}
The caption label and text will be separated by an en-dash,
- surrounded by spaces (| -- |).
+ surrounded by spaces (\verb*| -- |).
+%\showhyphens{separator}
\item[\UserDefined]
- Own separators can be defined using |\DeclareCaptionLabelSeparator|.\\
+ Own separators can be defined using |\Declare|\x|Caption|\x|Label|\x|Sep|\x|a|\x|ra|\x|tor|.
\SeeUserDefined
\end{Options}
Three examples:
\begin{Example}
\begin{quote}
- |labelsep=period|
+ |format=plain,labelsep=period|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example{labelsep=period}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example{format=plain,labelsep=period}{\exampletext}
\end{Example}
\begin{Example}
\begin{quote}
- |labelsep=newline,singlelinecheck=false|
+ |format=plain,labelsep=newline,singlelinecheck=false|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example{labelsep=newline,singlelinecheck=false}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example{format=plain,labelsep=newline,singlelinecheck=false}{\exampletext}
\end{Example}
\begin{Example}
\begin{quote}
- |labelsep=endash|
+ |format=plain,labelsep=endash|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example{labelsep=endash}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example{format=plain,labelsep=endash}{\exampletext}
\end{Example}
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{textformat=}\NEWfeature{v3.0l}
+With the option
+\nopagebreak[3]
+\begin{quote}
+ |textformat=|\meta{text format name}
+\end{quote}
+\nopagebreak[3]
+%\NEWdescription{v3.0e}
+you specify how the caption text will be typeset.
+There are two standard caption text formats:
+
+\begin{Options}{\OptionLabel}
+ \item[simple]
+ The caption text will be typeset as it is.
+
+ \item[period]
+ The caption text will be followed by a period.
+
+ \item[\UserDefined]
+ Own label formats can be defined using |\Declare|\x|Caption|\x|Text|\x|Format|.
+ \SeeUserDefined
+\end{Options}
+
% --------------------------------------------------------------------------- %
+\pagebreak[4]
\subsection{Justification}
\label{justification}
@@ -459,10 +539,6 @@ You can choose one of the following:
Each line of the caption will be centered.
% \item[Centering]
-% Each line of the caption will be centered, too.
-% But this time the command |\Centering| of the \package{ragged2e} package
-% will be used to achieve this. This difference is that this time the word
-% breaking algorithm of \TeX\ will work inside the caption.
\item[centerlast]
The last line of each paragraph of the caption text will be centered.
@@ -485,8 +561,8 @@ You can choose one of the following:
The need for the \package{ragged2e} package will be detected at
run-time, therefore you maybe need a second \LaTeX\ run if this
option is used.}
- The main difference is that the word breaking algorithm of \TeX\ will
- work inside captions.
+ The main difference to |raggedright| is that the word breaking
+ algorithm of \TeX\ will work inside captions.
\fi
\item[raggedleft]
@@ -496,45 +572,49 @@ You can choose one of the following:
% Each line of the caption will be moved to the right margin using
% the command |\RaggedLeft| from the \package{ragged2e} package.
+%\showhyphens{justification}
\item[\UserDefined]
- Own justifications can be defined using |\DeclareCaptionJustification|.\\
+ Own justifications can be defined using |\Declare|\x|Caption|\x|Jus|\x|ti|\x|fi|\x|ca|\x|tion|.
\SeeUserDefined
\end{Options}
Three examples:
\begin{Example}
\begin{quote}
- |justification=centerlast|
+ |format=plain,justification=centerlast|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example{justification=centerlast}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example{format=plain,justification=centerlast}{\exampletext}
\end{Example}
\begin{Example}
\begin{quote}
|format=hang,justification=raggedright|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{format=hang,justification=raggedright}{\exampletext}
\end{Example}
\begin{Example}
\begin{quote}
- |labelsep=newline,justification=centering|
+ |format=plain,labelsep=newline,justification=centering|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example*{labelsep=newline,justification=centering}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example*{format=plain,labelsep=newline,justification=centering}{\exampletext}
\end{Example}
+\smallskip
+
+\pagebreak[3]
\DescribeMacro{singlelinecheck=}
-The standard \LaTeX\ document classes (|article|, |report|, and |book|)
-automatically center a caption if it fits in one single line:
+The standard \LaTeX\ document classes (\class{article}, \class{report}, and
+\class{book}) automatically center a caption if it fits in one single line:
\example*{}{A short caption.}
\INFO
-\Thispackage\ adapts this behaviour and therefore usually
-ignores the justification \& indention you have set with |justification=| \&
+\Thispackage\ adapts this behavior and therefore usually ignores the
+justification \& indention you have set with |justification=| \&
|indention=| in such case.
But you can switch this special treatment of such short captions off
with the option
@@ -578,13 +658,17 @@ You set them up using the options
And these are the available font options:
-\begin{Options}{\OptionLabel}
+\begin{Options}{stretch=\meta{amount}}
\item[scriptsize] {\scriptsize Very small size}
\item[footnotesize] {\footnotesize The size usually used for footnotes}
\item[small] {\small Small size}
\item[normalsize] {\normalsize Normal size}
\item[large] {\large Large size}
\item[Large] {\Large Even larger size}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+ \item[normalfont] {\normalfont Normal shape \& series \& family}
\item[up] {\upshape Upright shape}
\item[it] {\itshape Italic shape}
@@ -597,10 +681,25 @@ And these are the available font options:
\item[rm] {\rmfamily Roman family}
\item[sf] {\sffamily Sans Serif family}
\item[tt] {\ttfamily Typewriter family}
-
- \item[singlespacing] |\singlespacing| (see \package{setspace} package)
- \item[onehalfspacing] |\onehalfspacing|
- \item[doublespacing] |\doublespacing|
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+ \item[singlespacing] Single spacing \See{\Ref{setspace}}
+ \item[onehalfspacing] One-and-a-half spacing \See{\Ref{setspace}}
+ \item[doublespacing] Double spacing \See{\Ref{setspace}}
+ \item[stretch=\meta{amount}] |\setstretch|\marg{amount} \See{\Ref{setspace}}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+ \item[normalcolor] |\normalcolor|
+ \item[color=\meta{colour}] |\color|\marg{colour}
+ {\small(If the \package{color} or \package{xcolor} package is loaded,
+ see \Ref{declare} for an example)}
+\end{Options}
+\vspace{0pt}\pagebreak[3]
+\begin{Options}{stretch=\meta{amount}}
+ \item[normal] The combination of the options \opt{normalcolor},
+ \opt{normalfont}, \opt{normalsize}, and \opt{singlespacing}
\item[\UserDefined]
Own font options can be defined using |\DeclareCaptionFont|.\\
@@ -618,21 +717,29 @@ and
%\end{quote}
will give the same result.
-Two examples:
+Three examples:
\begin{Example}
\begin{quote}
- |font={small,it},labelfont=bf|
+ |font=it,labelfont=bf|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example{font={small,it},labelfont=bf}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example{font=it,labelfont=bf}{\exampletext}
\end{Example}
\begin{Example}
\begin{quote}
- |font=small,labelfont=bf,textfont=it|
+ |labelfont=bf,textfont=it|
\end{quote}
- \captionsetup{aboveskip=0pt}
- \example{font=small,labelfont=bf,textfont=it}{\exampletext}
+ \captionsetup{skip=0pt}
+ \example{labelfont=bf,textfont=it}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
+ |font={small,stretch=0.80}|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{font={small,stretch=0.80}}{\exampletext}
\end{Example}
% --------------------------------------------------------------------------- %
@@ -643,31 +750,81 @@ Two examples:
\DescribeMacro{margin=}
\DescribeMacro{width=}
For all captions you can specify \emph{either} an extra margin \emph{or}
-a fixed width. You do this by using the options
+a fixed width:~\footnote{Only fixed widths are supported here; if you are
+looking for a way to limit the width of the caption to the width of the
+figure or table, please take a look at the \package{floatrow}\cite{floatrow}
+or \package{threeparttable}\cite{threeparttable} package.}
\begin{quote}\begin{tabular}{@{}r@{}ll}
- |margin=| & \meta{amount} & \emph{or}\\
+ |margin=| & \meta{amount} & \emph{--or--}\\
+ |margin=| & |{|\meta{left amount}|,|\meta{right amount}|}| & \emph{--or--}\\
|width=| & \meta{amount} & \\
\end{tabular}\end{quote}
-Nevertheless what option you use, the left and right margin will be the
-same.
-
-Two examples will illustrating this:
+\NEWfeature{v3.1}
+If you specify just one \meta{amount} for the margin, it will be used for both,
+the left and right margin, e.g.~|margin=10pt| is equivalent to |margin={10pt,10pt}|.
+In two-side documents the left and right margin will be swapped on even pages.
+\DescribeMacro{oneside}
+\DescribeMacro{twoside}
+To prevent this you can specify the option |oneside| additionally,
+e.g.~|\caption|\x|setup|\xx|{margin=|\xx|{0pt,10pt},|\xx|oneside}|.\par
+If you are specifying a width, then both, the left and the right margin, will
+have the same amount.
+
+Three examples will illustrating this:
\begin{Example}
\begin{quote}
|margin=10pt|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{margin=10pt}{\exampletext}
\end{Example}
\begin{Example}
\begin{quote}
+ |margin={1cm,0cm}|
+ \end{quote}
+ \captionsetup{skip=0pt}
+ \example{margin={1cm,0cm}}{\exampletext}
+\end{Example}
+
+\begin{Example}
+ \begin{quote}
|width=.75\textwidth|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{width=.75\textwidth}{\exampletext}
\end{Example}
+\emph{Note:} When the caption is placed beside the contents (for example in
+a |SCfigure| environment offered by the \package{sidecap} package\cite{sidecap})
+or the caption is an in-text caption (for example in a |wrapfigure| environment
+offered by the \package{wrapfig} package\cite{wrapfig}), the margin setting
+will be usually reset to |0pt| at the very beginning of the environment.
+But if you really want to setup an extra margin for these environments, you can
+do so by setting this margin either inside the environment itself, of by
+specifying a margin for this particular environment,
+e.g.~|\captionsetup[SCfigure]{margin=10pt}|.
+
+\pagebreak[3]
+\DescribeMacro{margin*=}\NEWfeature{v3.1}
+\begin{Expert}
+There is also a starred variant of the |margin=| option, |margin*=|, which only
+changes the margin if no width was set.
+\end{Expert}
+
+\pagebreak[3]
+\DescribeMacro{minmargin=}
+\DescribeMacro{maxmargin=}\NEWfeature{v3.1}
+\begin{Expert}
+You can also set a minimum or maximum margin amount. This can be useful for
+limiting the margin amount in smaller environments, e.g.~|minipage|s.
+For example the \SmF\ document classes limit the margin amount to
+|maxmargin=.1\linewidth|. (See \Ref{SMF})
+\end{Expert}
+
+\medskip
+
+\pagebreak[3]
\DescribeMacro{parskip=}
This option is useful for captions containing more than one paragraph.
It specifies the extra vertical space inserted between them:
@@ -679,7 +836,7 @@ One example:
\begin{quote}
|margin=10pt,parskip=5pt|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{margin=10pt,parskip=5pt}{%
First paragraph of the caption. This one contains some test, just to
show how these options affect the layout of the caption.\par
@@ -687,6 +844,7 @@ One example:
show how these options affect the layout of the caption.}
\end{Example}
+\pagebreak[3]
\DescribeMacro{hangindent=}
The option
\begin{quote}
@@ -701,7 +859,7 @@ But if the caption contains multiple paragraphs you will notice the difference:
\begin{quote}
|format=hang,indention=-.5cm|
\end{quote}
- \captionsetup{aboveskip=0pt}
+ \captionsetup{skip=0pt}
\example{format=hang,indention=-.5cm}{%
First paragraph of the caption. This one contains some test, just to
show how these options affect the layout of the caption.\par
@@ -721,15 +879,22 @@ But if the caption contains multiple paragraphs you will notice the difference:
show how these options affect the layout of the caption.}
\end{Example}
+\emph{Note:} If your caption contains more than one paragraph, you have
+to specify an alternative caption for the list-of-figures using the
+optional argument of |\caption| or |\captionof|, otherwise you will get
+an error message.
+
% --------------------------------------------------------------------------- %
+\pagebreak[4]
\subsection{Styles}
\label{style}
\DescribeMacro{style=}
A suitable combination of caption options is called \emph{caption style}.
You can compare them more or less to page styles which you set up with
-|\pagestyle|: The caption style provides all settings for a whole caption layout.
+|\pagestyle|; the caption style provides all settings for a whole caption
+layout.
You switch to an already defined caption style with the option
\begin{quote}
@@ -740,7 +905,7 @@ You switch to an already defined caption style with the option
\NEWfeature{v3.1}
The |base| style puts all options you already know about to values reflecting
the look of the captions when using one of the base \LaTeX\ document classes
-|article|, |report|, and |book|.
+\class{article}, \class{report}, and \class{book}.
This means that specifying the option
\begin{quote}
|style=base|
@@ -748,9 +913,9 @@ This means that specifying the option
has the same effect as specifying all these options:
\begin{quote}
|format=plain,labelformat=default,labelsep=colon,|\\
- |justification=justified,font=,labelfont=,|\\
- |textfont=,margin=0pt,indention=0pt,parindent=0pt|\\
- |hangindent=0pt,singlelinecheck=true|
+ |justification=justified,font={},labelfont={},|\\
+ |textfont={},margin=0pt,indention=0pt|\\
+ |parindent=0pt,hangindent=0pt,singlelinecheck=true|
\end{quote}
{\small(But |justification=centering,indention=0pt| will be set if
the caption fits into a single line.)}
@@ -761,14 +926,15 @@ This style is selected by default and represents these options:
\begin{quote}
|format=default,labelformat=default,labelsep=default,|\\
|justification=default,font=default,labelfont=default,|\\
- |textfont=default,margin=0pt,indention=0pt,parindent=0pt|\\
- |hangindent=0pt,singlelinecheck=true|
+ |textfont=default,margin=0pt,indention=0pt|\\
+ |parindent=0pt,hangindent=0pt,singlelinecheck=true|
\end{quote}
{\small(But again |justification=centering,indention=0pt| will be set if
the caption fits into a single line.)}
-So if you use one of the base \LaTeX\ document classes,
-both |base| and |default| point to the nearly same settings.
+So if you use one of the base \LaTeX\ document classes \class{article},
+\class{report}, or \class{book}, both |base| and |default| point to nearly
+the same settings.
{\small\emph{Note:} Own caption styles can be defined using
|\DeclareCaptionStyle|. \SeeUserDefined}
@@ -778,101 +944,70 @@ both |base| and |default| point to the nearly same settings.
\subsection{Skips}
\label{skips}
-\DescribeMacro{aboveskip=}
-\DescribeMacro{belowskip=}
-The vertical spaces above and below the caption are controlled by the skips
-|\abovecaptionskip| and |\belowcaptionskip|. The standard \LaTeX\ document
-classes |article|, |report| and |book| set |\abovecaptionskip| to |10pt|
-and |\belowcaptionskip| to |0pt|, other document classes may use other values.
+\DescribeMacro{skip=}\NEWfeature{v3.0d}
+The vertical space between the caption and the figure or table contents is
+controlled by the option
+\begin{quote}
+ |skip=|\meta{amount}\quad.
+\end{quote}
+The standard \LaTeX\ document classes \class{article}, \class{report} and
+\class{book} preset it to |skip=10pt|, but other document classes may use
+a different amount.
-\pagebreak[3]
-Both skips can be changed with the command |\setlength|, but you can
-use these options, too:
-\nopagebreak[3]
-\begin{quote}\begin{tabular}{@{}r@{}ll}
- |aboveskip=| & \meta{amount} & and\\
- |belowskip=| & \meta{amount} & .\\
-\end{tabular}\end{quote}
+\bigskip
+\pagebreak[3]
\DescribeMacro{position=}
-Using |\abovecaptionskip| and |\belowcaptionskip| has a major design flaw:
-If the caption is typeset \emph{above} (and not \emph{below}) the figure
-or table they are not set up very useful at default, because there will be
-some extra space above the caption but no space between the caption and the
-figure or table itself. (Remember: |\belowcaptionskip| is usually set to |0pt|.)
-
-Please compare the spacing in these small tables:
-\begin{Example}
- \captionsetup{position=b}
- \begin{minipage}[c]{.5\linewidth}
-% \captionsetup{aboveskip=0pt}%
- \captionof{table}{A table}
- \centering\begin{tabular}{ll}
- A & B \\
- C & D \\
- \end{tabular}
- \end{minipage}
- \begin{minipage}[c]{.5\linewidth}
- \centering\begin{tabular}{ll}
- A & B \\
- C & D \\
- \end{tabular}
- \captionof{table}{A table}
- \end{minipage}
-\end{Example}
-
-But you can fix this by using the option |position=|: It specifies how the
-spacing above and below the caption will be used:
+The |\caption| command offered by |\LaTeX| has a design flaw:
+The command does not know if it stands on the beginning of the figure or
+table, or at the end. Therefore it does not know where to put the space
+separating the caption from the content of the figure or table.
+While the standard implementation always puts the space above the caption
+in floating environments (and inconsistently below the caption in
+|longtable|s), the implementation offered by this package is more
+flexible.
+By giving the option
\begin{quote}
- |position=top|\quad(or |position=above|)
+ |position=top|\quad or\quad |position=above|
\end{quote}
-tells \thispackage\ to use the spacing useful for caption
-\emph{above} the figure or table and
+it's assumed that the caption is standing at the \emph{top} of the
+environment and therefore the space setup with |skip=|\meta{amount} is
+placed below the caption.
+(Please note that |position=top| does \emph{NOT} mean that the
+caption is actually placed at the top of the figure or table.
+Instead the caption is usually placed where you place the |\caption|
+command.)
+But with
\begin{quote}
- |position=bottom|\quad(or |position=below|)
+ |position=bottom|\quad or\quad |position=below|
\end{quote}
-tells \thispackage\ to use the spacing useful for captions
-\emph{below} the figure or table. (The last one is the default setting
-except for |longtable|s.)
-
-So adding an extra |\captionsetup{position=top}| to the left example
-table gives you proper spacing around both captions:
-\begin{Example}
- \begin{minipage}[c]{.5\linewidth}
- \captionsetup{position=t}
- \captionof{table}{A table}
- \centering\begin{tabular}{ll}
- A & B \\
- C & D \\
- \end{tabular}
- \end{minipage}
- \begin{minipage}[c]{.5\linewidth}
- \centering\begin{tabular}{ll}
- A & B \\
- C & D \\
- \end{tabular}
- \captionsetup{position=b}
- \captionof{table}{A table}
- \end{minipage}
-\end{Example}
+it's assumed that the caption is standing at the \emph{bottom} of the
+environment and therefore the space is placed above the caption.
+And finally with
+\begin{quote}
+ |position=auto|\quad {\small(which is the default setting)}
+\end{quote}
+the caption package tries its best to determine the actual position of
+the caption on its own. Please note that while this is successfully in
+most cases, it could give wrong results under rare circumstances.
-(Technically speaking |\abovecaptionskip| and |\belowcaptionskip| will
-be swapped if you specify the option |position=top|, so in both cases
-|\abovecaptionskip| will be used between the caption and the figure or
-table itself.)
+\medskip
-This option is especially useful when used together with the optional
-argument of the |\captionsetup| command.
-\See{\Ref{commands} for details}\par
+\pagebreak[3]
+\DescribeMacro{figureposition=}%\NEWfeature{v3.0a}
+\DescribeMacro{tableposition=}%\NEWfeature{v3.0a}
+The |position| option is especially useful when used together with the
+optional argument of the |\captionsetup| command.
+\See{\Ref{captionsetup} for details}\par
For example
\begin{quote}
- |\captionsetup[table]{position=top}|
+ |\captionsetup[table]{position=above}|
\end{quote}
causes all captions within tables to be treated as captions \emph{above}
the table (regarding spacing around it).
-\DescribeMacro{tableposition=}%\NEWfeature{v3.0a}
-Because this is a very common setting \thispackage\ offers
-an abbreviating option for the use with |\usepackage|:
+Because this is a very common setting, \thispackage\ offers
+the abbreviating options |figure|\x|position=|\xx\meta{pos} and
+|table|\x|position=|\xx\meta{pos}, e.g.
\begin{quote}
|\usepackage[|\ldots|,tableposition=top]{caption}|
\end{quote}
@@ -881,65 +1016,326 @@ is equivalent to
|\usepackage[|\ldots|]{caption}|\\
|\captionsetup[table]{position=top}|
\end{quote}
+\DANGER
+{\small Please note that the options \opt{skip=}, \opt{position=},
+ \opt{figureposition=}, and \opt{tableposition=} do not always have an effect.
+ Since it's a matter of the document class to supply the environments
+ \env{figure} and \env{table}, it could use its very own spacing, and could
+ decide for itself if the caption will be typeset as ``top'' or ``bottom''
+ caption.
+ For example the \KOMAScript\ document classes support the \opt{skip}
+ setting, but will always typeset \env{figure} captions as ``bottom'' captions,
+ and \env{table} captions are dependent on the global option
+ \opt{tablecaptionsabove} resp.\ \opt{tablecaptionsbelow}.
+ \See{\Ref{KOMA}}
+
+ Furthermore some packages control the behavior of the spacing above and
+ below the caption for themself, e.g.~the \package{float}, the
+ \package{floatrow}, and the \package{supertabular} package.}
+
+\bigskip
+
+\begin{Expert}
+Internally the skip between caption and contents is represented by
+|\above|\x|caption|\x|skip| (which is always set above the caption in
+\LaTeX{}s implementation).
+But there is a second value |\below|\x|caption|\x|skip| (usually set to
+|0pt| by default) which is set below the caption in \LaTeX{}s implementation,
+but on the other side than |\above|\x|caption|\x|skip| by this package.
+So technically speaking, this package swaps the meaning of these two skips
+when |position=top| is set.
+Please note that there are several packages around which do the same trick
+(like the \package{ftcap}, the \package{nonfloat}, and the \package{topcap}
+package) which usage should be avoided when this package is used.
+\end{Expert}
+
+% --------------------------------------------------------------------------- %
+
+\subsection{Lists}
+\label{lists}
+
+\DescribeMacro{list=}\NEWfeature{v3.1}
+The |\caption| command usually places an entry in the List of Figures
+resp.~List of Tables. You can either suppress that individually by giving an
+empty optional argument to |\caption| {\small(see \Ref{caption})}, or
+programmatically by saying
+\begin{quote}
+ |list=no|\quad(or any other boolean value instead of |no|)\quad.~\footnote{%
+ Please note that the \package{subfig} package\cite{subfig} is not supporting
+ this option, it uses the counters \texttt{lofdepth} \& \texttt{lotdepth} for
+ this purpose instead.}
+\end{quote}
+
+\pagebreak[3]
+\DescribeMacro{listformat=}\NEWfeature{v3.1}
+With the option
+\nopagebreak[3]
+\begin{quote}
+ |listformat=|\meta{list format name}
+\end{quote}
+\nopagebreak[3]
+you can specify how the |figure| or |table| number will be typeset within
+the List of Figures resp.~List of Tables.
+There are five standard caption list formats:
+
+\begin{Options}{\OptionLabel}
+ \item[empty]
+ No number will be typeset.
+
+ \item[simple]
+ The number will be typeset with label prefix.
+
+ \item[parens]
+ The number will be typeset in parentheses, with label prefix.
+
+ \item[subsimple]
+ Same as |simple|, but without label prefix. (default)
+
+ \item[subparens]
+ Same as |parens|, but without label prefix.
+
+ \item[\UserDefined]
+ Own label formats can be defined using |\Declare|\x|Caption|\x|List|\x|Format|.
+ \SeeUserDefined
+\end{Options}
+
+The label prefix ($=$|\p@figure| resp.~|\p@table|) is usually empty,
+so |simple| and |subsimple| gives equal results, same with |parens| and
+|subparens|. But this can be different for sub-figures or sub-tables
+listed in the List of Figures resp.~List of Tables, or when the label prefix
+is redefined for a different purpose.
+
+% --------------------------------------------------------------------------- %
+
+\subsection{Names \& Numbering}
+\label{names}\label{numbering}
+
+\DescribeMacro{figurename=}
+\DescribeMacro{tablename=}\NEWfeature{v3.0l}
+You can change the name of the figures \& tables with the options
+\begin{quote}\begin{tabular}{@{}r@{}l@{\quad}l@{}}
+ |figurename=| & \meta{name} & and\\
+ |tablename=| & \meta{name} & .\\
+\end{tabular}\end{quote}
+The document class usually sets them to ``Figure'' \& ``Table', but for
+example with
+\begin{quote}
+ |figurename=Fig.|
+\end{quote}
+you can change the figure name to ``Fig''.
+
+\INFO*
+If you use the \package{babel} package, please load \thispackage\ \emph{after}
+the \package{babel} package.
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{name=}\NEWfeature{v3.1f}
+Similar to |figurename=| \& |tablename=| you can change the name of the
+\emph{current} environment with the option
+\begin{quote}
+ |name=|\meta{name}\quad.
+\end{quote}
+This could be useful in conjunction with the optional argument of
+|\captionsetup|, e.g.
+\begin{quote}
+ |\captionsetup[wrapfigure]{name=Fig.}|
+\end{quote}
+changes the name to ``Fig.'' for all |wrapfigure|s (while all the other
+figure captions will still have ``Figure'' as name).
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{figurewithin=}
+\DescribeMacro{tablewithin=}\NEWfeature{v3.1f}
+If a document class providing |\chapter| is used (e.g.~\package{report} or
+\package{book}), usually the \env{figure} and \env{table} caption counters
+are dependent on the |chapter| counter. Otherwise usually the \env{figure} and
+\env{table} counters are continuous throughout the document.
+
+This can be changed with the options
+\begin{quote}\begin{tabular}{r@{}l}
+ |figurewithin=| & \meta{figure ``within'' counter} \emph{or} \texttt{none}\quad and\\
+ |tablewithin=| & \meta{table ``within'' counter} \emph{or} \texttt{none}\quad .\\
+\end{tabular}\end{quote}
+If ``|none|'' is given as value, the numbering of figures resp. tables will
+be continuous throughout the document.
+Otherwise the numbering will be dependent on the given counter,
+e.g.~|figurewithin=section| gives figures a section-dependent numbering scheme.
+
+\bigskip
+
+\begin{Expert}
+The name \& numbering is internally done by the commands |\|\meta{type}|name|
+\& |\the|\meta{type}, e.g.~|\figurename| \& |\thefigure| for figures.
+While usually using the above options are sufficient, sometimes a direct
+re-definition of these two macros is necessary. For example:
+\begin{quote}
+ |\captionsetup{figurewithin=section}|\\
+ |\renewcommand\thefigure{\arabic{section}\alph{figure}}|
+\end{quote}
+gives you a section-dependent numbering scheme \meta{section}\meta{figure}
+with a numerical section counter and a alphanumerical figure counter,
+e.g.~``|Figure 2b|''.
+\end{Expert}
+
+% --------------------------------------------------------------------------- %
+
+\subsection{Types}
+\label{types}
+
+\DescribeMacro{type=}\NEWfeature{v3.0d}
+The |\caption| command can typeset captions for different types,
+e.g.~|figure| and |table|. If you try to use the |\caption| command outside
+these environments you will get an error message, because it does not know what
+kind of caption do you want to have here. But in such situations you can set
+the caption type manually with
+\begin{quote}
+ |type=|\meta{float type}
+\end{quote}
+prior to the usage of the |\caption| command (and other commands like
+|\Continued|\x|Float| or |\subfloat| offered by the \package{subfig}
+package\cite{subfig}), for example within an non-floating environment like
+|minipage|:
+\begin{quote}
+ |\noindent\begin{minipage}{\textwidth}|\\
+ | \captionsetup{type=figure}|\\
+ | \subfloat{|\ldots|}|\\
+ | |\ldots\\
+ | \caption{|\ldots|}|\\
+ |\end{minipage}|
+\end{quote}
+
+\begin{Expert}
+There is also a starred variant of this option, |type*=|\meta{float type},
+which behaves different than |type=|\meta{float type} if the
+\package{hyperref} package\cite{hyperref} is loaded: While |type=| sets an
+hyperlink anchor (if |hypcap=true| is set), |type*=| does not.
+(See also \Ref{hyperref})
+\end{Expert}
+
+\medskip
+
+Own float types can be defined with |\Declare|\x|Caption|\x|Type| offered by
+this package, |\new|\x|float| offered by the \package{float}
+package\cite{float}, or |\Declare|\x|New|\x|Float|\x|Type| offered by the
+\package{floatrow} package\cite{float}.
+
+\medskip
+
+\DANGER % \NEWdescription{v3.1}
+Please note that you should use the option |type=| only
+\emph{inside} boxes or environments (like |\parbox| or |minipage|),
+at best one where no page break could happen between contents and caption.
+Furthermore some visual side-effects (e.g.~mixed-up figure and table settings
+regarding captions) could occur without using a box or environment,
+therefore a warning message will be issued if you try to do so.\footnote{%
+You only get this warning message if you use \eTeX\ as underlying \TeX\ engine.}
+
+\vfill
% --------------------------------------------------------------------------- %
\pagebreak[4]
\section{Commands}
-\label{commands}
+
+\subsection{Typesetting captions}
+\label{caption}
+\label{captionlistentry}
\DescribeMacro{\caption}
The command
-\nopagebreak[3]
\begin{quote}
- |\caption|\oarg{lst\_entry}\marg{heading}
+ |\caption|\oarg{list entry}\marg{heading}
\end{quote}
-\nopagebreak[3]
typesets the caption inside a floating environment like |figure| or |table|.
Well, you already know this, but \thispackage\ offers an extension:
-If you leave the argument \meta{lst\_entry} empty, no entry in the list of
+If you leave the argument \meta{list entry} empty, no entry in the list of
figures or tables will be made. For example:
\begin{quote}
- |\caption[]{A figure without entry in the list of figures.}|
-\end{quote}
+ |\caption[]{A figure without list entry.}|
+\end{quote}
+
+\begin{Expert}
+Please remember that the \meta{heading} is a so-called \emph{moving} argument,
+if no \meta{list entry} has been given. If a \meta{list entry} is given,
+this argument is moving instead. ``\emph{Moving} argument''
+means that the argument will be written to the list-of file, make it
+appearing in the ``List of Figures'' resp. ``List of Tables'', too.
+\emph{Moving} arguments are not allowed to contain \emph{fragile} commands,
+everything must be \emph{robust}, otherwise the argument could get
+\emph{broken}, resulting in strange \LaTeX\ errors. Some \emph{fragile}
+commands could be \emph{protected} by a leading |\protect|, own definitions
+could get defined with |\DeclareRobustCommand| instead of |\newcommand| to
+make them \emph{robust}.
+
+An example: |\caption{${}^{137}_{\phantom{1}55}$Cs}| will cause errors since
+|\phantom| is \emph{fragile}. So we have either have to use the optional
+argument \meta{list entry}
+(e.g.~|\caption[${}^|\xx|{137}_|\xx|{55}$|\xx|Cs]|\xx|{${}^|\xx|{137}_|\xx|{\phantom{1}55}$|\xx|Cs}|)
+or add |\robust| to prevent the |\phantom| command from getting \emph{broken}:
+|\caption{${}^|\xx|{137}_|\xx|{|\textcolor{blue}{\cs{protect}}|\phantom{1}55}$|\xx|Cs}|.
+
+But sometimes even this is not sufficient. The reason behind is the so-called
+single-line-check: It puts the \meta{heading} into a horizontal box to determine
+the width of the caption, and this could cause error messages, too. An example:
+|\caption{A| |schematic.| |\[V_{C}| |\sim| |\left| |\{| |\begin{array}{cc}|
+|E_{g}| |&| |\textrm{p-n}| |\\| |e\phi_{B}| |&| |\textrm{M-S}| |\end{array}|
+|\right.| |\]}|.
+Using |\caption[A| |schematic]{|\ldots|}| is not sufficient here, it's still
+leading to errors. (``\texttt{Missing \$ inserted.}'') So we have to put
+a |\captionsetup{singlelinecheck=off}| just in front of the |\caption|
+command additionally.
+
+For more information about \emph{moving} arguments and \emph{fragile} \&
+\emph{robust} commands, take a closer look at your \LaTeX\ manual or visit
+\url{http://www-h.eng.cam.ac.uk/help/tpl/textprocessing/teTeX/latex/latex2e-html/fragile.html}.
+\end{Expert}
+
+\medskip
+\pagebreak[3]
\DescribeMacro{\caption*}
The \package{longtable} package defines the command |\caption*| which
typesets the caption without label and without entry in the list of tables.
An example:
\begin{quote}
- |\begin{longtable}{cc}|\\
+ |\begin{longtable}{|\ldots|}|\\
| \caption*{A table}\\|\\
- | A & B \\|\\
- | C & D \\|\\
+ | |\ldots\\
|\end{longtable}|
\end{quote}
looks like
-\begin{longtable}{cc}
+\DeleteShortVerb{\|}
+\begin{longtable}{r|rr}
\caption*{A table}\\
- A & B \\
- C & D \\
+ & x & y \\\hline
+ a & 1 & 2 \\
+ b & 3 & 4 \\
\end{longtable}
-
+\MakeShortVerb{\|}
This package offers this feature, too, so you can use this command now within
every floating environment like |figure| or |table|, like:
\begin{quote}
|\begin{table}|\\
| \caption*{A table}|\\
- | \begin{tabular}{cc}|\\
- | A & B \\|\\
- | C & D \\|\\
- | \end{tabular}|\\
+% | \begin{tabular}{|\ldots|}|\\
+% | |\ldots\\
+% | \end{tabular}|\\
+ | |\ldots\\
|\end{table}|
\end{quote}
+\pagebreak[3]
\DescribeMacro{\captionof}
\DescribeMacro{\captionof*}
Sometimes you want to typeset a caption \emph{outside} a floating environment,
-putting a figure within a |minipage| for instance. For this purpose
+putting a figure within a non-floating |minipage| for instance. For this purpose
\thispackage\ offers the command
\begin{quote}
- |\captionof|\marg{float type}\oarg{lst\_entry}\marg{heading}\quad.
+ |\captionof|\marg{float type}\oarg{list entry}\marg{heading}\quad.
\end{quote}
Note that the first argument, the \meta{float type}, is mandatory here, because
the |\captionof| command needs to know which name to put into the caption label
@@ -951,24 +1347,67 @@ An example:
\end{quote}
typesets captions like this:
\begin{Example}
- \captionof{figure}{A figure}
- \captionsetup{belowskip=\abovecaptionskip}
- \captionof{table}{A table}
+ \begingroup
+ \captionof{figure}{A figure}
+ \endgroup
+ \captionsetup{position=top}
+ \begingroup
+ \captionof{table}{A table}
+ \endgroup
\end{Example}
-The star variant |\captionof*| has the same behaviour as the |\caption*| command:
+The star variant |\captionof*| has the same behavior as the |\caption*| command:
it typesets the caption without label and without entry to the list of figures
or tables.
\DANGER % \NEWdescription{v3.1}
-Please note that you should use both |\captionof| and |\captionof*| only
-\emph{inside} boxes or environments (like |\parbox| or |minipage|),
-otherwise an error message will be issued.\footnote{%
-This only happens if you use \eTeX\ as underlying \TeX\ engine.
-Otherwise no error message will be issued, but a page break can appear
-between content and caption.
-Furthermore some strange effects could occur,
-e.g., mixed-up figure and table settings regarding captions.}
+Since |\captionof| uses the |type*=| option internally, the same restrictions
+as for the |type=| option apply here, so you should use both |\captionof|
+and |\captionof*| only \emph{inside} boxes or environments, too.
+\See{\Ref{types}}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\captionlistentry}\NEWfeature{v3.1}
+Under certain circumstances it could be useful to make a list-of-figure
+(or table) entry on its own.
+This could be achieved with
+\begin{quote}
+ |\captionlistentry|\oarg{float type}\marg{list entry}\quad.
+\end{quote}
+One example: It's quite easy to have a |longtable| with captions above the
+contents and a single list entry which points to the first page of the table:
+\begin{quote}
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption{|\ldots|}\\|\\
+ |\endfirsthead|\\
+ | \caption[]{|\ldots|}\\|\\
+ |\endhead|\\
+ | |\ldots
+\end{quote}
+But since the \package{longtable} package does not offer an |\endfirstfoot|
+command, you cannot easily have captions \emph{below} the table
+contents and a single list entry which points to the first page of the table.
+Here is were the |\captionlistentry| command could be used:
+\begin{quote}
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption[]{|\ldots|}\\|\\
+ |\endfoot|\\
+ | \captionlistentry{|\ldots|}|\\
+ | |\ldots
+\end{quote}
+{\small(Another example can be found in \Ref{examples}.)}
+
+\smallskip
+
+\begin{Expert}
+Please note that \meta{list entry} is a \emph{moving} argument, so everything
+it contains must be \emph{robust}. (See also explanation of |\caption|)
+\end{Expert}
+
+\subsection{Setting options}
+\label{captionsetup}
\DescribeMacro{\captionsetup}
We already know the |\captionsetup| command (see \Ref{usage}),
@@ -1008,17 +1447,22 @@ gives captions like this:
\endgroup
\end{Example}
-As you see the command |\captionsetup[figure]{|\ldots|}| only changed
+As you see the command |\captionsetup[figure]{|\ldots|}| only changes
the look of the |figure| caption labels, not touching the other ones.
-{\small As \meta{float type} you can usually give one of these two only:
+As \meta{float type} you can usually give one of these two only:
|figure| or |table|.
-But as we will see later some \LaTeX\ packages (like the
-\package{float}, \package{longtable}, and \package{sidecap} package
-for example) offer additional floating environments and these two
-commands can also be used with them. \See{\Ref{packages}}}
+But as we will see later some \LaTeX\ packages (like the \package{floatrow},
+\package{longtable}, and \package{sidecap} package for example) and also
+this package offer additional environments with captions and these two
+commands can also be used with them.
+\See{\Ref{declare} and \Ref{packages}}
-{\small\NEWfeature{v3.1}
+\smallskip
+
+\pagebreak[3]
+\NEWfeature{v3.1}
+\begin{Expert}
There is also a starred variant of |\captionsetup|:
\begin{quote}
|\captionsetup*|\oarg{float type}\marg{options}
@@ -1026,10 +1470,13 @@ There is also a starred variant of |\captionsetup|:
While the non-starred variant gives you a warning if the \meta{options} are
actually not used throughout the document (e.g.~a |\captionsetup[table]{font=sf}|
without a |table|), the starred variant will not.
-This is quite useful when setting generic options which are independant of a
-specific document.}
+This is quite useful when setting generic options which are independent of a
+specific document.
+\end{Expert}
-\pagebreak[4]
+\medskip
+
+\pagebreak[3]
\DescribeMacro{\clearcaptionsetup}
If you want to get rid of these parameters marked for an automatic use within
a particular environment you can use the command
@@ -1038,7 +1485,7 @@ a particular environment you can use the command
\end{quote}
For example |\clearcaptionsetup{figure}| would clear all the extra handling
-for |figure|s in the example above:
+for figures in the example above:
\begin{quote}
|\captionsetup{font=small}|\\
|\captionsetup[figure]{labelfont=bf,textfont=it}|\\
@@ -1050,6 +1497,7 @@ for |figure|s in the example above:
| \caption{A figure}|\\
\ldots\\
\end{quote}
+\pagebreak[3]
\begin{Example}
\captionsetup{font=small}
\captionsetup[figure]{labelfont=bf,textfont=it}
@@ -1063,6 +1511,7 @@ for |figure|s in the example above:
\endgroup
\end{Example}
+\pagebreak[3]
\NEWfeature{v3.1}
If an optional argument \meta{option} is given, only the settings regarding
this particular \meta{option} are cleared.\footnote{You can only specify
@@ -1070,9 +1519,9 @@ this particular \meta{option} are cleared.\footnote{You can only specify
If you want to clean more than one option, you need to use more than one
\cs{clearcaptionsetup}s.}
While the example above not only clears the options |labelfont=bf,textfont=it|
-for |figure|s (but all options for |figure|s instead),
+for figures (but all options for figures instead),
this one would only clear the |labelfont=bf| setting, leaving all other
-settings for |figure|s intact:
+settings for figures intact:
\begin{quote}
|\captionsetup{font=small}|\\
|\captionsetup[figure]{labelfont=bf,textfont=it}|\\
@@ -1096,28 +1545,33 @@ settings for |figure|s intact:
\captionof{figure}{A figure}
\endgroup
\end{Example}
-{\small Analogous to |\captionsetup*| there is also a starred form
+\begin{Expert}
+Analogous to |\captionsetup*| there is also a starred form
|\clearcaptionsetup*| which suppresses warnings if the given \meta{option}
-was not setup for the specified \meta{float type}.}
+was not setup for the specified \meta{float type}.
+\end{Expert}
-\pagebreak[4]
+\medskip
+
+\vfill\pagebreak[4]
\DescribeMacro{\showcaptionsetup}
-For debugging purposes the command
+For debugging purposes the command\nopagebreak
\begin{quote}
|\showcaptionsetup|\marg{float type}
\end{quote}
-is offered. It generates a logfile entry, showing the given options
+is offered. It generates a log file entry, showing the given options
for the specified \meta{float type}. For example
\begin{quote}
|\captionsetup[figure]{labelfont=bf,textfont=it}|\\
|\showcaptionsetup{figure}|
\end{quote}
gives the info:
-\begin{quote}
+\begin{quote}\small
|Caption Info: Option list on `figure'|\\
|Caption Data: {labelfont=bf,textfont=it} on input line 5.|
\end{quote}
+\pagebreak[3]
\subsection{Continued floats}
\label{ContinuedFloat}
@@ -1128,20 +1582,18 @@ their own reference number. This is what the command
|\ContinuedFloat|
\end{quote}
is for; it should be used as first command inside the floating environment.
-It prevents the increment of the relevant counter (usually done by |\caption|)
-so a figure or table with a |\ContinuedFloat| in it gets the same reference
-number as the figure or table before.
-
-An example:
+It prevents the incrementation of the relevant counter (usually done by
+|\caption|), so a figure or table with a |\ContinuedFloat| in it gets the
+same reference number as the figure or table before. An example:
\begin{quote}
|\begin{table}|\\
- |\caption{A table}|\\
- \ldots\\
+ | \caption{A table}|\\
+ | |\ldots\\
|\end{table}|\\
\ldots\\
|\begin{table}\ContinuedFloat|\\
- |\caption{A table (cont.)}|\\
- \ldots\\
+ | \caption{A table (cont.)}|\\
+ | |\ldots\\
|\end{table}|
\end{quote}
gives the following result:
@@ -1151,45 +1603,107 @@ gives the following result:
\centerline{\ldots}
\ContinuedFloat
\caption{A table (cont.)}
+ \centerline{\ldots}
\end{Example}
+\bigskip
+
+\NEWfeature{v3.1}
+Furthermore the |\ContinuedFloat| command executes options associated with
+the type name ``|ContinuedFloat|''. For example this can be used to switch
+to a different label format for continued figures or tables, as shown here:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{continued}{Continued #1~#2}|\\
+ |\captionsetup[ContinuedFloat]{labelformat=continued}|\\
+ \ldots\\
+ |\begin{table}\ContinuedFloat|\\
+ | \caption{A table}|\\
+ | |\ldots\\
+ |\end{table}|
+\end{quote}
+\begin{Example}
+ \captionsetup{type=table,position=b,skip=0pt}
+ \captionsetup[ContinuedFloat]{labelformat=continued}
+ \ContinuedFloat
+ \caption{A table}
+ \centerline{\ldots}
+\end{Example}
+\medskip
+\See{\Ref{declare} for an explanation of \cs{DeclareCaptionLabelFormat}.}
+
+\bigskip
+
+If you want to have a different caption label in |longtable|s after
+a page break, this can \emph{not} be archived by using |\ContinuedFloat|,
+but you could write something like:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{continued}{Continued #1~#2}|\\
+ \ldots\\
+ |\begin{longtable}{|\ldots|}|\\
+ | \caption{A longtable}\\|\\
+ |\endfirsthead|\\
+ | \captionsetup{labelformat=continued}|\\
+ | \caption[]{A longtable}\\|\\
+ |\endhead|\\
+ | |\ldots\\
+ |\end{longtable}|
+\end{quote}
+{\small\emph{Note:} |\ContinuedFloat| is not available for |longtable|s.}
+
+\vfill
+
% --------------------------------------------------------------------------- %
\pagebreak[4]
\section{Own enhancements}
\label{declare}
-A family of commands is provided to allow users to define their own formats.
+A family of commands is provided to allow users to define their own formats
+etc.
This enables information on separators, justification, fonts, and styles to
-be associated with a name and kept in one place
-(these commands need to appear in the document preamble,
-this is the part between |\documentclass| and |\begin{document}|).
+be associated with a name and kept in one place.
+(These commands need to appear in the document preamble,
+this is the part between |\documentclass| and |\begin{document}|.)
-\pagebreak[2]
+\pagebreak[3]
\DescribeMacro{\DeclareCaptionFormat}
You can define your own caption formats using the command
\begin{quote}
- |\DeclareCaptionFormat|\marg{name}\marg{code using \#1, \#2 and \#3}\quad.
+ |\DeclareCaptionFormat|\marg{name}\marg{code using \#1, \#2 and \#3}\mbox{\quad.}
\end{quote}
At usage the system replaces \#1 with the caption label, \#2 with the
separator and \#3 with the text. So the standard format |plain| is
pre-defined by \thispackage\ as
\begin{quote}
- |\DeclareCaptionFormat{plain}{#1#2#3\par}|
+ |\DeclareCaptionFormat{plain}{#1#2#3\par}|\quad.
\end{quote}
+\begin{Expert}
+There is also a starred variant, |\DeclareCaptionFormat*|, which causes
+the code being typeset in \TeX s vertical (instead of horizontal) mode,
+but does not support the |indention=| option.
+\end{Expert}
-\DescribeMacro{\DeclareCaptionLabelFormat}
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\LabelFormat}
Likewise you can define your own caption label formats:
\begin{quote}
|\DeclareCaptionLabelFormat|\marg{name}\marg{code using \#1 and \#2}
\end{quote}
At usage \#1 gets replaced with the name (e.g. ``figure'') and \#2
gets replaced with the reference number (e.g. ``12'').
+An example:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{bf-parens}{(\textbf{#2})}|\\
+ |\captionsetup{labelformat=bf-parens,labelsep=quad}|
+\end{quote}
+\example*{labelformat=bf-parens,labelsep=quad}{\exampletext}
+\pagebreak[3]
\DescribeMacro{\bothIfFirst}
\DescribeMacro{\bothIfSecond}
-If you define your own caption label formats and use the \package{subfig}
-package\cite{subfig}, you should take care of empty caption label names.
+If you define your own caption label formats and use the
+\package{subfig}\cite{subfig} or \package{subcaption} package,
+you should take care of empty caption label names.
For this purpose the commands
\begin{quote}
|\bothIfFirst|\marg{first arg}\marg{second arg}\quad and\\
@@ -1199,44 +1713,68 @@ are offered. |\bothIfFirst| tests if the first argument exists (means: is
not empty), |\bothIfSecond| tests if the second argument exists. If yes,
both arguments get typeset, otherwise none of them.
+\smallskip
+
+\pagebreak[3]
For example the standard label format |simple| is \emph{not} defined as
\begin{quote}
- |\DeclareCaptionLabelFormat{simple}{#1~#2}|\quad,
+ |\DeclareCaptionLabelFormat{simple}{#1~#2}|\mbox{\quad,}
\end{quote}
because this could cause an extra space if \#1 is empty. Instead |simple|
is defined as
\begin{quote}
- |\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{~}#2}|\quad,
+ |\DeclareCaptionLabelFormat{simple}%|\\
+ | {\bothIfFirst{#1}{~}#2}|\mbox{\quad,}
\end{quote}
causing the space to appear only if the label name is present.
+\smallskip
+
\pagebreak[3]
-\DescribeMacro{\DeclareCaptionLabelSeparator}
+\DescribeMacro{\DeclareCaption-\\TextFormat}\NEWfeature{v3.0l}
+Likewise you can define your own caption text formats:
+\begin{quote}
+ |\DeclareCaptionTextFormat|\marg{name}\marg{code using \#1}
+\end{quote}
+At usage \#1 gets replaced with the caption text.
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\LabelSeparator}
You can define your own caption label separators with
-\nopagebreak[3]
\begin{quote}
- |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}\quad.
+ |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}\mbox{\quad.}
\end{quote}
-\nopagebreak[3]
Again an easy example taken from \thispackage\ itself:
-\nopagebreak[3]
\begin{quote}
|\DeclareCaptionLabelSeparator{colon}{: }|
\end{quote}
-\pagebreak[3]
+\begin{Expert}
+There is also a starred variant, |\DeclareCaptionLabelSeparator*|, which
+causes the code being typeset without using the |labelfont=| setting.
+So for example the label separators |quad|, |newline|, and |endash|
+are defined in this way.
+\end{Expert}
+
+\bigskip
-\DescribeMacro{\DeclareCaptionJustification}
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\Justification}
You can define your own caption justifications with
\begin{quote}
- |\DeclareCaptionJustification|\marg{name}\marg{code}\quad.
+ |\DeclareCaptionJustification|\marg{name}\marg{code}\mbox{\quad.}
\end{quote}
The \meta{code} simply gets typeset just before the caption.
E.g.~using the justification |raggedright|, which is defined as
\begin{quote}
- |\DeclareCaptionJustification{raggedright}{\raggedright}|\quad,
+ |\DeclareCaptionJustification{raggedright}{\raggedright}|\mbox{\quad,}
\end{quote}
-lets captions with all lines moved to the left margin.
+typesets captions with all lines moved to the left margin.
+
+\bigskip
+\pagebreak[3]
\DescribeMacro{\DeclareCaptionFont}
You can define your own caption fonts with
\begin{quote}
@@ -1281,10 +1819,13 @@ you can get the same result simply with
| textfont={color=green}}|\quad.
\end{quote}
+\medskip
+
+\pagebreak[3]
\DescribeMacro{\DeclareCaptionStyle}
You can define your own caption styles with
\begin{quote}
- |\DeclareCaptionStyle|\marg{name}\oarg{additional options}\marg{options}
+ |\DeclareCaptionStyle|\marg{name}\oarg{additional options}\marg{options}\mbox{\quad.}
\end{quote}
Remember, caption styles are just a collection of suitable options, saved
under a given name. You can wake up these options at any time with the
@@ -1302,12 +1843,92 @@ Again a very easy example taken from the core of this package: The
caption style |base| is pre-defined as
\begin{quote}
|\DeclareCaptionStyle{base}%|\\
- | [justification=centering,indention=0pt]{}|\quad.
+ | [justification=centering,indention=0pt]{}|\quad.
\end{quote}
+Something more exciting:
+\begin{quote}
+ |\DeclareCaptionStyle{mystyle}%|\\
+ | [margin=5mm,justification=centering]%|\\
+ | {font=footnotesize,labelfont=sc,margin={10mm,0mm}}|\\
+ |\captionsetup{style=mystyle}|
+\end{quote}
+gives you caption like these ones:
+\begin{Example}
+ \captionsetup{type=figure,style=mystyle,position=b}
+ \caption{A short caption.}
+ \caption{A long long long long long long long long long
+ long long long long long long long long long
+ long long long long long long long long long caption.}
+\end{Example}
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaption-\\ListFormat}\NEWfeature{v3.1}
+You can define your own caption list formats with
+\begin{quote}
+ |\DeclareCaptionListFormat|\marg{name}\marg{code using \#1 and \#2}\mbox{\quad.}
+\end{quote}
+At usage \#1 gets replaced with the label prefix (e.g.~|\p@figure|) and \#2
+gets replaced with the reference number (e.g.~|\thefigure|).
+
+\bigskip
+
+\pagebreak[3]
+\DescribeMacro{\DeclareCaptionType}\NEWfeature{v3.1f}
+You can define your own floating environments \& caption types with
+\begin{quote}
+ |\DeclareCaptionType|\oarg{options}\marg{type}\oarg{name}\oarg{list name}
+\end{quote}
+where \meta{options} are one or more of
+\begin{quote}\begin{tabular}{r@{}l@{\qquad}l}
+ |fileext=| & \meta{file extension}
+ & {\small(e.g.~|fileext=lod|)}\\
+% |listname=|\meta{list name}\\
+% |name=|\meta{prosa name}\\
+ |placement=| & \meta{combination of \,\purett{htbp}}
+ & {\small(e.g.~|placement=tbp|)}\\
+ |within=| & \meta{``within'' counter} \emph{or} \texttt{none}\quad.
+ & {\small(e.g.~|within=section|)}
+\end{tabular}\end{quote}
+If no \meta{options} are given, ``lo\meta{type}'' will be used as \meta{file
+extension} for the list, ``|tbp|'' as \meta{placement} specifier,
+and ``|chapter|'' resp. ``|none|'' as \meta{``within'' counter},
+i.e., the counter which resets the numbering.
+(If ``|none|'' was specified as value, the numbering of the new
+type will be continuous throughout the document.)
+
+If no \meta{name} is given, the name of the newly created type will be set
+to \meta{type}, but with an uppercase first letter.
+If no \meta{list name} is given, the list name will be set to ``List of
+\meta{name}s''.
+
+The list will be typeset using the command |\listof|\meta{type}|s|.
+If the \package{fltpage} package is loaded, an environment called
+|FP|\meta{type} will be defined, same for |sideways|\meta{type}
+(\package{rotating} package), |SC|\meta{type} (\package{sidecap} package),
+and |wrap|\meta{type} (\package{wrapfig} package).
+
+\smallskip
+
+So for example
+\begin{quote}
+ |\DeclareCaptionType{diagram}|
+\end{quote}
+will define a new caption type and floating environment called |diagram|,
+the list will be stored in a file with the extension |lodiagram|, the name
+(used for the caption) will be ``|Diagram|'' and the list name
+``|List of Diagrams|''. The list could be typeset with |\listofdiagrams|.
+Dependent on which packages are loaded, the environments |FPdiagram|,
+|sidewaysdiagram|, |SCdiagram|, and |wrapdiagram| will be defined additionally.
+
% --------------------------------------------------------------------------- %
-\subsection{Further Examples}
+\subsection{Further examples}
+\label{examples}
+
+\subsubsection*{Example 1}
%\NEWdescription{v3.1}
If you would like to have a line break between caption label and text
@@ -1318,7 +1939,7 @@ you could define it this way:
If you select this format with |\captionsetup{format=myformat}|
you get captions like this:
%\begin{Example}
-% \captionsetup{aboveskip=0pt}
+% \captionsetup{skip=0pt}
\example{format=myformat1,labelfont=bf}{\exampletext}
%\end{Example}
You could even use an indention with this caption format:
@@ -1327,7 +1948,7 @@ You could even use an indention with this caption format:
\end{quote}
This would look like this:
%\begin{Example}
-% \captionsetup{aboveskip=0pt}
+% \captionsetup{skip=0pt}
\example{format=myformat1,indention=1cm,labelfont=bf}{\exampletext}
%\end{Example}
Instead, you would like to have an indention only of the first line of
@@ -1342,7 +1963,7 @@ the caption text? No problem, e.g.
\end{quote}
would give you captions like
%\begin{Example}
-% \captionsetup{aboveskip=0pt}
+% \captionsetup{skip=0pt}
\example{format=myformat2,myindention=1cm,labelfont=bf}{\exampletext}
%\end{Example}
But you want to have an caption option for this indention, so you can use
@@ -1359,40 +1980,87 @@ This could be done, too:
\end{quote}
would give the same result as the example above.
-\bigskip\pagebreak[3]
+\subsubsection*{Example 2}
-A different example: You want captions to look like this:
+You want captions to look like this:
%\begin{Example}
-% \captionsetup{aboveskip=0pt}
+% \captionsetup{skip=0pt}
\example{format=reverse,labelformat=fullparens,labelsep=fill,labelfont=it}{\exampletext}
%\end{Example}
\pagebreak[2]
You could do it this way:
\nopagebreak[3]
-{\leftmargini=10pt
- \begin{quote}
- |\DeclareCaptionFormat{reverse}{#3#2#1}|\\
- |\DeclareCaptionLabelFormat{fullparens}%|\\
- | {(\bothIfFirst{#1}{~}#2)}|\\
- |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\
- |\captionsetup{format=reverse,labelformat=fullparens,|\\
- | labelsep=fill,font=small,labelfont=it}|
- \end{quote}}
-
-\bigskip\pagebreak[3]
-
-Another example: The caption text should go into the left margin; a possible
-solution would be:
-{\leftmargini=10pt
- \begin{quote}
- |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\
- |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}|
- \end{quote}}
+\begin{quote}
+ |\DeclareCaptionFormat{reverse}{#3#2#1}|\\
+ |\DeclareCaptionLabelFormat{fullparens}%|\\
+ | {(\bothIfFirst{#1}{~}#2)}|\\
+ |\DeclareCaptionLabelSeparator{fill}{\hfill}|\\
+ |\captionsetup{format=reverse,labelformat=fullparens,|\\
+ | labelsep=fill,font=small,labelfont=it}|
+\end{quote}
+
+\subsubsection*{Example 3}
+
+The caption text should go into the left margin? A possible solution would be:
+\begin{quote}
+ |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\
+ |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}|
+\end{quote}
As a result you would get captions like this:
-%\begin{Example}
-% \captionsetup{aboveskip=0pt}
- \example{format=llap,labelsep=quad,singlelinecheck=no,margin=0pt}{\exampletext}
-%\end{Example}
+\example{format=llap,labelsep=quad,singlelinecheck=no,margin=0pt}{\exampletext}
+
+\medskip
+
+If the indention into the margin shall be fixed, you could use a combination
+of |\llap| and |\makebox|, for example:
+\begin{quote}
+ |\DeclareCaptionFormat{llapx}%|\\
+ | {\llap{\makebox[5em][l]{#1}}#3\par}|\\
+ |\captionsetup{format=llapx,singlelinecheck=off}|
+\end{quote}
+\example{format=llapx,singlelinecheck=off,skip=0pt,margin=0pt}{\exampletext}
+
+\subsubsection*{Example 4}
+
+This example puts a figure aside a table, but uses only one common caption for both.
+This will be achieved by a combination of
+|\Declare|\x|Caption|\x|Label|\x|Format| and |\caption|\x|list|\x|entry|:
+\begin{quote}
+ |\DeclareCaptionLabelFormat{andtable}%|\\
+ | {#1~#2 \& \tablename~\thetable}|\\
+ \ldots\\
+ |\begin{figure}|\\
+ | \centering|\\
+ | \includegraphics{|\ldots|}%|\\
+ | \qquad|\\
+ | \begin{tabular}[b]{\ldots}|\\
+ | |\ldots\\
+ | \end{tabular}|\\
+ | \captionlistentry[table]{|\ldots|}|\\
+ | \captionsetup{labelformat=andtable}|\\
+ | \caption{|\ldots|}|\\
+ |\end{figure}|
+\end{quote}
+\DeleteShortVerb{\|}%
+\noindent\begin{minipage}{\linewidth}
+ \captionsetup{type=figure}
+ \centering
+ \includegraphics[width=30pt]{cat}%
+ \qquad
+ \begin{tabular}[b]{r|rr}
+ & x & y \\\hline
+ a & 1 & 2 \\
+ b & 3 & 4 \\
+ \end{tabular}
+ \captionlistentry[table]{A figure and a table with a common caption}
+ \captionsetup{labelformat=andtable}
+ \caption{A figure and a table with a common caption~\footnotemark}
+\end{minipage}
+\footnotetext{The picture was taken with permission from the
+ \LaTeX\ Companion\cite{TLC2} examples.}
+\MakeShortVerb{\|}
+
+\vfill
% --------------------------------------------------------------------------- %
@@ -1405,7 +2073,9 @@ As a result you would get captions like this:
commands for customizing captions. If these possibilities are sufficient for
you, there is usually no need for you to use the \package{caption} package
at all. And if you are just interested in using the command \cs{captionof},
-loading of the very small \package{capt-of} is usually sufficient.}
+loading of the very small \package{capt-of} package is usually sufficient.}
+
+\medskip
This section will give you an overview of the document classes the
\package{caption} supports, what do they already offer regarding captions,
@@ -1421,8 +2091,8 @@ with different document classes.
\DANGER
If you don't find the document class you use in this section, you usually
don't have to worry: Many document classes are derived from one of the
-standard document classes |article|, |report|, or |book|, and behave the
-same regarding captions.
+standard document classes \class{article}, \class{report}, or \class{book},
+and behave the same regarding captions.
\Thispackage\ automatically does a compatibility check against the document
class used and will give you a clear warning if a incompatibility was detected.
If you don't get such warning everything is fine, but if you get it the usage of
@@ -1484,7 +2154,7 @@ If you want to use a common margin for both, insert |\clearcaptionsetup[margin*]
into the preamble of your document, after loading \thispackage.
Additionally the options |figureposition=b,tableposition=t| will be set.
-You can override these settings by specifing other values for
+You can override these settings by specifying other values for
|figureposition=| or |tableposition=| in the option list while loading \thispackage.
\subsection{beamer}
@@ -1496,8 +2166,8 @@ You can override these settings by specifing other values for
|labelformat=| & \textit{not numbered} \\
|labelsep=| & |colon| \\
|justification=| & |raggedright| \\
-|font=| & \use\ \package{beamer} |caption| \settings \\
-|labelfont=| & \use\ \package{beamer} |caption name| \settings \\
+|font=| & \use\ \class{beamer} |caption| \settings \\
+|labelfont=| & \use\ \class{beamer} |caption name| \settings \\
|textfont=| & \nofont \\
\end{tabular}
@@ -1508,14 +2178,14 @@ You can setup font and color settings with
This will still work, unless you set a different font with
|\captionsetup|\xx|{font=|\xx\meta{options}|}| or
|\captionsetup|\xx|{labelfont=|\xx\meta{options}|}|.\par
-Furthermore the \package{beamer} classes offer different caption templates
-which can be choosen with
+Furthermore the \class{beamer} classes offer different caption templates
+which can be chosen with
|\set|\x|beamter|\x|template|\xx|{caption}|\xx|[|\meta{template}|]|.
Since \thispackage\ replaces this caption template mechanism,
|\def|\x|beamer|\x|template*|\xx|{caption}|\xx\marg{template code}
and
|\set|\x|beamer|\x|template|\xx|{caption}|\xx|[|\meta{template}|]|
-will have no function when \thispackage\ is used.
+will have no effect when \thispackage\ is used.
\subsection{\KOMAScript: scrartcl, scrreprt, and scrbook}
\label{KOMA}
@@ -1617,7 +2287,7 @@ or \package{frenchpro} package.
% --------------------------------------------------------------------------- %
\pagebreak[4]
-\section{Supported packages}
+\section{Package support}
\label{packages}
%\NEWdescription{v3.1}
@@ -1627,20 +2297,94 @@ captions, too:
\package{float}, \package{floatflt}, \package{fltpage},
\package{hyperref}, \package{hypcap}, \package{listings},
\package{longtable}, \package{picinpar}, \package{picins},
- \package{rotating}, \package{sidecap}, \package{subfigure},
- \package{supertabular}, \package{threeparttable}, and \package{wrapfig}
+ \package{rotating}, \package{setspace}, \package{sidecap},
+ \package{subfigure}, \package{supertabular}, \package{threeparttable},
+ and \package{wrapfig}
\end{quote}
Furthermore the \package{floatrow} and the \package{subfig} package
supports \thispackage\ and use its |\captionsetup| interface.
\newcommand\packagedescription[1]{%
+ \ifvmode\else\par\fi
\nopagebreak
- \parbox[b]{\linewidth}{\footnotesize\leftskip=10pt\rightskip=10pt\relax#1}%
+ \parbox[b]{\linewidth}{\footnotesize\leftskip=10pt\rightskip=10pt\relax#1}\par
\nopagebreak\smallskip\nopagebreak}
\newcommand\Note{\smallskip\emph{Note:}~}
\pagebreak[3]
+\subsection{algorithms}
+\label{algorithms}
+\packagedescription{%
+The \package{algorithms} bundle\cite{algorithms} provides two environments:
+The \texttt{algorithmic} environment provides an environment for describing
+algorithms, and the \texttt{algorithm} environment provides a ``float''
+wrapper for algorithms.}
+
+Since the \texttt{algorithm} environment is implemented via |\newfloat|
+provided by the \package{float} package\cite{float}, please see \Ref{float}.
+
+\iffalse
+\pagebreak[3]
+\subsection{algorithm2e}
+\label{algorithm2e}
+\packagedescription{%
+The \package{algorithm2e} package\cite{algorithm2e} offers an environment for
+writing algorithms in LaTeX2e.}
+
+Since the \package{algorithm2e} package does not use some kind of standard
+interface for defining its floating environment (e.g.~|\newfloat| of the
+\package{float} package) and typesetting its caption,
+this package is \emph{not} supported by \thispackage, and never will be.
+Unfortunately it does not offer a simple, non-floating environment, too.
+But you can define it on your own, for example:
+\begin{quote}
+ |\usepackage{algorithm2e}|\\
+ |% save the "algorithm" environment from the algorithm2e package|\\
+ |\let\ORIGalgorithm\algorithm|\\
+ |\let\ORIGendalgorithm\endalgorithm|\\
+ |% define the algorithmic environment|\\ % , based on the saved environment
+ |\newenvironment{algorithmic}%|\\
+ | {\renewenvironment{algocf}[1][h]{}{}% pass over floating stuff|\\
+ | \ORIGalgorithm}%|\\
+ | {\ORIGendalgorithm}|\\
+ \ldots
+\end{quote}
+Having defined this non-floating \texttt{algorithmic} environment,
+you can define your own new floating environment with |\newfloat| of the
+\package{float} package (or |\DeclareNewFloatType| of the \package{floatrow}
+package), and use the combination of this floating environment
+and \texttt{algorithmic} in its body, just like you would do when you use the
+\package{algorithm}/\package{algorithmic} package tandem.
+
+You could even use the \package{algorithm} package for this purpose, for example:
+\begin{quote}
+ \ldots\\
+ |% load the algorithm package to re-define the|\\
+ |% floating environment "algorithm" and \listofalgorithms|\\
+ |\let\listofalgorithms\undefined|\\
+ |\usepackage{algorithm}|\\
+ \ldots\\
+ |% Example usage:|\\
+ |\begin{algorithm}|\\
+ |\caption{An algorithm}|\\
+ |\begin{algorithmic}|\\
+ | \SetVline|\\
+ | \eIf{cond1}{|\\
+ | a line\;|\\
+ | }{|\\
+ | another line\;|\\
+ | }|\\
+ |\end{algorithmic}|
+\end{quote}
+Now you are finally able to customize the float and caption layout like every
+other floating environment defined with the \package{float} package\cite{float},
+please see \Ref{float}.
+
+%{\small(An alternative would be using the \package{algorithmicx} package.)}
+\fi
+
+\pagebreak[3]
\subsection{float}
\label{float}
\packagedescription{%
@@ -1651,7 +2395,7 @@ It also provides the \texttt{H} float placement option of the obsolete
\package{here} package.}
For floating environments defined with \cs{newfloat} or \cs{restylefloat} the
-|position| option has no effect on the main caption anymore, since its
+|po|\x|si|\x|tion| option has no effect on the main caption anymore, since its
placement and spacing will be controlled by the selected float style instead.
Furthermore a caption style and options defined with the name of the float
@@ -1659,11 +2403,12 @@ style will be executed additionally to the regular ones.
Using this mechanism \thispackage\ emulates the default look \& feel of the
|ruled| captions: It defines the caption style
\begin{quote}
- |\DeclareCaptionStyle{ruled}{labelfont=bf,labelsep=space,|\\
- | strut=off}|~.
+ |\DeclareCaptionStyle{ruled}%|\\
+ | {labelfont=bf,labelsep=space,strut=off}|\mbox{\quad.}
\end{quote}
So to change this you need either define your own caption style called
-|ruled| or use |\captionsetup[ruled]|\marg{options}.%,
+|ruled| or use |\captionsetup[ruled]|\marg{options} to specify additional
+options.%,
%e.g.~|\captionsetup[ruled]{labelsep=colon}|.
Also by using this mechanism the skip between a |boxed| float and its caption
@@ -1671,22 +2416,23 @@ is specified, overriding its global value:
\begin{quote}
|\captionsetup[boxed]{skip=2pt}|
\end{quote}
-For changing this just use |\captionsetup[boxed]{skip=|\meta{value}|}|
+For changing this, just use |\captionsetup[boxed]{skip=|\meta{value}|}|
with an appropriate value. Or if you want to use the global |skip| setting
-instead you can remove the usage of the local setting for these floats with
+instead, you can remove the usage of the local setting for these floats with
|\clearcaptionsetup[skip]{boxed}|.
\Note
Only one single caption can be typeset inside environments defined with
-\cs{newfloat} or \cs{restylefloat}, futhermore these environments are not
-behaving exactly like the pre-defined floats |figure| \& |table|.
-As a consequence many packages do not coorperate well with these.
+|\new|\x|float| or |\re|\x|style|\x|float|, furthermore these environments
+are not behaving exactly like the pre-defined floats |figure| \& |table|.
+As a consequence many packages do not cooperate well with these.
Furthermore the float package has some caveats \& limitations, so if you
just want to define a new simple floating environment---behaving like
-|figure| or |table|---I recommend using \cs{DeclareFloatingEnvironment}
+|figure| or |table|---I recommend using \cs{DeclareCaptionType}
instead.
And for defining non-simple floating environments and customization I
-recommend using the \package{floatrow} package\cite{floatrow} instead.
+recommend using |\DeclareNewFloatType| offered by the \package{floatrow}
+package\cite{floatrow}.
\iffalse
Please also note that you \emph{don't} need a |\restylefloat| for using
@@ -1750,7 +2496,7 @@ environments you can use
These options will be executed additionally to the regular ones for
|figure| or |table|.
-Furthermore \cs{DefineFloatingEnvironment}\marg{name} will also define
+Furthermore \cs{DeclareCaptionType}\marg{name} will also define
an environment called |FP|\meta{name} which behaves like |FPfigure| and
|FPtable|.
@@ -1788,7 +2534,7 @@ would be set.
\pagebreak[3]Please note:\nopagebreak
\begin{description}
\item{\cs{captionof}\marg{type}\csmarg\ldots\ vs.
- \cs{captionsetup}\csmarg{type=\meta{type}}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
+ \cs{captionsetup}\csmarg{type=\textrm{\meta{type}}}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
Without \package{hyperref} loaded, both will give you identical results.
But with \package{hyperref} loaded, and with |hypcap=true| requested, the
hyperlink anchor will be placed different.
@@ -1814,14 +2560,14 @@ since |\caption|\x|setup|\xx|{type=|\xx|figure}| does not only set the caption t
to ``figure'' but does place a hyperlink anchor, too.
\item{\cs{caption}\csoarg{}\csmarg\ldots\ vs.
- \cs{captionsetup}\csmarg{listof=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
+ \cs{captionsetup}\csmarg{list=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
Again, without \package{hyperref} loaded, both will give you identical results.
But with \package{hyperref} loaded, the difference is in the nuances.
So for example the optional argument of \cs{caption} will also be written to
the |aux| file, and will be used by the \cs{nameref} command.
So if you choose to use \cs{caption} with empty optional argument,
\cs{nameref} will also give you an empty result.
-So it's better to use \cs{captionsetup}\csmarg{listof=false} if you don't
+So it's better to use \cs{captionsetup}\csmarg{list=false} if you don't
want an entry in the List of Figures or List of Tables.
\end{description}
@@ -1830,8 +2576,8 @@ want an entry in the List of Figures or List of Tables.
\label{hypcap}
\packagedescription{%
The \package{hypcap} package\cite{hypcap} offers a solution to the problem
-that links to a float using hyperref may anchors to the caption rather than
-the beginning of the float.
+that links to a float using \package{hyperref} may anchors to the caption
+rather than the beginning of the float.
Since \thispackage\ \version{3.1} already solves this problem for itself,
the \package{hypcap} package is usually not needed, at least when you use
\thispackage.}
@@ -1844,7 +2590,7 @@ So for a manual placement of hyperlink anchors |\captionsetup{type=|\meta{type}|
is not sufficient anymore, instead you need to use |\capstart|
(provided by the \package{hypcap} package) for this.
-Regarding the automatical placement the \package{hypcap} package offers good
+Regarding the automatically placement the \package{hypcap} package offers good
placement of hyperlink anchors for the floating environments |figure| and
|table| only. In contrast the |hypcap=true| option of \thispackage\ also
offers good placements of hyperlink anchors for
@@ -1898,7 +2644,9 @@ to a value different than |4in|.)
\cs{captionof} and \cs{ContinuedFloat} do not work for |longtable|s.
\NEWfeature{v3.1}
If you need a |longtable| which does not increment the |table| counter
-please use the |longtable*| environment offered by \thispackage.
+please use the |longtable*| environment offered by the \package{ltcaption}
+package which is part of \thispackage\ bundle and will be loaded
+automatically.
\pagebreak[3]
\subsection{picinpar}
@@ -1989,11 +2737,25 @@ The command \cs{rotcaption} will be extended by \thispackage, so
|\captionof|.
\NEWfeature{v3.1}
-Furthermore \cs{DefineFloatingEnvironment}\marg{name} will also define
+Furthermore \cs{DeclareCaptionType}\marg{name} will also define
an environment called |sideways|\meta{name} which behaves like
|sideways|\x|figure| and |sideways|\x|table|.
\pagebreak[3]
+\subsection{setspace}
+\label{setspace}
+\packagedescription{%
+The \package{setspace} package\cite{setspace} offers options and commands
+to change the spacing,
+e.g.\ \cs{usepackage}\xx\csoarg{one\x half\x spacing}\xx\csmarg{set\x space}
+causes the document to be typeset in one-and-a-half spacing.}
+
+If the \package{setspace} package is used in conjunction with \thispackage,
+the caption will be typeset with single spacing as default. This can be changed
+by specifying either |font=onehalfspacing|, |font=doublespacing|, or
+|font={stretch=|\meta{amount}|}|. \See{\Ref{fonts}}
+
+\pagebreak[3]
\subsection{sidecap}
\label{sidecap}
\packagedescription{%
@@ -2010,23 +2772,50 @@ environments you can use
These options will be executed additionally to the regular ones for
|figure| or |table|.
+\pagebreak[3]
\NEWfeature{v3.1}
-Furthermore \cs{DefineFloatingEnvironment}\marg{name} will also define
+Furthermore \cs{DeclareCaptionType}\marg{name} will also define
an environment called |SC|\meta{name} which behaves like |SCfigure| and
|SCtable|.
+\pagebreak[3]
\Note
The \package{sidecap} package offers its own options for justification.
If set, they will override the one specified with the caption option
|justification=| for captions beside their contents.
+\pagebreak[3]
\Note
The |margin| resp.~|width| setting will not be used for these figures \& tables,
unless you set it explicit with |\captionsetup|\xx|[SCfigure]|\xx|{|\ldots|}|
or |\captionsetup|\xx|[SCtable]|\xx|{|\ldots|}|.
\medskip{\small(Instead of using the \package{sidecap} package you can also use
-the \package{floatrow} package\cite{floatrow} for this purpose.)}
+the more powerful \package{floatrow} package\cite{floatrow} for this purpose.)}
+
+\pagebreak[3]
+\subsubsection*{Undocumented features}
+The \package{sidecap} package \version{1.6} has some undocumented package
+options and commands which allow further customization of the side-captions:
+
+\pagebreak[3]
+\DescribeMacro{margincaption}
+The package option
+\begin{quote}
+ |margincaption|\qquad{\small(e.g.~|\usepackage[margincaption]{sidecap}|)}
+\end{quote}
+causes all side-captions to be placed into the margin.
+
+\pagebreak[3]
+\DescribeMacro{\sidecaptionvpos}
+The command
+\begin{quote}
+ |\sidecaptionvpos|\marg{float type}\marg{pos}
+\end{quote}
+sets the vertical position of the side-caption. \meta{pos} can be either `|t|'
+(for top alignment), `|b|' (for bottom alignment), or `|c|' (for center alignment).
+The default setting for \env{table} is `|t|', for \env{figure} and all other
+ones defined with |\Declare|\x|Caption|\x|Type| it's `|b|'.
\pagebreak[3]
\subsection{subfigure}
@@ -2034,7 +2823,7 @@ the \package{floatrow} package\cite{floatrow} for this purpose.)}
\packagedescription{%
The \package{subfigure} package\cite{subfigure} provides support for small or
`sub' figures and tables within a single figure or table environment.
-This package is obsolete, new users should use subfig instead.}
+This package is obsolete, new users should use \package{subfig} instead.}
Since the \package{subfigure} package is obsolete it will only be supported in
a way that old documents (which have used \thispackage\ \version{1.x} during
@@ -2117,7 +2906,7 @@ environments you can use
These options will be executed additionally to the regular ones for
|figure| or |table|.
-Furthermore \cs{DefineFloatingEnvironment}\marg{name} will also define
+Furthermore \cs{DeclareCaptionType}\marg{name} will also define
an environment called |wrap|\meta{name} which behaves like |wrapfigure| and
|wraptable|.
@@ -2135,6 +2924,51 @@ commands \emph{must} be placed after \emph{both} packages have been loaded.
% --------------------------------------------------------------------------- %
\pagebreak[4]
+\section{History}
+\label{history}
+
+The version $1.0$ was written in 1994 and was offering a handful of options
+to customize the look \& feel of the captions. Version $1.2$ added the
+support of the \package{float} package.
+(The other versions $1.x$ were mainly bugfix-releases.)
+
+The \package{caption2} package $2.0$ was an experimental side-version of
+the regular \package{caption} package. It was made public as beta test version
+without proper documentation in 1995 because of the strong demand for new
+features and adaptations to additional packages like the \package{longtable}
+package.
+Furthermore it offered a revised support of the \package{subfigure} package.
+(A version $2.1$ was offered as bugfix-release in 2002.)
+
+In 2003 I finally found some time, so a new regular release $3.0$
+of the \package{caption} package could be build in cooperation with
+Frank Mittelbach and Steven Cochran.
+It was released in December 2003 and superseded the neglected
+\package{caption2} package.
+Main parts were re-written and it provided a complete re-work of
+the user interface.
+Furthermore it supported the \package{hyperref}, \package{hypcap},
+\package{listings}, \package{sidecap}, and \package{supertabular} packages
+additionally.
+
+While all the previous versions were designed for usage with the standard
+\LaTeX\ document classes \class{article}, \class{report}, and \class{book},
+the current version $3.1$ released in 2007 also supports the \AmS,
+\KOMAScript, \NTG, and \SmF\ document classes, and the \class{beamer} class
+as well.
+Furthermore it was adapted to the \package{frenchb} Babel option,
+the \package{frenchle} \& \package{frenchpro} packages,
+and the \package{floatflt}, \package{fltpage}, \package{picinpar},
+\package{picins}, \package{setspace}, \package{threeparttable},
+and \package{wrapfig} packages.
+New commands and options were introduced as well, for example
+|\caption|\x|list|\x|entry|, |\Declare|\x|Caption|\x|List|\x|Format|,
+|\Declare|\x|Caption|\x|Type|, \opt{figurewithin=} \& \opt{tablewithin=},
+\opt{list=} \& \opt{listformat=}, and \opt{maxmargin=} \& \opt{minmargin=}.
+Another benefit are the new hypcap and sub-caption features.
+\See{\Ref{hyperref} and the \package{subcaption} package documentation}
+
+\pagebreak[4]
\section{Compatibility to older versions}
\label{compatibility}
@@ -2230,7 +3064,7 @@ resp.
\begin{quote}
|\captionsetup[ruled]{|\ldots|}|\qquad.
\end{quote}
-\SeeUserDefined[, \Ref{commands}, and \Ref{float}]
+\SeeUserDefined[, \Ref{captionsetup}, and \Ref{float}]
\subsection{caption2 v\texorpdfstring{$2.x$}{2.x}}
\label{caption2}
@@ -2328,7 +3162,8 @@ default one which is |4in|).
%\NEWdescription{v3.1}
\Thispackage\ \version{3.0} did not support any document classes
-other than the standard \LaTeX\ ones: |article|, |report|, and |book|.
+other than the standard \LaTeX\ ones: \class{article}, \class{report},
+and \class{book}.
Therefore the default settings used to be fixed, but now \thispackage{}
supports more classes, therefore they are now set in dependence on the
document class used.
@@ -2336,7 +3171,7 @@ document class used.
For example: While in \version{3.0} the default caption |justification| used
to be always |justified|, it's now still |justified| when using one of the
standard document classes, but |raggedright| will be used as default format
-when when used with the \package{beamer} document class.
+when when used with the \class{beamer} document class.
%An easy way to select the `old' defaults---if desired---is using the option
An easy way to select the `old' defaults is using the option
@@ -2354,6 +3189,16 @@ happen, but not that they actually will happen.
Anyway, if you use \thispackage\ in such circumstances,
you should use it with care.
+\bigskip
+
+\emph{Note:} The option |caption=false|, which used to be a workaround for
+not using the whole \package{caption} package (leaving the caption stuff
+offered by the document class or other packages intact), but keeping the
+\package{subfig} package working. This mechanism is obsolete and not offered
+anymore, please pass this option to the \package{subfig} package instead and
+do not load \thispackage\ anymore.
+%\par\See{the \package{subfig} package\cite{subfig} documentation}
+
% --------------------------------------------------------------------------- %
\pagebreak[4]
@@ -2393,20 +3238,20 @@ Command & & Section \\
\hline
\endhead
|\abovecaptionskip| & & \ref{skips} \\
-%|\AtBeginCaption| & & \ref{x} \\
-%|\AtEndCaption| & & \ref{x} \\
+%|\AtBeginCaption| & & \ref{hooks} \\
+%|\AtEndCaption| & & \ref{hooks} \\
|\belowcaptionskip| & & \ref{skips} \\
-|\caption| & & \ref{commands} \\
-|\caption*| & & \ref{commands} \\
-|\captionbox| & & \ref{x} \\
-|\captionof| & & \ref{commands} \\
-|\captionof*| & & \ref{commands} \\
-|\captionsetup| & & \ref{commands} \\
-|\captionsetup*| & & \ref{commands} \\
+|\caption| & & \ref{caption} \\
+|\caption*| & & \ref{caption} \\
+|\captionlistentry| & & \ref{captionlistentry} \\
+|\captionof| & & \ref{caption} \\
+|\captionof*| & & \ref{caption} \\
+|\captionsetup| & & \ref{captionsetup} \\
+|\captionsetup*| & & \ref{captionsetup} \\
|\centerfirst| & & \ref{justification} \\
|\centerlast| & & \ref{justification} \\
-|\clearcaptionsetup| & & \ref{commands} \\
-|\clearcaptionsetup*| & & \ref{commands} \\
+|\clearcaptionsetup| & & \ref{captionsetup} \\
+|\clearcaptionsetup*| & & \ref{captionsetup} \\
|\ContinuedFloat| & & \ref{ContinuedFloat} \\
|\DeclareCaptionFont| & & \ref{declare} \\
|\DeclareCaptionFormat| & & \ref{declare} \\
@@ -2415,18 +3260,30 @@ Command & & Section \\
|\DeclareCaptionLabelFormat| & & \ref{declare} \\
|\DeclareCaptionLabelSeparator| & & \ref{declare} \\
|\DeclareCaptionLabelSeparator*| & & \ref{declare} \\
-|\DeclareCaptionListOfFormat| & & \ref{declare} \\
+|\DeclareCaptionListFormat| & & \ref{declare} \\
|\DeclareCaptionOption| & & \ref{declare} \\
|\DeclareCaptionStyle| & & \ref{declare} \\
+|\DeclareCaptionSubType| & & --~\footnotemark \\
|\DeclareCaptionTextFormat| & & \ref{declare} \\
-|\DeclareFloatingEnvironment| & & \ref{DeclareFloatingEnvironment} \\
-|\showcaptionsetup| & & \ref{commands} \\
+|\DeclareCaptionType| & & \ref{declare} \\
+|\showcaptionsetup| & & \ref{captionsetup} \\
\end{longtable}
+\footnotetext{\cs{DeclareCaptionSubType} is explained in the
+ \package{subcaption} package documentation.}
-\pagebreak[4]
+\vfill\pagebreak[4]
\subsection{Options}
-\newcommand\preambleoption{ \footnotemark[1]}
+\newcommand\preambleoption{~%
+ \begingroup\def\thefootnote{\fnsymbol{footnote}}%
+ \footnotemark[2]%
+ \endgroup}
+\newcommand\preambleoptiontext{%
+ \begingroup\def\thefootnote{\fnsymbol{footnote}}%
+ \footnotetext[2]{These options are only available in the preamble of the document.}%
+ \endgroup}
+\begingroup
+\small
\begin{longtable}{lll}
Option & Short description & Section \\
\hline
@@ -2435,8 +3292,9 @@ Option & Short description & Section \\
|belowskip| & sets the skip below caption & \ref{skips} \\
|compatibility|\preambleoption & force (non-)compatibility & \ref{classes} \\
%|config| & & \ref{x} \\
-|figurename|\preambleoption & sets the figure name & \ref{x} \\
+|figurename|\preambleoption & sets the figure name & \ref{names} \\
|figureposition|\preambleoption & gives a hint about the figure caption position & \ref{skips} \\
+|figurewithin|\preambleoption & sets the figure ``within'' counter & \ref{numbering} \\
|font| & sets the font & \ref{fonts} \\
|format| & sets the format & \ref{formats} \\
|FPlist| & to where the list entry of a FPfigure should link? & \ref{fltpage} \\
@@ -2450,13 +3308,15 @@ Option & Short description & Section \\
|labelformat| & sets the format of the caption label & \ref{formats} \\
|labelsep| & sets the label separator & \ref{formats} \\
|labelseparator| & sets the label separator & \ref{formats} \\
-|listof| & switches the entries in the `List of' on or off & \ref{listof} \\
-|listofformat| & sets the `List of' entry format & \ref{listof} \\
+|list| & switches the entries in the `List of' on or off & \ref{lists} \\
+|listformat| & sets the `List of' entry format & \ref{lists} \\
|margin| & sets the margin & \ref{margins} \\
|margin*| & sets the margin, but only if no width is set & \ref{margins} \\
|maxmargin| & sets the max. margin & \ref{margins} \\
|minmargin| & sets the min. margin & \ref{margins} \\
-|options| & executes the given option list & \ref{x} \\
+|name| & sets the name of the current environment & \ref{names} \\
+|oneside| & selects the one-side mode & \ref{margins} \\
+%|options| & executes the given option list & \ref{x} \\
|parindent| & sets the paragraph indention & \ref{margins} \\
|parskip| & sets the skip between paragraphs & \ref{margins} \\
|position| & gives a hint about the caption position & \ref{skips} \\
@@ -2465,40 +3325,56 @@ Option & Short description & Section \\
|skip| & sets the skip between content \& caption & \ref{skips} \\
|strut| & switches the usage of |\strut|s on or off & \ref{formats} \\
|style| & sets the caption style & \ref{style} \\
-|tablename|\preambleoption & sets the table name & \ref{x} \\
+|subtype| & sets the sub-caption type & \phantom{t}--~\footnotemark \\
+|tablename|\preambleoption & sets the table name & \ref{names} \\
|tableposition|\preambleoption & gives a hint about the table caption position & \ref{skips} \\
+|tablewithin|\preambleoption & sets the table ``within'' counter & \ref{numbering} \\
|textfont| & sets the font of the caption text & \ref{fonts} \\
|textformat| & sets the format of the caption text & \ref{formats} \\
-|twoside| & selects the two-side mode & \ref{x} \\
-|type| & sets the caption type \& places a hyperlink anchor & \ref{x} \\
-|type*| & sets the caption type only & \ref{x} \\
+|twoside| & selects the two-side mode & \ref{margins} \\
+|type| & sets the caption type \& places a hyperlink anchor & \ref{types} \\
+|type*| & sets the caption type only & \ref{types} \\
|width| & sets a fixed caption width & \ref{margins} \\
\end{longtable}
-\footnotetext[1]{These options are only available in the preamble of the document.}
+\endgroup
+\preambleoptiontext
+\footnotetext{The option \opt{subtype} is explained in the
+ \package{subcaption} package documentation.}
\nopagebreak\parbox[t]{\linewidth}{\small\emph{Note:}
- Obsolete options are not listed here. See\\
- \hspace*{1em}\Ref{caption1} and\\
- \hspace*{1em}\Ref{caption2} for a list of these options.}
+ Obsolete options are not listed here. See
+ \Ref{caption1} and
+ \Ref{caption2} for a list of these options.}
-\pagebreak[4]
+\vfill\pagebreak[4]
\subsection{Warnings}
\begin{Warnings}
\Message
+ |\caption outside box or environment.|
+\Or
+ |\captionsetup{type=...} outside box or environment.|
+\Or
+ |\captionsetup{type*=...} or \captionof outside box or environment.|
+\Description
+ You have placed a |\caption|, |\caption|\x|of|, or
+ |\caption|\x|setup{type=|\xx\meta{type}|}| command outside an box, group,
+ or environment.
+ You should not do this since it could cause some bad side-effects.
+ \par\See{\Ref{types} and \Ref{caption}}
+
+\Message
|\caption will not be redefined since it's already|\\
|redefined by a document class or package which is|\\
- |unknown to the caption package.|\\
- |As a result some features will not work as expected.|
+ |unknown to the caption package.|
\Description
- If \thispackage\ detects that some (unknown) documentclass or
+ If \thispackage\ detects that some (unknown) document class or
package has enhanced |\caption|, it will not redefine
|\caption|, too, since this would simply kill the enhancement.
As a result some features, like |\caption*|, |\ContinuedFloat|,
using the optional argument of |\captionsetup|,
- or the options |listof=| \& |hypcap=| will be ignored or
- not work as expected.\par
+ or the options |list=| and |hypcap=| will not be available.\par
If you don't care about the original enhancements but would
like to use the full range of features of \thispackage\ instead
you can give the unsupported(!) option |compatibility=false|
@@ -2507,21 +3383,9 @@ Option & Short description & Section \\
\par\See{\Ref{classes}}
\Message
- |Caption type was already set to `|\meta{type}|'.|
-\Description
- This warning informs you about mixed caption options. For example if
- you use a |\captionof{table}{|\ldots|}| inside a |figure| environment,
- this would result in using both option sets for that specific caption,
- the ones for |figure| (specified with |\captionsetup[figure]{|\ldots|}|)
- and the one for |table| (specified with |\captionsetup[table]{|\ldots|}|)
- as well.
- \par\See{\Ref{commands}}
-
-\Message
|Forced redefinition of \caption since the|\\
|unsupported(!) package option `compatibility=false'|\\
- |was given. Please fasten your seat belts, as we may|\\
- |experience turbulence!|
+ |was given.|
\Description
Since you were so keen to specify the option |compatibility=false|
\thispackage\ will try to do its best to fulfill your wishes.
@@ -2534,7 +3398,7 @@ Option & Short description & Section \\
|Hyperref support is turned off because hyperref has|\\
|stopped early.|
\Description
- If the \package{hyperref} package stopps early during loading
+ If the \package{hyperref} package stops early during loading
(because of what-ever reason), the \package{hyperref} support of
\thispackage\ will not be available. As a result you could get
\package{hyperref} warnings and non-functional hyperlinks to figures
@@ -2553,7 +3417,7 @@ Option & Short description & Section \\
\Message
|Internal Warning: |\meta{warning message}|.|
\Description
-% \Thispackage\ can only set hyperanchors in \TeX s vertical mode.\par
+% \Thispackage\ can only set hyperlink anchors in \TeX s vertical mode.\par
You should never see this warning, either you use a package which redefines
|figure| or |table| and which is unknown to \thispackage, or this is a bug
in \thispackage.
@@ -2577,7 +3441,7 @@ Option & Short description & Section \\
get this warning. If this is not because of a typo and you would like
to suppress this warning, use |\clearcaptionsetup*| instead of
|\clearcaptionsetup|.
- \par\See{\Ref{commands}}
+ \par\See{\Ref{captionsetup}}
\Message
|Option list `|\meta{option list}|' undefined.|
@@ -2588,7 +3452,7 @@ Option & Short description & Section \\
get this warning. If this is not because of a typo and you would like
to suppress this warning, use |\clearcaptionsetup*| instead of
|\clearcaptionsetup|.
- \par\See{\Ref{commands}}
+ \par\See{\Ref{captionsetup}}
\iffalse
\Message
@@ -2640,6 +3504,17 @@ Option & Short description & Section \\
\par\See{\Ref{margins}}
\Message
+ |The caption type was already set to `|\meta{type}|'.|
+\Description
+ This warning informs you about mixed caption options. For example if
+ you use a |\captionof{table}{|\ldots|}| inside a |figure| environment,
+ this would result in using both option sets for that specific caption,
+ the ones for |figure| (specified with |\captionsetup[figure]{|\ldots|}|)
+ and the one for |table| (specified with |\captionsetup[table]{|\ldots|}|)
+ as well.
+ \par\See{\Ref{captionsetup}}
+
+\Message
|The option `hypcap=true' will be ignored for this|\\
|particular \caption.|
\Description
@@ -2651,7 +3526,7 @@ Option & Short description & Section \\
This can happen if you use |\captionof| inside a non-floating environment,
but also if you use some package which redefines |figure| or |table|, and
which is unknown to \thispackage.\par
- If this is ok for you but you want to supress this warning, simply place a
+ If this is ok for you but you want to suppress this warning, simply place a
|\captionsetup{|\xx|hypcap=|\xx|false}| just before the |\caption| or
|\captionof| command which is causing the warning.
If this is not ok for you you can try to set a hyperlink anchor with
@@ -2660,11 +3535,11 @@ Option & Short description & Section \\
\Message
|Unsupported document class (or package) detected,|\\
- |usage of the caption package is *not* recommended.|
+ |usage of the caption package is not recommended.|
\Description
Either the document class you use is unknown to \thispackage, or you
have included a package in your document which redefines |\@makecaption|
- (which is responsible for typeseting the caption) as well.
+ (which is responsible for typesetting the caption) as well.
This means \thispackage\ will either change the design of captions in an
unwanted way, or it even refuses to work correctly at all.
\par\See{\Ref{classes}}
@@ -2678,13 +3553,13 @@ Option & Short description & Section \\
or because you use a package which redefines |figure| or |table| and
which is unknown to \thispackage, or simply because you don't have any usage
of the environment \meta{type} after this line.\par
- If you want to supress this warning you can use |\captionsetup*| instead of
+ If you want to suppress this warning you can use |\captionsetup*| instead of
|\captionsetup|.
- \par\See{\Ref{commands}}
+ \par\See{\Ref{captionsetup}}
\Message
|Usage of the |\meta{package}| package together with the|\\
- |caption package is strongly *not* recommended.|\\
+ |caption package is strongly not recommended.|\\
|Instead of loading the |\meta{package}| package you should|\\
|use the caption package option `tableposition=top'.|
\Description
@@ -2695,7 +3570,7 @@ Option & Short description & Section \\
\end{Warnings}
-\pagebreak[4]
+\pagebreak[3]
\subsection{Errors}
\begin{Warnings}
@@ -2709,7 +3584,7 @@ Option & Short description & Section \\
you need to give an optional argument to |\caption| resp.~|\captionof|
for the List of Figures resp.~List of Tables, too, even if you don't
use such list.
- \par\See{\Ref{commands}, \Ref{listof}, and \Ref{hyperref}\,}
+ \par\See{\Ref{caption}, \Ref{lists}, and \Ref{hyperref}\,}
\Message
|\caption outside float.|
@@ -2717,19 +3592,7 @@ Option & Short description & Section \\
You have placed a |\caption| command outside a floating environment or
a |longtable|. If this is what you want to, please use either
|\captionsetup{|\xx|type=|\xx\meta{type}|}| $+$ |\caption| or |\captionof|.
- \par\See{\Ref{commands}}
-
-\Message
- |\caption outside box or environment.|
-\Or
- |\captionsetup{type=...} outside box or environment.|
-\Or
- |\captionsetup{type*=...} or \captionof outside box or environment.|
-\Description
- You have placed a |\caption|, |\captionof|, or |\captionsetup{type=|\meta{type}|}|
- command outside an box, group, or environment.
- This is not supported.
- \par\See{\Ref{commands}}
+ \par\See{\Ref{caption}}
\Message
|\ContinuedFloat outside float.|
@@ -2739,15 +3602,15 @@ Option & Short description & Section \\
If this is what you want to, please use the combination
|\captionsetup{|\xx|type=|\xx\meta{type}|}| $+$ |\ContinuedFloat|.\par
Please note that |\ContinuedFloat| inside a |longtable| is not working (yet),
- but maybe using the |longtable*| environment, which typesets a longtable
+ but maybe using the |longtable*| environment, which typesets a \env{longtable}
without incrementing the |table| counter, if sufficient for you.
- \par\See{\Ref{commands} and \Ref{longtable}}
+ \par\See{\Ref{ContinuedFloat} and \Ref{longtable}}
\Message
|Continued `|\meta{type}|' after `|\meta{type}|'.|
\Description
At the moment continued figures or tables are not allowed to be interrupted
- by a floating envionment of another type, e.g.~a table between a figure and a
+ by a floating environment of another type, e.g.~a table between a figure and a
continued figure.
\par\See{\Ref{ContinuedFloat}}
@@ -2757,7 +3620,7 @@ Option & Short description & Section \\
|package *(right) after* the `float' package.|
\Description
Please take care of the load order of packages
- if you use the \package{wrapfig} package in coorperation with the
+ if you use the \package{wrapfig} package in cooperation with the
\package{float} package.
\par\See{\Ref{wrapfig}}
@@ -2767,7 +3630,7 @@ Option & Short description & Section \\
|`wrapfig' version 3.6.|
\Description
Please take care of the version of the \package{wrapfig} package
- if you use the \package{wrapfig} package in coorperation with the
+ if you use the \package{wrapfig} package in cooperation with the
\package{float} package.
\par\See{\Ref{wrapfig}}
@@ -2786,6 +3649,17 @@ Option & Short description & Section \\
Please send me an e-mail reporting this issue.
\Message
+ |No float type '|\meta{type}|' defined.|
+\Description
+ The \meta{type} you have specified in |\captionsetup{type=|\meta{type}|}|,
+ |\captionof|\marg{type}, or |\DeclareCaptionSubType| is not defined.
+ \meta{type} should be either `\texttt{figure}' or `\texttt{table}', or
+ any other floating environment defined with |\DeclareCaptionType|,
+ |\newfloat| offered by the \package{float} package\cite{float},
+ or |\DeclareNewFloatType| offered by the \package{floatrow}
+ package\cite{floatrow}.
+
+\Message
|Not allowed in longtable* environment.|
\Description
The usage of |\caption| is not allowed inside the |longtable*| environment.
@@ -2798,7 +3672,7 @@ Option & Short description & Section \\
The feature required is not supported in compatibility mode.
`compatibility mode' means that \thispackage\ has detected either an
incompatible document class or an incompatible package which also
- extents the |\caption| command. Leaving the original extention intact,
+ extents the |\caption| command. Leaving the original extension intact,
some features of \thispackage\ are not supported.
\par\See{\Ref{compatibility}}
@@ -2827,7 +3701,7 @@ Option & Short description & Section \\
If you want to typeset multi-paragraph captions, you need to give an
optional argument to |\caption| resp.~|\captionof| for the List of
Figures resp.~List of Tables, too, even if you don't use such list.
- \par\See{\Ref{commands}, \Ref{listof}, and \Ref{hyperref}\,}
+ \par\See{\Ref{caption}, \Ref{lists}, and \Ref{hyperref}\,}
\iffalse % was removed in v3.1b
\Message
@@ -2837,7 +3711,7 @@ Option & Short description & Section \\
|about the `float' and the `wrapfig' package.|
\Description
Please take care of the load order of packages
- if you use the \package{wrapfig} package in coorperation with the
+ if you use the \package{wrapfig} package in cooperation with the
\package{float} package. But maybe a different package tried to extent
the \package{float} package in a manner which is incompatible to
\thispackage!?
@@ -2863,7 +3737,7 @@ Option & Short description & Section \\
A caption label separator which contains a |\\| command (like
|labelsep=|\xx|newline|) can not be combined with a hanging caption format
(like |format=|\xx|hang|).
- Please select either another caption label seperator
+ Please select either another caption label separator
(e.g.~|labelsep=|\xx|colon|) or another caption format
(e.g.~|format=|\xx|plain|).
\par\See{\Ref{formats} resp.~\Ref{KOMA}}
@@ -2874,11 +3748,11 @@ Option & Short description & Section \\
|and do *not* load the caption package anymore.|
\Description
You have specified the option |caption=false|. This used to be a workaround
- for not using the whole \package{caption} package, leaving the caption stuff
- offered by the document class or other packages intact, but keeping the
- \package{subfig} package working. This mechanism is obsolet and not offered
- anymore, please pass this option to the \package{subfig} instead and do not
- load \thispackage\ anymore.
+ for not using the whole \package{caption} package (leaving the caption stuff
+ offered by the document class or other packages intact), but keeping the
+ \package{subfig} package working. This mechanism is obsolete and not offered
+ anymore, please pass this option to the \package{subfig} package instead and
+ do not load \thispackage\ anymore.
\par\See{the \package{subfig} package\cite{subfig} documentation}
\Message
@@ -2910,11 +3784,11 @@ Option & Short description & Section \\
\par\See{\Ref{formats}}
\Message
- |Undefined list-of format `|\meta{name}|'.|
+ |Undefined list format `|\meta{name}|'.|
\Description
You tried to set a caption list-of format which does not exists.
Maybe a typo!?
- \par\See{\Ref{listof}}
+ \par\See{\Ref{lists}}
\Message
|Undefined position `|\meta{name}|'.|
@@ -3033,6 +3907,22 @@ who all helped to make this package a better one.
\newblock {\em The {\LaTeX} Companion (2nd.~Ed.)},\\
\newblock Addison-Wesley, 2004.
+ \bibitem{algorithms}
+ Rogério Brito:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/algorithms/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/algorithms/algorithms.pdf}%
+ {\emph{Algorithms}},\\
+ June 2, 2006
+
+\iffalse
+ \bibitem{algorithm2e}
+ Christophe Fiorio:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/algorithm2e/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/algorithm2e/algorithm2e.pdf}%
+ {\emph{algorithm2e.sty -- package for algorithms}},\\
+ March 11, 2007
+\fi
+
\bibitem{beamer}
Till Tantau:\\
\href{http://tug.ctan.org/tex-archive/macros/latex/contrib/beamer/}%
@@ -3087,7 +3977,7 @@ who all helped to make this package a better one.
\href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}%
% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.pdf}%
{\emph{Hypertext marks in \LaTeX}},\\
- June 14, 2007
+ November 12, 2007
\bibitem{hypcap}
Heiko Oberdiek:\\
@@ -3131,6 +4021,13 @@ who all helped to make this package a better one.
{\emph{A style option for rotated objects in \LaTeX}},\\
1997/09/26
+ \bibitem{setspace}
+ Erica M. S. Harris \& Geoffrey Tobin:\\
+ \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/setspace/}%
+% \href{ftp://tug.ctan.org/tex-archive/macros/latex/contrib/setspace/}%
+ {\emph{LaTeX Document Package ``setspace''}},\\
+ 1 December 2000
+
\bibitem{sidecap}
Rolf Niepraschk \& Hubert G\"a\ss lein:\\
\href{http://tug.ctan.org/tex-archive/macros/latex/contrib/sidecap/}%
diff --git a/Master/texmf-dist/doc/latex/caption/caption.pdf b/Master/texmf-dist/doc/latex/caption/caption.pdf
index 4faf48fb283..6ec796ee07a 100644
--- a/Master/texmf-dist/doc/latex/caption/caption.pdf
+++ b/Master/texmf-dist/doc/latex/caption/caption.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/caption/caption2.pdf b/Master/texmf-dist/doc/latex/caption/caption2.pdf
index 5029bc7bd8e..df65de6426b 100644
--- a/Master/texmf-dist/doc/latex/caption/caption2.pdf
+++ b/Master/texmf-dist/doc/latex/caption/caption2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/caption/ltcaption.pdf b/Master/texmf-dist/doc/latex/caption/ltcaption.pdf
index 97e009c4aa8..a607b982617 100644
--- a/Master/texmf-dist/doc/latex/caption/ltcaption.pdf
+++ b/Master/texmf-dist/doc/latex/caption/ltcaption.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/caption/subcaption.pdf b/Master/texmf-dist/doc/latex/caption/subcaption.pdf
new file mode 100644
index 00000000000..cb770695d39
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/caption/subcaption.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/latex/caption/caption.dtx b/Master/texmf-dist/source/latex/caption/caption.dtx
index 83d19829927..29fede54769 100644
--- a/Master/texmf-dist/source/latex/caption/caption.dtx
+++ b/Master/texmf-dist/source/latex/caption/caption.dtx
@@ -19,17 +19,17 @@
% This Current Maintainer of this work is Axel Sommerfeldt.
%
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-% caption-eng.tex, and caption-rus.tex.
+% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
% \fi
-% \CheckSum{5516}
+% \CheckSum{5983}
%
% \iffalse
%<*driver>
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesFile{caption.drv}[2007/11/04 v3.1e Implementation of the caption package]
+\ProvidesFile{caption.drv}[2007/12/23 v3.1f Implementation of the caption package]
\hbadness=9999 \newcount\hbadness \hfuzz=100pt % Make TeX shut up.
%\errorcontextlines=3
%
@@ -50,9 +50,10 @@
\fi
%
\usepackage{hypdoc}
-\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartview={}}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartpage={},pdfstartview={}}
%
-\usepackage[debug]{caption}[2007/11/04]
+\usepackage[debug]{caption}[2007/12/21]
%
\DeclareRobustCommand*\eTeX{\texorpdfstring
{\leavevmode\hbox{$\varepsilon$}-\TeX}%
@@ -75,7 +76,7 @@
% \newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}}
% \newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}}
% \newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}}
-% \let\package\puresf
+% \let\class\puresf \let\package\puresf
% \let\env\purett \let\opt\purett
%
% \def\thispackage{the \package{caption} package}
@@ -84,6 +85,8 @@
% \newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}}
% \newcommand*\csoarg[1]{\texttt{\char`\[#1\char`\]}}
% \newcommand*\version[2][]{\textit{v#2}}
+% \newcommand*\x{\discretionary{-}{}{}}
+% \newcommand*\xx{\discretionary{}{}{}}
%
% \GetFileInfo{caption.drv}
% \let\docdate\filedate
@@ -153,14 +156,16 @@
% \fi
%
% \DoNotIndex{\\,\_,\ ,\@@par}
-% \DoNotIndex{\@classoptionslist,\@currext,\@currname}
-% \DoNotIndex{\@ehc,\@ehd,\@empty,\@expandtwoargs}
+% \DoNotIndex{\@bsphack}
+% \DoNotIndex{\@car,\@cdr,\@classoptionslist,\@cons,\@currext,\@currname}
+% \DoNotIndex{\@ehc,\@ehd,\@empty,\@esphack,\@expandtwoargs}
% \DoNotIndex{\@for,\@firstofone,\@firstoftwo}
% \DoNotIndex{\@gobble,\@gobblefour,\@gobbletwo,\@hangfrom}
-% \DoNotIndex{\@ifnextchar,\@ifpackagelater,\@ifpackageloaded}
-% \DoNotIndex{\@ifstar,\@ifundefined,\@latex@error,\@namedef,\@nameuse}
+% \DoNotIndex{\if@minipage\@ifnextchar,\@ifpackagelater,\@ifpackageloaded}
+% \DoNotIndex{\@ifstar,\@ifundefined,\@latex@error,\@minipagefalse,\@minipagetrue}
+% \DoNotIndex{\@namedef,\@nameuse}
% \DoNotIndex{\@onlypreamble,\@parboxrestore,\@plus,\@ptionlist}
-% \DoNotIndex{\@removeelement,\@restorepar,\@secondoftwo,\@setpar}
+% \DoNotIndex{\@removeelement,\@restorepar,\@secondoftwo,\@setminipage,\@setpar}
% \DoNotIndex{\@tempa,\@tempboxa,\@tempdima,\@tempdimb,\@tempdimc,\@tempb,\@tempc}
% \DoNotIndex{\@testopt}
% \DoNotIndex{\@undefined,\@unprocessedoptions,\@unusedoptionlist}
@@ -225,7 +230,7 @@
%
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{caption3}[2007/11/04 v3.1e caption3 kernel (AR)]
+\ProvidesPackage{caption3}[2007/12/21 v3.1f caption3 kernel (AR)]
% \end{macrocode}
%
% \subsection{Generic helpers}
@@ -682,6 +687,7 @@
% \changes{v3.0a}{2004/01/17}{Bugfix: Missing \% added}
% \changes{v3.1}{2007/07/22}{Starred-variant added}
% \changes{v3.1e}{2007/07/27}{Inside packages the starred variant will be used automatically}
+% \changes{v3.1f}{2007/11/16}{Bugfix 07-11-09: `space hack' added}
% |\captionsetup|\oarg{type}\marg{keyval-list of options}\\
% |\captionsetup*|\oarg{type}\marg{keyval-list of options}\par
% If the optional argument `type' is specified, we simply save or append
@@ -701,10 +707,12 @@
\newcommand*\caption@setup{\caption@setkeys{caption}}
% \end{macrocode}
% \begin{macrocode}
-\def\caption@setup@options#1[#2]{%
- % #1 is \@gobble in star form, and \@firstofone otherwise
- #1{\caption@addtooptlist{#2}}%
- \expandafter\caption@l@addto@list\csname caption@opt@#2\endcsname}
+\def\caption@setup@options#1[#2]#3{%
+ \@bsphack
+ % #1 is \@gobble in star form, and \@firstofone otherwise
+ #1{\caption@addtooptlist{#2}}%
+ \expandafter\caption@l@addto@list\csname caption@opt@#2\endcsname{#3}%
+ \@esphack}
% \end{macrocode}
% \end{macro}
%
@@ -712,6 +720,7 @@
% \changes{v3.1}{2007/07/29}{Optional argument added}
% \changes{v3.1}{2007/08/17}{Starred variant added}
% \changes{v3.1e}{2007/07/27}{Inside packages the starred variant will be used automatically}
+% \changes{v3.1f}{2007/11/16}{Bugfix 07-11-09: `space hack' added}
% |\clearcaptionsetup|\oarg{option}\marg{type}\\
% |\clearcaptionsetup*|\oarg{option}\marg{type}\par
% This removes the saved option list associated with \meta{type}.
@@ -729,13 +738,15 @@
% \end{macrocode}
% \begin{macrocode}
\def\@@clearcaptionsetup[#1]#2{%
- \expandafter\caption@ifempty@list\csname caption@opt@#2\endcsname
- {\caption@tempa{\caption@Warning{Option list `#2' undefined}}}%
- {\ifx,#1,%
- \caption@clearsetup{#2}%
- \else
- \caption@@removefromsetup{#1}{#2}%
- \fi}}
+ \@bsphack
+ \expandafter\caption@ifempty@list\csname caption@opt@#2\endcsname
+ {\caption@tempa{\caption@Warning{Option list `#2' undefined}}}%
+ {\ifx,#1,%
+ \caption@clearsetup{#2}%
+ \else
+ \caption@@removefromsetup{#1}{#2}%
+ \fi}%
+ \@esphack}
% \end{macrocode}
% \begin{macrocode}
\newcommand*\caption@clearsetup[1]{%
@@ -772,19 +783,22 @@
% \begin{macro}{\showcaptionsetup}
% \changes{v3.0e}{2005/05/03}{Optimized for memory usage}
% \changes{v3.1}{2007/07/29}{Bugfix: Does not expand option list anymore}
+% \changes{v3.1f}{2007/11/16}{Bugfix 07-11-09: `space hack' added}
% |\showcaptionsetup|\oarg{package}\marg{type}\par
% This comes for debugging issues: It shows the saved option list which
% is associated with \meta{type}.
% \begin{macrocode}
\newcommand*\showcaptionsetup[2][\@firstofone]{%
- \GenericWarning{}{%
- #1 Caption Info: Option list on `#2'\MessageBreak
- #1 Caption Data: \@ifundefined{caption@opt@#2}{%
- -none-%
- }{%
- {\expandafter\expandafter\expandafter\strip@prefix
- \expandafter\meaning\csname caption@opt@#2\endcsname}%
- }}}
+ \@bsphack
+ \GenericWarning{}{%
+ #1 Caption Info: Option list on `#2'\MessageBreak
+ #1 Caption Data: \@ifundefined{caption@opt@#2}{%
+ -none-%
+ }{%
+ {\expandafter\expandafter\expandafter\strip@prefix
+ \expandafter\meaning\csname caption@opt@#2\endcsname}%
+ }}%
+ \@esphack}
% \end{macrocode}
% \end{macro}
%
@@ -799,6 +813,7 @@
% \changes{v3.0l}{2007/01/30}{Optional argument removed}
% \changes{v3.1}{2007/04/11}{Usage of \cs{clearcaptionsetup} added}
% \changes{v3.1}{2007/05/09}{Renamed from \cs{caption@settype} to \cs{caption@setoptions}}
+% \changes{v3.1f}{2007/12/03}{Definition of \cs{caption@iftypewarning} removed}
% |\caption@setoptions|\marg{type or environment or\ldots}\par
% Caption options which have been saved with |\captionsetup|\oarg{type} can
% be executed by using this command.
@@ -807,13 +822,15 @@
% \begin{macrocode}
\newcommand*\caption@setoptions[1]{%
\caption@Debug{options=#1}%
- \expandafter\let\expandafter\@tempa\csname caption@opt@#1\endcsname
- \ifx\@tempa\relax \else
- \let\caption@iftypewarning\@firstoftwo % = true
- \expandafter\caption@setup\expandafter{\@tempa}%
+ \expandafter\let\expandafter\caption@opt\csname caption@opt@#1\endcsname
+ \ifx\caption@opt\relax \else
+ \caption@xsetup\caption@opt
\caption@clearsetup{#1}%
\fi}
% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\caption@xsetup[1]{\expandafter\caption@setup\expandafter{#1}}
+% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@addtooptlist}
@@ -862,6 +879,7 @@
% \changes{v3.0l}{2007/01/30}{Optional argument added}
% \changes{v3.0p}{2007/04/08}{\cs{caption@keydepth} is now a command instead of a counter}
% \changes{v3.1b}{2007/09/18}{Usage of \cs{caption@Package} removed, we use \cs{caption@KV@err} instead}
+% \changes{v3.1f}{2007/11/16}{Bugfix 07-11-09: `space hack' added}
% |\caption@setkeys|\oarg{package}\marg{family}\marg{key-values}\par
% This one simply calls |\setkeys|\marg{family}\marg{key-values}
% but lets the error messages not refer to the \package{keyval} package,
@@ -871,12 +889,13 @@
% \end{macrocode}
% \begin{macrocode}
\long\def\caption@@setkeys[#1]#2#3{%
+ \@bsphack
+% \end{macrocode}
+% \begin{macrocode}
\expandafter\let\csname ORI@KV@err\caption@keydepth\endcsname\KV@err
\expandafter\let\csname ORI@KV@errx\caption@keydepth\endcsname\KV@errx
- \@ifundefined{#1@KV@err}%
- {\let\KV@err\ORI@KV@err\let\KV@errx\ORI@KV@errx}%
- {\expandafter\let\expandafter\KV@err\csname #1@KV@err\endcsname
- \let\KV@errx\KV@err}%
+ \expandafter\let\expandafter\KV@err\csname #1@KV@err\endcsname
+ \let\KV@errx\KV@err
\edef\caption@keydepth{\caption@keydepth i}%
% \end{macrocode}
% \begin{macrocode}
@@ -886,7 +905,10 @@
% \begin{macrocode}
\edef\caption@keydepth{\expandafter\@cdr\caption@keydepth\@nil}%
\expandafter\let\expandafter\KV@err\csname ORI@KV@err\caption@keydepth\endcsname
- \expandafter\let\expandafter\KV@errx\csname ORI@KV@errx\caption@keydepth\endcsname}
+ \expandafter\let\expandafter\KV@errx\csname ORI@KV@errx\caption@keydepth\endcsname
+% \end{macrocode}
+% \begin{macrocode}
+ \@esphack}
% \end{macrocode}
% \begin{macrocode}
\let\caption@keydepth\@empty
@@ -955,13 +977,14 @@
% \changes{v3.0p}{2007/04/01}{\cs{captionmarginx} renamed to \cs{captionmargin@}}
% \changes{v3.0p}{2007/04/03}{Option `twoside' added}
% \changes{v3.1}{2007/08/11}{Options `margin*', `minmargin', and `maxmargin' added}
+% \changes{v3.1f}{2007/11/10}{Option `oneside' added}
%
% \begin{macro}{\captionmargin}
% \begin{macro}{\captionwidth}
% |\captionmargin| and |\captionwidth| contain the extra margin
% resp. the total width used for captions. Please never set these values in
% a direct way, they are just accessible in user documents to provide
-% compatibility to |caption.sty| \version{1.x}.\par
+% compatibility to \version{1.x}.\par
% Note that we can only set one value at a time, `margin' \emph{or} `width'.
% If |\captionwidth| is not zero we will take this value afterwards,
% otherwise |\captionmargin| and |\captionmargin@|.
@@ -978,6 +1001,7 @@
\DeclareCaptionOption{margin*}{\setcaptionmargin*{#1}}
\DeclareCaptionOption{width}{\setcaptionwidth{#1}}
\DeclareCaptionOption{twoside}[1]{\caption@set@bool\caption@iftwoside{#1}}
+\DeclareCaptionOptionNoValue{oneside}{\caption@set@bool\caption@iftwoside0}
% \end{macrocode}
% \begin{macrocode}
\DeclareCaptionOption{minmargin}{\caption@setoptcmd\caption@minmargin{#1}}
@@ -994,7 +1018,7 @@
% `\texttt{margin*=}\cs{captionmargin}' works in singleline options}
% |\setcaptionmargin|\marg{amount}\\
% |\setcaptionmargin*|\marg{amount}\par
-% Please never use this in user documents, it's just there to
+% Please never use them in user documents, it's just there to
% provide compatibility to the \package{caption2} package.
% \begin{macrocode}
\newcommand*\setcaptionmargin{%
@@ -1064,13 +1088,21 @@
%
% \begin{macro}{\caption@label}
% \changes{v3.1}{2007/09/01}{This macro added}
+% \changes{v3.1f}{2007/12/03}{Definition of \cs{caption@newlabel} in AUX file added}
% This command is a modified version of |\label| from \LaTeX2e.
% It will be used inside |\caption@ifoddpage| and |\FP@helpNote|.
% \begin{macrocode}
\newcommand*\caption@label[1]{%
+ \caption@@label
\protected@write\@auxout{\let\caption@thepage\relax}%
{\string\caption@newlabel{#1}{\caption@thepage}}}
% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\caption@@label{%
+ \global\let\caption@@label\relax
+ \protected@write\@auxout{}%
+ {\string\providecommand*\string\caption@newlabel[2]{}}}
+% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@pageref}
@@ -1177,7 +1209,7 @@
% our option) or not (and therefore should be ignored by us).\footnote{%^^A
% This problem was completely solved due a change of \cs{caption@ProcessOptions}
% in \thispackage\ \version{3.0j}, but we still need this workaround since
-% these options otherwise would still collide with the current version $1.3$
+% these options would otherwise still collide with the current version $1.3$
% of the \package{subfig} package (Sigh!)}
% \begin{macrocode}
\@ifundefined{scr@caption}{}{%
@@ -1232,6 +1264,7 @@
% \changes{v3.0f}{2005/06/01}{Starred variant added}
% \changes{v3.1}{2007/07/29}{Recursive style definitions should work now}
% \changes{v3.1d}{2007/10/23}{`SingleLine' renamed to `singleline' for consistency}
+% \changes{v3.1f}{2007/12/03}{Definition of \cs{caption@iftypewarning} removed}
% |\caption@setstyle|\marg{name}\\
% |\caption@setstyle*|\marg{name}\par
% Selecting a caption style means saving the additional
@@ -1251,13 +1284,12 @@
{#1{\caption@Error{Undefined style `#2'}}}%
{\expandafter\let\expandafter\caption@sty\csname caption@sty@#2\endcsname
\ifx\caption@setstyle@flag\@undefined
- \let\caption@setstyle@flag\caption@setstyle
- \let\caption@iftypewarning\@firstoftwo % = true
+ \let\caption@setstyle@flag\relax
\caption@resetstyle
- \expandafter\caption@setup\expandafter{\caption@sty}%
+ \caption@xsetup\caption@sty
\let\caption@setstyle@flag\@undefined
\else
- \expandafter\caption@setup\expandafter{\caption@sty}%
+ \caption@xsetup\caption@sty
\fi
\expandafter\let\expandafter\caption@sls\csname caption@sls@#2\endcsname
\expandafter\caption@l@addto@list\expandafter\caption@opt@singleline
@@ -1269,13 +1301,14 @@
% \changes{v3.1}{2007/02/04}{%
% This macro renamed from \cs{caption@setdefault} to \cs{caption@resetstyle}}
% \changes{v3.1d}{2007/10/23}{`SingleLine' renamed to `singleline' for consistency}
+% \changes{v3.1f}{2007/11/17}{\texttt{size=} added}
% This resets (nearly) all caption options to the base ones.
% \emph{Note that this does not touch the skips and the positioning!}
% \begin{macrocode}
\newcommand*\caption@resetstyle{%
\caption@setup{%
format=plain,labelformat=default,labelsep=colon,textformat=simple,%
- justification=justified,font=,labelfont=,textfont=,%
+ justification=justified,font=,size=,labelfont=,textfont=,%
margin=0pt,minmargin=0,maxmargin=0,%
indent=0pt,parindent=0pt,hangindent=0pt,%
singlelinecheck=1,strut=1}%
@@ -1409,12 +1442,14 @@
% \end{macrocode}
% \end{macro}
%
-% There are three pre-defined label formats, called `empty', `simple',
-% and `parens'.
+% \changes{v3.1f}{2007/12/16}{Caption label format \opt{brace} added}
+% There are four pre-defined label formats, called `empty', `simple',
+% `parens', and `brace'.
% \begin{macrocode}
\DeclareCaptionLabelFormat{empty}{}
\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{\nobreakspace}#2}
\DeclareCaptionLabelFormat{parens}{\bothIfFirst{#1}{\nobreakspace}(#2)}
+\DeclareCaptionLabelFormat{brace}{\bothIfFirst{#1}{\nobreakspace}#2)}
% \end{macrocode}
%
% `default' usually maps to `simple'.
@@ -1560,14 +1595,17 @@
%
% \begin{macrocode}
\DeclareCaptionOption{font}{\caption@setfont{font}{#1}}
+\DeclareCaptionOption{font+}{\caption@addtofont{font}{#1}}
\DeclareDefaultCaptionFont{font}{}
% \end{macrocode}
% \begin{macrocode}
\DeclareCaptionOption{labelfont}{\caption@setfont{labelfont}{#1}}
+\DeclareCaptionOption{labelfont+}{\caption@addtofont{labelfont}{#1}}
\DeclareDefaultCaptionFont{labelfont}{}
% \end{macrocode}
% \begin{macrocode}
\DeclareCaptionOption{textfont}{\caption@setfont{textfont}{#1}}
+\DeclareCaptionOption{textfont+}{\caption@addtofont{textfont}{#1}}
\DeclareDefaultCaptionFont{textfont}{}
% \end{macrocode}
%
@@ -1576,13 +1614,24 @@
% \changes{v3.1}{2006/05/14}{Support of \cs{DeclareDefaultCaptionFont} added}
% |\caption@setfont|\marg{name}\marg{keyval-list of names}\par
% Selecting a caption font means saving all the code snippets
-% (in |\caption#1|).
+% in |\caption|\meta{name}.
+% \begin{macrocode}
+\newcommand*\caption@setfont[1]{%
+ \expandafter\let\csname caption#1\endcsname\@empty
+ \caption@addtofont{#1}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\caption@addtofont}
+% \changes{v3.1f}{2007/11/17}{This macro added}
+% |\caption@addtofont|\marg{name}\marg{keyval-list of names}\par
+% Like |\caption@setfont|, but adds the code snippets to |\caption|\meta{name}.\par
% Because we use |\setkeys| recursive here we need to do this inside an
-% extra group and collect all the code snippets in |\caption@tempa| first.
+% extra group.
% \begin{macrocode}
-\newcommand*\caption@setfont[2]{%
+\newcommand*\caption@addtofont[2]{%
\begingroup
- \let\caption@fnt\@empty
+ \expandafter\let\expandafter\caption@fnt\csname caption#1\endcsname
\define@key{caption@fnt}{default}[]{%
\l@addto@macro\caption@fnt{\csname caption#1@default\endcsname}}%
\caption@setkeys[caption]{caption@fnt}{#2}%
@@ -1660,19 +1709,10 @@
\KV@caption@fnt@singlespacing\@unused}}
% \end{macrocode}
%
-% \begin{macro}{\captionsize}
-% \changes{v3.0a}{2004/01/23}{Implementation changed from \cs{captionfont}
-% to \cs{@empty}}
-% \changes{v3.0c}{2004/07/16}{Use \cs{providecommand} instead of \cs{newcommand}}
-% The old versions \version{1.x} of \thispackage\ offered this
-% command to setup the font size used for captions. We still do
-% so old documents will work fine.
-% \begin{macrocode}
-\providecommand\captionsize{}
-% \end{macrocode}
-% \end{macro}
-%
% \changes{v3.0a}{2004/01/23}{Option \opt{size=} now sets \cs{captionsize} instead of \cs{captionfont}}
+% The old versions \version{1.x} of \thispackage\ offered this
+% command to setup the font size used for captions. We still do
+% so old documents will work fine.
% \begin{macrocode}
\DeclareCaptionOption{size}{\caption@setfont{size}{#1}}
\DeclareDefaultCaptionFont{size}{}
@@ -1994,33 +2034,38 @@
% \subsection{Lists}
%
% \changes{v3.0b}{2004/05/16}{Option \opt{listof=} added}
+% \changes{v3.1f}{2007/11/17}{Option \opt{list=} added}
% \begin{macrocode}
-\DeclareCaptionOption{listof}{\caption@set@bool\caption@iflof{#1}}
+\DeclareCaptionOption{list}{\caption@set@bool\caption@iflist{#1}}
+\DeclareCaptionOption{listof}{\caption@set@bool\caption@iflist{#1}}
% \end{macrocode}
%
-% \begin{macro}{\DeclareCaptionListOfFormat}
+% \begin{macro}{\DeclareCaptionListFormat}
% \changes{v3.1}{2004/07/15}{This macro added}
-% |\DeclareCaptionListOfFormat|\marg{name}\marg{code with \#1 and \#2}
+% \changes{v3.1f}{2007/11/17}{Renamed from \cs{DeclareCaptionListOfFormat} to \cs{DeclareCaptionListFormat}}
+% |\DeclareCaptionListFormat|\marg{name}\marg{code with \#1 and \#2}
% \begin{macrocode}
-\newcommand*\DeclareCaptionListOfFormat[2]{%
+\newcommand*\DeclareCaptionListFormat[2]{%
\global\@namedef{caption@lstfmt@#1}##1##2{#2}}
-\@onlypreamble\DeclareCaptionListOfFormat
+\@onlypreamble\DeclareCaptionListFormat
% \end{macrocode}
% \end{macro}
%
% \changes{v3.1}{2007/07/15}{Option \opt{listofformat=} added}
+% \changes{v3.1f}{2007/11/17}{Option \opt{listofformat=} renamed to \opt{listformat=}}
% \begin{macrocode}
-\DeclareCaptionOption{listofformat}{\caption@setlistofformat{#1}}
+\DeclareCaptionOption{listformat}{\caption@setlistformat{#1}}
% \end{macrocode}
%
-% \begin{macro}{\caption@setlistofformat}
+% \begin{macro}{\caption@setlistformat}
% \changes{v3.1}{2004/07/15}{This macro added}
-% |\caption@setlistofformat|\marg{name}\par
-% Selecting a caption list-of format simply means saving the code (in |\caption@lstfmt|).
+% \changes{v3.1f}{2007/11/17}{Renamed from \cs{caption@setlistofformat} to \cs{caption@setlistformat}}
+% |\caption@setlistformat|\marg{name}\par
+% Selecting a caption list format simply means saving the code (in |\caption@lstfmt|).
% \begin{macrocode}
-\newcommand*\caption@setlistofformat[1]{%
+\newcommand*\caption@setlistformat[1]{%
\@ifundefined{caption@lstfmt@#1}%
- {\caption@Error{Undefined list-of format `#1'}}%
+ {\caption@Error{Undefined list format `#1'}}%
{\expandafter\let\expandafter\caption@lstfmt
\csname caption@lstfmt@#1\endcsname}}
% \end{macrocode}
@@ -2028,11 +2073,11 @@
%
% There are five pre-defined list formats, taken from the \package{subfig} package.
% \begin{macrocode}
-\DeclareCaptionListOfFormat{empty}{}
-\DeclareCaptionListOfFormat{simple}{#1#2}
-\DeclareCaptionListOfFormat{parens}{#1(#2)}
-\DeclareCaptionListOfFormat{subsimple}{#2}
-\DeclareCaptionListOfFormat{subparens}{(#2)}
+\DeclareCaptionListFormat{empty}{}
+\DeclareCaptionListFormat{simple}{#1#2}
+\DeclareCaptionListFormat{parens}{#1(#2)}
+\DeclareCaptionListFormat{subsimple}{#2}
+\DeclareCaptionListFormat{subparens}{(#2)}
% \end{macrocode}
% \begin{macrocode}
\def\caption@lstfmt@default{\caption@lstfmt@subsimple}
@@ -2044,7 +2089,6 @@
% \begin{macrocode}
\DeclareCaptionOption{debug}[1]{%
\caption@set@bool\caption@ifdebug{#1}%
- \let\caption@iftypewarning\caption@ifdebug
\caption@ifdebug
{\def\caption@Debug{\PackageInfo{caption}}}%
{\let\caption@Debug\@gobble}}
@@ -2382,7 +2426,7 @@
% \subsection{Execution of options}
%
% \begin{macrocode}
-\captionsetup{style=default,position=default,listof=1,listofformat=default,%
+\captionsetup{style=default,position=default,list=1,listformat=default,%
twoside=\if@twoside 1\else 0\fi}
% \end{macrocode}
% \begin{macrocode}
@@ -2412,7 +2456,7 @@
% |listof=| was set to |true|.
% \begin{macrocode}
\newcommand*\caption@addcontentsline[2]{%
- \caption@iflof%
+ \caption@iflist
{\def\@tempa{#2}}%
{\let\@tempa\@empty}%
\ifx\@tempa\@empty \else
@@ -2470,7 +2514,7 @@
% single-line-check replaced by \cs{relax}}
% \changes{v3.0i}{2006/01/11}{Bugfix: \cs{caption@startbox} will always be
% typeset in horizontal mode}
-% \changes{v3.0k}{2006/05/13}{Uses \cs{captionbox} instead of \cs{caption@start/endbox}}
+% \changes{v3.0k}{2006/05/13}{Uses \cs{caption@parbox} instead of \cs{caption@start/endbox}}
% \changes{v3.0l}{2007/01/04}{Oops, bugfix 04-05-05 got lost in v3.0j, re-added}
% \changes{v3.0p}{2007/04/03}{Usage of \cs{caption@ifoddpage} added}
% \changes{v3.1}{2007/07/29}{\cs{caption@calcmargin} moved below single-line-check}
@@ -2520,7 +2564,7 @@
% \begin{macrocode}
\@tempdima\captionwidth
\caption@ifh{\advance\@tempdima-\caption@indent}%
- \captionbox\@tempdima{%
+ \caption@parbox\@tempdima{%
% \end{macrocode}
%
% Typeset the indention (option |indention=|)\\
@@ -2535,7 +2579,7 @@
\fi}%
% \end{macrocode}
%
-% Typeset the caption itself and close the |\captionbox|
+% Typeset the caption itself and close the |\caption@parbox|
% \begin{macrocode}
\caption@@@make{#1}{#2}}%
% \end{macrocode}
@@ -2624,7 +2668,7 @@
% \end{macrocode}
% \begin{macrocode}
\newcommand*\caption@singleline{%
- \expandafter\caption@setup\expandafter{\caption@opt@singleline}%
+ \caption@xsetup\caption@opt@singleline
\let\caption@fmt\caption@slfmt}
% \end{macrocode}
% \end{macro}
@@ -2652,15 +2696,16 @@
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\captionbox}
-% \changes{v3.0k}{2006/05/13}{We define \cs{captionbox} instead of
+% \begin{macro}{\caption@parbox}
+% \changes{v3.0k}{2006/05/13}{We define \cs{caption@parbox} instead of
% \cs{caption@start/endbox}}
-% \changes{v3.0n}{2006/03/09}{Bugfix 07-03-09: \cs{captionbox} changed from
+% \changes{v3.0n}{2006/03/09}{Bugfix 07-03-09: \cs{caption@parbox} changed from
% \cs{parbox-t} to \cs{parbox-b}}
-% |\captionbox|\marg{width}\marg{contents}\par
+% \changes{v3.1f}{2007/11/11}{Renamed from \cs{captionbox} to \cs{caption@parbox}}
+% |\caption@parbox|\marg{width}\marg{contents}\par
% This macro defines the box which surrounds the caption paragraph.
% \begin{macrocode}
-\newcommand*\captionbox{\parbox[b]}
+\newcommand*\caption@parbox{\parbox[b]}
% \end{macrocode}
% \end{macro}
%
@@ -2676,6 +2721,7 @@
% \changes{v3.0h}{2005/08/25}{\cs{caption@iflf} added}
% \changes{v3.0l}{2007/02/18}{Usage of \cs{caption@tfmt} added}
% \changes{v3.1}{2007/05/07}{Bugfix: \cs{ifhmode} added to \cs{@finalstrut}}
+% \changes{v3.1f}{2007/11/17}{Made option \opt{size=} stronger than \opt{font=}}
% |\caption@@@make|\marg{caption label}\marg{caption text}\par
% This one finally typesets the caption paragraph, without margin and indention.
% \begin{macrocode}
@@ -2708,7 +2754,7 @@
%
% Finally typeset the caption.
% \begin{macrocode}
- \caption@hj\captionsize\captionfont\caption@fmt
+ \caption@hj\captionfont\captionsize\caption@fmt
{\ifcaption@star\else{\captionlabelfont#1}\fi}%
{\ifcaption@star\else{\caption@iflf\captionlabelfont\caption@lsep}\fi}%
{{\captiontextfont
@@ -2756,34 +2802,26 @@
% \end{macrocode}
% \end{macro}
%
-% \iffalse\subsection{\cs{DeclareFloatingEnvironment}}\fi
-% \subsection{Bonus features}
+% \subsection{Types \& sub-types}
%
-% \begin{macro}{\DeclareFloatingEnvironment}
+% \begin{macro}{\DeclareCaptionType}
% \changes{v3.1}{2007/08/12}{This macro added}
% \changes{v3.1a}{2007/09/07}{Three optional arguments added}
-% |\DeclareFloatingEnvironment|\oarg{file ext}\marg{environment}\oarg{name}\oarg{list name}
+% \changes{v3.1f}{2007/12/06}{Renamed from \cs{DeclareFloatingEnvironment} to \cs{DeclareCaptionType}}
+% \changes{v3.1f}{2007/12/21}{Optional argument revised, uses key-value syntax now}
+% |\DeclareCaptionType|\oarg{options}\marg{environment}\oarg{name}\oarg{list name}
% \begin{macrocode}
-\providecommand*\DeclareFloatingEnvironment{%
- \@ifnextchar[%]
- \caption@@DeclareFloatingEnvironment\caption@DeclareFloatingEnvironment}
-\@onlypreamble\DeclareFloatingEnvironment
-% \end{macrocode}
-% \begin{macrocode}
-\newcommand*\caption@DeclareFloatingEnvironment[1]{%
- \caption@@DeclareFloatingEnvironment[lo#1]{#1}}
-\@onlypreamble\caption@DeclareFloatingEnvironment
+\newcommand*\DeclareCaptionType{%
+ \@testopt\@DeclareCaptionType{}}
+\@onlypreamble\DeclareCaptionType
% \end{macrocode}
% \begin{macrocode}
-\def\caption@@DeclareFloatingEnvironment[#1]#2{%
- \@ifundefined{c@chapter}%
- {\newcounter{#2}%
- \@namedef{the#2}{\arabic{#2}}%
- \@namedef{theH#2}{\arabic{#2}}}%
- {\newcounter{#2}[chapter]%
- \@namedef{the#2}{\ifnum\c@chapter>\z@ \thechapter.\fi \arabic{#2}}%
- \@namedef{theH#2}{\theHchapter.\arabic{#2}}}%
- \@namedef{fps@#2}{tbp}%
+\def\@DeclareCaptionType[#1]#2{%
+ \def\caption@type{#2}%
+ \caption@Debug{New type `#2'}%
+ \newcounter{#2}\@namedef{theH#2}{}%
+ \KV@caption@DCT@within{\@ifundefined{c@chapter}{none}{chapter}}%
+ \KV@caption@DCT@placement{tbp}%
\@ifundefined{c@float@type}%
{\newcounter{float@type}%
\setcounter{float@type}{\@ifundefined{c@figure}14}}%
@@ -2791,18 +2829,11 @@
\caption@Debug{float type `#2'=\the\value{float@type}}%
\expandafter\xdef\csname ftype@#2\endcsname{\the\value{float@type}}%
\addtocounter{float@type}{\value{float@type}}%
- \@namedef{ext@#2}{#1}%
+ \KV@caption@DCT@fileext{lo#2}%
\@namedef{fnum@#2}{\@nameuse{#2name}\nobreakspace\@nameuse{the#2}}%
\newenvironment{#2}{\@float{#2}}{\end@float}%
\newenvironment{#2*}{\@dblfloat{#2}}{\end@dblfloat}%
- \expandafter\newcommand\csname listof#2s\endcsname{\begingroup
- \expandafter\let\expandafter\listfigurename\csname list#2name\endcsname
- \expandafter\let\expandafter\ext@figure\csname ext@#2\endcsname
- \let\caption@ORI@starttoc\@starttoc
- \renewcommand*\@starttoc[1]{%
- \expandafter\caption@ORI@starttoc\expandafter{\ext@figure}}%
- \listoffigures
- \endgroup}%
+ \expandafter\newcommand\csname listof#2s\endcsname{\caption@listof{#2}}%
\@ifundefined{l@figure}%
{\@namedef{l@#2}{\@dottedtocline{1}{1.5em}{2.3em}}}%
{\expandafter\let\csname l@#2\endcsname\l@figure}%
@@ -2816,36 +2847,204 @@
\expandafter\let\csname #2name\endcsname\@tempa
\expandafter\newcommand\csname list#2name\endcsname{}%
\expandafter\xdef\csname list#2name\endcsname{List of \@tempa s}%
- \@cons\caption@floatlist{{#2}}%
- \@ifnextchar[{\caption@@@DeclareFloatingEnvironment{#2}}\relax}
-\@onlypreamble\caption@@DeclareFloatingEnvironment
+ \@cons\caption@typelist{{#2}}%
+ \caption@setkeys[caption]{caption@DCT}{#1}%
+ \@ifnextchar[\@@DeclareCaptionType\relax}
+\@onlypreamble\@DeclareCaptionType
% \end{macrocode}
% \begin{macrocode}
-\def\caption@@@DeclareFloatingEnvironment#1[#2]{%
- \@namedef{#1name}{#2}%
- \@ifnextchar[{\caption@@@@DeclareFloatingEnvironment{#1}}\relax}
-\@onlypreamble\caption@@@DeclareFloatingEnvironment
+\def\@@DeclareCaptionType[#1]{%
+ \KV@caption@DCT@name{#1}%
+ \@ifnextchar[\@@@DeclareCaptionType\relax}
+\@onlypreamble\@@DeclareCaptionType
% \end{macrocode}
% \begin{macrocode}
-\def\caption@@@@DeclareFloatingEnvironment#1[#2]{%
- \@namedef{list#1name}{#2}}
-\@onlypreamble\caption@@@@DeclareFloatingEnvironment
+\def\@@@DeclareCaptionType[#1]{%
+ \KV@caption@DCT@listname{#1}}
+\@onlypreamble\@@@DeclareCaptionType
% \end{macrocode}
% \begin{macrocode}
-\newcommand*\caption@floatlist{}
+\let\DeclareFloatingEnvironment\DeclareCaptionType % old command name
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\caption@listof}
+% \changes{v3.1f}{2007/12/21}{This macro added}
+% |\caption@listof|\marg{float type}
+% \begin{macrocode}
+\newcommand*\caption@listof[1]{%
+ \begingroup
+ \expandafter\let\expandafter\listfigurename\csname list#1name\endcsname
+ \expandafter\let\expandafter\ext@figure\csname ext@#1\endcsname
+ \let\caption@ORI@starttoc\@starttoc
+ \renewcommand*\@starttoc[1]{%
+ \expandafter\caption@ORI@starttoc\expandafter{\ext@figure}}%
+ \listoffigures
+ \endgroup}
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\ForFloatingEnvironments}
+% \begin{macro}{\caption@typelist}
+% An \cs{@elt}-list containing the caption types defined
+% with |\Declare|\x|Caption|\x|Type|.
+% \begin{macrocode}
+\newcommand*\caption@typelist{}
+% \end{macrocode}
+% \end{macro}
+%
+% The available \meta{options} are:
+% |fileext=|\meta{file extension},
+% |listname=|\meta{list name},
+% |name=|\meta{prosa name},
+% |placement=|\meta{htbp},
+% |within=|\meta{none,chapter,section}, and
+% |without|.
+% \begin{macrocode}
+\define@key{caption@DCT}{fileext}{\@namedef{ext@\caption@type}{#1}}
+\@onlypreamble@key{caption@DCT}{fileext}
+\define@key{caption@DCT}{listname}{\@namedef{list\caption@type name}{#1}}
+\@onlypreamble@key{caption@DCT}{listname}
+\define@key{caption@DCT}{name}{\@namedef{\caption@type name}{#1}}
+\@onlypreamble@key{caption@DCT}{name}
+\define@key{caption@DCT}{placement}{\@namedef{fps@\caption@type}{#1}}
+\@onlypreamble@key{caption@DCT}{placement}
+\define@key{caption@DCT}{within}{%
+ \@ifundefined{c@chapter}{}{\@removefromreset\caption@type{chapter}}%
+ \@removefromreset\caption@type{section}%
+ \begingroup
+ \caption@setkeys[caption]{caption@within}{#1}%
+ \endgroup}
+\@onlypreamble@key{caption@DCT}{within}
+\define@key{caption@DCT}{without}{\KV@caption@DCT@within{none}}
+\@onlypreamble@key{caption@DCT}{without}
+% \end{macrocode}
+% \begin{macrocode}
+\define@key{caption@within}{none}[]{%
+ \caption@within{}{}}
+\@onlypreamble@key{caption@within}{none}
+\@ifundefined{c@chapter}{}{%
+ \define@key{caption@within}{chapter}[]{%
+ \@addtoreset\caption@type{chapter}%
+ \caption@within{\ifnum\c@chapter>\z@ \thechapter.\fi}{\theHchapter.}}
+ \@onlypreamble@key{caption@within}{chapter}}
+\define@key{caption@within}{section}[]{%
+ \@addtoreset\caption@type{section}%
+ \caption@within{\ifnum\c@section>\z@ \thesection.\fi}{\theHsection.}}
+\@onlypreamble@key{caption@within}{section}
+% \end{macrocode}
+% \begin{macro}{\caption@within}
+% \changes{v3.1f}{2007/12/21}{This macro added}
+% |\caption@within|\marg{thecode}\marg{theHcode}
+% \begin{macrocode}
+\newcommand*\caption@within{%
+ \expandafter\caption@within@\expandafter{\caption@type}}
+\@onlypreamble\caption@within
+\newcommand*\caption@within@[3]{%
+ \global\@namedef{the\caption@type}{#2\arabic{#1}}%
+ \@ifundefined{theH\caption@type}\caption@AtBeginDocument\@firstofone
+ {\global\@namedef{theH\caption@type}{#3\arabic{#1}}}}
+\@onlypreamble\caption@within@
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\@removefromreset}
+% \changes{v3.1f}{2007/12/21}{This macro added}
+% This code was taken from the \package{remreset} package
+% which is part of the `carlisle' package bundle.
+% (Copyright 1997 David Carlisle)
+% \begin{macrocode}
+\providecommand*\@removefromreset[2]{{%
+ \expandafter\let\csname c@#1\endcsname\@removefromreset
+ \def\@elt##1{%
+ \expandafter\ifx\csname c@##1\endcsname\@removefromreset
+ \else
+ \noexpand\@elt{##1}%
+ \fi}%
+ \expandafter\xdef\csname cl@#2\endcsname{%
+ \csname cl@#2\endcsname}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\DeclareCaptionSubType}
+% \changes{v3.1f}{2007/11/16}{This macro added}
+% |\DeclareCaptionSubType|\oarg{numbering scheme}\marg{type}\\
+% |\DeclareCaptionSubType*|\oarg{numbering scheme}\marg{type}\par
+% The starred variant provides the numbering format
+% \meta{type}|.|\meta{subtype} while the non-starred variant simply
+% uses \meta{subtype}.
+% \begin{macrocode}
+\newcommand*\DeclareCaptionSubType{%
+ \caption@teststar\@DeclareCaptionSubType\@firstoftwo\@secondoftwo}
+\@onlypreamble\DeclareCaptionSubType
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\@DeclareCaptionSubType[1]{%
+ \@testopt{\@@DeclareCaptionSubType{#1}}{alph}}
+\@onlypreamble\@DeclareCaptionSubType
+% \end{macrocode}
+% \begin{macrocode}
+\def\@@DeclareCaptionSubType#1[#2]#3{%
+ \@ifundefined{c@#3}%
+ {\caption@Error{No float type '#3' defined}}%
+% \end{macrocode}
+% \begin{macrocode}
+ {\@ifundefined{c@sub#3}%
+ {\caption@Debug{New subtype `sub#3'}%
+ \newcounter{sub#3}%
+ \@namedef{ext@sub#3}{\csname ext@#3\endcsname}%
+ \@ifundefined{l@chapter}%
+ {\edef\@tempa{\expandafter\expandafter\expandafter\noexpand
+ \expandafter\@car\l@subsubsection\@nil}%
+ \def\@tempb{\@dottedtocline}%
+ \ifx\@tempa\@tempb % \l@subsubsection starts with \@dottedtocline
+ \expandafter\edef\csname l@sub#3\endcsname{%
+ \noexpand\@dottedtocline{2}%
+ \expandafter\expandafter\expandafter\noexpand
+ \expandafter\@gobbletwo\l@subsubsection}%
+ \else
+ \@namedef{l@sub#3}{\@dottedtocline{2}{3.8em}{3.2em}}%
+ \fi}%
+ {\expandafter\let\csname l@sub#3\endcsname\l@subsection}%
+ \@cons\caption@subtypelist{{#3}}}%
+ {\caption@Debug{Modify caption `sub#3'}}%
+% \end{macrocode}
+% \begin{macrocode}
+ #1% is \@firstoftwo in star form, and \@secondoftwo otherwise
+ {\@namedef{p@sub#3}{}%
+ \@namedef{thesub#3}{\csname the#3\endcsname.\@nameuse{#2}{sub#3}}}%
+ {\@namedef{p@sub#3}{\csname the#3\endcsname}%
+ \@namedef{thesub#3}{\@nameuse{#2}{sub#3}}}%
+ \@namedef{theHsub#3}{\csname theH#3\endcsname.\arabic{sub#3}}%
+ \@namedef{sub#3autorefname}{\csname #3name\endcsname}}}
+% \end{macrocode}
+% \begin{macrocode}
+\@onlypreamble\@@DeclareCaptionSubType
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\caption@subtypelist}
+% An \cs{@elt}-list containing the subtypes defined
+% with |\Declare|\x|Caption|\x|Sub|\x|Type|.
+% \begin{macrocode}
+\newcommand*\caption@subtypelist{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\caption@For}
% \changes{v3.1a}{2007/09/07}{This macro added}
-% |\ForFloatingEnvironments|\marg{code with \#1}
+% \changes{v3.1f}{2007/11/16}{Renamed from \cs{ForFloatingEnvironments} to \cs{caption@For}}
+% |\caption@For|\marg{elt-list}\marg{code with \#1}\\
+% |\caption@For*|\marg{elt-list}\marg{code with \#1}
% \begin{macrocode}
-\providecommand\ForFloatingEnvironments[1]{%
- \caption@AtBeginDocument{%
- \def\@elt##1{#1}%
- \caption@floatlist
+\newcommand*\caption@For{\caption@withoptargs\caption@@For}
+\@onlypreamble\caption@For
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand\caption@@For[3]{%
+ \caption@AtBeginDocument#1{%
+ \def\@elt##1{#3}%
+ \@nameuse{caption@#2}%
\let\@elt\relax}}%
-\@onlypreamble\ForFloatingEnvironments
+\@onlypreamble\caption@@For
% \end{macrocode}
% \end{macro}
%
@@ -2854,35 +3053,17 @@
% \changes{v3.0l}{2007/01/31}{Bugfix of subfig package moved from package (kernel)}
% \changes{v3.1}{2007/07/07}{Several adaptions to the \package{subfig} package added}
%
-% Unfortunately the author of the \package{subfig} package does not seem to
-% maintain his package anymore, so we have to make several adaptions here.
+% We have to make several adaptions to \thispackage~\version{3.1} here.
% \begin{macrocode}
\caption@AtBeginDocument{%
\def\@tempa{\@ifstar\sf@@subref\sf@subref}%
\ifx\subref\@tempa
\PackageInfo{caption3}{subfig package 1.2 or 1.3 is loaded\@gobble}%
% \end{macrocode}
-%
% \begin{macrocode}
\let\caption@setfloattype\@gobble
-% \end{macrocode}
-% \begin{macrocode}
-% \let\sf@ifinlist\caption@ifinlist
- \let\sf@ifpositiontop\caption@iftop
-% \end{macrocode}
-% \begin{macrocode}
- \def\@dottedxxxline#1#2#3#4#5#6#7{%
- \begingroup
- \caption@setfloattype{#1}%
- \caption@setoptions{subfloat}%
- \caption@setoptions{sub#1}%
- \ifnum #3>\@nameuse{c@#2depth}\else
- \@dottedtocline{\z@}{#4}{#5}{#6}{#7}%
- \fi
- \endgroup}%
-% \end{macrocode}
-% \begin{macrocode}
- \let\sf@subfloat\sf@NEW@subfloat
+ \let\@dottedxxxline\sf@NEW@dottedxxxline
+ \let\sf@subfloat\sf@NEW@subfloat
% \end{macrocode}
% This is a very small bugfix for \version{1.2} and \version{1.3} or the
% \package{subfig} package, making \cs{subref} robust, so it works in
@@ -2891,15 +3072,22 @@
\DeclareRobustCommand*\subref{\@ifstar\sf@@subref\sf@subref}%
% \end{macrocode}
% \begin{macrocode}
- \caption@removefromoptlist{subfloat}%
- \caption@removefromoptlist{subfigure}%
- \caption@removefromoptlist{subtable}%
-% \end{macrocode}
-% \begin{macrocode}
\fi
+ \let\sf@NEW@dottedxxxline\@undefined
\let\sf@NEW@subfloat\@undefined}
% \end{macrocode}
% \begin{macrocode}
+\def\sf@NEW@dottedxxxline#1#2#3#4#5#6#7{%
+ \begingroup
+ \caption@setfloattype{#1}%
+ \caption@setoptions{subfloat}%
+ \caption@setoptions{sub#1}%
+ \ifnum #3>\@nameuse{c@#2depth}\else
+ \@dottedtocline{\z@}{#4}{#5}{#6}{#7}%
+ \fi
+ \endgroup}
+% \end{macrocode}
+% \begin{macrocode}
\def\sf@NEW@subfloat{%
\begingroup
\caption@setfloattype\@captype
@@ -2919,7 +3107,7 @@
\setcounter{sub\@captype @save}{\value{sub\@captype}}%
\@ifnextchar [% %] match left bracket
{\sf@@subfloat}%
- {\sf@@subfloat[\@empty]}}%
+ {\sf@@subfloat[\@empty]}}
% \end{macrocode}
%
% \iffalse
@@ -2940,7 +3128,7 @@
%
% \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{caption}[2007/11/04 v3.1e Customising captions (AR)]
+\ProvidesPackage{caption}[2007/12/23 v3.1f Customizing captions (AR)]
%\@ifundefined{PackageRedefines}{}{\PackageRedefines{caption}{caption}}
% \end{macrocode}
%
@@ -2957,7 +3145,7 @@
% \subsection{Loading the kernel}
%
% \begin{macrocode}
-\RequirePackage{caption3}[2007/11/04] % needs v3.1e or newer
+\RequirePackage{caption3}[2007/12/21] % needs v3.1f or newer
% \end{macrocode}
%
% \subsection{Check against incompatible packages}
@@ -2997,7 +3185,7 @@
\newcommand*\caption@IncompatiblePackage[2]{%
\PackageWarningNoLine{caption}{%
Usage of the #1 package together with the\MessageBreak
- caption package is strongly *not* recommended.\MessageBreak
+ caption package is strongly not recommended.\MessageBreak
Instead of loading the #1 package you should\MessageBreak
use the caption package option\MessageBreak
\space\space`tableposition=top'#2}}
@@ -3013,7 +3201,7 @@
\caption@ifbool{documentclass}{}{%
\PackageWarningNoLine{caption}{%
Unsupported document class (or package) detected,\MessageBreak
- usage of the caption package is *not* recommended}%
+ usage of the caption package is not recommended}%
\caption@Info{\string\@makecaption\space=\space\meaning\@makecaption}%
}
% \end{macrocode}
@@ -3201,16 +3389,9 @@
}
% \end{macrocode}
%
-% \subsection{Option for configuration files}
-%
-% \begin{macrocode}
-\DeclareCaptionOption*{config}[caption]{%
- \InputIfFileExists{#1.cfg}%
- {\typeout{*** Local configuration file #1.cfg used ***}}%
- {\caption@Warning{Configuration file #1.cfg not found}}}
-% \end{macrocode}
+% \subsection{Declaration of options}
%
-% \subsection{Options for figure and table}
+% \subsubsection{Options for figure and table}
%
% \changes{v3.0a}{2004/01/09}{Options \opt{figureposition} and \opt{tableposition} added}
% \begin{macrocode}
@@ -3235,15 +3416,18 @@
%
% \changes{v3.0d}{2004/08/03}{Options \opt{figurename} and \opt{tablename} added}
% \changes{v3.1}{2007/07/04}{Options \opt{figurename} and \opt{tablename} re-written}
+% \changes{v3.1f}{2007/11/18}{Options \opt{figurename} and \opt{tablename} are now
+% available after the document preamble, too.}
+% \changes{v3.1f}{2007/11/18}{Option \opt{name} added}
% \begin{macrocode}
\DeclareCaptionOption{figurename}{\caption@SetFloatName{figure}{#1}}
-\@onlypreamble@key{caption}{figurename}
\DeclareCaptionOption{tablename}{\caption@SetFloatName{table}{#1}}
-\@onlypreamble@key{caption}{tablename}
+\DeclareCaptionOption{name}{\caption@setfloatname\@captype{#1}}
% \end{macrocode}
%
% \begin{macro}{\caption@SetFloatName}
% \changes{v3.1}{2007/07/04}{This macro added}
+% \changes{v3.1f}{2007/11/18}{After-preamble variant added}
% |\caption@SetFloatName|\marg{cmd}\marg{value}
% \begin{macrocode}
\newcommand*\caption@SetFloatName[2]{%
@@ -3253,12 +3437,56 @@
\@ifundefined{captions\languagename}{}{%
\def\@tempa{\endgroup
\expandafter\addto\csname captions\languagename\endcsname}}}%
- \@tempa{\@namedef{#1name}{#2}}}
-\@onlypreamble\caption@SetFloatName
+ \@tempa{\caption@setfloatname{#1}{#2}}}
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\caption@setfloatname[2]{\@namedef{#1name}{#2}}
+% \end{macrocode}
+% \begin{macrocode}
+\caption@AtBeginDocument{\let\caption@SetFloatName\caption@setfloatname}
% \end{macrocode}
% \end{macro}
%
-% \subsection{caption v1.x compatibility options}
+% \changes{v3.1f}{2007/12/21}{Options \opt{figurewithin} and \opt{tablewithin} added}
+% \begin{macrocode}
+\DeclareCaptionOption{figurewithin}{\caption@Within{figure}{#1}}
+\@onlypreamble@key{caption}{figurewithin}
+\DeclareCaptionOption{figurewithout}{\caption@Within{figure}{none}}
+\@onlypreamble@key{caption}{figurewithout}
+% \end{macrocode}
+% \begin{macrocode}
+\DeclareCaptionOption{tablewithin}{\caption@Within{table}{#1}}
+\@onlypreamble@key{caption}{tablewithin}
+\DeclareCaptionOption{tablewithout}{\caption@Within{table}{none}}
+\@onlypreamble@key{caption}{tablewithout}
+% \end{macrocode}
+% \begin{macro}{\caption@within}
+% \changes{v3.1}{2007/12/21}{This macro added}
+% \begin{macrocode}
+\newcommand*\caption@Within[1]{\def\caption@type{#1}\KV@caption@DCT@within}
+\@onlypreamble\caption@Within
+% \end{macrocode}
+% \end{macro}
+%
+% \subsubsection{Miscellaneous options}
+%
+% \begin{macrocode}
+\DeclareCaptionOption*{config}[caption]{%
+ \InputIfFileExists{#1.cfg}%
+ {\typeout{*** Local configuration file #1.cfg used ***}}%
+ {\caption@Warning{Configuration file #1.cfg not found}}}
+% \end{macrocode}
+%
+% \changes{v3.1f}{2007/11/28}{Option \opt{@minipage=} added}
+% \begin{macrocode}
+\DeclareCaptionOption{@minipage}{%
+ \caption@ifinlist{#1}{auto,default}%
+ {\let\caption@if@minipage\@gobbletwo}%
+ {\caption@set@bool\caption@if@minipage{#1}}}
+\captionsetup{@minipage=default}
+% \end{macrocode}
+%
+% \subsubsection{caption v1.x compatibility options}
% \changes{v3.1}{2007/07/21}{Option `compatibility' added}
% \changes{v3.1}{2007/09/01}{caption v1.x compatibility options revised}
% \changes{v3.1d}{2007/10/24}{Bugfix 07-10-24 in caption v1.x$ compatibility options}
@@ -3319,7 +3547,7 @@
\DeclareCaptionOptionNoValue*{ruled}{\caption@setbool{ruled}{1}}
% \end{macrocode}
%
-% \subsection{caption2 v2.x compatibility options}
+% \subsubsection{caption2 v2.x compatibility options}
% \changes{v3.0h}{2005/07/08}{caption2 \version{2.x} compatibility options added}
% \changes{v3.1}{2007/09/01}{caption2 v2.x compatibility options revised}
% \changes{v3.1d}{2007/10/24}{Bugfix 07-10-24 in caption v2.x$ compatibility options}
@@ -3340,7 +3568,7 @@
\caption@WarningNoLine{Obsolete option `ignoreLTcapwidth' ignored}}
% \end{macrocode}
%
-% \subsection{Obsolete caption v3.0 options}
+% \subsubsection{Obsolete caption v3.0 options}
% \changes{v3.1}{2007/05/07}{Package option \opt{caption} marked as obsolete,
% gives error now}
%
@@ -3354,7 +3582,7 @@
and do *not* load the caption package anymore}}}
% \end{macrocode}
%
-% \subsection{fltpage package support options}
+% \subsubsection{fltpage package support options}
%
% \changes{v3.1}{2007/09/01}{Options `FPlist' \& `FPref' added}
% With these options is controlled where the list-of entry and |\ref| resp.
@@ -3377,7 +3605,7 @@
\captionsetup{FPlist=caption,FPref=figure}
% \end{macrocode}
%
-% \subsection{hyperref package support options}
+% \subsubsection{hyperref package support options}
%
% \changes{v3.1}{2007/06/21}{Options `hypcap' \& `hypcapspace' added}
% With |hypcap=off| one can turn the \package{hypcap} support off
@@ -3400,14 +3628,25 @@
\caption@ProcessOptions*{caption}
% \end{macrocode}
%
-% \subsection{Option `type', \cs{captionof} and \cs{ContinuedFloat}}
+% \subsection{\cs{captionof} and \cs{ContinuedFloat}}
%
% \changes{v3.0d}{2004/08/03}{Option \opt{type=} added}
% \changes{v3.1}{2007/06/25}{Option \opt{type*=} added}
+% \changes{v3.1f}{2007/11/16}{Option \opt{subtype} \& \opt{subtype*} added}
+%
% \begin{macrocode}
\caption@AtBeginDocument{%
- \DeclareCaptionOption{type}{\caption@settype{#1}}
- \DeclareCaptionOption{type*}{\caption@settype*{#1}}}
+% \end{macrocode}
+% \begin{macrocode}
+ \DeclareCaptionOption{type}{\caption@settype{#1}}%
+ \DeclareCaptionOption{type*}{\caption@settype*{#1}}%
+% \end{macrocode}
+% \begin{macrocode}
+ \DeclareCaptionOption{subtype}[sub\@captype]{\caption@setsubtype{#1}}%
+ \DeclareCaptionOption{subtype*}[sub\@captype]{\caption@setsubtype*{#1}}%
+% \end{macrocode}
+% \begin{macrocode}
+}
% \end{macrocode}
%
% \emph{Important Note:}
@@ -3419,13 +3658,15 @@
% \changes{v3.1}{2007/05/09}{This macro added}
% \changes{v3.1b}{2007/09/22}{Usage of \cs{caption@xlabel} added}
% \changes{v3.1d}{2007/10/23}{Error message for \cs{caption@checkgrouplevel} revised}
+% \changes{v3.1f}{2007/11/16}{\cs{caption@setsubtype} added}
+% \changes{v3.1f}{2007/12/03}{Crappy \cs{caption@iftypewarning} replaced}
% |\caption@settype*|\marg{type}\par
% sets |\@captype| and executes the options associated with it
% (using |\caption@setoptions|).
% Furthermore we check |\currentgrouplevel| (if avail),
% redefine |\@currentlabel| so a |\label| before |\caption| will result
% in a hint instead of a wrong reference, and
-% use the macro |\caption@settypehook| (which will be used by our
+% use the macro |\caption@|(|sub|)|typehook| (which will be used by our
% \package{float} package support).\par
% The non-starred version sets a \package{hyperref} anchor additionally
% (if |hypcap=true| and the \package{hypcap} package is not loaded).
@@ -3434,6 +3675,12 @@
\caption@@settype{}}
% \end{macrocode}
% \begin{macrocode}
+\newcommand*\caption@setsubtype{%
+ \caption@iftype
+ {\caption@@settype{sub}}%
+ {\caption@Error{Option `subtype=' outside float}}}%
+% \end{macrocode}
+% \begin{macrocode}
\newcommand*\caption@@settype[1]{%
\caption@teststar{\caption@@@settype{#1}}\@firstoftwo\@secondoftwo}
% \end{macrocode}
@@ -3442,41 +3689,51 @@
% #1 = "" or "sub"
% #2 = \@firstoftwo in star form, \@secondoftwo otherwise
% #3 = <type>, e.g. "figure" or "table"
- \caption@Debug{type=#3}%
- \caption@checkgrouplevel{#1}{%
- \captionsetup{#1type#2*\@empty=...}#2{ or \@backslashchar#1captionof}{}}%
+ \@ifundefined{c@#3}%
+ {\caption@Error{No float type '#3' defined}}%
+ {\caption@Debug{#1type=#3}%
+ \caption@checkgrouplevel{#1}{%
+ \captionsetup{#1type#2*\@empty=...}#2{ or
+ \@backslashchar#1captionof}{}}%
% \end{macrocode}
% \begin{macrocode}
- \@ifundefined{@#1captype}{}{%
- \edef\@tempa{#3}%
- \expandafter\ifx\csname @#1captype\endcsname\@tempa \else
- \caption@iftypewarning{\caption@Warning{%
- Caption type was already set to `#3'\MessageBreak}}{}%
- \fi}%
- \expandafter\edef\csname @#1captype\endcsname{#3}%
- \let\caption@iftypewarning\caption@ifdebug
+ \edef\@tempa{#3}%
+ \expandafter\ifx\csname @#1captype\endcsname\@tempa \else
+ \@nameuse{caption@#1type@warning}%
+ \fi
+ \expandafter\let\csname @#1captype\endcsname\@tempa
% \end{macrocode}
% \begin{macrocode}
- \@nameuse{#1caption@settypehook}%
- \expandafter\caption@setoptions\csname @#1captype\endcsname
+ \@nameuse{caption@#1typehook}%
% \end{macrocode}
% \begin{macrocode}
- \let\caption@ifrefstepcounter\@secondoftwo
- #2{}{%
- \let\@currentlabel\caption@undefinedlabel
-% \let\@currentHlabel\@undefined
- \ifx\caption@ORI@label\@undefined
- \let\caption@ORI@label\label
- \def\label{\caption@withoptargs\caption@xlabel}%
- \fi
- \caption@start}}
+ \caption@setoptions{#3}%
+ \ifx\caption@opt\relax
+ \@nameundef{caption@#1type@warning}%
+ \else
+ \@namedef{caption@#1type@warning}{\caption@Warning{%
+ The #1caption type was already set to
+ `\csname @#1captype\endcsname'\MessageBreak}}%
+ \fi
+% \end{macrocode}
+% \begin{macrocode}
+ \let\caption@ifrefstepcounter\@secondoftwo
+ #2{}{%
+ \let\@currentlabel\caption@undefinedlabel
+% \let\@currentHlabel\@undefined
+ \ifx\caption@ORI@label\@undefined
+ \let\caption@ORI@label\label
+ \let\label\caption@xlabel
+ \fi
+ \caption@start}}}
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\caption@settypehook}
-% Hook, will be extended by our \package{float} package support.
+% \begin{macro}{\caption@typehook}
+% Hook, will be extended later on, e.g.~by our \package{float} package
+% support.
% \begin{macrocode}
-\newcommand*\caption@settypehook{}
+\newcommand*\caption@typehook{}
% \end{macrocode}
% \end{macro}
%
@@ -3500,9 +3757,10 @@
%
% \begin{macro}{\caption@checkgrouplevel}
% \changes{v3.1}{2007/07/15}{This macro and its usage added}
+% \changes{v3.1f}{2007/11/28}{Error changed to warning (compatibility)}
% Checks if |\captionsetup{type=|\ldots|}| or |\caption| is done
-% inside a group or not -- in the latter case an error will be issued.
-% (needs \eTeX)
+% inside a group or not -- in the latter case a warning message will
+% be issued. (needs \eTeX)
% \begin{macrocode}
\begingroup\expandafter\expandafter\expandafter\endgroup
\expandafter\ifx\csname currentgrouplevel\endcsname\relax
@@ -3517,7 +3775,7 @@
\expandafter\edef\csname #1caption@grouplevel\endcsname{%
\the\currentgrouplevel}%
\else
- \caption@Error{\string#2\MessageBreak outside box or environment}%
+ \caption@Warning{\string#2\MessageBreak outside box or environment}%
\fi
}{}}
\fi
@@ -3536,16 +3794,18 @@
% \end{macro}
% \begin{macro}{\caption@xlabel}
% \changes{v3.1b}{2007/09/22}{This macro and its usage added}
+% \changes{v3.1f}{2007/11/11}{Revised}
% The new code of |\label| inside floating environments.
% |\label| will be redefined using |\caption@withoptargs|, so
% |#1| are the optional arguments (if any), and
% |#2| is the mandatory argument here.
% \begin{macrocode}
-\newcommand*\caption@xlabel[2]{%
+\newcommand*\caption@xlabel{%
\ifx\@currentlabel\caption@undefinedlabel
\caption@Warning{\noexpand\label before \noexpand\caption ignored}%
+ \expandafter\@gobble
\else
- \caption@ORI@label#1{#2}%
+ \expandafter\caption@ORI@label
\fi}
% \end{macrocode}
% \end{macro}
@@ -3570,6 +3830,7 @@
%
% \begin{macro}{\captionlistentry}
% \changes{v3.1}{2007/07/28}{This macro added}
+% \changes{v3.1f}{2007/11/16}{Bugfix 07-11-09: `space hack' added}
% |\captionlistentry|\oarg{float type}\marg{list entry}
% \begin{macrocode}
\newcommand*\captionlistentry{%
@@ -3577,9 +3838,11 @@
% \end{macrocode}
% \begin{macrocode}
\def\caption@listentry[#1]#2{%
- \caption@refstepcounter{#1}%
- \caption@makecurrent{#1}{#2}%
- \caption@addcontentsline{#1}{#2}}
+ \@bsphack
+ \caption@refstepcounter{#1}%
+ \caption@makecurrent{#1}{#2}%
+ \caption@addcontentsline{#1}{#2}%
+ \@esphack}
% \end{macrocode}
% \end{macro}
%
@@ -3674,10 +3937,14 @@
%
% \begin{macro}{\caption@dblarg}
% \changes{v3.1}{2007/02/05}{This macro added}
+% \changes{v3.1f}{2007/12/06}{Bugfix 07-12-06: Changed so it works without \cs{kernel@ifnextchar}
+% (which was introduced in \LaTeXe\ 2004/01/23), too}
% A |\relax| was added compared to |\@dblarg| so |\caption{}| will be
% expanded to |\caption[\relax]{}| (and not to |\caption[]{}|).
% \begin{macrocode}
-\newcommand\caption@dblarg[1]{\kernel@ifnextchar[{#1}{\caption@xdblarg{#1}}}%
+\@ifundefined{kernel@ifnextchar}%
+ {\newcommand\caption@dblarg[1]{\@ifnextchar[{#1}{\caption@xdblarg{#1}}}}%
+ {\newcommand\caption@dblarg[1]{\kernel@ifnextchar[{#1}{\caption@xdblarg{#1}}}}%
\newcommand\caption@xdblarg[2]{#1[{#2\relax}]{#2}}%
% \end{macrocode}
% \end{macro}
@@ -3753,21 +4020,6 @@
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\caption@addcontentsline}
-% If |\sf@ifpositiontop| is defined, we extend |\caption@addcontentsline|
-% so it handles sub-captions, too.
-% \begin{macrocode}
-\caption@AtBeginDocument*{%
- \@ifundefined{sf@ifpositiontop}{}{%
- \let\caption@kernel@addcontentsline\caption@addcontentsline
- \renewcommand*\caption@addcontentsline[2]{%
- \sf@ifpositiontop{\@listsubcaptions{#1}}{}%
- \caption@kernel@addcontentsline{#1}{#2}%
- \sf@ifpositiontop{}{\@listsubcaptions{#1}}}%
- }}
-% \end{macrocode}
-% \end{macro}
-%
% \begin{macro}{\caption@boxrestore}
% \changes{v3.1}{2007/03/03}{This macro and its usage added}
% \changes{v3.1b}{2007/09/17}{Bugfix: Redefinition of CR added}
@@ -4141,7 +4393,7 @@
% \begin{macrocode}
\@ifundefined{caption@ifcompatibility}%
{\let\caption@ifcompatibility\caption@ifincompatible
- \let\@tempa\@firstofone}%
+ \let\@tempa\caption@WarningNoLine}%
{\let\@tempa\@gobble}% suppress warning
% \end{macrocode}
%
@@ -4151,12 +4403,9 @@
%
% \begin{macrocode}
\@tempa{%
- \caption@WarningNoLine{%
- \noexpand\caption will not be redefined since it's already\MessageBreak
- redefined by a document class or package which is\MessageBreak
- unknown to the caption package.\MessageBreak
- As a result some features will not work as expected}%
- }%
+ \noexpand\caption will not be redefined since it's already\MessageBreak
+ redefined by a document class or package which is\MessageBreak
+ unknown to the caption package}%
% \end{macrocode}
%
% |\ContinuedFloat| is not supported in compatibility mode.
@@ -4196,8 +4445,7 @@
\caption@WarningNoLine{%
Forced redefinition of \noexpand\caption since the\MessageBreak
unsupported(!) package option `compatibility=false'\MessageBreak
- was given. Please fasten your seat belts, as we may\MessageBreak
- experience turbulence}%
+ was given}%
}{}%
% \end{macrocode}
%
@@ -4236,6 +4484,8 @@
%
% \begin{macro}{\@caption}
% \changes{v3.1}{2007/02/04}{Re-written, does not save\&use original definition anymore}
+% \changes{v3.1f}{2007/11/28}{Bugfix: Handling of \texttt{@minipage} flag added}
+% \changes{v3.1f}{2007/11/28}{Support of option \opt{@minipage} added}
% As above, our version has been adapted to the packages we support.
% Additionally our code is nested by |\caption@beginex| \&
% |\caption@end| instead of |\begingroup| \& |\endgroup|.
@@ -4259,12 +4509,16 @@
\caption@beginex{#1}{#2}{#3}%
\caption@setfloatcapt{%
\caption@boxrestore
+ \if@minipage
+ \@setminipage
+ \fi
\caption@normalsize
\ifcaption@star
\let\caption@@anchor\@firstofone
\fi
\@makecaption{\csname fnum@#1\endcsname}%
- {\ignorespaces\caption@@anchor{#3}}\par}%
+ {\ignorespaces\caption@@anchor{#3}}\par
+ \caption@if@minipage\@minipagetrue\@minipagefalse}%
\caption@end}%
% \end{macrocode}
% \end{macro}
@@ -4297,7 +4551,6 @@
% \end{macrocode}
%
% \begin{macro}{\@makecaption}
-% \changes{v3.1}{2007/03/10}{\cs{nobreak}s added, needed for beamer class}
% |\@makecaption|\marg{label}\marg{text}\par
% We do basically the same as the original code (from the standard
% \LaTeX\ document classes), but take care of the |position=| setting
@@ -4311,6 +4564,151 @@
% \end{macrocode}
% \end{macro}
%
+% \subsection{Support for sub-captions}
+% \changes{v3.1f}{2007/11/16}{Support for sub-captions added}
+%
+% \begin{macro}{\caption@DeclareSubType}
+% |\caption@DeclareSub| initializes the usage of \cs{caption}
+% in sub-floats.
+% \begin{macrocode}
+\def\caption@DeclareSubType sub#1\@nil{%
+ \caption@Debug{Initializing subtype for `#1'\@gobble}%
+ \@namedef{subcaption@value#1}{0}%
+ \@namedef{caption@beginsub#1}{\caption@beginsubfloat{#1}}}
+\@onlypreamble\caption@DeclareSubType
+% \end{macrocode}
+% \end{macro}
+%
+% Initialize the sub-captions defined with \cs{DeclareCaptionSubType}\ldots
+% \begin{macrocode}
+\caption@For*{subtypelist}{\caption@DeclareSubType sub#1\@nil}
+% \end{macrocode}
+%
+% Initialize the sub-captions defined with \cs{newsubfloat}\cite{subfig}\ldots
+% \begin{macrocode}
+\caption@AtBeginDocument*{%
+ \@ifundefined{sf@counterlist}{}{%
+ \@for\sf@temp:=\sf@counterlist\do{%
+ \expandafter\caption@DeclareSubType\sf@temp\@nil}}}
+% \end{macrocode}
+%
+% \begin{macro}{\caption@subtypehook}
+% Hook, will be used inside \cs{caption@setsubtype}.
+% \begin{macrocode}
+\newcommand*\caption@subtypehook{%
+ \ifx\caption\caption@subcaption \else
+% \end{macrocode}
+% \begin{macrocode}
+ \caption@ifrefstepcounter{}{%
+ % no \caption or \subcaption in this (floating) environment yet
+ \caption@Debug{Increment \@captype\ counter =\the\value\@captype}%
+ \caption@l@stepcounter\@captype
+ \let\addcontentsline\subcaption@addcontentsline}%
+% \end{macrocode}
+% \begin{macrocode}
+ \ifnum\csname subcaption@value\@captype\endcsname=\value\@captype \else
+ \caption@Debug{Reset sub\@captype\ counter}%
+ \expandafter\xdef\csname subcaption@value\@captype\endcsname{%
+ \the\value\@captype}%
+ \@stpelt\@subcaptype
+ \fi
+% \end{macrocode}
+% \begin{macrocode}
+ \c@ContinuedFloat=0\relax
+ \let\caption@resetContinuedFloat\@gobble
+ \let\caption@addcontentsline\caption@kernel@addcontentsline
+ \let\caption@setfloatcapt\@firstofone
+% \end{macrocode}
+% \begin{macrocode}
+ \caption@clearmargin
+ \caption@setoptions{sub}%
+ \caption@setoptions{subfloat}% for subfig-package compatibility
+% \end{macrocode}
+% \begin{macrocode}
+ \let\caption\caption@subcaption
+ \fi}%
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\caption@subcaption}
+% Makes a sub-caption.
+% \begin{macrocode}
+\newcommand*\caption@subcaption{%
+ \caption@iftype
+ {\caption@checkgrouplevel{sub}\subcaption
+ \caption@star
+ {\caption@refstepcounter\@subcaptype}%
+ {\caption@dblarg{\@caption\@subcaptype}}}%
+ {\caption@Error{\noexpand\subcaption outside float}}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\caption@addcontentsline}
+% We extend |\caption@addcontentsline| so it handles sub-captions, too.
+% \Note{\cs{sf@ifpositiontop} \& \cs{@listsubcaptions} are defined by the
+% \package{subfigure} \& \package{subfig} packages.}
+% \begin{macrocode}
+\let\caption@kernel@addcontentsline\caption@addcontentsline
+\renewcommand*\caption@addcontentsline[2]{%
+ \sf@ifpositiontop{\@listsubcaptions{#1}}{}%
+ \caption@kernel@addcontentsline{#1}{#2}%
+ \sf@ifpositiontop{}{\@listsubcaptions{#1}}%
+ \caption@addsubcontentslines{#1}}
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\caption@addsubcontentslines[1]{%
+ \begingroup
+ \subcaption@addcontentslines
+ \endgroup
+ \subcaption@clearcontentslines}%
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\caption@AtBeginDocument*{%
+ \@ifundefined{sf@ifpositiontop}{\let\sf@ifpositiontop\@gobbletwo}{}%
+ \subcaption@clearcontentslines
+ \g@addto@macro\caption@typehook{\subcaption@checkcontentslines}%
+ \AtEndDocument{\subcaption@checkcontentslines}}%
+% \end{macrocode}
+%
+% \begin{macro}{\subcaption@addcontentsline}
+% Add a pending sub-caption list entry.
+% \begin{macrocode}
+\newcommand*\subcaption@addcontentsline[3]{%
+ \protected@edef\@tempa{%
+ \noexpand\g@addto@macro\noexpand\subcaption@addcontentslines{%
+ \noexpand\@namedef{the#2}{\csname the#2\endcsname}%
+ \ifx\@currentHref\@undefined \else
+ \noexpand\def\noexpand\@currentHref{\@currentHref}%
+ \fi
+ \protect\addcontentsline{#1}{#2}{#3}}}%
+ \@tempa}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\subcaption@checkcontentslines}
+% Checks if the list of pending sub-captions is empty, if not,
+% a warning will be issued.
+% \begin{macrocode}
+\newcommand*\subcaption@checkcontentslines{%
+ \ifx\subcaption@addcontentslines\@empty \else
+ \subcaption@Error{%
+ Something's wrong--perhaps a missing \protect\caption\MessageBreak
+ in the last figure or table}%
+ \subcaption@clearcontentslines
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\subcaption@clearcontentslines}
+% Clear pending sub-caption list entries.
+% \begin{macrocode}
+\newcommand*\subcaption@clearcontentslines{%
+ \global\let\subcaption@addcontentslines\@empty}
+% \end{macrocode}
+% \end{macro}
+%
% \subsection{Document class \& Babel package support}
%
% \subsubsection{The \AmS{} \& \SmF{} classes}
@@ -4331,11 +4729,34 @@
% Since the beamer class do not offer a `list of figures' we switch
% this support in \thispackage\ off.
% \begin{macrocode}
- \captionsetup{listof=false}
- \undefine@key{caption}{listof}
- \undefine@key{caption}{listofformat}
+ \captionsetup{list=false}
+ \DeclareCaptionOption{list}{}
+ \DeclareCaptionOption{listof}{}
% \end{macrocode}
%
+% \begin{macro}{\figure}
+% \changes{v3.1f}{2007/12/17}{This re-definition for \class{beamer} document class added}
+% \begin{macro}{\table}
+% \changes{v3.1f}{2007/12/17}{This re-definition for \class{beamer} document class added}
+% We redefine |figure| \& |table| so our type-specific options will be used,
+% a \package{hyperref} anchor will be set etc.
+% \begin{macrocode}
+ \expandafter\let\expandafter\caption@ORI@figure
+ \csname\string\figure\endcsname
+ \@namedef{\string\figure}[#1]{%
+ \caption@ORI@figure[#1]%
+ \caption@settype{figure}}
+% \end{macrocode}
+% \begin{macrocode}
+ \expandafter\let\expandafter\caption@ORI@table
+ \csname\string\table\endcsname
+ \@namedef{\string\table}[#1]{%
+ \caption@ORI@table[#1]%
+ \caption@settype{table}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
% \begin{macrocode}
}{}
% \end{macrocode}
@@ -4511,6 +4932,7 @@
% \changes{v3.1}{2007/07/22}{This macro added}
% \changes{v3.1c}{2007/10/06}{\cs{caption} \& \cs{@caption} revised for enhanced compatibility}
% \changes{v3.1c}{2007/10/06}{Bugfix: Made \cs{@caption} long}
+% \changes{v3.1f}{2007/11/16}{Uses `space hack' instead of \cs{ignorespaces} now}
% |\caption@freeze*|\par
% Used by the \package{fltpage} \& \package{sidecap} package support.
% \begin{macrocode}
@@ -4547,10 +4969,12 @@
\let\caption@@refstepcounter\caption@l@stepcounter
\caption@ORI}%
\long\def\@caption##1[##2]##3{%
- \gdef\caption@SClentry{##2}\gdef\caption@SCtext{##3}%
- \ignorespaces}%
+ \@bsphack
+ \gdef\caption@SClentry{##2}%
+ \gdef\caption@SCtext{##3}%
+ \@esphack}%
#1{% is \@gobble in star form, and \@firstofone otherwise
- \def\label##1{\gdef\caption@SClabel{##1}\ignorespaces}}%
+ \def\label##1{\@bsphack\gdef\caption@SClabel{##1}\@esphack}}%
% \end{macrocode}
% \begin{macrocode}
}%
@@ -4690,7 +5114,7 @@
% \end{macrocode}
% \end{macro}
%
-% \begin{macro}{\caption@settypehook}
+% \begin{macro}{\caption@typehook}
% \changes{v3.1}{2007/07/08}{float package hook added}
% \LaTeX\ and almost every other packages use
% |\|\meta{type}|name|
@@ -4709,7 +5133,7 @@
% \Note{If the float was not defined with \cs{newfloat} but with
% \cs{restylefloat} instead, \cs{fname@}\meta{type} is not defined.}
% \begin{macrocode}
- \g@addto@macro\caption@settypehook{%
+ \g@addto@macro\caption@typehook{%
\expandafter\ifx\csname #1name\endcsname\relax
\expandafter\let\csname #1name\expandafter\endcsname
\csname fname@#1\endcsname
@@ -4950,6 +5374,7 @@
% \end{macro}
%
% \begin{macro}{\FP@floatBegin}
+% \changes{v3.1f}{2007/11/16}{Uses `space hack' instead of \cs{ignorespaces} now}
% Original code:
% \begin{verbatim}
% \newcommand{\FP@floatBegin}[1]{%
@@ -4975,7 +5400,7 @@
\begin{lrbox}{\FP@floatCorpusBOX}%
\caption@ifFPrefcap
{\caption@freeze\relax}%
- {\def\label##1{\gdef\FP@LabelText{##1}\ignorespaces}%
+ {\def\label##1{\@bsphack\gdef\FP@LabelText{##1}\@esphack}%
\caption@freeze*}}%
% \end{macrocode}
% \end{macro}
@@ -5065,7 +5490,7 @@
%
% \changes{v3.1a}{2007/09/07}{\cs{DeclareFloatingEnvironment} defines FP-variant, too}
% \begin{macrocode}
- \ForFloatingEnvironments{%
+ \caption@For{typelist}{%
\newenvironment{FP#1}{\FP@floatBegin{#1}}{\FP@floatEnd}}%
% \end{macrocode}
%
@@ -5277,7 +5702,7 @@
% \end{macrocode}
% \Note{Since \cs{Hy@raisedlink} change \cs{@tempdima} we surrounded it by \cs{ifvmode},
% suppressing ``\texttt{LaTeX Warning: Float too large for page by 1.0pt}'' in \texttt{sideways} floats.
-% (This will not be necessary with future versions of \package{hyperref}.)}
+% (This is not necessary since \package{hyperref} \version{6.77}.)}
% \begin{macrocode}
\ifx\HyperRaiseLinkLength\@tempdima
\def\caption@raisedlink#1{\ifvmode#1\else\Hy@raisedlink{#1}\fi}%
@@ -5309,7 +5734,7 @@
% \iffalse
% (Since |\caption@setfloatcapt| will be set to |\@firstofone| inside
% |\subcaption| there is no need to add its restauration to
-% |\subcaption@settypehook|.)
+% |\caption@subtypehook|.)
% \fi
% \begin{macrocode}
\def\caption@freezeHref{%
@@ -5318,7 +5743,7 @@
% \end{macrocode}
% \begin{macrocode}
% \let\caption@ORI@@start\caption@@start
-% \l@addto@macro\subcaption@settypehook{%
+% \l@addto@macro\caption@subtypehook{%
% \let\caption@@start\caption@ORI@@start}%
% \end{macrocode}
% \begin{macrocode}
@@ -5784,6 +6209,7 @@
% \end{macro}
%
% \begin{macro}{\make@piccaption}
+% \changes{v3.1}{2007/12/06}{Bugfix: \cs{caption@clearmargin} will always be used now}
% The original code:
% \begin{verbatim}
% \def\make@piccaption{%
@@ -5814,11 +6240,11 @@
\long\def\caption[##1]##2{%
\caption@freezeHref % will be defrosted in \ivparpic
\caption@settype\@piccaptype
- \ifnum\c@piccaptionpos>2\relax
+% \ifnum\c@piccaptionpos>2\relax
\caption@clearmargin
- \else
- \captionwidth\z@ % do not use "width=" setting
- \fi
+% \else
+% \captionwidth\z@ % do not use "width=" setting
+% \fi
\caption@setoptions{parpic}%
\let\caption@boxrestore\@parboxrestore
\caption@setautoposition b%
@@ -5900,7 +6326,7 @@
%
% \begin{macro}{\@makerotcaption}
% \changes{v3.0i}{2005/12/06}{Rewritten, should finally work proper now}
-% \changes{v3.0m}{2007/03/04}{Uses \cs{captionbox} instead of \cs{caption@start/endbox} now}
+% \changes{v3.0m}{2007/03/04}{Uses \cs{caption@parbox} instead of \cs{caption@start/endbox} now}
% Original (bugfixed) code:
% \begin{verbatim}
% \long\def\@makerotcaption#1#2{%
@@ -5928,9 +6354,9 @@
\caption@slc{#1}{#2}{.8\vsize}{%
\let\caption@makerot\caption@@make
\caption@clearmargin
-% \long\def\captionbox##1##2{\hbox{\hsize=.8\textheight\relax##2}}%
+% \long\def\caption@parbox##1##2{\hbox{\hsize=.8\textheight\relax##2}}%
% (not needed because \rotatebox uses an \hbox anyway)
- \let\captionbox\@secondoftwo}%
+ \let\caption@parbox\@secondoftwo}%
\caption@set@bool\caption@ifslc0% been there, done that
\fi
% \end{macrocode}
@@ -5948,7 +6374,7 @@
%
% \changes{v3.1a}{2007/09/07}{\cs{DeclareFloatingEnvironment} defines sideways-variant, too}
% \begin{macrocode}
- \ForFloatingEnvironments{%
+ \caption@For{typelist}{%
\newenvironment{sideways#1}{\@rotfloat{#1}}{\end@rotfloat}%
\newenvironment{sideways#1*}{\@rotdblfloat{#1}}{\end@rotdblfloat}}%
% \end{macrocode}
@@ -6064,12 +6490,17 @@
% \end{macro}
%
% \changes{v3.1a}{2007/09/07}{\cs{DeclareFloatingEnvironment} defines SC-variant, too}
+% \changes{v3.1f}{2007/12/23}{Bugfix in definition of SC-variant}
% \begin{macrocode}
- \ForFloatingEnvironments{%
- \newenvironment{SC#1}%
- {\SC@float[\@nameuse{SC@#1@vpos}]{#1}}{\endSC@float}%
- \newenvironment{SC#1*}%
- {\SC@dblfloat[\@nameuse{SC@#1@vpos}]{#1}}{\endSC@dblfloat}}%
+ \newcommand*\caption@For@SC[2]{%
+ \def#1{b}% = \sidecaptionvpos{#2}{b} (v1.6)
+ \newenvironment{SC#2}%
+ {\SC@float[#1]{#2}}{\endSC@float}%
+ \newenvironment{SC#2*}%
+ {\SC@dblfloat[#1]{#2}}{\endSC@dblfloat}}%
+ \@onlypreamble\caption@For@SC
+ \caption@For{typelist}{%
+ \expandafter\caption@For@SC\csname SC@#1@vpos\endcsname{#1}}%
% \end{macrocode}
%
% \begin{macrocode}
@@ -6321,7 +6752,7 @@
%
% \changes{v3.1a}{2007/09/07}{\cs{DeclareFloatingEnvironment} defines wrap-variant, too}
% \begin{macrocode}
- \ForFloatingEnvironments{%
+ \caption@For{typelist}{%
\newenvironment{wrap#1}{\wrapfloat{#1}}{\endwrapfloat}%
\caption@restylewrapfloat{#1}}%
% \end{macrocode}
@@ -6451,7 +6882,7 @@
% Sebastian Rahtz \& Heiko Oberdiek:\\
% \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}%
% {\emph{Hypertext marks in \LaTeX}},\\
-% June 14, 2007
+% November 12, 2007
%
% \bibitem{hypcap}
% Heiko Oberdiek:\\
diff --git a/Master/texmf-dist/source/latex/caption/caption.ins b/Master/texmf-dist/source/latex/caption/caption.ins
index 9d140a7027f..d950ea13334 100644
--- a/Master/texmf-dist/source/latex/caption/caption.ins
+++ b/Master/texmf-dist/source/latex/caption/caption.ins
@@ -23,9 +23,9 @@ This work has the LPPL maintenance status "maintained".
This Current Maintainer of this work is Axel Sommerfeldt.
This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-caption-eng.tex, and caption-rus.tex.
+ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
\endpreamble
@@ -33,12 +33,13 @@ caption-eng.tex, and caption-rus.tex.
\file{caption3.sty}{\from{caption.dtx}{kernel}}}
\generate{\file{caption2.sty}{\from{caption2.dtx}{package}}}
\generate{\file{ltcaption.sty}{\from{ltcaption.dtx}{package}}}
+\generate{\file{subcaption.sty}{\from{subcaption.dtx}{package}}}
\Msg{***********************************************************}
\Msg{*}
\Msg{* To finish the installation you have to move the files}
\Msg{* `caption.sty', `caption2.sty', 'caption3.sty',}
-\Msg{* and `ltcaption.sty'}
+\Msg{* `ltcaption.sty', and `subcaption.sty'}
\Msg{* into a directory searched by TeX.}
\Msg{*}
\Msg{* To produce the documentation run the file}
diff --git a/Master/texmf-dist/source/latex/caption/caption2.dtx b/Master/texmf-dist/source/latex/caption/caption2.dtx
index 522ce87c581..0d18ff7868e 100644
--- a/Master/texmf-dist/source/latex/caption/caption2.dtx
+++ b/Master/texmf-dist/source/latex/caption/caption2.dtx
@@ -19,9 +19,9 @@
% This Current Maintainer of this work is Axel Sommerfeldt.
%
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-% caption-eng.tex, and caption-rus.tex.
+% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
% \fi
% \CheckSum{846}
@@ -30,7 +30,7 @@
%<*driver>
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesFile{caption2.drv}%
- [2007/09/10 v2.2 Documentated code of the (obsolete) caption2 package]
+ [2007/11/28 v2.2 Documentated code of the (obsolete) caption2 package]
\hbadness=9999 \newcount\hbadness \hfuzz=100pt % Make TeX shut up.
%\errorcontextlines=3
%
@@ -46,7 +46,8 @@
\fi
%
\usepackage{hypdoc}
-\hypersetup{pdfkeywords={LaTeX, package, caption2},pdfstartview={}}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{pdfkeywords={LaTeX, package, caption2},pdfstartpage={},pdfstartview={}}
%
\usepackage{caption2}[2007/08/12]
%
@@ -105,7 +106,7 @@
% very far with this\ldots
%
% In 2003 I finally found some (more) time, so a new regular release $3.0$
-% of the \package{caption} package could be build in coorparation with
+% of the \package{caption} package could be build in cooperation with
% Frank Mittelbach and Steven Cochran.
% It was released in December 2003 and superseded the neglected
% \package{caption2} package.
@@ -119,11 +120,15 @@
% that the \package{caption2} package should be used instead of the
% \package{caption} package -- these hints are outdated since December 2003.
%
+% \vfill
+% \bigskip
+% \pagebreak[4]
+%
% \section*{How to migrate to the regular \package{caption} package?}
%
% Usually replacing \package{caption2} by \package{caption} is sufficient
% because the \package{caption} package emulates most of the options and
-% commands of the \package{caption2} package.
+% commands offered by the \package{caption2} package.
% If you get some errors or wired results afterwards, please take a closer
% look at the \package{caption} package documentation which will hopefully
% help you clearing these problems. You will also find a section called
@@ -134,10 +139,10 @@
% \section*{What will happen to this package?}
%
% The \package{caption2} package is still some kind of supported, that means
-% it will be part of future releases and bugs will still be fixed so existing
-% documents using this package will still compile.
-% But it will \emph{not} be enhanced in the future or adapted to future versions
-% of foreign packages.
+% it will be part of future releases of the \package{caption} package bundle,
+% and bugs will still be fixed so existing documents using this package will
+% still compile.
+% But it will \emph{not} be enhanced in the future.
%
% This means migrating to the actual \package{caption} package should not be
% necessary for old documents -- they should still compile fine as they are.
@@ -147,8 +152,9 @@
% \StopEventually{}
%
% \DoNotIndex{\\,\_,\ ,\@@par}
-% \DoNotIndex{\@classoptionslist,\@currext,\@currname}
-% \DoNotIndex{\@ehc,\@ehd,\@empty,\@expandtwoargs}
+% \DoNotIndex{\@bsphack}
+% \DoNotIndex{\@car,\@cdr,\@classoptionslist,\@cons,\@currext,\@currname}
+% \DoNotIndex{\@ehc,\@ehd,\@empty,\@esphack,\@expandtwoargs}
% \DoNotIndex{\@for,\@firstofone,\@firstoftwo}
% \DoNotIndex{\@gobble,\@gobblefour,\@gobbletwo,\@hangfrom}
% \DoNotIndex{\@ifnextchar,\@ifstar,\@ifundefined,\@latex@error}
@@ -205,18 +211,18 @@
\PackageWarning{caption2}{%
****************************************************\MessageBreak
THIS PACKAGE IS OBSOLETE:\MessageBreak
- This package attempts to provide an caption 2.0/2.1\MessageBreak
- author environment so that OLD documents can be\MessageBreak
- successfully processed.\MessageBreak
- It should NOT be used for NEW documents! New\MessageBreak
- documents should use the caption package instead.\MessageBreak
+ This package attempts to provide an `caption2'\MessageBreak
+ package v2.0/2.1 author environment so that OLD\MessageBreak
+ documents can be successfully processed. It should\MessageBreak
+ NOT be used for NEW documents! New documents should\MessageBreak
+ use the regular `caption' package v3.x instead.\MessageBreak
****************************************************\@gobbletwo}%
% \end{macrocode}
%
% \subsection{Loading the caption3 kernel}
%
% \begin{macrocode}
-\RequirePackage{caption3}[2007/08/12] % needs v3.1 or newer
+\RequirePackage{caption3}[2007/09/01] % needs v3.1 or newer
% \end{macrocode}
%
% \subsection{Check against the regular caption package}
@@ -540,7 +546,7 @@
% \end{macrocode}
% \end{macro}
%
-% \subsection{Options}
+% \subsection{Declaration of options}
%
% \begin{macro}{normal}
% \begin{macro}{center}
@@ -693,7 +699,9 @@
% \end{macrocode}
% \end{macro}
%
-% That's it! Now set the default values and start processing the options.
+% \subsection{Execution of options}
+%
+% Now we set the default values and start processing the options.
% (If \cs{caption@twozero} is set to true (default) we will emulate the package
% load algorithm of \textsf{caption} v2.0: If the package is already loaded
% patch it, otherwise do nothing.)
diff --git a/Master/texmf-dist/source/latex/caption/ltcaption.dtx b/Master/texmf-dist/source/latex/caption/ltcaption.dtx
index 299c7e6f8f2..31bcfcb3d35 100644
--- a/Master/texmf-dist/source/latex/caption/ltcaption.dtx
+++ b/Master/texmf-dist/source/latex/caption/ltcaption.dtx
@@ -19,9 +19,9 @@
% This Current Maintainer of this work is Axel Sommerfeldt.
%
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-% caption-eng.tex, and caption-rus.tex.
+% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%
% \fi
% \CheckSum{333}
@@ -49,7 +49,8 @@
\makeatletter\let\LT@makecaption@ORI\LT@makecaption\makeatother
%
\usepackage{hypdoc}
-\hypersetup{pdfkeywords={LaTeX, package, ltcaption},pdfstartview={}}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{pdfkeywords={LaTeX, package, ltcaption},pdfstartpage={},pdfstartview={}}
%
\usepackage{ltcaption}[2007/09/01]
%\usepackage[LTcapwidthtotable]{fr-longtable}
@@ -374,8 +375,9 @@
% \fi
%
% \DoNotIndex{\\,\_,\ ,\@@par}
-% \DoNotIndex{\@classoptionslist,\@currext,\@currname}
-% \DoNotIndex{\@ehc,\@ehd,\@empty,\@expandtwoargs}
+% \DoNotIndex{\@bsphack}
+% \DoNotIndex{\@car,\@cdr,\@classoptionslist,\@cons,\@currext,\@currname}
+% \DoNotIndex{\@ehc,\@ehd,\@empty,\@esphack,\@expandtwoargs}
% \DoNotIndex{\@for,\@firstofone,\@firstoftwo}
% \DoNotIndex{\@gobble,\@gobblefour,\@gobbletwo,\@hangfrom}
% \DoNotIndex{\@ifnextchar,\@ifpackagelater,\@ifpackageloaded}
diff --git a/Master/texmf-dist/source/latex/caption/subcaption.dtx b/Master/texmf-dist/source/latex/caption/subcaption.dtx
new file mode 100644
index 00000000000..0aa97c2b03b
--- /dev/null
+++ b/Master/texmf-dist/source/latex/caption/subcaption.dtx
@@ -0,0 +1,868 @@
+% \iffalse meta-comment
+%
+% This is file `subcaption.dtx'.
+%
+% Copyright (C) 2007 Axel Sommerfeldt (caption@sommerfee.de)
+%
+% --------------------------------------------------------------------------
+%
+% This work 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".
+%
+% This Current Maintainer of this work is Axel Sommerfeldt.
+%
+% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
+% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
+%
+% \fi
+% \CheckSum{144}
+%
+% \iffalse
+%<*driver>
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesFile{subcaption.drv}[2007/12/06 v0.3 Adds a sub-caption feature to the caption package]
+\hbadness=9999 \newcount\hbadness \hfuzz=74pt % Make TeX shut up.
+%\errorcontextlines=3
+%
+\documentclass{ltxdoc}
+\setlength\parindent{0pt}
+\setlength\parskip{\smallskipamount}
+%
+\usepackage{ifpdf}
+\ifpdf
+ \usepackage{mathptmx,courier}
+ \usepackage[scaled=0.90]{helvet}
+ \addtolength\marginparwidth{15pt}
+\fi
+%
+\usepackage{array,slashbox}
+\IfFileExists{cat.eps}%
+ {\usepackage{graphicx}}%
+ {\IfFileExists{test/tlc2/cat.eps}%
+ {\usepackage{graphicx}\graphicspath{{test/tlc2/}}}%
+ {\usepackage[demo]{graphicx}}}
+%
+\usepackage{hypdoc}
+\ifpdf\usepackage{hypdestopt}\fi
+\hypersetup{pdfkeywords={LaTeX, package, subcaption},pdfstartpage={},pdfstartview={}}
+%
+\usepackage{caption}[2007/12/06] % needs v3.1f or newer
+\usepackage{subcaption}[2007/12/06]
+\DeclareCaptionSubType*[arabic]{table}
+\captionsetup[subtable]{labelformat=simple,labelsep=colon}
+%
+\newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}}
+\newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}}
+\newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}}
+\let\package\puresf
+\let\env\purett \let\opt\purett
+%
+\newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}}
+\newcommand*\csoarg[1]{\texttt{\char`\[#1\char`\]}}
+\newcommand*\version[2][]{$v#2$}
+\newcommand*\x{\discretionary{-}{}{}}
+\newcommand*\xx{\discretionary{}{}{}}
+%
+\usepackage{marvosym}
+\newcommand*\MARGINSYM[1]{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{#1}}}}
+\newenvironment{info}{\par\bigskip\csname info*\endcsname}{\csname endinfo*\endcsname}
+\newenvironment{info*}%
+ {\small
+ \MARGINSYM{\vbox to \ht\strutbox{\LARGE\Info}}%
+ \ignorespaces}%
+ {\par}
+%
+\begin{document}
+ \DocInput{subcaption.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% \let\subsectionautorefname\sectionautorefname
+% \let\subsubsectionautorefname\sectionautorefname
+%
+% \def\thispackage{the \package{subcaption} package}
+% \def\Thispackage{The \package{subcaption} package}
+%
+% \newcommand\NEWfeature{\NEW{New feature}}
+% \newcommand\NEWdescription{\NEW{New description}}
+%
+% \makeatletter
+% \newcommand*\Ref{\@ifstar{\@Ref\ref}{\@Ref\autoref}}
+% \newcommand*\@Ref[2]{#1{#2}: \textit{\nameref{#2}}}
+% \makeatother
+% \newcommand*\See[1]{\nopagebreak{\small (See #1)}}
+%
+% \GetFileInfo{subcaption.drv}
+% \let\docdate\filedate
+% \GetFileInfo{subcaption.sty}
+%
+% \title{\texorpdfstring{\Thispackage\thanks{%^^A
+% This package has version number \fileversion, last revised \filedate.}}%^^A
+% {The subcaption package}}
+% \author{Axel Sommerfeldt\\
+% \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}}
+% \date{\docdate}
+% \maketitle
+%
+% \begin{abstract}
+% This tiny package demonstrates the sub-caption feature of the
+% \package{caption} package.
+% \end{abstract}
+%
+% \subsection*{Introduction}
+% \begin{info*}
+% Prepared with either |\Declare|\x|Caption|\x|Sub|\x|Type| (offered by the
+% \package{caption} package) or |\new|\x|sub|\x|float| (offered by the
+% \package{subfig} package), the caption package option |subtype| becames
+% available, causing |\caption| to typeset a sub-caption instead of an
+% ordinary one.\par
+% This package demonstrates the usage of |\Declare|\x|Caption|\x|Sub|\x|Type|,
+% |\caption|\x|setup{sub|\x|type}|, and the internal hook
+% |\caption@sub|\x|type|\x|hook|.
+% \end{info*}
+%
+% \setcounter{tocdepth}{2}
+% \tableofcontents
+%
+% \vfill
+% \emph{Please note:}
+% This package is incompatible with the \package{subfigure} and \package{subfig}
+% packages.
+% \medskip
+%
+% \clearpage
+% \section{The user interface}
+%
+% Just load this package after the \package{caption} package, e.g.:
+% \begin{quote}
+% |\usepackage|\oarg{options}|{caption}|\\
+% |\usepackage|\oarg{options}|{subcaption}|
+% \end{quote}
+% The options for \thispackage\ are the same ones as for the \package{caption}
+% package, but specify settings which are used for sub-captions
+% \emph{additionally}.
+% In fact
+% \begin{quote}
+% |\usepackage|\oarg{options}|{subcaption}|
+% \end{quote}
+% is identical to
+% \begin{quote}
+% |\usepackage{subcaption}|\\
+% |\captionsetup[sub]|\marg{options}
+% \end{quote}
+%
+% \bigskip
+%
+% The default settings for |sub|captions are:
+% \begin{quote}
+% |margin=0pt,font+=small,labelformat=parens,labelsep=space,|\\
+% |skip=6pt,list=false,hypcap=false|
+% \end{quote}
+%
+% Options specified with |\usepackage[|\ldots|]{subcaption}| and
+% |\captionsetup[sub]{|\ldots|}| will override the ones specified by
+% |\captionsetup{|\ldots|}| and |\captionsetup[figure]{|\ldots|}|,
+% but are again overwritten by |\captionsetup[subfigure]{|\ldots|}|
+% (same for `table'). So finally we have the following order how
+% settings for subcaptions are applied:
+% \begin{enumerate}
+% \item global settings
+% {\small(|\usepackage[|\ldots|]{caption}| and |\captionsetup{|\ldots|}|)}
+% \item environmental settings
+% {\small(|\captionsetup[figure|\emph{ -or- }|table]{|\ldots|}|)}
+% \item local settings
+% {\small(|\captionsetup{|\ldots|}| inside |figure| or |table| environment)}
+% \item default `sub' settings
+% {\small(|margin=0pt,font+=small,|\ldots, see above)}
+% \item custom `sub' settings
+% {\small(|\usepackage[|\ldots|]{subcaption}| and |\captionsetup[sub]{|\ldots|}|)}
+% \item environmental `sub' settings
+% {\small(|\captionsetup[subfigure|\emph{ -or- }|subtable]{|\ldots|}|)}
+% \item local `sub' settings
+% {\small(|\captionsetup{|\ldots|}| inside |subfigure| or |subtable|)}
+% \end{enumerate}
+% An example:
+% \begin{quote}
+% |\usepackage[labelsep=quad,indention=10pt]{caption}|\\
+% |\usepackage[labelfont=bf,list=true]{subcaption}|\\
+% |\captionsetup[table]{textfont=it,position=top}|\\
+% |\captionsetup[subtable]{textfont=sf}|
+% \end{quote}
+% causes the captions inside |subtable| environments to be typeset with
+% the settings
+% \begin{quote}
+% |indention=10pt,position=top,margin=0pt,font=small,|\\
+% |labelformat=parens,labelsep=space,skip=6pt,hypcap=false,|\\
+% |labelfont=bf,list=true,textfont=sf|\quad.
+% \end{quote}
+%
+% \vfill\clearpage
+% \subsection{The \cs{subcaption} command}
+%
+% \DescribeMacro\subcaption
+% The easiest and most flexible method to apply a sub-caption is by using the
+% |\subcaption| command. Its syntax is analogous to the one of the |\caption|
+% command and shares its features:
+% \begin{quote}
+% |\subcaption|\oarg{list entry}\marg{heading}\\
+% |\subcaption*|\marg{heading}
+% \end{quote}
+% Please note that the |\subcaption| command \emph{must} be applied inside
+% its own box or environment.
+%
+% An example:
+% \begin{quote}
+% |\begin{figure}|\\
+% | \begin{minipage}[b]{.5\linewidth}|\\
+% | \centering\large A|\\
+% | \subcaption{A subfigure}\label{fig:1a}|\\
+% | \end{minipage}%|\\
+% | \begin{minipage}[b]{.5\linewidth}|\\
+% | \centering\large B|\\
+% | \subcaption{Another subfigure}\label{fig:1b}|\\
+% | \end{minipage}|\\
+% | \caption{A figure}\label{fig:1}|\\
+% |\end{figure}|
+% \end{quote}
+% gives the result:
+% \par\bigskip
+% \noindent\begin{minipage}{\linewidth}
+% \captionsetup{type=figure}
+% \begin{minipage}[b]{.5\linewidth}
+% \centering\large A
+% \subcaption{A subfigure}\label{fig:1a}
+% \end{minipage}%^^A
+% \begin{minipage}[b]{.5\linewidth}
+% \centering\large B
+% \subcaption{Another subfigure}\label{fig:1b}
+% \end{minipage}
+% \caption{A figure}\label{fig:1}
+% \end{minipage}
+%
+% \bigskip
+%
+% \begin{info}
+% Actually the |\subcaption| command is just a simple combination of
+% |\caption|\x|setup{sub|\x|type*}| and |\caption|.
+% Analogous to the |type| option, the |subtype| option (both offered by the
+% \package{caption} package) sets the sub-type of the box or environment
+% (so |\caption| will typeset a sub-caption instead of an ordinary one),
+% places a proper hyperlink anchor (non-starred variant only),
+% executes options associated with the sub-type etc.\iffalse\footnote{\emph{Note:}
+% Since \cs{captionsetup}\csmarg{subtype} is part of the \package{caption}
+% package, it works in coorparation with the \package{subfig} package as
+% well.}\fi
+% \end{info}
+%
+% \vfill\clearpage
+% \subsection{The subfigure \& subtable environments}
+%
+% \DescribeEnv{subfigure}
+% \DescribeEnv{subtable}
+% After loading \thispackage\ the new environments |subfigure| and
+% |subtable| are available, which have the same (optional \& mandatory)
+% arguments as the |minipage| environment.
+% Inside these environments you use the ordinary |\caption| command
+% for typesetting captions. So this example is identical to the
+% last one, but uses the |subfigure| environment:
+% \begin{quote}
+% |\begin{figure}|\\
+% | \begin{|\textcolor{blue}{\texttt{subfigure}}|}[b]{.5\linewidth}|\\
+% | \centering\large A|\\
+% | |\textcolor{blue}{\cs{caption}}|{A subfigure}\label{fig:1a}|\\
+% | \end{|\textcolor{blue}{\texttt{subfigure}}|}%|\\
+% | \begin{|\textcolor{blue}{\texttt{subfigure}}|}[b]{.5\linewidth}|\\
+% | \centering\large B|\\
+% | |\textcolor{blue}{\cs{caption}}|{Another subfigure}\label{fig:1b}|\\
+% | \end{|\textcolor{blue}{\texttt{subfigure}}|}|\\
+% | \caption{A figure}\label{fig:1}|\\
+% |\end{figure}|
+% \end{quote}
+% Using the |subfigure| or |subtable| environment instead of |\subcaption|
+% has two (little) advantages:
+% \begin{itemize}
+% \item You can override the setttings for a specific subcaption
+% with a |\captionsetup| inside the |subfigure| or |subtable| environment, e.g.:
+% \begin{quote}
+% \ldots\\
+% |\begin{subfigure}[b]{.5\linewidth}|\\
+% | \centering\large A|\\
+% | |\textcolor{blue}{\cs{captionsetup}\csmarg{skip=3pt}}\\
+% | \caption{A subfigure}\label{fig:1a}|\\
+% |\end{subfigure}|\\
+% \ldots
+% \end{quote}
+% \item Hyperlinks pointing to this subfigure will jump to the beginning
+% of the subfigure, and not to the caption of the subfigure
+% (if |hypcap=true| is set for sub-captions).
+% \See{\Ref{hypcap}}
+% \end{itemize}
+%
+% \bigskip
+%
+% \begin{info}
+% The |subfigure| \& |subtable| environments are just simple minipage
+% environments with |\caption|\x|setup|\xx|{subtype}| as first contents line.
+% These environments are defined with the help of
+% |\caption@For{subtypelist}|, which executes code for every sub-type
+% declared with |\DeclareCaptionSubType|.
+% \end{info}
+%
+% \vfill\clearpage
+% \subsection{The \cs{subcaptionbox} command}
+%
+% \DescribeMacro\subcaptionbox
+% A more powerful (but less flexible) way of setting sub-figures is
+% offered by the |\subcaptionbox| command. Its syntax is:
+% \begingroup
+% \leftmargini=12pt
+% \begin{quote}
+% |\subcaptionbox|\oarg{list entry}\marg{heading}\oarg{width}\oarg{inner-pos}\marg{contents}\\
+% |\subcaptionbox*|\marg{heading}\oarg{width}\oarg{inner-pos}\marg{contents}
+% \end{quote}
+% \endgroup
+% \begin{small}
+% The arguments \meta{list entry} \& \meta{heading} will be used for
+% typesetting the |\caption|.\par
+% \meta{width} is the width of the resulting |\parbox|; the default value is
+% the width of the contents.\par
+% \meta{inner-pos} specifies how the contents will be justified inside the
+% resulting |\parbox|;
+% it can be either `c' (for |\centering|), `l' (for |\raggedright|),
+% `r' (for |\raggedleft|), or `s' (for no special justification).
+% The default is `c'.
+% (But you can use any justification defined with
+% |\DeclareCaptionJustification| as well, e.g.~`|centerlast|'.)
+% \end{small}
+%
+% \bigskip
+%
+% Using |\subcaptionbox|, the baseline of the resulting box will be placed
+% right between contents and heading, so usually you don't have to care about the
+% vertical alignment of the sub-figures for yourself.
+% Also the hyperlink anchor is placed properly with respect to the |hypcap=|
+% setting.
+%
+% One example:
+% \begin{quote}
+% |\begin{figure}|\\
+% | \centering|\\
+% | \subcaptionbox{A cat\label{cat}}|\\
+% | {\includegraphics{cat}}|\\
+% | \subcaptionbox{An elephant\label{elephant}}|\\
+% | {\includegraphics{elephant}}|\\
+% | \caption{Two animals}\label{animals}|\\
+% |\end{figure}|
+% \end{quote}
+% gives the result:\par
+% \noindent\begin{minipage}{\linewidth}
+% \captionsetup{type=figure}
+% \centering
+% \subcaptionbox{A cat\label{cat}}
+% {\includegraphics[width=30pt]{cat}}
+% \subcaptionbox{An elephant\label{elephant}}
+% {\includegraphics[width=.4\textwidth]{elephant}}
+% \caption[Two animals]{Two animals~\footnotemark}\label{animals}
+% \end{minipage}
+% \footnotetext{The pictures were taken with permission from the
+% \LaTeX\ Companion\cite{TLC2} examples.}
+%
+% \bigskip
+%
+% As you see the result is not satisfying;
+% the caption below the cat looks ugly because of the small width of the
+% graphic. This can be solved by using the optional arguments of |\captionbox|,
+% increasing the width of the resulting box:
+% \begin{quote}
+% | |\ldots\\
+% | \subcaptionbox{A cat\label{cat}}|\\
+% | [2.5cm]{\includegraphics{cat}}|\\
+% | |\ldots
+% \end{quote}
+% \noindent\begin{minipage}{\linewidth}
+% \captionsetup{type=figure}
+% \centering
+% \subcaptionbox{A cat\label{cat2}}
+% [2.5cm]{\includegraphics[width=30pt]{cat}}
+% \subcaptionbox{An elephant\label{elephant2}}
+% {\includegraphics[width=.4\textwidth]{elephant}}
+% \caption{Two animals}\label{animals2}
+% \end{minipage}
+%
+% \bigskip
+%
+% Furthermore the main caption, which is centered with respect to the
+% |\textwidth|, looks mis-aligned with respect to the sub-captions.
+% This can (again) be solved by using the optional arguments of |\captionbox|,
+% giving both boxes the same width, for example:
+% \begin{quote}
+% | |\ldots\\
+% | \subcaptionbox{A cat\label{cat}}|\\
+% | [.4\linewidth]{\includegraphics{cat}}%|\\
+% | \subcaptionbox{An elephant\label{elephant}}|\\
+% | [.4\linewidth]{\includegraphics{elephant}}|\\
+% | |\ldots
+% \end{quote}
+% \noindent\begin{minipage}{\linewidth}
+% \captionsetup{type=figure}
+% \centering
+% \subcaptionbox{A cat\label{cat3}}
+% [.4\linewidth]{\includegraphics[width=39.34724pt]{cat}}%^^A
+% \subcaptionbox{An elephant\label{elephant3}}
+% [.4\linewidth]{\includegraphics[width=.4\textwidth]{elephant}}
+% \caption{Two animals}\label{animals3}
+% \end{minipage}
+%
+% \bigskip
+%
+% \begin{info}
+% The |\subcaptionbox| is a |\parbox| with |\caption|\x|setup|\xx|{subtype}|
+% as first contents line. \iffalse See implementation for details.\fi
+% \end{info}
+%
+% \vfill\clearpage
+% \subsection{The \cs{subref} command}
+%
+% While |\ref|\marg{key} (and |\ref*|\marg{key}, if the \package{hyperref}
+% package is used) usually gives a combined result representing the main
+% caption counter and the sub-caption one, it is sometimes useful to have
+% a reference to the sub-caption only. For this purpose you can use
+% \begin{quote}
+% |\subref|\marg{key}\\
+% |\subref*|\marg{key}~\footnote{%^^A
+% Like \cs{ref*}, \cs{subref*} is only available if the \package{hyperref}
+% package\cite{hyperref} is used.}%^^A
+% \qquad.
+% \end{quote}
+% So for example |\ref{cat}| gives the result `\ref{cat}' but |\subref{cat}|
+% gives `\subref{cat}'.
+%
+% \begin{small}
+% \emph{Note:} If the sub-caption was defined with the starred variant
+% |\DeclareCaptionSubType*|, both |\ref| and |\subref| gives the same result.
+% \end{small}
+%
+% \begin{info}
+% The |\subref| command demonstrates the usage of |\caption@subtypehook|
+% which will be called during |\captionsetup{subtype}|.
+% \end{info}
+%
+% \iffalse\vfill\clearpage\fi
+% \subsection{The \cs{DeclareCaptionSubType} command}
+%
+% \DescribeMacro\DeclareCaptionSubType
+% For using the sub-caption feature of the \package{caption} package some
+% commands and counters must be prepared. This is done with~\footnote{%^^A
+% \cs{newsubfloat} offered by the \package{subfig} package\cite{subfig}
+% could be used for this purpose as well.}
+% \begin{quote}
+% |\DeclareCaptionSubType|\oarg{numbering scheme}\marg{type}\\
+% |\DeclareCaptionSubType*|\oarg{numbering scheme}\marg{type}
+% \end{quote}
+% For the environments |figure| \& |table| (and all the ones
+% defined with |\Declare|\x|Caption|\x|Type|) this will be done automatically
+% by this package, but for others (e.g.~defined with |\newfloat| offered by the
+% \package{float} package or |\Declare|\x|New|\x|Float|\x|Type| offered by the
+% \package{floatrow} package) this has to be done manually.
+%
+% \medskip
+%
+% The starred variant provides the sub-caption numbering format
+% \meta{type}|.|\meta{subtype} (e.g.~`|1.2|') while the non-starred variant
+% simply uses \meta{subtype} (e.g.~`|a|').
+%
+% \begin{small}
+% Own numbering formats can be created by redefining |\thesub|\meta{type}, e.g.
+% \begin{quote}|\DeclareCaptionSubType*{figure}|\\
+% |\renewcommand\thesubfigure{\thefigure\alph{subfigure}}|\end{quote}
+% would give you sub-caption numbers like `|1b|'.
+% \end{small}
+%
+% The default numbering scheme is |alph|, but you can use any \LaTeX\ command
+% name here which converts a counter to a text value, e.g. |arabic|, |roman|,
+% |Roman|, |alph|, |Alph|, |fnsymbol|, \ldots
+%
+% But |\DeclareCaptionSubType| is not for defining new sub-caption types only,
+% you can use this command for re-definitions as well, e.g.
+% \begingroup
+% \leftmargini=12pt
+% \begin{quote}
+% |\DeclareCaptionSubType*[arabic]{table}|\\
+% |\captionsetup[subtable]{labelformat=simple,labelsep=colon}|
+% \end{quote}
+% \endgroup
+% \pagebreak[3]
+% will give you sub-captions in |table|s like these ones:
+% \par\bigskip
+% \noindent\begin{minipage}{\linewidth}
+% \captionsetup{type=table}
+% \centering
+% \caption{Two tables}
+% \subcaptionbox{Table one}[3cm][c]{\begin{tabular}{cc}A & B\\ C & D\\ \end{tabular}}
+% \subcaptionbox{Table two}[3cm][c]{\begin{tabular}{cc}E & F\\ G & H\\ \end{tabular}}
+% \end{minipage}
+%
+% \begin{info}
+% |\DeclareCaptionSubType| is an integral part of the \package{caption}
+% package kernel.
+% \end{info}
+%
+% \iffalse\vfill\clearpage\fi
+% \subsection{Where do hyperlinks jump?}
+% \label{hypcap}
+%
+% For the |subfigure| \& |subtable| environments and |\subcaptionbox| boxes
+% (and own constructs which use |\captionsetup{subtype}|) the
+% hyperlink anchors will be placed in respect to the |hypcap=| setting.
+% While usage of this option is straight-forward ordinary captions,
+% the usage for sub-captions depends on the setting for the main captions.
+% This table gives you an overview where the hyperlinks will jump:\par
+%
+% \bigskip
+% \begin{small}
+% \centering
+% \DeleteShortVerb{\|}
+% \renewcommand\arraystretch{1.5}
+% \begin{tabular}{|l|p{3cm}p{3cm}|}
+% \hline
+% \backslashbox{subcaption}{caption} &
+% \multicolumn{1}{c}{\texttt{hypcap=false}} &
+% \multicolumn{1}{c|}{\texttt{hypcap=true}} \\
+% \hline
+% \raisebox{-1.5ex}[1.5ex]{\texttt{hypcap=false}} &
+% sub-caption & figure or table\par\hfill\textit{(default setting)}\\
+% \raisebox{-1.5ex}[1.5ex]{\texttt{hypcap=true}} &
+% sub-figure or\par sub-table & sub-figure or\par sub-table \\
+% \hline
+% \end{tabular}\par
+% \MakeShortVerb{\|}
+% \end{small}
+% \bigskip
+%
+% But if |\subcaption| is used and |hypcap=true| is set for sub-captions,
+% \thispackage\ does not know where the sub-figure or sub-table actually
+% begins, so it will jump to the sub-caption instead.
+%
+% \medskip
+% \emph{Remember:} If you use the \package{hypcap} package\cite{hypcap},
+% it controls the placement of the hyperlink anchors, making the rules
+% above invalid.
+%
+% \bigskip
+% {\small(See also the documentation of the \package{caption} package,
+% sections about \package{hyperref} \& \package{hypcap}.)}
+%
+% \iffalse
+% --------------------------------------------------------------------------- %
+% \fi
+%
+% \pagebreak[2]
+% \section{Thanks}
+%
+% I would like to thank
+% Stephen Dalton
+% who helped to make this package a better one.
+%
+% \iffalse
+% --------------------------------------------------------------------------- %
+% \fi
+%
+% \StopEventually{%^^A
+% \begin{thebibliography}{9}
+% \bibitem{TLC2}
+% Frank Mittelbach and Michel Goossens:\\
+% \newblock {\em The {\LaTeX} Companion (2nd.~Ed.)},
+% \newblock Addison-Wesley, 2004.
+% \iffalse
+% \bibitem{floatrow}
+% Olga Lapko:\\
+% \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/}%
+% {\emph{The floatrow package documentation}},
+% 2007/08/24
+% \fi
+% \bibitem{hyperref}
+% Sebastian Rahtz \& Heiko Oberdiek:\\
+% \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}%
+% {\emph{Hypertext marks in \LaTeX}},
+% November 12, 2007
+% \bibitem{hypcap}
+% Heiko Oberdiek:\\
+% \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/oberdiek/}%
+% {\emph{The hypcap package -- Adjusting anchors of captions}},
+% 2007/04/09
+% \bibitem{subfig}
+% Steven D. Cochran:\\
+% \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfig/}%
+% {\emph{The subfig package}},
+% 2005/07/05
+% \end{thebibliography}
+% }
+%
+% \iffalse
+% --------------------------------------------------------------------------- %
+% \fi
+%
+% \DoNotIndex{\\,\_,\ ,\@@par}
+% \DoNotIndex{\@bsphack}
+% \DoNotIndex{\@car,\@cdr,\@classoptionslist,\@cons,\@currext,\@currname}
+% \DoNotIndex{\@ehc,\@ehd,\@empty,\@esphack,\@expandtwoargs}
+% \DoNotIndex{\@for,\@firstofone,\@firstoftwo}
+% \DoNotIndex{\@gobble,\@gobblefour,\@gobbletwo,\@hangfrom}
+% \DoNotIndex{\@ifnextchar,\@ifpackagelater,\@ifpackageloaded}
+% \DoNotIndex{\@ifstar,\@ifundefined,\@latex@error,\@namedef,\@nameuse}
+% \DoNotIndex{\@onlypreamble,\@parboxrestore,\@plus,\@ptionlist}
+% \DoNotIndex{\@removeelement,\@restorepar,\@secondoftwo,\@setpar}
+% \DoNotIndex{\@tempa,\@tempboxa,\@tempdima,\@tempdimb,\@tempdimc,\@tempb,\@tempc}
+% \DoNotIndex{\@testopt}
+% \DoNotIndex{\@undefined,\@unprocessedoptions,\@unusedoptionlist}
+% \DoNotIndex{\p@,\z@}
+% \DoNotIndex{\active,\addtocounter,\addtolength,\advance,\aftergroup}
+% \DoNotIndex{\baselineskip,\begin,\begingroup,\bfseries,\box}
+% \DoNotIndex{\catcode,\centering,\changes,\csname,\def,\divide,\do,\downarrow}
+% \DoNotIndex{\edef,\else,\empty,\end,\endcsname,\endgraf,\endgroup,\expandafter}
+% \DoNotIndex{\fi,\footnotesize,\global}
+% \DoNotIndex{\hangindent,\hbox,\hfil,\hsize,\hskip,\hspace,\hss}
+% \DoNotIndex{\ifcase,\ifdim,\ifnum,\ifodd,\ifvoid,\ifvmode}
+% \DoNotIndex{\ifx,\ignorespaces,\itshape}
+% \DoNotIndex{\Large,\large,\leavevmode,\leftmargini,\leftskip,\let,\linewidth}
+% \DoNotIndex{\llap,\long,\m@ne,\margin,\mdseries,\message}
+% \DoNotIndex{\newcommand,\newdimen,\newlength,\newline,\newif,\newsavebox}
+% \DoNotIndex{\next,\nobreak,\nobreakspace,\noexpand,\noindent,\numberline}
+% \DoNotIndex{\normalcolor,\normalfont,\normalsize,\or,\par,\parbox,\parfillskip}
+% \DoNotIndex{\parindent,\parskip,\prevdepth,\protect,\protected@edef,\protected@write}
+% \DoNotIndex{\providecommand,\quad}
+% \DoNotIndex{\raggedleft,\raggedright,\relax,\renewcommand,\RequirePackage}
+% \DoNotIndex{\rightskip,\rmfamily}
+% \DoNotIndex{\sbox,\scriptsize,\scshape,\setbox,\setlength,\sffamily,\slshape}
+% \DoNotIndex{\small,\string,\space,\strut}
+% \DoNotIndex{\textheight,\the,\toks@,\typeout,\ttfamily}
+% \DoNotIndex{\unvbox,\uparrow,\upshape,\usebox,\usepackage}
+% \DoNotIndex{\value,\vbox,\vsize,\vskip,\wd,\width,\z@skip}
+% \DoNotIndex{\AtBeginDocument,\AtEndOfPackage,\CurrentOption,\DeclareOption}
+% \DoNotIndex{\ExecuteOptions,\GenericWarning,\IfFileExists,\InputIfFileExists}
+% \DoNotIndex{\NeedsTeXFormat,\MessageBreak}
+% \DoNotIndex{\PackageError,\PackageInfo,\PackageWarning,\PackageWarningNoLine}
+% \DoNotIndex{\PassOptionsToPackage,\ProcessOptions,\ProvidesPackage}
+%
+% \iffalse
+% --------------------------------------------------------------------------- %
+% \fi
+%
+% \setlength{\parskip}{0pt plus 1pt}
+% \changes{v0.1}{2007/09/01}{First demo}
+% \changes{v0.2}{2007/11/11}{\cs{subcaptionbox} added}
+% \changes{v0.3}{2007/12/06}{Adapted to \package{caption} package \version{3.1f}}
+%
+% \newcommand*\Note[2][Note]{\par{\small\emph{#1:} #2}}
+%
+% \iffalse
+% --------------------------------------------------------------------------- %
+% \fi
+%
+% \vfill\clearpage
+% \section{The implementation}
+% \iffalse
+%<*package>
+% \fi
+%
+% \subsection{Identification}
+%
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesPackage{subcaption}[2007/12/06 v0.3 Adding subcaptions (AR)]
+% \end{macrocode}
+%
+% \subsection{Initial code}
+%
+% We need the \package{caption} package, so we issue an error here if it's
+% not loaded yet.
+% \begin{macrocode}
+\@ifundefined{caption@subtypehook}{% we need caption v3.1f or newer
+ \PackageError{subcaption}{`caption' package not loaded\MessageBreak
+ (which is needed by this package)\@gobble}{%
+ If you do not understand this error, please take a closer look\MessageBreak
+ at the documentation of the `subcaption' package.\MessageBreak
+ \@ehc}%
+ \endinput}{}
+% \end{macrocode}
+%
+% \iffalse
+% \subsection{Declaration of options}
+% We do not have own options.
+% \fi
+%
+% \subsection{Execution of options}
+%
+% We map |\caption@setkeys| to |\captionsetup[sub]| so |\caption@ExecuteOptions|
+% \& |\caption@ProcessOptions| adds the options to the `|sub|' option list
+% instead of executing them immediately.
+% \begin{macrocode}
+\let\caption@setkeys@ORI\caption@setkeys
+\renewcommand\caption@setkeys[2]{\captionsetup[sub]{#2}}
+% \end{macrocode}
+% \begin{macrocode}
+\caption@ExecuteOptions{subcaption}{%
+ font+=small,labelformat=parens,labelsep=space,skip=6pt,list=0,hypcap=0}
+\caption@ProcessOptions*{subcaption}
+% \end{macrocode}
+% \begin{macrocode}
+\let\caption@setkeys\caption@setkeys@ORI
+\let\caption@setkeys@ORI\@undefined
+% \end{macrocode}
+%
+% \subsection{Main code}
+%
+% We call |\DeclareCaptionSubType| for |figure|, |table|,
+% and every caption type declared with |\DeclareCaptionType| here.
+% \begin{macrocode}
+\@ifundefined{c@figure}{}{\DeclareCaptionSubType{figure}}
+\@ifundefined{c@table}{}{\DeclareCaptionSubType{table}}
+\caption@For{typelist}{\DeclareCaptionSubType{#1}}
+% \end{macrocode}
+%
+% \pagebreak[3]
+% \subsubsection{The \cs{subcaption} command}
+%
+% \begin{macro}{\subcaption}
+% Without a prefacing |\captionsetup{subtype}|, \cs{subcaption} is some kind
+% of |\captionof{sub\@captype}|.
+% \Note{Like \cs{captionof}, this command is designed to be used inside an
+% own group!}
+% \begin{macrocode}
+\newcommand*\subcaption{\captionsetup{subtype*}\caption}
+% \end{macrocode}
+% But with a prefacing |\captionsetup{subtype}|, \cs{subcaption} is simply
+% |\caption|.
+% \begin{macrocode}
+\g@addto@macro\caption@subtypehook{\let\subcaption\caption}
+% \end{macrocode}
+% \end{macro}
+%
+% \pagebreak[3]
+% \subsubsection{The subfigure \& subtable environments}
+%
+% \begin{macro}{subfigure}
+% \begin{macro}{subtable}
+% This is just an ordinary \env{minipage} environment with
+% |\captionsetup{subtype}| as first contents line.
+% It will be defined using the helper macro |\caption@For{sub|\x|type|\x|list}|
+% offered by the \package{caption} kernel, so for every caption type
+% declared with |\Declare|\x|Caption|\x|Type| a corresponding `sub' environment
+% will be defined automatically.
+% \begin{macrocode}
+\caption@For{subtypelist}{%
+ \newenvironment{sub#1}%
+ {\caption@withoptargs\subcaption@minipage}%
+ {\endminipage}}%
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand*\subcaption@minipage[2]{%
+ \minipage#1{#2}%
+ \captionsetup{subtype}}
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+% \pagebreak[3]
+% \subsubsection{The \cs{subcaptionbox} command}
+%
+% \begin{macro}{\subcaptionbox}
+% A |\parbox| with contents and sub-caption, separated by an invisible |\hrule|.
+% \begin{macrocode}
+\newcommand*\subcaptionbox{\caption@withoptargs\subcaption@box}
+% \end{macrocode}
+% \begin{macrocode}
+\newcommand\subcaption@box[2]{%
+ \@testopt{\subcaption@ibox{#1}{#2}}{\wd\@tempboxa}}
+% \end{macrocode}
+% \begin{macrocode}
+\long\def\subcaption@ibox#1#2[#3]{%
+ \@testopt{\subcaption@iibox{#1}{#2}{#3}}\subcaptionbox@hj@default}
+% \end{macrocode}
+% \begin{macrocode}
+\long\def\subcaption@iibox#1#2#3[#4]#5{%
+ \setbox\@tempboxa\hbox{#5}%
+ \begingroup
+ \captionsetup{subtype*}% set \caption@position
+ \caption@iftop{%
+ \endgroup
+ \parbox[t]{#3}{%
+ \captionsetup{subtype,position=t}%
+ \vbox{\caption#1{#2}}%
+ \hrule\@height\z@
+ \csname caption@hj@#4\endcsname
+ \unhbox\@tempboxa}%
+ }{%
+ \endgroup
+ \parbox[b]{#3}{%
+ \captionsetup{subtype,position=b}%
+ \csname caption@hj@#4\endcsname
+ \unhbox\@tempboxa
+ \hrule\@height\z@
+ \vtop{\caption#1{#2}}}%
+ }}
+% \end{macrocode}
+% \begin{macrocode}
+\providecommand*\caption@hj@c{\centering}
+\providecommand*\caption@hj@l{\raggedright}
+\providecommand*\caption@hj@r{\raggedleft}
+\providecommand*\caption@hj@s{}
+\newcommand*\subcaptionbox@hj@default{c}
+% \end{macrocode}
+% \end{macro}
+%
+% \pagebreak[3]
+% \subsubsection{The \cs{subref} command}
+%
+% At |\captionsetup{subtype}|, we redefine |\label|.
+% \begin{macrocode}
+\g@addto@macro\caption@subtypehook{%
+ \ifx\label\subcaption@label \else
+ \let\subcaption@ORI@label\label
+ \let\label\subcaption@label
+ \fi}
+% \end{macrocode}
+%
+% \begin{macro}{\subcaption@label}
+% When a label will be placed for a sub-caption, we automatically place
+% a second one for |\subref|, too. This second label will contain
+% the sub-type counter only.
+% \begin{macrocode}
+\newcommand*\subcaption@label[1]{%
+ \@bsphack\begingroup
+ \subcaption@ORI@label{#1}%
+ \protected@edef\@currentlabel{\csname thesub\@captype\endcsname}%
+ \subcaption@ORI@label{sub@#1}%
+ \endgroup\@esphack}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\subref}
+% This simply calls |\ref| with the second label. (see |\subcaption@label|)
+% \begin{macrocode}
+\DeclareRobustCommand*\subref{\caption@withoptargs\subcaption@ref}
+\newcommand*\subcaption@ref[2]{\ref#1{sub@#2}}
+% \end{macrocode}
+% \end{macro}
+%
+% \iffalse
+%</package>
+% \fi
+%
+% \iffalse
+% --------------------------------------------------------------------------- %
+% \fi
+%
+% \Finale
+%
+\endinput
diff --git a/Master/texmf-dist/tex/latex/caption/caption.sty b/Master/texmf-dist/tex/latex/caption/caption.sty
index bcc8bc5ca2e..2ca6b650286 100644
--- a/Master/texmf-dist/tex/latex/caption/caption.sty
+++ b/Master/texmf-dist/tex/latex/caption/caption.sty
@@ -23,15 +23,15 @@
%% This Current Maintainer of this work is Axel Sommerfeldt.
%%
%% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-%% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-%% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-%% caption-eng.tex, and caption-rus.tex.
+%% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+%% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+%% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%%
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{caption}[2007/11/04 v3.1e Customising captions (AR)]
+\ProvidesPackage{caption}[2007/12/23 v3.1f Customizing captions (AR)]
\newcommand*\caption@Info[1]{\PackageInfo{caption}{#1\@gobble}}
\@onlypreamble\caption@Info
-\RequirePackage{caption3}[2007/11/04] % needs v3.1e or newer
+\RequirePackage{caption3}[2007/12/21] % needs v3.1f or newer
\@ifpackageloaded{caption2}{%
\caption@Error{%
You can't use both, the (obsolete) caption2 *and*\MessageBreak
@@ -54,7 +54,7 @@
\newcommand*\caption@IncompatiblePackage[2]{%
\PackageWarningNoLine{caption}{%
Usage of the #1 package together with the\MessageBreak
- caption package is strongly *not* recommended.\MessageBreak
+ caption package is strongly not recommended.\MessageBreak
Instead of loading the #1 package you should\MessageBreak
use the caption package option\MessageBreak
\space\space`tableposition=top'#2}}
@@ -62,7 +62,7 @@
\caption@ifbool{documentclass}{}{%
\PackageWarningNoLine{caption}{%
Unsupported document class (or package) detected,\MessageBreak
- usage of the caption package is *not* recommended}%
+ usage of the caption package is not recommended}%
\caption@Info{\string\@makecaption\space=\space\meaning\@makecaption}%
}
\@ifundefined{@captionheadfont}{}{%
@@ -149,10 +149,6 @@
\caption@setcapmargin
\fi
}
-\DeclareCaptionOption*{config}[caption]{%
- \InputIfFileExists{#1.cfg}%
- {\typeout{*** Local configuration file #1.cfg used ***}}%
- {\caption@Warning{Configuration file #1.cfg not found}}}
\DeclareCaptionOption{figureposition}{%
\captionsetup*[figure]{position=#1}}
\@onlypreamble@key{caption}{figureposition}
@@ -169,9 +165,8 @@
\captionsetup*[table]{position=#1}}
\@onlypreamble@key{caption}{tableposition}
\DeclareCaptionOption{figurename}{\caption@SetFloatName{figure}{#1}}
-\@onlypreamble@key{caption}{figurename}
\DeclareCaptionOption{tablename}{\caption@SetFloatName{table}{#1}}
-\@onlypreamble@key{caption}{tablename}
+\DeclareCaptionOption{name}{\caption@setfloatname\@captype{#1}}
\newcommand*\caption@SetFloatName[2]{%
\begingroup
\def\@tempa{\endgroup\@firstofone}%
@@ -179,8 +174,28 @@
\@ifundefined{captions\languagename}{}{%
\def\@tempa{\endgroup
\expandafter\addto\csname captions\languagename\endcsname}}}%
- \@tempa{\@namedef{#1name}{#2}}}
-\@onlypreamble\caption@SetFloatName
+ \@tempa{\caption@setfloatname{#1}{#2}}}
+\newcommand*\caption@setfloatname[2]{\@namedef{#1name}{#2}}
+\caption@AtBeginDocument{\let\caption@SetFloatName\caption@setfloatname}
+\DeclareCaptionOption{figurewithin}{\caption@Within{figure}{#1}}
+\@onlypreamble@key{caption}{figurewithin}
+\DeclareCaptionOption{figurewithout}{\caption@Within{figure}{none}}
+\@onlypreamble@key{caption}{figurewithout}
+\DeclareCaptionOption{tablewithin}{\caption@Within{table}{#1}}
+\@onlypreamble@key{caption}{tablewithin}
+\DeclareCaptionOption{tablewithout}{\caption@Within{table}{none}}
+\@onlypreamble@key{caption}{tablewithout}
+\newcommand*\caption@Within[1]{\def\caption@type{#1}\KV@caption@DCT@within}
+\@onlypreamble\caption@Within
+\DeclareCaptionOption*{config}[caption]{%
+ \InputIfFileExists{#1.cfg}%
+ {\typeout{*** Local configuration file #1.cfg used ***}}%
+ {\caption@Warning{Configuration file #1.cfg not found}}}
+\DeclareCaptionOption{@minipage}{%
+ \caption@ifinlist{#1}{auto,default}%
+ {\let\caption@if@minipage\@gobbletwo}%
+ {\caption@set@bool\caption@if@minipage{#1}}}
+\captionsetup{@minipage=default}
\DeclareCaptionOption{compatibility}[1]{\caption@setbool{compatibility}{#1}}
\@onlypreamble@key{caption}{compatibility}
\DeclareCaptionOptionNoValue*{normal}{%
@@ -249,35 +264,49 @@
\captionsetup{hypcap=1,hypcapspace=.5\baselineskip}
\caption@ProcessOptions*{caption}
\caption@AtBeginDocument{%
- \DeclareCaptionOption{type}{\caption@settype{#1}}
- \DeclareCaptionOption{type*}{\caption@settype*{#1}}}
+ \DeclareCaptionOption{type}{\caption@settype{#1}}%
+ \DeclareCaptionOption{type*}{\caption@settype*{#1}}%
+ \DeclareCaptionOption{subtype}[sub\@captype]{\caption@setsubtype{#1}}%
+ \DeclareCaptionOption{subtype*}[sub\@captype]{\caption@setsubtype*{#1}}%
+}
\newcommand*\caption@settype{%
\caption@@settype{}}
+\newcommand*\caption@setsubtype{%
+ \caption@iftype
+ {\caption@@settype{sub}}%
+ {\caption@Error{Option `subtype=' outside float}}}%
\newcommand*\caption@@settype[1]{%
\caption@teststar{\caption@@@settype{#1}}\@firstoftwo\@secondoftwo}
\newcommand*\caption@@@settype[3]{%
- \caption@Debug{type=#3}%
- \caption@checkgrouplevel{#1}{%
- \captionsetup{#1type#2*\@empty=...}#2{ or \@backslashchar#1captionof}{}}%
- \@ifundefined{@#1captype}{}{%
- \edef\@tempa{#3}%
- \expandafter\ifx\csname @#1captype\endcsname\@tempa \else
- \caption@iftypewarning{\caption@Warning{%
- Caption type was already set to `#3'\MessageBreak}}{}%
- \fi}%
- \expandafter\edef\csname @#1captype\endcsname{#3}%
- \let\caption@iftypewarning\caption@ifdebug
- \@nameuse{#1caption@settypehook}%
- \expandafter\caption@setoptions\csname @#1captype\endcsname
- \let\caption@ifrefstepcounter\@secondoftwo
- #2{}{%
- \let\@currentlabel\caption@undefinedlabel
- \ifx\caption@ORI@label\@undefined
- \let\caption@ORI@label\label
- \def\label{\caption@withoptargs\caption@xlabel}%
- \fi
- \caption@start}}
-\newcommand*\caption@settypehook{}
+ \@ifundefined{c@#3}%
+ {\caption@Error{No float type '#3' defined}}%
+ {\caption@Debug{#1type=#3}%
+ \caption@checkgrouplevel{#1}{%
+ \captionsetup{#1type#2*\@empty=...}#2{ or
+ \@backslashchar#1captionof}{}}%
+ \edef\@tempa{#3}%
+ \expandafter\ifx\csname @#1captype\endcsname\@tempa \else
+ \@nameuse{caption@#1type@warning}%
+ \fi
+ \expandafter\let\csname @#1captype\endcsname\@tempa
+ \@nameuse{caption@#1typehook}%
+ \caption@setoptions{#3}%
+ \ifx\caption@opt\relax
+ \@nameundef{caption@#1type@warning}%
+ \else
+ \@namedef{caption@#1type@warning}{\caption@Warning{%
+ The #1caption type was already set to
+ `\csname @#1captype\endcsname'\MessageBreak}}%
+ \fi
+ \let\caption@ifrefstepcounter\@secondoftwo
+ #2{}{%
+ \let\@currentlabel\caption@undefinedlabel
+ \ifx\caption@ORI@label\@undefined
+ \let\caption@ORI@label\label
+ \let\label\caption@xlabel
+ \fi
+ \caption@start}}}
+\newcommand*\caption@typehook{}
\newcommand*\caption@iftype{%
\@ifundefined{@captype}{\let\@captype\@undefined\@secondoftwo}\@firstoftwo}
\begingroup\expandafter\expandafter\expandafter\endgroup
@@ -293,16 +322,17 @@
\expandafter\edef\csname #1caption@grouplevel\endcsname{%
\the\currentgrouplevel}%
\else
- \caption@Error{\string#2\MessageBreak outside box or environment}%
+ \caption@Warning{\string#2\MessageBreak outside box or environment}%
\fi
}{}}
\fi
\newcommand*\caption@undefinedlabel{??}
-\newcommand*\caption@xlabel[2]{%
+\newcommand*\caption@xlabel{%
\ifx\@currentlabel\caption@undefinedlabel
\caption@Warning{\noexpand\label before \noexpand\caption ignored}%
+ \expandafter\@gobble
\else
- \caption@ORI@label#1{#2}%
+ \expandafter\caption@ORI@label
\fi}
\caption@AtBeginDocument{%
\def\captionof{\caption@teststar\caption@of{\caption*}\caption}}
@@ -310,9 +340,11 @@
\newcommand*\captionlistentry{%
\@testopt\caption@listentry\@captype}
\def\caption@listentry[#1]#2{%
- \caption@refstepcounter{#1}%
- \caption@makecurrent{#1}{#2}%
- \caption@addcontentsline{#1}{#2}}
+ \@bsphack
+ \caption@refstepcounter{#1}%
+ \caption@makecurrent{#1}{#2}%
+ \caption@addcontentsline{#1}{#2}%
+ \@esphack}
\def\ContinuedFloat{%
\@ifnextchar[\@ContinuedFloat{%
\caption@iftype
@@ -341,7 +373,9 @@
\let\caption@ifrefstepcounter\@firstoftwo}
\newcommand*\caption@@refstepcounter{\refstepcounter}
\let\caption@ifrefstepcounter\@secondoftwo
-\newcommand\caption@dblarg[1]{\kernel@ifnextchar[{#1}{\caption@xdblarg{#1}}}%
+\@ifundefined{kernel@ifnextchar}%
+ {\newcommand\caption@dblarg[1]{\@ifnextchar[{#1}{\caption@xdblarg{#1}}}}%
+ {\newcommand\caption@dblarg[1]{\kernel@ifnextchar[{#1}{\caption@xdblarg{#1}}}}%
\newcommand\caption@xdblarg[2]{#1[{#2\relax}]{#2}}%
\newcommand*\caption@begin[1]{%
\begingroup
@@ -359,14 +393,6 @@
\@ifundefined{fnum@#1}{\iftrue}{\ifx\caption@lfmt\caption@lfmt@default\else}%
\@namedef{fnum@#1}{\caption@fnum{#1}}%
\fi}
-\caption@AtBeginDocument*{%
- \@ifundefined{sf@ifpositiontop}{}{%
- \let\caption@kernel@addcontentsline\caption@addcontentsline
- \renewcommand*\caption@addcontentsline[2]{%
- \sf@ifpositiontop{\@listsubcaptions{#1}}{}%
- \caption@kernel@addcontentsline{#1}{#2}%
- \sf@ifpositiontop{}{\@listsubcaptions{#1}}}%
- }}
\newcommand*\caption@boxrestore{%
\let\if@nobreak\iffalse
\let\if@noskipsec\iffalse
@@ -589,16 +615,13 @@
\caption@setbool{incompatible}{1}}%
\@ifundefined{caption@ifcompatibility}%
{\let\caption@ifcompatibility\caption@ifincompatible
- \let\@tempa\@firstofone}%
+ \let\@tempa\caption@WarningNoLine}%
{\let\@tempa\@gobble}% suppress warning
\caption@ifcompatibility{%
\@tempa{%
- \caption@WarningNoLine{%
- \noexpand\caption will not be redefined since it's already\MessageBreak
- redefined by a document class or package which is\MessageBreak
- unknown to the caption package.\MessageBreak
- As a result some features will not work as expected}%
- }%
+ \noexpand\caption will not be redefined since it's already\MessageBreak
+ redefined by a document class or package which is\MessageBreak
+ unknown to the caption package}%
\renewcommand*\caption@ContinuedFloat[1]{%
\caption@Error{Not available in compatibility mode}}%
\caption@AtBeginDocument*{%
@@ -618,8 +641,7 @@
\caption@WarningNoLine{%
Forced redefinition of \noexpand\caption since the\MessageBreak
unsupported(!) package option `compatibility=false'\MessageBreak
- was given. Please fasten your seat belts, as we may\MessageBreak
- experience turbulence}%
+ was given}%
}{}%
\def\caption{%
\caption@iftype
@@ -639,12 +661,16 @@
\caption@beginex{#1}{#2}{#3}%
\caption@setfloatcapt{%
\caption@boxrestore
+ \if@minipage
+ \@setminipage
+ \fi
\caption@normalsize
\ifcaption@star
\let\caption@@anchor\@firstofone
\fi
\@makecaption{\csname fnum@#1\endcsname}%
- {\ignorespaces\caption@@anchor{#3}}\par}%
+ {\ignorespaces\caption@@anchor{#3}}\par
+ \caption@if@minipage\@minipagetrue\@minipagefalse}%
\caption@end}%
}%
\caption@AtBeginDocument*{%
@@ -659,12 +685,95 @@
\caption@iftop{\vskip\belowcaptionskip}{\vskip\abovecaptionskip}%
\caption@@make{#1}{#2}%
\caption@iftop{\vskip\abovecaptionskip}{\vskip\belowcaptionskip}}
+\def\caption@DeclareSubType sub#1\@nil{%
+ \caption@Debug{Initializing subtype for `#1'\@gobble}%
+ \@namedef{subcaption@value#1}{0}%
+ \@namedef{caption@beginsub#1}{\caption@beginsubfloat{#1}}}
+\@onlypreamble\caption@DeclareSubType
+\caption@For*{subtypelist}{\caption@DeclareSubType sub#1\@nil}
+\caption@AtBeginDocument*{%
+ \@ifundefined{sf@counterlist}{}{%
+ \@for\sf@temp:=\sf@counterlist\do{%
+ \expandafter\caption@DeclareSubType\sf@temp\@nil}}}
+\newcommand*\caption@subtypehook{%
+ \ifx\caption\caption@subcaption \else
+ \caption@ifrefstepcounter{}{%
+ % no \caption or \subcaption in this (floating) environment yet
+ \caption@Debug{Increment \@captype\ counter =\the\value\@captype}%
+ \caption@l@stepcounter\@captype
+ \let\addcontentsline\subcaption@addcontentsline}%
+ \ifnum\csname subcaption@value\@captype\endcsname=\value\@captype \else
+ \caption@Debug{Reset sub\@captype\ counter}%
+ \expandafter\xdef\csname subcaption@value\@captype\endcsname{%
+ \the\value\@captype}%
+ \@stpelt\@subcaptype
+ \fi
+ \c@ContinuedFloat=0\relax
+ \let\caption@resetContinuedFloat\@gobble
+ \let\caption@addcontentsline\caption@kernel@addcontentsline
+ \let\caption@setfloatcapt\@firstofone
+ \caption@clearmargin
+ \caption@setoptions{sub}%
+ \caption@setoptions{subfloat}% for subfig-package compatibility
+ \let\caption\caption@subcaption
+ \fi}%
+\newcommand*\caption@subcaption{%
+ \caption@iftype
+ {\caption@checkgrouplevel{sub}\subcaption
+ \caption@star
+ {\caption@refstepcounter\@subcaptype}%
+ {\caption@dblarg{\@caption\@subcaptype}}}%
+ {\caption@Error{\noexpand\subcaption outside float}}}
+\let\caption@kernel@addcontentsline\caption@addcontentsline
+\renewcommand*\caption@addcontentsline[2]{%
+ \sf@ifpositiontop{\@listsubcaptions{#1}}{}%
+ \caption@kernel@addcontentsline{#1}{#2}%
+ \sf@ifpositiontop{}{\@listsubcaptions{#1}}%
+ \caption@addsubcontentslines{#1}}
+\newcommand*\caption@addsubcontentslines[1]{%
+ \begingroup
+ \subcaption@addcontentslines
+ \endgroup
+ \subcaption@clearcontentslines}%
+\caption@AtBeginDocument*{%
+ \@ifundefined{sf@ifpositiontop}{\let\sf@ifpositiontop\@gobbletwo}{}%
+ \subcaption@clearcontentslines
+ \g@addto@macro\caption@typehook{\subcaption@checkcontentslines}%
+ \AtEndDocument{\subcaption@checkcontentslines}}%
+\newcommand*\subcaption@addcontentsline[3]{%
+ \protected@edef\@tempa{%
+ \noexpand\g@addto@macro\noexpand\subcaption@addcontentslines{%
+ \noexpand\@namedef{the#2}{\csname the#2\endcsname}%
+ \ifx\@currentHref\@undefined \else
+ \noexpand\def\noexpand\@currentHref{\@currentHref}%
+ \fi
+ \protect\addcontentsline{#1}{#2}{#3}}}%
+ \@tempa}
+\newcommand*\subcaption@checkcontentslines{%
+ \ifx\subcaption@addcontentslines\@empty \else
+ \subcaption@Error{%
+ Something's wrong--perhaps a missing \protect\caption\MessageBreak
+ in the last figure or table}%
+ \subcaption@clearcontentslines
+ \fi}
+\newcommand*\subcaption@clearcontentslines{%
+ \global\let\subcaption@addcontentslines\@empty}
\@ifundefined{smf@makecaption}{}{\let\smf@makecaption\@makecaption}
\@ifclassloaded{beamer}{%
\caption@Info{beamer document class}%
- \captionsetup{listof=false}
- \undefine@key{caption}{listof}
- \undefine@key{caption}{listofformat}
+ \captionsetup{list=false}
+ \DeclareCaptionOption{list}{}
+ \DeclareCaptionOption{listof}{}
+ \expandafter\let\expandafter\caption@ORI@figure
+ \csname\string\figure\endcsname
+ \@namedef{\string\figure}[#1]{%
+ \caption@ORI@figure[#1]%
+ \caption@settype{figure}}
+ \expandafter\let\expandafter\caption@ORI@table
+ \csname\string\table\endcsname
+ \@namedef{\string\table}[#1]{%
+ \caption@ORI@table[#1]%
+ \caption@settype{table}}
}{}
\@ifundefined{scr@caption}{}{%
\caption@AtBeginDocument{\let\scr@caption\caption}}
@@ -761,10 +870,12 @@
\let\caption@@refstepcounter\caption@l@stepcounter
\caption@ORI}%
\long\def\@caption##1[##2]##3{%
- \gdef\caption@SClentry{##2}\gdef\caption@SCtext{##3}%
- \ignorespaces}%
+ \@bsphack
+ \gdef\caption@SClentry{##2}%
+ \gdef\caption@SCtext{##3}%
+ \@esphack}%
#1{% is \@gobble in star form, and \@firstofone otherwise
- \def\label##1{\gdef\caption@SClabel{##1}\ignorespaces}}%
+ \def\label##1{\@bsphack\gdef\caption@SClabel{##1}\@esphack}}%
}%
\newcommand*\caption@defrost{%
\ifx\caption@ORI@ContinuedFloat\@undefined
@@ -805,7 +916,7 @@
}{}%
\caption@freezeHref % will be defrosted in \float@makebox
\caption@ORI@float@setevery{#1}}%
- \g@addto@macro\caption@settypehook{%
+ \g@addto@macro\caption@typehook{%
\expandafter\ifx\csname #1name\endcsname\relax
\expandafter\let\csname #1name\expandafter\endcsname
\csname fname@#1\endcsname
@@ -875,7 +986,7 @@
\begin{lrbox}{\FP@floatCorpusBOX}%
\caption@ifFPrefcap
{\caption@freeze\relax}%
- {\def\label##1{\gdef\FP@LabelText{##1}\ignorespaces}%
+ {\def\label##1{\@bsphack\gdef\FP@LabelText{##1}\@esphack}%
\caption@freeze*}}%
\renewcommand*\FP@floatEnd{%
\end{lrbox}%
@@ -919,7 +1030,7 @@
\caption@defrost
\end\@captype}%
}%
- \ForFloatingEnvironments{%
+ \caption@For{typelist}{%
\newenvironment{FP#1}{\FP@floatBegin{#1}}{\FP@floatEnd}}%
}{%
\let\caption@ifFPlistcap\@undefined
@@ -1130,11 +1241,7 @@
\long\def\caption[##1]##2{%
\caption@freezeHref % will be defrosted in \ivparpic
\caption@settype\@piccaptype
- \ifnum\c@piccaptionpos>2\relax
\caption@clearmargin
- \else
- \captionwidth\z@ % do not use "width=" setting
- \fi
\caption@setoptions{parpic}%
\let\caption@boxrestore\@parboxrestore
\caption@setautoposition b%
@@ -1167,14 +1274,14 @@
\caption@slc{#1}{#2}{.8\vsize}{%
\let\caption@makerot\caption@@make
\caption@clearmargin
- \let\captionbox\@secondoftwo}%
+ \let\caption@parbox\@secondoftwo}%
\caption@set@bool\caption@ifslc0% been there, done that
\fi
\rotatebox{90}{\caption@makerot{#1}{#2}}%
\nobreak\hspace{12pt}}%
\newcommand\caption@makerot[2]{%
\begin{minipage}\captionwidth\caption@@make{#1}{#2}\end{minipage}}%
- \ForFloatingEnvironments{%
+ \caption@For{typelist}{%
\newenvironment{sideways#1}{\@rotfloat{#1}}{\end@rotfloat}%
\newenvironment{sideways#1*}{\@rotdblfloat{#1}}{\end@rotdblfloat}}%
}{}
@@ -1208,11 +1315,15 @@
\def\SC@orig@caption[##1]##2{\caption@defrost}%
\caption@setSC@justify % for compatibility mode
\caption@ORI@endSC@FLOAT}%
- \ForFloatingEnvironments{%
- \newenvironment{SC#1}%
- {\SC@float[\@nameuse{SC@#1@vpos}]{#1}}{\endSC@float}%
- \newenvironment{SC#1*}%
- {\SC@dblfloat[\@nameuse{SC@#1@vpos}]{#1}}{\endSC@dblfloat}}%
+ \newcommand*\caption@For@SC[2]{%
+ \def#1{b}% = \sidecaptionvpos{#2}{b} (v1.6)
+ \newenvironment{SC#2}%
+ {\SC@float[#1]{#2}}{\endSC@float}%
+ \newenvironment{SC#2*}%
+ {\SC@dblfloat[#1]{#2}}{\endSC@dblfloat}}%
+ \@onlypreamble\caption@For@SC
+ \caption@For{typelist}{%
+ \expandafter\caption@For@SC\csname SC@#1@vpos\endcsname{#1}}%
}{}
\caption@IfPackageLoaded{subfigure}[2002/01/23 v2.1]{%
\def\sf@ifpositiontop{%
@@ -1318,7 +1429,7 @@
\@nameuse{caption@ORI@wrap#1}}%
\caption@restylewrapfloat{figure}%
\caption@restylewrapfloat{table}%
- \ForFloatingEnvironments{%
+ \caption@For{typelist}{%
\newenvironment{wrap#1}{\wrapfloat{#1}}{\endwrapfloat}%
\caption@restylewrapfloat{#1}}%
\ifx\WF@floatstyhook\@undefined \else % wrapfig v3.6
diff --git a/Master/texmf-dist/tex/latex/caption/caption2.sty b/Master/texmf-dist/tex/latex/caption/caption2.sty
index c23bfbcec24..d1d982f9522 100644
--- a/Master/texmf-dist/tex/latex/caption/caption2.sty
+++ b/Master/texmf-dist/tex/latex/caption/caption2.sty
@@ -23,22 +23,22 @@
%% This Current Maintainer of this work is Axel Sommerfeldt.
%%
%% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-%% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-%% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-%% caption-eng.tex, and caption-rus.tex.
+%% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+%% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+%% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%%
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesPackage{caption2}[2007/08/12 v2.2b Customising captions (AS)]
\PackageWarning{caption2}{%
****************************************************\MessageBreak
THIS PACKAGE IS OBSOLETE:\MessageBreak
- This package attempts to provide an caption 2.0/2.1\MessageBreak
- author environment so that OLD documents can be\MessageBreak
- successfully processed.\MessageBreak
- It should NOT be used for NEW documents! New\MessageBreak
- documents should use the caption package instead.\MessageBreak
+ This package attempts to provide an `caption2'\MessageBreak
+ package v2.0/2.1 author environment so that OLD\MessageBreak
+ documents can be successfully processed. It should\MessageBreak
+ NOT be used for NEW documents! New documents should\MessageBreak
+ use the regular `caption' package v3.x instead.\MessageBreak
****************************************************\@gobbletwo}%
-\RequirePackage{caption3}[2007/08/12] % needs v3.1 or newer
+\RequirePackage{caption3}[2007/09/01] % needs v3.1 or newer
\@ifpackageloaded{caption}{%
\PackageError{caption2}{%
You can't use both, the (current) caption *and*\MessageBreak
diff --git a/Master/texmf-dist/tex/latex/caption/caption3.sty b/Master/texmf-dist/tex/latex/caption/caption3.sty
index 0459e0cd472..02bd5e3f470 100644
--- a/Master/texmf-dist/tex/latex/caption/caption3.sty
+++ b/Master/texmf-dist/tex/latex/caption/caption3.sty
@@ -23,12 +23,12 @@
%% This Current Maintainer of this work is Axel Sommerfeldt.
%%
%% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-%% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-%% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-%% caption-eng.tex, and caption-rus.tex.
+%% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+%% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+%% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%%
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{caption3}[2007/11/04 v3.1e caption3 kernel (AR)]
+\ProvidesPackage{caption3}[2007/12/21 v3.1f caption3 kernel (AR)]
\providecommand*\@nameundef[1]{%
\expandafter\let\csname #1\endcsname\@undefined}
\providecommand\l@addto@macro[2]{%
@@ -211,23 +211,27 @@
\newcommand*\@captionsetup[1]{%
\@ifnextchar[{\caption@setup@options#1}\caption@setup}
\newcommand*\caption@setup{\caption@setkeys{caption}}
-\def\caption@setup@options#1[#2]{%
- % #1 is \@gobble in star form, and \@firstofone otherwise
- #1{\caption@addtooptlist{#2}}%
- \expandafter\caption@l@addto@list\csname caption@opt@#2\endcsname}
+\def\caption@setup@options#1[#2]#3{%
+ \@bsphack
+ % #1 is \@gobble in star form, and \@firstofone otherwise
+ #1{\caption@addtooptlist{#2}}%
+ \expandafter\caption@l@addto@list\csname caption@opt@#2\endcsname{#3}%
+ \@esphack}
\newcommand*\clearcaptionsetup{%
\caption@teststar@\@clearcaptionsetup\@gobble\@firstofone}
\newcommand*\@clearcaptionsetup[1]{%
\let\caption@tempa#1%
\@testopt\@@clearcaptionsetup{}}
\def\@@clearcaptionsetup[#1]#2{%
- \expandafter\caption@ifempty@list\csname caption@opt@#2\endcsname
- {\caption@tempa{\caption@Warning{Option list `#2' undefined}}}%
- {\ifx,#1,%
- \caption@clearsetup{#2}%
- \else
- \caption@@removefromsetup{#1}{#2}%
- \fi}}
+ \@bsphack
+ \expandafter\caption@ifempty@list\csname caption@opt@#2\endcsname
+ {\caption@tempa{\caption@Warning{Option list `#2' undefined}}}%
+ {\ifx,#1,%
+ \caption@clearsetup{#2}%
+ \else
+ \caption@@removefromsetup{#1}{#2}%
+ \fi}%
+ \@esphack}
\newcommand*\caption@clearsetup[1]{%
\caption@removefromoptlist{#1}%
\@nameundef{caption@opt@#1}}
@@ -253,23 +257,25 @@
\caption@tempa{\caption@Warning{%
Option `#1' was not in list `#2'\MessageBreak}}}
\newcommand*\showcaptionsetup[2][\@firstofone]{%
- \GenericWarning{}{%
- #1 Caption Info: Option list on `#2'\MessageBreak
- #1 Caption Data: \@ifundefined{caption@opt@#2}{%
- -none-%
- }{%
- {\expandafter\expandafter\expandafter\strip@prefix
- \expandafter\meaning\csname caption@opt@#2\endcsname}%
- }}}
+ \@bsphack
+ \GenericWarning{}{%
+ #1 Caption Info: Option list on `#2'\MessageBreak
+ #1 Caption Data: \@ifundefined{caption@opt@#2}{%
+ -none-%
+ }{%
+ {\expandafter\expandafter\expandafter\strip@prefix
+ \expandafter\meaning\csname caption@opt@#2\endcsname}%
+ }}%
+ \@esphack}
\DeclareCaptionOption{options}{\caption@setoptions{#1}}
\newcommand*\caption@setoptions[1]{%
\caption@Debug{options=#1}%
- \expandafter\let\expandafter\@tempa\csname caption@opt@#1\endcsname
- \ifx\@tempa\relax \else
- \let\caption@iftypewarning\@firstoftwo % = true
- \expandafter\caption@setup\expandafter{\@tempa}%
+ \expandafter\let\expandafter\caption@opt\csname caption@opt@#1\endcsname
+ \ifx\caption@opt\relax \else
+ \caption@xsetup\caption@opt
\caption@clearsetup{#1}%
\fi}
+\newcommand*\caption@xsetup[1]{\expandafter\caption@setup\expandafter{#1}}
\newcommand*\caption@addtooptlist[1]{%
\@ifundefined{caption@opt@#1@lineno}{%
\caption@dooptlist\caption@g@addto@list{#1}%
@@ -290,18 +296,18 @@
on input line \csname caption@opt@#1@lineno\endcsname}}}
\newcommand*\caption@setkeys{\@dblarg\caption@@setkeys}
\long\def\caption@@setkeys[#1]#2#3{%
+ \@bsphack
\expandafter\let\csname ORI@KV@err\caption@keydepth\endcsname\KV@err
\expandafter\let\csname ORI@KV@errx\caption@keydepth\endcsname\KV@errx
- \@ifundefined{#1@KV@err}%
- {\let\KV@err\ORI@KV@err\let\KV@errx\ORI@KV@errx}%
- {\expandafter\let\expandafter\KV@err\csname #1@KV@err\endcsname
- \let\KV@errx\KV@err}%
+ \expandafter\let\expandafter\KV@err\csname #1@KV@err\endcsname
+ \let\KV@errx\KV@err
\edef\caption@keydepth{\caption@keydepth i}%
\caption@Debug{\protect\setkeys{#2}{#3}}%
\setkeys{#2}{#3}%
\edef\caption@keydepth{\expandafter\@cdr\caption@keydepth\@nil}%
\expandafter\let\expandafter\KV@err\csname ORI@KV@err\caption@keydepth\endcsname
- \expandafter\let\expandafter\KV@errx\csname ORI@KV@errx\caption@keydepth\endcsname}
+ \expandafter\let\expandafter\KV@errx\csname ORI@KV@errx\caption@keydepth\endcsname
+ \@esphack}
\let\caption@keydepth\@empty
\newcommand*\caption@ExecuteOptions[2]{%
\@expandtwoargs\caption@setkeys{#1}{#2}}%
@@ -337,6 +343,7 @@
\DeclareCaptionOption{margin*}{\setcaptionmargin*{#1}}
\DeclareCaptionOption{width}{\setcaptionwidth{#1}}
\DeclareCaptionOption{twoside}[1]{\caption@set@bool\caption@iftwoside{#1}}
+\DeclareCaptionOptionNoValue{oneside}{\caption@set@bool\caption@iftwoside0}
\DeclareCaptionOption{minmargin}{\caption@setoptcmd\caption@minmargin{#1}}
\DeclareCaptionOption{maxmargin}{\caption@setoptcmd\caption@maxmargin{#1}}
\newcommand*\setcaptionmargin{%
@@ -360,8 +367,13 @@
\newcommand*\caption@newlabel{\@newl@bel{caption@r}}
\newcommand*\caption@thepage{\the\c@page}
\newcommand*\caption@label[1]{%
+ \caption@@label
\protected@write\@auxout{\let\caption@thepage\relax}%
{\string\caption@newlabel{#1}{\caption@thepage}}}
+\newcommand*\caption@@label{%
+ \global\let\caption@@label\relax
+ \protected@write\@auxout{}%
+ {\string\providecommand*\string\caption@newlabel[2]{}}}
\newcommand*\caption@pageref[1]{%
\expandafter\ifx\csname caption@r@#1\endcsname\relax
\G@refundefinedtrue % => 'There are undefined references.'
@@ -427,13 +439,12 @@
{#1{\caption@Error{Undefined style `#2'}}}%
{\expandafter\let\expandafter\caption@sty\csname caption@sty@#2\endcsname
\ifx\caption@setstyle@flag\@undefined
- \let\caption@setstyle@flag\caption@setstyle
- \let\caption@iftypewarning\@firstoftwo % = true
+ \let\caption@setstyle@flag\relax
\caption@resetstyle
- \expandafter\caption@setup\expandafter{\caption@sty}%
+ \caption@xsetup\caption@sty
\let\caption@setstyle@flag\@undefined
\else
- \expandafter\caption@setup\expandafter{\caption@sty}%
+ \caption@xsetup\caption@sty
\fi
\expandafter\let\expandafter\caption@sls\csname caption@sls@#2\endcsname
\expandafter\caption@l@addto@list\expandafter\caption@opt@singleline
@@ -441,7 +452,7 @@
\newcommand*\caption@resetstyle{%
\caption@setup{%
format=plain,labelformat=default,labelsep=colon,textformat=simple,%
- justification=justified,font=,labelfont=,textfont=,%
+ justification=justified,font=,size=,labelfont=,textfont=,%
margin=0pt,minmargin=0,maxmargin=0,%
indent=0pt,parindent=0pt,hangindent=0pt,%
singlelinecheck=1,strut=1}%
@@ -491,6 +502,7 @@
\DeclareCaptionLabelFormat{empty}{}
\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{\nobreakspace}#2}
\DeclareCaptionLabelFormat{parens}{\bothIfFirst{#1}{\nobreakspace}(#2)}
+\DeclareCaptionLabelFormat{brace}{\bothIfFirst{#1}{\nobreakspace}#2)}
\def\caption@lfmt@default{\caption@lfmt@simple}
\newcommand\DeclareCaptionLabelSeparator{%
\caption@teststar\caption@declarelabelseparator\@gobble\@firstofone}
@@ -541,14 +553,20 @@
\global\@namedef{caption#1@default}{#2}}
\@onlypreamble\DeclareDefaultCaptionFont
\DeclareCaptionOption{font}{\caption@setfont{font}{#1}}
+\DeclareCaptionOption{font+}{\caption@addtofont{font}{#1}}
\DeclareDefaultCaptionFont{font}{}
\DeclareCaptionOption{labelfont}{\caption@setfont{labelfont}{#1}}
+\DeclareCaptionOption{labelfont+}{\caption@addtofont{labelfont}{#1}}
\DeclareDefaultCaptionFont{labelfont}{}
\DeclareCaptionOption{textfont}{\caption@setfont{textfont}{#1}}
+\DeclareCaptionOption{textfont+}{\caption@addtofont{textfont}{#1}}
\DeclareDefaultCaptionFont{textfont}{}
-\newcommand*\caption@setfont[2]{%
+\newcommand*\caption@setfont[1]{%
+ \expandafter\let\csname caption#1\endcsname\@empty
+ \caption@addtofont{#1}}
+\newcommand*\caption@addtofont[2]{%
\begingroup
- \let\caption@fnt\@empty
+ \expandafter\let\expandafter\caption@fnt\csname caption#1\endcsname
\define@key{caption@fnt}{default}[]{%
\l@addto@macro\caption@fnt{\csname caption#1@default\endcsname}}%
\caption@setkeys[caption]{caption@fnt}{#2}%
@@ -592,7 +610,6 @@
\KV@caption@fnt@normalfont\@unused
\KV@caption@fnt@normalsize\@unused
\KV@caption@fnt@singlespacing\@unused}}
-\providecommand\captionsize{}
\DeclareCaptionOption{size}{\caption@setfont{size}{#1}}
\DeclareDefaultCaptionFont{size}{}
\newcommand*\DeclareCaptionJustification[2]{%
@@ -711,25 +728,25 @@
\newcommand*\caption@endhook{}
\newcommand*\AtBeginCaption{\l@addto@macro\caption@beginhook}
\newcommand*\AtEndCaption{\l@addto@macro\caption@endhook}
-\DeclareCaptionOption{listof}{\caption@set@bool\caption@iflof{#1}}
-\newcommand*\DeclareCaptionListOfFormat[2]{%
+\DeclareCaptionOption{list}{\caption@set@bool\caption@iflist{#1}}
+\DeclareCaptionOption{listof}{\caption@set@bool\caption@iflist{#1}}
+\newcommand*\DeclareCaptionListFormat[2]{%
\global\@namedef{caption@lstfmt@#1}##1##2{#2}}
-\@onlypreamble\DeclareCaptionListOfFormat
-\DeclareCaptionOption{listofformat}{\caption@setlistofformat{#1}}
-\newcommand*\caption@setlistofformat[1]{%
+\@onlypreamble\DeclareCaptionListFormat
+\DeclareCaptionOption{listformat}{\caption@setlistformat{#1}}
+\newcommand*\caption@setlistformat[1]{%
\@ifundefined{caption@lstfmt@#1}%
- {\caption@Error{Undefined list-of format `#1'}}%
+ {\caption@Error{Undefined list format `#1'}}%
{\expandafter\let\expandafter\caption@lstfmt
\csname caption@lstfmt@#1\endcsname}}
-\DeclareCaptionListOfFormat{empty}{}
-\DeclareCaptionListOfFormat{simple}{#1#2}
-\DeclareCaptionListOfFormat{parens}{#1(#2)}
-\DeclareCaptionListOfFormat{subsimple}{#2}
-\DeclareCaptionListOfFormat{subparens}{(#2)}
+\DeclareCaptionListFormat{empty}{}
+\DeclareCaptionListFormat{simple}{#1#2}
+\DeclareCaptionListFormat{parens}{#1(#2)}
+\DeclareCaptionListFormat{subsimple}{#2}
+\DeclareCaptionListFormat{subparens}{(#2)}
\def\caption@lstfmt@default{\caption@lstfmt@subsimple}
\DeclareCaptionOption{debug}[1]{%
\caption@set@bool\caption@ifdebug{#1}%
- \let\caption@iftypewarning\caption@ifdebug
\caption@ifdebug
{\def\caption@Debug{\PackageInfo{caption}}}%
{\let\caption@Debug\@gobble}}
@@ -964,7 +981,7 @@
\DeclareDefaultCaptionFont{textfont}{\itshape}%
\DeclareCaptionLabelSeparator{default}{\captionseparator\space}%
}
-\captionsetup{style=default,position=default,listof=1,listofformat=default,%
+\captionsetup{style=default,position=default,list=1,listformat=default,%
twoside=\if@twoside 1\else 0\fi}
\ProcessOptions*
\caption@IfCheckCommand{%
@@ -977,7 +994,7 @@
\caption@Debug{\string\@makecaption\space=\space\meaning\@makecaption\@gobble}%
}
\newcommand*\caption@addcontentsline[2]{%
- \caption@iflof%
+ \caption@iflist
{\def\@tempa{#2}}%
{\let\@tempa\@empty}%
\ifx\@tempa\@empty \else
@@ -1016,7 +1033,7 @@
\hspace\@tempdima
\@tempdima\captionwidth
\caption@ifh{\advance\@tempdima-\caption@indent}%
- \captionbox\@tempdima{%
+ \caption@parbox\@tempdima{%
\caption@ifh{%
\ifdim\caption@indent=\z@
\leavevmode
@@ -1069,7 +1086,7 @@
\fi
\caption@Debug{End SLC}}
\newcommand*\caption@singleline{%
- \expandafter\caption@setup\expandafter{\caption@opt@singleline}%
+ \caption@xsetup\caption@opt@singleline
\let\caption@fmt\caption@slfmt}
\newcommand*\caption@prepareslc{%
\let\@footnotetext\@gobble\let\@endnotetext\@gobble
@@ -1077,7 +1094,7 @@
\let\stepcounter\caption@l@stepcounter
\let\refstepcounter\stepcounter\let\H@refstepcounter\stepcounter}
\newcommand*\caption@l@stepcounter[1]{\advance\csname c@#1\endcsname\@ne\relax}
-\newcommand*\captionbox{\parbox[b]}
+\newcommand*\caption@parbox{\parbox[b]}
\newcommand\caption@@@make[2]{%
\sbox\@tempboxa{#1}%
\ifdim\wd\@tempboxa=\z@
@@ -1087,7 +1104,7 @@
\let\caption@lsep\relax
}%
\@setpar{\@@par\caption@@par}\caption@@par
- \caption@hj\captionsize\captionfont\caption@fmt
+ \caption@hj\captionfont\captionsize\caption@fmt
{\ifcaption@star\else{\captionlabelfont#1}\fi}%
{\ifcaption@star\else{\caption@iflf\captionlabelfont\caption@lsep}\fi}%
{{\captiontextfont
@@ -1110,22 +1127,15 @@
\caption@ifempty\@unused}
\newcommand*\caption@@par{%
\parindent\caption@parindent\hangindent\caption@hangindent}%
-\providecommand*\DeclareFloatingEnvironment{%
- \@ifnextchar[%]
- \caption@@DeclareFloatingEnvironment\caption@DeclareFloatingEnvironment}
-\@onlypreamble\DeclareFloatingEnvironment
-\newcommand*\caption@DeclareFloatingEnvironment[1]{%
- \caption@@DeclareFloatingEnvironment[lo#1]{#1}}
-\@onlypreamble\caption@DeclareFloatingEnvironment
-\def\caption@@DeclareFloatingEnvironment[#1]#2{%
- \@ifundefined{c@chapter}%
- {\newcounter{#2}%
- \@namedef{the#2}{\arabic{#2}}%
- \@namedef{theH#2}{\arabic{#2}}}%
- {\newcounter{#2}[chapter]%
- \@namedef{the#2}{\ifnum\c@chapter>\z@ \thechapter.\fi \arabic{#2}}%
- \@namedef{theH#2}{\theHchapter.\arabic{#2}}}%
- \@namedef{fps@#2}{tbp}%
+\newcommand*\DeclareCaptionType{%
+ \@testopt\@DeclareCaptionType{}}
+\@onlypreamble\DeclareCaptionType
+\def\@DeclareCaptionType[#1]#2{%
+ \def\caption@type{#2}%
+ \caption@Debug{New type `#2'}%
+ \newcounter{#2}\@namedef{theH#2}{}%
+ \KV@caption@DCT@within{\@ifundefined{c@chapter}{none}{chapter}}%
+ \KV@caption@DCT@placement{tbp}%
\@ifundefined{c@float@type}%
{\newcounter{float@type}%
\setcounter{float@type}{\@ifundefined{c@figure}14}}%
@@ -1133,18 +1143,11 @@
\caption@Debug{float type `#2'=\the\value{float@type}}%
\expandafter\xdef\csname ftype@#2\endcsname{\the\value{float@type}}%
\addtocounter{float@type}{\value{float@type}}%
- \@namedef{ext@#2}{#1}%
+ \KV@caption@DCT@fileext{lo#2}%
\@namedef{fnum@#2}{\@nameuse{#2name}\nobreakspace\@nameuse{the#2}}%
\newenvironment{#2}{\@float{#2}}{\end@float}%
\newenvironment{#2*}{\@dblfloat{#2}}{\end@dblfloat}%
- \expandafter\newcommand\csname listof#2s\endcsname{\begingroup
- \expandafter\let\expandafter\listfigurename\csname list#2name\endcsname
- \expandafter\let\expandafter\ext@figure\csname ext@#2\endcsname
- \let\caption@ORI@starttoc\@starttoc
- \renewcommand*\@starttoc[1]{%
- \expandafter\caption@ORI@starttoc\expandafter{\ext@figure}}%
- \listoffigures
- \endgroup}%
+ \expandafter\newcommand\csname listof#2s\endcsname{\caption@listof{#2}}%
\@ifundefined{l@figure}%
{\@namedef{l@#2}{\@dottedtocline{1}{1.5em}{2.3em}}}%
{\expandafter\let\csname l@#2\endcsname\l@figure}%
@@ -1158,45 +1161,139 @@
\expandafter\let\csname #2name\endcsname\@tempa
\expandafter\newcommand\csname list#2name\endcsname{}%
\expandafter\xdef\csname list#2name\endcsname{List of \@tempa s}%
- \@cons\caption@floatlist{{#2}}%
- \@ifnextchar[{\caption@@@DeclareFloatingEnvironment{#2}}\relax}
-\@onlypreamble\caption@@DeclareFloatingEnvironment
-\def\caption@@@DeclareFloatingEnvironment#1[#2]{%
- \@namedef{#1name}{#2}%
- \@ifnextchar[{\caption@@@@DeclareFloatingEnvironment{#1}}\relax}
-\@onlypreamble\caption@@@DeclareFloatingEnvironment
-\def\caption@@@@DeclareFloatingEnvironment#1[#2]{%
- \@namedef{list#1name}{#2}}
-\@onlypreamble\caption@@@@DeclareFloatingEnvironment
-\newcommand*\caption@floatlist{}
-\providecommand\ForFloatingEnvironments[1]{%
- \caption@AtBeginDocument{%
- \def\@elt##1{#1}%
- \caption@floatlist
+ \@cons\caption@typelist{{#2}}%
+ \caption@setkeys[caption]{caption@DCT}{#1}%
+ \@ifnextchar[\@@DeclareCaptionType\relax}
+\@onlypreamble\@DeclareCaptionType
+\def\@@DeclareCaptionType[#1]{%
+ \KV@caption@DCT@name{#1}%
+ \@ifnextchar[\@@@DeclareCaptionType\relax}
+\@onlypreamble\@@DeclareCaptionType
+\def\@@@DeclareCaptionType[#1]{%
+ \KV@caption@DCT@listname{#1}}
+\@onlypreamble\@@@DeclareCaptionType
+\let\DeclareFloatingEnvironment\DeclareCaptionType % old command name
+\newcommand*\caption@listof[1]{%
+ \begingroup
+ \expandafter\let\expandafter\listfigurename\csname list#1name\endcsname
+ \expandafter\let\expandafter\ext@figure\csname ext@#1\endcsname
+ \let\caption@ORI@starttoc\@starttoc
+ \renewcommand*\@starttoc[1]{%
+ \expandafter\caption@ORI@starttoc\expandafter{\ext@figure}}%
+ \listoffigures
+ \endgroup}
+\newcommand*\caption@typelist{}
+\define@key{caption@DCT}{fileext}{\@namedef{ext@\caption@type}{#1}}
+\@onlypreamble@key{caption@DCT}{fileext}
+\define@key{caption@DCT}{listname}{\@namedef{list\caption@type name}{#1}}
+\@onlypreamble@key{caption@DCT}{listname}
+\define@key{caption@DCT}{name}{\@namedef{\caption@type name}{#1}}
+\@onlypreamble@key{caption@DCT}{name}
+\define@key{caption@DCT}{placement}{\@namedef{fps@\caption@type}{#1}}
+\@onlypreamble@key{caption@DCT}{placement}
+\define@key{caption@DCT}{within}{%
+ \@ifundefined{c@chapter}{}{\@removefromreset\caption@type{chapter}}%
+ \@removefromreset\caption@type{section}%
+ \begingroup
+ \caption@setkeys[caption]{caption@within}{#1}%
+ \endgroup}
+\@onlypreamble@key{caption@DCT}{within}
+\define@key{caption@DCT}{without}{\KV@caption@DCT@within{none}}
+\@onlypreamble@key{caption@DCT}{without}
+\define@key{caption@within}{none}[]{%
+ \caption@within{}{}}
+\@onlypreamble@key{caption@within}{none}
+\@ifundefined{c@chapter}{}{%
+ \define@key{caption@within}{chapter}[]{%
+ \@addtoreset\caption@type{chapter}%
+ \caption@within{\ifnum\c@chapter>\z@ \thechapter.\fi}{\theHchapter.}}
+ \@onlypreamble@key{caption@within}{chapter}}
+\define@key{caption@within}{section}[]{%
+ \@addtoreset\caption@type{section}%
+ \caption@within{\ifnum\c@section>\z@ \thesection.\fi}{\theHsection.}}
+\@onlypreamble@key{caption@within}{section}
+\newcommand*\caption@within{%
+ \expandafter\caption@within@\expandafter{\caption@type}}
+\@onlypreamble\caption@within
+\newcommand*\caption@within@[3]{%
+ \global\@namedef{the\caption@type}{#2\arabic{#1}}%
+ \@ifundefined{theH\caption@type}\caption@AtBeginDocument\@firstofone
+ {\global\@namedef{theH\caption@type}{#3\arabic{#1}}}}
+\@onlypreamble\caption@within@
+\providecommand*\@removefromreset[2]{{%
+ \expandafter\let\csname c@#1\endcsname\@removefromreset
+ \def\@elt##1{%
+ \expandafter\ifx\csname c@##1\endcsname\@removefromreset
+ \else
+ \noexpand\@elt{##1}%
+ \fi}%
+ \expandafter\xdef\csname cl@#2\endcsname{%
+ \csname cl@#2\endcsname}}}
+\newcommand*\DeclareCaptionSubType{%
+ \caption@teststar\@DeclareCaptionSubType\@firstoftwo\@secondoftwo}
+\@onlypreamble\DeclareCaptionSubType
+\newcommand*\@DeclareCaptionSubType[1]{%
+ \@testopt{\@@DeclareCaptionSubType{#1}}{alph}}
+\@onlypreamble\@DeclareCaptionSubType
+\def\@@DeclareCaptionSubType#1[#2]#3{%
+ \@ifundefined{c@#3}%
+ {\caption@Error{No float type '#3' defined}}%
+ {\@ifundefined{c@sub#3}%
+ {\caption@Debug{New subtype `sub#3'}%
+ \newcounter{sub#3}%
+ \@namedef{ext@sub#3}{\csname ext@#3\endcsname}%
+ \@ifundefined{l@chapter}%
+ {\edef\@tempa{\expandafter\expandafter\expandafter\noexpand
+ \expandafter\@car\l@subsubsection\@nil}%
+ \def\@tempb{\@dottedtocline}%
+ \ifx\@tempa\@tempb % \l@subsubsection starts with \@dottedtocline
+ \expandafter\edef\csname l@sub#3\endcsname{%
+ \noexpand\@dottedtocline{2}%
+ \expandafter\expandafter\expandafter\noexpand
+ \expandafter\@gobbletwo\l@subsubsection}%
+ \else
+ \@namedef{l@sub#3}{\@dottedtocline{2}{3.8em}{3.2em}}%
+ \fi}%
+ {\expandafter\let\csname l@sub#3\endcsname\l@subsection}%
+ \@cons\caption@subtypelist{{#3}}}%
+ {\caption@Debug{Modify caption `sub#3'}}%
+ #1% is \@firstoftwo in star form, and \@secondoftwo otherwise
+ {\@namedef{p@sub#3}{}%
+ \@namedef{thesub#3}{\csname the#3\endcsname.\@nameuse{#2}{sub#3}}}%
+ {\@namedef{p@sub#3}{\csname the#3\endcsname}%
+ \@namedef{thesub#3}{\@nameuse{#2}{sub#3}}}%
+ \@namedef{theHsub#3}{\csname theH#3\endcsname.\arabic{sub#3}}%
+ \@namedef{sub#3autorefname}{\csname #3name\endcsname}}}
+\@onlypreamble\@@DeclareCaptionSubType
+\newcommand*\caption@subtypelist{}
+\newcommand*\caption@For{\caption@withoptargs\caption@@For}
+\@onlypreamble\caption@For
+\newcommand\caption@@For[3]{%
+ \caption@AtBeginDocument#1{%
+ \def\@elt##1{#3}%
+ \@nameuse{caption@#2}%
\let\@elt\relax}}%
-\@onlypreamble\ForFloatingEnvironments
+\@onlypreamble\caption@@For
\caption@AtBeginDocument{%
\def\@tempa{\@ifstar\sf@@subref\sf@subref}%
\ifx\subref\@tempa
\PackageInfo{caption3}{subfig package 1.2 or 1.3 is loaded\@gobble}%
\let\caption@setfloattype\@gobble
- \let\sf@ifpositiontop\caption@iftop
- \def\@dottedxxxline#1#2#3#4#5#6#7{%
- \begingroup
- \caption@setfloattype{#1}%
- \caption@setoptions{subfloat}%
- \caption@setoptions{sub#1}%
- \ifnum #3>\@nameuse{c@#2depth}\else
- \@dottedtocline{\z@}{#4}{#5}{#6}{#7}%
- \fi
- \endgroup}%
- \let\sf@subfloat\sf@NEW@subfloat
+ \let\@dottedxxxline\sf@NEW@dottedxxxline
+ \let\sf@subfloat\sf@NEW@subfloat
\DeclareRobustCommand*\subref{\@ifstar\sf@@subref\sf@subref}%
- \caption@removefromoptlist{subfloat}%
- \caption@removefromoptlist{subfigure}%
- \caption@removefromoptlist{subtable}%
\fi
+ \let\sf@NEW@dottedxxxline\@undefined
\let\sf@NEW@subfloat\@undefined}
+\def\sf@NEW@dottedxxxline#1#2#3#4#5#6#7{%
+ \begingroup
+ \caption@setfloattype{#1}%
+ \caption@setoptions{subfloat}%
+ \caption@setoptions{sub#1}%
+ \ifnum #3>\@nameuse{c@#2depth}\else
+ \@dottedtocline{\z@}{#4}{#5}{#6}{#7}%
+ \fi
+ \endgroup}
\def\sf@NEW@subfloat{%
\begingroup
\caption@setfloattype\@captype
@@ -1216,7 +1313,7 @@
\setcounter{sub\@captype @save}{\value{sub\@captype}}%
\@ifnextchar [% %] match left bracket
{\sf@@subfloat}%
- {\sf@@subfloat[\@empty]}}%
+ {\sf@@subfloat[\@empty]}}
\endinput
%%
%% End of file `caption3.sty'.
diff --git a/Master/texmf-dist/tex/latex/caption/ltcaption.sty b/Master/texmf-dist/tex/latex/caption/ltcaption.sty
index 3c752d16979..852b6efaaa8 100644
--- a/Master/texmf-dist/tex/latex/caption/ltcaption.sty
+++ b/Master/texmf-dist/tex/latex/caption/ltcaption.sty
@@ -23,9 +23,9 @@
%% This Current Maintainer of this work is Axel Sommerfeldt.
%%
%% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
-%% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
-%% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
-%% caption-eng.tex, and caption-rus.tex.
+%% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+%% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+%% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
%%
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesPackage{ltcaption}[2007/09/01 v1.1 longtable captions (AR)]
diff --git a/Master/texmf-dist/tex/latex/caption/subcaption.sty b/Master/texmf-dist/tex/latex/caption/subcaption.sty
new file mode 100644
index 00000000000..5f6ee5c2508
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/caption/subcaption.sty
@@ -0,0 +1,104 @@
+%%
+%% This is file `subcaption.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% subcaption.dtx (with options: `package')
+%%
+%% Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de)
+%%
+%% --------------------------------------------------------------------------
+%%
+%% This work 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".
+%%
+%% This Current Maintainer of this work is Axel Sommerfeldt.
+%%
+%% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
+%% ltcaption.dtx, and subcaption.dtx, the derived files caption.sty,
+%% caption2.sty, caption3.sty, ltcaption.sty, and subcaption.sty, and the
+%% user manuals caption-deu.tex, caption-eng.tex, and caption-rus.tex.
+%%
+\NeedsTeXFormat{LaTeX2e}[1994/12/01]
+\ProvidesPackage{subcaption}[2007/12/06 v0.3 Adding subcaptions (AR)]
+\@ifundefined{caption@subtypehook}{% we need caption v3.1f or newer
+ \PackageError{subcaption}{`caption' package not loaded\MessageBreak
+ (which is needed by this package)\@gobble}{%
+ If you do not understand this error, please take a closer look\MessageBreak
+ at the documentation of the `subcaption' package.\MessageBreak
+ \@ehc}%
+ \endinput}{}
+\let\caption@setkeys@ORI\caption@setkeys
+\renewcommand\caption@setkeys[2]{\captionsetup[sub]{#2}}
+\caption@ExecuteOptions{subcaption}{%
+ font+=small,labelformat=parens,labelsep=space,skip=6pt,list=0,hypcap=0}
+\caption@ProcessOptions*{subcaption}
+\let\caption@setkeys\caption@setkeys@ORI
+\let\caption@setkeys@ORI\@undefined
+\@ifundefined{c@figure}{}{\DeclareCaptionSubType{figure}}
+\@ifundefined{c@table}{}{\DeclareCaptionSubType{table}}
+\caption@For{typelist}{\DeclareCaptionSubType{#1}}
+\newcommand*\subcaption{\captionsetup{subtype*}\caption}
+\g@addto@macro\caption@subtypehook{\let\subcaption\caption}
+\caption@For{subtypelist}{%
+ \newenvironment{sub#1}%
+ {\caption@withoptargs\subcaption@minipage}%
+ {\endminipage}}%
+\newcommand*\subcaption@minipage[2]{%
+ \minipage#1{#2}%
+ \captionsetup{subtype}}
+\newcommand*\subcaptionbox{\caption@withoptargs\subcaption@box}
+\newcommand\subcaption@box[2]{%
+ \@testopt{\subcaption@ibox{#1}{#2}}{\wd\@tempboxa}}
+\long\def\subcaption@ibox#1#2[#3]{%
+ \@testopt{\subcaption@iibox{#1}{#2}{#3}}\subcaptionbox@hj@default}
+\long\def\subcaption@iibox#1#2#3[#4]#5{%
+ \setbox\@tempboxa\hbox{#5}%
+ \begingroup
+ \captionsetup{subtype*}% set \caption@position
+ \caption@iftop{%
+ \endgroup
+ \parbox[t]{#3}{%
+ \captionsetup{subtype,position=t}%
+ \vbox{\caption#1{#2}}%
+ \hrule\@height\z@
+ \csname caption@hj@#4\endcsname
+ \unhbox\@tempboxa}%
+ }{%
+ \endgroup
+ \parbox[b]{#3}{%
+ \captionsetup{subtype,position=b}%
+ \csname caption@hj@#4\endcsname
+ \unhbox\@tempboxa
+ \hrule\@height\z@
+ \vtop{\caption#1{#2}}}%
+ }}
+\providecommand*\caption@hj@c{\centering}
+\providecommand*\caption@hj@l{\raggedright}
+\providecommand*\caption@hj@r{\raggedleft}
+\providecommand*\caption@hj@s{}
+\newcommand*\subcaptionbox@hj@default{c}
+\g@addto@macro\caption@subtypehook{%
+ \ifx\label\subcaption@label \else
+ \let\subcaption@ORI@label\label
+ \let\label\subcaption@label
+ \fi}
+\newcommand*\subcaption@label[1]{%
+ \@bsphack\begingroup
+ \subcaption@ORI@label{#1}%
+ \protected@edef\@currentlabel{\csname thesub\@captype\endcsname}%
+ \subcaption@ORI@label{sub@#1}%
+ \endgroup\@esphack}
+\DeclareRobustCommand*\subref{\caption@withoptargs\subcaption@ref}
+\newcommand*\subcaption@ref[2]{\ref#1{sub@#2}}
+\endinput
+%%
+%% End of file `subcaption.sty'.