exsheets (9feb15)

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

3 files changed, 71 insertions, 25 deletions

diff --git a/Master/texmf-dist/doc/latex/exsheets/README b/Master/texmf-dist/doc/latex/exsheets/README
index 40dd109879c..00ebce19e10 100644
--- a/Master/texmf-dist/doc/latex/exsheets/README
+++ b/Master/texmf-dist/doc/latex/exsheets/README
@@ -1,9 +1,9 @@
 --------------------------------------------------------------------------
-EXSHEETS 2014/10/14
+EXSHEETS 2015/02/09
 bundled packages:
-the EXSHEETS package v0.17
+the EXSHEETS package v0.18
   Yet another package for the creation of exercise sheets
-the EXSHEETS-LISTINGS package v0.17
+the EXSHEETS-LISTINGS package v0.18
   Using listings in exsheets
 
 --------------------------------------------------------------------------
@@ -11,7 +11,7 @@ Clemens Niederberger
 Web:    https://bitbucket.org/cgnieder/exsheets/
 E-Mail: contact@mychemistry.eu
 --------------------------------------------------------------------------
-Copyright 2011-2014 Clemens Niederberger
+Copyright 2011-2015 Clemens Niederberger
 
 This work may be distributed and/or modified under the
 conditions of the LaTeX Project Public License, either version 1.3
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
index 1be4dfe0ada..8dcb6b2f494 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
index 4780f0d809f..2a9be5269cb 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
@@ -1,7 +1,7 @@
 % arara: pdflatex
-% !arara: biber
+% arara: biber
+% arara: pdflatex
 % arara: pdflatex
-% !arara: pdflatex
 % !arara: pdflatex
 % --------------------------------------------------------------------------
 % the EXSHEETS package
@@ -13,7 +13,7 @@
 % Web:    https://bitbucket.org/cgnieder/exsheets/
 % E-Mail: contact@mychemistry.eu
 % --------------------------------------------------------------------------
-% Copyright 2011-2014 Clemens Niederberger
+% Copyright 2011-2015 Clemens Niederberger
 % 
 % This work may be distributed and/or modified under the
 % conditions of the LaTeX Project Public License, either version 1.3
@@ -116,10 +116,10 @@
     bigstar,bottomrule,
     citetitle,cs,color,
     DeclareInstance,DeclareTemplateInterface,
-    endspacing,
+    endmdframed,endspacing,
     keyis,
     leftthumbsup,
-    midrule,
+    mdframed,midrule,
     rightarrow,rlap,
     s,sample,setlength,
     spacing,square,
@@ -180,7 +180,7 @@
 \addbibresource{biblatex-examples.bib}
 \addbibresource{\jobname.bib}
 
-\begin{filecontents}{\jobname.bib}
+\begin{filecontents*}{\jobname.bib}
 @online{tex.sx:131546,
   title   = {Fixing lstlisting inside \ExSheets\ \code{question} and
     \code{solution} environments} ,
@@ -197,7 +197,7 @@
   date    = {2013-09-18} ,
   urldate = {2013-09-22}
 }
-\end{filecontents}
+\end{filecontents*}
 
 % ----------------------------------------------------------------------------
 % example definitions that have to be done in the preamble:
@@ -467,6 +467,16 @@ in a full \TeX~Live or \hologo{MiKTeX} installation.
       is described in section~\ref{sec:solutions} on
       page~\pageref{option:use-saved-counter-format}.
   \end{itemize}
+
+\item[Version 0.18]
+  The package now provides the correct Danish translations, thanks to Jonas
+  Nyrup.
+
+  The macro \cs{exsheetsprintsolution} is introduced, see
+  page~\pageref{exsheetsprintsolution} for a little bit of an explanation.
+
+  The option \option{no-skip-below} is introduced which disables the insertion
+  of vertical space after the question and solution environments.
 \end{description}
 
 
@@ -483,7 +493,12 @@ first type are the classic package options which are used when you load
 \begin{sourcecode}
   \usepackage[<options>]{exsheets}
 \end{sourcecode}
-These options are described in section~\ref{sec:options}.
+All general options can be used this way and most of them are described in
+section~\ref{sec:options}.  All of those options also can be set via the setup
+command:
+\begin{commands}
+  \command{SetupExSheets}[\oarg{module}\marg{options}]
+\end{commands}
 
 The second type are options that belong to a specific environment or command.
 These options are either used directly with the environment/command
@@ -492,10 +507,10 @@ These options are either used directly with the environment/command
    ...
   \end{env}
 \end{sourcecode}
