summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex')
-rw-r--r--Master/texmf-dist/doc/latex/exsheets/exsheets_en.tex23
1 files changed, 18 insertions, 5 deletions
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}