summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/acrotex/doc/aeb_man.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/acrotex/doc/aeb_man.tex')
-rw-r--r--macros/latex/contrib/acrotex/doc/aeb_man.tex69
1 files changed, 56 insertions, 13 deletions
diff --git a/macros/latex/contrib/acrotex/doc/aeb_man.tex b/macros/latex/contrib/acrotex/doc/aeb_man.tex
index 29337b17a0..93c348abb9 100644
--- a/macros/latex/contrib/acrotex/doc/aeb_man.tex
+++ b/macros/latex/contrib/acrotex/doc/aeb_man.tex
@@ -17,7 +17,7 @@
%%\usepackage{times}
%\usepackage{timesNRMT}
-% \previewOn\pmpvOn
+%\previewOn\pmpvOn
\usepackage{aeb_mlink}
\usepackage{longtable,colortbl}
@@ -243,10 +243,10 @@
\university{{\AcroT} Software Development Team}
\email{dpstory@acrotex.net}
\versionLabel{Dated:}
-\version{2021/06/19}
+\version{2021/10/03}
\copyrightyears{1999-\the\year}
\nocopyright
-\prepared{2021/06/19}
+\prepared{2021/10/03}
\revisionLabel{Distribution Dated:}
\copyrightStatus{True}
@@ -4153,7 +4153,7 @@ this topic.
\subsection{The \texttt{userbmintrvl} Option}\label{eq:userbmintrvl}
-The \opt{userbmintrvl} option defines \cs{rbmIntrvl} command, the syntax of which is,
+The \opt{userbmintrvl} option defines the \cs{rbmIntrvl} command, the syntax of which is,
\bVerb\takeMeasure{\cs{rbmIntrvl\darg{[a,b]}\ameta{\textsf{arguments of \cs{RespBoxMath}}}}}%
\begin{dCmd}[commandchars=!()]{\bxSize}
\rbmIntrvl{[a,b]}!ameta(!textsf(arguments of !cs(RespBoxMath)))
@@ -5284,7 +5284,7 @@ Which of the following are prime numbers?
\Ans0 1 &
\Ans1 2 &
\Ans1 3 &
- \Ans0 4 \\
+ \Ans0 4 \\[3bp]
\Ans1 5 &
\Ans0 6 &
\Ans1 7 &
@@ -5305,6 +5305,40 @@ You'll note that the \env{shortquiz} environment is used, yet form fields
(check boxes) are used; this is by design. Links are not available for MS
questions, only for MC questions.
+\subsubsection{The rollover display of choice fields}\label{ss:ChoiceTT}
+
+In recent versions of \textsf{AA/AR DC}, the rollover display for choice
+fields (radio fields and checkboxes) has changed. Previously when the mouse
+rolls over a choice field, the tool tip is displayed. For quizzes, the choice
+fields have no tool tip, so nothing was displayed. Now, \textsf{AA/AR DC}
+displays \texttt{\ameta{tool-tip}:\,\ameta{export-value}}, which reveals
+information not intended for the student taking that quiz. The \pkg{exerquiz}
+package is modified to reflect this change. The rollover of radio buttons and
+check boxes now displays as \texttt{Choice:\,a}, \texttt{Choice:\,b}, \dots. The word
+`Choice' is the tool tip and lower case letter is the export value. The tool tip for
+all choice fields of a quizzes can be changed with \cs{TUChoice}:
+\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!()]
+\TUChoice{!ameta(text)}
+\end{Verbatim}
+The default is \verb~\TUChoice{Choice}~.
+
+The tool tip may be localized to other languages as follows:
+\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!()]
+\TUChoice{Ellecci\'{o}n}
+\end{Verbatim}
+to obtain the Spanish word Ellecci\'{o}n for choice. More obscure localization
+can be done using unicode, for example,
+\begin{Verbatim}[xleftmargin=\amtIndent,commandchars=!()]
+\defUniStr{Choice}{Ellecci\u00F3n}
+\TUChoice{\unicodeStr(Choice)}
+\end{Verbatim}
+However, for this form to be valid, the preamble must use the package \pkg{forms16be}:
+\begin{Verbatim}
+\usepackage{exerquiz}
+\usepackage{forms16be}
+\end{Verbatim}
+
+
\subsubsection{Other supported question types}
In addition to MC and MS questions, any other supported types can be used
@@ -5356,9 +5390,9 @@ Was it in Xanadu did Kubla Kahn a stately pleasure dome decree?
short-quiz to change response feedback; \cs{sqTurnOffAlerts} turns off the
(annoying) alerts.
-\redpoint The \cs{sqTurnOffAlerts} command only apply to a short-quiz that
-uses radio buttons. You can reverse the effect of this command by expanding
-\cs{sqTurnOnAlerts}. The default is \cs{sqTurnOnAlerts}.
+\redpoint The \cs{sqTurnOffAlerts} command only apply to a short-quiz.
+Reverse the effect of this command by expanding \cs{sqTurnOnAlerts}. The
+default is \cs{sqTurnOnAlerts}.
\subsubsection{\texttt{shortquiz} with solutions}\label{ss:QuizS}
@@ -6037,7 +6071,7 @@ levels are set through the optional argument of \cs{sqTallyTotal}.
\begin{aebQuote}
\begin{description}
-\item[Weak passing level] Syntax: \cs{sqTallyTotal[\cs{weakpassing\darg{\ameta{n}}}]}\\[3pt]
+\item[Weak passing level] Syntax: \cs{sqTallyTotal[\cs{weakpass\darg{\ameta{n}}}]}\\[3pt]
\textbf{User Experience.} As soon as the student makes more than
\ameta{n} errors, the following message appears in an alert dialog box:
\begin{Verbatim}
@@ -6048,7 +6082,7 @@ with fewer errors and greater understanding.}
The student is allowed to continue the quiz, but with the knowledge the
performance is below the expected standard, as set by the instructor.
-\item[Strong passing level] Syntax: \cs{sqTallyTotal[\cs{strongpassing\darg{\ameta{n}}}]}\\[3pt]
+\item[Strong passing level] Syntax: \cs{sqTallyTotal[\cs{strongpass\darg{\ameta{n}}}]}\\[3pt]
\textbf{User Experience.} As soon as the student makes more than \ameta{n}
errors, the following message appears in an alert dialog box:
\begin{Verbatim}
@@ -6580,6 +6614,12 @@ argument to pass partial points rewarded for a wrong answer.
\texttt{manswers} environment, \Nameref{manswersQuiz}, for posting questions with multiple
correct answers.
+\subsubsection{The rollover display choice fields}
+
+Refer to the comments in the subsection titled \Nameref{ss:ChoiceTT}.
+
+
+
\subsection{Basic Usage}
In this section we discuss the two \texttt{quiz} styles:
@@ -6799,8 +6839,8 @@ Prior to your quiz, use the following code, if desired.
\useBeginQuizButton
\useEndQuizButton
\end{Verbatim}
-Clicking the \uif{Begin Quiz} button clears all fields in the quiz and initializes it for the user
-to respond to each question. Shift-clicking the \uif{Begin Quiz} button clears all fields, but does not
+Clicking the \FmtMP{Click \uif{Begin Quiz} action}\uif{Begin Quiz} button clears all fields in the quiz and initializes it for the user
+to respond to each question. Shift-clicking the \FmtMP{Shift-click \uif{Begin Quiz} action}\uif{Begin Quiz} button clears all fields, but does not
initialize the quiz.
\useBeginQuizButton\useEndQuizButton
@@ -7241,6 +7281,9 @@ parameter is a unique name for the solution to the quiz. Notice as well that
the \texttt{solution} environment follows, and is not nested
within the \texttt{answers} environment.
+\subsubsection{The rollover display choice fields}
+
+Refer to the comments in the subsection titled \Nameref{ss:ChoiceTT}.
\subsection{How to Modify the \texttt{quiz} Environment}
@@ -12020,7 +12063,7 @@ features of the \pkg{web} and \textsf{exerquiz} packages.
\item Documented the use of form check boxes with the \texttt{shortquiz}
environment and introduced the commands
\begin{Verbatim}[xleftmargin=\amtIndent]
- \sqTurnOffAlerts,\sqTurnOnAlerts,\sqNoCorrections,\sqNoCorrections
+ \sqTurnOffAlerts,\sqTurnOnAlerts,\sqCorrections,\sqNoCorrections
\end{Verbatim}
to control response feedback.
\item Added language \texttt{finnish} Options. Translation due