From 14d99d3e545f4db9381dc9da8616ffdd33962ce5 Mon Sep 17 00:00:00 2001
From: Frank Fuhlbrück
Date: Thu, 7 Mar 2024 13:24:24 +0100
Subject: v0.16: embedded mode

---
 exercisesheets.tex | 49 +++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 45 insertions(+), 4 deletions(-)

(limited to 'exercisesheets.tex')

diff --git a/exercisesheets.tex b/exercisesheets.tex
index 25ad9b8..30cbd1c 100644
--- a/exercisesheets.tex
+++ b/exercisesheets.tex
@@ -1,5 +1,5 @@
 %% exercisesheets.tex
-%% Copyright 2008-2023 Sebastian Kuhnert, Frank Fuhlbrück
+%% Copyright 2008-2024 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
@@ -53,7 +53,7 @@
 \usepackage[english,iso]{isodate}
 \title{The \exsh Package}
 \author{Sebastian Kuhnert\and Frank Fuhlbrück}
-\date{Version 0.15.1, \printdateTeX{2023/12/14}}
+\date{Version 0.16, \printdateTeX{2024/03/07}}
 
 \begin{document}
 \maketitle
@@ -64,7 +64,7 @@ finally combined into this package. Starting from Version 0.7, there was an alte
 
 
 \subsection*{Licence}
-Copyright \textcopyright{} 2008--2023 Sebastian Kuhnert and Frank Fuhlbrück.
+Copyright \textcopyright{} 2008--2024 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
@@ -183,7 +183,43 @@ The following options are available:
   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{settitle}\opt{=\param{true/false}}] If set to true
+  (which is the default),
+  the document \verb|\title| will be automatically set to the value
+  of \option{strings/sheets} and the value of \option{strings/
+  solutions} will be
+  appended if \option{solutions} is not \option{false}.
+ \item[\option{patchpagenumbers}\opt{=\param{true/false}}] If true
+  (default), pages will be numbered within sheets and page numbers
+  get a prefix of the form ``\param{sheet number}\verb|-|''.
+ \item[\option{usestartsection}\opt{=\param{true/false}}] If true
+  (default), the command \verb|\@startsection| is used to create
+  the header of any exercise as a section, which (among other
+  things) adds an entry to the TOC (if existent) at level 1
+  (usually corresponding to \verb|\section|).
+ \item[\option{embedded}\opt{=\param{true/false}}] Default: false.
+  Embedded mode allows for exercise ``sheets'' which do not
+  interfere with a surrounding document. More explicitly, it does
+  not interfere with \verb|secnumdepth|, defines special counters
+  \verb|exshsheet| and \verb|exshexercise| to use them for
+  \option{sheet counter} and \option{exercise counter},
+  respectively and sets all of \option{patchenumerate},
+  \option{settitle}, \option{patchpagenumbers} and
+  \option{usestartsection} to \option{false}.
+  An internally defined macro which basically does no extra
+  formatting or adding anything to the TOC is used as
+  \option{sheet sectioning cmd} instead of the usual \verb|part|.
+  Finally,
+  the \option{sheet start page action} and the
+  \option{sheet end page action} are both set to \verb|\relax|.
+  If you want to override any of this, do it after setting
+  \option{embedded} to \option{true}.
+ \item{\option{minskips\opt{=\param{true/false}}}} Default: false.
+  If true, the values of
+  \option{above sheet title skip},
+  \option{below sheet header skip},
+  \option{above first exercise skip} and
+  \option{below exercise title skip} are all set to 0pt.
  \item[\option{showtodos} / \option{hidetodos}]
   \verb|\TODO| markers
   are hidden by default, this option switches their behavior. This
@@ -884,6 +920,11 @@ Since version \verb|0.15| this package can be used with make4ht and tex4ebook in
 \label{sec:changelog}
 
 \begin{itemize}
+    \item[v. 0.16:]  2024-03-07
+      \begin{itemize}
+        \item Embedded mode and most of the additional options it
+        automatically sets.
+      \end{itemize}
     \item[v. 0.15.1:]  2023-12-14
       \begin{itemize}
         \item bugfix: beamer support was broken in 0.15 due to
-- 
cgit v1.2.3

