path: root/Master/texmf-dist/doc/latex/caption/caption-deu.tex

%
% This is file `caption-deu.tex'.
%
% Copyright (C) 1994-2007 Axel Sommerfeldt (caption@sommerfee.de)
% 
% --------------------------------------------------------------------------
% 
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2003/12/01 or later.
% 
% This work has the LPPL maintenance status "maintained".
% 
% This Current Maintainer of this work is Axel Sommerfeldt.
% 
% This work consists of the files caption.ins, caption.dtx, caption2.dtx,
% and ltcaption.dtx, the derived files caption.sty, caption2.sty,
% caption3.sty, and ltcaption.sty, and the user manuals caption-deu.tex,
% caption-eng.tex, and caption-rus.tex.
% 
\NeedsTeXFormat{LaTeX2e}[1994/12/01]
\ProvidesFile{caption-deu.tex}[2007/10/02 v3.1c Das caption-Paket]
\hbadness=9999 \newcount\hbadness \hfuzz=20pt % Make TeX shut up.
%\errorcontextlines=3

\documentclass[a4paper]{ltxdoc}
\setlength\parindent{0pt}
\setlength\parskip{\medskipamount}

%%%\usepackage[T1]{fontenc}
\usepackage{ifpdf}
\ifpdf
  \usepackage{mathptmx,courier}
  \usepackage[scaled=0.90]{helvet}
  \addtolength\marginparwidth{15pt}
\fi

\usepackage[german]{babel}
\IfFileExists{selinput.sty}%
  {\usepackage{selinput}\SelectInputMappings{adieresis={ä},germandbls={ß}}}%
  {\usepackage[latin1]{inputenc}}
\usepackage{longtable,setspace}

\usepackage{hypdoc}\hypersetup{german}
\hypersetup{pdfkeywords={LaTeX, package, caption},pdfstartview={}}
\usepackage[listof=0,hypcap=false]{caption}[2007/09/01]

\DeclareRobustCommand*\eTeX{\texorpdfstring
  {\leavevmode\hbox{$\varepsilon$}-\TeX}%
  {e-TeX}}
\DeclareRobustCommand*\AmS{\texorpdfstring
  {{\protect\usefont{OMS}{cmsy}{m}{n}A\kern-.1667em\lower.5ex\hbox{M}\kern-.125emS}}%
  {AMS}}
\DeclareRobustCommand*\KOMAScript{\texorpdfstring
  {\textsf{K\kern.05em O\kern.05em M\kern.05em A\kern.1em-\kern.1em Script}}%
  {KOMA-Script}}
\DeclareRobustCommand*\NTG{NTG}
\DeclareRobustCommand*\SmF{SMF}

\newcommand\NEW[2]{\hskip 1sp \marginpar{\footnotesize\sffamily\raggedleft#1\\#2}}

\usepackage{marvosym}
\makeatletter
\newcommand*\INFO{\@ifstar{\@INFO{}}{\@INFO{\vbox to \ht\strutbox}}}
\newcommand*\@INFO[1]{\MARGINSYM{#1{\Huge\Info}}}
\makeatother
\font\manual=manfnt
\newcommand*\DANGER{\MARGINSYM{\manual\char127}}
\newcommand*\MARGINSYM[1]{\hskip 1sp \marginpar{\raggedleft\textcolor{blue}{{#1}}}}

\DeclareCaptionFormat{myformat1}{#1#2\\#3}
\newlength\myindention
\DeclareCaptionFormat{myformat2}{#1#2\\\hspace*\myindention#3}
\DeclareCaptionOption{myindention}{\setlength\myindention{#1}}
\DeclareCaptionFormat{reverse}{#3#2#1}
\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}
\DeclareCaptionLabelFormat{fullparens}{(\bothIfFirst{#1}{~}#2)}
\DeclareCaptionLabelSeparator{fill}{\hfill}

\newcommand*\purerm[1]{{\upshape\mdseries\rmfamily #1}}
\newcommand*\puresf[1]{{\upshape\mdseries\sffamily #1}}
\newcommand*\purett[1]{{\upshape\mdseries\ttfamily #1}}
\let\package\puresf
\let\env\purett \let\opt\purett

\newcommand*\csmarg[1]{\texttt{\char`\{#1\char`\}}}
\newcommand*\csoarg[1]{\texttt{\char`\[#1\char`\]}}
\newcommand*\version[2][]{$v#2$}
\newcommand*\x{\discretionary{-}{}{}}
\newcommand*\xx{\discretionary{}{}{}}

\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}

\makeatletter
\newcommand\example{\@ifstar
  {\@example{belowskip=\abovecaptionskip}}%
  {\@example{}}}
