exsheets (19dec12)

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

5 files changed, 87 insertions, 54 deletions

diff --git a/Master/texmf-dist/doc/latex/exsheets/README b/Master/texmf-dist/doc/latex/exsheets/README
index 71d92d02bb0..44746a43b46 100644
--- a/Master/texmf-dist/doc/latex/exsheets/README
+++ b/Master/texmf-dist/doc/latex/exsheets/README
@@ -1,5 +1,5 @@
 --------------------------------------------------------------------------
-EXSHEETS v0.5a - 2012/12/06
+EXSHEETS v0.6 - 2012/12/18
 
 bundled packages:
 the EXSHEETS package
diff --git a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.pdf
index b53965922c9..ce878434f15 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 9add39fd108..9e8d9faf667 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
@@ -85,17 +85,20 @@
 % code examples
 % ExSheets:
 \addcmds{
-  acs, addpoints, blank, bigstar, bottomrule, checkedchoicebox, choice, choicebox,
-  citetitle, cmd, color, correct,
+  acs, addpoints,
+  blank, bigstar, bottomrule,
+  checkedchoicebox, choice, choicebox, citetitle, cmd, color, correct,
   DeclareInstance, DeclareTemplateInterface, DeclareQuestionProperty,
-  DebugExSheets, endspacing, examspace, ForEachQuestion, GetQuestionProperty,
+    DebugExSheets, endspacing, examspace, ForEachQuestion, GetQuestionProperty,
   grade, includequestions, iflastquestion,
   midrule, NewQuSolPair, NewTasks, numberofquestions, points,
   PrintIfIncludeActiveF, PrintIfIncludeActiveT, PrintIfIncludeActiveTF,
-  printsolutions, PrintSolutionsF, PrintSolutionsTF, PrintSolutionsT,
+    printsolutions, PrintSolutionsF, PrintSolutionsTF, PrintSolutionsT,
   QuestionNumber, RenewQuSolPair, rightarrow, s, sample, setlength,
-  SetQuestionProperties, SetupExSheets, spacing, square, sumpoints,
-  tabcolsep, task, textcite, textcolor, toprule, totalpoints
+  SetQuestionProperties, SetupExSheets, SetVariations, spacing, square,
+    sumpoints,
+  tabcolsep, task, textcite, textcolor, toprule, totalpoints,
+  variant, vary
 }
 
 % translations:
@@ -770,50 +773,6 @@ You have two possibilities to display and count them:
 \end{beispiel}
 \secidx*{Counting Points}
 
-\subsection{A Grade Distribution}\secidx{Grade Distribution}
-Probably this is a rather esoteric feature but it could proof useful in some cases.
-Suppose you are a German math teacher and want to grade exactly corresponding to
-the number of points relative to the sum of total points, regardless of how big
-that might be. You could do something like this to present your grading decisions
-for the exam:
-\begin{beispiel}
- % preamble:
- % \DeclareRelGrades{
- %   1     = 1 ,
- %   {1,5} = .9167 ,
- %   2     = .8333 ,
- %   {2,5} = .75 ,
- %   3     = .6667 ,
- %   {3,5} = .5833 ,
- %   4     = .5
- % }
- \small\setlength\tabcolsep{2pt}
- \begin{tabular}{r|*8c}
-  Punkte
-    & $\grade*{1}$      & $\le\grade*{1}$ & $\le\grade*{1,5}$ & $\le\grade*{2}$
-    & $\le\grade*{2,5}$ & $\le\grade*{3}$ & $\le\grade*{3,5}$ & $<\grade*{4}$ \\
-  Note
-    & 1 & 1--2 & 2 & 2--3 & 3 & 3--4 & 4 & 5
- \end{tabular}
-\end{beispiel}
-
-These are the available commands and options:
-\begin{beschreibung}
- \Befehl{DeclareRelGrades}{<grade>=<num>,...}\newline
-   This command is used to define grades and assign the percentage of total
-   points to them.
- \Befehl{grade}*{<grade>}\newline
-   Gives the number of points corresponding to a grade depending on the value
-   of \cmd{pointssum} with or without (starred version) ``unit''.
- \Option[grades]{round}{<num>}\Default{0}
-   The number of decimals the points of a grade are rounded to. This doesn't apply
-   to the maximum number of points if the rounded number would be bigger than the
-   actual sum.
- \Option[grades]{half}{\default{true}|false}\Default{false}
-   If set to \code{true} points are rounded either to full or to half points.
-\end{beschreibung}
-\secidx*{Grade Distribution}
-
 \subsection{Printing Solutions}\label{sec:solutions}\secidx[print]{solutions}
 You have already seen that you can print solutions where they are using the
 \key[solution]{print} option. But \ExSheets offers you quite more possibilities.
@@ -943,8 +902,8 @@ has an \acs{id}. To see which \acs{id} a question has you can call the following
 command:
 \begin{beschreibung}
  \Befehl{DebugExSheets}{true|false}
