diff --git a/ouexam.dtx b/ouexam.dtx index d29a804..2f08558 100755 --- a/ouexam.dtx +++ b/ouexam.dtx @@ -1,6 +1,6 @@ -\def\ouexamdate{14 August 2008} -\def\ouexamversion{2.1.3} -\def\ouexamshortdate{2009/04/28} +\def\ouexamdate{26 April 2010} +\def\ouexamversion{2.2} +\def\ouexamshortdate{2010/04/26} % \iffalse meta-comment %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %% @@ -36,7 +36,7 @@ % % \fi % -%% \CheckSum{819} +%% \CheckSum{825} %% %% \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 @@ -420,6 +420,19 @@ % \item where to position the number of marks relative to the question, % depending on how full the last line of the question is. % \end{itemize} +% +% +% \changes{2.2}{2010/04/26}{NJS Added time allocation macros.} +% \subsection{Time allocations} +% \label{Sec-Questions-Time} +% +% If you wish to suggest a time allocation for completing a question, use the \DescribeMacro{\timeallocation} \cs{timeallocation} macro. The only argument is the number of minutes to be allocated for this question. The macro will output the time allocation in the form: \textbf{[The suggested time allocation for this question is \emph{t} minutes.]} +% +% If you wish to allow a certain amount of time for candidates to read some text, use the \DescribeMacro{\readingtime} \cs{readingtime} macro. The only argument is the number of minutes to be allocated for reading time. The macro will output the reading time in the form: \textbf{[Allow \emph{t} minutes reading time.]} +% +% Both macros assume the base unit to be minutes; if you wish to change this you will need to redefine the macros. Otherwise, the argument can be almost anything: text, numbers, etc. +% +% \textsf{ouexam} currently does not check that time allocations sum correctly. This may be implemented in a future version. % % % \subsection{Marking schedule information} @@ -1503,6 +1516,29 @@ % \end{macro} % % +% \changes{2.2}{2010/04/26}{NJS Added time allocation macros.} +% \subsection{Time allocations} +% +% \begin{macro}{\timeallocation} +% The \cs{timeallocation} macro takes a single argument representing the number of minutes suggested time allocation for a question, and outputs it in the form: \textbf{[The suggested time allocation for this question is \emph{t} minutes.]} The argument is not checked and can be anything (numbers, text). The macro will need to be redefined if either units other than minutes or different phrasing are required. +% \begin{macrocode} +\newcommand{\timeallocation}[1]{% + \textbf{[The suggested time allocation for answering this question % + is #1 minutes.]}% +} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\readingtime} +% The \cs{readingtime} macro takes a single argument representing the number of minutes reading time allocated to some part of the examination, and outputs it in the form: \textbf{[Allow \emph{t} minutes reading time.]} The argument is not checked and can be anything (numbers, text). The macro will need to be redefined if either units other than minutes or different phrasing are required. +% \begin{macrocode} +\newcommand{\readingtime}[1]{\textbf{[Allow #1 minutes reading time.]}} +% \end{macrocode} +% \end{macro} +% +% \textsf{ouexam} currently does not check that any of these time allocations sum to the correct total. If implemented, this would work in a similar way to how marks totals are checked, and would be keyed in some way off \cs{@hours}. +% +% % \subsection{Marking schedule information} % % \begin{environment}{marking}