% \iffalse meta-comment
% 
% This is file `caption.dtx'.
% 
% Copyright (C) 1994-2004 Axel Sommerfeldt (caption@sommerfeldt.net)
% 
% --------------------------------------------------------------------------
% 
% 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, caption.xml, and anleitung.tex and the derived files
% caption.sty, caption2.sty, caption3.sty, and manual.tex.
% 
% \fi
% \CheckSum{1800}
%
% \iffalse
%<*driver>
\documentclass{ltxdoc}
\setlength\parindent{0pt}
\setlength\parskip{\smallskipamount}
%
\newcommand\NEWfeature{\NEW{New feature}}
\newcommand\NEWdescription{\NEW{New description}}
\newcommand\NEW[2]{%
  \hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft
    #1\\#2}}
%
\ifx\pdfoutput\undefined\else
  \ifcase\pdfoutput\else
    \usepackage{mathptmx,courier}
    \usepackage[scaled=0.90]{helvet}
    \addtolength\marginparwidth{15pt}
  \fi
\fi
%
\usepackage{caption}[2004/11/28]
%\usepackage{float}
\usepackage{longtable,hyperref}
%\usepackage[raggedright]{sidecap}
%
\DeclareCaptionLabelSeparator{period-newline}{. \\}
\DeclareCaptionStyle{period-newline}[labelsep=period]{labelsep=period-newline}
\DeclareCaptionStyle{period-newline2}[labelsep=period,justification=centering]{labelsep=period-newline}
\DeclareCaptionStyle{period-newline3}[labelsep=period]{labelsep=period-newline,justification=centering}
\DeclareCaptionFormat{reverse}{#3#2#1}
\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}
\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{ }#2)}
\DeclareCaptionLabelSeparator{fill}{\hfill}
%
\DeclareRobustCommand{\KOMAScript}{\textsf{K\kern.05em O\kern.05em%
    M\kern.05em A\kern.1em-\kern.1em Script}}
%
\begin{document}
  \DocInput{caption.dtx}
\end{document}
%</driver>
% \fi
%
% \newcommand*{\purerm}[1]{{\upshape\mdseries\rmfamily #1}}
% \newcommand*{\puresf}[1]{{\upshape\mdseries\sffamily #1}}
% \newcommand*{\purett}[1]{{\upshape\mdseries\ttfamily #1}}
% \let\package\puresf\def\thispackage{\package{caption}}
% \let\env\purett \let\opt\purett
% 
% \newenvironment{Options}[1]%
%   {\list{}{\renewcommand{\makelabel}[1]{\texttt{##1}\hfil}%
%    \settowidth{\labelwidth}{\texttt{#1\space}}%
%    \setlength{\leftmargin}{\labelwidth}%
%    \addtolength{\leftmargin}{\labelsep}}}%
%   {\endlist}
% 
% \newenvironment{Example}%
%   {\ifvmode\else\unskip\par\fi
%    \minipage{\linewidth}\smallskip}%
%   {\smallskip\endminipage}
% \newcommand\example[3][figure]{%
%   \begingroup
%     \captionsetup{#2}%
%     \captionof{#1}[]{#3}%
%   \endgroup}
% 
% \GetFileInfo{caption.sty}
% \title{Typesetting captions with the
%        \thispackage\ package\thanks{This package has version number
%        \fileversion, last revised \filedate.}}
% \author{Axel Sommerfeldt\\\href{mailto:caption@sommerfeldt.net}{\texttt{caption@sommerfeldt.net}}}
% \date{2005/06/13}
% \maketitle
% 
% 
% \begin{abstract}
% The \thispackage\ package provides many ways to customise the captions
% in floating environments such |figure| and |table| and cooperates with
% many other packages.\footnote{A complete re-work of the user interface
% done together with Steven D. Cochran and Frank Mittelbach has lead to
% this new enhanced version 3.0.}
% \end{abstract}
% 
% \iffalse
% \tableofcontents
% \fi
% 
% \newcommand\figuretext{%
%   White sand beaches. The pink smoothness of the conch shell. A sea abundant
%   with possibilities. Duty-free shops filled with Europe's finest gifts and
%   perfumes. Play your favorite game of golf amidst the tropical greens on one
%   of the many championship courses.}
%
% 
% \section{Introduction}
% 
% Within the standard \LaTeX\ 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{belowskip=\abovecaptionskip}{\figuretext}
% 
% There should be possibilities to change this; e.g., it would be nice if you
% can 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:
% 
% \example{belowskip=\abovecaptionskip,size=small,margin=10pt,labelfont=bf}{\figuretext}
% 
% With this package you can do this easily as there are many ready-to-use
% caption formatting options, but you are free to define your very own stuff, too.
% 
% 
% \pagebreak[4]
% \section{Using the package}
% \label{usage}
% 
% \DescribeMacro{\usepackage}
% Insert
% \begin{quote}
%   |\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}|.
% The options control how your captions will look like; e.g.,
% \begin{quote}
%   |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}|
% \end{quote}
% would result in captions looking like the second one in the introduction.
% 
% \DescribeMacro{\captionsetup}
% For a later change of options the \thispackage\ package provides the command
% \begin{quote}
%   |\captionsetup|\oarg{float type}\marg{options}
% \end{quote}
% So
% \begin{quote}
%   |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}|
% \end{quote}
% and
% \begin{quote}
%   |\usepackage{caption}|\\
%   |\captionsetup{margin=10pt,font=small,labelfont=bf}|
% \end{quote}
% are equal in their results.
% 
% It's good to know that |\captionsetup| has an effect on the current
% environment only. So if you want to change some settings for the
% current |figure| or |table| only, just place the |\captionsetup| command
% inside the |figure| or |table| right before the |\caption| command.
% For example
% \begin{quote}
%   |\begin{figure}|\\
%   |  |\ldots\\
%   |  \captionsetup{singlelinecheck=off}|\\
%   |  \caption{|\ldots|}|\\
%   |\end{figure}|
% \end{quote}
% switches the single-line-check off, but only for this |figure| so all
% the other captions remain untouched.
% 
% (For a description of the optional parameter \meta{float type} see
%  section \ref{misc}: \textit{``Useful stuff''}.)
% 
% \section{Options}
% \def\OptionLabel{RaggedRight}
% 
% 
% \subsection{Formatting}
% 
% \DescribeMacro{format=}
% A figure or table caption mainly consits of three parts: the caption label,
% which says if this object is a `Figure' or `Table' and what number is
% associated with it, the caption text itself, which is normally a short
% description of contents, and the caption separator which separates the text
% 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 ,
% \end{quote}
% having the name of the caption format as its argument.
%
% There are two standard caption formats:\footnote{You have the option to
% define your own ones, too. See section \ref{declare}:
% \textit{``Do it yourself!''} for details.}
% 
% \begin{Options}{\OptionLabel}
%   \item[default]
%   Typesets the captions as a normal paragraph.
%   (This is the default behaviour, it
%   is adapted from the standard \LaTeX\ document classes.)
% 
%   \item[hang]
%   Indents the caption text, so it will `hang' under the first line of the text.
% \end{Options}
% 
% \begin{Example}
%   An example: Specifying the option
%   \begin{quote}
%     |format=hang|
%   \end{quote}
%   yields captions like this:
%   \example{format=hang}{\figuretext}
% \end{Example}
% 
% \DescribeMacro{indention=}
% For both formats (\texttt{default} 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}.
% \end{quote}
% 
% Three examples:
% 
% \begin{Example}
%   \begin{quote}
%     |format=default,indention=.5cm|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{format=default,indention=.5cm}{\figuretext}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |format=hang,indention=-0.5cm|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{format=hang,indention=-0.5cm}{\figuretext}
% \end{Example}
% 
% \DescribeMacro{labelformat=}
% With the option
% \begin{quote}
%   |labelformat=|\meta{label format name}
% \end{quote}
% \NEWdescription{v3.0e}
% you specify how the caption label will be typeset.
% There are three standard caption label formats:
% 
% \begin{Options}{\OptionLabel}
%   \item[default]
%   The caption label will be typeset as specified by the document class,
%   usually this means the name and the number (like \texttt{simple}).
%   (This is the default behaviour.)
%
%   \item[empty]
%   The caption label will be empty. This option only makes sense when used
%   together with other options like \texttt{labelsep=none}.
% 
%   \item[simple]
%   The caption label will be typeset as a name and a number.
% 
%   \item[parens]
%   The number of the caption label will be typeset in parentheses.
% \end{Options}
% 
% \begin{Example}
%   An example: Using the options
%   \begin{quote}
%     |labelformat=parens,labelsep=quad|
%   \end{quote}
%   yields captions like this one:
%   \example{labelformat=parens,labelsep=quad}{\figuretext}
% \end{Example}
% 
% \DescribeMacro{labelsep=}
% With the options
% \begin{quote}
%   |labelsep=|\meta{label separator name}
% \end{quote}
% you specify what caption separator will be used.
% You can choose one of the following:
% 
% \begin{Options}{\OptionLabel}
%   \item[none]
%   There is no caption separator. This option only makes sense when used
%   together with other options like \texttt{labelformat=empty}.
% 
%   \item[colon]
%   The caption label and text will be separated by a colon and a space.
%   (This is the default one.)
% 
%   \item[period]
%   The caption label and text will be separated by a period and a space.
% 
%   \item[space]
%   The caption label and text will be separated by a single space.
% 
%   \item[quad]
%   The caption label and text will be separated by a |\quad|.
% 
%   \item[newline]
%   The caption label and text will be separated by a line break (|\\|).
% \end{Options}
% 
% Two examples:
% \begin{Example}
%   \begin{quote}
%     |labelsep=period|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{labelsep=period}{\figuretext}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |labelsep=newline,singlelinecheck=false|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{labelsep=newline,singlelinecheck=false}{\figuretext}
% \end{Example}
% 
% 
% \subsection{Justification}
% 
% \DescribeMacro{justification=}
% As addition to the caption format you could also specify a
% \emph{caption justification}; it is specified with the option
% \begin{quote}
%   |justification=|\meta{justification name}\quad.
% \end{quote}
%
% You can choose one of the following:
% 
% \begin{Options}{\OptionLabel}
%   \item[justified]
%   Typesets the caption as a normal paragraph. (This is the default.)
% 
%   \item[centering]
%   Each line of the caption will be centered.
% 
% \iffalse
%   \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.
% \fi
% 
%   \item[centerlast]
%   The last line of each paragraph of the caption text will be centered.
% 
%   \item[centerfirst]
%   Only the first line of the caption will be centered.
% 
%   \item[raggedright]
%   Each line of the caption will be moved to the left margin.
% 
% \iffalse
%   \item[RaggedRight]
%   Each line of the caption will be moved to the left margin using
%   the command |\RaggedRight| from the \package{ragged2e} package.
% \fi
%   \item[RaggedRight]
%   Each line of the caption will be moved to the left margin, too.
%   But this time the command |\RaggedRight| 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[raggedleft]
%   Each line of the caption will be moved to the right margin.
% 
% \iffalse
%   \item[RaggedLeft]
%   Each line of the caption will be moved to the right margin using
%   the command |\RaggedLeft| from the \package{ragged2e} package.
% \fi
% \end{Options}
% 
% Two examples:
% \begin{Example}
%   \begin{quote}
%     |justification=centerlast|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{justification=centerlast}{\figuretext}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |format=hang,justification=raggedright|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{format=hang,justification=raggedright}{\figuretext}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |labelsep=newline,justification=centering|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{belowskip=\abovecaptionskip,labelsep=newline,justification=centering}{\figuretext}
% \end{Example}
% 
% \DescribeMacro{singlelinecheck=}
% If the caption fit in a single line it will always be centered, ignoring
% the justification you set:
%
% \example{belowskip=\abovecaptionskip}{A short caption.}
%
% This behaviour is adapted from the standard \LaTeX\ document classes
% |article|, |report|, and |book|), but using the \thispackage\ package
% you can switch this special treatment of such short captions off
% with the option
% \begin{quote}
%   |singlelinecheck=|\meta{bool}\quad.
% \end{quote}
% Using |false|, |no|, |off| or |0| for \meta{bool} you switch off the
% extra centering:
% \begin{quote}
%   |singlelinecheck=false|
% \end{quote}
% Doing so the above short caption would look like
% 
% \begingroup
% \captionsetup{type=figure}
% \ContinuedFloat
% \endgroup
% \example{belowskip=\abovecaptionskip,singlelinecheck=false}{A short caption.}
% 
% Using |true|, |yes|, |on| or |1| for \meta{bool} you switch on the
% extra centering again. (The default is on.)
% 
% 
% \subsection{Fonts}
% 
% \DescribeMacro{font=}
% \DescribeMacro{labelfont=}
% \DescribeMacro{textfont=}
% There are three font options which affects different parts of the caption:
% One affecting the whole caption (|font|), one which only affects the caption
% label and separator (|labelfont|) and at last one which only affects the
% caption text (|testfont|).
% You set them up using the options
% \begin{quote}\begin{tabular}{@{}r@{}ll}
%   |font=|      & \marg{font options} & ,\\
%   |labelfont=| & \marg{font options} & and\\
%   |textfont=|  & \marg{font options} & .\\
% \end{tabular}\end{quote}
% 
% And these are the available font options:
% 
% \begin{Options}{\OptionLabel}
%   \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}
% 
%   \item[up]           {\upshape Upright shape}
%   \item[it]           {\itshape Italic shape}
%   \item[sl]           {\slshape Slanted shape}
%   \item[sc]           {\scshape Small Caps shape}
% 
%   \item[md]           {\mdseries Medium series}
%   \item[bf]           {\bfseries Bold series}
% 
%   \item[rm]           {\rmfamily Roman family}
%   \item[sf]           {\sffamily Sans Serif family}
%   \item[tt]           {\ttfamily Typewriter family}
% \end{Options}
% 
% If you use only one of these options you can omit the braces;
% e.g., the options
% \iffalse
% \begin{quote}
% \fi
%   |font={small}|
% \iffalse
% \end{quote}
% \fi
% and
% \iffalse
% \begin{quote}
% \fi
%   |font=small|
% \iffalse
% \end{quote}
% \fi
% yield the same result.
% 
% Two examples:
% \begin{Example}
%   \begin{quote}
%     |font={small,it},labelfont=bf|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{font={small,it},labelfont=bf}{\figuretext}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |font=small,labelfont=bf,textfont=it|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{font=small,labelfont=bf,textfont=it}{\figuretext}
% \end{Example}
% 
% 
% \subsection{Margins and further paragraph options}
% 
% \DescribeMacro{margin=}
% \DescribeMacro{width=}
% For all captions you can specify \emph{either} an extra margin \emph{or}
% a fixed width. You do this using the options
% \begin{quote}\begin{tabular}{@{}r@{}ll}
%   |margin=| & \meta{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 illustrating this:
% \begin{Example}
%   \begin{quote}
%     |margin=10pt|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{margin=10pt}{\figuretext}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |width=.75\textwidth|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{width=.75\textwidth}{\figuretext}
% \end{Example}
% 
% \DescribeMacro{parskip=}
% This option is useful for captions containing more than one paragraph.
% If specifies the extra vertical space inserted between them:
% \begin{quote}
%   |parskip=|\meta{amount}
% \end{quote}
% One example:
% \begin{Example}
%   \begin{quote}
%     |margin=10pt,parskip=5pt|
%   \end{quote}
%   \captionsetup{aboveskip=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.
% 
%     Second paragraph of the caption. This one contains some text, too, to
%     show how these options affect the layout of the caption.}
% \end{Example}
% 
% \DescribeMacro{hangindent=}
% The option
% \begin{quote}
%   |hangindent=|\meta{amount}
% \end{quote}
% is for setting up a hanging indention starting from the second line of each
% paragraph. If the caption contains just a single paragraph, using this option
% leads to the same result as the option |indention=| you already know about.
% But if the caption contains multiple paragraphs you will notice the difference:
% 
% \begin{Example}
%   \begin{quote}
%     |format=hang,indention=-.5cm|
%   \end{quote}
%   \captionsetup{aboveskip=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.
% 
%     Second paragraph of the caption. This one contains some text, too, to
%     show how these options affect the layout of the caption.}
% \end{Example}
% 
% \begin{Example}
%   \begin{quote}
%     |format=hang,hangindent=-.5cm|
%   \end{quote}
%   \captionsetup{aboveskip=0pt}
%   \example{format=hang,hangindent=-.5cm}{
%     First paragraph of the caption. This one contains some test, just to
%     show how these options affect the layout of the caption.
% 
%     Second paragraph of the caption. This one contains some text, too, to
%     show how these options affect the layout of the caption.}
% \end{Example}
% 
% 
% \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.
% 
% You switch to an already defined caption style with the option
% \begin{quote}
%   |style=|\meta{style name}\quad.
% \end{quote}
% The \thispackage\ package usually defines only the style |default| which
% puts all options you already know about to the default ones.
% This means that specifying the option
% \begin{quote}
%   |style=default|
% \end{quote}
% has the same effect as specifying all these options:
% \begin{quote}
%   |format=default,labelformat=simple,labelsep=colon,|\\
%   |justification=justified,font=default,labelfont=default,|\\
%   |textfont=default,margin=0pt,indention=0pt,parindent=0pt|\\
%   |hangindent=0pt,singlelinecheck=true|
% \end{quote}
% 
% 
% \subsection{Skips}
% 
% \DescribeMacro{aboveskip=}
% \DescribeMacro{belowskip=}
% The 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|.
%
% \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}
%
% \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}
%   \begin{minipage}[c]{.5\linewidth}
% \iffalse
%     \captionsetup{aboveskip=0pt}%
% \fi
%     \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:
% \begin{quote}
%   |position=top|\quad(or |position=above|)
% \end{quote}
% tells the \thispackage\ package to use the spacing useful for caption
% \emph{above} the figure or table and
% \begin{quote}
%   |position=bottom|\quad(or |position=below|)
% \end{quote}
% tells the \thispackage\ package 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=top}
%     \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}
%
% (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.)
% 
% \DescribeMacro{tableposition=}
% This option is especially useful when used together with the optional
% argument of the |\captionsetup| command. (See section \ref{misc}:
% \textit{``Useful stuff''} for details.) E.g.,
% \begin{quote}
%   |\captionsetup[table]{position=top}|
% \end{quote}
% causes all captions within tables to be treated as captions \emph{above}
% the table (regarding spacing around it).
% \NEWfeature{v3.0a}
% Because this is a very common setting the \thispackage\ package offers
% an abbreviating option for the use with |\usepackage|:
% \begin{quote}
%   |\usepackage[|\ldots|,tableposition=top]{caption}|
% \end{quote}
% is equivalent to
% \begin{quote}
%   |\usepackage[|\ldots|]{caption}|\\
%   |\captionsetup[table]{position=top}|
% \end{quote}
%
% 
% \pagebreak[4]
% \section{Useful stuff}
% \label{misc}
% 
% \DescribeMacro{\caption}
% The command
% \nopagebreak[3]
% \begin{quote}
%   |\caption|\oarg{lst\_entry}\marg{heading}
% \end{quote}
% \nopagebreak[3]
% typesets the caption inside a floating environment like |figure| or |table|.
% Well, you already know this, but what is new is the fact then when you leave
% the argument \meta{lst\_entry} empty, no entry in the list of figures or
% tables will be made; e.g.,
% \begin{quote}
%   |\caption[]{A figure without entry in the list of figures.}|
% \end{quote}
% 
% \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}|\\
%   |  \caption*{A table}\\|\\
%   |  A & B \\|\\
%   |  C & D \\|\\
%   |\end{longtable}|
% \end{quote}
% looks like
% \begin{longtable}{cc}
%   \caption*{A table}\\
%   A & B \\
%   C & D \\
% \end{longtable}
% 
% This package does it, too, so you can use this command now within every
% floating environment like |figure| or |table|, like here:
% \begin{quote}
%   |\begin{table}|\\
%   |  \caption*{A table}|\\
%   |  \begin{tabular}{cc}|\\
%   |    A & B \\|\\
%   |    C & D \\|\\
%   |  \end{longtable}|\\
%   |\end{table}|
% \end{quote}
% 
% \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 the
% \thispackage\ package offers the command
% \begin{quote}
%   |\captionof|\marg{float type}\oarg{lst\_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
% (e.g. ``Figure'' or ``Table'') and in which list to put the contents entry.
% An example:
% \begin{quote}
%   |\captionof{figure}{A figure}|\\
%   |\captionof{table}{A table}|
% \end{quote}
% typesets captions like this:
% \begin{Example}
%   \captionof{figure}{A figure}
%   \captionsetup{belowskip=\abovecaptionskip}
%   \captionof{table}{A table}
% \end{Example}
% 
% The star variant |\captionof*| has the same behaviour as the |\caption*| command:
% it typesets the caption without label and without entry to the list of figures
% or tables.
%
% Please use both |\captionof| and |\captionof*| only \emph{inside} environments
% (like |minipage| or |\parbox|), otherwise a page break can appear between content
% and caption. Furthermore some strange effects could occur (e.g., wrong spacing
% around captions).
% 
% \DescribeMacro{\ContinuedFloat}
% Sometimes you want to split figures or tables without giving them
% their own reference number. This is what the command
% \begin{quote}
%   |\ContinuedFloat|
% \end{quote}
% is for; it should be used as first command inside the floating environment.
% It prevents the increment of the relevant counter 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\\
%   |\end{table}|\\
%   \ldots\\
%   |\begin{table}\ContinuedFloat|\\
%   |\caption{A table (cont.)}|\\
%   \ldots\\
%   |\end{table}|
% \end{quote}
% gives the following result:
% \begin{Example}
%   \makeatletter\def\@captype{table}\makeatother
%   \caption[]{A table}
%   \centerline{\ldots}
%   \ContinuedFloat
%   \captionsetup{aboveskip=0pt}
%   \caption[]{A table (cont.)}
% \end{Example}
% 
% \DescribeMacro{\captionsetup}
% We already know the |\captionsetup| command (see section \ref{usage}:
% \textit{``Using the package''}), but this time we get enlighten about
% the optional argument \meta{float type}.
% 
% Remember, the syntax of this command is
% \begin{quote}
%   |\captionsetup|\oarg{float type}\marg{options}\quad.
% \end{quote}
% 
% If a \meta{float type} gets specified, all the \meta{options} don't
% change anything at this time. Instead they only get marked for a later use,
% when a caption inside of a floating environment of the particular type
% \meta{float type} gets typeset.
% For example
% \begin{quote}
%   |\captionsetup[figure]|\marg{options}
% \end{quote}
% forces captions within a |figure| environment to use the given \meta{options}.
%
% Here comes an example to illustrate this:
% \begin{quote}
%   |\captionsetup{font=small}|\\
%   |\captionsetup[figure]{labelfont=bf}|
% \end{quote}
% gives captions like this:
% \begin{Example}
%   \captionsetup{font=small}
%   \captionsetup[figure]{labelfont=bf}
%   \captionof{figure}[]{A figure}
%   \captionsetup{belowskip=\abovecaptionskip}
%   \captionof{table}[]{A table}
% \end{Example}
% 
% As you see the command |\captionsetup[figure]{labelfont=bf}| only changed
% the font of the figure caption labels, not touching all other ones.
% 
% \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
% \begin{quote}
%   |\clearcaptionsetup|\marg{Typ}\quad.
% \end{quote}
%
% For example |\clearcaptionsetup{figure}| would clear the extra handling in the
% example above:
% \begin{Example}
%   \captionsetup{font=small}
%   \captionof{figure}[]{A figure}
%   \captionsetup{belowskip=\abovecaptionskip}
%   \captionof{table}[]{A table}
% \end{Example}
% 
% As \meta{float type} you can usually give one of these only two:
% |figure| and |table|.
% But as we will see later some \LaTeX\ packages exist (like the \package{float}
% package for example) who can define additional floating enviroments and these two
% commands also works with them.
% 
% 
% \pagebreak[3]
% \section{Do it yourself!}
% \label{declare}
% 
% A family of commands is provided to allow users to define their own formats.
% 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}|).
% 
% \pagebreak[2]
% \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.
% \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 |default| is defined
% inside |caption.sty| as
% \begin{quote}
%   |\DeclareCaptionFormat{default}{#1#2#3\par}|
% \end{quote}
% 
% \DescribeMacro{\DeclareCaptionLabelFormat}
% 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'').
% 
% \DescribeMacro{\bothIfFirst}
% \DescribeMacro{\bothIfSecond}
% When you define your own caption label formats and use the \package{subfig}
% package\cite{subfig}, too, you must take care of empty caption label names.
% For this purpose the commands
% \begin{quote}
%   |\bothIfFirst|\marg{first arg}\marg{second arg}\quad and\\
%   |\bothIfSecond|\marg{first arg}\marg{second arg}
% \end{quote}
% are offered. |\bothIfFirst| tests if the first argument exists (means: is
% not empty), |\bothIfSecond| tests if the second argument exists. If it is
% so both arguments get typeset, otherwise none of them.
% 
% For example the standard label format |simple| isn't defined as
% \begin{quote}
%   |\DeclareCaptionLabelFormat{simple}{#1 #2}|\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,
% \end{quote}
% causing the space to appear only if the label name is present.
% 
% \pagebreak[3]
% \DescribeMacro{\DeclareCaptionLabelSeparator}
% You can define your own caption label separators with
% \nopagebreak[3]
% \begin{quote}
%   |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}\quad.
% \end{quote}
% \nopagebreak[3]
% Again an easy example taken from |caption.sty| itself:
% \nopagebreak[3]
% \begin{quote}
%   |\DeclareCaptionLabelSeparator{colon}{: }|
% \end{quote}
% \pagebreak[3]
% 
% \DescribeMacro{\DeclareCaptionJustification}
% You can define your own caption justifications with
% \begin{quote}
%   |\DeclareCaptionJustification|\marg{name}\marg{code}\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,
% \end{quote}
% yields captions with all lines moved to the left margin.
% 
% \DescribeMacro{\DeclareCaptionFont}
% You can define your own caption fonts with
% \begin{quote}
%   |\DeclareCaptionFont|\marg{name}\marg{code}\quad.
% \end{quote}
% For example this package defines the options |small| and |bf| as
% \begin{quote}
%   |\DeclareCaptionFont{small}{\small}|\quad and\\
%   |\DeclareCaptionFont{bf}{\bfseries}|\quad.
% \end{quote}
% 
% \DescribeMacro{\DeclareCaptionStyle}
% The best one comes at last: You can define your own caption styles with
% \begin{quote}
%   |\DeclareCaptionStyle|\marg{name}\oarg{additional options}\marg{options}
% \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
% option |style=|\meta{style name}.
%
% All caption styles are based on the default set of options. (See section
% \ref{style}: \textit{``Styles''} for a complete list.) So you only need
% to specify options which are different to them.
% 
% If you specify \meta{additional options} they get used in addition when
% the caption fits into a single line and this check was not disabled with
% the option |singlelinecheck=off|.
% 
% Again a very easy example taken from |caption.sty|:
% \begin{quote}
%   |\DeclareCaptionStyle{default}[justification=centering]{}|
% \end{quote}
% 
% 
% \subsection{Examples}
% 
% If you would like to have a colon \emph{and} a line break as caption
% separator you could define it this way:
% \begin{quote}
%   |\DeclareCaptionLabelSeparator{period-newline}{. \\}|
% \end{quote}
% Selecting this separator with |\captionsetup{labelsep=period-newline}| you
% get captions like this:
% \begin{Example}
%   \captionsetup{labelsep=period-newline,labelfont=bf,margin=10pt}
%   \captionsetup{aboveskip=0pt,type=figure}
%   \caption[]{\figuretext}
% \end{Example}
% 
% For short captions---which fit into one single line---this separator
% may not be satisfying, even when the automatically centering process
% is switched off (with |singlelinecheck=off|):
% \begin{Example}
%   \captionsetup{labelsep=period-newline,labelfont=bf,margin=10pt,singlelinecheck=0}
%   \captionsetup{aboveskip=0pt,type=figure}
%   \caption[]{A figure.}
% \end{Example}
% 
% An own caption style which selects another caption separator automatically
% puts this right:
% \begin{quote}
%   |\DeclareCaptionStyle{period-newline}%|\\
%   |  [labelsep=period]{labelsep=period-newline}|
% \end{quote}
% \begin{Example}
%   \captionsetup{style=period-newline,labelfont=bf,margin=10pt}
%   \captionsetup{aboveskip=0pt,type=figure}
%   \ContinuedFloat
%   \caption[]{A figure.}
% \end{Example}
% If you would like to keep the centering of these captions an appropriate
% definition is
% \begin{quote}
%   |\DeclareCaptionStyle{period-newline}%|\\
%   |  [labelsep=period,justification=centering]%|\\
%   |  {labelsep=period-newline}|
% \end{quote}
% Using this definition short captions look like
% \begin{Example}
%   \captionsetup{style=period-newline2,labelfont=bf,margin=10pt}
%   \captionsetup{aboveskip=0pt,type=figure}
%   \ContinuedFloat
%   \caption[]{A figure.}
% \end{Example}
% while long ones still have a line break after the caption label.
% 
% Slightly changed, you also get centered captions if they are longer than one line:
% \begin{quote}
%   |\DeclareCaptionStyle{period-newline}%|\\
%   |  [labelsep=period]%|\\
%   |  {labelsep=period-newline,justification=centering}|
% \end{quote}
% \begin{Example}
%   \captionsetup{style=period-newline3,labelfont=bf,margin=10pt}
%   \captionsetup{aboveskip=0pt,type=figure}
%   \caption[]{\figuretext}
% \end{Example}
%
% \bigskip\pagebreak[3]
% Another example: You want captions to look like this:
% \begin{Example}
%   \captionsetup{format=reverse,labelformat=fullparens,labelsep=fill,font=small,labelfont=it}
%   \captionsetup{aboveskip=0pt}
%  \captionof{figure}[]{\figuretext}
% \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}}
% As a result you would get captions like this:
% \begin{Example}
%   \captionsetup{format=llap,singlelinecheck=no,labelsep=quad}
%   \captionsetup{aboveskip=0pt}
%   \captionof{figure}[]{\figuretext}
% \end{Example}
% 
% 
% \pagebreak[3]
% \section{Using non-standard document classes}
% 
% \NEWdescription{v3.0d}
% The \thispackage\ package was developed using the standard document classes
% |article|, |report| and |book|.
% 
% If you would like to use the \thispackage\ package with the
% \KOMAScript\ classes or with the \package{memoir} class, you have to take
% into consideration that all the possibilities for customization of the
% captions the \KOMAScript\ classes or \package{memoir} class have
% to offer will get lost. (And they have a lot of possibilites to offer!)
% So class options like |tablecaptionabove| and commands like |\captionabove|,
% |\captionbelow|, |\captionformat|, |\figureformat|, |\tableformat|,
% |\setcapindent|, |\setcaphanging|, |\captionstyle| etc.\ will not work
% anymore. So make a wise decision!
% 
% Using the \thispackage\ package together with document classes not mentioned
% so far is not recommended at the moment -- unwanted layout changes,
% side effects or failures could occur. (But future versions of the
% \thispackage\ package will contain adaptions for more document classes!
% 
% 
% \section{Using other packages}
% \label{packages}
% 
% The \thispackage\ package contains special adaptions to other packages who
% handle with captions, too, so the captions always should look like you
% have specified them to look like.
%
% These are the packages the \thispackage\ package is adapted to:
% 
% \begin{tabular}{ll}
%   |float|        & Gives you the possibility to define new floating environments\\
%   |hypcap|       & Adjusting \package{hyperref} anchors of captions\\
%   |listings|     & Typesets source code listings\\
%   |longtable|    & Typesets tables spanned over multiple pages\\
%   |rotating|     & Supports rotated figures and tables\\
%   |sidecap|      & Offers captions \emph{beside} figures or tables\\
%   |supertabular| & Typesets tables spanned over multiple pages\\
% \end{tabular}
% 
% \NEWfeature{v3.0b}
% If you use one of the above packages together with the {\thispackage} package
% you get the additional possibility to set up captions with
% \begin{quote}|\captionsetup|\oarg{environment}\marg{options}\quad.\end{quote}
% These options will apply for captions inside these environments automatically.
% For example
% \begin{quote}|\captionsetup[lstlisting]{labelfont=bf}|\end{quote}
% forces captions inside the |lstlisting| environment to have bold labels.
% (Please note that this do not work with the |sideways| environments offered by
% the \package{rotating} package.)
% 
% If a certain support is not desired you can switch it off using the
% \thispackage\ package option
% \begin{quote}
%   |\usepackage[|\ldots|,|\meta{package}|=no]{caption}|\quad.
% \end{quote}
% For example specifying the option |float=no| means you don't like the
% \thispackage\ package to support the \package{float} package.
% (Note: You can specify these options only within the |\usepackage| command,
%  especially \emph{not} at a later time with |\captionsetup|.)
% 
% For further information about the supported packages please take a look
% at the documentation belonging to it or buy yourself
% The \LaTeX\ Companion\cite{companion}.
% 
% 
% \subsection{The \package{float} package}
% 
% A very useful feature is provided by the \package{float} package\cite{float}:
% It offers the float placement specifier |H| which is much more restrictive
% than the specifier |h| offered by \LaTeX. While the latter one is only a
% recommendation to \LaTeX\ to set the float ``here'', the |H| forces the
% float to appear exactly at the spot where it occurs in your input file
% and nowhere else.
%
% Furthermore it offers different styles for floating environments, these
% styles are |plain|, |plaintop|, |ruled|, and |boxed|.
% You can link one of these styles to either new floating environments or
% to one of the existing environments |figure| and |table|.
% 
% If you are using the \thispackage\ package together with the \package{float}
% package this caption style called |ruled| gets defined automatically:
% \begin{quote}
%   |\DeclareCaptionStyle{ruled}{labelfont=bf,labelsep=space}|
% \end{quote}
% This style represents the caption layout in |ruled| styled floats.
% For you as an end user this means that captions within |ruled| floats will
% always look like this, nevertheless what generic caption options do you
% specify:
% 
% \ifx\floatstyle\undefined
% 
% \begin{Example}
% \hrule height.8pt depth0pt \kern2pt
% \vbox{\strut{\bfseries Program 7.1}
%    The first program. This hasn't got anything to do with the package
%    but is included as an example. Note the \texttt{ruled} float style.}
% \kern2pt\hrule\kern2pt
% \begin{verbatim}
% #include <stdio.h>
% 
% int main(int argc, char **argv)
% {
%        for (int i = 0; i < argc; ++i)
%                printf("argv[%d] = %s\n", i, argv[i]);
%        return 0;
% }
% \end{verbatim}
% \kern2pt\hrule\relax
% \end{Example}
% 
% \else
% 
% \floatstyle{ruled}
% \newfloat{Program}{tbp}{lop}[section]
% \floatname{Program}{Program}
% 
% \begin{Program}[H]
% \begin{verbatim}
% #include <stdio.h>
% 
% int main(int argc, char **argv)
% {
%        for (int i = 0; i < argc; ++i)
%                printf("argv[%d] = %s\n", i, argv[i]);
%        return 0;
% }
% \end{verbatim}
% \caption{The first program. This hasn't got anything to do with the package
%    but is included as an example. Note the \texttt{ruled} float style.}
% \end{Program}
% 
% \fi
% 
% If you want a different layout for |ruled| captions you have to define
% your own one using the command
% \begin{quote}
%   |\DeclareCaptionStyle{ruled}|\marg{options}\quad.
% \end{quote}
% 
% This mechanism also works with all other float styles. If you want a special
% caption layout for |plain| or |boxed| floats for example you can simply define
% a suitable caption style with the same name as the float style.
% 
% \textbf{Note:} For successful cooperation you need the float package
% version 1.3 or newer.
%
% 
% \subsection{The \package{listings} package}
% 
% \NEWdescription{v3.0b}
% The \package{listings} package\cite{listings} is a source code printer for \LaTeX.
% You can typeset stand alone files as well as listings with an environment
% similar to \texttt{verbatim} as well as you can print code snippets using
% a command similar to |\verb|.
% Many parameters control the output and if your preferred programming
% language isn't already supported, you can make your own definition.
%
% \textbf{Note:} For successful cooperation you need the listings package
% version 1.2 or higher. You'll get an error message when using an
% older version!
%
% 
% \subsection{The \package{longtable} package}
% 
% The \package{longtable} package\cite{longtable} offers the environment
% |longtable| which behaves similar to the |tabular| environment, but
% the table itself can span multiple pages.
%
% \textbf{Note:} For successful cooperation you need the longtable package
% version 3.15 or newer.
% 
% 
% \subsection{The \package{rotating} package}
% 
% The \package{rotating} package\cite{rotating} offers the floating
% environments \texttt{sideways\-figure} and \texttt{sideways\-table}
% which are just like normal figures and tables but rotated by 90 degree.
% Furthermore they always use a full page on their own.
% 
% 
% \subsection{The \package{sidecap} package}
% 
% \NEWdescription{v3.0b}
% The \package{sidecap} package\cite{sidecap} offers the floating
% environments |SCfigure| and |SCtable| which are like normal figures
% and tables but the caption will be put \emph{beside} the contents.
% 
% The \package{sidecap} package offers it's own options for justification.
% If set, they will override the one specified with the caption option
% |justification=| for captions beside their contents.
%
% \DescribeMacro{listof=}
% Using the \package{sidecap} package you will probably notice that
% suppressing the entry in the list of figures or tables with
% |\caption[]{|\ldots|}| won't work inside these environments.
% This is caused by the implementation design of the \package{sidecap}
% package, but you can use |\captionsetup{listof=false}| inside the
% figure or table as an alternative here.
% 
% \ifx\SCfigure\undefined
% 
% \begin{Example}
%   \newsavebox\scbox
%   \begin{lrbox}{\scbox}
%     \setlength{\unitlength}{.75cm}
%     \setlength{\fboxsep}{0pt}
%     \fbox{\begin{picture}(4,4)
%       \put(1,3){\circle{1}}
%       \put(3,3){\circle{1}}
%       \put(2,2){\circle{1}}
%       \put(1,1){\circle{1}}
%       \put(3,1){\circle{1}}
%     \end{picture}}
%   \end{lrbox}
%   \newlength\scboxwidth
%   \setlength\scboxwidth{\wd\scbox}
%   \makebox[\linewidth][c]{
%     \parbox[b]{\scboxwidth}{\unhbox\scbox}
%     \hspace\marginparsep
%     \parbox[b]{1.5\scboxwidth}{
%       \captionsetup{justification=RaggedRight,labelfont=bf}
%       \captionof{figure}[]{A small example with the caption beside the figure.}
%     }
%   }
% \end{Example}
% 
% \else
% 
% \captionsetup{labelfont=bf}
% \begin{SCfigure}[1.5][!ht]
%   \setlength{\unitlength}{.75cm}
%   \setlength{\fboxsep}{0pt}
%   \fbox{\begin{picture}(4,4)
%     \put(1,3){\circle{1}}
%     \put(3,3){\circle{1}}
%     \put(2,2){\circle{1}}
%     \put(1,1){\circle{1}}
%     \put(3,1){\circle{1}}
%   \end{picture}}
% \iffalse
% \captionsetup{labelfont=bf}
% \fi
%   \caption[]{A small example with the caption beside the figure.}
% \end{SCfigure}
% \captionsetup{labelfont=default}
% 
% \fi
% 
% 
% \subsection{The \package{supertabular} package}
% 
% The \package{supertabular} package\cite{supertabular} offers the environment
% |supertabular| which is quite similar to the |longtable| environment provided
% by the \package{longtable} package. Both offers the typesetting of tables
% which can span multiple pages. For a detailed discussion about the
% differences between these powerful packages please take a look at
% The \LaTeX\ Companion\cite{companion}.
% 
% 
% \subsection{Known incompatibilities}
% 
% \NEWdescription{v3.0b}
% Using the \thispackage\ package together with one of the following packages
% is not recommended; usually this would cause unwanted side effects or even
% errors:
% \begin{quote}
% \package{ccaption}, \package{hvfloat}, \package{nonfloat}
% \end{quote}
%
% 
% \section{Compatibility to older versions}
% 
% \subsection{\thispackage\ version $1.x$}
% 
% This version of the \thispackage\ package still supports the old options
% and commands provided by the version $1.x$ of this package. So there
% shouldn't occur any problems compiling old documents, but please don't mix
% old options and commands with the new ones. This isn't supported and can
% yield to ugly side effects.
% 
% Here comes a short oversight of the old options and commands and how they
% are replaced within this version of the \thispackage\ package:
% 
% \begin{small}\begin{longtable}{ll}
% \thispackage\ $1.\mathit{x}$ & \thispackage\ $3.\mathit{x}$\\
% \hline
% \endhead
% |normal|                           & |format=default|\\
% |hang|                             & |format=hang|\\
% |isu|                              & |format=hang|\\
% |center|                           & |justification=centering|\\
% |centerlast|                       & |justification=centerlast|\\
% |anne|                             & |justification=centerlast|\\
% |nooneline|                        & |singlelinecheck=off|\\
% |scriptsize|                       & |font=scriptsize|\\
% |footnotesize|                     & |font=footnotesize|\\
% |small|                            & |font=small|\\
% |normalsize|                       & |font=normalsize|\\
% |large|                            & |font=large|\\
% |Large|                            & |font=Large|\\
% |up|                               & |labelfont=up|\\
% |it|                               & |labelfont=it|\\
% |sl|                               & |labelfont=sl|\\
% |sc|                               & |labelfont=sc|\\
% |md|                               & |labelfont=md|\\
% |bf|                               & |labelfont=bf|\\
% |rm|                               & |labelfont=rm|\\
% |sf|                               & |labelfont=sf|\\
% |tt|                               & |labelfont=tt|\\
% |\setlength{\captionmargin}|       & |margin=|\meta{amount}\\
% |\renewcommand{\captionfont}|      & |\DeclareCaptionFont|\\
%                                    & $+$ |\captionsetup{font=|\meta{name}|}|\\
% |\renewcommand{\captionsize}|      & |\DeclareCaptionFont|\\
%                                    & $+$ |\captionsetup{font=|\meta{name}|}|\\
% |\renewcommand{\captionlabelfont}| & |\DeclareCaptionLabelFont|\\
%                                    & $+$ |\captionsetup{labelfont=|\meta{name}|}|\\
% \end{longtable}\end{small}
% 
% 
% \subsection{\package{caption2} version $2.x$}
% 
% Although they do very similar stuff the packages \package{caption} and
% \package{caption2} have a very different implementation design. So this
% version of the \thispackage\ package isn't compatible to the
% \package{caption2} package at all. Of course for compiling old documents
% you can still use the \package{caption2} package, the latest version
% is provided with this package. But newly created documents shouldn't use
% the \package{caption2} package, please use the \thispackage\ package
% instead as described in this manual.
% 
% \iffalse
% TODO: Table like the "caption 1.x => caption 3.x" one
% \fi
% 
% 
% \pagebreak[3]
% \section{Further reading}
% 
% I recommend the following documents for further reading:
% 
% \begin{itemize}
% \item
%   The \TeX\ FAQ - Frequently asked questions about \TeX\ and \LaTeX :
%   \begin{quote}\url{http://faq.tug.org/}\end{quote}
%
% \item
%   A French FAQ can be found at
%   \begin{quote}\url{http://www.grappa.univ-lille3.fr/FAQ-LaTeX/}\end{quote}
% 
% \item
%   \textsf{epslatex} from Keith Reckdahl contains many tips around
%   graphics in \LaTeXe. You will find this document in the directory
%   \begin{quote}\url{ftp://ftp.ctan.org/pub/tex/info/}\end{quote}
%   as \texttt{epslatex.ps} and \texttt{epslatex.pdf}.
%
%   There is also a french translation available:
%   \begin{quote}\url{ftp://ftp.ctan.org/pub/tex/info/fepslatex.ps}\end{quote}
% \end{itemize}
% 
% 
% \section{Thanks}
% 
% I would like to thank Katja Melzner, Steven D. Cochran, Frank Mittelbach,
% David Carlisle, Carsten Hinz, and Olga Lapko.
% Thanks a lot for all your help, ideas, patience, spirit, and support!
% 
% Also I would like to thank
% Harald Harders,
% Peter L\"offler,
% Peng Yu,
% Alexander Zimmermann,
% Matthias Pospiech,
% J\"urgen Wieferink,
% Christoph Bartoschek,
% Uwe St\"ohr, and
% Ralf Stubner
% who all helped to make this package a better one.
%
%
% \changes{v1.0}{27 Oct 94}{First release}
% \changes{v1.1}{ 3 Nov 94}{New captiontype \cs{centerlast}}
% \changes{v1.2}{28 Nov 94}{Support of the {\sf float} package}
% \changes{v1.3}{ 8 Jan 95}{Support of \cs{captionlabelfont} in subcaptions}
% \changes{v1.4}{30 Jan 95}{New option \cs{nooneline}}
% \changes{v3.0}{10 Jul 03}{Rewritten; many new commands and features}
% \changes{v3.0a}{22 Jan 04}{Some bugfixes and small design changes}
% \changes{v3.0b}{14 May 04}{Some bugfixes and small improvements}
% \changes{v3.0c}{15 Jul 04}{Bugfix regarding rotating and sidecap package support}
% \changes{v3.0d}{12 Feb 05}{Split into 2 packages; some bugfixes and improvements}
% \changes{v3.0e}{ 5 May 05}{Some bugfixes}
% \changes{v3.0f}{11 May 05}{hypcap support; bugfix regarding float support}
%
% \StopEventually{\begin{thebibliography}{9}
%   \bibitem{companion}
%   Frank Mittelbach and Michel Goossens:
%   \newblock {\em The {\LaTeX} Companion (2nd.~Ed.)},
%   \newblock Addison-Wesley, 2004.
% 
%   \bibitem{float}
%   Anselm Lingnau:
%   \emph{An Improved Environment for Floats},
%   2001/11/08
% 
%   \bibitem{floatrow}
%   Olga Lapko:
%   \emph{The floatrow package documentation},
%   2005/05/22
%
%   \bibitem{hyperref}
%   Sebastian Rahtz:
%   \emph{Hypertext marks in \LaTeX},
%   2003/11/30
%
%   \bibitem{hypcap}
%   Heiko Oberdiek:
%   \emph{The hypcap package -- Adjusting anchors of captions}
%   2001/08/27
%
%   \bibitem{listings}
%   Carsten Heinz:
%   \emph{The Listings Package},
%   2004/02/13
% 
%   \bibitem{longtable}
%   David Carlisle:
%   \emph{The longtable package},
%   2000/10/22
% 
%   \bibitem{rotating}
%   Sebastian Rahtz and Leonor Barroca:
%   \emph{A style option for rotated objects in \LaTeX},
%   1997/09/26
% 
%   \bibitem{sidecap}
%   Rolf Niepraschk und Hubert G\"a\ss lein:
%   \emph{The sidecap package},
%   2003/06/06
% 
%   \bibitem{subfig}
%   Steven D. Cochran:
%   \emph{The subfig package},
%   2004/01/16
% 
%   \bibitem{supertabular}
%   Johannes Braams und Theo Jurriens:
%   \emph{The supertabular environment},
%   2002/07/19
% \end{thebibliography}}
%
% \DoNotIndex{\\,\_,\ ,\@@par}
% \DoNotIndex{\@classoptionslist,\@currext,\@currname}
% \DoNotIndex{\@ehc,\@ehd,\@empty,\@expandtwoargs}
% \DoNotIndex{\@for,\@firstofone,\@firstoftwo}
% \DoNotIndex{\@gobble,\@gobblefour,\@gobbletwo,\@hangfrom}
% \DoNotIndex{\@ifnextchar,\@ifstar,\@ifundefined,\@latex@error}
% \DoNotIndex{\@namedef,\@nameuse}
% \DoNotIndex{\@onlypreamble,\@parboxrestore,\@plus,\@ptionlist}
% \DoNotIndex{\@removeelement,\@restorepar,\@secondoftwo,\@setpar}
% \DoNotIndex{\@tempa,\@tempboxa,\@tempdima,\@tempdimb,\@tempdimc,\@tempb,\@tempc}
% \DoNotIndex{\@undefined,\@unprocessedoptions,\@unusedoptionlist}
% \DoNotIndex{\p@,\z@}
% \DoNotIndex{\active,\addtocounter,\addtolength,\advance}
% \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{\normalsize,\or,\par,\parbox,\parfillskip}
% \DoNotIndex{\parindent,\parskip,\prevdepth,\protect,\protected@edef,\providecommand}
% \DoNotIndex{\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{\ProcessOptions,\ProvidesPackage}
%
% \clearpage
% \setlength{\parskip}{0pt plus 1pt}
%
% \section{The Implementation}
%
% The \package{caption} package consists of two parts -- the kernel and the
% main package.
%
% The kernel provides all the user commands and internal macros which are
% necessary for typesetting captions and setting parameters regarding these.
% While the standard \LaTeX\ document classes provides an internal command
% called |\@makecaption| and no options to control its behavior (except the
% vertical skips above and below them), we provide similar commands called
% |\caption@make| and |\caption@@make|, but with a lot of options.
% Loading the kernel part do not change the output of a \LaTeX\ document
% -- it just provides functionality which can be used by \LaTeXe\ packages
% which typesets captions, like the \package{caption} package or the
% \package{subfig} package.
%
% The \package{caption} package itself redefines the \LaTeX\ commands
% |\caption|, |\@caption|, and |\@makecaption| and maps the latter one to
% |\caption@@make|, giving the user the possibility to control the captions of
% the floating environments |figure| and |table|. Furthermore it does similar
% to the caption stuff coming from other packages like the \package{longtable}
% package: Mapping the appropriate internal commands (like |\LT@makecaption|)
% to the ones offered by the \package{caption} kernel.
% So you can think of the \package{caption} package as a layer package, it
% simply provides adaption layers between the caption stuff coming from
% \LaTeX\ itself or any \LaTeXe\ package and the caption stuff offered by the
% \package{caption} kernel.
%
% \subsection{Kernel}
% \iffalse
%<*kernel>
% \fi
%
% \subsubsection*{Identification}
%
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesPackage{caption3}[2005/06/11 v3.0f caption3 kernel (AS)]
%    \end{macrocode}
%
% \subsubsection*{Generic helpers}
%
% \begin{macro}{\@nameundef}
% This is the opposite part to |\@namedef| which is offered by the \LaTeX\ kernel.
% We use it to remove the definition of some commands and keyval options after
% |\begin{document}| (to save \TeX\ memory) or to remove caption options defined
% with |\captionsetup|\oarg{type}.
%    \begin{macrocode}
\providecommand*\@nameundef[1]{%
  \expandafter\let\csname #1\endcsname\@undefined}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\l@addto@macro}
% The \LaTeXe\ kernel offers the internal helper macro |\g@addto@macro| which
% globally adds commands to any existising macro, like in |\AtBeginDocument|.
% This is the same but it works local, not global.
%    \begin{macrocode}
\providecommand\l@addto@macro[2]{%
  \begingroup
    \toks@\expandafter{#1#2}%
    \edef\@tempa{\endgroup\def\noexpand#1{\the\toks@}}%
  \@tempa}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\bothIfFirst}
% \begin{macro}{\bothIfSecond}
% |\bothIfFirst| tests if the first argument is not empty, |\bothIfSecond|
% tests if the second argument is not empty. If yes both arguments get
% typeset, otherwise none of them.
%    \begin{macrocode}
\def\bothIfFirst#1#2{%
  \protected@edef\caption@tempa{#1}%
  \ifx\caption@tempa\@empty\else
    #1#2%
  \fi}
\def\bothIfSecond#1#2{%
  \protected@edef\caption@tempa{#2}%
  \ifx\caption@tempa\@empty\else
    #1#2%
  \fi}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \begin{macro}{\caption@ifinlist}
% This helper macro checks if the first argument is in the list which is
% offered as second argument. So for example
% \begin{quote}
%   |\caption@ifinlist{frank}{axel,frank,steven}{yes}{no}|
% \end{quote}
% would expand to |yes|.
%    \begin{macrocode}
\def\caption@ifinlist#1#2{%
  \let\next\@secondoftwo
  \edef\caption@tempa{#1}%
  \@for\caption@tempb:={#2}\do{%
    \ifx\caption@tempa\caption@tempb
      \let\next\@firstoftwo
    \fi}%
  \next}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@setbool}
% \begin{macro}{\caption@ifbool}
% For setting and testing boolean options we offer these two helper macros:
% \begin{quote}
% |\caption@setbool|\marg{name}\marg{value}\\
% |                |(with |value = false/true/no/yes/off/on/0/1|)\\
% |\caption@ifbool|\marg{name}\marg{if-clause}\marg{else-clause}\\
% \end{quote}
%    \begin{macrocode}
\def\caption@setbool#1#2{%
  \caption@ifinlist{#2}{1,true,yes,on}{%
    \expandafter\let\csname caption@if#1\endcsname\@firstoftwo
  }{\caption@ifinlist{#2}{0,false,no,off}{%
    \expandafter\let\csname caption@if#1\endcsname\@secondoftwo
  }{%
    \PackageError{caption}{Undefined boolean value `#2'}{\caption@eh}%
  }}}
