From e480192748bfcf90d6b341056638d42ccc67c265 Mon Sep 17 00:00:00 2001
From: Frank Fuhlbrück
Date: Thu, 15 Oct 2020 09:21:05 +0200
Subject: Beamer-Version

---
 exercisesheets.tex | 39 +++++++++++++++++++++++++++++++++++----
 1 file changed, 35 insertions(+), 4 deletions(-)

(limited to 'exercisesheets.tex')

diff --git a/exercisesheets.tex b/exercisesheets.tex
index 760c5f9..9c1d67c 100644
--- a/exercisesheets.tex
+++ b/exercisesheets.tex
@@ -53,17 +53,20 @@
 \usepackage[english,iso]{isodate}
 \title{The \exsh Package}
 \author{Sebastian Kuhnert\and Frank Fuhlbrück}
-\date{Version 0.6, \printdateTeX{2019/2/11}}
+\date{Version 0.7, \printdateTeX{2020/10/15}}
 
 \begin{document}
 \maketitle
 
 The \exsh package provides a way to typeset exercise sheets as used in
 university courses. It evolved from a set of macros an environments that were
-finally combined into this package.
+finally combined into this package. Starting from Version 0.7, there
+is an alternative variant designed for use eith the beamer package.
+This variant is called exercisesheets-beamer. Not all combinations of options have been testet with the beamer variant.
+
 
 \subsection*{Licence}
-Copyright \textcopyright{} 2008--2019 Sebastian Kuhnert and Frank Fuhlbrück.
+Copyright \textcopyright{} 2008--2020 Sebastian Kuhnert and Frank Fuhlbrück.
 Permission is granted to copy, distribute and/or modify this software under the
 terms of the \LaTeX{} Project Public Licence, version 1.3c or later. This
 package is maintained, the Current Maintainer is Sebastian
@@ -114,6 +117,10 @@ Kuhnert\footnote{\href{mailto:mail@sebastian-kuhnert.de}{mail@sebastian-kuhnert.
 \section{Basic Usage}
 
 \subsection{Package Loading}
+There are two versions of the package: one for article and similar
+classes and one for the beamer document class. If you want the latter,
+replace \enquote{exercisesheets} with \enquote{exercisesheets-beamer}.
+
 \begin{lstlisting}
 \usepackage(*\opt{[\param{options}]}*){exercisesheets}
 \end{lstlisting}
@@ -191,6 +198,16 @@ automatically generate an appropriate one (this may require an additional
 All this information is included in the PDF meta-data if the \texttt{hyperref}
 package is loaded with the option \texttt{pdfusetitle}.
 
+There is also a related option:
+\begin{description}
+ \item[\option{exauthor=\param{list of names}}] If you want to use the
+ \lstinline|\author| macro for the general author of a course but
+ there are different authors for individual exercises or all
+ exercises in general, you can set this key. Currently only
+ exercisesheets-baemer uses this for the footline, while 
+ \option{author} is used for the headline.
+\end{description}
+
 \subsection{Defining Exercise Sheets}
 \label{sec:sheet}
 \begin{lstlisting}
@@ -220,6 +237,8 @@ The following \param{options} are supported:
   typeset exams.
  \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,
+ see above.
  \item[\option{subject=\param{subject}}] Set the subject included in the sheet
   head. By default, the value passed to \verb|\subject| is used.
  \item[\option{semester=\param{semester}}] Set the semester included in the
@@ -235,10 +254,19 @@ The following \param{options} are supported:
   \begin{solution}(*\opt{[\param{solution options}]}*)
     (*\param{solution text}*)
   \end{solution}
+  \begin{beamersolution}(*\opt{[\param{solution options}]}*)
+    (*\param{solution text}*)
+  \end{beamersolution}
 \end{exercise}
 \end{lstlisting}
 
-This inserts an exercise into the current document. The following options are
+This inserts an exercise into the current document. All
+\option{beamersolution}s are ignored, if the usual 
+\exsh package is loaded, but \exsh-beamer also processes
+normal solututions by default (set option \option{beamersolution}
+to turn this off).
+
+The following options are
 supported:
 \begin{description}
  \item[\option{name=\param{text}}] Use \param{text} as the name of the exercise.
@@ -263,6 +291,9 @@ supported:
   document (or sheet) default.
  \item[\option{sample}] Include this exercise (and its solution) in while compiling
  sample solutions.
+ \item[\option{beamersolution}] For \exsh-beamer only. If this option
+ is set all normal solutions will not be included and only 
+ \option{beamersolution}s are typeset.
 \end{description}
 
 Solutions are only typeset, if the \option{solutions} option is in effect. There
-- 
cgit v1.2.3

