path: root/Master/texmf-dist/source/latex/exsol/exsol.dtx

% \iffalse meta-comment
%
% Copyright (C) 2012 by Walter Daems <walter.daems@ua.ac.be>
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, either version 1.3 of this license
% or (at your option) any later version.  The latest version of this
% license is in:
% 
%    http://www.latex-project.org/lppl.txt
% 
% and version 1.3 or later is part of all distributions of LaTeX version
% 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
% 
% The Current Maintainer of this work is Walter Daems.
%
% This work consists of the files exsol.dtx and exsol.ins and the derived 
% files:
%   - exsol.sty
%   - example.tex
%   - example-solutionbook.tex
%
% \fi
%
% \iffalse
%
%<package|driver>\NeedsTeXFormat{LaTeX2e}
%<driver>\ProvidesFile{exsol.dtx}
%<package>\ProvidesPackage{exsol}
%<package|driver>  [2013/05/12 v0.6 ExSol - Exercises and Solutions package (DMW)]
\def\fileversion{0.6}
\def\filedate{2013/05/12}
%<*driver> 
\documentclass[11pt]{ltxdoc}
\usepackage[english]{babel}
\usepackage[exercisesfontsize=small]{exsol}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
\usepackage{makeidx}
\usepackage{alltt}
\IfFileExists{tocbibind.sty}{\usepackage{tocbibind}}{}
\IfFileExists{hyperref.sty}{\usepackage[bookmarksopen]{hyperref}}{}
\EnableCrossrefs         
\CodelineIndex
\RecordChanges
\newcommand{\exsol}{\textsf{ExSol}}
\StopEventually{\PrintChanges\PrintIndex}
\begin{document}
 \DocInput{exsol.dtx}