\def\@example#1{%
  \@testopt{\@@example{#1}}{figure}}
\long\def\@@example#1[#2]#3#4{%
  \begingroup
    \captionsetup{#1,size=small,margin={\leftmargini,10pt},#3}%
    \captionof{#2}[]{#4}%
  \endgroup}
\makeatother

\begin{document}
\let\subsectionautorefname\sectionautorefname
\let\subsubsectionautorefname\sectionautorefname

\def\thispackage{das \package{caption}"=Paket}
\def\Thispackage{Das \package{caption}"=Paket}

\newcommand\NEWfeature{\NEW{Neues Feature}}
\newcommand\NEWdescription{\NEW{Neue Beschreibung}}

\makeatletter
\newcommand*\Ref{\@ifstar{\@Ref\ref}{\@Ref\autoref}}
\newcommand*\@Ref[2]{#1{#2}: \textit{"`\nameref{#2}"'}}
\makeatother
\newcommand*\See[1]{{\small (Siehe #1)}}
\newcommand*\SeeUserDefined[1][]{\See{\Ref{declare}#1}}

\def\TODO{\emph{-- Hier fehlt noch 'was --}}

% --------------------------------------------------------------------------- %

\GetFileInfo{caption-deu.tex}
\let\docdate\filedate
\GetFileInfo{caption.sty}

\title{Setzen von Abbildungs- und Tabellenbeschriftungen mit dem
       caption-Paket\texorpdfstring{\thanks{%
         Dieses Paket hat die Versionsnummer \fileversion,
         zuletzt ge"andert am \filedate.}}{}}
\author{Axel Sommerfeldt\\
        \href{mailto:caption@sommerfee.de}{\texttt{caption@sommerfee.de}}}
\date{\docdate}
\maketitle

% --------------------------------------------------------------------------- %

\begin{abstract}
\Thispackage\ bietet einem Mittel und Wege das Erscheinungsbild der
Bildunterschriften und Tabellen"uberschriften den eigenen W"unschen
bzw.\ bestimmten Vorgaben anzupassen.
Hierbei wurde viel Wert auf die reibungslose Zusammenarbeit und in die
Integration anderer Dokumentenklassen und Pakete gelegt.\footnote{F"ur die
Version 3.0 dieses Paketes wurde die Benutzerschnittstelle zusammen
mit Steven D. Cochran und Frank Mittelbach komplett "uberarbeitet.}
\end{abstract}

\newcommand\exampletext{%
  Die auf die Rotationsfrequenz des Innenzylinders normierten Eigenfrequenzen
  der gefundenen Grundmoden der Taylor"=Str"omung f"ur \mbox{$\eta = 0.5$}. %\\
  (Die azimutale Wellenzahl ist mit $m$ bezeichnet.)}

% --------------------------------------------------------------------------- %

\section*{Einleitung}

Mit |\caption| gesetzte Bildunterschriften und Tabellenüberschriften werden
von den Standard"=Dokumentenklassen eher stiefmütterlich behandelt.
In der Regel schlicht als ganz normaler Absatz gesetzt, ergibt sich keine
signifikante optische Abgrenzung vom eigentlichen Text, wie z.B. hier:

\example*{size=normalsize,margin=0pt}{\exampletext}

Es sollte aber eine Möglichkeit geben, diesem Umstand abzuhelfen. Es wäre
zum Beispiel nett, wenn man den Text der Unterschrift etwas kleiner gestalten,
extra Ränder festlegen oder den Zeichensatz des Bezeichners dem der
Kapitelüberschriften anpassen könnte. So in etwa:

\example*{size=small,margin=10pt,labelfont=bf,labelsep=endash}{\exampletext}

Mit Hilfe dieses Paketes können Sie dies leicht bewerkstelligen; es sind viele
vorgegebene Parameter einstellbar, Sie können aber auch eigene
Gestaltungsmerkmale einfließen lassen.

% --------------------------------------------------------------------------- %

\clearpage
\section*{Vorläufige Dokumentation}

Diese Anleitung ist leider teilweise inkonsistent und insbesondere noch nicht
fertiggestellt.
Ich werde mich bemühen, sie in den nächsten Monaten zu vervollständigen;
die aktuelle Interimsversion kann immer
\href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/caption/caption-eng.pdf}%
{hier} bezogen werden.\par\bigskip

% --------------------------------------------------------------------------- %

%\clearpage
\tableofcontents

% --------------------------------------------------------------------------- %

\clearpage
\section{Verwendung des Paketes}
\label{usage}

\DescribeMacro{\usepackage}
Mittels
\begin{quote}
  |\usepackage|\oarg{Optionen}|{caption}[|\texttt{\filedate}|]|
\end{quote}
in dem Vorspann des Dokumentes wird das \thispackage\ Paket eingebunden, die
Optionen legen hierbei das Aussehen der "Uber- und Unterschriften fest. So
w"urde z.B.
\begin{quote}
  |\usepackage[margin=10pt,font=small,labelfont=bf,|\\
  |            labelsep=endash]{caption}|%
  %|[|\texttt{\filedate}|]|
\end{quote}
zu dem obrigen Ergebnis mit Rand, kleinerem Zeichensatz und fetter Bezeichnung
f"uhren.

\DescribeMacro{\captionsetup}
Eine "Anderung der Parameter ist auch zu einem sp"ateren Zeitpunkt jederzeit
mittels des Befehls
\begin{quote}
  |\captionsetup|\oarg{Typ}\marg{Optionen}
\end{quote}
m"oglich. So sind z.B. die Befehlssequenzen
\begin{quote}
  |\usepackage[margin=10pt,font=small,labelfont=bf]{caption}|
\end{quote}
und
\begin{quote}
  |\usepackage{caption}|\\
  |\captionsetup{margin=10pt,font=small,labelfont=bf}|
\end{quote}
in ihrer Wirkung identisch.

Weiterhin gilt zu beachten, da"s sich die Verwendung von |\captionsetup|
innerhalb von Umgebungen nur auf die Umgebung selber auswirkt, nicht aber auf
den Rest des Dokumentes. M"ochte man also z.B. die automatische Zentrierung der
Abbildungsunterschrift nur in einem konkreten Falle ausschalten, so kann dies
mit
\begin{quote}
  |\begin{figure}|\\
  |  |\ldots\\
  |  \captionsetup{singlelinecheck=off}|\\
  |  \caption{|\ldots|}|\\
  |\end{figure}|
\end{quote}
geschehen, ohne da"s die restlichen Abbildungsunterschriften hiervon
beeintr"achtigt werden.

(Der optionale Parameter \meta{Typ} wird in \Ref{commands} behandelt.)

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Optionen}
\label{options}

\def\OptionLabel{RaggedRight}
\def\UserDefined{\ldots}

% --------------------------------------------------------------------------- %

\subsection{Formatierung}
\label{formats}

\DescribeMacro{format=}
Eine Abbildungs- oder Tabellenbeschriftung besteht im wesentlichen aus drei
Teilen:
Dem Bezeichner (etwa "`Abbildung 3"'), dem Trenner
(etwa "`:\textvisiblespace"') und dem eigentlichen Text.
Mittels der Option
\begin{quote}
  |format=|\meta{Name}
\end{quote}
wird festgelegt, wie diese drei Teile zusammengesetzt werden.
F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar:%\footnote{Es gibt
%hier wie auch bei vielen anderen Optionen die M"oglichkeit, auch eigene
%Formate, Zeichens"atze etc.\ zu definieren. Wie dies geht wird in Abschnitt
%\ref{declare}: \textit{"`Eigene Erweiterungen"'} dargelegt.}

\begin{Options}{\OptionLabel}
  \item[plain]%\NEWdescription{v3.0h}
  Die Beschriftung wird als gew"ohnlicher Abschnitt gesetzt.

  \item[hang]
  Der Text wird so gesetzt, da"s er an dem Bezeichner "`h"angt"', d.h.~der
  Platz unter dem Bezeichner und dem Trenner bleibt leer.

  \item[\UserDefined]
  Eigene Formate k"onnen mittels |\DeclareCaptionFormat| definiert werden.
  \SeeUserDefined
\end{Options}

\begin{Example}
  Ein Beispiel: Die Angabe der Option
  \begin{quote}
    |format=hang|
  \end{quote}
  f"uhrt zu Abbildungsunterschriften der Art
  \example{format=hang}{\exampletext}
\end{Example}

\DescribeMacro{indention=}
Bei beiden Formaten (\texttt{plain} und \texttt{hang}) kann der Einzug der Beschriftung
ab der zweiten Textzeile angepasst werden, dies geschieht mit Hilfe der Option
\begin{quote}
  |indention=|\meta{Einzug}\quad,
\end{quote}
wobei anstelle von \meta{Einzug} jedes beliebige feste Ma"s angegeben werden kann.

Zwei Beispiele:

\begin{Example}
  \begin{quote}
    |format=plain,indention=.5cm|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{format=plain,indention=.5cm}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |format=hang,indention=-0.5cm|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{format=hang,indention=-0.5cm}{\exampletext}
\end{Example}

%\pagebreak[3]
\DescribeMacro{labelformat=}
Mittels der Option
\nopagebreak[3]
\begin{quote}
  |labelformat=|\meta{Name}
\end{quote}
\nopagebreak[3]
%\NEWdescription{v3.0e}
wird die Zusammensetzung des Bezeichners festgelegt.
F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar:

\begin{Options}{\OptionLabel}
  \item[default]
  Der Bezeichner wird wie von der verwendeten Dokumentenklasse vorgegeben gesetzt,
  "ublicherweise ist dies der Name und die Nummer, getrennt durch ein Leerzeichen
  (wie \texttt{simple}).
  (Dies ist das Standardverhalten.)

  \item[empty]
  Der Bezeichner ist leer. (Diese Option macht in der Regel nur in Verbindung mit
  anderen Optionen -- wie etwa \texttt{labelsep=none} -- Sinn.)

  \item[simple]
  Der Bezeichner ist aus dem Namen und der Nummer zusammengesetzt.

  \item[parens]
  Die Nummer des Bezeichners wird in runde Klammern gesetzt.

  \item[\UserDefined]
  Eigene Formate k"onnen mittels |\DeclareCaptionLabelFormat| definiert werden.
  \SeeUserDefined
\end{Options}

\begin{Example}
  Ein Beispiel: Die Optionen
  \begin{quote}
    |labelformat=parens,labelsep=quad|
  \end{quote}
  f"uhren zu Abbildungsunterschriften der Art
  \example{labelformat=parens,labelsep=quad}{\exampletext}
\end{Example}

\DescribeMacro{labelsep=}
Mittels der Option
\begin{quote}
  |labelsep=|\meta{Name}
\end{quote}
wird die Zusammensetzung des Trenners festgelegt.
F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar:

\begin{Options}{\OptionLabel}
  \item[none]
  Der Trenner ist leer. (Diese Option macht in der Regel nur in Verbindung
  mit anderen Optionen -- wie etwa \texttt{labelformat=empty} -- Sinn.)

  \item[colon]
  Der Trenner besteht aus einem Doppelpunkt und einem Leerzeichen.

  \item[period]
  Der Trenner besteht aus einem Punkt und einem Leerzeichen.

  \item[space]
  Der Trenner besteht lediglich aus einem einzelnen Leerzeichen.

  \item[quad]
  Der Trenner besteht aus einem |\quad|.

  \item[newline]
  Als Trenner wird ein Zeilenumbruch verwendet.

  \item[endash]%\NEWfeature{v3.0h}
  Als Trenner wird ein Gedankenstrich verwendet.

  \item[\UserDefined]
  Eigene Trenner k"onnen mittels |\DeclareCaptionLabelSeparator| definiert werden.
  \SeeUserDefined
\end{Options}

Drei Beispiele:
\begin{Example}
  \begin{quote}
    |labelsep=period|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{labelsep=period}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |labelsep=newline,singlelinecheck=false|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{labelsep=newline,singlelinecheck=false}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |labelsep=endash|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{labelsep=endash}{\exampletext}
\end{Example}

% --------------------------------------------------------------------------- %

\subsection{Textausrichtung}
\label{justification}

\DescribeMacro{justification=}
Mittels der Option
\begin{quote}
  |justification=|\meta{Name}
\end{quote}
wird die Ausrichtung des Textes festgelegt.
F"ur \meta{Name} sind folgende M"oglichkeiten verf"ugbar:

\begin{Options}{\OptionLabel}
  \item[justified]
  Der Text wird als Blocksatz gesetzt.

  \item[centering]
  Der Text wird zentriert gesetzt.

%  \item[Centering]
%  Der Text wird zentriert gesetzt. Hierf"ur wird jedoch im Gegensatz
%  zu \texttt{centering} der Befehl |\Centering| des \package{ragged2e}-Paketes
%  verwendet, der \LaTeX\ das Trennen der Worte erlaubt.

  \item[centerlast]
  Lediglich die letzte Zeile des Textes wird zentriert gesetzt.

  \item[centerfirst]
  Lediglich die erste Zeile des Textes wird zentriert gesetzt.

  \item[raggedright]
  Der Text wird linksb"undig gesetzt.

%  \item[RaggedRight]
%  Der Text wird linksb"undig mit Hilfe des \package{ragged2e}-Paketes gesetzt.
  \item[RaggedRight]
  Der Text wird ebenfalls linksb"undig gesetzt. Hierf"ur wird jedoch im Gegensatz
  zu \texttt{raggedright} der Befehl |\RaggedRight| des \package{ragged2e}-Paketes
  verwendet, der \LaTeX\ das Trennen der Worte erlaubt.

  \item[raggedleft]
  Der Text wird rechtsb"undig gesetzt.

%  \item[RaggedLeft]
%  Der Text wird rechtsb"undig mit Hilfe des \package{ragged2e}-Paketes gesetzt.

  \item[\UserDefined]
  Eigene Ausrichtungen k"onnen mittels |\DeclareCaptionJustification| definiert werden.
  \SeeUserDefined
\end{Options}

Einige Beispiele:
\begin{Example}
  \begin{quote}
    |justification=centerlast|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{justification=centerlast}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |format=hang,justification=raggedright|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{format=hang,justification=raggedright}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |format=hang,justification=RaggedRight|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{belowskip=\abovecaptionskip,format=hang,justification=RaggedRight}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |labelsep=newline,justification=centering|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{belowskip=\abovecaptionskip,labelsep=newline,justification=centering}{\exampletext}
\end{Example}

\DescribeMacro{singlelinecheck=}
In den Standard"=Dokumentenclassen |article|, |report| und |book| sind die
Ab\-bildungs- und Tabellenbeschriftungen so realisiert, da"s sie automatisch
zentriert werden, wenn sie lediglich aus einer einzigen Textzeile bestehen:

\example*{}{Eine kurze Beschriftung.}

%\example{belowskip=\abovecaptionskip}{%
% Eine lange Beschriftung, die gen"ugend Text enth"alt, um l"anger als
% eine einzelne Zeile zu sein.}

\INFO
Diesen Mechanismus "ubernimmt \thispackage\ und ignoriert damit
in der Regel bei solch kurzen Beschriftungen die mittels der Optionen
|justification=| und |indention=| eingestellte Textausrichtung.
Dieses Verhalten kann jedoch mit der Option
\begin{quote}
  |singlelinecheck=|\meta{bool}
\end{quote}
reguliert werden. Setzt man f"ur \meta{bool} entweder |false|, |no|, |off|
oder |0| ein, so wird der Zentrierungsmechnismus au"ser Kraft gesetzt.
Die obrige, kurze Abbildungsunterschrift w"urde z.B. nach Angabe der Option
\begin{quote}
  |singlelinecheck=false|
\end{quote}
so aussehen:

\begingroup
  \captionsetup{type=figure}
  \ContinuedFloat
  \example*{singlelinecheck=false}{Eine kurze Beschriftung.}
\endgroup

Setzt man f"ur \meta{bool} hingegen |true|, |yes|, |on| oder |1| ein, so
wird die automatische Zentrierung wieder eingeschaltet. (Standardm"a"sig
ist sie eingeschaltet.)

% --------------------------------------------------------------------------- %

\subsection{Zeichens"atze}
\label{fonts}

\DescribeMacro{font=}
\DescribeMacro{labelfont=}
\DescribeMacro{textfont=}
Das \thispackage-Paket kennt 3 Zeichens"atze: Denjenigen f"ur die gesammte Beschriftung
(|font|), denjenigen, der lediglich auf den Bezeichner und den Trenner angewandt wird
(|labelfont|), sowie denjenigen, der lediglich auf den Text wirkt (|textfont|).
So lassen sich die unterschiedlichen Teile der Beschriftung individuell mittels
\begin{quote}\begin{tabular}{@{}r@{}ll}
  |font=|      & \marg{Zeichensatzoptionen} & ,\\
  |labelfont=| & \marg{Zeichensatzoptionen} & und\\
  |textfont=|  & \marg{Zeichensatzoptionen} & \\
\end{tabular}\end{quote}
\nopagebreak[3]
anpassen.
\pagebreak[3]

Als \meta{Zeichensatzoptionen} sind eine Kombination aus folgendem erlaubt:

\begin{Options}{\OptionLabel}
  \item[scriptsize]   {\scriptsize Sehr kleine Schrift}
  \item[footnotesize] {\footnotesize Fu"snotengr"o"se}
  \item[small]        {\small Kleine Schrift}
  \item[normalsize]   {\normalsize Normalgro"se Schrift}
  \item[large]        {\large Gro"se Schrift}
  \item[Large]        {\Large Gr"o"sere Schrift}

  \item[up]           {\upshape Upright Schriftart}
  \item[it]           {\itshape Italic Schriftart}
  \item[sl]           {\slshape Slanted Schriftart}
  \item[sc]           {\scshape Small Caps Schriftart}

  \item[md]           {\mdseries Medium Schriftserie}
  \item[bf]           {\bfseries Bold Schriftserie}

  \item[rm]           {\rmfamily Roman Schriftfamilie}
  \item[sf]           {\sffamily Sans Serif Schriftfamilie}
  \item[tt]           {\ttfamily Typewriter Schriftfamilie}

  \item[singlespacing]  |\singlespacing| (siehe \package{setspace}-Paket)
  \item[onehalfspacing] |\onehalfspacing|
  \item[doublespacing]  |\doublespacing|

  \item[\UserDefined]
  Eigene Zeichensatzoptionen k"onnen mittels |\DeclareCaptionFont| definiert werden.
  \SeeUserDefined
\end{Options}

Wird lediglich eine einzelne Zeichensatzoption ausgew"ahlt, k"onnen die
geschweiften Klammern entfallen, d.h.~die Optionen
%\begin{quote}
  |font={small}|
%\end{quote}
und
%\begin{quote}
  |font=small|
%\end{quote}
sind in ihrer Wirkung identisch.

Beispiele:
\begin{Example}
  \begin{quote}
    |font={small,it},labelfont=bf|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{font={small,it},labelfont=bf}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |font=small,labelfont=bf,textfont=it|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{font=small,labelfont=bf,textfont=it}{\exampletext}
\end{Example}

% --------------------------------------------------------------------------- %

\subsection{R"ander und Abs"atze}
\label{margins}

\DescribeMacro{margin=}
\DescribeMacro{width=}
F"ur die Abbildungs- und Tabellenbeschriftungen kann \emph{entweder} ein extra Rand
\emph{oder} eine feste Breite festgelegt werden. Dies geschieht mit
\begin{quote}\begin{tabular}{@{}r@{}ll}
  |margin=| & \meta{Rand} & \emph{oder}\\
  |width=|  & \meta{Breite} & \\
\end{tabular}\end{quote}
In beiden F"allen wird die Beschriftung zentriert, d.h.~der linke und rechte Rand
sind immer gleich gro"s.

Zwei Beispiele hierzu:
\begin{Example}
  \begin{quote}
    |margin=10pt|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{margin=10pt}{\exampletext}
\end{Example}

\begin{Example}
  \begin{quote}
    |width=.75\textwidth|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{width=.75\textwidth}{\exampletext}
\end{Example}

\DescribeMacro{parskip=}
Diese Option wirkt auf Abbildungs- oder Tabellenbeschriftungen, die
aus mehr als einem Absatz bestehen; sie legt den Abstand zwischen den
Abs"atzen fest.
\begin{quote}
  |parskip=|\meta{Abstand zwischen Abs"atzen}
\end{quote}
Ein Beispiel:
\begin{Example}
  \begin{quote}
    |margin=10pt,parskip=5pt|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{margin=10pt,parskip=5pt}{%
    Erster Absatz der Beschriftung; dieser enth"alt einigen Text, so da"s die
    Auswirkungen der Optionen deutlich werden.\par
    Zweiter Absatz der Beschriftung; dieser enth"alt ebenfalls einigen Text,
    so da"s die Auswirkungen der Optionen deutlich werden.}
\end{Example}

\DescribeMacro{hangindent=}
Die Option
\begin{quote}
  |hangindent=|\meta{Einzug}
\end{quote}
legt einen Einzug f"ur alle Zeilen au"ser der jeweils ersten des Absatzes fest.
Besteht die Beschriftung lediglich aus einem einzelnen Absatz, so ist die
Wirkung mit der Option |indention=|\meta{Einzug} identisch, bei mehreren
Abs"atzen zeigt sich jedoch der Unterschied:

\begin{Example}
  \begin{quote}
    |format=hang,indention=-.5cm|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{format=hang,indention=-.5cm}{%
    Erster Absatz der Beschriftung; dieser enth"alt einigen Text, so da"s die
    Auswirkungen der Optionen deutlich werden.\par
    Zweiter Absatz der Beschriftung; dieser enth"alt ebenfalls einigen Text,
    so da"s die Auswirkungen der Optionen deutlich werden.}
\end{Example}

\begin{Example}
  \begin{quote}
    |format=hang,hangindent=-.5cm|
  \end{quote}
  \captionsetup{aboveskip=0pt}
  \example{format=hang,hangindent=-.5cm}{%
    Erster Absatz der Beschriftung; dieser enth"alt einigen Text, so da"s die
    Auswirkungen der Optionen deutlich werden.\par
    Zweiter Absatz der Beschriftung; dieser enth"alt ebenfalls einigen Text,
    so da"s die Auswirkungen der Optionen deutlich werden.}
\end{Example}

% --------------------------------------------------------------------------- %

\subsection{Stile}
\label{style}

\DescribeMacro{style=}
Eine geeignete Kombination aus den bisher vorgestellten Optionen wird \textit{Stil}
genannt; dies ist in etwa mit dem Seitenstil vergleichbar, den man bekannterma"sen
mit |\pagestyle| einstellen kann.

Einen vordefinierten Abbildungs- und Tabellenbeschriftungsstil kann man mit der
Option
\begin{quote}
  |style=|\meta{Stil}
\end{quote}
ausw"ahlen. \Thispackage\ definiert zwei Stile: |base| und |default|.

\NEWfeature{v3.1}
Der Stil |base| setzt alle bisher vorgestellten Optionen auf die Belegung
zurück, die das Aussehen der Beschriftungen der Standard"=\LaTeX"=Dokumentenklassen
|article|, |report| und |book| repräsentiert. D.h.~die Angabe der Option
\begin{quote}
  |style=default|
\end{quote}
entspricht den Optionen
\begin{quote}
  |format=plain,labelformat=default,labelsep=colon,|\\
  |justification=justified,font=,labelfont=,|\\
  |textfont=,margin=0pt,indention=0pt,parindent=0pt|\\
  |hangindent=0pt,singlelinecheck=true|
\end{quote}
{\small(Aber |justification=centering,indention=0pt| wird automatisch
 gewählt werden, wenn die Beschriftung in eine einzelne Zeile passt.)}

Der Stil |default| hingegen folgt den Standardwerten der verwendeten
Dokumentenklasse. Dieser Stil wird vorausgewählt und entspricht den
Optionen
\begin{quote}
  |format=default,labelformat=default,labelsep=default,|\\
  |justification=default,font=default,labelfont=default,|\\
  |textfont=default,margin=0pt,indention=0pt,parindent=0pt|\\
  |hangindent=0pt,singlelinecheck=true|\quad.
\end{quote}
{\small(Aber |justification=centering,indention=0pt| wird ebenso automatisch
 gewählt werden, wenn die Beschriftung in eine einzelne Zeile passt.)}

Wenn also eine der drei Standard"=\LaTeX"=Dokumentenklassen verwendet wird,
zeigen |base| und |default| auf (fast) die gleichen Einstellungen.

{\small\emph{Hinweis:} Eigene Stile k"onnen mittels |\DeclareCaptionStyle|
 definiert werden. \SeeUserDefined}

% --------------------------------------------------------------------------- %

\subsection{Abst"ande}
\label{skips}

\DescribeMacro{aboveskip=}
\DescribeMacro{belowskip=}
Die vertikalen Abstände vor und nach der Beschriftung werden von
|\abovecaptionskip| und |\belowcaptionskip| kontrolliert.
Die Standard"=\LaTeX"=Klassen |article|, |report| und |book| belegen den
Abstand |\abovecaptionskip| mit |10pt| und |\belowcaptionskip| mit |0pt|,
andere Dokumentenklassen ggf.~ mit anderen Werten.

\pagebreak[3]
Beide Abst"ande lassen sich gew"ohnlich mit |\setlength| "andern, aber auch mit den
\thispackage-Optionen
\nopagebreak[3]
\begin{quote}\begin{tabular}{@{}r@{}ll}
  |aboveskip=| & \meta{Abstand nach oben}  & und\\
  |belowskip=| & \meta{Abstand nach unten} & .\\
\end{tabular}\end{quote}

\DescribeMacro{position=}
Die sture Anwendung von |\abovecaptionskip| und |\belowcaptionskip| bei
Beschriftungen birgt einen gro"sen Nachteil: Ist die Beschriftung \emph{"uber}
und nicht \emph{unter} der Abbildung oder Tabelle (wie bei Tabellen durchaus
"ublich), so ist die Vorbelegung dieser beiden Abst"ande nicht mehr sinnvoll,
da hier kein Abstand zwischen der Beschriftung und der Tabelle gesetzt wird.
(Wir erinnern uns: |\belowcaptionskip| ist auf |0pt|, also kein Abstand,
vorbelegt.)

Man vergleiche:
\begin{Example}
  \captionsetup{position=b}
  \begin{minipage}[c]{.5\linewidth}%
%   \captionsetup{aboveskip=0pt}%
    \captionof{table}{Eine Tabelle}%
    \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}{Eine Tabelle}%
  \end{minipage}%
\end{Example}

Mit Hilfe des Parameters |position| kann man jedoch festlegen, wie
\LaTeX\ die Beschriftung behandeln soll, ob als \mbox{\emph{"Uber}schrift}
oder als \mbox{\emph{Unter}schrift}:
\begin{quote}
  |position=top|\quad(oder |position=above|)
\end{quote}
gibt an, da"s die Abst"ande so gew"ahlt werden, da"s sie f"ur \mbox{\emph{"Uber}schriften}
sinnvoll gew"ahlt sind und
\begin{quote}
  |position=bottom|\quad(oder |position=below|)
\end{quote}
gibt an, da"s die Abst"ande so gew"ahlt werden, da"s sie f"ur \mbox{\emph{"Uber}schriften}
sinnvoll gew"ahlt sind. (Dies ist die Standardeinstellung, allerdings nicht f"ur |longtable|s.)

F"ugt man nun ein |\captionsetup{position=top}| in die linke Tabelle vor dem
|\caption| Befehl ein, so ergeben sich im Vergleich zwischen "Uberschrift und
Unterschrift stimmige Abst"ande:
\begin{Example}
  \begin{minipage}[c]{.5\linewidth}%
    \captionsetup{position=t}%
    \captionof{table}{Eine Tabelle}%
    \centering\begin{tabular}{ll}%
      A & B \\%
      C & D \\%
    \end{tabular}%
  \end{minipage}%
  \begin{minipage}[c]{.5\linewidth}%
    \centering\begin{tabular}{ll}%
      A & B \\%
      C & D \\%
    \end{tabular}%
    \captionsetup{position=b}
    \captionof{table}{Eine Tabelle}%
  \end{minipage}%
\end{Example}

(Technisch ist dies so realisiert, da"s bei "Uberschriften die Ab\-st"an\-de
|\abovecaptionskip| und |\belowcaptionskip| vertauscht werden, so da"s
|\abovecaptionskip| immer derjenige Abstand ist, der zwischen Tabelle
und Beschriftung zur Anwendung kommt.)

Sinnvoll l"a"st sich diese Option insbesondere zusammen mit dem optionalen
Parameter bei |\captionsetup| anwenden: \See{auch \Ref{commands}}
\begin{quote}
  |\captionsetup[table]{position=top}|
\end{quote}
bewirkt, da"s bei allen Tabellen die Beschriftung bzgl.~der Abst"ande als
"Uberschrift behandelt wird.
\DescribeMacro{tableposition=}%\NEWfeature{v3.0a}
Da dies eine sehr gebr"auchliche Einstellung ist,
stellt das \thispackage"=Paket diesen Befehl auch als abk"urzende Option f"ur
|\usepackage| zur Verf"ugung:
\begin{quote}
  |\usepackage[|\ldots|,tableposition=top]{caption}|
\end{quote}
entspricht
\begin{quote}
  |\usepackage[|\ldots|]{caption}|\\
  |\captionsetup[table]{position=top}|
\end{quote}

% --------------------------------------------------------------------------- %

\pagebreak[3]
\section{Befehle}
\label{commands}

\DescribeMacro{\caption}
Der Befehl
\nopagebreak[3]
\begin{quote}
  |\caption|\oarg{Kurzform f"ur das Verzeichnis}\marg{Beschriftung}
\end{quote}
\nopagebreak[3]
erzeugt eine "Uber- bzw.~Unterschrift innerhalb einer gleitenden Umgebung
wie |figure| oder |table|. Dies ist an sich nichts neues, neu ist allerdings,
da"s kein Eintrag ins Abbildungs- oder Tabellenverzeichnis vorgenommen
wird, wenn eine leere Kurzform angegeben wird, etwa so:
\begin{quote}
  |\caption[]{Dies ist eine Abbildung, die nicht ins|\\
  |           Abbildungsverzeichnis aufgenommen wird}|
\end{quote}

\DescribeMacro{\caption*}
Das \package{longtable}-Paket definiert zus"atzlich zum Befehl |\caption| auch
den Befehl |\caption*|, der eine Beschriftung ohne Bezeichner und ohne Eintrag
ins Tabellenverzeichnis erzeugt. So erzeugt z.B. der Code
\begin{quote}
  |\begin{longtable}{cc}|\\
  |  \caption*{Eine Tabelle}\\|\\
  |  A & B \\|\\
  |  C & D \\|\\
  |\end{longtable}|
\end{quote}
diese Tabelle:
\begin{longtable}{cc}
  \caption*{Eine Tabelle}\\
  A & B \\
  C & D \\
\end{longtable}

\Thispackage\ bietet diesen Mechanismus auch f"ur normale Abbildungs-
und Tabellenbeschriftungen an. Ein Beispiel:
\begin{quote}
  |\begin{table}|\\
  |  \caption*{Eine Tabelle}|\\
  |  \begin{tabular}{cc}|\\
  |    A & B \\|\\
  |    C & D \\|\\
  |  \end{tabular}|\\
  |\end{table}|
\end{quote}

\DescribeMacro{\captionof}
\DescribeMacro{\captionof*}
Der Befehl |\caption| funktioniert in der Regel nur innerhalb von gleitenden
Umgebungen, manchmal m"ochte man ihn jedoch auch anderweitig anwenden,
etwa um eine Abbildung in eine nicht-gleitende Umgebung wie |minipage| zu
setzen.

\pagebreak[2]
Hierf"ur stellt \thispackage\ den Befehl
\begin{quote}
  |\captionof|\marg{Umgebungstyp}\oarg{Kurzform}\marg{Langform}
\end{quote}
zur Verf"ugung. Die Angabe des Umgebungstypen ist hierbei notwendig, damit der
gew"unschte Bezeichner gew"ahlt wird und der Eintrag in das richtige Verzeichnis
vorgenommen wird. Ein Beispiel:
\begin{quote}
  |\captionof{figure}{Abbildung}|\\
  |\captionof{table}{Tabelle}|
\end{quote}
f"uhrt zu folgendem Ergebnis:
\begin{Example}
  \captionof{figure}{Abbildung}
  \captionsetup{belowskip=\abovecaptionskip}
  \captionof{table}{Tabelle}
\end{Example}

Analog zu |\caption*| gibt es auch den Befehl |\captionof*| f"ur Beschriftungen
ohne Bezeichner und ohne Verzeichniseintrag.

\DANGER % \NEWdescription{v3.1}
Beide Befehle, sowohl |\captionof| als auch |\captionof*|, sollten nur
\emph{innerhalb} von Umgebungen (wie |minipage| oder |\parbox|) angewandt werden;
ansonsten hat dies einen \LaTeX"=Fehler zur Folge.\footnote{%
Nur wenn \eTeX\ zum Einsatz kommt. Ansonsten gibt es zwar keine Fehlermeldung,
aber es kann passieren, da"s \LaTeX\ zwischen dem Inhalt und der
Beschreibung einen Seitenumbruch setzt; zum anderen kann es bei Mi"sachtung gar
zu seltsamen Effekten und unerwünschten Formatierungen der folgenden
Abbildungs- und Tabellenbeschriftungen kommen!}

\DescribeMacro{\captionsetup}
Den Befehl |\captionsetup| haben wir ja schon im \Ref{usage} kennengelernt,
uns dort allerdings die Bedeutung des optionalen Parameters
\meta{Typ} aufgespart. %Dies soll nun nachgeholt werden:

Wir erinnern uns, die Syntax des Befehls lautet
\begin{quote}
  |\captionsetup|\oarg{Typ}\marg{Optionen}
\end{quote}

Wird hierbei ein \meta{Typ} angegeben, so werden die Optionen nicht
unmittelbar umgesetzt, sondern werden lediglich vermerkt und kommen erst dann
zum Einsatz, wenn eine "Uber- bzw.\ Unterschrift innerhalb des passenden
gleitenden Umgebungstyps gesetzt wird. So wirkt sich z.B. die Angabe
\begin{quote}
  |\captionsetup[figure]|\marg{Optionen}
\end{quote}
lediglich auf die Unterschriften aus, die innerhalb einer |figure|"=Umgebung
gesetzt werden.

Ein Beispiel:
\begin{quote}
  |\captionsetup{font=small}|\\
  |\captionsetup[figure]{labelfont=bf}|
\end{quote}
f"uhrt zu Abbildungs- und Tabellenunterschriften der Art:
\begin{Example}
  \captionsetup{font=small}
  \captionsetup[figure]{labelfont=bf}
  \begingroup
    \captionof{figure}{Eine Abbildung}
  \endgroup
  \captionsetup{belowskip=\abovecaptionskip}
  \begingroup
    \captionof{table}{Eine Tabelle}
  \endgroup
\end{Example}

Wie man sieht, f"uhrt das |\captionsetup[figure]{labelfont=bf}| lediglich dazu,
da"s Abbildungsunterschriften mit fettem Bezeichner gesetzt werden, alle anderen
Unter- bzw.\ "Uberschriften werden hiervon nicht beeinflu"st.

\DescribeMacro{\clearcaptionsetup}
Um diese vermerkten, typbezogenen Parameter aus dem Ged"achnis von \LaTeX\ zu
l"oschen, gibt es den Befehl
\begin{quote}
  |\clearcaptionsetup|\marg{Typ}\quad.
\end{quote}

|\clearcaptionsetup{figure}| w"urde z.B. die obrige Sonderbehandlung der
Abbildungsunterschriften wieder aufheben:
\begin{Example}
  \captionsetup{font=small}
  \begingroup
    \captionof{figure}{Eine Abbildung}
  \endgroup
  \captionsetup{belowskip=\abovecaptionskip}
  \begingroup
    \captionof{table}{Eine Tabelle}
  \endgroup
\end{Example}

Als Umgebungstypen mit Unter- bzw.\ "Uberschriften gibt es in der Regel nur
zwei: |figure| und |table|. Wie wir jedoch sp"ater sehen werden, kommen durch die
Verwendung spezieller \LaTeX-Pakete (wie etwa das \package{float},
\package{longtable} oder \package{sidecap}"=Paket)
ggf.~weitere Typen hinzu, deren Beschriftungen ebenfalls derart individuell
angepasst werden k"onnen.

\subsection{Fortlaufende gleitende Umgebungen}
\label{ContinuedFloat}

\DescribeMacro{\ContinuedFloat}
Manchmal m"ochte man Abbildungen oder Tabellen aufteilen, jedoch ohne den einzelnen
Teilen eine eigene Abbildungs- oder Tabellennummer zu geben. Hierf"ur stellt das
\thispackage-Paket den Befehl
\begin{quote}
  |\ContinuedFloat|
\end{quote}
zur Verf"ugung, der gleich als erstes innerhalb der folgenden Teile angewandt
werden sollte. Er verhindert, da"s die Z"ahlung fortgef"uhrt wird; eine Abbildung
oder Tabelle, die ein |\ContinuedFloat| enth"alt, erh"alt also die gleiche Nummer
wie die vorherige Abbildung oder Tabelle.

Ein Beispiel:
\begin{quote}
  |\begin{table}|\\
  |\caption{Eine Tabelle.}|\\
  \ldots\\
  |\end{table}|\\
  \ldots\\
  |\begin{table}\ContinuedFloat|\\
  |\caption{Eine Tabelle. (fortgef"uhrt)}|\\
  \ldots\\
  |\end{table}|
\end{quote}
ergibt als Ergebnis:
\begin{Example}
  \makeatletter\def\@captype{table}\makeatother
  \caption[]{Eine Tabelle.}
  \centerline{\ldots}
  \ContinuedFloat
  \captionsetup{aboveskip=0pt}
  \caption[]{Eine Tabelle. (fortgef"uhrt)}
\end{Example}

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Eigene Erweiterungen}
\label{declare}

Wem die vorhandenen Formate, Trenner, Textausrichtungen, Zeichens"atze und Stile
nicht ausreichen, der hat die M"oglichkeit, sich eigene zu definieren. Hierzu
gibt es eine Reihe von Befehlen, die in dem Vorspann des Dokumentes (das ist der
Teil vor |\begin{document}|) zum Einsatz kommen.

\pagebreak[2]
\DescribeMacro{\DeclareCaptionFormat}
Eigene Formate k"onnen mit dem Befehl
\begin{quote}
  |\DeclareCaptionFormat|\marg{Name}\marg{Code mit \#1, \#2 und \#3}
\end{quote}
definiert werden. F"ur \#1 wird sp"ater der Bezeichner, f"ur \#2 der Trenner
und f"ur \#3 der Text eingesetzt. So ist z.B. das Standardformat |plain|,
welches die Beschriftung als gew"ohnlichen Absatz formatiert, folgenderma"sen
in |caption.sty| definiert:
\begin{quote}
  |\DeclareCaptionFormat{plain}{#1#2#3\par}|
\end{quote}

\DescribeMacro{\DeclareCaptionLabelFormat}
"Ahnlich k"onnen auch eigene Bezeichnerformate definiert werden:
\begin{quote}
  |\DeclareCaptionLabelFormat|\marg{Name}\marg{Code mit \#1 und \#2}
\end{quote}
Bei den Bezeichnerformaten wird hierbei f"ur \#1 der Name (also z.B.
"`Abbildung"'), f"ur \#2 die Nummer (also z.B. "`12"') eingesetzt.

\DescribeMacro{\bothIfFirst}
\DescribeMacro{\bothIfSecond}
Hierbei gibt es eine Besonderheit zu beachten: Wird das Bezeichnerformat
auch in Verbindung mit dem \package{subfig}"=Paket\cite{subfig} verwendet,
so kann der Bezeichnername (also \#1) auch leer sein.
Um dies flexibel handhaben zu k"onnen, stellt das \thispackage"=Paket die
Befehle
\begin{quote}
  |\bothIfFirst|\marg{Erstes Argument}\marg{Zweites Argument}\quad und\\
  |\bothIfSecond|\marg{Erstes Argument}\marg{Zweites Argument}
\end{quote}
zur Verf"ugung. |\bothIfFirst| testet, ob das erste Argument leer ist,
|\bothIfSecond|, ob das zweite Argument leer ist. Nur wenn dies nicht der
Fall ist, werden beide Argumente ausgegeben, ansonsten werden beide
unterdr"uckt.

So ist z.B. das Standard"=Bezeichnerformat |simple| nicht, wie man
naiverweise annehmen k"onnte, als
\begin{quote}
  |\DeclareCaptionLabelFormat{simple}{#1 #2}|
\end{quote}
definiert, weil dies zu einem st"orendem f"uhrenden Leerzeichen f"uhren w"urde,
wenn \#1 leer ist. Stattdessen findet sich in |caption.sty| folgende
Definition, die sowohl mit |\caption| als auch mit |\subfloat| harmoniert:
\begin{quote}
  |\DeclareCaptionLabelFormat{simple}{\bothIfFirst{#1}{~}#2}|
\end{quote}
d.h.~das Leerzeichen kommt nur dann zum Einsatz, wenn \#1 nicht leer ist.

\pagebreak[3]
\DescribeMacro{\DeclareCaptionLabelSeparator}
Eigene Trenner werden mit
\nopagebreak[3]
\begin{quote}
  |\DeclareCaptionLabelSeparator|\marg{Name}\marg{Code}
\end{quote}
\nopagebreak[3]
definiert. Auch hier wieder als einfaches Beispiel die Definition des
Standard"=Trenners aus |caption.sty|:
\nopagebreak[3]
\begin{quote}
  |\DeclareCaptionLabelSeparator{colon}{: }|
\end{quote}
\pagebreak[3]

\DescribeMacro{\DeclareCaptionJustification}
Eigene Textausrichtungen k"onnen mit
\begin{quote}
  |\DeclareCaptionJustification|\marg{Name}\marg{Code}
\end{quote}
definiert werden. Der \meta{Code} wird dann der Beschriftung vorangestellt,
so f"uhrt z.B. die Verwendung der Ausrichtung
\begin{quote}
  |\DeclareCaptionJustification{raggedright}{\raggedright}|
\end{quote}
dazu, da"s alle Zeilen der Beschriftung linksb"undig ausgegeben werden.

\DescribeMacro{\DeclareCaptionFont}
Eigene Zeichensatzoptionen k"onnen mit
\begin{quote}
  |\DeclareCaptionFont|\marg{Name}\marg{Code}
\end{quote}
definiert werden. So definiert z.B. das \thispackage"=Paket die Optionen
|small| und |bf| folgenderma"sen:
\begin{quote}
  |\DeclareCaptionFont{small}{\small}|\\
  |\DeclareCaptionFont{bf}{\bfseries}|
\end{quote}
\iffalse
Die Zeilenabst"ande lie"sen sich z.B.~"uber das \package{setspace}"=Paket
regeln:%\NEWdescription{v3.0h}
\begin{quote}
  |\usepackage{setspace}|\\
  |\DeclareCaptionFont{singlespacing}{\setstretch{1}}|\quad\footnote{%
  \emph{Hinweis:} \cs{singlespacing} kann hier nicht benutzt werden,
  da es ein \cs{vskip} Kommando enth"alt.}\\
  |\DeclareCaptionFont{onehalfspacing}{\onehalfspacing}|\\
  |\DeclareCaptionFont{doublespacing}{\doublespacing}|\\
  |\captionsetup{font={onehalfspacing,small},labelfont=bf}|
\end{quote}
\example{font={onehalfspacing,small},labelfont=bf,singlelinecheck=off}{\exampletext}
\fi
Ein Beispiel, welches etwas Farbe ins Spiel bringt:
\begin{quote}
  |\usepackage{color}|\\
  |\DeclareCaptionFont{red}{\color{red}}|\\
  |\DeclareCaptionFont{green}{\color{green}}|\\
  |\DeclareCaptionFont{blue}{\color{blue}}|\\
  |\captionsetup{labelfont={blue,bf},textfont=green}|
\end{quote}
\example*{labelfont={color=blue,bf},textfont={color=green},singlelinecheck=off}{\exampletext}
Aber da \thispackage\ schon die pfiffige Definition
\begin{quote}
  |\DeclareCaptionFont{color}{\color{#1}}|
\end{quote}
enthält, kann man das selbe Resultat auch einfach mit
\begin{quote}
  |\usepackage{color}|\\
  |\captionsetup{labelfont={color=blue,bf},|\\
  |               textfont={color=green}}|\quad.
\end{quote}
erreichen.

\DescribeMacro{\DeclareCaptionStyle}
Zu guter letzt noch die Definition eigener Stile. Stile sind einfach eine
Ansammlung von geeigneten Einstellungen, die unter einem eigenen Namen
zusammengefasst werden und mit der Paketoption |style=|\meta{Name} ausgew"ahlt
werden k"onnen. Sie werden wie folgt definiert:
\begin{quote}
  |\DeclareCaptionStyle|\marg{Name}\oarg{zus"atzliche Optionen}\marg{Optionen}
\end{quote}
Hierbei ist zu beachten, da"s die \meta{Optionen} immer auf dem Stil |base|
basieren (siehe auch \Ref{style}), es brauchen also nur davon abweichende
Optionen angegeben werden.

Sind \meta{zus"atzliche Optionen} angegeben, so kommen diese automatisch
zus"atzlich zum Einsatz, sofern die Beschreibung in eine einzelne Zeile passt
und diese Abfrage nicht mit |singlelinecheck=off| ausgeschaltet wurde.

Als Beispiel mu"s mal wieder eine einfache Definition innerhalb dieses Paketes
herhalten, so ist der Stil |base| definiert als
\begin{quote}
  |\DeclareCaptionStyle{base}%|\\
  |  [justification=centering,indention=0pt]{}|\quad.
\end{quote}

% --------------------------------------------------------------------------- %

\subsection{Weiterf"uhrende Beispiele}

%\NEWdescription{v3.1}
Möchte man die Bezeichnung (inkl. Trenner wie Doppelpunkt) vom Text mit einem
Zeilenumbruch getrennt haben, so könnte man dies z.B.~so bewerkstelligen:
\begin{quote}
  |\DeclareCaptionFormat{myformat}{#1#2\\#3}|
\end{quote}
Wählt man anschließend dieses Format mit |\captionsetup{format=myformat}| aus,
so erhält man Beschriftungen der Art:
%\begin{Example}
%  \captionsetup{aboveskip=0pt}
  \example{format=myformat1,labelfont=bf}{\exampletext}
%\end{Example}
Auch einen Einzug könnte man diesem Format mit auf den Weg geben:
\begin{quote}
  |\captionsetup{format=myformat,indention=1cm}|
\end{quote}
führt zu Beschriftungen wie:
%\begin{Example}
%  \captionsetup{aboveskip=0pt}
  \example{format=myformat1,indention=1cm,labelfont=bf}{\exampletext}
%\end{Example}
Aber Sie möchten den Einzug nur auf die erste Zeile des Texts anwenden?
Kein Problem, so würde z.B.~die Definition
\begin{quote}
  |\newlength\myindention|\\
  |\DeclareCaptionFormat{myformat}%|\\
  |       {#1#2\\\hspace*{\myindention}#3}|\\
  \ldots\\
  |\setlength\myindention{1cm}|\\
  |\captionsetup{format=myformat}|
\end{quote}
zu Beschriftungen dieser Art führen:
%\begin{Example}
%  \captionsetup{aboveskip=0pt}
  \example{format=myformat2,myindention=1cm,labelfont=bf}{\exampletext}
%\end{Example}
Zu der Länge |\myindention| hätten Sie gerne eine Option, so daß man diesen
Einzug auch z.B.~mit |\captionsetup|\xx|[figure]|\xx|{myindention=|\ldots|}| setzen kann?
Auch dies läßt sich bewerkstelligen, z.B.~folgendermaßen:
\begin{quote}
  |\newlength\myindention|\\
  |\DeclareCaptionOption{myindention}%|\\
  |       {\setlength\myindention{#1}}|\\
  |\DeclareCaptionFormat{myformat}%|\\
  |       {#1#2\\\hspace\myindention #3}|\\
  \ldots\\
  |\captionsetup{format=myformat,myindention=1cm}|
\end{quote}

\bigskip\pagebreak[3]

Ein anderes Beispiel: Die Beschriftungen sollen wie folgt aussehen:
%\begin{Example}
%  \captionsetup{aboveskip=0pt}
  \example{format=reverse,labelformat=fullparens,labelsep=fill,labelfont=it}{\exampletext}
%\end{Example}
\pagebreak[2]
Dies lie"se sich z.B. wie folgt realisieren:
\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]

Ein weiteres Beispiel: Der Bezeichner soll in den linken Rand verlagert
werden, so da"s die komplette Absatzbreite der Beschriftung selber zugute kommt:
{\leftmargini=10pt
 \begin{quote}
   |\DeclareCaptionFormat{llap}{\llap{#1#2}#3\par}|\\
   |\captionsetup{format=llap,labelsep=quad,singlelinecheck=no}|
 \end{quote}}
Das Ergebnis w"aren Beschriftungen wie diese:
%\begin{Example}
%  \captionsetup{aboveskip=0pt}
  \example{format=llap,labelsep=quad,singlelinecheck=no,margin=0pt}{\exampletext}
%\end{Example}

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Unterstützung der Dokumentenklassen} % \& Babel}
\label{classes}

%\NEWdescription{v3.1}
{\small\emph{Bitte beachten Sie:} Viele Dokumentenklassen haben bereits
eingebaute Optionen und Befehle, um das Erscheinungsbild der Abbildungs- und
Tabellenbeschriftungen individuell anzupassen.
Wenn diese Möglichkeiten für Sie ausreichend sind, gibt es in der Regel
keinen Grund, \thispackage\ zu benutzen. Und falls Sie lediglich an dem
Befehl |\captionof| interessiert sind, ist in der Regel das Laden des
kleinen aber feinen \package{capt-of}"=Paketes hierzu völlig ausreichend.}

Dieser Teil der Dokumentation möchte Ihnen einen Überblick über diejenigen
Dokumentenklassen, an welche \thispackage\ angepasst ist, geben:
Welche Möglichkeiten zur Beschriftungsgestaltung sie bereits verfügen,
mit welchen Seiteneffekten Sie rechnen müssen, wenn Sie dieses Paket verwenden,
und zuletzt mit welchen Standardwerten die Optionen belegt werden.

\NEWfeature{v3.1}
Die Standardwerte "`default"' hängen von der verwendeten Dokumentenklasse ab;
sie repräsentieren quasi das Aussehen, wie es vom Autor der Klasse gewünscht war.
So kann z.B.~die Einstellung |format=default| je nach verwendeter Klasse
unterschiedliche Aussehen der Beschriftungen hervorbringen.

\DANGER
Sollten Sie Ihre Dokumentenklasse nicht in diesem Abschnitt finden, so haben Sie
trotzdem oftmals keinen Grund zur Sorge: Viele Dokumentenklassen sind von den
Standardklassen |article|, |report| und |book| abgeleitet, und verhalten sich
bezüglich der Abbildungs- und Tabellenbeschriftungen gleich.
\Thispackage überprüft automatisch die Kompatibilität zur Dokumentenklasse und
gibt eine klare Warnung aus, wenn es eine Unverträglichkeit entdeckt.
Wenn Sie keine solche Warnung erhalten, ist alles bestens, wenn doch, wird von
der Verwendung des \package{caption}"=Paketes abgeraten, insbesondere erhalten
Sie in einem solchen Fall keinen Support.

{\small(Sollten Sie trotz der angemahnten Inkompatibilität \thispackage{}
 nutzen wollen, sollten Sie vorsichtig auf Seiteneffekte achten; gewöhnlich
 ändert sich alleine durch das Einbinden des \package{caption}"=Paketes
 ohne Optionen bereits das eigentlich von der Dokumentenklasse vorgebene
 Aussehen der Beschriftungen.
 Wenn dies für Sie in Ordnung ist, sollten Sie als erstes die Option
 |style=base| mittels |\usepackage|\xx|[style=base]|\xx|{caption}| oder
 |\captionsetup|\xx|{style=base}| angeben, um \thispackage\ in einen
 dokumentierten Grundstatus zu versetzen.
 Anschließend können Sie anfangen, mittels zusätzlicher Optionen erste
 Anpassungen vorzunehmen und die Daumen gedrückt zu halten.)}

\newcommand*\Option{Option}
\newcommand*\defaultvalue{\texttt{default} Belegung}
\newcommand*\use{\textit{verwendet}}
\newcommand*\settings{\textit{Einstellungen}}
\newcommand*\nofont{\textit{keiner}}

\subsection{Standard \LaTeX: article, report \& book}

\begin{tabular}{ll}
\Option          & \defaultvalue \\\hline
|format=|        & |plain| \\
|labelformat=|   & |simple| \\
|labelsep=|      & |colon| \\
|justification=| & |justified| \\
|font=|          & \nofont \\
|labelfont=|     & \nofont \\
|textfont=|      & \nofont \\
\end{tabular}

\textbf{Von der Klasse angebotene Befehle:} Keine

\noindent{\small(\emph{Hinweis:} Dies gilt in der Regel auch für abgeleitete
Dokumentenklassen.)}

\subsection{\AmS: amsart, amsproc und amsbook}
\label{AMS}

\TODO

\subsection{beamer}
\label{beamer}

\begin{tabular}{ll}
\Option          & \defaultvalue \\\hline
|format=|        & |plain| \\
|labelformat=|   & \textit{nicht nummeriert} \\
|labelsep=|      & |colon| \\
|justification=| & |raggedright| \\
|font=|          & \use\ \package{beamer} |caption| \settings \\
|labelfont=|     & \use\ \package{beamer} |caption name| \settings \\
|textfont=|      & \nofont \\
\end{tabular}

\textbf{Von der Klasse angebotene Befehle und Seiteneffekte:}\\
Die Zeichensatz- und Farbeinstellungen können mit
|\setbeamerfont|\xx|{caption}|\xx\marg{options} und
|\setbeamerfont|\xx|{caption name}|\xx\marg{options} vorgenommen werden.
Dies wird auch mit dem \package{caption}"=Paket noch funktionieren, zumindest
solange Sie keinen anderen Zeichensatz mit
|\captionsetup|\xx|{font=|\xx\meta{options}|}| oder
|\captionsetup|\xx|{labelfont=|\xx\meta{options}|}| einstellen.\par
Weiterhin bietet die \package{beamer}"=Klasse verschiedene "`Templates"' für
die Beschriftungen an, diese können mit
|\set|\x|beamter|\x|template|\xx|{caption}|\xx|[|\meta{template}|]|
ausgewählt werden.
Da \thispackage\ diesen Mechanismus ersetzt, haben
|\def|\x|beamer|\x|template*|\xx|{caption}|\xx\marg{template code}
und
|\set|\x|beamer|\x|template|\xx|{caption}|\xx|[|\meta{template}|]|
keine Funktion mehr, wenn \thispackage\ verwendet wird.

\subsection{\KOMAScript: scrartcl, scrreprt \& scrbook}
\label{KOMA}

\begin{tabular}{ll}
\Option          & \defaultvalue \\\hline
|format=|        & \use\ |\setcapindent| \textit{\&} |\setcaphanging| \\
|labelformat=|   & |simple| \\
|labelsep=|      & \use\ |\captionformat| \\
|justification=| & |justified| \\
|font=|          & \use\ |\setkomafont{caption}| \settings \\
|labelfont=|     & \use\ |\setkomafont{captionlabel}| \settings \\
|textfont=|      & \nofont \\
\end{tabular}

\textbf{Von der Klasse angebotene Befehle:}\\
Die \KOMAScript"=Dokumentenklassen bietet sehr viele Möglichkeiten, das Design
der Abbildungs- und Tabellenbeschriftungen anzupassen. Für eine Übersicht schauen
Sie bitte in die sehr gute \KOMAScript"=Dokumentation, Abschnitt "`Tabellen
und Abbildungen"'.

\textbf{Seiteneffekte:}\\
Das optionale Argument von |\setcapwidth| wird (noch) nicht vom
\package{caption}"=Paket unterstützt und daher ignoriert.
Weiterhin überschreiben die \KOMAScript"=Optionen |tablecaptionabove| \&
|tablecaptionbelow| sowie die dazugehörigen Befehle |\captionabove| \&
|\captionbelow| die Einstellungsmöglichkeit |position=|, die \thispackage{}
anbietet.

\subsection{\NTG: artikel, rapport \& boek}
\label{NTG}

\begin{tabular}{ll}
\Option          & \defaultvalue \\\hline
|format=|        & |plain| \\
|labelformat=|   & |simple| \\
|labelsep=|      & |colon| \\
|justification=| & |justified| \\
|font=|          & \nofont \\
|labelfont=|     & \use\ |\CaptionLabelFont| \\
|textfont=|      & \use\ |\CaptionTextFont| \\
\end{tabular}

\textbf{Von der Klasse angebotene Befehle und Seiteneffekte:}\\
|\CaptionLabelFont| und |\CaptionTextFont| können entweder direkt oder
indirekt über |\CaptionFonts| definiert werden.
Beides funktioniert auch weiterhin, zumindest solange kein anderer
Zeichensatz mittels der \package{caption}"=Paket"=Optionen
|labelfont=| oder |textfont=| festgelegt wird.

\subsection{\SmF: smfart und smfbook}
\label{SMF}

\TODO

\subsection{Die französische Babel Option}
\label{frenchb}

\TODO\iffalse
If you use the \package{frenchb} option of the \package{babel} package
with one of the three standard \LaTeX{} classes (or a one derived from them)
the default |labelsep=| will be set to \cs{CaptionSeparator} (offered by
\package{frenchb}), overriding the default value set by the document class.
So redefining \cs{CaptionSeparator} will still work, unless you don't
select a different |labelsep=| than the default one.
\fi

\INFO*
Bitte laden Sie \thispackage\ \emph{nach} dem \package{babel}"=Paket.

\subsection{Das frenchle- und frenchpro-Paket}
\label{frenchpro}

\TODO\iffalse
If you use the \package{frenchle} or \package{frenchpro} package,
the default |labelsep=| will be set to \cs{captionseparator} (offered by
\package{frenchle/pro}) plus \cs{space}, overriding the default value set
by the document class.
So redefining \cs{captionseparator} will still work, unless you don't
select a different |labelsep=| than the default one.

Furthermore the default |textfont=| will be set to |textfont=it|,
since this emulates the default setting of |\captionfont| defined by the
\package{frenchle} or \package{frenchpro} package.
%If you redefine |\captionfont| after loading the \package{frenchle} or
%\package{frenchpro} package, this redefinition gets lost.
Please note that the command \cs{captionfont} is used by the
\package{caption} package internally for a different purpose,
so you should not change it (anymore).

The command \cs{unnumberedcaptions}\marg{figure or table} will still work,
but only unless you don't select a different |labelformat=| than the default
one.
\fi

\INFO*
Bitte laden Sie \thispackage\ \emph{nach} dem \package{frenchle}
oder \package{frenchpro}"=Paket.

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Interaktion mit anderen Paketen}
\label{packages}

%\NEWdescription{v3.1}
\Thispackage\ ist an folgende Pakete, die ebenfalls Abbildungs- oder
Tabellenbeschriftungen anbieten, angepasst:
\begin{quote}
  \package{float}, \package{floatflt}, \package{fltpage},
  \package{hyperref}, \package{hypcap}, \package{listings},
  \package{longtable}, \package{picinpar}, \package{picins},
  \package{rotating}, \package{sidecap}, \package{subfigure},
  \package{supertabular}, \package{threeparttable} und \package{wrapfig}
\end{quote}

Weiterhin arbeiten das \package{floatrow}- und das \package{subfig}"=Paket
aktiv mit diesem Paket zusammen und verwenden die |\captionsetup|"=Schnittstelle.

\subsection{float}
\label{float}

\TODO

\subsection{floatflt}
\label{floatflt}

\TODO

\subsection{fltpage}
\label{fltpage}

\TODO

\subsection{hyperref}
\label{hyperref}

\NEWfeature{v3.1}
Zwei Optionen regeln das Setzen von Hyperlinks:
\begin{description}
\item{\texttt{hypcap=}}\\[\smallskipamount]
Auf |true| gesetzt, werden alle Hyperlink"=Anker -- wohin Einträge im
Abbildungs- und Tabellenverzeichnis, sowie |\ref| und |\autoref|
verweisen -- an den Anfang der (gleitenden) Umgebungen wie Abbildung
oder Tabelle plaziert.\par
Auf |false| gesetzt zeigen hingegen alle Hyperlink"=Anker auf die
Beschriftung.\par
(Die Voreinstellung ist |hypcap=true|.)
\item{\texttt{hypcapspace=}}\\[\smallskipamount]
Dies regelt den vertikalen Abstand zwischen dem Hyperlink"=Anker und der
(gleitenden) Umgebung, so entfernt z.B.~|hypcapspace=0pt| diesen Abstand.\par
(Die Voreinstellung ist|hypcapspace=0.5\baselineskip|.)
\end{description}

Bitte beachten Sie:

\begin{description}
\item{\cs{captionof}\marg{type}\csmarg\ldots\ vs.
      \cs{captionsetup}\csmarg{type=\meta{Typ}}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
Ohne geladenes \package{hyperref}"=Paket bekommen Sie identische Resultate.
Aber mit \package{hyperref} geladen und mit |hypcap=true| versehen wird der
Hyperlink"=Anker unterschiedlich gesetzt. So plaziert z.B.
\begin{quote}
|\begin{minipage}{\linewidth}|\\
|  |\ldots\\
|  \captionof{figure}{A figure}|\\
|\end{minipage}|
\end{quote}
den Anker bei der Beschriftung.
(Und wenn |hypcap=true| gesetzt ist, wird eine Warnung deswegen ausgegeben.)
\begin{quote}
|\begin{minipage}{\linewidth}|\\
|  \captionsetup{type=figure}|\\
|  |\ldots\\
|  \caption{A figure}|\\
|\end{minipage}|
\end{quote}
hingegen plaziert den Anker an den Anfang der |minipage|.

\item{\cs{caption}\csoarg{}\csmarg\ldots\ vs.
      \cs{captionsetup}\csmarg{listof=false}$+$\cs{caption}\csmarg\ldots}\\[\smallskipamount]
Wiederum bekommen Sie ohne geladenes \package{hyperref}"=Paket identische Resultate.
Aber mit \package{hyperref} geladen liegen die Unterschiede in den Feinheiten.
So wird z.B.~das optionale Argument von \cs{caption} auch in die |aux|-Datei
geschrieben und vom \cs{nameref} Befehl verwendet.
Wenn Sie also \cs{caption} mit leerem Argument angeben, wird ein auf diese
Abbildung oder Tabelle angewandtes \cs{nameref} nicht das erwünschte,
nämlich ein leeres Resultat zur Folge haben.
Daher ist es besser \cs{captionsetup}\csmarg{listof=false} zu verwenden,
wenn Sie keinen Eintrag in dem Abbildungs- oder Tabellenverzeichnis wünschen.
\end{description}

\subsection{hypcap}
\label{hypcap}

Wird das \package{hypcap}"=Paket zusätzlich zum \package{hyperref}"=Paket
geladen, so übernimmt es die Kontrolle über die Platzierung der Hyperlink"=Anker.

Dies hat den Nebeneffekt, daß die Hyperlink"=Anker innerhalb der Umgebungen
|floatingfigure| (vom \package{floatflt}"=Paket bereitgestellt),
|figwindow| (vom \package{picinpar}"=Paket bereitgestellt),
|parpic| (vom \package{picins}"=Paket bereitgestellt) und
|wrapfigure| (vom \package{wrapfig}"=Paket bereitgestellt)
nicht mehr optimal platziert werden.

Außerdem ist zu beachten, daß dann |\captionsetup{type=|\meta{Type}|}|
keinen Hyperlink"=Anker mehr setzt, dies muß dann stattdessen mit
|\capstart| (welches vom \package{hypcap}"=Paket angeboten wird) geschehen.

\subsection{listings}
\label{listings}

\TODO

\subsection{longtable}
\label{longtable}

\TODO

\subsection{picinpar}
\label{picinpar}

\TODO

\subsection{picins}
\label{picins}

\TODO

\subsection{rotating}
\label{rotating}

\TODO

\subsection{sidecap}
\label{sidecap}

\TODO

\subsection{subfigure}
\label{subfigure}

\TODO

\subsection{supertabular}
\label{supertabular}

\TODO

\subsection{threeparttable}
\label{threeparttable}

\TODO

\subsection{wrapfig}
\label{wrapfig}

\TODO

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Kompatibilit"at zu "alteren Versionen}
\label{compatibility}

\subsection{caption v\texorpdfstring{$1.x$}{1.x}}
\label{caption1}

Diese Version des \thispackage"=Paketes ist weitgehend kompatibel zu "alteren
Versionen des Paketes; alte, vorhandene Dokumente sollten sich also in der
Regel ohne Probleme weiterhin "ubersetzen lassen.
Jedoch ist zu beachten, da"s eine Mischung aus alten Befehlen und neueren
Optionen bzw.~Befehlen zu unerw"unschten Nebeneffekten f"uhren kann.

Hier eine kurze "Ubersicht "uber die alten, "uberholten Optionen und ihre
aktuellen Entsprechungen:

{\small\begin{longtable}{ll}
\package{caption} \version{1.x} & \package{caption} \version{3.x}\\
\hline
\endhead
|normal|        & |format=plain|\\
|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|\\
\end{longtable}}

Neben den Optionen zum Einstellen des Zeichensatzes gab es auch die Befehle
|\captionsize| bzw. |\captionfont| und |\captionlabelfont|, die direkt
mittels |\renewcommand| ver"andert werden konnten. Dieser Mechanismus
wurde durch die Anweisungen
\begin{quote}
  |\DeclareCaptionFont{|\ldots|}{|\ldots|}|\qquad und\\
  |\captionsetup{font=|\ldots|,labelfont=|\ldots|}|
\end{quote}
ersetzt. \SeeUserDefined

Das Setzen eines Randes geschah in \version{1.x} mittels
\begin{quote}
  |\setlength{\captionmargin}{|\ldots|}|\quad.
\end{quote}
Dies wurde durch
\begin{quote}
  |\captionsetup{margin=|\ldots|}|
\end{quote}
ersetzt. \See{\Ref{margins}}

Zum Beispiel w"urde
\begin{quote}
|\usepackage[hang,bf]{caption}|\\
|\renewcommand\captionfont{\small\sffamily}|\\
|\setlength\captionmargin{10pt}|
\end{quote}
in aktueller Notation
\begin{quote}
|\usepackage[format=hang,labelfont=bf,font={small,sf},|\\
|            margin=10pt]{caption}|
\end{quote}
bzw.
\begin{quote}
|\usepackage{caption}|\\
|\captionsetup{format=hang,labelfont=bf,font={small,sf},|\\
|              margin=10pt}|
\end{quote}
hei"sen.

Die etwas exotische Option |ruled|, die eine partielle Anwendung der
eingestellten Parameter bei gleitenden Umgebungen des Typs |ruled|
aktivierte, wird ebenfalls emuliert, hat aber keine direkte
Entsprechung in dieser Version des \package{caption}"=Paketes.
M"ochte man gezielt das Aussehen der Abbildungen des Stils |ruled|,
der durch das \package{float}"=Paket zur Verf"ugung gestellt wird,
ver"andern, so ist dies nun durch
\begin{quote}
  |\DeclareCaptionStyle{ruled}{|\ldots|}|
\end{quote}
bzw.
\begin{quote}
  |\captionsetup[ruled]{|\ldots|}|
\end{quote}
m"oglich.
\SeeUserDefined[, \Ref{commands} und \Ref{float}]

\subsection{caption2 v\texorpdfstring{$2.x$}{2.x}}
\label{caption2}

Die Pakete \package{caption} und seine experimentelle, nun veraltete
Variante \package{caption2} sind vom internen Konzept
her zu unterschiedlich, um hier eine vollst"andige Kompatibilit"at
gew"ahrleisten zu k"onnen.
Daher liegt diesem Paket weiterhin die Datei |caption2.sty| bei, so da"s
"altere Dokumente, die das \package{caption2}"=Paket verwenden, weiterhin
"ubersetzt werden k"onnen.

Neue Dokumente sollten jedoch auf dem aktuellen \package{caption}"=Paket
aufgesetzt werden. In den meisten F"allen ist es ausreichend, einfach
ggf.~die Anweisung
\begin{quote}
  |\usepackage[...]{caption2}|
\end{quote}
durch
\begin{quote}
  |\usepackage[...]{caption}|
\end{quote}
zu ersetzen. Einige Optionen und Befehle werden jedoch nicht emuliert,
so da"s sie anschlie"send Fehlermeldungen erhalten k"onnen.
Die folgenden Abs"atze werden Ihnen jedoch bei der Umsetzung dieser
Optionen und Befehle helfen. Sollten dar"uberhinaus noch Fragen oder
Probleme auftreten, so z"ogern Sie bitte nicht, mich diesbez"uglich
per E-Mail zu kontaktieren.

Zus"atzlich zu den bereits im vorherigen Abschnitt vorgestellten Optionen
werden auch folgende emuliert:

{\small\begin{longtable}{ll}
\package{caption2} \version{2.x} & \thispackage\ \version{3.x}\\
\hline
\endhead
|flushleft|   & |justification=raggedright|\\
|flushright|  & |justification=raggedleft|\\
|oneline|     & |singlelinecheck=on|\\
\end{longtable}}

Das Setzen eines Randes geschah in \version{2.x} mittels
\begin{quote}\leavevmode\hbox{%
  |\setcaptionmargin{|\ldots|}| bzw.
  |\setcaptionwidth{|\ldots|}|\quad.
}\end{quote}
Dies wurde durch
\begin{quote}\leavevmode\hbox{%
  |\captionsetup{margin=|\ldots|}| bzw.
  |\captionsetup{width=|\ldots|}|
}\end{quote}
ersetzt. \See{\Ref{margins}}

Das Setzen des Einzuges wurde in \version{2.x} mit
\begin{quote}
  |\captionstyle{indent}|\\
  |\setlength\captionindent{|\ldots|}|
\end{quote}
erledigt, dies geschieht nun mit
\begin{quote}
  |\captionsetup{format=plain,indention=|\ldots|}|\quad.
\end{quote}

Die Sonderbehandlung von einzeiligen Beschriftungen lie"s sich in
\version{2.x} mit |\oneline|\-|captions|\-|false| aus-
bzw. |\oneline|\-|captions|\-|true| wieder einschalten. Dies wurde durch
|\captionsetup{|\xx|singlelinecheck=|\xx|off}|
bzw.
|\captionsetup{|\xx|singlelinecheck=|\xx|on}|
ersetzt. \See{\Ref{justification}}

Die Befehle
\begin{quote}
  |\captionlabeldelim|, |\captionlabelsep|, |\captionstyle|,\\
  |\defcaptionstyle|, |\newcaptionstyle| und |\renewcaptionstyle|
\end{quote}
haben keine direkte Entsprechnung und werden daher durch diese
Version des \package{caption}"=Paketes auch nicht emuliert.
Sie f"uhren also bei der Verwendung %mit diesem \thispackage"=Paket
zu Fehlermeldungen und m"ussen daher zwingend umgesetzt werden.
Die Umsetzung ist von Fall zu Fall verschieden, lesen Sie sich daher bitte
diese Anleitung gr"undlich durch und suchen Sie sich die Optionen bzw.~Befehle
als Ersatz heraus, die Ihren W"unschen entsprechen.

\iffalse
Als kleine Hilfestellung hier die Beispiele aus der alten Anleitung zum
\package{caption2}"=Paket und deren Umsetzung:

\newenvironment{OldNew}%
  {\begin{minipage}\linewidth
   \def\Old{Alt:\begin{quote}}%
   \def\New{\end{quote}Neu:\begin{quote}}%
   \def\Or{\end{quote}\centerline{-- oder --}\begin{quote}}%
  }%
  {\end{quote}\end{minipage}}

\begin{OldNew}
\Old
  |\captionstyle{center}|
\New
  |\captionsetup{justification=centering}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\captionstyle{indent}|\\
  |\setlength{\captionindent}{1cm}|
\New
  |\captionsetup{format=plain,indention=1cm}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\renewcommand\captionfont{\small}|\\
  |\renewcommand\captionlabelfont{\itshape}|
\New
  |\captionsetup{font=small,labelfont=it}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\renewcommand\captionfont{\small\itshape}|\\
  |\renewcommand\captionlabelfont{\upshape}|
\New
  |\captionsetup{font=small,textfont=it}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\setcaptionwidth{.5\textwidth}|
\New
  |\captionsetup{width=.5\textwidth}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\setcaptionmargin{.25\textwidth}|
\New
  |\captionsetup{margin=.25\textwidth}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\newcaptionstyle{absatz}{\captionlabel: \exampletext\par}|\\
  |\captionstyle{absatz}|
\New
  |\DeclareCaptionFormat{absatz}{#1: #3\par}|\\
  |\captionsetup{format=absatz,singlelinecheck=off}|
\Or
  |\captionsetup{format=plain,singlelinecheck=off}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\newcaptionstyle{fancy}{\textsf{\captionlabel}\\\exampletext\par}|\\
  |\captionstyle{fancy}|
\New
  |\DeclareCaptionFormat{fancy}{\textsf{#1}\\#3\par}|\\
  |\captionsetup{format=fancy,singlelinecheck=off}|
\Or
  |\captionsetup{format=plain,labelfont=sf,labelsep=newline}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\newcaptionstyle{fancy2}{\exampletext\hfill\textit{(\captionlabel)}}|\\
  |\captionstyle{fancy2}|
\New
  |\DeclareCaptionFormat{fancy2}{#3\hfill\textit{(#1)}}|\\
  |\captionsetup{format=fancy2,singlelinecheck=off}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\newcaptionstyle{mystyle}{%|\\
  |  \normalcaptionparams|\\
  |  \renewcommand\captionlabelfont{\bfseries}%|\\
  |  \renewcommand\captionlabeldelim{.}%|\\
  |  \onelinecaptionsfalse|\\
  |  \usecaptionstyle{centerlast}}|\\
  |\captionstyle{mystyle}|
\New
  |\DeclareCaptionStyle{mystyle}{labelfont=bf,labelsep=period,justification=centerlast}|\\
  |\captionsetup{style=mystyle}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\newcaptionstyle{hangandleft}{%|\\
  |  \let\oldcaptiontext\exampletext|\\
  |  \def\exampletext{\raggedright\oldcaptiontext}%|\\
  |  \usecaptionstyle{hang}}|\\
  |\captionstyle{hangandleft}|
\New
  |\captionsetup{format=hang,justification=raggedright}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\newcaptionstyle{fancy}{%|\\
  |  \usecaptionmargin\captionfont|\\
  |  \onelinecaption|\\
  |    {{\captionlabelfont\captionlabel\captionlabeldelim}%|\\
  |     \captionlabelsep\exampletext}%|\\
  |    {{\centering\captionlabelfont\captionlabel\par}%|\\
  |      \centerlast\exampletext\par}}|\\
  |\captionstyle{fancy}|
\New
  |\DeclareCaptionFormat{fancy}{\centering#1\par\centerlast#3\par}|\\
  |\DeclareCaptionStyle{fancy}|\\
  |  [format=plain,justification=centering]|\\
  |  {format=fancy}|\\
  |\captionsetup{style=fancy}|
\Or
  |\DeclareCaptionFormat{fancy}{#1\par#3\par}|\\
  |\DeclareCaptionStyle{fancy}|\\
  |  [format=plain,justification=centering]|\\
  |  {format=fancy,justification=centerlast}|\\
  |\captionsetup{style=fancy}|
\end{OldNew}

\hrule

\begin{OldNew}
\Old
  |\renewcaptionstyle{longtable}{\usecaptionstyle{normal}}|
\New
  |\captionsetup[longtable]{format=plain}|
\end{OldNew}
\fi

Ebenfalls keine Entsprechung hat die \version{2.x}"=Option |ignoreLTcapwidth|.
Deren Verwendung kann in der Regel einfach entfallen, da \thispackage\ den
Wert von |\LTcapwidth| sowieso nicht beachtet, solange er nicht explizit auf
einen anderen Wert als den Standardwert ($=$|4in|) gesetzt wird.
\See{\Ref{longtable}}

\subsection{caption v\texorpdfstring{$3.0$}{3.0}}
\label{caption3}

%\NEWdescription{v3.1}
\Thispackage\ \version{3.0} hatte keine weiteren Dokumentenklassen
aktiv unterstützt als die drei Standard"=Klassen, die \LaTeX\ selber
mitbringt: |article|, |report| und |book|.
Daher waren die Vorbelegungen der Einstellungsmöglichkeiten fest durch
dieses Paket vorgegeben, sie repräsentierten das Aussehen bei Verwendung
einer dieser Klassen.
Nun aber unterstützt \thispackage\ mehr Dokumentenklasse aktiv, folglich
kann die Vorbelegung nun von der verwendeten Dokumentenklasse abhängen.

Ein Beispiel: Während in \version{3.0} die Vorbelegung der Ausrichtung
immer |justification=|\xx|justified| was, ist sie nun immer noch |justified|
wenn eine der drei Standardklassen verwendet wird, aber
|justification=|\xx|raggedright|, wenn die \package{beamer}"=Klasse verwendet
wird.

Möchten sie weiterhin die "`alten"' Vorbelegungen, so können Sie die Option
|style=base| beim Laden des \package{caption}"=Paketes angeben oder später
mittels |\captionsetup|\xx|{style=base}| den alten Grundzustand wieder herstellen.

Weiterhin prüft die aktuelle Version des \package{caption}"=Paketes automatisch
nach Inkompatibilitäten und gibt ggf.~ eine Warnung diesbezüglich aus.
Sollte eine ernsthafte Inkompatibilität festgestellt werden, werden außerdem
einige Features des \package{caption}"=Paketes abgeschaltet.
Lediglich diese Prüfung ist neu, wenn sie also neuerdings eine
Kompatibilitätswarnung erhalten, so waren auch bereits vorangegangene Versionen
des \package{caption}"=Paketes inkompatibel, dies hatte sich aber früher "`nur"'
durch Seiteneffekte bzw.~nicht korrekt funktionierende Features geäußert.
Die Kompatibilitätswarnungen sagen auch nicht aus, daß etwas schief gegangen ist,
sondern lediglich, daß etwas schief gehen kann. Sie sollten aber auf jeden Fall,
wenn Sie \thispackage\ trotz einer solchen Warnung einsetzen, die Abbildungs-
und Tabellenbeschriftungen bzgl.~ ihres Aussehens genau im Auge behalten.

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Alphabetische Referenz}

%\newenvironment{Warnings}%
% {\begin{trivlist}%
%   \def\Message{\pagebreak[3]\leftskip=0pt\relax\item[]\color{blue}}%
%   \def\Description{\nopagebreak\par\nopagebreak\color{black}\leftskip=1.5em\nopagebreak}%
% }%
% {\color{black}\end{trivlist}}
\makeatletter
\newenvironment{Warnings}{%
  \newif\ifMessage
  \def\Message{%
    \ifMessage\end{minipage}\par\vspace\itemsep\pagebreak[3]\fi
    \begin{minipage}{\linewidth}%
    \setlength\parindent{0pt}%
    \setlength\parskip{\smallskipamount}%
    \setlength\leftskip{0pt}%
    \color{blue}%
    \Messagetrue}%
  \def\Description{%
    \par\color{black}\leftskip=1.5em}%
  \def\Or{\@testopt\@Or{oder}}%
  \def\@Or[##1]{%
    \\{\small\color{black}\hspace{1.5em}\textit{-- ##1 --}}\\}%
}{%
  \ifMessage\end{minipage}\par\fi
}
\makeatother

\subsection{Befehle}

\begin{longtable}{lll}
Befehl                           & & Abschnitt \\
\hline
\endhead
|\abovecaptionskip|              & & \ref{skips} \\
%|\AtBeginCaption|               & & \ref{x} \\
%|\AtEndCaption|                 & & \ref{x} \\
|\belowcaptionskip|              & & \ref{skips} \\
|\caption|                       & & \ref{commands} \\
|\caption*|                      & & \ref{commands} \\
|\captionbox|                    & & \ref{x} \\
|\captionof|                     & & \ref{commands} \\
|\captionof*|                    & & \ref{commands} \\
|\captionsetup|                  & & \ref{commands} \\
|\captionsetup*|                 & & \ref{commands} \\
|\centerfirst|                   & & \ref{justification} \\
|\centerlast|                    & & \ref{justification} \\
|\clearcaptionsetup|             & & \ref{commands} \\
|\clearcaptionsetup*|            & & \ref{commands} \\
|\ContinuedFloat|                & & \ref{ContinuedFloat} \\
|\DeclareCaptionFont|            & & \ref{declare} \\
|\DeclareCaptionFormat|          & & \ref{declare} \\
|\DeclareCaptionFormat*|         & & \ref{declare} \\
|\DeclareCaptionJustification|   & & \ref{declare} \\
|\DeclareCaptionLabelFormat|     & & \ref{declare} \\
|\DeclareCaptionLabelSeparator|  & & \ref{declare} \\
|\DeclareCaptionLabelSeparator*| & & \ref{declare} \\
|\DeclareCaptionListOfFormat|    & & \ref{declare} \\
|\DeclareCaptionOption|          & & \ref{declare} \\
|\DeclareCaptionStyle|           & & \ref{declare} \\
|\DeclareCaptionTextFormat|      & & \ref{declare} \\
|\DeclareFloatingEnvironment|    & & \ref{DeclareFloatingEnvironment} \\
|\showcaptionsetup|              & & \ref{commands} \\
\end{longtable}

\pagebreak[4]
\subsection{Optionen}
\newcommand\preambleoption{ \footnotemark[1]}

\begin{longtable}{lll}
Option            & Kurzbeschreibung & Abschnitt \\
\hline
\endhead
|aboveskip|       & setzt den Abstand über der Beschriftung & \ref{skips} \\
|belowskip|       & setzt den Abstand unter der Beschriftung & \ref{skips} \\
|compatibility|\preambleoption & erzwingt (Nicht-)Kompatibilität & \ref{classes} \\
%|config| &       & \ref{x} \\
|figurename|\preambleoption & setzt den Abbildungsnamen & \ref{x} \\
|figureposition|\preambleoption & gibt einen Hinweis auf die Position & \ref{skips} \\
|font|            & wählt den Zeichensatz & \ref{fonts} \\
|format|          & wählt das Format & \ref{formats} \\
|FPlist|          & wohin soll der Listeneintrag einer FPfigure zeigen? & \ref{fltpage} \\
|FPref|           & wohin soll ein |\ref| einer FPfigure zeigen? & \ref{fltpage} \\
|hangindent|      & setzt den "`hängenden"' Einzug & \ref{margins} \\
|hypcap|          & wählt das "`hypcap"' Feature aus & \ref{hyperref} \\
|hypcapspace|     & setzt den Abstand über einem Hyperlink & \ref{hyperref} \\
|indention|       & setzt den Einzug & \ref{margins} \\
|justification|   & wählt die Ausrichtung & \ref{justification} \\
|labelfont|       & wählt den Zeichensatz des Bezeichners & \ref{fonts} \\
|labelformat|     & wählt das Format des Bezeichners & \ref{formats} \\
|labelsep|        & wählt den Trenner zw. Bezeichner$+$Text & \ref{formats} \\
|labelseparator|  & wählt den Trenner zw. Bezeichner$+$Text & \ref{formats} \\
|listof|          & schaltet die Listeneinträge an bzw. aus & \ref{listof} \\
|listofformat|    & wählt das Listenformat & \ref{listof} \\
|margin|          & setzt den Rand bzw. die Ränder & \ref{margins} \\
|margin*|         & setzt den Rand, sofern keine Breite gesetzt ist & \ref{margins} \\
|maxmargin|       & setzt den max. zu verwendenen Rand & \ref{margins} \\
|minmargin|       & setzt den min. zu verwendenen Rand & \ref{margins} \\
|options|         & führt die angegebene Optionsliste aus & \ref{x} \\
|parindent|       & setzt den Absatzeinzug & \ref{margins} \\
|parskip|         & setzt den Absatzabstand & \ref{margins} \\
|position|        & gibt einen Hinweis auf die Position & \ref{skips} \\
|singlelinecheck| & schaltet die "`Ein-Zeilen-Prüfung"' ein bzw. aus  & \ref{justification} \\
%|size|           & wählt die Größe des Zeichensatzes & \ref{x} \\
|skip|            & setzt den Abstand zwischen Inhalt \& Beschriftung & \ref{skips} \\
|strut|           & schaltet die Verwendung von |\strut| ein bzw. aus & \ref{formats} \\
|style|           & wählt einen kompletten Stil aus & \ref{style} \\
|tablename|\preambleoption & setzt den Tabellennamen & \ref{x} \\
|tableposition|\preambleoption & gibt einen Hinweis auf die Position & \ref{skips} \\
|textfont|        & wählt den Zeichensatz des Textes & \ref{fonts} \\
|textformat|      & wählt das Format des Textes & \ref{formats} \\
|twoside|         & wählt den zweiseitigen Modus & \ref{x} \\
|type|            & setzt den Typ \& setzt einen Hyperlink-Anker & \ref{x} \\
|type*|           & setzt (nur) den Typ & \ref{x} \\
|width|           & setzt eine feste Breite & \ref{margins} \\
\end{longtable}
\footnotetext[1]{Diese Optionen stehen nur in dem Dokumentenvorspann (Preamble)
                 zur Verfügung.}
\nopagebreak\parbox[t]{\linewidth}{\small\emph{Hinweis:}
  Veraltete Optionen sind hier nicht gelistet,
  diese sind in\\
  \hspace*{1em}\Ref{caption1} und\\
  \hspace*{1em}\Ref{caption2} zu finden.}

\pagebreak[4]
\subsection{Warnungen}

\begin{Warnings}

\Message
  |\caption will not be redefined since it's already|\\
  |redefined by a document class or package which is|\\
  |unknown to the caption package.|\\
  |As a result some new features of the caption|\\
  |package will not work as expected.|
\Description
  Wenn \thispackage\ eine vorhandene (und unbekannte) Erweiterung des Befehls
  |\caption| erkannt hat, definiert es |\caption| nicht erneut um, da dies
  unweigerlich den Verlust der ursprünglichen Erweiterung zur Folge hätte.
  Daher funktionieren manche Features, wie |\caption*|,
  |\ContinuedFloat|, das optionale Argument von |\captionsetup|,
  sowie die Optionen |listof=| und |hypcap=| nicht mehr; sie werden
  entweder ignoriert oder arbeiten nicht erwartungsgemäß.\par
  Wenn Sie an der ursprünglichen Erweiterung nicht interessiert sind
  und stattdessen den vollen Umfang des \package{caption}"=Paketes
  verwenden wollen, können Sie es mit der nicht supporteten(!)
  Option |compatibility=false| probieren und die Daumen drücken.
  (Aber Sie werden die nächste Warnung stattdessen bekommen.)
  \par\See{\Ref{classes}}

\Message
  |Caption type was already set to `|\meta{type}|'.|
\Description
  Diese Warnung informiert Sie über vermische \package{caption}"=Optionen.
  Wenn Sie z.B.~ein |\captionof|\xx|{table}|\xx|{|\ldots|}| in einer |figure|
  Umgebung verwenden, werden beide Optionensätze, sowohl derjenige für |figure|
  (mittels |\captionsetup|\xx|[figure]|\xx|{|\ldots|}| angegeben) als auch
  derjenige für |table| (mittels |\captionsetup|\xx|[table]|\xx|{|\ldots|}|
  angegeben), angewandt.
  \par\See{\Ref{commands}}

\Message
  |Forced redefinition of \caption since the|\\
  |unsupported(!) package option `compatibility=false'|\\
  |was given. Please fasten your seat belts, as we may|\\
  |experience turbulence!|
\Description
  Da Sie so mutig waren, die Option |compatibility=false| zu probieren,
  wird \thispackage\ sein bestes geben, um diesen Wunsch zu erfüllen.
  Aber je nach verwendeter Dokumentenklasse bzw.~Pakete sollten Sie sich
  auf nicht"=funktionierende Features oder gar Fehlermeldungen einstellen.
  Also bitte die Daumen gedrückt halten!
  \par\See{\Ref{classes}}

\Message
  |Hyperref support is turned off because hyperref has|\\
  |stopped early.|
\Description
  Wenn das \package{hyperref}"=Paket seinen Dienst einstellt (den Grund hierfür
  teilt es Ihnen mit), ist auch die \package{hyperref}"=Unterstützung des
  \package{caption}"=Paketes nicht verfügbar. Als Folge werden Sie einige
  Warnungen des \package{hyperref}"=Paketes bekommen, ferner werden Hyperlinks
  auf Abbildungen und Tabellen nicht funktionsfähig sein.
  \par\See{\Ref{hyperref}}

\Message
  |Ignoring optional argument [|\meta{pos}|] of \setcapwidth.|
\Description
  \Thispackage\ bemüht sich, so gut es kann, die \KOMAScript"=Befehle
  bzgl.~Tabellen und Abbildungen zu emulieren. Aber das optionale Argument
  von |\setcapwidth| funktioniert (noch) nicht; wenn Sie es angeben,
  wird diese Warnung ausgegeben.
  \par\See{\Ref{KOMA}}

\Message
  |Internal Warning: |\meta{Warnungstext}|.|
\Description
  Diese Warnung sollten Sie niemals sehen; entweder verwenden Sie ein Paket,
  welches |figure| und/oder |table| in einer dem \package{caption}"=Paket
  unbekannten Art \& Weise verändert, oder aber es ist ein Bug im
  \package{caption}"=Paket.
  Bitte senden Sie mir einen Fehlerbericht diesbezüglich per E-Mail. Danke!

\Message
  |\label before \caption ignored|
\Description
  Anders als bei nicht gleitenden Umgebungen wird bei den
  gleitenden Umgebungen die interne Referenz erst bei Anwendung des Befehls
  |\caption| erzeugt. Ein |\label| Befehl, der auf diese Abbildung
  bzw.~Tabelle verweisen soll, muß daher entweder \emph{nach} |\caption|
  oder innerhalb des Argumentes von |\caption| platziert werden.

\Message
  |Option `|\meta{option}|' was not in list `|\meta{option list}|'.|
\Description
  Wenn Sie versuchen, eine bestimmte Option aus einer Optionsliste zu
  entfernen, zum Beispiel mit |\clearcaptionsetup[position]{table}|,
  und die angegebene Option kann nicht in der Liste gefunden werden, so
  erhalten Sie die obenstehende Warnung.
  Liegt dies nicht an einem Schreibfehler Ihrerseits und möchten Sie ferner
  diese Warnung unterdrücken, so verwenden können Sie hierzu |\clearcaptionsetup*|
  anstelle von |\clearcaptionsetup| verwenden.
  \par\See{\Ref{commands}}

\Message
  |Option list `|\meta{option list}|' undefined.|
\Description
  Wenn Sie versuchen, eine bestimmte Option aus einer Optionsliste zu
  entfernen, zum Beispiel mit |\clearcaptionsetup[format]{figure}|,
  und die angegebene Optionsliste ist (noch) nicht definiert, so
  erhalten Sie die obenstehende Warnung.
  Liegt dies nicht an einem Schreibfehler Ihrerseits und möchten Sie ferner
  diese Warnung unterdrücken, so verwenden können Sie hierzu |\clearcaptionsetup*|
  anstelle von |\clearcaptionsetup| verwenden.
  \par\See{\Ref{commands}}

\iffalse
\Message
  |Possibly superfluous \restylefloat{|\meta{type}|} detected.|\\
  |If you think that this warning is unjustified,|\\
  |you can switch it off using the caption package|\\
  |option `restylefloatcheck=off'.|
\Description
  \TODO
\fi

\Message
  |`ragged2e' package not loaded, therefore|\\
  |substituting \raggedright for \RaggedRight.|
\Description
  Die Option |justification=|\xx|RaggedRight| ist nur dann voll funktionsfähig,
  wenn Sie das \package{ragged2e}"=Paket auf Ihrem \TeX"=System installiert haben.
  Ist dies nicht der Fall, erhalten Sie diese Warnung und |justification=|\xx|RaggedRight|
  wird im späteren Verlauf des Dokumentes wie |justification=|\xx|raggedright|
  behandelt werden.
  \par\See{\Ref{justification}}

\Message
  |Obsolete option `ignoreLTcapwidth' ignored.|
\Description
  Die Option |ignoreLTcapwidth| des \package{caption2}"=Paketes wird nicht von
  diesem Paket emuliert. In der Regel können Sie aber diese Option ohne Nebeneffekte
  einfach entfernen.
  \par\See{\Ref{caption2} und \Ref{longtable}}

\Message
  |`ragged2e' support has been changed. Rerun to get|\\
  |captions right.|
\Description
  Das \package{ragged2e} wird nur dann vom \package{caption}"=Paket geladen,
  wenn es tatsächlich benötigt wird.
  Um dies zu gewährleisten, sind zwei \LaTeX"=Läufe notwendig, daher können Sie
  beim ersten Durchlauf diese Warnung bekommen.
  Im nächsten \LaTeX"=Lauf sollte also diese Warnung verschwunden sein.
  \par\See{\Ref{justification}}

\Message
  |Reference on page |\meta{page no.}| undefined.|
\Description
  Ist ein zweiseitiges Dokumentenlayout gewählt, benötigt \thispackage\ zwei
  \LaTeX"=Läufe, um die Ränder richtig zuordnen zu können;
  daher können Sie beim ersten Durchlauf diese Warnung bekommen.
  Im nächsten \LaTeX"=Lauf sollte also diese Warnung verschwunden sein.
  \par\See{\Ref{margins}}

\Message
  |The option `hypcap=true' will be ignored for this|\\
  |particular \caption.|
\Description
  \Thispackage\ hat keinen geeigneten Hyperlink"=Anker für diese Beschriftung
  gefunden, daher hat es entschlossen, die Einstellung |hypcap=true| (die per
  Standard gesetzt ist) zu ignorieren.
  Als Folge werden Hyperlinks zu dieser Abbildung oder Tabelle (etwa über das
  Abbildungsverzeichnis, oder selber mit |\ref| oder |\autoref| angelegt)
  nicht auf den Beginn der Abbildung oder Tabelle verweisen, sondern stattdessen
  auf deren Beschriftung.\par
  Dies kann z.B.~passieren, wenn eine Beschriftung mittels |\captionof| innerhalb
  einer nicht-gleitenden Umgebung gesetzt wird, aber auch, wenn ein Sie ein Paket
  in Ihrem Dokument verwenden, welches die Umgebungen |figure| oder |table|
  umdefiniert hat, dieses Paket aber dem \package{caption}"=Paket unbekannt
  ist.\par
  Ist dies für Sie ok, aber die Warnung stört Sie, können Sie sie
  |\captionsetup{|\xx|hypcap=|\xx|false}| direkt vor dem betroffenen |\caption|
  oder |\captionof| Befehl platzieren.
  Ist dies hingegen nicht für Sie ok, können Sie versuchen, selber an geeigneter
  Stelle einen Hyperlink"=Anker mit |\captionsetup{|\xx|type=|\xx\meta{Typ}|}|
  zu setzen.
  \par\See{\Ref{hyperref}}

\Message
  |Unsupported document class (or package) detected,|\\
  |usage of the caption package is *not* recommended.|
\Description
  Entweder ist die verwendete Dokumentenklasse dem \package{caption}"=Paket
  unbekannt, oder aber Sie haben ein Paket in Ihrem Dokument eingebunden,
  welches ebenfalls das interne Makro |\@makecaption| (was für das Setzen
  der Abbildungs- und Tabellenbeschriftungen zuständig ist) umdefiniert.
  Wie-auch-immer, \thispackage\ wird entweder das Design der Beschriftungen
  in einer ungewollten Art \& Weise verändern, oder aber es wird zu keinem
  geordneten Verhalten und/oder Fehlermeldungen kommen. Deswegen wird in
  diesem Falle die Verwendung des \package{caption}"=Paketes nicht empfohlen.
  \par\See{\Ref{classes}}

\Message
  |Unused \captionsetup[|\meta{type}|].|
\Description
  Es wurden Optionen mit |\captionsetup[|\meta{Typ}|]| definiert, die im Laufe
  des Dokumentes aber nicht zur Anwendung gekommen sind.
  Dies kann zum einen an einem Schreibfehler im Argument \meta{Typ} liegen,
  aber auch daran, daß ein dem \package{caption}"=Paket unbekanntes Paket
  die Umgebungen |figure| und/oder |table| umdefiniert hat, oder auch einfach,
  weil Sie die angegebene Umgebung gar nicht im späteren Verlauf Ihres Dokumentes
  verwenden.\par
  Möchten Sie diese Warnung unterdrücken, so verwenden Sie hierzu
  |\caption|\x|setup*| anstelle von |\caption|\x|setup|.
  \par\See{\Ref{commands}}

\Message
  |Usage of the |\meta{package}| package together with the|\\
  |caption package is strongly *not* recommended.|\\
  |Instead of loading the |\meta{package}| package you should|\\
  |use the caption package option `tableposition=top'.|
\Description
  Das angegebene Paket mischt sich ebenfalls in die Verwendung der Abstände
  über- und unterhalb der Beschriftungen ein. Viele Köche verderben den Brei,
  also ist es ratsam, sich für eines der Pakete -- das angegebene oder
  \thispackage\ -- zu entscheiden, um falsche Abstände zu vermeiden.
  \par\See{\Ref{skips}}

\end{Warnings}

\pagebreak[4]
\subsection{Fehlermeldungen}

\begin{Warnings}

\Message
  |Argument of \@caption has an extra }.|
\Or
  |Paragraph ended before \@caption was complete.|
\Description
  Beim Setzen von Beschriftungen, die etwas spezielles wie z.B.~eine
  Tabelle enthält, ist zu beachten, daß immer ein alternativer Listeneintrag
  als optionales Argument bei |\caption| bzw. |\captionof| mit angegeben
  werden muß, auch wenn Ihr Dokument gar kein Abbildungs- oder
  Tabellenverzeichnis beeinhaltet.
  \par\See{\Ref{commands}, \Ref{listof} und \Ref{hyperref}\,}

\Message
  |\caption outside float.|
\Description
  |\caption| ist (in der Regel) nur für die Anwendung in gleitenden
  Umgebungen wie |figure| oder |table|, oder für die Anwendung innerhalb
  |longtable| konzipiert, ansonsten bekommen Sie obenstehende Fehlermeldung.\par
  Um eine Beschriftung innerhalb einer anderen Umgebung zu setzen, verwenden Sie
  bitte entweder die Kombination |\captionsetup{|\xx|type=|\xx\meta{type}|}| $+$
  |\caption|, oder aber |\captionof|.
  \par\See{\Ref{commands}}

\Message
  |\caption outside box or environment.|
\Or
  |\captionsetup{type=...} outside box or environment.|
\Or
  |\captionsetup{type*=...} or \captionof outside box or environment.|
\Description
  |\caption|, |\captionof| sowie |\captionsetup{|\xx|type=|\xx\meta{type}|}|
  sind nur für die Anwendung innerhalb einer Box, Gruppe oder Umgebung konzipiert.
  \par\See{\Ref{commands}}

\Message
  |\ContinuedFloat outside float.|
\Description
  |\ContinuedFloat| ist nur für die Anwendung innerhalb einer gleitenden
  Umgebung wie |figure| oder |table| konzipiert. %oder auch |longtable|
  Für die Anwendung in einer Box, Gruppe oder nicht-gleitenden Umgebung
  bietet sich die Kombination
  |\captionsetup{|\xx|type=|\xx\meta{Typ}|}| $+$ |\ContinuedFloat| an.\par
  |\ContinuedFloat| innerhalb einer |longtable| funktioniert zwar (noch)
  nicht, aber vielleicht ist die |longtable*| Umgebung, die eine longtable
  ohne Erhöhung des Tabellenzählers setzt, für Sie hilfreich.
  \par\See{\Ref{commands} und \Ref{longtable}}

\Message
  |Continued `|\meta{type}|' after `|\meta{type}|'.|
\Description
  Z.Z.~ dürfen fortlaufende Abbildungen oder Tabellen nicht von anderen gleitenden
  Umgebungen oder einer |longtable| unterbrochen werden, so ist z.B.~ eine Tabelle
  zwischen einer Abbildung und einer (mit |\ContinuedFloat|) fortgesetzten Abbildung
  nicht möglich.
  \par\See{\Ref{ContinuedFloat}}

\Message
  |For a successful cooperation of the `wrapfig' package|\\
  |with the `float' package you should load the `wrapfig'|\\
  |package *(right) after* the `float' package.|
\Description
  Achten Sie bei der gleichzeitigen Verwendung der Pakete \package{wrapfig}
  und \package{float} unbedingt auf die richtige Ladereihenfolge und
  Anwendung.
  \par\See{\Ref{wrapfig}}

\Message
  |For a successful cooperation of the `wrapfig' package|\\
  |with the `float' package you should use at least|\\
  |`wrapfig' version 3.6.|
\Description
  Für die gleichzeitige Verwendung der Pakete \package{wrapfig} und
  \package{float} wird die Version $3.6$ des \package{wrapfig}"=Paketes
  benötigt.
  \par\See{\Ref{wrapfig}}

\Message
  |For a successful cooperation we need at least version|\\
  |`|\meta{date}|' of package |\meta{package}|, but only version|\\
  |`|\meta{old-date}|' is available.|
\Description
  Das aktuelle \package{caption}"=Paket kann nicht mit einem solchen,
  veralteten Paket zusammen betrieben werden.
  Bitte aktualisieren Sie das betroffene Paket, zumindest auf die
  benötigte Version.

\Message
  |Internal Error: |\meta{Fehlertext}|.|
\Description
  Diesen Fehler sollten Sie niemals sehen. Wenn doch, senden Sie mir bitte
  einen Fehlerbericht per E-Mail.

\Message
  |Not allowed in longtable* environment.|
\Description
  Der Befehl |\caption| ist nicht immerhalb einer |longtable*| Umgebung
  erlaubt. Verwenden sie entweder |\caption*| für eine Beschriftung ohne
  Bezeichner oder benutzen Sie die reguläre |longtable| Umgebung.

\Message
  |Not available in compatibility mode.|
\Description
  Das angeforderte Feature steht im sog.~Kompatibilitätsmodus nicht zur
  Verfügung, d.h.~\thispackage\ hat eine inkompatible Dokumentenklasse oder
  ein inkompatibles Paket entdeckt, welches ebenfalls |\caption| erweitert
  und damit die Anwendung dieses Features bzw.~Befehls verhindert.
  \par\See{\Ref{compatibility}}

\Message
  |Only one \caption can be placed in this environment.|
\Description
  Innerhalb der Umgebungen, die das \package{fltpage} oder \package{sidecap}
  Paket zur Verfügung stellt, kann nur eine Bildbeschriftung gesetzt werden.

\Message
  |Option clash for package caption.|
\Or[aber manchmal auch]
  |Missing \begin{document}.|
\Description
  Ein anderes \LaTeX-Paket hat \thispackage\ bereits geladen, Sie können es
  daher nicht noch einmal mit anderen Optionen laden.
  Als Verdächtiger kommt z.B.~das \package{ctable} oder das
  \package{subfig}"=Paket in Frage; sollte dies zutreffen,
  laden Sie bitte entweder \thispackage\ \emph{vor} dem betreffenen Paket.
  Im Falle des \package{subfig}"=Paketes können Sie auch alternativ beim
  Laden des \package{subfig}"=Paketes die Option |caption=false| angeben.
  \par\See{Dokumentation des \package{subfig}"=Paketes\cite{subfig}}

\Message
  |Runaway argument?|\\
  |Paragraph ended before \caption@makecurrent was complete.|
\Description
  Beim Setzen von Beschriftungen, die mehr als aus einem Absatz bestehen,
  ist zu beachten, daß immer ein alternativer Listeneintrag als optionales
  Argument bei |\caption| bzw. |\captionof| mit angegeben werden muß,
  auch wenn Ihr Dokument gar kein Abbildungs- oder Tabellenverzeichnis
  beeinhaltet.
  \par\See{\Ref{commands}, \Ref{listof} und \Ref{hyperref}\,}

\iffalse % was removed in v3.1b
\Message
  |Something is going wrong here...|\\
  |For a removal of this problem please consult the|\\
  |caption package documentation, especially the sections|\\
  |about the `float' and the `wrapfig' package.|
\Description
  Achten Sie bei der gleichzeitigen Verwendung der Pakete \package{wrapfig}
  und \package{float} unbedingt auf die richtige Ladereihenfolge und
  Anwendung. Aber vielleicht hat auch ein anderes Paket das
  \package{float}"=Paket in einer für \thispackage\ inkompatiblen
  Art \& Weise erweitert!?
  \par\See{\Ref{float} und \Ref{wrapfig}}
\fi

\iffalse
\Message
  |Something's wrong--perhaps a missing \caption|\\
  |in the last figure or table.|
\Description
  It seems that you have used a |\subcaption| command without a
  corresponding |\caption| command. This is not supported.
\fi

\Message
  |The option `labelsep=|\meta{name}|' does not work|\\
  |with `format=hang'.|
\Or
  |The option `labelsep=|\meta{name}|' does not work|\\
  |with \setcaphanging (which is set by default).|
\Description
  Ein Bezeichnungstrenner, der ein |\\| Kommando enthält (wie etwa
  |labelsep=|\xx|newline|), kann nicht mit einem Format kombiniert werden,
  welches "`hängende"' Beschriftungen liefert (wie etwa |format=|\xx|hang|).
  Bitte wählen Sie entweder einen anderen Trenner (wie
  z.B. |labelsep=|\xx|colon|), oder aber ein anderes Beschriftungsformat
  (wie z.B. |format=|\xx|plain|) aus.
  \par\See{\Ref{formats} bzw.~\Ref*{KOMA}}

\Message
  |The package option `caption=false' is obsolete.|\\
  |Please pass this option to the subfig package instead|\\
  |and do *not* load the caption package anymore.|
\Description
  Sie haben die Option |caption=false| angegeben. Diese war früher mal eine
  Krücke, um nicht das komplette \package{caption}"=Paket zu laden, sondern
  nur den für das \package{subfig}"=Paket zwingend benötigten Teil.
  Dieser Mechanismus ist veraltet und wird nicht mehr angeboten; stattdessen
  sollten sie diese Option dem \package{subfig}"=Paket übergeben und
  \thispackage\ nicht mehr explizit laden.
  \par\See{Dokumentation des \package{subfig}"=Paketes\cite{subfig}}

\Message
  |Undefined boolean value `|\meta{value}|'.|
\Description
  Es wurde versucht, eine boolische Option (wie z.B.~|singlelinecheck=| oder
  |hypcap=|) auf einen unbekannten Wert zu setzen. Nur die Werte |false|, |no|,
  |off|, |0| bzw.~|true|, |yes|, |on| und |1| sind hier möglich.

\Message
  |Undefined format `|\meta{name}|'.|
\Description
  Es wurde versucht, ein Beschriftungsformat auszuwählen, welches nicht
  definiert ist. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{formats}}

\Message
  |Undefined label format `|\meta{name}|'.|
\Description
  Es wurde versucht, ein Bezeichnungsformat auszuwählen, welches nicht
  definiert ist. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{formats}}

\Message
  |Undefined label separator `|\meta{name}|'.|
\Description
  Es wurde versucht, ein Beschriftungstrenner auszuwählen, welcher nicht
  definiert ist. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{formats}}

\Message
  |Undefined list-of format `|\meta{name}|'.|
\Description
  Es wurde versucht, ein Listenformat auszuwählen, welches nicht
  definiert ist. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{listof}}

\Message
  |Undefined position `|\meta{name}|'.|
\Description
  Es wurde versucht, den Positionshinweis auf einen unbekannten Wert zu
  setzen. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{skips}}

\Message
  |Undefined style `|\meta{name}|'.|
\Description
  Es wurde versucht, ein Beschriftungsstil auszuwählen, welcher nicht
  definiert ist. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{style}}

\Message
  |Undefined text format `|\meta{name}|'.|
\Description
  Es wurde versucht, ein Textformat auszuwählen, welches nicht
  definiert ist. Vielleicht ein Schreibfehler!?
  \par\See{\Ref{formats}}

\Message
  |You can't use both, the (obsolete) caption2 *and*|\\
  |the (current) caption package.|
\Description
  Die Pakete \package{caption} und \package{caption2} können nicht
  innerhalb eines Dokumentes gleichzeitig verwendet werden.
  Verwenden Sie bitte nur das aktuelle \package{caption}"=Paket.
  \par\See{\Ref{caption2}}

\Message
  |You can't use the caption package option|\\
  |  `tableposition=|\meta{position}|'|\\
  |and use the |\meta{package}| package, too.|
\Or
  |You can't use the global option|\\
  |  `tablecaptionabove'|\\
  |and use the |\meta{package}| package, too.|
\Description
% (ftcap,nonfloat,topcapt)
  Das angegebene Paket mischt sich ebenfalls in die Verwendung der Abstände
  über- und unterhalb der Beschriftungen ein.
  Sie müssen sich daher für eines der Pakete -- das angegebene oder
  \thispackage\ -- zu entscheiden, um falsche Abstände zu verhindern.
  \par\See{\Ref{skips}}

\end{Warnings}

% --------------------------------------------------------------------------- %

\pagebreak[4]
\section{Weiterf"uhrende Dokumente}

Folgende, im Internet verfügbare Dokumente m"ochte ich an dieser Stelle
jedem ans Herz legen:

\begin{itemize}
\item
  Die \TeX\ FAQ -- "`Frequently Asked Questions"' über \TeX\ und \LaTeX:
  \begin{quote}\url{http://faq.tug.org/}\end{quote}

\iffalse
\item
  Die DANTE-FAQ -- Oft gestellte Fragen \& deren Antworten:
  \begin{quote}\url{http://www.dante.de/faq/de-tex-faq/}\end{quote}
\fi

\item
  \emph{"`Hilfe für LaTeX-Einsteiger"'} von Christian Faulhammer:
  \begin{quote}\url{http://www.minimalbeispiel.de/}\end{quote}

\item
  \emph{"`Gleitobjekte -- die richtige Schmierung"'} von Axel Reichert
  erl"autert den Umgang mit gleitenden Umgebungen und ist hier im Netz
  zu finden:
  \begin{quote}
    \url{ftp://dante.ctan.org/pub/tex/info/german/gleitobjekte/}
  \end{quote}

\item
  \emph{"`Bilder einfügen in \LaTeX: Ein How-To"'} von Dominik Bischoff
  beinhaltet die häufigsten Fragen und Antworten, die im Zusammenhang
  mit \LaTeX\ und Abbildungen auftreten:
  \begin{quote}
    \url{http://tug.ctan.org/info/l2picfaq/german/l2picfaq.pdf}
  \end{quote}

\item
  \textsf{epslatex} von Keith Reckdahl enth"alt viele n"utzliche Tips im
  Zusammenhang mit der Einbindung von Graphiken in \LaTeXe.
  Das Dokument ist in Englisch und unter
  \begin{quote}\url{ftp://dante.ctan.org/pub/tex/info/epslatex/}\end{quote}
  zu finden.
\end{itemize}

% --------------------------------------------------------------------------- %

\pagebreak[2]
\section{Danksagungen}

Von ganzem Herzen danke ich Katja Melzner,
Steven D. Cochran, Frank Mittelbach, Olga Lapko,
David Carlisle, Carsten Heinz und Keith Reckdahl.

Weiterhin m"ochte ich mich herzlich bei
Harald Harders,
Peter L\"offler,
Peng Yu,
Alexander Zimmermann,
Matthias Pospiech,
J\"urgen Wieferink,
Christoph Bartoschek,
Uwe St\"ohr,
Ralf Stubner,
Geoff Vallis,
Florian Keiler,
J"urgen G"obel,
Uwe Siart,
Sang-Heon Shim,
Henrik Lundell,
David Byers,
William Asquith,
Prof.~Dr.~Dirk Hoffmann,
Frank Martini
und
Danie Els
f"ur ihre Hilfe beim stetigen Verbessern dieses Paketes bedanken.

% --------------------------------------------------------------------------- %

\pagebreak[4]
\begin{thebibliography}{99}
  \bibitem{TLC2}
  Frank Mittelbach und Michel Goossens:\\
  \newblock {\em Der {\LaTeX} Begleiter (2.\,Auflage)},\\
  \newblock Addison-Wesley, 2004.

  \bibitem{beamer}
  Till Tantau:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/beamer/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/beamer/doc/beameruserguide.pdf}%
       {\emph{User Guide to the Beamer Class, Version 3.07}},\\
  March 11, 2007

  \bibitem{KOMAScript}
  Markus Kohm \& Jens-Uwe-Morawski:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/koma-script/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/koma-script/scrguide.pdf}%
       {\emph{KOMA-Script -- ein wandelbares \LaTeXe-Paket}},\\
  2007-03-02

  \bibitem{NTG}
  Victor Eijkhout:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/ntgclass/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/ntgclass/classdoc.pdf}%
       {\emph{An introduction to the Dutch \LaTeX\ document classes}},\\
  3 September 1989

  \bibitem{float}
  Anselm Lingnau:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/float/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/float/float.pdf}%
       {\emph{An Improved Environment for Floats}},\\
  2001/11/08

  \bibitem{floatflt}
  Mats Dahlgren:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatflt/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/floatflt/floatflt.pdf}%
       {\emph{Welcome to the floatflt package}},\\
  1998/06/05

  \bibitem{floatrow}
  Olga Lapko:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf}%
       {\emph{The floatrow package documentation}},\\
  2007/08/24

  \bibitem{fltpage}
  Sebastian Gross:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/fltpage/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/fltpage/fltpage.pdf}%
       {\emph{Welcome to the beta test of fltpage package!}},\\
  1998/11/13

  \bibitem{hyperref}
  Sebastian Rahtz \& Heiko Oberdiek:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/hyperref/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/hyperref/hyperref.pdf}%
       {\emph{Hypertext marks in \LaTeX}},\\
  June 14, 2007

  \bibitem{hypcap}
  Heiko Oberdiek:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/oberdiek/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/oberdiek/hypcap.pdf}%
       {\emph{The hypcap package -- Adjusting anchors of captions}},\\
  2007/04/09

  \bibitem{listings}
  Carsten Heinz \& Brooks Moses:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/listings/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/listings/listings.pdf}%
       {\emph{The Listings Package}},\\
  2007/02/22

  \bibitem{longtable}
  David Carlisle:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/required/tools/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/required/tools/longtable.pdf}%
       {\emph{The longtable package}},\\
  2004/02/01

  \bibitem{picinpar}
  Friedhelm Sowa:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex209/contrib/picinpar/}%
       {\emph{Pictures in Paragraphs}},\\
  July 13, 1993

  \bibitem{picins}
  Joachim Bleser und Edmund Lang:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex209/contrib/picins/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex209/contrib/picins/mpic.dvi}%
       {\emph{PicIns-Benutzerhandbuch Version 3.0}},\\
  September~1992

  \bibitem{rotating}
  Sebastian Rahtz und Leonor Barroca:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/rotating/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/rotating/}%
       {\emph{A style option for rotated objects in \LaTeX}},\\
  1997/09/26

  \bibitem{sidecap}
  Rolf Niepraschk \& Hubert G\"a\ss lein:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/sidecap/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf}%
       {\emph{The sidecap package}},\\
  2003/06/06

  \bibitem{subfigure}
  Steven D. Cochran:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfigure/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/subfigure/subfigure.pdf}%
       {\emph{The subfigure package}},\\
  2002/07/02

  \bibitem{subfig}
  Steven D. Cochran:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/subfig/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/subfig/subfig.pdf}%
       {\emph{The subfig package}},\\
  2005/07/05

  \bibitem{supertabular}
  Johannes Braams und Theo Jurriens:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/supertabular/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/supertabular/supertabular.pdf}%
       {\emph{The supertabular environment}},\\
  2002/07/19

  \bibitem{threeparttable}
  Donald Arseneau:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/misc/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/misc/threeparttable.sty}%
       {\emph{Three part tables: title, tabular environment, notes}},\\
  2003/06/13

  \bibitem{wrapfig}
  Donald Arseneau:\\
  \href{http://tug.ctan.org/tex-archive/macros/latex/contrib/wrapfig/}%
% \href{ftp://dante.ctan.org/tex-archive/macros/latex/contrib/wrapfig/wrapfig.sty}%
       {\emph{WRAPFIG.STY ver 3.6}},\\
  2003/01/31
\end{thebibliography}

% --------------------------------------------------------------------------- %

\end{document}