examdesign update for class name change (7sep06)

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

15 files changed, 147 insertions, 4 deletions

diff --git a/Master/texmf-dist/doc/latex/examdesign/Bugs b/Master/texmf-dist/doc/latex/examdesign/Bugs
new file mode 100644
index 00000000000..3185b04f479
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/Bugs
@@ -0,0 +1 @@
+No known bugs.
diff --git a/Master/texmf-dist/doc/latex/examdesign/Changes b/Master/texmf-dist/doc/latex/examdesign/Changes
new file mode 100644
index 00000000000..ee638e37cce
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/Changes
@@ -0,0 +1,99 @@
+Version 1.1:
+  - Added the 'matching' environment
+
+  - Continuous numbering of questions across sections is now
+    possible.
+
+  - Removed the following environments:
+        = shortanswer*
+	= fillin*
+	= fixed*
+	= multiplechoice*
+	= truefalse*
+    (the functionality provided by these environments can now
+    be obtained in other ways)
+
+  - Changed the syntax of the standard sections.  The optional 
+    argument now can be used to set a number of parameters 
+    customizing that section.  These parameters are described
+    at length in the documentation.  (Previously, it specified
+    the section title.)
+  
+  - The format of the section number and identifier can now be
+    easily customized.
+
+  - Cross-referencing works.
+
+  - The 'block' environment now accepts an optional argument.  
+    Right now, the only optional argument is "questions", which
+    specifies the number of questions in the block, and defines
+    two new commands (\thefirst and \thelast) which refer to the
+    range of questions which fall within that block.
+
+  - The \pagebreak command can now be used to force pagebreaks
+    before sections and questions.
+
+  - The \BreakPageOnVersion command can be used to introduce
+    pagebreaks before a question or section only on particular
+    versions of the test.
+
+  - For many of the standard question types, the command \ShortKey
+    will produce a "shortened" answer key that contains only the
+    answers (no question or section introduction text), hence saving
+    paper.
+
+  - A not-so-terribly-ugly hack has been provided in order to facilitate
+    the typesetting of any TeX code requiring catcode changes.
+
+  - Fixed a bug that prevented the 'block' environment from
+    working correctly inside some of the sections.
+
+  - The TeX source has been simplified.  It's still not pretty,
+    but it should be a lot easier to understand.
+
+  - Probably some other stuff that I've forgotten...
+
+Version 1.02:
+  - Fixed a bug that broke the cedilla (\c) command.
+
+  - Added the following environments:
+	= frontmatter  = shortanswer*
+	= endmatter    = fillin*
+	= examtop      = fixed*
+	= exampreface  = multiplechoice*
+	= examclosing  = truefalse*
+	= keytop
+	= keypreface
+	= keyclosing
+	= block
+
+  - Added the following commands:
+	= \word
+	= \examname
+	= \key
+	= \examvspace
+	= \examvspace*
+	= \examhspace
+	= \examhspace*
+	= \keyvspace
+	= \keyvspace*
+	= \keyhspace
+	= \keyhspace*
+
+  - Eliminated the \instructions command for inserting 
+    instructions after the section header.  The section 
+    environments are now "smart" enough to recognize
+    when instructions appear.
+
+  - The \exam command has been redefined.  The old \exam
+    command, used for specifying the name of the exam, has
+    been replaced by \examname.  
+
+  - Added the following user-customizable lengths:
+	= \beforesectsep   = \beforeinstsep
+	= \aftersectsep    = \afterinstsep
+
+  - Every question is now surrounded by \@beforequestionhook and
+    \@endquestionhook, in case the user wants to use them for
+    anything.
+
diff --git a/Master/texmf-dist/doc/latex/examdesign/INSTALL b/Master/texmf-dist/doc/latex/examdesign/INSTALL
new file mode 100644
index 00000000000..be602f5b62c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/INSTALL
@@ -0,0 +1,21 @@
+Put the materials in your favorite spot.  For instance, on Unix-like 
+system a good spot may be /var/local/share/texmf/tex/latex/examdesign/ .
+
+In that directory run 
+  latex examdesign.ins
+(and then you might have to copy the created file examdesign.cls into an area 
+where LaTeX2e can find it).  Don't forget to run "texhash" (if you are using
+a menu-ed environment you may need to find a menu item like "Rebuild 
+the TeX database").
+
+Make your new document like this. 
+
+\documentclass[10pt]{examdesign}
+\begin{document}
+  :
+\end{document}
+
+Use the example files as a start.
+
+..................................................................
+2006-Sept-05 Jim Hefferon (From some material from JA.)
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/examdesign/README b/Master/texmf-dist/doc/latex/examdesign/README
new file mode 100644
index 00000000000..4e21e365d1f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/README
@@ -0,0 +1,22 @@
+This bundle provides a class examdesign for making exams.  
+
+The class provides several features useful for designing tests
+or question sets:
+
+* it allows for explicit markup of questions and answers;
+
+* the class will, at the user's request, automatically generate
+answer keys;
+
+* multiple versions of the same test can be generated
+automatically, with the ordering of questions within each section
+randomly permuted so as to minimize cheating;
+
+* the generated answer keys can be constructed either with or
+without the questions included;
+
+* environments are provided to assist in constructing the most
+common types of test question: matching, true/false,
+multiple-choice, fill-in-the-blank, and short answer/essay
+questions.
+
diff --git a/Master/texmf-dist/doc/latex/examdesign/exam.dvi b/Master/texmf-dist/doc/latex/examdesign/exam.dvi
deleted file mode 100644
index 067dc6eb2e5..00000000000
--- a/Master/texmf-dist/doc/latex/examdesign/exam.dvi
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/examdesign/examdesign.pdf b/Master/texmf-dist/doc/latex/examdesign/examdesign.pdf
new file mode 100644
index 00000000000..d52f0038cb2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/examdesign.pdf
diff --git a/Master/texmf-dist/doc/latex/examdesign/examplea.dvi b/Master/texmf-dist/doc/latex/examdesign/examplea.dvi
deleted file mode 100644
index c68a54fc275..00000000000
--- a/Master/texmf-dist/doc/latex/examdesign/examplea.dvi
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/examdesign/examplea.pdf b/Master/texmf-dist/doc/latex/examdesign/examplea.pdf
new file mode 100644
index 00000000000..61ddd0ed0f5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/examplea.pdf
diff --git a/Master/texmf-dist/doc/latex/examdesign/examplea.tex b/Master/texmf-dist/doc/latex/examdesign/examplea.tex
index 9b660fc8885..117539930df 100644
--- a/Master/texmf-dist/doc/latex/examdesign/examplea.tex
+++ b/Master/texmf-dist/doc/latex/examdesign/examplea.tex
@@ -1,4 +1,4 @@
-\documentclass[10pt]{exam}
+\documentclass[10pt]{examdesign}
 \usepackage{amsmath}
 \usepackage{pifont}
 \SectionFont{\large\sffamily}
