University of Otago LaTeX exam template

Nigel Stanger authored on 13 Jun 2013
CreateCluster.eps - Added ouexam example directory. 20 years ago
CreateIndex.eps - Added ouexam example directory. 20 years ago
CreateObjectType.eps - Added ouexam example directory. 20 years ago
CreateTable1.eps - Added ouexam example directory. 20 years ago
CreateTable2.eps - Added ouexam example directory. 20 years ago
FAQ - Added heading and wrapped. 20 years ago
INSTALL - Updated version number. 16 years ago
MANIFEST - Added INSTALL file. 16 years ago
Makefile - Updated install target for new example structure. 20 years ago
README - Updated to document latest version changes. 16 years ago
TODO - Added note about possible hyperref incompatibility. 20 years ago
example.tex - Added initial comments. 20 years ago
example1.tex - Added initial comments. 20 years ago
example2.tex - Added initial comments. 20 years ago
lstlang0.sty - Added file comment. 20 years ago
ouexam.dtx Corrected \filedate. 11 years ago
ouexam.ins - Added CVS ID. 20 years ago
README
********************************************************************************
**
** File: $Id$
**
********************************************************************************

ouexam v2.1.2
=============

ouexam document class v2.1.2, 14 August 2008

Copyright 1999--2008 Nigel Stanger and University of Otago

This LaTeX2e document class enables the production of University of Otago
formatted examination papers. It handles all the fiddly layout requirements
(such as printing `TURN OVER' at the bottom of every page except the last),
and also ensures that the actual number of marks for questions in the
examination add up to the expected number of marks.


WHAT'S NEW IN VERSION 2.1.2

* The "subject to inspection" messages that appear in the calculators and
  permitted material sections of the title page now only appear when
  calculators are allowed or there actually is additional permitted
  material, respectively.


WHAT'S NEW IN VERSION 2.1.1

* "END" is now printed at the bottom of the last page of the exam.


WHAT'S NEW IN VERSION 2.1

* Updated the calculators macro to conform to the new University calculator
  regulations. \allowcalculators now has an optional argument to specify
  the kinds of calculators permitted.

* \permitcalculators has been added as a synonym for \allowcalculators.


WHAT'S NEW IN VERSION 2.0.2

* If you omitted any of the required title page macros (\examyear,
  \papernumber, \papertitle or \department), ouexam crashed when trying
  to report the error. Fixed.

* Added the ability to specify "FY" (full-year) as a semester type in the
  \semester macro.


WHAT'S NEW IN VERSION 2.0.1

* There was a bug in the definition of the macros for numbering
  sub-sub-questions that meant they were numbered as "(a)" instead of the
  correct "(i)". Fixed.

* When referencing sub-questions or sub-sub-questions, the entire question
  number was included (that is, "1(b)(iii)" instead of just "(iii)"). This
  made it difficult to sensibly reference these items, so the relevant
  macros have been changed to omit this prefixed information. References to
  questions now print as "1", sub-questions as "(b)" and sub-sub-questions
  as "(iii)". If this does not suit your requirements, change the
  \labelquestion, \labelsubquestion or \labelsubsubquestion macros.


REQUIREMENTS

ouexam requires the verbatim class, which should be standard on most LaTeX
installations. The class documentation uses the graphicx and hyperref
packages, so you will have to install these first if you don't have them
already.


INSTALLING (UNIX OR SIMILAR)

A makefile is provided:

	* `make' will produce both ouexam.cls and ouexam.dvi (see below).

	* `make class' will produce ouexam.cls. Place this file in a directory
	  somewhere in your TeX search path (e.g., if you use teTeX, put it in
	  texmf/tex/latex/ouexam or somewhere similar).

	* `make doc' will produce ouexam.dvi.
	
	* If you have GhostScript and the dvipdf command, `make pdfdoc' will
	  produce PDF documentation.


INSTALLING (EVERYTHING ELSE)

Run ouexam.ins through LaTeX to produce ouexam.cls. Place this file in a
directory somewhere in your LaTeX search path. Then run ouexam.dtx through
LaTeX _three_ (yes, three) times to produce the documentation (ouexam.dvi).
PDF documentation can be produced from the DVI by whatever means you
normally use to do so.