v 0.10 - make some special behavior optional

1 files changed, 23 insertions, 10 deletions

diff --git a/exercisesheets.tex b/exercisesheets.tex
index b1d0fff..a8bf2ff 100644
--- a/exercisesheets.tex
+++ b/exercisesheets.tex
@@ -1,5 +1,5 @@
 %% exercisesheets.tex
-%% Copyright 2008-2017 Sebastian Kuhnert, Frank Fuhlbrück
+%% Copyright 2008-2022 Sebastian Kuhnert, Frank Fuhlbrück
 %
 % This work may be distributed and/or modified under the conditions
 % of the LaTeX Project Public License, either version 1.3c of this
@@ -10,7 +10,7 @@
 %
 % This work has the LPPL maintenance status `maintained'.
 %
-% The Current Maintainer of this work is Sebastian Kuhnert.
+% The Current Maintainer of this work is Frank Fuhlbrück.
 %
 % This work consists of the files listed in README.
 
@@ -53,7 +53,7 @@
 \usepackage[english,iso]{isodate}
 \title{The \exsh Package}
 \author{Sebastian Kuhnert\and Frank Fuhlbrück}
-\date{Version 0.9, \printdateTeX{2022/01/07}}
+\date{Version 0.10, \printdateTeX{2022/01/12}}
 
 \begin{document}
 \maketitle
@@ -179,12 +179,18 @@ The following options are available:
  \item[\option{exercisespath}] Set the (relative) path of the 
   directory containing exercises to be included via 
   \verb|\includeexercise|.
+ \item[\option{patchenumerate}\opt{=\param{true/false}}] Sets
+  enumerate item labels for the first four levels, starting with
+  a), b) etc. for the top-level (sub-exercises). Depending on other 
+  loaded packages (\verb|enumitem|, \verb|paralist|) the mechanism
+  slightly differs. This option is active by default.
+  
  \item[\option{showtodos} / \option{hidetodos}] 
   \verb|\TODO| markers
   are hidden by default, this option switches their behavior. This 
   option is usually set within \verb|\ifsamplesolutions| or 
   similar.
- \item[\option{beamercompatibility}] 
+ \item[\option{beamercompatibility}\opt{=\param{true/false}}] 
   This options (which only is effective in the non-beamer version)
   defines several beamer macros with as trivial 
   effects as possible, e.g., \verb|\pause| becomes \verb|\relax|
@@ -192,7 +198,9 @@ The following options are available:
   this option after loading \verb|enumitem| etc. as the enumerate 
   and itemize environment are defined to swallow overlay 
   specifications without effect, this also holds for
-  \verb|\item<1->|. The current list of redefinitions is as 
+  \verb|\item<1->|. If you load \verb|exercisesheets| before them
+  use \verb|\exshset| afterwards.
+  The current list of redefinitions is as 
   follows:
 \begin{lstlisting}
   \let\pause\relax
@@ -275,10 +283,15 @@ The following \param{options} are supported:
   Useful to inform students when the sheet is due. If you want a note consisting
   of more than one line split at a particular position, use
   \verb|\protect\linebreak|.
- \item[\option{title=\param{title}}] Deviate from the usual numbering theme and
-  directly set the sheet title. When this option is used, exercise numbers are
-  reset and different page numbering conventions are used. This is useful to
-  typeset exams.
+ \item[\option{title=\param{title}}] 
+  Directly set the sheet title. When this option is used, different 
+  page numbering conventions are used. This is useful to
+  typeset exams (combined with the next option).
+ \item[\option{number within sheet\opt{=\param{true/false}}}]   
+  Deviate from the usual numbering theme and
+  restart from one for exercises on the sheet. The previous 
+  counter value is restored after the sheet, so you can insert 
+  a special sheet.
  \item[\option{author=\param{author}}] Set the author included in the sheet
   head. By default, the value passed to \verb|\author| is used.
  \item[\option{exauthor=\param{exauthor}}] Only used by \exsh-beamer,
@@ -410,7 +423,7 @@ TODO markers (s.a.) the warning will be issued nevertheless.
 
 \subsection{Annotating Points for Sub-Exercises}
 \begin{lstlisting}
-\begin{exercise}[points=10]
+\begin{exercise}[points=sum]%sum produces 7+6
   \begin{enumerate}
    \item Part 1 \points{oral}
    \item Part 2 \points[optional]{oral}