From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Mon, 2 Sep 2019 13:46:59 +0900
Subject: Initial commit

---
 .../contrib/threeparttable/threeparttable.tex      | 110 +++++++++++++++++++++
 1 file changed, 110 insertions(+)
 create mode 100644 macros/latex/contrib/threeparttable/threeparttable.tex

(limited to 'macros/latex/contrib/threeparttable/threeparttable.tex')

diff --git a/macros/latex/contrib/threeparttable/threeparttable.tex b/macros/latex/contrib/threeparttable/threeparttable.tex
new file mode 100644
index 0000000000..eb8c333a01
--- /dev/null
+++ b/macros/latex/contrib/threeparttable/threeparttable.tex
@@ -0,0 +1,110 @@
+\documentclass[a4paper]{article}
+\usepackage{miscdoc}
+\begin{document}
+\title{The \Package{threeparttable} package\thanks{This documentation
+    covers version 3.0 of the package, dated 2006-06-13}}
+\author{Donald Arseneau\thanks{Documentation put together by Robin
+    Fairbairns}}
+\maketitle
+
+\section{Outline}
+
+This package facilitates tables with titles (captions) and notes.  The
+title and notes are given a width equal to the body of the table (a
+tabular environment).  By itself, a \environment{threeparttable} does
+not float, but you can put it in a \environment{table} or a
+\environment{table*} or some other floating environment.  (This causes
+extra typing, but gives more flexibility.)
+
+Inside a \environment{threeparttable} there should be a caption,
+followed by a tabular environment (\environment{tabular},
+\environment{tabular*}, \environment{tabularx} or the like), possibly
+followed by a series of itemized \emph{tablenotes}.  (The caption may
+also go after the tabular environment.)
+
+For example:
+\begin{quote}
+\begin{verbatim}
+\begin{table}
+  \begin{threeparttable}[b]
+    \caption{...}
+    \begin{tabular}...% or {tabular*}
+      ...42\tnote{1}&....  ...
+    \end{tabular}
+    \begin{tablenotes}
+    \item [1] the first note ...
+    \end{tablenotes}
+  \end{threeparttable}
+\end{table}
+\end{verbatim}
+\end{quote}
+
+The {threeparttable} environment takes an optional vertical-placement
+parameter, \option[t], \option[b], or \option[c]; the default is
+\option[t].
+
+There is nothing automatic about the notes; you must specify the
+identifier in the body of the table (``\cmdinvoke{tnote}{a}'') and in
+the notes below the table (``\cmdinvoke{item}[a]\texttt{...}'').  The
+author chose this method because automatic numbering with \cs{footnote} would be very hard to use, particularly because many tables make
+repeated reference to a single note\footnote{If someone has a
+  convenient, elegant, automatic system, the author promises to
+  listen!}.  \cs{tnote} commands may be given in the caption too, and
+they will \textbf{not} appear in the list of tables.
+
+There are several commands which should be redefined for customizing the
+behaviour of \Package{threeparttable}, especially the table notes.
+Some options are provided for common variations of the table notes:
+\begin{description}
+\item[\option{para}]      Notes come one-after-another without line breaks
+\item[\option{flushleft}] No hanging indentation on notes
+\item[\option{online}]    \cs{item} tag is printed normal size, not superscript
+\item[\option{normal}]    restores default formatting
+\end{description}
+These options can be given to the \cs{usepackage} command or to each
+individual \environment{tablenotes} environment.  The
+\option[normal] option is intended to reverse the whole-document
+options for a particular table; e.g.
+\begin{quote}
+\begin{verbatim}
+\usepackage[para]{threeparttable}
+... document rambles on ...
+\begin{tablenotes}[normal,flushleft]
+\end{verbatim}
+\end{quote}
+These few options will not give you every format you might want, so
+you may find that you need to redefine one or more of the
+configuration commands.  Note that mixing options with redefinitions
+is unlikely to work smoothly: Please submit your redefinitions to be
+used as options in future versions!
+
+Configuration commands:
+\begin{itemize}
+\item \cs{TPTminimum}: command givining minimum caption width.
+  Default \texttt{4em}; change with \cs{def} or \cs{renewcommand}.
+\item \cs{TPTrlap}: A command with one argument, to make notes go out
+  of the column, into the column separation (for right-aligning)
+\item \cs{TPTtagStyle}: Command with one argument to set appearance of
+  the tag (number) in \cmdinvoke{tnote}{tag}.  It defaults to nil.  It
+  could be \cs{textit}.
+\item \cs{tnote}: Yes, you can redefine the \cs{tnote} command.
+\item \cs{TPTnoteLabel}: Command with one argument to format the item
+  label in the tablenotes list (\cs{makelabel}); default uses
+  \cs{tnote}.
+\item \cs{TPTnoteSettings}: A command to issue all the
+  list-environment setup commands for the tablenotes.
+\item \cs{tablenotes} or \cs{TPTdoTablenotes}: Yes, you can redefine
+  the whole tablenotes environment. (\cs{tablenotes} processes
+  optional parameters, then invokes \cs{TPTdoTablenotes}; the
+  \option[para] option replaces \cs{TPTdoTablenotes}).
+\end{itemize}
+For figures, there is an equivalent \environment{measuredfigure}
+environment. It is fairly fragile though, and should be used only for
+a single graphic above a single caption.
+
+Note that the \cs{caption} formatting is \emph{not} adjusted by
+\Package{threeparttable}.  You should use one of the caption-control
+packages to get captions that work well as table titles.  In truth,
+\Package{threeparttable} sets \cs{abovecaptionskip} to zero for
+captions above the table, but more complete changes are called for.
+\end{document}
-- 
cgit v1.2.3