-or can be set with the setup command:
-\begin{commands}
-  \command{SetupExSheets}[\oarg{module}\marg{options}]
-\end{commands}
+or can also be set with the setup command.  In the first case they only act
+upon the environment or command where they're used.  In the second case they
+are set for all following uses of the corresponding environment or command.
+
 The options of the second type all belong to \module*{modules}.  Let's say you
 want to specify some options of the \env{question} environment.  You can then
 say the following:
@@ -516,7 +531,7 @@ an experimental and developping state.  This means that the sytax of the
 package may and possibly will change sometime in the future.  I cannot foresee
 what any consequences of that will be for \ExSheets.
 
-\section{Package Options}\label{sec:options}
+\section{General Options}\label{sec:options}
 The package \ExSheets\ has some options, namely the following ones:
 \begin{options}
   %% counter-format
@@ -544,14 +559,14 @@ The package \ExSheets\ has some options, namely the following ones:
     This code is placed immediately before the subtitle of the questions and
     solutions.  It only has an effect with a title instance that uses the
     subtitle coffin, see section~\ref{sec:exsheets-headings}.
-  % %% load-headings
-  % \keybool{load-headings}\Default{false}
-  %   Loads additional styles for the headings.  More on this is described in
-  %   section~\ref{sec:exsheets-headings}.
-  % %% load-tasks
-  % \keybool{load-tasks}\Default{false}
-  %   Loads additional styles for the \env{tasks} environment.  See
-  %   the \href{tasks_en.pdf}{documentation of the \Tasks\ package}.
+  % skip-below
+  \keyval{skip-below}{dim}\Default{.5\cs*{baselineskip}}
+    \sinceversion{0.18}Sets the vertical space that is inserted after the
+    question and solution environments.
+  % no-skip-below
+  \keybool{no-skip-below}\Default{false}
+    \sinceversion{0.18}Disables the insertion of vertical space after the
+    question and solution environments.
   %% totoc
   \keybool{totoc}\Default{false}
     This option adds the questions and solutions with their names and numbers
@@ -669,6 +684,12 @@ The \env{question} environment takes one or more of the following options:
     Adds a subtitle \meta{subtitle} for the question that is used by headings
     instances that make use of the subtitle coffin, see
     section~\ref{sec:exsheets-headings}.
+  \keyval{skip-below}{dim}\Module{question}\Default{.5\cs*{baselineskip}}
+    \sinceversion{0.18}Sets the vertical space that is inserted after the
+    question environment.
+  \keybool{no-skip-below}\Module{question}\Default{false}
+    \sinceversion{0.18}Disables the insertion of vertical space after the
+    question environment.
   \keybool{print}\Module{question}\Default{true}
     Prints or hides the question.
   \keyval{ID}{id}\Module{question}\Default
@@ -789,6 +810,12 @@ The \env{solutions} environment also has options, namely these:
     Sets a custom name.
   \keybool{print}\Module{solution}\Default{false}
     Prints or hides the solution.
+  \keyval{skip-below}{dim}\Module{solution}\Default{.5\cs*{baselineskip}}
+    \sinceversion{0.18}Sets the vertical space that is inserted after the
+    solution environment.
+  \keybool{no-skip-below}\Module{solution}\Default{false}
+    \sinceversion{0.18}Disables the insertion of vertical space after the
+    solution environment.
   \keyval{pre-hook}{code}\Module{solution}\Default
     \sinceversion{0.16}Adds \meta{code} directly before the solution title.
   \keyval{post-hook}{code}\Module{solution}\Default
@@ -1829,6 +1856,25 @@ What this package doesn't provide is changing the background of questions or
 framing them.  But this is easily possible using the \pkg{mdframed} package
 and its \cs*{surroundwithmdframed} command.
 
+\ExSheets{} also provides the options \option{pre-hook}, \option{post-hook},
+\option{pre-body-hook} and \option{post-body-hook} to both the question and
+the solution environment.  With them it is rather straightforward to add a
+\pkg{mdframed} frame for instance:
+\begin{sourcecode}
+  \SetupExSheets{
+    solution/pre-hook = \mdframed ,
+    solution/post-hook = \endmdframed
+  }
+\end{sourcecode}
+
+Last\sinceversion{0.18} but not least there is the macro
+\cs{exsheetsprintsolution}\marg{heading}\marg{body}\label{exsheetsprintsolution}
+which may be redefined to suit your needs. The default definition is
+equivalent to
+\begin{sourcecode}
+  \newcommand\exsheetsprintsolution[2]{#1#2}
+\end{sourcecode}
+
 \subsection{The \code{exsheets-headings} Object}\label{sec:exsheets-headings}
 \ExSheets\ defines the object \code{exsheets-headings} and one template for it,
 the `default' template.  The package also defines two instances of this