\end{document}
%</driver>
% \fi
%
% \CheckSum{0}
%
% \CharacterTable
%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%   Digits        \0\1\2\3\4\5\6\7\8\9
%   Exclamation   \!     Double quote  \"     Hash (number) \#
%   Dollar        \$     Percent       \%     Ampersand     \&
%   Acute accent  \'     Left paren    \(     Right paren   \)
%   Asterisk      \*     Plus          \+     Comma         \,
%   Minus         \-     Point         \.     Solidus       \/
%   Colon         \:     Semicolon     \;     Less than     \<
%   Equals        \=     Greater than  \>     Question mark \?
%   Commercial at \@     Left bracket  \[     Backslash     \\
%   Right bracket \]     Circumflex    \^     Underscore    \_
%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%   Right brace   \}     Tilde         \~}
%
%
% \changes{v0.1}{2012/01/05}{. Initial version}
% \changes{v0.2}{2012/01/06}{. Minor bug fixes based on first use by
% Paul Levrie}
% \changes{v0.3}{2012/01/07}{. Minor bug fixes based on second use by
% Paul}
% \changes{v0.4}{2012/01/09}{. Allowed for non-list formatting of
% exercises (as default)}
% \changes{v0.5}{2012/01/15}{. Added option to also send exercises to
% solutions file}
% \changes{v0.6}{2013/05/12}{. Prepared for CTAN publication}
%
% \DoNotIndex{\newcommand,\newenvironment}
% \setlength{\parindent}{0em}
% \addtolength{\parskip}{0.5\baselineskip}
%
% \title{The \exsol{} package\thanks{This document
%   corresponds to exsol~\fileversion, dated \filedate.}}
% \author{Walter Daems (\texttt{walter.daems@ua.ac.be})}
% \date{}
%
% \maketitle
%
% \section{Introduction}
% %%%%%%%%%%%%%%%%%%%%%%
% The package \exsol{} provides macros to allow
% embedding exercises and solutions in the \LaTeX{} source of an
% instructional text (e.g., a book or a course text) while generating
% the following separate documents:
% \begin{itemize}
% \item your original text that only contains the exercises, and
% \item a solution book that only contains the solutions to the
% exercises (a package option exists to also copy the exercises themselves to the solution book).
% \end{itemize}
% 
% The former is generated when running \LaTeX{} on your document. This
% run writes the solutions to a secondary file that can be included
% into a simple document harness, such that when running \LaTeX{} on
% the latter, you can generate a nice solution book.
% 
% Why use \exsol{}?
% \begin{itemize}
% \item It allows to keep the \LaTeX{} source of your exercises and their
% solutions in a single file. Away with the nightmare to keep your
% solutions in sync with the original text.
% \item It separates exercises and solutions, allowing you
%   \begin{itemize}
%   \item to only release the solution book to the instructors of the
%   course;
%   \item to encourage students that you provide with the solution
%   book to first try solving the exercises without opening the book;
%   this seems to be easier than not peeking into the solution of an
%   exercise that is typeset just below the exercise itself.
%   \end{itemize}
% \end{itemize}
%
% The code of the \exsol{} package was taken almost literally
% from \textsf{fancyvrb} \cite{fancyvrb}. Therefore, all credits go to the
% authors/maintainers of \textsf{fancyvrb}.
%
% \section{Installation}
% %%%%%%%%%%%%%%%%%%%%%%
% Either you are a package manager and then you'll know how to
% prepare an installation package for \exsol{}.
%
% Either you are a normal user and then you have two options. First,
% check if there is a package that your favorite \LaTeX{}
% distributor has prepared for you. Second, grab the TDS package
% from CTAN \cite{CTAN} (\texttt{exsol.tds.zip}) and unzip it somewhere in your
% own TDS tree, regenerate your filename database and off you go.
% In any case, make sure that \LaTeX{} finds the \texttt{exsol.sty} file.
%
% The \exsol{} package uses some auxiliary packages: \textsf{fancyverb},
% \textsf{ifthen}, \textsf{kvoptions} and, optionally,
% \textsf{babel}. Fetch them from CTAN \cite{CTAN} if your \TeX{}
% distributor does not provide them.
%
% \section{Usage}
% %%%%%%%%%%%%%%%
% 
% \subsection{Preparing your document source}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% The macro package exsol can be loaded with:
% \begin{verbatim}
% \usepackage{exsol}
% \end{verbatim}
%
% Then, you are ready to add some exercises including their solution
% to your document source. To this end, embed them in a
% \texttt{exercise} and a corresponding \texttt{solution} environment.
% Optionally, you may embed several of them in a \texttt{exercises}
% environment, to make them stand out in your text.
% E.g.,
%
% \begin{VerbatimOut}{exsol.tmp}
% 
% \begin{exercises}
%
%   \begin{exercise}
%     Solve the following equation for $x \in C$, with $C$ the set of
%     complex numbers:
%     \begin{equation}
%       5 x^2 -3 x = 5
%     \end{equation}
%   \end{exercise}
%
%   \begin{solution}
%     Let's start by rearranging the equation, a bit:
%     \begin{eqnarray}
%       5.7 x^2 - 3.1 x &=& 5.3\\
%       5.7 x^2 - 3.1 x -5.3 &=& 0
%     \end{eqnarray}
%     The equation is now in the standard form:
%     \begin{equation}
%       a x^2 + b x + c = 0
%     \end{equation}
%     For quadratic equations in the standard form, we know that two
%     solutions exist:
%     \begin{equation}
%       x_{1,2} = \frac{ -b \pm \sqrt{d}}{2a}
%     \end{equation}
%     with
%     \begin{equation}
%       d = b^2 - 4 a c
%     \end{equation}
%     If we apply this to our case, we obtain:
%     \begin{equation}
%       d = (-3.1)^2 - 4 \cdot 5.7 \cdot (-5.3) = 130.45
%     \end{equation}
%     and
%     \begin{eqnarray}
%       x_1 &=& \frac{3.1 + \sqrt{130.45}}{11.4} = 1.27\\
%       x_2 &=& \frac{3.1 - \sqrt{130.45}}{11.4} = -0.73
%     \end{eqnarray}
%     The proposed values $x = x_1, x_2$ are solutions to the given equation.
%   \end{solution}
%
%   \begin{exercise}
%     Consider a 2-dimensional vector space equipped with a Euclidean
%     distance function. Given a right-angled triangle, with the sides
%     $A$ and $B$ adjacent to the right angle having lengths, $3$ and
%     $4$, calculate the length of the hypotenuse, labeled $C$.
%   \end{exercise}
%   \begin{solution}
%     This calls for application of Pythagoras' theorem, which 
%     tells us:
%     \begin{equation}
%       \left\|A\right\|^2 + \left\|B\right\|^2 = \left\|C\right\|^2
%     \end{equation}
%     and therefore:
%     \begin{eqnarray}
%       \left\|C\right\| 
%       &=& \sqrt{\left\|A\right\|^2 + \left\|B\right\|^2}\\
%       &=& \sqrt{3^2 + 4^2}\\
%       &=& \sqrt{25} = 5
%     \end{eqnarray}
%     Therefore, the length of the hypotenuse equals $5$.
%   \end{solution}
%
% \end{exercises}
% \end{VerbatimOut}
% \VerbatimInput[frame=lines,gobble=2,fontsize=\footnotesize]{exsol.tmp}
%
% The result in the original document, can be seen below. As you can
% see, there's no trace of the solution. 
%
% \input{exsol.tmp}
%
% When running \LaTeX{} on your document (in our case on the
% \texttt{exsol.dtx} file, as a side effect a file with extension
% \texttt{.sol.tex} has been written to disk (in our case, the file
% \texttt{exsol.sol.tex}), containing all solutions in sequence.
%
% Generating a solution book is a simple as including the file into a
% simple harness, that allows you giving it a proper title page and to
% add other bells and whistles.
%
% E.g.,
% \begin{VerbatimOut}{exsol-solutionbook.tex}
% \documentclass{article}
% \usepackage[english]{babel}
% \title{Solutions to the exercises, specified in the \textsf{ExSol} package}
% \author{Walter Daems}
% \date{2013/05/12}
%
% \begin{document}
%
% \maketitle
%
% \input{exsol.sol}
%
% \end{document}
% \end{VerbatimOut}
% \VerbatimInput[frame=lines,gobble=2,fontsize=\footnotesize]{exsol-solutionbook.tex}
% 
% You may generate this solution book, by running \LaTeX{} on the
% file named \texttt{exsol-solutionbook.tex} that is generated when running
% \LaTeX{} on the \texttt{exsol.dtx} file.
%
% The result approximately looks like this:
%
% \setcounter{equation}{0}
% \rule{\linewidth}{.7pt}
% \begin{center}
% {\Large Solutions to the exercises, specified in the \textsf{ExSol} package}\\
% {\large Walter Daems}\\
% {\large 2013/05/12}
% \end{center}
% \par---\newline\textbf{Solution 3.1-1}
%     Let's start by rearranging the equation, a bit:
%     \begin{eqnarray}
%       5.7 x^2 - 3.1 x &=% 5.3\\
%       5.7 x^2 - 3.1 x -5.3 &=% 0
%     \end{eqnarray}
%     The equation is now in the standard form:
%     \begin{equation}
%       a x^2 + b x + c = 0
%     \end{equation}
%     For quadratic equations in the standard form, we know that two
%     solutions exist:
%     \begin{equation}
%       x_{1,2} = \frac{ -b \pm \sqrt{d}}{2a}
%     \end{equation}
%     with
%     \begin{equation}
%       d = b^2 - 4 a c
%     \end{equation}
%     If we apply this to our case, we obtain:
%     \begin{equation}
%       d = (-3.1)^2 - 4 \cdot 5.7 \cdot (-5.3) = 130.45
%     \end{equation}
%     and
%     \begin{eqnarray}
%       x_1 &=& \frac{3.1 + \sqrt{130.45}}{11.4} = 1.27\\
%       x_2 &=& \frac{3.1 + \sqrt{130.45}}{11.4} = -0.73
%     \end{eqnarray}
%     The proposed values $x = x_1, x_2$ are solutions to
%     the given equation.
% \par---\newline\textbf{Solution 3.1-2}
%       This calls for application of Pythagoras' theorem, which
%       tells us:
%       \begin{equation}
%         \left\|A\right\|^2 + \left\|B\right\|^2 = \left\|C\right\|^2
%       \end{equation}
%       and therefore:
%       \begin{eqnarray}
%         \left\|C\right\|
%         &=& \sqrt{\left\|A\right\|^2 + \left\|B\right\|^2}\\
%         &=& \sqrt{3^2 + 4^2}\\
%         &=& \sqrt{25} = 5
%       \end{eqnarray}
%       Therefore, the length of the hypotenuse equals $5$.
%
% \rule{\linewidth}{.7pt}
%
% \clearpage
%
% \section{Implementation}
% %%%%%%%%%%%%%%%%%%%%%%%
%    \begin{macrocode}
%<*package>
%    \end{macrocode}
%
% \subsection{Auxiliary packages}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% The package uses some auxiliary packages:
%    \begin{macrocode}
\RequirePackage{fancyvrb}
\RequirePackage{ifthen}
\RequirePackage{kvoptions}
%    \end{macrocode}
%
% \subsection{Package options}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%
% The package offers some options:
%
% \changes{v0.2}{2012/01/06}{Added option exercisesfont}
% \changes{v0.4}{2012/01/09}{Changed name of option to exercisesfontsize}
%
% \begin{macro}{exercisesfontsize}
%  This option allows setting the font of the \texttt{exercises}
%  environment. You may chopse one of tiny, scriptsize, footnotesize,
%  small, normalsize, large, etc.\\
%  E.g., \texttt{[exercisesfontsize=small]}.
%    \begin{macrocode}
\DeclareStringOption[normalsize]{exercisesfontsize}
%    \end{macrocode}
% \end{macro}
%
% \changes{v0.4}{2012/01/06}{Added option exercisesinlist}
% \changes{v0.5}{2012/01/09}{Changed option exercisesinlist to exerciseaslist}
%
% \begin{macro}{exerciseaslist}
%  This boolean option (true, false) allows setting the typesetting of
%  the \texttt{exercises} in a list environment. This causes the
%  exercises to be typeset in a more compact fashion, with indented
%  left and right margin. 
%    \begin{macrocode}
\DeclareBoolOption[false]{exerciseaslist}
%    \end{macrocode}
% \end{macro}
%
% \changes{v0.5}{2012/01/09}{Added option copyexercisesinsolutions}
% \begin{macro}{copyexercisesinsolutions}
%  This boolean option (true, false) allows copying the exercises in
%  the solutions file, to allow for making a complete stand-alone
%  exercises bundle.
%    \begin{macrocode}
\DeclareBoolOption[false]{copyexercisesinsolutions}
%    \end{macrocode}
% \end{macro}
%
% The options are processed using:
%    \begin{macrocode}
\ProcessKeyvalOptions*
%    \end{macrocode}
%
% The options are subsequently handled
%    \begin{macrocode}
\newcommand{\exercisesfontsize}{\csname \exsol@exercisesfontsize\endcsname}
%    \end{macrocode}
%
% \subsection{Con- and destruction of the auxiliary streams}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% At the beginning of your document, we start by opening a stream to a
% file that will be used to write the solutions to. At the end of your
% document, the package closes the stream.
%    \begin{macrocode}
\AtBeginDocument{
  \newwrite\solutionstream
  \immediate\openout\solutionstream=\jobname.sol.tex
}
\AtEndDocument{
  \immediate\closeout\solutionstream
}
%    \end{macrocode}
%
% \subsection{Exercises counter}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% By providing an exercise counter, proper numbering of the exercises
% is provided to allow for good cross referencing of the solutions to
% the exercises.
% \changes{v0.2}{2012/01/06}{Removed dash in counter when in document
% without sectioning commands}
%    \begin{macrocode}
\newcounter{exercise}[subsection]
\setcounter{exercise}{0}
\renewcommand{\theexercise}{%
  \@ifundefined{c@chapter}{}{\if0\arabic{chapter}\else\arabic{chapter}.\fi}%
  \if0\arabic{section}\else\arabic{section}\fi%
  \if0\arabic{subsection}\else.\arabic{subsection}\fi%
  \if0\arabic{subsubsection}\else.\arabic{subsubsection}\fi%
  \if0\arabic{exercise}\else%
    \@ifundefined{c@chapter}%
                 {\if0\arabic{section}\else-\fi}%
                 {-}%
    \arabic{exercise}%
  \fi
}
%    \end{macrocode}
%
% \section{The user environments}
%
% \begin{macro}{exercise}
%   The \texttt{exercise} environment is used to typeset your
%   exercises, provide them with a nice label and allow for copying
%   the exercise to the solutions file (if the package option
%   \texttt{copyexercisesinsolution}) is set. The label can be
%   set by redefining the \cs{exercisename} macro, or by relying on
%   the \textsf{Babel} provisions. The code is almost litteraly
%   taken from the \textsf{FancyVerb} package.
%    \begin{macrocode}
\def\exercise{\FV@Environment{}{exercise}}
\def\FVB@exercise{%
  \refstepcounter{exercise}%
  \newwrite\exercisestream
  \immediate\openout\exercisestream=\jobname.exc.tex
  \ifexsol@copyexercisesinsolutions
    \typeout{Writing exercise to \jobname.sol.tex}
    \immediate\write\solutionstream{\string\par---\string\newline
      \string\textbf\string{\exercisename{} \theexercise \string}}
  \else
    \immediate\write\solutionstream{\string\par---\string\newline}
  \fi
  \immediate\write\exercisestream{\string\begin{exsol@exercise}}
  \@bsphack
  \begingroup
    \FV@UseKeyValues
    \FV@DefineWhiteSpace
    \def\FV@Space{\space}%
    \FV@DefineTabOut
    \ifexsol@copyexercisesinsolutions
      \def\FV@ProcessLine{\immediate\write\solutionstream{\FV@Line}%
                          \immediate\write\exercisestream}%
    \else
      \def\FV@ProcessLine{\immediate\write\exercisestream}%
    \fi
    \relax
    \let\FV@FontScanPrep\relax
    \let\@noligs\relax
    \FV@Scan
  }
\def\FVE@exercise{
  \endgroup\@esphack
  \immediate\write\exercisestream{\string\end{exsol@exercise}}
  \ifexsol@copyexercisesinsolutions
    \immediate\write\solutionstream{\string~\string\newline}
  \fi
  \immediate\closeout\exercisestream
  \input{\jobname.exc.tex}
}
\DefineVerbatimEnvironment{exercise}{exercise}{}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{exsol@exercise}
%   The \texttt{exsol@exercise} environment is an internal macro used
%   to typeset your exercises and provide them with a nice label and
%   number. Do not use it directly. Use the proper environment
%   \texttt{exercise} instead.
%   \changes{v0.2}{2012/01/06}{Attempted to fix MiKTeX formatting problems}
%   \changes{v0.3}{2012/01/08}{Fixed labelsep to avoid cluttered
%   itemize environments}
%   \changes{v0.4}{2012/01/06}{Added option exercisesinlist such that
%   default results in non list formatting of exercise}
%   \changes{v0.5}{2012/01/09}{Changed implementation to allow for
%   copying the exercises to the solutions file.}
%    \begin{macrocode}
\newenvironment{exsol@exercise}[0]
{%
  \begin{minipage}[t]{\textwidth}%
    \ifthenelse{\boolean{exsol@exerciseaslist}}
               {\begin{list}%
                   {%
                   }%
                   {%
                     \setlength{\topsep}{0pt}%
                     \setlength{\leftmargin}{1em}%
                     \setlength{\rightmargin}{1em}%
                     \setlength{\listparindent}{0em}%
                     \setlength{\itemindent}{0em}%
                     \setlength{\parsep}{\parskip}}%
                 \item[\hspace*{\leftmargin}\textit{\exercisename{} 
                                                    \theexercise:}]
               }%
               {
                 \textit{\exercisename{} \theexercise:}~
               }
}
{%
  \ifthenelse{\boolean{exsol@exerciseaslist}}
             {\end{list}}{}
  \end{minipage}
  \vspace{1ex}\par
}
%    \end{macrocode}
% \end{macro}
%
%
% \begin{macro}{solution}
%   The \texttt{solution} environment is used to typeset your solutions
%   and provide them with a nice label and number that corresponds to
%   the exercise that preceeded this solution. Theno label can be
%   set by redefining the \cs{solutionname} macro, or by relying on
%   the \textsf{Babel} provisions. The code is almost litteraly
%   taken from the \textsf{FancyVerb} package.
%    \begin{macrocode}
\def\solution{\FV@Environment{}{solution}}
\def\FVB@solution{%
  \typeout{Writing solution to \jobname.sol.tex}
  \immediate\write\solutionstream{\string\textbf\string{\solutionname{}\string}}
  \ifexsol@copyexercisesinsolutions
    \immediate\write\solutionstream{\string\newline}
  \else
    \immediate\write\solutionstream{\string\textbf\string{\theexercise\string}%
                                    \string\newline}
  \fi
  \@bsphack
  \begingroup
    \FV@UseKeyValues
    \FV@DefineWhiteSpace
    \def\FV@Space{\space}%
    \FV@DefineTabOut
    \def\FV@ProcessLine{\immediate\write\solutionstream}%
    \relax
    \let\FV@FontScanPrep\relax
    \let\@noligs\relax
    \FV@Scan
  }
\def\FVE@solution{\endgroup\@esphack}
\DefineVerbatimEnvironment{solution}{solution}{}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{exercises}
%   The \texttt{exercises} environment helps typesetting your exercises to
%   stand out from the rest of the text. You may use it at the end of
%   a chapter, or just to group some exercises in the text.
%   \changes{v0.2}{2012/01/06}{Attempted to fix MiKTeX formatting problems}
%   \changes{v0.3}{2012/01/07}{Added some extra whitespace below exercisesname}
%    \begin{macrocode}
\newenvironment{exercises}
{\par\exercisesfontsize\rule{.25\linewidth}{0.15mm}\\*~\\*%
 \textbf{\normalsize \exercisesname}\vspace*{1ex}\\}
{~\\*\rule{.25\linewidth}{0.15mm}\par}
%    \end{macrocode}
% \end{macro}
%
% \subsection{Some Babel provisions}
% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \changes{v0.2}{2012/01/06}{Fixed babel errors}
% \begin{macro}{\exercisename}
%   The exercise environment makes use of a label \texttt{\exercisename{}}
%   macro.
%    \begin{macrocode}
\newcommand{\exercisename}{Exercise}
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{\exercisesname}
%   The exercises environment makes use of a label \texttt{\exercisesname{}}
%   macro.
%    \begin{macrocode}
\newcommand{\exercisesname}{Exercises}
%    \end{macrocode}
% \end{macro}
% 
% \begin{macro}{\solutionname}
%   The solution environment makes use of a label \texttt{\solutionname{}}
%   macro.
%    \begin{macrocode}
\newcommand{\solutionname}{Solution}
%    \end{macrocode}
% \end{macro}
% 
% 
% You may redefine these macros, but to help you out a little bit, we
% provide with some basic Babel auxiliaries. If you're a true polyglot
% and are willing to help me out by providing translations for other
% languages, I'm very willing to incorporate them into the code.
%
%    \begin{macrocode}
\addto\captionsdutch{%
  \renewcommand{\exercisename}{Oefening}%
  \renewcommand{\exercisesname}{Oefeningen}%
  \renewcommand{\solutionname}{Oplossing}%
}
\addto\captionsgerman{%
  \renewcommand{\exercisename}{Aufgabe}%
  \renewcommand{\exercisesname}{Aufgaben}%
  \renewcommand{\solutionname}{L\"osung}%
}
\addto\captionsfrench{%
  \renewcommand{\exercisename}{Exercice}%
  \renewcommand{\exercisesname}{Exercices}%
  \renewcommand{\solutionname}{Solution}%
}
%    \end{macrocode}
%
%
%
% Now the final hack overloads the basic sectioning commands to make
% sure that they are copied into your solution book.
%
%    \begin{macrocode}
\let\exsol@@makechapterhead\@makechapterhead
\def\@makechapterhead#1{%
  \immediate\write\solutionstream{\string\chapter{#1}}%
  \exsol@@makechapterhead{#1}
}
\ifdefined\frontmatter
  \let\exsol@@frontmatter\frontmatter
  \def\frontmatter{%
    \immediate\write\solutionstream{\string\frontmatter}%
    \exsol@@frontmatter
  }
\fi
\ifdefined\frontmatter
  \let\exsol@@mainmatter\mainmatter
  \def\mainmatter{%
    \immediate\write\solutionstream{\string\mainmatter}%
    \exsol@@mainmatter
  }
\fi
\ifdefined\backmatter
  \let\exsol@@backmatter\backmatter
  \def\backmatter{%
    \immediate\write\solutionstream{\string\backmatter}%
    \exsol@@backmatter
  }
\fi
%    \end{macrocode}
%
% \begin{macro}{\noexercisesinchapter}
%   If you have chapters without exercises, you may want to indicate
%   this clearly into your source. Otherwise empty chapters may appear
%   in your solution book.
%    \begin{macrocode}
\newcommand{\noexercisesinchapter}
{
  \immediate\write\solutionstream{No exercises in this chapter}
}
%    \end{macrocode}
% \end{macro}
%
%    \begin{macrocode}
%</package>
%    \end{macrocode}
%
% \bibliographystyle{alpha}
%
% \begin{thebibliography}{99}
%
% \bibitem{fancyvrb}
% Timothy Van Zandt, Herbert Vo\ss, Denis Girou, Sebastian Rahtz, Niall
% Mansfield 
% \newblock The \texttt{fancyvrb} package.
% \newblock \url{http://ctan.org/pkg/fancyvrb}.
% \newblock online, accessed in January 2012.
%
% \bibitem{CTAN} 
% The Comprehensive TeX Archive Network.
% \newblock \url{http://www.ctan.org}.
% \newblock online, accessed in January 2012.
%
% \end{thebibliography}
%
% \Finale
\endinput