- \befehl{CurrentQuestionID} \sinceversion{0.4a}expands to the current question
-   \acs{id} (after two expansions).
+ \Befehl{CurrentQuestionID}\sinceversion{0.4a}\newline
+   expands to the current question \acs{id} (after two expansions).
 \end{beschreibung}
 Let's create some more questions and take a look what this command does:
 \begin{beispiel}
@@ -1036,6 +995,81 @@ supported yet.
  \bool_set_false:N \g__exsheets_use_topics_bool
 \ExplSyntaxOff
 
+\subsection{Variations of an Exam}\secidx{Variations}
+\noindent\sinceversion{0.6}It is a quite common task to design an exam in two
+different variants. This is of course possible with \ExSheets' classes (see
+section~\ref{sec:classes}). However, often not the whole question is to be
+different but only small details, the numbers in a maths exam, say. For this
+purpose \ExSheets provides the following commands:
+\begin{beschreibung}
+ \Befehl{SetVariations}{<num>}\newline
+   Set the number of different variants. This will determine how many arguments
+   the command \cmd*{vary} will get. \code{<num>} must at least be \code{2} and
+   is initially set to \code{2}.
+ \Befehl{variant}{<num>}\newline
+   Choose the active variant. The argument must be a number between \code{1}
+   and the number set with \cmd*{variations}. Initially set to \code{1}.
+ \Befehl{vary}{<variant 1>}\ma{<variant 2>}\newline
+   This command is the one actually used in the document. It has a number of
+   required arguments equal to the number set with \cmd*{variations}. All of its
+   arguments are discarded except the one specified with \cmd*{variant}.
+\end{beschreibung}
+
+\begin{beispiel}
+ \SetVariations{6}%
+ \variant{6}\vary{A}{B}{C}{D}{E}{F}
+ \variant{1}\vary{A}{B}{C}{D}{E}{F}
+ \variant{5}\vary{A}{B}{C}{D}{E}{F}
+ \variant{2}\vary{A}{B}{C}{D}{E}{F}
+ \variant{4}\vary{A}{B}{C}{D}{E}{F}
+ \variant{3}\vary{A}{B}{C}{D}{E}{F}
+\end{beispiel}
+\secidx*{Variations}
+
+\subsection{A Grade Distribution}\secidx{Grade Distribution}
+Probably this is a rather esoteric feature but it could proof useful in some cases.
+Suppose you are a German math teacher and want to grade exactly corresponding to
+the number of points relative to the sum of total points, regardless of how big
+that might be. You could do something like this to present your grading decisions
+for the exam:
+\begin{beispiel}
+ % preamble:
+ % \DeclareRelGrades{
+ %   1     = 1 ,
+ %   {1,5} = .9167 ,
+ %   2     = .8333 ,
+ %   {2,5} = .75 ,
+ %   3     = .6667 ,
+ %   {3,5} = .5833 ,
+ %   4     = .5
+ % }
+ \small\setlength\tabcolsep{2pt}
+ \begin{tabular}{r|*8c}
+  Punkte
+    & $\grade*{1}$      & $\le\grade*{1}$ & $\le\grade*{1,5}$ & $\le\grade*{2}$
+    & $\le\grade*{2,5}$ & $\le\grade*{3}$ & $\le\grade*{3,5}$ & $<\grade*{4}$ \\
+  Note
+    & 1 & 1--2 & 2 & 2--3 & 3 & 3--4 & 4 & 5
+ \end{tabular}
+\end{beispiel}
+
+These are the available commands and options:
+\begin{beschreibung}
+ \Befehl{DeclareRelGrades}{<grade>=<num>,...}\newline
+   This command is used to define grades and assign the percentage of total
+   points to them.
+ \Befehl{grade}*{<grade>}\newline
+   Gives the number of points corresponding to a grade depending on the value
+   of \cmd{pointssum} with or without (starred version) ``unit''.
+ \Option[grades]{round}{<num>}\Default{0}
+   The number of decimals the points of a grade are rounded to. This doesn't apply
+   to the maximum number of points if the rounded number would be bigger than the
+   actual sum.
+ \Option[grades]{half}{\default{true}|false}\Default{false}
+   If set to \code{true} points are rounded either to full or to half points.
+\end{beschreibung}
+\secidx*{Grade Distribution}
+
 \subsection{Adding and Using Additional Information to Questions}\label{sec:additional_info}
 \secidx{Additional Information to Questions}
 For managing lots of questions and corresponding solutions it can be very useful
diff --git a/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf b/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf
index 424286f0916..a11f8cbea66 100644
--- a/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf
+++ b/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf
diff --git a/Master/texmf-dist/doc/latex/exsheets/grading-table.tex b/Master/texmf-dist/doc/latex/exsheets/grading-table.tex
index 85239f69181..6b65f8c475e 100644
--- a/Master/texmf-dist/doc/latex/exsheets/grading-table.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/grading-table.tex
@@ -1,6 +1,5 @@
 \documentclass{scrartcl}
 \usepackage{exsheets}
-\DeclareQuestionProperty{points}
 
 \begin{document}