Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions captdef.tex
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,13 @@ \section{Why this package?}
creates things that look as if they were created by \cs{caption}, and
which work outside of a float.

The \textsf{float} package provides an alternative to
\cs{captdef}-defined commands, in the float \texttt{[H]} option
The \Package{float} package provides an alternative to
\cs{DeclareCaption}-defined commands, in the float \texttt{[H]} option
(``place the environment \emph{here} without doing any of this
floating stuff''). So why use \Package{captdef}?\,---\,its great
advantage is simplicity; you load it, and it defines just \emph{three}
macros, while \textsf{float} defines lots and lots. (Of course, if
you need others of \textsf{float}'s capabilities, \textsf{captdef}
you need others of \textsf{float}'s capabilities, \Package{captdef}
loses its advantage\dots).

\section{How the package works}
Expand All @@ -45,13 +45,13 @@ \section{How the package works}
The package then goes on to declare the commonly-needed caption
commands \cs{figcaption} and \cs{tabcaption}:
\begin{quote}
\cmdinvoke{captdef}{\cs{figcaption}}{figure}\\
\cmdinvoke{captdef}{\cs{tabcaption}}{table}
\cmdinvoke{DeclareCaption}{\cs{figcaption}}{figure}\\
\cmdinvoke{DeclareCaption}{\cs{tabcaption}}{table}
\end{quote}

\section{The potential problem}

Commands defined by \cs{captdef} place a caption in text, and also step the
Commands defined by \cs{DeclareCaption} place a caption in text, and also step the
\environment{figure} (or \environment{table} or whatever) counter. The float
environments do the same.

Expand Down Expand Up @@ -96,7 +96,7 @@ \section{The potential problem}
if a single one won't fit).

The moral of that little tale is to say: don't use
\cs{captdef}-defined commands with floats of the same type in the same
\cs{DeclareCaption}-defined commands with floats of the same type in the same
document. (Or be extra-specially careful about what's happening if
you must.)
\end{document}