@@ -9,7 +9,7 @@
 \NumberOfVersions{3}
 \IncludeFromFile{foobar.tex}
 
-\class{{\Large An example of the \textsf{exam} class}}
+\class{{\Large An example of the \textsf{examdesign} class}}
 
 \begin{document}
 
diff --git a/Master/texmf-dist/doc/latex/examdesign/exampleb.dvi b/Master/texmf-dist/doc/latex/examdesign/exampleb.dvi
deleted file mode 100644
index 4ed47ab28ee..00000000000
--- a/Master/texmf-dist/doc/latex/examdesign/exampleb.dvi
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/examdesign/exampleb.pdf b/Master/texmf-dist/doc/latex/examdesign/exampleb.pdf
new file mode 100644
index 00000000000..c5cfa72db35
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/exampleb.pdf
diff --git a/Master/texmf-dist/doc/latex/examdesign/exampleb.tex b/Master/texmf-dist/doc/latex/examdesign/exampleb.tex
index d5a73bd9098..a4bdc6589df 100644
--- a/Master/texmf-dist/doc/latex/examdesign/exampleb.tex
+++ b/Master/texmf-dist/doc/latex/examdesign/exampleb.tex
@@ -1,4 +1,4 @@
-\documentclass[10pt, onekey]{exam}
+\documentclass[10pt, onekey]{examdesign}
 \Fullpages
 \NumberOfVersions{4}
 \def\eV{\mbox{eV}}
diff --git a/Master/texmf-dist/doc/latex/examdesign/examplec.dvi b/Master/texmf-dist/doc/latex/examdesign/examplec.dvi
deleted file mode 100644
index 658a531816d..00000000000
--- a/Master/texmf-dist/doc/latex/examdesign/examplec.dvi
+++ /dev/null
diff --git a/Master/texmf-dist/doc/latex/examdesign/examplec.pdf b/Master/texmf-dist/doc/latex/examdesign/examplec.pdf
new file mode 100644
index 00000000000..2052f106635
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/examdesign/examplec.pdf
diff --git a/Master/texmf-dist/doc/latex/examdesign/examplec.tex b/Master/texmf-dist/doc/latex/examdesign/examplec.tex
index b7784d298a5..a3f82336188 100644
--- a/Master/texmf-dist/doc/latex/examdesign/examplec.tex
+++ b/Master/texmf-dist/doc/latex/examdesign/examplec.tex
@@ -1,4 +1,4 @@
-\documentclass{exam}
+\documentclass{examdesign}
 \Fullpages
 \NumberOfVersions{3}