\def\caption@ifbool#1{\@nameuse{caption@if#1}}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsubsection*{Using the keyval package}
%
% We need the \package{keyval} package for option handling, so we load it here.
%    \begin{macrocode}
\RequirePackage{keyval}[1997/11/10]
%    \end{macrocode}
%
% \begin{macro}{\undefine@key}
% This helper macro is the opposite of |\define@key|, it removes a keyval
% definition.
%    \begin{macrocode}
\providecommand*\undefine@key[2]{%
  \@nameundef{KV@#1@#2}\@nameundef{KV@#1@#2@default}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\DeclareCaptionOption}
% |\DeclareCaptionOption|\marg{option}\marg{code}\\
% |\DeclareCaptionOption*|\marg{option}\marg{code}\par
% The starred form makes the option only available during the lifetime
% of the current package, so they are only avail at |\usepackage|, but
% can't be used with |\captionsetup| later on.
%    \begin{macrocode}
\newcommand\DeclareCaptionOption{%
  \@ifstar{\caption@declareoption\AtEndOfPackage}%
          {\caption@declareoption\@gobble}}
\newcommand*\caption@declareoption[2]{%
  #1{\undefine@key{caption}{#2}}\define@key{caption}{#2}}
\@onlypreamble\DeclareCaptionOption
\@onlypreamble\caption@declareoption
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\captionsetup}
% |\captionsetup|\oarg{type}\marg{keyval-list of options}\par
% If `type' is set, we simply save or append the option list,
% otherwise we `execute' it with |\setkeys|.
% \changes{v3.0a}{17 Jan 04}{Missing percent added}
%    \begin{macrocode}
\def\captionsetup{\@ifnextchar[\caption@setuptype\caption@setup}
\def\caption@setuptype[#1]#2{%
  \@ifundefined{caption@typ@#1}%
    {\@namedef{caption@typ@#1}{#2}}%
    {\expandafter\l@addto@macro\csname caption@typ@#1\endcsname{,#2}}}
\def\caption@setup{\setkeys{caption}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@settype}
% |\caption@settype|\marg{type}\par
% Caption options which have been saved with |\captionsetup|\oarg{type} can
% be executed using this macro. (It simply executes the saved option list,
% if there is any.)
%    \begin{macrocode}
\def\caption@settype#1{%
  \@ifundefined{caption@typ@#1}{}{%
    \caption@esetup{\csname caption@typ@#1\endcsname}}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@esetup}
% To execute a keyval-list of options saved within a macro we
% need this special version of |\caption@setup| which expands the
% argument first.
%    \begin{macrocode}
\def\caption@esetup#1{%
  \edef\caption@tempa{\noexpand\caption@setup{#1}}%
  \caption@tempa}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\clearcaptionsetup}
% |\clearcaptionsetup|\marg{type}\par
% This removes the saved option list associated with \meta{type}.
%    \begin{macrocode}
\newcommand*\clearcaptionsetup[1]{\@nameundef{caption@typ@#1}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\showcaptionsetup}
% |\showcaptionsetup|\oarg{package}\marg{type}\par
% This command is 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: KV list on `#2'\MessageBreak
    #1 Caption Data: (%
    \@ifundefined{caption@typ@#2}{%
      % Empty -- print nothing.
    }{%
      \@nameuse{caption@typ@#2}%
    }%
    )}}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Errors}
%
% \begin{macro}{\caption@eh}
% We only provide this simple error message as helper for the user.
%    \begin{macrocode}
\newcommand\caption@eh{%
  If you do not understand this error, please take a closer look\MessageBreak
  at the documentation of the `caption' package.\MessageBreak
  \@ehc}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Margin resp. width}
%
% \begin{macro}{\captionmargin}
% \begin{macro}{\captionwidth}
% \begin{macro}{\ifcaption@width}
% |\captionmargin| and |\captionwidth| contains the extra margin
% resp. the total width used for captions. Never set these values in a
% direct way, they are just accessible in user documents to provide
% compatibility to |caption.sty| v$1.x$.
%    \begin{macrocode}
\newdimen\captionmargin
\newdimen\captionwidth
\newif\ifcaption@width
%    \end{macrocode}
% \end{macro}
% \end{macro}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{margin}{\caption@setmargin{#1}}
\DeclareCaptionOption{width}{\caption@setwidth{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setmargin}
% \begin{macro}{\caption@setwidth}
% Note that we can only set one at a time, `margin' \emph{or} `width'.
% Which dimension is actually set will be recognized by |\ifcaption@width|.
%    \begin{macrocode}
\newcommand\caption@setmargin{%
  \caption@widthfalse
  \setlength\captionmargin}
\newcommand\caption@setwidth{%
  \caption@widthtrue
  \setlength\captionwidth}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsubsection*{Indentions}
% \begin{macro}{\captionindent}
% \begin{macro}{\captionparindent}
% \begin{macro}{\captionhangindent}
% These are the indentions we support.
%    \begin{macrocode}
\newdimen\captionindent
\newdimen\captionparindent
\newdimen\captionhangindent
%    \end{macrocode}
% \end{macro}
% \end{macro}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{indent}[\leftmargini]{\setlength\captionindent{#1}}% obsolete!
\DeclareCaptionOption{indention}[\leftmargini]{\setlength\captionindent{#1}}
\DeclareCaptionOption{parindent}[\parindent]{\setlength\captionparindent{#1}}% changed v3.0b
\DeclareCaptionOption{hangindent}[0pt]{\setlength\captionhangindent{#1}}% changed v3.0b
%    \end{macrocode}
%
% \subsubsection*{Styles}
%
% \begin{macro}{\DeclareCaptionStyle}
% |\DeclareCaptionStyle|\marg{name}\oarg{single-line-list-of-KV}\marg{list-of-KV}
% \changes{v3.0a}{17 Jan 04}{We pass through argument no.3 so extra spaces between the arguments do make any harm}
%    \begin{macrocode}
\newcommand*\DeclareCaptionStyle[1]{%
  \@ifnextchar[{\caption@declarestyle{#1}}{\caption@declarestyle{#1}[]}}
\def\caption@declarestyle#1[#2]#3{%
  \global\@namedef{caption@sls@#1}{#2}%
  \global\@namedef{caption@sty@#1}{#3}}
\@onlypreamble\DeclareCaptionStyle
\@onlypreamble\caption@declarestyle
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{style}{\caption@setstyle{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setstyle}
% |\caption@setstyle|\marg{name}\\
% |\caption@setstyle*|\marg{name}\par
% Selecting a caption style means saving the additional
% \meta{single-line-list-of-KV} (this will be done by |\caption@sls|),
% resetting the caption options to the default ones (this will be done using
% |\caption@setdefault|) and executing the \meta{list-of-KV} options
% (this will be done using |\caption@esetup|).\par
% The starred version will give no error message if the given style is not
% defined.
%    \begin{macrocode}
\newcommand\caption@setstyle{%
  \@ifstar{\caption@@setstyle\@gobble}{\caption@@setstyle\@firstofone}}
\newcommand*\caption@@setstyle[2]{%
  \@ifundefined{caption@sty@#2}%
    {#1{\PackageError{caption}{Undefined caption style `#2'}{\caption@eh}}}%
	{\expandafter\let\expandafter\caption@sls\csname caption@sls@#2\endcsname
     \caption@setdefault\caption@esetup{\csname caption@sty@#2\endcsname}}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@setdefault}
% This resets (nearly) all caption options to the default ones.
% (Note that this does not touch the skips and the positioning!)
%    \begin{macrocode}
\newcommand\caption@setdefault{\captionsetup{%
  format=default,labelformat=default,labelsep=default,justification=default,%
  font=default,labelfont=default,textfont=default,%
  margin=0pt,indention=0pt,parindent=0pt,hangindent=0pt,singlelinecheck}}
%    \end{macrocode}
% \end{macro}
%
% There is only one pre-defined style, called `default'. It's a perfect match
% to the standard \LaTeX\ document classes: If the caption fits in one single
% line, it is typeset centered.
%
%    \begin{macrocode}
\DeclareCaptionStyle{default}[indent=0pt,justification=centering]{}
%    \end{macrocode}
%
% \subsubsection*{Formats}
%
% \begin{macro}{\DeclareCaptionFormat}
% |\DeclareCaptionFormat|\marg{name}\marg{code with \#1, \#2, and \#3}\\
% |\DeclareCaptionFormat*|\marg{name}\marg{code with \#1, \#2, and \#3}\par
% The starred form causes the code being typeset in vertical (instead of
% horizontal) mode, but does not support the |indention=| option.
% \changes{v3.0a}{17 Jan 04}{We pass through argument no.3 so extra spaces between the arguments do make any harm}
% \changes{v3.0d}{9 Feb 05}{Starred form added}
%    \begin{macrocode}
\def\DeclareCaptionFormat{%
  \@ifstar{\caption@declareformat\@gobble}{\caption@declareformat\@firstofone}}
\newcommand\caption@declareformat[3]{%
  \global\expandafter\let\csname caption@ifh@#2\endcsname#1%
  \global\long\expandafter\def\csname caption@fmt@#2\endcsname##1##2##3{#3}}
\@onlypreamble\DeclareCaptionFormat
\@onlypreamble\caption@declareformat
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{format}{\caption@setformat{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setformat}
% |\caption@setformat|\marg{name}\par
% Selecting a caption format simply means saving the code (in |\caption@fmt|)
% and if the code should be used in horizontal or vertical mode (|\caption@ifh|).
%    \begin{macrocode}
\newcommand*\caption@setformat[1]{%
  \@ifundefined{caption@fmt@#1}%
    {\PackageError{caption}{Undefined caption format `#1'}{\caption@eh}}%
    {\expandafter\let\expandafter\caption@ifh\csname caption@ifh@#1\endcsname
     \expandafter\let\expandafter\caption@fmt\csname caption@fmt@#1\endcsname}}
%    \end{macrocode}
% \end{macro}
%
% There are two pre-defined formats, called `@normal' and `hang'.
% \iffalse
% (Note that `normal' is not documented and this name can be a subject of change
% in future versions of this package!)
% \fi
%
%    \begin{macrocode}
\DeclareCaptionFormat{@normal}{#1#2#3\par}
\DeclareCaptionFormat{hang}{%
  \@hangfrom{#1#2}%
  \advance\captionparindent\hangindent
  \advance\captionhangindent\hangindent
  \caption@@par
  #3\par}
%    \end{macrocode}
%
% `default' usually maps to `@normal'.
%
%    \begin{macrocode}
\def\caption@fmt@default{\caption@fmt@@normal}
\def\caption@ifh@default{\caption@ifh@@normal}% bugfix v3.0e (05-04-28)
%    \end{macrocode}
%
% \subsubsection*{Label formats}
%
% \begin{macro}{\DeclareCaptionLabelFormat}
% |\DeclareCaptionLabelFormat|\marg{name}\marg{code with \#1 and \#2}
% \changes{v3.0a}{17 Jan 04}{We pass through argument no.2 so extra spaces between the arguments do make any harm}
%    \begin{macrocode}
\newcommand*\DeclareCaptionLabelFormat[2]{%
  \global\expandafter\def\csname caption@lfmt@#1\endcsname##1##2{#2}}
\@onlypreamble\DeclareCaptionLabelFormat
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{labelformat}{\caption@setlabelformat{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setlabelformat}
% |\caption@setlabelformat|\marg{name}\par
% Selecting a caption label format simply means saving the code (in |\caption@lfmt|).
%    \begin{macrocode}
\newcommand*\caption@setlabelformat[1]{%
  \@ifundefined{caption@lfmt@#1}%
    {\PackageError{caption}{Undefined caption label format `#1'}{\caption@eh}}%
    {\expandafter\let\expandafter\caption@lfmt\csname caption@lfmt@#1\endcsname}}
%    \end{macrocode}
% \end{macro}
%
% There are three pre-defined label formats, called `empty', `simple', and `parens'.
%
%    \begin{macrocode}
\DeclareCaptionLabelFormat{empty}{}
\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{\nobreakspace}#2}
\DeclareCaptionLabelFormat{parens}{\bothIfFirst{#1}{\nobreakspace}(#2)}
%    \end{macrocode}
%
% `default' usually maps to `simple'.
%
%    \begin{macrocode}
\def\caption@lfmt@default{\caption@lfmt@simple}
%    \end{macrocode}
%
% \subsubsection*{Label separators}
%
% \begin{macro}{\DeclareCaptionLabelSeparator}
% |\DeclareCaptionLabelSeparator|\marg{name}\marg{code}
% \changes{v3.0a}{17 Jan 04}{We pass through argument no.2 so extra spaces between the arguments do make any harm}
%    \begin{macrocode}
\newcommand\DeclareCaptionLabelSeparator[2]{%
  \global\long\@namedef{caption@lsep@#1}{#2}}
\@onlypreamble\DeclareCaptionLabelSeparator
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{labelsep}{\caption@setlabelseparator{#1}}
\DeclareCaptionOption{labelseparator}{\caption@setlabelseparator{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setlabelseparator}
% |\caption@setlabelseparator|\marg{name}\par
% Selecting a caption label separator simply means saving the code (in |\caption@lsep|).
%    \begin{macrocode}
\newcommand*\caption@setlabelseparator[1]{%
  \@ifundefined{caption@lsep@#1}%
    {\PackageError{caption}{Undefined caption label separator `#1'}{\caption@eh}}%
    {\expandafter\let\expandafter\caption@lsep\csname caption@lsep@#1\endcsname}}
%    \end{macrocode}
% \end{macro}
%
% There are six pre-defined label separators, called `none', `colon', `period', `space', `quad', and `newline'.
%
%    \begin{macrocode}
\DeclareCaptionLabelSeparator{none}{}
\DeclareCaptionLabelSeparator{colon}{: }
\DeclareCaptionLabelSeparator{period}{. }
\DeclareCaptionLabelSeparator{space}{ }
\DeclareCaptionLabelSeparator{quad}{\quad}
\DeclareCaptionLabelSeparator{newline}{\\}% 05-03-23 (v3.0f)
%    \end{macrocode}
%
% `default' usually maps to `colon'.
%
%    \begin{macrocode}
\def\caption@lsep@default{\caption@lsep@colon}
%    \end{macrocode}
%
% \subsubsection*{Justifications}
%
% \begin{macro}{\DeclareCaptionJustification}
% |\DeclareCaptionJustification|\marg{name}\marg{code}
% \changes{v3.0a}{17 Jan 04}{We pass through argument no.2 so extra spaces between the arguments do make any harm}
%    \begin{macrocode}
\newcommand*\DeclareCaptionJustification[2]{%
  \global\@namedef{caption@hj@#1}{#2}}
%\newcommand\DeclareCaptionJustification{\DeclareCaptionFont}
\@onlypreamble\DeclareCaptionJustification
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{justification}{\caption@setjustification{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setjustification}
% |\caption@setjustification|\marg{name}\par
% Selecting a caption justification simply means saving the code (in |\caption@hj|).
%    \begin{macrocode}
\newcommand*\caption@setjustification[1]{%
  \@ifundefined{caption@hj@#1}%
    {\PackageError{caption}{Undefined caption justification `#1'}{\caption@eh}}%
    {\expandafter\let\expandafter\caption@hj\csname caption@hj@#1\endcsname}}
%\newcommand\caption@setjustification{\caption@setfont{@hj}}
%    \end{macrocode}
% \end{macro}
%
% These are the pre-defined justification code snippets.
%
%    \begin{macrocode}
\DeclareCaptionJustification{justified}{}
\DeclareCaptionJustification{centering}{\centering}
\DeclareCaptionJustification{centerfirst}{\caption@centerfirst}
\DeclareCaptionJustification{centerlast}{\caption@centerlast}
\DeclareCaptionJustification{raggedleft}{\raggedleft}
\DeclareCaptionJustification{raggedright}{\raggedright}
%    \end{macrocode}
%
% `default' usually maps to `justified'.
%
%    \begin{macrocode}
\def\caption@hj@default{\caption@hj@justified}
%    \end{macrocode}
%
% \begin{macro}{\caption@centerfirst}
% \begin{macro}{\caption@centerlast}
% Please blame Frank Mittelbach for |\caption@centerfirst| and
% Anne Br\"uggemann-Klein for |\caption@centerlast| |:-)|
%    \begin{macrocode}
\newcommand\caption@centerfirst{%
  \edef\caption@normaladjust{%
    \leftskip\the\leftskip
    \rightskip\the\rightskip
    \parfillskip\the\parfillskip\relax}%
  \leftskip\z@\@plus -1fil%
  \rightskip\z@\@plus 1fil%
  \parfillskip\z@skip
  \noindent\hskip\z@\@plus 2fil%
  \@setpar{\@@par\@restorepar\caption@normaladjust}}
\newcommand\caption@centerlast{%
  \leftskip\z@\@plus 1fil%
  \rightskip\z@\@plus -1fil%
  \parfillskip\z@\@plus 2fil\relax}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% We also support the upper-case commands offered by the \package{ragged2e}
% package.
% Note that these just map to their lower-case variants if the
% \package{ragged2e} package is not available.
%    \begin{macrocode}
\DeclareCaptionJustification{Centering}{%
  \caption@ragged\Centering\centering}
\DeclareCaptionJustification{RaggedLeft}{%
  \caption@ragged\RaggedLeft\raggedleft}
\DeclareCaptionJustification{RaggedRight}{%
  \caption@ragged\RaggedRight\raggedright}
%    \end{macrocode}
%
% \begin{macro}{\caption@ragged}
% |\caption@ragged| will be basically defined as\par
% |\AtBeginDocument{\IfFileExists{ragged2e.sty}%|\\
% |  {\RequirePackage{ragged2e}\let\caption@ragged\@firstoftwo}%|\\
% |  {\let\caption@ragged\@secondoftwo}}|\par
% but with a warning if the ragged2e package is not avail.
% (This warning will by typeout only ones per option, that's why we need the
% |caption\string#1| stuff.)
%    \begin{macrocode}
\newcommand*\caption@ragged[2]{%
  \@ifundefined{caption\string#1}{%
    \PackageWarning{caption}{%
      Cannot locate the `ragged2e' package, therefore\MessageBreak
      substituting \string#2 for \string#1\MessageBreak}%
    \global\@namedef{caption\string#1}}{}%
  #2}
%    \end{macrocode}
%    \begin{macrocode}
\AtBeginDocument{\IfFileExists{ragged2e.sty}{%
  \RequirePackage{ragged2e}\let\caption@ragged\@firstoftwo}{}}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Fonts}
%
% \begin{macro}{\DeclareCaptionFont}
% |\DeclareCaptionFont|\marg{name}\marg{code}
% \changes{v3.0a}{22 Jan 04}{More-than-one token arguments are allowed now}
%    \begin{macrocode}
\newcommand\DeclareCaptionFont[2]{%
  \define@key{caption@fnt}{#1}[]{\g@addto@macro\caption@tempa{#2}}}
\@onlypreamble\DeclareCaptionFont
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{font}{\caption@setfont{font}{#1}}
\DeclareCaptionOption{labelfont}{\caption@setfont{labelfont}{#1}}
\DeclareCaptionOption{textfont}{\caption@setfont{textfont}{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setfont}
% |\caption@setfont|\marg{command}\marg{keyval-list of names}\par
% Selecting a caption font means saving all the code snippets (in |#1|).
% Because we use |\setkeys| recursive here we need to put this into an extra
% group and collect all the code snippets in |\caption@tempa| first.
%    \begin{macrocode}
\newcommand*\caption@setfont[2]{%
  \let\caption@tempa\@empty
  \begingroup
    \setkeys{caption@fnt}{#2}%
  \endgroup
  \expandafter\let\csname caption#1\endcsname\caption@tempa}
%    \end{macrocode}
% \end{macro}
%
% These are the pre-defined font code snippets.
%
%    \begin{macrocode}
\DeclareCaptionFont{default}{}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionFont{scriptsize}{\scriptsize}
\DeclareCaptionFont{footnotesize}{\footnotesize}
\DeclareCaptionFont{small}{\small}
\DeclareCaptionFont{normalsize}{\normalsize}
\DeclareCaptionFont{large}{\large}
\DeclareCaptionFont{Large}{\Large}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionFont{up}{\upshape}
\DeclareCaptionFont{it}{\itshape}
\DeclareCaptionFont{sl}{\slshape}
\DeclareCaptionFont{sc}{\scshape}
\DeclareCaptionFont{md}{\mdseries}
\DeclareCaptionFont{bf}{\bfseries}
\DeclareCaptionFont{rm}{\rmfamily}
\DeclareCaptionFont{sf}{\sffamily}
\DeclareCaptionFont{tt}{\ttfamily}
%    \end{macrocode}
%
% \begin{macro}{\captionsize}
% The old versions $1.x$ of the \package{caption} package offered this
% command to setup the font size used for captions. We still do
% so old documents will work fine.
% \changes{v3.0c}{16 Jul 04}{Use \cs{providecommand} instead of \cs{newcommand} in respect of the memoir class}
%    \begin{macrocode}
\providecommand\captionsize{}
%    \end{macrocode}
% \end{macro}
%    \begin{macrocode}
\DeclareCaptionOption{size}{\caption@setfont{size}{#1}}% changed v3.0a
%    \end{macrocode}
%
% \subsubsection*{Vertical spaces before and after captions}
%
% \begin{macro}{\abovecaptionskip}
% \begin{macro}{\belowcaptionskip}
% Usually these skips are defined within the document class, but some
% document classes don't do so.
%    \begin{macrocode}
\@ifundefined{abovecaptionskip}{%
  \newlength\abovecaptionskip\setlength\abovecaptionskip{10\p@}}{}
\@ifundefined{belowcaptionskip}{%
  \newlength\belowcaptionskip\setlength\belowcaptionskip{0\p@}}{}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
%    \begin{macrocode}
\DeclareCaptionOption{aboveskip}{\setlength\abovecaptionskip{#1}}
\DeclareCaptionOption{belowskip}{\setlength\belowcaptionskip{#1}}
\DeclareCaptionOption{skip}{\setlength\abovecaptionskip{#1}}% new 3.0d
%    \end{macrocode}
%
% \subsubsection*{Positioning}
%
% These macros handle the right position of the caption.
% Note that the position is actually \emph{not} controlled by the
% \package{caption} kernel options, but by the user (or the package) instead.
% The user can put the |\caption| command where ever he likes! So this stuff
% is only to give us a hint where to put the right skips, the user usually has
% to take care for himself that this hint actually matches the right position.
% The user can also try out the experimental setting |position=auto| which
% means that the \package{caption} package should try to guess the actual
% position of the caption for himself. (But in many cases, for example in
% |longtable|s, this is doomed to fail, so it's not documented in the
% user part of the documentation.)
%
%    \begin{macrocode}
\DeclareCaptionOption{position}{\caption@setposition{#1}}
%    \end{macrocode}
%
% \begin{macro}{\caption@setposition}
% Selecting the caption position means that we put |\caption@position| to
% the right value. Please do \emph{not} use the internal macro
% |\caption@position| in your own package or document, but use the wrapper
% macro |\caption@iftop| instead.
% \changes{v3.0a}{22 Jan 04}{Now `t', `above', `b', `below', and `a' are allowed, too}
% \changes{v3.0d}{10 Aug 04}{\cs{caption@defaultpos} added}
%    \begin{macrocode}
\newcommand*\caption@setposition[1]{%
  \caption@ifinlist{#1}{d,default}{%
    \def\caption@position{\caption@defaultpos}%
  }{\caption@ifinlist{#1}{t,top,above}{%
    \let\caption@position\@firstoftwo
  }{\caption@ifinlist{#1}{b,bottom,below}{%
    \let\caption@position\@secondoftwo
  }{\caption@ifinlist{#1}{a,auto}{%
    \let\caption@position\@undefined
  }{%
    \PackageError{caption}{Undefined caption position `#1'}{\caption@eh}%
  }}}}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@defaultpos}
% The default `position' is `bottom', this means that the (larger) skip will
% be typeset above the caption. This correspondents to the |\@makecaption|
% implementation in the standard \LaTeX\ document classes.
%    \begin{macrocode}
%\caption@setdefaultpos{b}% default = bottom
\let\caption@defaultpos\@secondoftwo
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@iftop}
% |\caption@iftop|\marg{true-code}\marg{false-code}\par
% (If |\caption@position| is set to `auto' we assume a `bottom' position.)
%    \begin{macrocode}
\newcommand\caption@iftop{% bugfixed v3.0a, improved v3.0d
  \ifx\caption@position\@undefined
    \expandafter\@secondoftwo
  \else
    \expandafter\caption@position
  \fi}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@fixposition}
% This macro checks if the `position' is set to `auto'.
% If yes, |\caption@autoposition| will be called to
% set |\caption@position| to a proper value we can actually use.
%    \begin{macrocode}
\newcommand\caption@fixposition{%
  \ifx\caption@position\@undefined
    \caption@autoposition
  \fi}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@autoposition}
% We guess the actual position of the caption by checking |\prevdepth|.
%    \begin{macrocode}
\newcommand\caption@autoposition{% bugfixed v3.0a
  \ifvmode
    \ifodd\caption@debug\relax
      \edef\caption@tempa{\the\prevdepth}%
      \PackageInfo{caption}{\protect\prevdepth=\caption@tempa}%
    \fi
%
%   \caption@setposition{\ifdim\prevdepth>-\p@ b\else t\fi}%
    \ifdim\prevdepth>-\p@
      \let\caption@position\@secondoftwo
    \else
      \let\caption@position\@firstoftwo
    \fi
  \else
    \ifodd\caption@debug\relax
      \PackageInfo{caption}{no \protect\prevdepth}%
    \fi
%
%   \caption@setposition{b}%
    \let\caption@position\@secondoftwo
  \fi}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Hooks}
%
% \begin{macro}{\AtBeginCaption}
% \begin{macro}{\AtEndCaption}
% |\AtBeginDocument| \marg{code}\\
% |\AtEndDocument| \marg{code}\par
% These hooks can be used analogous to |\AtBeginDocument| and |\AtEndDocument|.
%    \begin{macrocode}
\newcommand\caption@beginhook{}
\newcommand\caption@endhook{}
\newcommand\AtBeginCaption{\l@addto@macro\caption@beginhook}
\newcommand\AtEndCaption{\l@addto@macro\caption@endhook}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsubsection*{Miscellaneous options}
%
%    \begin{macrocode}
\DeclareCaptionOption{parskip}[5pt]{\AtBeginCaption{\setlength\parskip{#1}}}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionOption{listof}{\caption@setbool{lof}{#1}}% new v3.0b
\DeclareCaptionOption{singlelinecheck}[1]{\caption@setbool{slc}{#1}}
\DeclareCaptionOption{strut}{\caption@setbool{strut}{#1}}% new v3.0d
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionOption{debug}{\def\caption@debug{#1}}
%    \end{macrocode}
%
% \subsubsection*{Initialization of parameters}
%
%    \begin{macrocode}
\captionsetup{style=default,position=default,listof=1,strut=1,debug=0}
%    \end{macrocode}
%
% \begin{macro}{\ifcaption@star}
% If the starred form of |\caption| is used, this will be set to |true|.
% (Note: This will be replaced by |\caption@iflabel| in future versions
% of the caption package, so I can use |\caption@setbool| so set this
% value.)
%    \begin{macrocode}
\newif\ifcaption@star
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Typesetting the caption}
%
% \begin{macro}{\caption@make}
% |\caption@make|\marg{float name}\marg{ref.\ number}\marg{text}
%    \begin{macrocode}
\newcommand\caption@make[2]{%
  \caption@@make{\caption@lfmt{#1}{#2}}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@@make}
% |\caption@@make|\marg{caption label}\marg{caption text}
%    \begin{macrocode}
\newcommand\caption@@make[2]{%
% \begingroup
  \caption@beginhook
  \caption@calcmargin
%    \end{macrocode}
%
% Special single-line treatment
% (Improvement v3.0d: moved to here)
%
%    \begin{macrocode}
  \caption@ifslc{%
    \ifx\caption@sls\@empty\else
      \caption@startslc
      \setbox\@tempboxa\hbox{\caption@@@make{#1}{#2}}%
      \ifdim\wd\@tempboxa >\captionwidth
        \caption@endslc
      \else
        \caption@endslc
        \caption@esetup\caption@sls
        \caption@calcmargin
      \fi
    \fi}{}%
%    \end{macrocode}
%
% Bugfix v3.0d: Use |\@tempdima| instead of |\captionmargin|, |\ifdim added| (04-10-26)
%
%    \begin{macrocode}
  \@tempdima\captionmargin
  \caption@ifh{\advance\@tempdima by \captionindent}%
  \ifdim\@tempdima=\z@\else
    \hskip\@tempdima
  \fi
%    \end{macrocode}
%
% Bugfix v3.0d: Use |\@tempdima| instead of |\captionwidth| (04-10-26)
%
%    \begin{macrocode}
  \@tempdima\captionwidth
  \caption@ifh{\advance\@tempdima by -\captionindent}%
  \caption@startbox\@tempdima
%    \end{macrocode}
%
% Bugfix v3.0b: |\ifdim| added (04-05-05)\\
% Bugfix v3.0d: |\leavevmode| added (05/02/09)\\
% Improvement v3.0d: |\caption@ifh| (05/02/09)
%
%    \begin{macrocode}
    \caption@ifh{%
      \ifdim\captionindent=\z@
        \leavevmode
      \else
        \hskip-\captionindent
      \fi}%
%    \end{macrocode}
%
% Bugfix v3.0d: |\strut| moved from here to |\caption@@@make|
%
%    \begin{macrocode}
    \caption@@@make{#1}{#2}%
%    \end{macrocode}
%
%    \begin{macrocode}
  \caption@endbox
%    \end{macrocode}
%
% Bugfix v3.0d: This |\hskip| added
%
%    \begin{macrocode}
  \ifdim\captionmargin=\z@\else
    \hskip\captionmargin
  \fi
%    \end{macrocode}
%
%    \begin{macrocode}
  \caption@endhook
% \endgroup
  \global\caption@starfalse}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@calcmargin}
% Calculate |\captionmargin| \& |\captionwidth|, so both contain valid values.
%    \begin{macrocode}
\newcommand\caption@calcmargin{%
  \ifcaption@width
    \captionmargin\hsize
    \advance\captionmargin by -\captionwidth
    \divide\captionmargin by 2
  \else
    \captionwidth\hsize
    \advance\captionwidth by -2\captionmargin
  \fi
%
  \ifodd\caption@debug\relax
    \PackageInfo{caption}{\protect\hsize=\the\hsize,
      \protect\margin=\the\captionmargin,
      \protect\width=\the\captionwidth}%
  \fi}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@startslc}
% Re-define anything which would disturb the single line check\par
% Bugfix v3.0b: re-definition of |\label| \& |\@footnotetext| was missing here\\
% Improvement v3.0b: re-define |\stepcounter| instead of |\footnote(mark)|\\
% Improvement v3.0d: |\let\caption@hj\relax| added
%    \begin{macrocode}
\newcommand\caption@startslc{%
  \begingroup
  \let\label\@gobble\let\@footnotetext\@gobble
  \def\stepcounter##1{\advance\csname c@##1\endcsname\@ne\relax}%
  \let\caption@hj\relax}
\newcommand\caption@endslc{%
  \endgroup}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@startbox}
% \begin{macro}{\caption@endbox}
% These macros start and end the box which surrounds the caption paragraph.
%    \begin{macrocode}
\newcommand*\caption@startbox[1]{\vbox\bgroup\hsize#1}%
%\newcommand*\caption@startbox[1]{\vbox\bgroup\setlength\hsize{#1}\@parboxrestore}%
\newcommand*\caption@endbox{\egroup}
%\newcommand*\caption@endbox{\@finalstrut\strutbox\@@par\egroup}
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \begin{macro}{\caption@@@make}
% |\caption@@@make|\marg{caption label}\marg{caption text}\par
% This one finally typesets the caption paragraph, without margin and indention.
%    \begin{macrocode}
\newcommand\caption@@@make[2]{%
%    \end{macrocode}
%
% Empty text? Then use no caption label separator.
%
%    \begin{macrocode}
  \caption@ifempty{#2}{% changed v3.0e
    \let\caption@lsep\relax
    \let\caption@ifstrut\@secondoftwo % added v3.0e
  }%
%    \end{macrocode}
%
% Take care that |\captionparindent| and |\captionhangindent| will be used
% to typeset the paragraph.
%
%    \begin{macrocode}
  \def\caption@@par{%
    \parindent\captionparindent\hangindent\captionhangindent}%
  \@setpar{\@@par\caption@@par}\caption@@par
%    \end{macrocode}
%
% Finally the caption will be typeset.
%
%    \begin{macrocode}
  \caption@hj\captionsize\captionfont
%    \end{macrocode}
% Bugfix v3.0e: Handling of |\ifcaption@star| changed
%    \begin{macrocode}
  \caption@fmt{\ifcaption@star\else{\captionlabelfont#1}\fi}%
              {\ifcaption@star\else{\captionlabelfont\caption@lsep}\fi}%
              {{\captiontextfont
%    \end{macrocode}
% Bugfix v3.0d: Use some kind of |\@startstrut\strutbox| instead of |\strut| (04-12-16)
%    \begin{macrocode}
                \caption@ifstrut{\vrule\@height\ht\strutbox\@width\z@}{}%
%    \end{macrocode}
% Bugfix v3.0b: |\allowhyphens| added (04-05-06)
%    \begin{macrocode}
                \nobreak\hskip\z@skip
                #2%
%    \end{macrocode}
% Bugfix v3.0d: |\@finalstrut\strutbox| added (05-01-23)
%    \begin{macrocode}
%               \caption@ifstrut{\vrule\@height\z@\@depth\dp\strutbox\@width\z@}{}%
                \caption@ifstrut{\@finalstrut\strutbox}{}%
                \par}}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@ifempty}
% |\caption@ifempty|\marg{text}\marg{if-clause}\\
% (new v3.0e, 05/05/05)
%    \begin{macrocode}
\newcommand\caption@ifempty[1]{%
  \def\caption@tempa{#1}%
  \def\caption@tempb{\ignorespaces}%
  \ifx\caption@tempa\caption@tempb
    \let\caption@tempa\@empty
  \fi
  \ifx\caption@tempa\@empty
    \expandafter\@firstofone
  \else
    \expandafter\@gobble
  \fi}
%    \end{macrocode}
% \end{macro}
%
% \iffalse
%</kernel>
% \fi
%
%
% \subsection{Main package}
% \iffalse
%<*package>
% \fi
%
% \subsubsection*{Identification}
%
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesPackage{caption}[2005/06/28 v3.0g Customising captions (AS)]
%    \end{macrocode}
%
% \subsubsection*{Loading the caption kernel}
%
%    \begin{macrocode}
\RequirePackage{caption3}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionOption{type}{\def\@captype{#1}}% new v3.0d
%    \end{macrocode}
%
% \subsubsection*{Float names}
%
% \begin{macro}{\caption@floatname}
% |\caption@floatname|\marg{type}\par
% Usually all float names (which partly build the caption label)
% follow the same naming convention. But some packages (for example
% the \package{float} package) do not, so we use this wrapper macro which
% can be extended later on.
%    \begin{macrocode}
\newcommand*\caption@floatname[1]{\@nameuse{#1name}}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{Support for |figure| and |table|}
%
% \changes{v3.0a}{9 Jan 04}{Options `figureposition' and `tableposition' added}
%    \begin{macrocode}
\DeclareCaptionOption*{figureposition}{\captionsetup[figure]{position=#1}}%  new v3.0a
\DeclareCaptionOption*{tableposition}{\captionsetup[table]{position=#1}}%    new v3.0a
%    \end{macrocode}
%
% \subsubsection*{Configuration files}
%
%    \begin{macrocode}
\DeclareCaptionOption{config}[caption]{%
   \InputIfFileExists{#1.cfg}{\typeout{*** Local configuration file
                                       #1.cfg used ***}}%
                             {\PackageWarning{caption}{Configuration
                               file #1.cfg not found}}}
%    \end{macrocode}
%
% \subsubsection*{Compatibility options (caption v$1.x$)}
%
%    \begin{macrocode}
\DeclareCaptionOption*{normal}[]{\caption@setformat{normal}}
\DeclareCaptionOption*{isu}[]{\caption@setformat{hang}}
\DeclareCaptionOption*{hang}[]{\caption@setformat{hang}}
\DeclareCaptionOption*{center}[]{\caption@setjustification{centering}}
\DeclareCaptionOption*{anne}[]{\caption@setjustification{centerlast}}
\DeclareCaptionOption*{centerlast}[]{\caption@setjustification{centerlast}}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionOption*{scriptsize}[]{\def\captionfont{\scriptsize}}
\DeclareCaptionOption*{footnotesize}[]{\def\captionfont{\footnotesize}}
\DeclareCaptionOption*{small}[]{\def\captionfont{\small}}
\DeclareCaptionOption*{normalsize}[]{\def\captionfont{\normalsize}}
\DeclareCaptionOption*{large}[]{\def\captionfont{\large}}
\DeclareCaptionOption*{Large}[]{\def\captionfont{\Large}}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionOption*{up}[]{\l@addto@macro\captionlabelfont\upshape}
\DeclareCaptionOption*{it}[]{\l@addto@macro\captionlabelfont\itshape}
\DeclareCaptionOption*{sl}[]{\l@addto@macro\captionlabelfont\slshape}
\DeclareCaptionOption*{sc}[]{\l@addto@macro\captionlabelfont\scshape}
\DeclareCaptionOption*{md}[]{\l@addto@macro\captionlabelfont\mdseries}
\DeclareCaptionOption*{bf}[]{\l@addto@macro\captionlabelfont\bfseries}
\DeclareCaptionOption*{rm}[]{\l@addto@macro\captionlabelfont\rmfamily}
\DeclareCaptionOption*{sf}[]{\l@addto@macro\captionlabelfont\sffamily}
\DeclareCaptionOption*{tt}[]{\l@addto@macro\captionlabelfont\ttfamily}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionOption*{nooneline}[]{\caption@setbool{slc}{0}}
%    \end{macrocode}
%
%    \begin{macrocode}
\caption@setbool{ruled}{0}
\DeclareCaptionOption*{ruled}[]{\caption@setbool{ruled}{1}}
%    \end{macrocode}
%
% \subsubsection*{Generic package support}
%
% \begin{macro}{\DeclareCaptionPackage}
% Each single package support can be switched on or off by using the
% appropriate option. By default all of them are enabled.
%    \begin{macrocode}
\newcommand*\DeclareCaptionPackage[1]{%
  \caption@setbool{pkt@#1}{1}%
  \DeclareCaptionOption*{#1}{\caption@setbool{pkt@#1}{##1}}}
\AtEndOfPackage{\let\DeclareCaptionPackage\@undefined}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@ifpackage}
% |\caption@ifpackage|\marg{package name}\marg{package macro}\marg{package code}
%    \begin{macrocode}
\newcommand\caption@ifpackage[3]{%
  \caption@ifbool{pkt@#1}{%
    \@ifundefined{#2}%
      {\let\next\AtBeginDocument}%
      {\let\next\@firstofone}%
  }{%
    \let\next\@gobble
  }%
%
  \ifodd\caption@debug\relax
    \edef\caption@tempa{%
      \caption@ifbool{pkt@#1}{%
        \@ifundefined{#2}{AtBeginDocument}{firstofone}%
      }{gobble}}%
    \PackageInfo{caption}{#1 = \caption@ifbool{pkt@#1}{1}{0} %
         (\@ifundefined{#2}{not }{}loaded -> \caption@tempa)}%
  \fi
%
  \@nameundef{caption@ifpkt@#1}%  bugfixed v3.0a
%
  \next{%
    \expandafter\ifx\csname #2\endcsname\relax
    \else
      #3
    \fi}}
\AtEndOfPackage{\let\caption@ifpackage\@undefined}
%    \end{macrocode}
% \end{macro}
%
% These are the packages we support:
%
%    \begin{macrocode}
\DeclareCaptionPackage{caption}
%    \end{macrocode}
%
%    \begin{macrocode}
\DeclareCaptionPackage{float}
\DeclareCaptionPackage{floatrow}
\DeclareCaptionPackage{hyperref}
\DeclareCaptionPackage{hypcap}
\DeclareCaptionPackage{listings}
\DeclareCaptionPackage{longtable}
\DeclareCaptionPackage{rotating}
\DeclareCaptionPackage{sidecap}
\DeclareCaptionPackage{supertabular}
%    \end{macrocode}
%
% \begin{macro}{\ProcessOptionsWithKV}
% We process our options using the keyval package.
%    \begin{macrocode}
\def\ProcessOptionsWithKV#1{% bugfixed v3.0a
  \let\@tempc\relax
  \let\caption@tempa\@empty
  \@for\CurrentOption:=\@classoptionslist\do{%
    \@ifundefined{KV@#1@\CurrentOption}%
    {}%
    {%
      \edef\caption@tempa{\caption@tempa,\CurrentOption,}%
      \@expandtwoargs\@removeelement\CurrentOption
        \@unusedoptionlist\@unusedoptionlist
    }%
  }%
  \edef\caption@tempa{%
    \noexpand\setkeys{#1}{%
      \caption@tempa\@ptionlist{\@currname.\@currext}%
    }%
  }%
  \caption@tempa
%    \end{macrocode}
% Bugfix, see |<400D360C.9678329F@gmx.net>| for details
%    \begin{macrocode}
  \let\CurrentOption\@empty
  \AtEndOfPackage{\let\@unprocessedoptions\relax}}
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\ProcessOptionsWithKV{caption}
\let\ProcessOptionsWithKV\@undefined
%    \end{macrocode}
%
%    \begin{macrocode}
\caption@ifbool{pkt@caption}{}{\endinput}
\@nameundef{caption@ifpkt@caption}
%    \end{macrocode}
%
% \subsubsection*{Usefull stuff}
%
% \begin{macro}{\captionof}
% |\captionof|(|*|)\marg{type}\oarg{lst\_entry}\marg{heading}
%    \begin{macrocode}
\def\captionof{\@ifstar{\caption@of{\caption*}}{\caption@of\caption}}
\newcommand*\caption@of[2]{\def\@captype{#2}#1}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ContinuedFloat}
% |\ContinuedFloat|
%    \begin{macrocode}
\providecommand\ContinuedFloat{%
  \ifx\@captype\@undefined
    \@latex@error{\noexpand\ContinuedFloat outside float}\@ehd
  \else
    \addtocounter\@captype\m@ne
    \caption@ContinuedFloat\@captype
  \fi}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@ContinuedFloat}
% \begin{macro}{\caption@resetContinuedFloat}
%    \begin{macrocode}
\let\caption@ContinuedFloat\@gobble
\let\caption@resetContinuedFloat\@gobble
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsubsection*{Internal helpers}
%
% \begin{macro}{\caption@begin}
% |\caption@begin|\marg{type} (changed in v3.0b+v3.0e)
%    \begin{macrocode}
\newcommand*\caption@begin[1]{%
  \caption@resetContinuedFloat{#1}%
  \begingroup
  \caption@setfloattype{#1}%
%    \end{macrocode}
%
% \changes{v3.0e}{12 Apr 05}{Check for default label format added}
%    \begin{macrocode}
% \caption@setfnum{#1}%
  \ifx\caption@lfmt\caption@lfmt@default\else
    \@namedef{fnum@#1}{%
      \caption@lfmt{\caption@floatname{#1}}{\@nameuse{the#1}}}%
  \fi
%    \end{macrocode}
%
%    \begin{macrocode}
  \caption@fixposition
  \global\let\caption@fixedposition\caption@position
%    \end{macrocode}
%
%    \begin{macrocode}
  \caption@@begin{#1}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@beginex}
% |\caption@beginex|\marg{type}\marg{list entry}
%    \begin{macrocode}
\newcommand*\caption@beginex[1]{%
  \caption@begin{#1}%
  \caption@preparelof}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@end}
% |\caption@end|
%    \begin{macrocode}
\newcommand*\caption@end{%
  \caption@@end
  \endgroup
%    \end{macrocode}
%
%    \begin{macrocode}
  \let\caption@position\caption@fixedposition}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@setfloattype}
% A macro for setting up the right float type within |\@caption|, |\LT@makecaption| etc.
% Usually this is equivalent to |\caption@settype| but I made it an own macro so
% I can extend it later on, for example if the \package{float} package is loaded.
%    \begin{macrocode}
\let\caption@setfloattype\caption@settype%  new v3.0a
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@letfloattype}
% |\caption@letfloattype|\marg{type}\marg{extra code}\\
% (new in v3.0b, additional argument in v3.0e)
%    \begin{macrocode}
\newcommand*\caption@letfloattype[2]{%
  \def\caption@setfloattype##1{%
    \caption@settype{##1}#2\caption@settype{#1}}}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@preparelof}
% |\caption@preparelof|\marg{list entry}
%    \begin{macrocode}
\newcommand*\caption@preparelof[1]{%  changed v3.0b
  \caption@iflof%
    {\def\caption@tempa{#1}}%
    {\let\caption@tempa\@empty}%
  \ifx\caption@tempa\@empty
    \def\addcontentsline##1##2##3{}%
  \fi}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@@begin}
% \begin{macro}{\caption@@end}
% |\caption@@begin|\marg{type}\\
% |\caption@@end|
%    \begin{macrocode}
\let\caption@@begin\@gobble % new v3.0a
\let\caption@@end\@empty %    new v3.0a
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
% \subsubsection*{Caption support}
%
% Some packages (like the \package{hyperref} package for example) redefines
% |\caption| and |\@caption|, too, but without chaining to the previous
% definition. So we have to use |\AtBeginDocument| here, so we can make sure
% our definition don't get lost.
%
%    \begin{macrocode}
\AtBeginDocument{%
  \let\caption@old\caption
  \let\caption@@old\@caption
%    \end{macrocode}
%
%    \begin{macrocode}
  \@ifundefined{cc@caption}{%
%    \end{macrocode}
%
% \begin{macro}{\caption}
%   Define |\caption*| \ldots\\
%   (07/18/03: |\global| added, so this works with sidecap)
%   (05/22/05: |\ContinuedFloat| added)
%    \begin{macrocode}
    \def\caption{\caption@caption\caption@old}%
    \def\caption@caption#1{%
      \@ifstar{\ContinuedFloat\global\caption@startrue #1[]}{#1}}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\@caption}
%   Define |\caption[]{|\ldots|}| \ldots
%    \begin{macrocode}
    \long\def\@caption#1[#2]#3{%
      \caption@beginex{#1}{#2}%
        \caption@@old{#1}[{#2}]{#3}%
      \caption@end}%
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
  }{%
%    \end{macrocode}
%
%   Minimum captcont package support (bugfixed v3.0c, 04-07-15)
%
%    \begin{macrocode}
    \PackageInfo{caption}{captcont package v2.0 detected}%
    \def\caption@caption#1{#1}%  added v3.0c
  }%
}
%    \end{macrocode}
%
% \begin{macro}{\@makecaption}
% |\@makecaption|\marg{label}\marg{text}\par\bigskip
% Original code (from |latex/base/classes.dtx|):
% \begin{verbatim}
% \long\def\@makecaption#1#2{%
%   \vskip\abovecaptionskip
%   \sbox\@tempboxa{#1: #2}%
%   \ifdim \wd\@tempboxa >\hsize
%     #1: #2\par
%   \else
%     \global \@minipagefalse
%     \hb@xt@\hsize{\hfil\box\@tempboxa\hfil}%
%   \fi
%   \vskip\belowcaptionskip}
% \end{verbatim}
%    \begin{macrocode}
\renewcommand\@makecaption[2]{%
  \caption@iftop{\vskip\belowcaptionskip}{\vskip\abovecaptionskip}%
  \ifnum\caption@debug>1 %
    \llap{$\caption@iftop\downarrow\uparrow$ }%
  \fi
  \caption@@make{#1}{#2}%
  \caption@iftop{\vskip\abovecaptionskip}{\vskip\belowcaptionskip}}
%    \end{macrocode}
% \end{macro}
%
% \subsubsection*{KOMA-script classes support}
% (new in 3.0a)
%
% \changes{v3.0a}{18 Jan 04}{Minimum adaption to KOMA-Script added}
%    \begin{macrocode}
\AtBeginDocument{\let\scr@caption\caption}
%    \end{macrocode}
%
% \subsubsection*{float package support}
%
% \iffalse
% Rewritten v0.3f: more straight-ahead implementation, but only works with v1.3 now
% (the old code incl. documentation can be found in caption-30f-050530.zip)
% \fi
%
% The \package{float} package usually do not use the LaTeX kernel command
% |\@caption| to typeset the caption but |\float@caption| instead.
% (|\@caption| will only be used if the float is re-styled with
% |\restylefloat*|.)
%
% The main two things |\float@caption| is doing different are:
% \begin{itemize}
%   \item The caption will be typeset inside a savebox called |\@floatcapt| so
%   it can be placed above or below the float contents afterwards.
%   \item |\@makecaption| will not be used to finally typeset the caption.
%   Instead |\@fs@capt| will be used which definition is part of the float
%   style.
%   (Note that |\@fs@capt| will not typeset any vertical space above or below
%   the caption; instead this space will be typeset by the float style code
%   itself.)
% \end{itemize}
%
% So our main goal is to re-define |\float@caption| so our macro
% |\caption@@make| will be used instead of |\@fs@capt|.
%
% To allow different caption styles for different float styles we will also
% determine the current float style (e.g. `ruled') at run time and setup
% a caption style (and additional settings) with the same name, if defined.
%
% \begin{macro}{\caption@setfloatposition}
% First of all we provide a macro which converts |\@fs@iftopcapt| (which
% is part of a float style and controls where the caption will be typeset,
% above or below the float contents) to our |position=| setting. Since the
% spacing above and below the caption will be done by the float style and
% \emph{not} by us this sounds quite useless. But in fact it isn't, since some
% packages based on the \package{caption} package (like the \package{subfig}
% package) could have an interest for this information and therefore use the
% |\caption@iftop| macro we provide in our kernel. Furthermore we need this
% information for ourself in |\captionof| which uses |\@makecaption| to
% finally typeset the caption.
%    \begin{macrocode}
\def\caption@setfloatposition{%
  \caption@setposition{\@fs@iftopcapt t\else b\fi}}
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
\caption@ifpackage{float}{@float@setevery}{%
  \PackageInfo{caption}{float package v1.3 (or newer) detected}%
%    \end{macrocode}
%
% Since |\float@caption| puts the float contents into a savebox we need
% a special version of |\captionof| which `unfolds' this box afterwards,
% so the caption actually gets typeset. Furthermore we have to typeset
% the spacing above and below the caption for ourself, since this space is
% not part of the box.
%
% Please note that this version of |\captionof| only works \emph{outside}
% floating environments defined with the float package, so for example
% a |\captionof{Program}| used within a `standard' |figure| or a
% |minipage| will work fine, but not within a re-styled |figure| or
% an |Example| environment defined with |\newfloat|.
% (We don't check for this so you'll get wired errors if you try to do so!)
%
% \begin{macro}{\caption@of@float}
% Usually no special action is necessary, so we define |\caption@of@float|
% to |\@gobble|. We will redefine it later on to |\@firstofone| to activate
% the code which `unfolds' the savebox.
%    \begin{macrocode}
  \let\caption@of@float\@gobble
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@of}
% If the float is defined by the float package (which means |\fst@|\meta{type}
% is defined) we activate the special treatment for such captions typeset
% with |\captionof|. Furthermore we `execute' this float style, so
% |\@fs@iftopcapt| is set to its proper value.
%    \begin{macrocode}
  \renewcommand*\caption@of[2]{%
    \@ifundefined{fst@#2}{}{%
      \let\caption@of@float\@firstofone
      \@nameuse{fst@#2}\@float@setevery{#2}}%
    \def\@captype{#2}#1}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\float@caption}
% Our version of |\float@caption| nearly looks like our version of |\@caption|.
% The main differences are that |\@fs@capt| will be replaced by our |\caption@@make|
% and that the savebox called |\@floatcapt| will be unfolded if required. (See above)
%    \begin{macrocode}
  \let\caption@@float\float@caption
  \long\def\float@caption#1[#2]#3{%
    \caption@beginex{#1}{#2}%
      \let\@fs@capt\caption@@make
      \caption@@float{#1}[{#2}]{#3}%
      \caption@of@float{%
        \def\caption@@make##1##2{\unvbox\@floatcapt}%
        \@makecaption{}{}}%
    \caption@end}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\@float@setevery}
% |\@float@setevery|\marg{float type} is provided by the \package{float} package;
% it's called every time a floating environment defined with |\newfloat| or
% |\restylefloat| begins.
% We use this hook to do some adaptions and to setup the proper caption style
% (if defined) and additional settings declared with
% |\captionsetup|\oarg{float style}.
%    \begin{macrocode}
  \let\caption@float@setevery\@float@setevery
  \def\@float@setevery#1{%
    \caption@float@setevery{#1}%
%    \end{macrocode}
%
% \LaTeX{} and most packages use |\|\meta{type}|name|
% to provide a macro for the float name -- for example the command
% |\figurename| will usually contain the name of the floating environment
% |figure|:
% \begin{quote}
%   |\newcommand\figurename{Figure}|
% \end{quote}
%
% But the \package{float} package don't follow this naming convention,
% it uses |\fname@|\meta{type} instead. So we have to adapt
% |\caption@floatname| here, so our captions will be still ok.
%
%    \begin{macrocode}
    \def\caption@floatname##1{\@nameuse{fname@#1}}%
%    \end{macrocode}
%
% |\newfloat| and |\restylefloat| saves the \emph{actual} definition of
% |\@caption| or |\float@caption| in |\@float@c@|\meta{captype} with |\let|
% (instead of using |\def|), so redefinitions of |\@caption| (and of course
% our redefinition of |\float@caption|) will never been used if the
% |\newfloat| or |\restylefloat| command takes place in front of the
% redefinitions provided by the \package{caption} or other packages like the
% \package{hyperref} package.
%
% So here we determine if the user has used |\restylefloat| or
% |\restylefloat*| and bring |\@float@c@|\meta{captype} up-to-date.
% This is quite easy: If |\@float@c@|\meta{captype} is the same as the
% original or our own definition of |\float@caption|, the user has used
% |\restylefloat| (and |\float@caption| should be used), otherwise
% we assume he has used |\restylefloat*| (and |\@caption| should be used).
% (This test will fail if some other package re-defines |\float@caption|,
% too, so we have to assume that we are the only one.)
%
%    \begin{macrocode}
    \expandafter\let\expandafter\caption@tempa\csname @float@c@#1\endcsname
    \ifx\caption@tempa\float@caption
    \else\ifx\caption@tempa\@caption
    \else\ifx\caption@tempa\caption@@float
%     \ifodd\caption@debug\relax
%       \PackageInfo{caption}{\protect\@float@c@#1\space := \protect\float@caption}%
%     \fi
      \expandafter\let\csname @float@c@#1\endcsname\float@caption
    \else
%     \ifodd\caption@debug\relax
%       \PackageInfo{caption}{\protect\@float@c@#1\space := \protect\@caption}%
%     \fi
      \expandafter\let\csname @float@c@#1\endcsname\@caption
    \fi\fi\fi
%    \end{macrocode}
%
% If the floating environment is defined with |\newfloat| or |\restylefloat|
% (and \emph{not} with |\restylefloat*|), |\@float@c@|\meta{type}
% will now be identical to |\float@caption|.
%
%    \begin{macrocode}
    \expandafter\ifx\csname @float@c@#1\endcsname\float@caption
%    \end{macrocode}
%
% First of all we set the caption position to it's proper value.
% (See above definition of |\caption@setfloatposition|)
%
%    \begin{macrocode}
      \caption@setfloatposition%  changed v3.0b+f
%    \end{macrocode}
%
% Now we'll have to determine the current float style.
% This is not so easy because the only hint provided by the \package{float}
% package is the macro |\fst@|\meta{float type} which points to the macro
% which represents the float style.
% So for example after
% \begin{quote}
%   |\floatstyle{ruled}|\\
%   |\newfloat{Program}{tbp}{lop}|
% \end{quote}
% |\fst@Program| will be defined as
% \begin{quote}
%   |\def\fst@Program{\fs@ruled}|\quad.
% \end{quote}
%
% So here is what we do: We copy |\fst@|\meta{float type} to |\caption@fst| and
% make it a string so we can gobble the first four tokens (= |\fs@|), so only the
% the name of the float style is left.
%
%    \begin{macrocode}
      \expandafter\let\expandafter\caption@fst\csname fst@#1\endcsname
      \edef\caption@fst{\noexpand\string\expandafter\noexpand\caption@fst}%
      \edef\caption@fst{\noexpand\@gobblefour\caption@fst}%
%     \edef\caption@fst{\caption@fst}%
%    \end{macrocode}
%
% |\caption@fst| now contains the float style (e.g. `ruled')
% so we can use it to set the corresponding style (if defined) and additional options.
%
%    \begin{macrocode}
      \caption@setstyle*\caption@fst
      \caption@settype\caption@fst% new v3.0f
%    \end{macrocode}
%
%    \begin{macrocode}
    \fi}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\fs@plaintop}
% \begin{macro}{\fs@boxed}
% The float styles |plaintop| and |boxed| don't use our skip which can be set
% with |skip=| : |plaintop| uses |\belowcaptionskip| instead of
% |\abovecaptionskip|, and |boxed| uses a fixed space of |2pt|.
% So we patch the according float style macros here.
%    \begin{macrocode}
  \g@addto@macro\fs@plaintop{\def\@fs@mid{\vspace\abovecaptionskip\relax}}%
  \g@addto@macro\fs@boxed{\def\@fs@mid{\kern\abovecaptionskip\relax}}%
%    \end{macrocode}
% \end{macro}
% \end{macro}
%
%    \begin{macrocode}
}
%    \end{macrocode}
%
%    \begin{macrocode}
\captionsetup[boxed]{skip=2pt}%
%    \end{macrocode}
%
% To emulate the `ruled' definition of |\@fs@capt| we provide a caption style
% `ruled' with appropriate options. But if the package option |ruled| was
% specified, we setup additional caption settings to emulate the behaviour
% of the \package{caption} package v$1.x$ option |ruled| instead:
% The current caption settings will be used, but without margin and without
% `single-line-check'.
%    \begin{macrocode}
\caption@ifbool{ruled}{%
  \captionsetup[ruled]{margin=0pt,singlelinecheck=0}% new v3.0f
}{% v3.0f: "strut=0" added
  \DeclareCaptionStyle{ruled}{labelfont=bf,labelsep=space,strut=0}}
\let\caption@ifruled\@undefined
%    \end{macrocode}
%
% \subsubsection*{floatrow package support}
%
% The \package{floatrow} package is adapted for usage with the
% \package{caption} package. So the main work has already been done,
% there are only two little things we have to take care about.
%
%    \begin{macrocode}
\caption@ifpackage{floatrow}{flrow@setlist}{%
  \PackageInfo{caption}{floatrow package v0.1f (or newer) detected}%
%    \end{macrocode}
%
% \begin{macro}{\caption@of}
% Captions typeset with |\captionof| should have the correct layout,
% so we have to `activate' this layout here with |\flrow@setlist|.
% \par{\small (Please note that this version of |\captionof| has the same
% restrictions than the |\captionof| offered for floating environments
% defined with the \package{float} package, see above.)}
%    \begin{macrocode}
  \renewcommand*\caption@of[2]{%
    \def\@captype{#2}\flrow@setlist{{#2}}#1}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@floatname}
% The \package{floatrow} package followes the same naming convention
% as the \package{float} package; so we have to adapt |\caption@floatname|
% here, too.
%    \begin{macrocode}
  \renewcommand*\caption@floatname[1]{%
    \@nameuse{\@ifundefined{fname@#1}{#1name}{fname@#1}}}%
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
}
%    \end{macrocode}
%
%
% \subsubsection*{hyperref package support}
%
% When the \package{hyperref} package is used we have the problem
% that the usage of |\ContinuedFloat| will create duplicate
% hyperlinks -- both |\@currentHlabel| and |\@currentHref| will be the same
% for the main float and the continued ones. So we have to make sure
% unique labels and references will be created each time. We do this
% by extending |\theHfigure| and |\theHtable|, so for continued floats
% the scheme
% \begin{quote}\meta{type}|.|\meta{type \#}|.|\meta{continue \#}\end{quote}
% will be used instead of
% \begin{quote}\meta{type}|.|\meta{type \#}\quad\quad.\end{quote}
% \par{\small(This implementation follows an idea from Steven Douglas Cochran.)}
% \par{\small Note: This does not help if |\Hy@naturalnamestrue| is set.}
%
%    \begin{macrocode}
\caption@ifpackage{hyperref}{theHfigure}{%
  \PackageInfo{caption}{hyperref package v6.74m (or newer) detected}%
%    \end{macrocode}
%
% \begin{macro}{\caption@ContinuedFloat}
% If |\theH|\meta{type} is defined, we extend it with |.|\meta{continue \#}.
% Furthermore we set |\caption@resetContinuedFloat| to |\@gobble| so the
% continuation counter will not be reset to zero inside |\caption|.
%    \begin{macrocode}
  \def\caption@ContinuedFloat#1{%
    \@ifundefined{theH#1}{}{%
      \@ifundefined{CF@#1}{%
        \expandafter\newcount\csname CF@#1\endcsname
        \caption@resetContinuedFloat{#1}}{}%
      \global\advance\csname CF@#1\endcsname\@ne\relax
      \expandafter\l@addto@macro\csname theH#1\endcsname{.\expandafter\@arabic\csname CF@#1\endcsname}%
      \let\caption@resetContinuedFloat\@gobble
    }}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\caption@resetContinuedFloat}
% If a continuation counter is defined, we reset it.
%    \begin{macrocode}
  \def\caption@resetContinuedFloat#1{%
    \@ifundefined{CF@#1}{}{\global\csname CF@#1\endcsname\z@\relax}}%
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
}
%    \end{macrocode}
%
%
% \subsubsection*{hypcap package support}
% 
% When the \package{hypcap} package is used the following problems occur:
% \begin{enumerate}
%   \item The \package{hypcap} package uses |\capstart|, |\hc@caption|, and
%   |\hc@@caption| instead of |\caption| and |\@caption|.
%   So we have to patch these macros, too.
%   \item |\caption| will be saved to |\hc@org@caption| when the
%   \package{hypcap} package is loaded.
%   We have to change this so our definition of |\caption| will always be
%   used.
%   \item Both, |\capstart| and |\hc@@caption|, call |\hyper@makecurrent|.
%   But since we offer |\ContinuedFloat| the float counters could have changed
%   between these both calls! So we fix this by saving the \package{hyperref}
%   reference (= |\@currentHref|) in |\capstart| and restoring it later on in
%  |\hc@@caption|.
%   \par{\small (This also fixes the problem that \package{hypcap} does not
%   work if |\Hy@hypertexnamesfalse| is set. This come in handy; we set
%   it locally to avoid duplicated \package{hyperref} labels which could
%   occur if |\ContinuedFloat| will be used.)}
%   \item |\capstart| will call |\H@refstepcounter| to increase the float
%   number. This collides with a following|\ContinuedFloat|, too, so we have
%   to move this call from here to |\caption|. (Since we set
%   |\Hy@hypertexnamesfalse| we can do this without problems.)
% \end{enumerate}
%
%    \begin{macrocode}
\caption@ifpackage{hypcap}{hc@caption}{%
  \PackageInfo{caption}{hypcap package v1.0 (or newer) detected}%
%    \end{macrocode}
%
% \begin{macro}{\capstart}
% Here comes our version of |\capstart|:
%    \begin{macrocode}
  \let\caption@capstart\capstart
  \def\capstart{%
%    \end{macrocode}
% First of all we update |\hc@org@caption| to correct the problem that the
% \package{hypcap} package has saved an older definition of |\caption|.
%    \begin{macrocode}
    \let\hc@org@caption\caption
%    \end{macrocode}
% Since we don't know the float counter yet (it could be changed with
% |\ContinuedFloat| afterwards!) we make sure |\H@refstepcounter| will
% not be used and |\Hy@hypertexnamesfalse| is set, so unique
% \package{hyperref} labels will be generated by the original
% definition of |\capstart|.
% Afterwards we save the reference which was generated by
% |\hyper@makecurrent|.
%    \begin{macrocode}
    \begingroup
      \let\H@refstepcounter\@gobble
      \Hy@hypertexnamesfalse
      \caption@capstart
      \global\let\caption@currentHref\@currentHref
    \endgroup
%    \end{macrocode}
% The \package{hypcap} package restores the previous definition of |\caption|
% inside |\hc@@caption|. But since we will call this inside a group later on
% (making this restauration non-working), we have to make this for ourself
% inside |\caption|.
% (This would not be necessary if \package{hypcap} would do this inside
% |\hc@caption| instead of |\hc@@caption|.)\par
% Additionally we increase the float counter here (since we have suppressed this
% in |\capstart|) and use |\caption@caption| here, so |\caption*| will work as
% expected.
%    \begin{macrocode}
    \def\caption{%
      \let\caption\hc@org@caption
      \H@refstepcounter\@captype
      \caption@caption\hc@caption}}%
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\hc@@caption}
% Here comes our version of |\hc@@caption|:
%    \begin{macrocode}
  \let\caption@hc@@caption\hc@@caption
  \long\def\hc@@caption#1[#2]#3{%
    \caption@beginex{#1}{#2}%
%    \end{macrocode}
% Beside the usual |\caption@begin| and |\caption@end| stuff (to support local
% options etc.) we make sure our saved \package{hyperref} reference will be
% used.
%    \begin{macrocode}
      \let\caption@hyper@makecurrent\hyper@makecurrent
      \def\hyper@makecurrent\@captype{%
        \let\hyper@makecurrent\caption@hyper@makecurrent
        \global\let\@currentHref\caption@currentHref}%
%    \end{macrocode}
%    \begin{macrocode}
      \caption@hc@@caption{#1}[{#2}]{#3}%
    \caption@end}%
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
}
%    \end{macrocode}
%
%
% \subsubsection*{listings package support}
%
%    \begin{macrocode}
\caption@ifpackage{listings}{lst@MakeCaption}{%
  \PackageInfo{caption}{listings package v1.2 (or newer) detected}%
%
  \let\caption@lst@MakeCaption\lst@MakeCaption
  \def\lst@MakeCaption#1{%
    \let\caption@setfloattype\caption@settype
    \def\caption@autoposition{\caption@setposition{#1}}%
    \caption@begin{lstlisting}%
      \caption@lst@MakeCaption{#1}%
    \caption@end}%
%
}
%    \end{macrocode}
%
% \subsubsection*{longtable package support}
%
%    \begin{macrocode}
\caption@ifpackage{longtable}{LT@makecaption}{%
  \PackageInfo{caption}{longtable package v3.15 (or newer) detected}%
%
% Original code:
% \def\LT@makecaption#1#2#3{%
%   \LT@mcol\LT@cols c{\hbox to\z@{\hss\parbox[t]\LTcapwidth{%
%     % Based on article class "\@makecaption", "#1" is "\@gobble" in star
%     % form, and "\@firstofone" otherwise.
%     \sbox\@tempboxa{#1{#2: }#3}%
%     \ifdim\wd\@tempboxa>\hsize
%       #1{#2: }#3%
%     \else
%       \hbox to\hsize{\hfil\box\@tempboxa\hfil}%
%     \fi
%     \endgraf\vskip\baselineskip}%
%   \hss}}}
%
  \def\LT@makecaption#1#2#3{%
%   \noalign{\vskip...}%
%
    \LT@mcol\LT@cols c{\hbox to\z@{\hss\parbox[t]\hsize{%
%
      \caption@letfloattype{longtable}{% bugfixed v3.0e
        \ifdim\LTcapwidth=4in \else
          \caption@setwidth\LTcapwidth
        \fi}%
%     \caption@setdefaultpos{t}% default = top
      \let\caption@defaultpos\@firstoftwo% default = top
      \def\caption@autoposition{% does not work within \end(last)foot!
        \caption@setposition{\ifcase\LT@rows t\else b\fi}}%
%
      \caption@begin{table}%
%
%       This skip has 2 purposes:
%       1. Correct the heigth of the \parbox[t]. Usual it's the height of
%          the very first line, but because of our extra skip it's always 0pt.
%       2. Correct \arraystretch, which usually also affect the longtable
%          caption. (If this is not requested, take \strutbox instead.)
%       NOTE: This is only a quick workaround, it has to be revised later on.
%
        \vskip-\ht\@arstrutbox
%
        \caption@iftop{\vskip\belowcaptionskip}{\vskip\abovecaptionskip}%
%       \let\caption@beginbox\caption@beginLTbox
        \caption@startrue#1\caption@starfalse
        \caption@@make{#2}{#3}\endgraf
        \caption@iftop{\vskip\abovecaptionskip}{\vskip\belowcaptionskip}%
      \caption@end}%
%
    \hss}}}%
%
}
%    \end{macrocode}
%
% \subsubsection*{rotating package support}
%
%    \begin{macrocode}
\caption@ifpackage{rotating}{@rotcaption}{%
  \PackageInfo{caption}{rotating package v2.0 (or newer) detected}%
%
  \let\caption@rot\rotcaption
  \def\rotcaption{\caption@caption\caption@rot}%
%
  \let\caption@@rot\@rotcaption
  \long\def\@rotcaption#1[#2]#3{%
    \caption@beginex{#1}{#2}%
      \caption@@rot{#1}[{#2}]{#3}%
    \caption@end}%
%
% Original code:
% \long\def\@makerotcaption#1#2{%
%   \setbox\@tempboxa\hbox{#1: #2}%
%   \ifdim \wd\@tempboxa > .8\vsize
%     \rotatebox{90}{%
%     \begin{minipage}{.8\textheight}#1: #2\end{minipage}%
%     }\par
%   \else%
%     \rotatebox{90}{\box\@tempboxa}%
%   \fi
%   \hspace{12pt}%
% }
%
  \long\def\@makerotcaption#1#2{%
    \rotatebox{90}{%
      \begin{minipage}{.8\textheight}%
        \caption@@make{#1}{#2}%
      \end{minipage}%
    }\par
    \hspace{12pt}}%
%
}
%    \end{macrocode}
%
% \subsubsection*{sidecap package support}
%
%    \begin{macrocode}
\caption@ifpackage{sidecap}{endSC@FLOAT}{%
  \PackageInfo{caption}{sidecap package v1.4d (or newer) detected}%
%
% First of all, we let sidecap use an actual definition of \caption:
% (This is only required for version 1.5d of the sidecap package.)
%
  \let\SC@caption=\caption
%
% Make \caption* and local settings (\captionsetup) work
%
  \let\caption@SC@zfloat\SC@zfloat
  \def\SC@zfloat#1#2#3[#4]{%
% #2 = `figure' or `table' => \SC@captype
    \caption@SC@zfloat{#1}{#2}{#3}[#4]%
%
    \global\let\SC@CAPsetup\@empty
    \def\captionsetup##1{\g@addto@macro\SC@CAPsetup{,##1}}%
%
    \let\caption@old\caption
%   \def\caption{\renewcommand\captionsetup[1]{}\caption@caption\caption@old}%
    \def\caption{\caption@caption\caption@old}%
  }%
%
% Before typesetting the caption, we set the captionmargin to zero
% because the extra margin is only disturbing here.
% (We don't need to take care about the caption position because
%  the sidecap package set both \abovecaptionskip and \belowcaptionskip
%  to a skip of zero anyway.)
% Furthermore \SC@justify will override the caption justification, if set.
%
% Very old version (1.4): \SC@justify is not defined
% Older versions (1.5): \SC@justify is \relax when not set
% Newer versions (1.6): \SC@justify is \@empty when not set
%
  \let\caption@endSC@FLOAT\endSC@FLOAT
  \def\endSC@FLOAT{%
%   (Note that \@captype isn't defined so far, this will be done inside
%    the original definition of \endSC@FLOAT.)
%   We set \@captype already here, so \captionsetup will
%   work with \@captype-based options, too. (new v3.0d)
    \let\@captype\SC@captype
    \caption@esetup\SC@CAPsetup
%
    \caption@letfloattype{SC\@captype}{% bugfixed v3.0e
      \caption@setmargin\z@
      \@ifundefined{SC@justify}{}{%
        \ifx\SC@justify\@empty\else
          \let\caption@hj\SC@justify
          \let\SC@justify\@empty
        \fi}}%
%
    \long\def\caption@ifempty##1{% bugfix v3.0e
      \ifx\SC@CAPtext\@empty
        \expandafter\@firstofone
      \else
        \expandafter\@gobble
      \fi}%
%
    \caption@endSC@FLOAT}%
%
}
%    \end{macrocode}
%
% \subsubsection*{supertabular package support}
%
%    \begin{macrocode}
\def\caption@setSTposition{%
  \caption@setposition{\if@topcaption t\else b\fi}}
%
\caption@ifpackage{supertabular}{ST@caption}{%
  \PackageInfo{caption}{supertabular package detected}%
%
% Improvement v3.0e: \topcaption* and \bottomcaption*
  \let\caption@tablecaption\tablecaption
  \def\tablecaption{\caption@caption\caption@tablecaption}%
%
% Original code:
% \long\def\ST@caption#1[#2]#3{\par%
%   \addcontentsline{\csname ext@#1\endcsname}{#1}%
%                   {\protect\numberline{%
%                       \csname the#1\endcsname}{\ignorespaces #2}}
%   \begingroup
%     \@parboxrestore
%     \normalsize
%     \if@topcaption \vskip -10\p@ \fi
%     \@makecaption{\csname fnum@#1\endcsname}{\ignorespaces #3}\par
%     \if@topcaption \vskip 10\p@ \fi
%   \endgroup}
%
  \let\caption@ST\ST@caption
  \long\def\ST@caption#1[#2]#3{\par%  bugfixed v3.0a
    \caption@letfloattype{supertabular}{}%
    \let\caption@fixposition\caption@setSTposition
    \caption@beginex{#1}{#2}%
      \addcontentsline{\csname ext@#1\endcsname}{#1}%
                      {\protect\numberline{%
                          \csname the#1\endcsname}{\ignorespaces #2}}%
      \@parboxrestore
      \normalsize
      \@makecaption{\csname fnum@#1\endcsname}{\ignorespaces #3}\par
    \caption@end}%
%
}
%    \end{macrocode}
%
% \iffalse
%</package>
% \fi
%
% \clearpage
% \Finale
%
\endinput
