exsheets (23apr13)

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

4 files changed, 19 insertions, 6 deletions

diff --git a/Master/texmf-dist/doc/latex/exsheets/README b/Master/texmf-dist/doc/latex/exsheets/README
index 02c40c8c448..55317f7c961 100644
--- a/Master/texmf-dist/doc/latex/exsheets/README
+++ b/Master/texmf-dist/doc/latex/exsheets/README
@@ -1,5 +1,5 @@
 --------------------------------------------------------------------------
-EXSHEETS v0.9a - 2013/04/08
+EXSHEETS v0.9c - 2013/04/21
 
 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 f459bbf0559..50be4c19ddc 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 6d2ff8a691d..74ed6fdc596 100644
--- a/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
+++ b/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
@@ -1324,6 +1324,17 @@ These are the available commands and options:
 
 \section{Selectively Include Questions from External Files}\label{sec:include}
 \secidx{Include from External Files}
+\subsection{Caveat}
+I need to say some words of caution: the \cmd{includequestions} that will be
+presented shortly is probably \ExSheets' most experimental one at the time of
+writing (\today). Thanks to feedback of users it is constantly improved and
+bugs are fixed. It is not a very efficient way to insert question regarding
+performance and you shouldn't wonder if compilation slows down when you use it.
+It probably needs to be re-written all over but on the one hand that would
+introduce new bugs and on the other hand for the time being I don't have the
+capacities, anyway, so you'll have to live it, I'm afraid.
+
+\subsection{How it works}
 Suppose you have one or more files with questions prepared to use them as a kind
 of database. One for class A, say, one for class B, one for class C and so one,
 something like this:
@@ -1667,16 +1678,16 @@ The following examples use a sample text defined as follows:
  A `simple' heading. \sample
 \end{question}
 
+\newpage % FIXME: watch pagebreaks!
 \subsubsection{The `empty' Instance}
 \sinceversion{0.9a}
 \begin{beispiel}[code only]
  \DeclareInstance{exsheets-heading}{empty}{default}
   {
-    runin = true ,
-    above = \parskip ,
-    below = \parskip ,
-    attach           =
-      { main[l,vc] points[l,vc] (\linewidth + \marginparsep,0pt) } 
+    runin  = true ,
+    above  = \parskip ,
+    below  = \parskip ,
+    attach = { main[l,vc]points[l,vc](\linewidth+\marginparsep,0pt) }
   }
 \end{beispiel}
 \SetupExSheets{headings=empty}
@@ -1834,6 +1845,7 @@ The following examples use a sample text defined as follows:
  A `runin-wp-rev' heading. \sample
 \end{question}
 
+\newpage % FIXME: watch pagebreaks!
 \subsubsection{The `runin-nr' Instance}
 \begin{beispiel}[code only]
  \DeclareInstance{exsheets-heading}{runin-nr}{default}
@@ -2008,6 +2020,7 @@ Text before
  A `margin' heading. \sample
 \end{question}
 
+\newpage % FIXME: watch pagebreaks!
 \subsubsection{The `margin-nr' Instance}
 \begin{beispiel}[code only]
  \DeclareInstance{exsheets-heading}{margin-nr}{default}
diff --git a/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf b/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf
index 50a466af818..ad2da7f271e 100644
--- a/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf
+++ b/Master/texmf-dist/doc/latex/exsheets/grading-table.pdf