catechis (14jul18)

git-svn-id: svn://tug.org/texlive/trunk@48198 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 46 insertions, 4 deletions

diff --git a/Master/texmf-dist/source/latex/catechis/catechis.dtx b/Master/texmf-dist/source/latex/catechis/catechis.dtx
index 4eda60e7e6a..a752a15b4f2 100644
--- a/Master/texmf-dist/source/latex/catechis/catechis.dtx
+++ b/Master/texmf-dist/source/latex/catechis/catechis.dtx
@@ -25,7 +25,7 @@
 
 % \iffalse
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
-%<package>\ProvidesPackage{catechis}[2018/01/13 v2.0 Support for writing catechism questions and answers]
+%<package>\ProvidesPackage{catechis}[2018/07/13 v2.1 Support for writing catechism questions and answers]
 %<*driver>
 \documentclass{ltxdoc}
 
@@ -57,7 +57,7 @@
 \end{document}
 %</driver> \fi
 %
-% \title{The |catechis| Package, v2.0} \author{Donald P.\
+% \title{The |catechis| Package, v2.1} \author{Donald P.\
 % Goodman III} \date{\today}
 %
 % \maketitle
@@ -301,6 +301,31 @@
 % canst not be false to any man.}{Polonius}
 % \exline
 %
+% Because this will often not result in proper spacing,
+% |catechis| provides an environment,
+% \DescribeMacro{catcitations}|catcitations|, which
+% will insert appropriate spacing before and after the
+% citations.  This environment will automatically run
+% |\catcitetitle| for you.
+%
+% \begin{verbatim}
+% \begin{catcitations}
+% \catcite{For the apparel oft proclaims the man.}{Polonius}
+% \catcite{And this above all: to thine own self be true; /
+% and it must follow, as the night the day, / that thou
+% canst not be false to any man.}{Polonius}
+% \end{catcitations}
+% \end{verbatim}
+%
+% \exline
+% \begin{catcitations}
+% \catcite{For the apparel oft proclaims the man.}{Polonius}
+% \catcite{And this above all: to thine own self be true; /
+% and it must follow, as the night the day, / that thou
+% canst not be false to any man.}{Polonius}
+% \end{catcitations}
+% \exline
+%
 % Lastly, |catechis| gives some provisions for more
 % customary catechetical enumerates.  It uses standard
 % features from the |paralist| package for this, and simply
@@ -359,7 +384,7 @@
 % is defined as |\renewcommand{\thecatquesnum}{\arabic{catquesnum}.}|.
 % \vitem|\catquesnumwd| \DescribeMacro{\catquesnumwd}  The
 % width of the box in which |catechis| typesets the question
-% numbe.  By default, |2em|.
+% number.  By default, |2em|.
 %	\vitem|\catquesindent| \DescribeMacro{\catquesindent}
 %	The indentation of the first line of the question in
 %	|\catques|.  By default, |0em|.
@@ -403,6 +428,12 @@
 % \vitem|\catcitetitlesty| \DescribeMacro{\catcitetitlesty}
 % The style in which |\catcitetitle| will print its
 % contents.  By default, |\Large\scshape|.
+% \vitem|\catcitationbefskip| \DescribeMacro{\catcitationbefskip}
+% The distance to skip prior to beginning a |catcitations|
+% environment, before running |\catcitetitle|.
+% \vitem|\catcitationaftskip| \DescribeMacro{\catcitationaftskip}
+% The distance to skip after ending a |catcitations|
+% environment.
 %	\vitem|\catciteindent| \DescribeMacro{\catciteindent} The
 %	indentation of the first line of the citation itself
 %	(that is, the quotation) in a |\catcite|.  By default,
@@ -508,7 +539,7 @@
 }%
 %    \end{macrocode}
 % Define the commands to produce citation titles, and set
-% sensible defaults.
+% sensible defaults; also for the citation environment.
 %    \begin{macrocode}
 \def\catcitetitlesty{\Large\scshape}%
 \def\catcitetitleword{Citations}%
@@ -517,6 +548,17 @@
 		\catcitetitlesty\catcitetitleword%
 	\end{center}%
 }%
+\newlength\catcitationbefskip\catcitationbefskip=1em%
+\newlength\catcitationaftskip\catcitationaftskip=1em%
+\def\catcitations{%
+	\leavevmode%
+	\vskip\catcitationbefskip%
+	\catcitetitle%
+}%
+\def\endcatcitations{%
+	\leavevmode%
+	\vskip\catcitationaftskip%
+}%
 %    \end{macrocode}
 % Define actual citations macros and lengths.
 %    \begin{macrocode}