summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/exam
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-11-16 22:14:35 +0000
committerKarl Berry <karl@freefriends.org>2017-11-16 22:14:35 +0000
commit08c9009c085b5fb5cd2151a112662e3c689b67f7 (patch)
tree80a04ebaddc8ad615d6c2cbcffa758c540359f70 /Master/texmf-dist/doc/latex/exam
parentd703ad4829afa66b9973031c99a5dc1e9dd0c2ba (diff)
exam (16nov17)
git-svn-id: svn://tug.org/texlive/trunk@45832 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/exam')
-rw-r--r--Master/texmf-dist/doc/latex/exam/README9
-rw-r--r--Master/texmf-dist/doc/latex/exam/exam.md56
-rw-r--r--Master/texmf-dist/doc/latex/exam/examdoc.pdfbin463915 -> 481243 bytes
-rw-r--r--Master/texmf-dist/doc/latex/exam/examdoc.tex874
4 files changed, 741 insertions, 148 deletions
diff --git a/Master/texmf-dist/doc/latex/exam/README b/Master/texmf-dist/doc/latex/exam/README
index 96ea4c3a73a..fa68345e764 100644
--- a/Master/texmf-dist/doc/latex/exam/README
+++ b/Master/texmf-dist/doc/latex/exam/README
@@ -1,4 +1,5 @@
-This is version 2.5 of the exam document class, dated May 7, 2015.
+This is version 2.6 of the exam document class, dated October 26,
+2017.
The exam document class, together with its user's guide examdoc.tex,
attempts to make it easy for even a LaTeX novice to prepare exams.
@@ -11,7 +12,8 @@ subsubparts of subparts, all with optional point values.
each question and the total possible points for that question) or by
page number (listing each page with points and the total possible
points for that page). A grading table can cover the entire exam or
-just a part of the exam.
+just a part of the exam. Grading tables can have multiple rows or
+multiple columns.
3. Create headers and footers that are each specified in three parts:
One part to be left justified, one part to be centered, and one part
@@ -38,9 +40,8 @@ lined space, or space filled with a grid.
e.g., point values, or table headings), so that they can be adapted to
personal taste and/or languages other than English.
-
The user's guide examdoc.tex attempts to explain all of the
-possibilities in a readable way, with many specific examples.
+possibilities in a readable way, with many examples.
--------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/exam/exam.md5 b/Master/texmf-dist/doc/latex/exam/exam.md5
index e766cadd796..3d20ce21b91 100644
--- a/Master/texmf-dist/doc/latex/exam/exam.md5
+++ b/Master/texmf-dist/doc/latex/exam/exam.md5
@@ -1,3 +1,3 @@
-3d7b2787a32cf31f94fce30dbebe6a6d exam.cls
-0b79dabd1e74952a1f70abe1909330c2 examdoc.tex
-6c10f29d36dd8e009e854721b391fb50 examdoc.pdf
+01d4eea329c471b4295296dff587c23a exam.cls
+831e1841882d3e05abdae653595862d6 examdoc.pdf
+a9a481f4f36ec3dbf90ffe63f57ce803 examdoc.tex
diff --git a/Master/texmf-dist/doc/latex/exam/examdoc.pdf b/Master/texmf-dist/doc/latex/exam/examdoc.pdf
index 2193f665a85..37885b7ca40 100644
--- a/Master/texmf-dist/doc/latex/exam/examdoc.pdf
+++ b/Master/texmf-dist/doc/latex/exam/examdoc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/exam/examdoc.tex b/Master/texmf-dist/doc/latex/exam/examdoc.tex
index ac7f927d21c..cbcfb377a58 100644
--- a/Master/texmf-dist/doc/latex/exam/examdoc.tex
+++ b/Master/texmf-dist/doc/latex/exam/examdoc.tex
@@ -8,7 +8,8 @@
% The exam documentclass itself is in the file exam.cls.
-%%% Copyright (c) 1997, 2000, 2004, 2008, 2011, 2015 Philip S. Hirschhorn
+%%% Copyright (c) 1997, 2000, 2004, 2008, 2011, 2015, 2017
+% Philip S. Hirschhorn
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
@@ -49,9 +50,9 @@
% without generating pdf warnings:
\newcommand{\bs}{\texorpdfstring{\char`\\}{}}
-\newcommand{\docversion}{2.5}
-\newcommand{\docdate}{May 7, 2015}
-%\newcommand{\docdate}{\today}
+\newcommand{\docversion}{2.6}
+\newcommand{\docdate}{November 5, 2017}
+%\newcommand{\docdate}{Draft: \today}
%--------------------------------------------------------------------
%
@@ -128,8 +129,8 @@
Wellesley College\\
Wellesley, MA 02481\\
psh@math.mit.edu\\[\bigskipamount]
- Copyright \copyright~1994, 1997, 2000, 2004, 2008, 2011, 2015 Philip
- Hirschhorn\\
+ Copyright \copyright~1994, 1997, 2000, 2004, 2008, 2011, 2015, 2017\\
+ Philip Hirschhorn\\
All rights reserved}
\date{\docdate}
@@ -509,8 +510,8 @@ number for the \verb"\stretch" value. For example,
space allocated by \verb"\vspace{\stretch{1}}".)
In addition to leaving blank space, it's also possible to leave lined
-space, dotted lined space, or an empty box. For the full story, see
-section~\ref{sec:LeaveSpace}.
+space, dotted lined space, space printed with a grid, or an empty box.
+For the full story, see section~\ref{sec:LeaveSpace}.
%--------------------------------------------------------------------
\subsection{Headers and footers}
@@ -687,19 +688,24 @@ the command \verb"\printanswers"\indc{printanswers} at the beginning
of the exam (see section~\ref{sec:solutions}). The effect of this is
that
\begin{itemize}
-\item the contents of the
- environments\indt{solution}\indt{solutionorbox}%
- \indt{solutionorlines}\indt{solutionordottedlines}
+\item the contents of the environments
+ %
+ \index{solution environment@\texttt{solution} environment}%
+ %
+ \indt{solutionorbox}%
+ \indt{solutionorlines}\indt{solutionordottedlines}%
+ \indt{solutionorgrid}\indt{solutionbox}
\begin{center}
\begin{tabular}{l}
\verb"solution",\\
\verb"solutionorbox",\\
- \verb"solutionorlines", and\\
- \verb"solutionordottedlines"
+ \verb"solutionorlines",\\
+ \verb"solutionordottedlines",\\
+ \verb"solutionorgrid", and\\
+ \verb"solutionbox"
\end{tabular}
\end{center}
- (see section~\ref{sec:solutions}) will be printed on the next run of
- \LaTeX,
+ (see section~\ref{sec:solutions}) will be printed,
\item any choices of a \texttt{choices}\indt{choices},
\texttt{oneparchoices}\indt{oneparchoices},
\texttt{checkboxes}\indt{checkboxes}, or
@@ -1072,11 +1078,27 @@ The default is that the point value will be inserted at the beginning
of the question (or part, or subpart, or subsubpart) in parentheses,
but
\begin{itemize}
-\item the command \verb"\pointsinmargin"\indc{pointsinmargin} will
- cause the point values to be set in the left margin,
+\item the command \verb"\pointsinmargin"\indc{pointsinmargin} (or,
+ equivalently, the command
+ \verb"\pointsinleftmargin"\indc{pointsinleftmargin}) will cause the
+ point values to be set in the left margin,
\item the command
\verb"\pointsinrightmargin"\indc{pointsinrightmargin} will cause the
- point values to be set in the right margin, and
+ point values to be set in the right margin,
+\item the command
+ \verb"\pointstwosided"\indc{pointstwosided} will cause the
+ point values to be set
+ \begin{itemize}
+ \item in the right margin on odd numbered pages and
+ \item in the left margin on even numbered pages,
+ \end{itemize}
+\item the command
+ \verb"\pointstwosidedreversed"\indc{pointstwosidedreversed} will
+ cause the point values to be set
+ \begin{itemize}
+ \item in the left margin on odd numbered pages and
+ \item in the right margin on even numbered pages, and
+ \end{itemize}
\item the commands \verb"\nopointsinmargin"\indc{nopointsinmargin} and
\verb"\nopointsinrightmargin"\indc{nopointsinrightmargin} are
equivalent, and either of them will revert to the default situation.
@@ -1131,8 +1153,9 @@ Describe the effect on the aircraft industry.
section~\ref{sec:pointname}.)
\bigskip If you give the command
-\verb"\pointsinmargin"\indc{pointsinmargin}, then the above input will
-produce instead \pointsinmargin
+\verb"\pointsinmargin"\indc{pointsinmargin} (or, equivalently,
+\verb"\pointsinleftmargin"\indc{pointsinleftmargin}), then the above input
+will produce instead \pointsinmargin
\begin{questions}
\question[20]
Why is there air?
@@ -1489,8 +1512,9 @@ points.)
If you want some text (e.g., `` points'', or ``\%'') automatically
inserted along with the point values when using either
-\verb"\pointsinmargin" or \verb"\pointsinrightmargin", see the command
-\verb"\marginpointname" in section~\ref{sec:pointname}.
+\verb"\pointsinmargin", \verb"\pointsinrightmargin",
+\verb"\pointstwosided", or \verb"\pointstwosidedreversed", see the
+command \verb"\marginpointname" in section~\ref{sec:pointname}.
@@ -3611,7 +3635,8 @@ will cause the example in section~\ref{sec:CorrectChoice} to appear as
\index{customization!multiple choice questions|)}
%--------------------------------------------------------------------
%--------------------------------------------------------------------
-\section{Escaping the indentation: \texttt{\bs uplevel} and \texttt{\bs fullwidth}}
+\section{Escaping the indentation: \texttt{\bs uplevel} and
+ \texttt{\bs fullwidth}}
\label{sec:uplevel}
\index{indentation|(}
@@ -3708,9 +3733,9 @@ You can accomplish exactly the same thing by replacing
\end{verbatim}
by
\begin{verbatim}
- \begin{uplevel}
+ \begin{EnvUplevel}
The following two parts should be answered in classical Greek:
- \end{uplevel}
+ \end{EnvUplevel}
\end{verbatim}
If you want to give instructions for a group of questions, then the
@@ -4081,6 +4106,9 @@ which prints an empty box of height \verb"length" whose width equals
that of the current line. That is, the left edge is at the current
left margin (which depends on whether we're in a question, part,
subpart, or subsubpart) and the right edge is at the right margin.
+(The box printed by the \verb"\makeemptybox" command can be printed in
+color; for that, see section~\ref{sec:colorboxes}.)
+
\medskip
@@ -4157,6 +4185,7 @@ You can also insert an empty box when solutions are not being printed
by including an optional argument with the \verb"solutionoremptybox"
environment; see section~\ref{sec:SolSpace}.
+
\indcstop{makeemptybox}
\index{empty box|)}
\index{space!empty box|)}
@@ -4178,6 +4207,24 @@ lines that run the length of the current line. That is, they extend
from the current left margin (which depends on whether we're in a
question, part, subpart, or subsubpart) to the right margin.
+By default, the lines are in black. However, if you give the
+commands\indc{colorfillwithlines}\index{color package}
+\begin{center}
+ \begin{tabular}{l}
+ \verb"\usepackage{color}"\\
+ \verb"\colorfillwithlines"
+ \end{tabular}
+\end{center}
+then the lines will be in color, by default a light gray. That
+default color was defined by the
+command\indc{definecolor}\indt{FillWithLinesColor}
+\begin{center}
+ \verb"\definecolor{FillWithLinesColor}{gray}{0.8}"
+\end{center}
+\index{customization!\texttt{\char`\\fillwithlines}} You can change
+the color by giving a new \verb"\definecolor" command to redefine the
+color \texttt{FillWithLinesColor}.
+
\medskip
For example, if you type
@@ -4301,6 +4348,26 @@ command\index{customization!\texttt{\char`\\fillwithdottedlines}}
and that value can be changed by giving a new \verb"\setlength"
command.
+By default, the dotted lines are in black. However, if you give the
+commands\indc{colorfillwithdottedlines}\index{color package}
+\begin{center}
+ \begin{tabular}{l}
+ \verb"\usepackage{color}"\\
+ \verb"\colorfillwithdottedlines"
+ \end{tabular}
+\end{center}
+then the dotted lines will be in color, by default a light gray. That
+default color was defined by the
+command\indc{definecolor}\indt{FillWithDottedLinesColor}
+\begin{center}
+ \verb"\definecolor{FillWithDottedLinesColor}{gray}{0.8}"
+\end{center}
+\index{customization!\texttt{\char`\\fillwithdottedlines}} You can
+change the color by giving a new \verb"\definecolor" command to
+redefine the color \texttt{FillWithDottedLinesColor}.
+
+\medskip
+
For example, if you type
\begin{verbatim}
\begin{questions}
@@ -4412,7 +4479,7 @@ each square has outer side length equal to
\verb"\gridsize+\gridlinewidth".
By default, the created grids are in black. However, if you give the
-commands\indc{colorgrids}
+commands\indc{colorgrids}\index{color package}
\begin{center}
\begin{tabular}{l}
\verb"\usepackage{color}"\\
@@ -4514,7 +4581,7 @@ sure you're using either \verb"\pagestyle{headandfoot}" (the default)
or \verb"\pagestyle{foot}" (see section~\ref{sec:pagestyle}), and put
the following into your preamble (i.e., after the
\verb"\documentclass" command and before the \verb"\begin{document}"
- command):
+ command):\index{color package}\indc{gridfromfoot}
\begin{verbatim}
\usepackage{color}
\colorgrids
@@ -4736,14 +4803,13 @@ while if \verb"\printanswers" is in effect, you'll get \printanswers
\subsection{Solution environments}
\label{sec:SolEnv}
\index{solutions|(}
-\index{solution environment|(}
+\index{solution environment@\texttt{solution} environment|(}
\index{answers|(}
-\index{environment!solution|(}
-\index{environment!solutionorbox|(}
-\index{environment!solutionorlines|(}
-\index{environment!solutionordottedlines|(}
-\index{environment!solutionorgrid|(}
-\index{solution environment|(}
+\index{environment!solution@\texttt{solution}|(}
+\index{environment!solutionorbox@\texttt{solutionorbox}|(}
+\index{environment!solutionorlines@\texttt{solutionorlines}|(}
+\index{environment!solutionordottedlines@\texttt{solutionordottedlines}|(}
+\index{environment!solutionorgrid@\texttt{solutionorgrid}|(}
\index{solutionorbox environment|(}
\index{solutionorlines environment|(}
\index{solutionordottedlines environment|(}
@@ -4774,7 +4840,7 @@ document (see section~\ref{sec:answers}).
The six environments for solutions are divided into two types.
\begin{itemize}
-\item The \texttt{solutionorbox} environment (see
+\item The \texttt{solutionbox} environment (see
section~\ref{sec:solutionbox}) always prints a box, of whatever size
you choose, and if solutions are being printed it prints the
solution inside of the box.
@@ -4796,10 +4862,11 @@ The six environments for solutions are divided into two types.
differ only in the type of space they leave when you do include the
optional argument and solutions are not being printed.
-
The differences between these five environments are that if the
- optional argument is used and solutions are not being printed,
- then\index{solution environment!optional argument}
+ optional argument is used and solutions are not being printed, then
+ %
+ \index{solution environment@\texttt{solution} environment!optional argument}
+ %
\begin{itemize}
\item the \verb"solution" enviroment inserts that amount of blank
space, as if you had given a \verb"\vspace*"\indc{vspace*} command
@@ -4831,15 +4898,14 @@ points are not added to the points of the question or the points on
the page, and do not affect any gradetables or pointtables.
-\index{solution environment|)}
\index{solutionorbox environment|)}
\index{solutionorlines environment|)}
\index{solutionordottedlines environment|)}
-\index{environment!solution|)}
-\index{environment!solutionorbox|)}
-\index{environment!solutionorlines|)}
-\index{environment!solutionordottedlines|)}
-\index{environment!solutionorgrid|)}
+\index{environment!solution@\texttt{solution}|)}
+\index{environment!solutionorbox@\texttt{solutionorbox}|)}
+\index{environment!solutionorlines@\texttt{solutionorlines}|)}
+\index{environment!solutionordottedlines@\texttt{solutionordottedlines}|)}
+\index{environment!solutionorgrid@\texttt{solutionorgrid}|)}
%--------------------------------------------------------------------
\subsection{The appearance of the solution}
@@ -4864,7 +4930,10 @@ environments can be printed either
\item with no framing or shading (see section~\ref{sec:SolPlain}).
\end{itemize}
In all of these cases, solutions can be broken across pages, and the
-part on each page will be boxed or shaded as appropriate.
+part on each page will be boxed or shaded as appropriate. In
+addition, the \verb"\SolutionEmphasis" command can be used to
+highlight the text of the solution (using, e.g., boldface, or italics,
+or color); see section~\ref{sec:SolEmph}.
%--------------------------------------------------------------------
@@ -4874,7 +4943,8 @@ part on each page will be boxed or shaded as appropriate.
By default, the solution is printed inside of a box (i.e., an
\verb"\fbox"\indc{fbox}), and if the solution is broken across pages,
-then each piece is enclosed in a box. There is also a
+then each piece is enclosed in a box. (The box can be printed in
+color; for that, see section~\ref{sec:colorboxes}.) There is also a
\verb"\shadedsolutions"\indc{shadedsolutions} command to instead have
the solution printed in a \verb"\colorbox"\indc{colorbox} (i.e.,
printed on a shaded background); for this, you must load the
@@ -5040,6 +5110,56 @@ which returns you to the default situation.
\index{solution!no framing or shading|)}
%--------------------------------------------------------------------
+\subsection{Imported graphics in solutions}
+\label{sec:graphics}
+\index{graphics|(}
+\indc{includegraphics}
+
+Graphics can be included inside solution environments using the
+\verb"\includegraphics" command, as long as you've given the command
+\verb"\usepackage{graphicx}" in the preamble (i.e., after the
+\verb"\documentclass" command and before the \verb"\begin{document}"
+ command).
+
+A problem sometimes arises because many \LaTeX{} manuals say that you
+should put an \verb"\includegraphics" command inside of a
+\texttt{figure} environment, so that it will float to a convenient
+place on a page. The problem with this is that floating environments
+can't appear inside of a solution environment.
+
+There are (at least) two solutions to this problem, depending on
+whether you really want the graphic to float away from the location at
+which you've typed it.
+\begin{itemize}
+\item If you want the graphic to float, put the \texttt{figure}
+ environment \emph{outside} of the solution environment, using
+ \verb"\ifprintanswers" to ensure that it's printed only when
+ solutions are being printed, as in
+\begin{verbatim}
+\ifprintanswers
+ \begin{figure}
+ \includegraphics[width=7cm]{myfigure.pdf}
+ \caption{This is a lovely figure}
+ \label{fig:lovely}
+ \end{figure}
+\fi
+\end{verbatim}
+\item If you \emph{don't} want the graphic to float, then omit the
+ \texttt{figure} environment and just put the \verb"\includegraphics"
+ command wherever you want the graphic to appear. If you want the
+ graphic to have a caption, then put the command
+ \verb"\usepackage{caption}" in your preamble and then use the
+ \verb"\captionof" command, as in
+\begin{verbatim}
+\includegraphics[width=7cm]{myfigure.pdf}
+\captionof{figure}{This is a lovely figure}
+\label{fig:lovely}
+\end{verbatim}
+\end{itemize}
+
+\index{graphics|)}
+
+%--------------------------------------------------------------------
\subsection{Customizing the solution}
\label{sec:SolCust}
\index{customization!solution|(}
@@ -5162,7 +5282,7 @@ solution is printed. For the default definition of the
\label{sec:SolSpace}
\index{space!for answers|(}
\index{answer space|(}
-\index{solution environment!optional argument|(}
+\index{solution environment@\texttt{solution} environment!optional argument|(}
Each of the \texttt{solution}, \texttt{solutionorbox},
\texttt{solutionorlines}, \texttt{solutionordottedlines}, and
@@ -5170,7 +5290,9 @@ Each of the \texttt{solution}, \texttt{solutionorbox},
\begin{itemize}
\item In a
%
- \verb"solution"\indtsub{solution}{optional argument}
+ \verb"solution"
+ %
+ \index{solution environment@\texttt{solution} environment!optional argument}
%
environment this is an amount of blank space to be left (just as if
you had used a \verb"\vspace*"\indc{vspace*} command; see
@@ -5313,13 +5435,16 @@ solutions are being printed.
\emph{Note:} The document class option \texttt{cancelspace} and the
command \verb"\cancelspace" only affect the optional arguments of of
-the five solution environments; they do \emph{not} affect any
-\verb"\vspace" commands that you put into the file.
+the five solution environments \texttt{solution},
+\texttt{solutionorbox}, \texttt{solutionorlines},
+\texttt{solutionordottedlines}, and \texttt{solutionorgrid}; they do
+\emph{not} affect any \verb"\vspace" commands that you put into the
+file.
\indcstop{nocancelspace}
\indcstop{cancelspace}
-\index{solution environment!optional argument|)}
+\index{solution environment@\texttt{solution} environment!optional argument|)}
%--------------------------------------------------------------------
\subsection{The solutionbox environment}
@@ -5348,7 +5473,11 @@ environments (\texttt{solution}, \texttt{solutionorbox},
\end{enumerate}
If answers are not being printed then only the box is printed, with
nothing in it. If answers are being printed, then the solution is
-printed inside of the box.
+printed inside of the box. (The box printed by the
+\texttt{solutionbox} environment can be printed in color; for that,
+see section~\ref{sec:colorboxes}.)
+
+
For example, if you type
\begin{verbatim}
@@ -5375,11 +5504,69 @@ being printed, then you'll get
If solutions \emph{are} being printed, then the exact same box would
be printed, but it would have the solution printed inside of it.
-
-
\index{answer space|)}
\index{space!for answers|)}
+%--------------------------------------------------------------------
+\subsection{Solution box frames in color}
+\label{sec:colorboxes}
+
+The frames that are printed by the commands that create solution boxes
+can be printed in color. (By ``frame'' we mean the four lines that
+constitute the box, not any solution that may appear inside that box.)
+This includes
+\begin{itemize}
+\item the box printed by the \texttt{solutionbox}
+ environment\index{customization!\texttt{solutionbox}}
+ (see section~\ref{sec:solutionbox}),
+\item the box printed by the \verb"\makeemptybox"
+ command\index{customization!\texttt{\char`\\makeemptybox}}
+ (see section~\ref{sec:EmptyBox}),
+\item the box printed by the optional argument of the
+ \texttt{solutionorbox}
+ environment\index{customization!\texttt{solutionorbox}} (see
+ section~\ref{sec:SolEnv}), and
+\item the box printed around the solution by
+ the\index{customization!\texttt{solution} environments}
+ \begin{itemize}
+ \item \texttt{solution},
+ \item \texttt{solutionorbox},
+ \item \texttt{solutionorlines},
+ \item \texttt{solutionordottedlines}, and
+ \item \texttt{solutionorgrid}
+ \end{itemize}
+ environments when solutions are being printed and the default
+ solution appearance (\verb"\framedsolutions") is being used (see
+ section~\ref{sec:SolBox}).
+\end{itemize}
+
+If you've given the command
+\begin{center}
+ \verb"\usepackage{color}"\index{color package}
+\end{center}
+in the preamble of your document (i.e., after the
+\verb"\documentclass" command and before the \verb"\begin{document}"
+command), then you can give the command\indc{colorsolutionboxes}
+\begin{center}
+ \verb"\colorsolutionboxes"
+\end{center}
+to have the frame printed in color. The color of the frame will be
+\texttt{SolutionBoxColor}, the default value of which was created by
+the command\indc{definecolor}\indt{SolutionBoxColor}
+\begin{center}
+ \verb"\definecolor{SolutionBoxColor}{gray}{0.8}"
+\end{center}
+You can change the color by giving a new \verb"\definecolor" command,
+but you must do this \emph{after} the \verb"\colorsolutionboxes"
+command.
+
+To cancel color \texttt{solutionbox} frames and return to black, give
+the command\indc{nocolorsolutionboxes}
+\begin{center}
+ \verb"\nocolorsolutionboxes"
+\end{center}
+
+
%--------------------------------------------------------------------
\subsection{Changes depending on whether or not solutions are
@@ -5473,7 +5660,7 @@ environment will have no effect.
\indcstop{ifprintanswers}
\index{answers|)}
-\index{solution environment|)}
+\index{solution environment@\texttt{solution} environment|)}
\index{solutions|)}
@@ -5721,15 +5908,194 @@ page. If this becomes a problem, then you can either
\item create grading ranges (see section~\ref{sec:PartialTable}) and
print several partial grading tables, making each one small enough
to fit on the page, or
-\item use the \verb"\pointsofquestion" command (see
- section~\ref{sec:pointsofq}) or the \verb"\pointsonpage" command
- (see section~\ref{sec:pointsonp}) to create a custom \verb"tabular"
- environment that has more rows (or columns) than the tables produced
- by the \verb"gradingtable" command.
+\item use the \verb"\multirowgradetable" or
+ \verb"\multicolumngradetable" command (see section~\ref{sec:MulRows}
+ and section~\ref{sec:MulCols}) to create a grading table with
+ multiple rows or multiple columns.
\end{itemize}
\index{grading table!by question number or page number|)}
%--------------------------------------------------------------------
+\subsubsection{Grading tables with multiple rows}
+\label{sec:MulRows}
+
+If you want to print a horizontal grading table but the table would be
+too large for the page, you can print a grading table with multiple
+rows by giving the command
+\begin{center}
+ \verb"\multirowgradetable{numrows}[questions or pages]"
+\end{center}
+\indc{multirowgradetable}Note that the first argument
+(\texttt{numrows}) is \emph{required}, and so it is enclosed in
+braces, but the second argument (\texttt{questions} or \texttt{pages})
+is optional, and is enclosed in square brackets, just as in the
+\verb"\gradetable" command (see section~\ref{sec:GradeTables}). For
+example, to print a grading table with 3 rows indexed by questions,
+you would give the command
+\begin{center}
+ \verb"\multirowgradetable{3}[questions]"
+\end{center}
+The command
+\begin{center}
+ \verb"\gradetable[h][questions]"
+\end{center}
+is equivalent to
+\begin{center}
+ \verb"\multirowgradetable{1}[questions]"
+\end{center}
+
+The distance between the rows of a multirow table is
+\verb"\doublerulesep", the default value of which is 2.0pt. You can
+change that using a \verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
+For example, if an exam has 16 questions, each worth a total of 15
+points, and you type
+\begin{verbatim}
+\begin{center}
+ \setlength{\doublerulesep}{0.25in}
+ \multirowgradetable{2}[questions]
+\end{center}
+\end{verbatim}
+then you'll get
+\begin{center}
+ \setlength{\doublerulesep}{0.25in}
+ \cwidth=2em
+ \renewcommand{\arraystretch}{1.5}
+ \begin{tabular}{|l|c|c|c|c|c|c|c|c|c|}
+ \hline
+ Question:& 1& 2& 3& 4& 5& 6& 7& 8& 9\\
+ \hline
+ Points:&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15\\
+ \hline
+ Score:&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \\
+ \hline
+ \hline
+ Question:& 10& 11& 12& 13& 14& 15& 16&& Total\\
+ \hline
+ Points:&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ 15&
+ &
+ 240\\
+ \hline
+ Score:&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \hbox to \cwidth{\hfill}&
+ \\
+ \hline
+ \end{tabular}
+\end{center}
+
+
+%--------------------------------------------------------------------
+\subsubsection{Grading tables with multiple columns}
+\label{sec:MulCols}
+
+If you want to print a vertical grading table but the table would be
+too large for the page, you can print a grading table with multiple
+columns by giving the command
+\begin{center}
+ \verb"\multicolumngradetable{numcols}[questions or pages]"
+\end{center}
+\indc{multicolumngradetable}Note that the first argument
+(\texttt{numcols}) is \emph{required}, and so it is enclosed in
+braces, but the second argument (\texttt{questions} or \texttt{pages})
+is optional, and is enclosed in square brackets, just as in the
+\verb"\gradetable" command (see section~\ref{sec:GradeTables}). For
+example, to print a grading table with 3 columns indexed by questions,
+you would give the command
+\begin{center}
+ \verb"\multicolumngradetable{3}[questions]"
+\end{center}
+The command
+\begin{center}
+ \verb"\gradetable[v][questions]"
+\end{center}
+is equivalent to
+\begin{center}
+ \verb"\multicolumngradetable{1}[questions]"
+\end{center}
+
+The distance between the columns of a multicolumn table is
+\verb"\doublerulesep", the default value of which is 2.0pt. You can
+change that using a \verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
+For example, if an exam has 10 questions, each worth a total of 15
+points, and you type
+\begin{verbatim}
+\begin{center}
+ \setlength{\doublerulesep}{0.5in}
+ \multicolumngradetable{2}[questions]
+\end{center}
+\end{verbatim}
+then you'll get
+\begin{center}
+ \cwidth=2em
+ \setlength{\doublerulesep}{0.5in}
+ \renewcommand{\arraystretch}{1.5}
+ \begin{tabular}{|c|c|c|c|c|c|c|}
+ \cline{1-3}\cline{5-7}
+ Question& Points& Score&
+ \hspace*{-\arrayrulewidth}\hspace*{\doublerulesep}&
+ Question& Points& Score\\
+ \cline{1-3}\cline{5-7}
+ 1& 15& \hbox to \cwidth{\hfill}&&7& 15& \hbox to \cwidth{\hfill}\\
+ \cline{1-3}\cline{5-7}
+ 2& 15& \hbox to \cwidth{\hfill}&&8& 15& \hbox to \cwidth{\hfill}\\
+ \cline{1-3}\cline{5-7}
+ 3& 15& \hbox to \cwidth{\hfill}&&9& 15& \hbox to \cwidth{\hfill}\\
+ \cline{1-3}\cline{5-7}
+ 4& 15& \hbox to \cwidth{\hfill}&&10& 15& \hbox to \cwidth{\hfill}\\
+ \cline{1-3}\cline{5-7}
+ 5& 15& \hbox to \cwidth{\hfill}&& & & \hbox to \cwidth{\hfill}\\
+ \cline{1-3}\cline{5-7}
+ 6& 15& \hbox to \cwidth{\hfill}&&Total:& 150& \hbox to \cwidth{\hfill}\\
+ \cline{1-3}\cline{5-7}
+
+ \cline{1-3}\cline{5-7}
+ \end{tabular}
+\end{center}
+
+
+
+%--------------------------------------------------------------------
\subsection{Point tables indexed by question number or by page
number}
\label{sec:PointTables}
@@ -5893,15 +6259,88 @@ page. If this becomes a problem, then you can either
\item create grading ranges (see section~\ref{sec:PartialTable}) and
print several partial point tables, making each one small enough
to fit on the page, or
-\item use the \verb"\pointsofquestion" command (see
- section~\ref{sec:pointsofq}) or the \verb"\pointsonpage" command
- (see section~\ref{sec:pointsonp}) to create a custom \verb"tabular"
- environment that has more rows (or columns) than the tables produced
- by the \verb"pointtable" command.
+\item use the \verb"\multirowpointtable" or
+ \verb"\multicolumnpointtable" command (see
+ section~\ref{sec:PtMulRows} and section~\ref{sec:PtMulCols}) to
+ create a point table with multiple rows or multiple columns.
\end{itemize}
\index{point table!by question number or page number|)}
%--------------------------------------------------------------------
+\subsubsection{Point tables with multiple rows}
+\label{sec:PtMulRows}
+
+If you want to print a horizontal point table but the table would be
+too large for the page, you can print a point table with multiple
+rows by giving the command
+\begin{center}
+ \verb"\multirowpointtable{numrows}[questions or pages]"
+\end{center}
+\indc{multirowpointtable}Note that the first argument
+(\texttt{numrows}) is \emph{required}, and so it is enclosed in
+braces, but the second argument (\texttt{questions} or \texttt{pages})
+is optional, and is enclosed in square brackets, just as in the
+\verb"\pointtable" command (see section~\ref{sec:PointTables}). For
+example, to print a point table with 3 rows indexed by questions, you
+would give the command
+\begin{center}
+ \verb"\multirowpointtable{3}[questions]"
+\end{center}
+The command
+\begin{center}
+ \verb"\pointtable[h][questions]"
+\end{center}
+is equivalent to
+\begin{center}
+ \verb"\multirowpointtable{1}[questions]"
+\end{center}
+
+The distance between the rows of a multirow table is
+\verb"\doublerulesep", the default value of which is 2.0pt. You can
+change that using a \verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
+%--------------------------------------------------------------------
+\subsubsection{Point tables with multiple columns}
+\label{sec:PtMulCols}
+
+If you want to print a vertical point table but the table would be
+too large for the page, you can print a point table with multiple
+columns by giving the command
+\begin{center}
+ \verb"\multicolumnpointtable{numcols}[questions or pages]"
+\end{center}
+\indc{multicolumnpointtable}Note that the first argument
+(\texttt{numcols}) is \emph{required}, and so it is enclosed in
+braces, but the second argument (\texttt{questions} or \texttt{pages})
+is optional, and is enclosed in square brackets, just as in the
+\verb"\pointtable" command (see section~\ref{sec:PointTables}). For
+example, to print a point table with 3 columns indexed by questions,
+you would give the command
+\begin{center}
+ \verb"\multicolumnpointtable{3}[questions]"
+\end{center}
+The command
+\begin{center}
+ \verb"\pointtable[v][questions]"
+\end{center}
+is equivalent to
+\begin{center}
+ \verb"\multicolumnpointtable{1}[questions]"
+\end{center}
+
+The distance between the columns of a multicolumn table is
+\verb"\doublerulesep", the default value of which is 2.0pt. You can
+change that using a \verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
+%--------------------------------------------------------------------
\subsection{Table entries as clickable links}
\label{sec:Clickable}
\index{grading table!clickable links}
@@ -5932,7 +6371,8 @@ instead of the numbers of those questions, and those question titles
will be clickable links that take you to the corresponding question.
%--------------------------------------------------------------------
-\subsection{Grading ranges, partial grading tables, and partial point tables}
+\subsection{Grading ranges, partial grading tables, and partial point
+ tables}
\label{sec:PartialTable}
\index{grading range|(}
\indcstart{begingradingrange}
@@ -6006,6 +6446,91 @@ section~\ref{sec:BonusTables} and section~\ref{sec:CombinedTables}).
\indcstop{begingradingrange}
\index{grading range|)}
+
+%--------------------------------------------------------------------
+\subsubsection{Partial grading tables and partial point tables with
+ multiple rows}
+\label{sec:PartMulRows}
+
+If you want to print a horizontal partial grading table or partial
+point table but the table would be too large for the page, you can
+print a partial grading table or partial point table with multiple
+rows by giving the one of the commands
+\begin{center}
+ \verb"\multirowpartialgradetable{numrows}{rangename}[questions or pages]"
+ \verb"\multirowpartialpointtable{numrows}{rangename}[questions or pages]"
+\end{center}
+\indc{multirowpartialgradetable}\indc{multirowpartialpointtable}Note
+that the first two arguments (\texttt{numrows} and \texttt{rangename})
+are \emph{required}, and so they are enclosed in braces, but the third
+argument (\texttt{questions} or \texttt{pages}) is optional, and is
+enclosed in square brackets, just as in the \verb"\partialgradetable"
+and \verb"\partialpointtable" commands (see
+section~\ref{sec:PartialTable}). For example, to print a partial
+grading table with 3 rows covering the range \texttt{myrange} indexed
+by questions, you would give the command
+\begin{center}
+ \verb"\multirowpartialgradetable{3}{myrange}[questions]"
+\end{center}
+The command
+\begin{center}
+ \verb"\partialgradetable{myrange}[h][questions]"
+\end{center}
+is equivalent to
+\begin{center}
+ \verb"\multirowpartialgradetable{1}{myrange}[questions]"
+\end{center}
+
+The distance between the rows of a multirow table is
+\verb"\doublerulesep", the default value of which is 2.0pt. You can
+change that using a \verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
+%--------------------------------------------------------------------
+\subsubsection{Partial grading tables and partial point tables with
+ multiple columns}
+\label{sec:PartMulCols}
+
+If you want to print a vertical partial grading table or partial point
+table but the table would be too large for the page, you can print a
+partial grading table or partial point table with multiple columns by
+giving one of the commands
+\begin{center}
+\verb"\multicolumnpartialgradetable{numcols}{rangename}[questions or pages]"\\
+\verb"\multicolumnpartialpointtable{numcols}{rangename}[questions or pages]"
+\end{center}
+\indc{multicolumnpartialgradetable}\indc{multicolumnpartialpointtable}Note
+that the first two arguments (\texttt{numcols} and
+\texttt{rangename}) are \emph{required}, and so they are enclosed in
+braces, but the third argument (\texttt{questions} or \texttt{pages})
+is optional, and is enclosed in square brackets, just as in the
+\verb"\partialgradetable" and \verb"\partialpointtable" commands (see
+section~\ref{sec:PartialTable}). For example, to print a partial
+grading table with 3 columns covering the range \texttt{myrange}
+indexed by questions, you would give the command
+\begin{center}
+ \verb"\multicolumnpartialgradetable{3}{myrange}[questions]"
+\end{center}
+The command
+\begin{center}
+ \verb"\partialgradetable{myrange}[v][questions]"
+\end{center}
+is equivalent to
+\begin{center}
+ \verb"\multicolumnpartialgradetable{1}{myrange}[questions]"
+\end{center}
+
+The distance between the columns of a multicolumn table is
+\verb"\doublerulesep", the default value of which is 2.0pt. You can
+change that using a \verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
%--------------------------------------------------------------------
\subsection{\texttt{\bs pointsofquestion}}
\label{sec:pointsofq}
@@ -6114,29 +6639,59 @@ commands that count only the bonus points and ignore the non-bonus
points. (There are also commands that create tables listing both
non-bonus and bonus points; see section~\ref{sec:CombinedTables}.)
These commands, and the non-bonus commands to which they correspond,
-are as follows:\indc{bonusgradetable}\indc{bonuspointtable}%
-\indc{bonuspointsinrange}\indc{partialbonusgradetable}%
-\indc{partialbonuspointtable}\indc{bonuspointsofquestion}%
-\indc{bonuspointsonpage}
+are as follows:
\begin{center}
\begin{tabular}{l@{\qquad\qquad}l}
Bonus points& Non-bonus points\\[\bigskipamount]
\verb"\bonusgradetable"& \verb"\gradetable"\\
- \verb"\bonuspointtable"& \verb"\pointtable"\\[\medskipamount]
- \verb"\bonuspointsinrange"& \verb"\pointsinrange"\\
+ \verb"\multirowbonusgradetable"& \verb"\multirowgradetable"\\
+ \verb"\multicolumnbonusgradetable"& \verb"\multicolumngradetable"\\
+ \verb"\bonuspointtable"& \verb"\pointtable"\\
+ \verb"\multirowbonuspointtable"& \verb"\multirowpointtable"\\
+ \verb"\multicolumnbonuspointtable"&
+ \verb"\multicolumnpointtable"\\[\medskipamount]
\verb"\partialbonusgradetable"& \verb"\partialgradetable"\\
+ \verb"\multirowpartialbonusgradetable"&
+ \verb"\multirowpartialgradetable"\\
+ \verb"\multicolumnpartialbonusgradetable"&
+ \verb"\multicolumnpartialgradetable"\\
\verb"\partialbonuspointtable"&
- \verb"\partialpointtable"\\[\medskipamount]
+ \verb"\partialpointtable"\\
+ \verb"\multirowpartialbonuspointtable"&
+ \verb"\multirowpartialpointtable"\\
+ \verb"\multicolumnpartialbonuspointtable"&
+ \verb"\multicolumnpartialpointtable"\\[\medskipamount]
+ \verb"\bonuspointsinrange"& \verb"\pointsinrange"\\
\verb"\bonuspointsofquestion"& \verb"\pointsofquestion"\\
\verb"\bonuspointsonpage"& \verb"\pointsonpage"
\end{tabular}
\end{center}
+\indc{bonusgradetable}\indc{bonuspointtable}%
+\indc{bonuspointsinrange}\indc{partialbonusgradetable}%
+\indc{partialbonuspointtable}\indc{bonuspointsofquestion}%
+\indc{bonuspointsonpage}%
+\indc{multirowbonusgradetable}%
+\indc{multicolumnbonusgradetable}%
+\indc{multirowbonuspointtable}%
+\indc{multicolumnbonuspointtable}%
+\indc{multirowpartialbonusgradetable}%
+\indc{multicolumnpartialbonusgradetable}%
+\indc{multirowpartialbonuspointtable}%
+\indc{multicolumnpartialbonuspointtable}%
All of the the commands in the first column count bonus points and
ignore non-bonus points, while all of the commands in the second
-column count non-bonus points and ignore bonus points. The
-\verb"\partialbonusgradetable" and \verb"\partialbonuspointtable"
-commands use the same
-\verb"\begingradingrange"\indc{begingradingrange} and
+column count non-bonus points and ignore bonus points. The commands
+\begin{center}
+ \begin{tabular}{l}
+ \verb"\partialbonusgradetable",\\
+ \verb"\multirowpartialbonusgradetable",\\
+ \verb"\multicolumnpartialbonusgradetable",\\
+ \verb"\partialbonuspointtable",\\
+ \verb"\multirowpartialbonuspointtable", and\\
+ \verb"\multicolumnpartialbonuspointtable"
+ \end{tabular}
+\end{center}
+use the same \verb"\begingradingrange"\indc{begingradingrange} and
\verb"\endgradingrange"\indc{endgradingrange} commands that are used
by the corresponding non-bonus versions (see
section~\ref{sec:PartialTable}). Just as is described in
@@ -6214,14 +6769,15 @@ then you'll get
There are commands for producing \emph{combined} grading and point
tables, both partial and full, that tabulate both regular points and
-bonus points (see section~\ref{sec:Bonus}). These commands, and the
+bonus points (see section~\ref{sec:Bonus}). The single-row and
+single-column versions of these commands, and the
non-bonus and bonus commands to which they correspond, are
\indc{combinedgradetable}\indc{combinedpointtable}%
\indc{partialcombinedgradetable}\indc{partialcombinedpointtable}%
\begin{center}
\begin{tabular}{l@{\enskip}l@{\enskip}l}
- Non-Bonus points only& Bonus points only&
- Combined\\[\medskipamount]
+ Non-Bonus points only& \multicolumn{1}{c}{Bonus points only}&
+ \multicolumn{1}{c}{Combined}\\[\medskipamount]
\verb"\gradetable"& \verb"\bonusgradetable"&
\verb"\combinedgradetable"\\
\verb"\pointtable"& \verb"\bonuspointtable"&
@@ -6242,6 +6798,37 @@ and then the same two optional arguments as the other commands (the
first being either \verb"[v]" or \verb"[h]" and the second being
either \verb"[questions]" or \verb"[pages]").
+The multirow and multicolumn versions of combined grading tables and
+combined point tables are produced by the commands
+\indc{multirowcombinedgradetable}%
+\indc{multirowcombinedpointtable}%
+\indc{multirowpartialcombinedgradetable}%
+\indc{multirowpartialcombinedpointtable}%
+\indc{multicolumncombinedgradetable}%
+\indc{multicolumncombinedpointtable}%
+\indc{multicolumnpartialcombinedgradetable}%
+\indc{multicolumnpartialcombinedpointtable}%
+\begin{verbatim}
+\multirowcombinedgradetable{numrows}[questions or pages]
+\multirowcombinedpointtable{numrows}[questions or pages]
+\multirowpartialcombinedgradetable{numrows}{rangename}[questions or pages]
+\multirowpartialcombinedpointtable{numrows}{rangename}[questions or pages]
+\multicolumncombinedgradetable{numcols}[questions or pages]
+\multicolumncombinedpointtable{numcols}[questions or pages]
+\multicolumnpartialcombinedgradetable{numcols}{rangename}[questions or pages]
+\multicolumnpartialcombinedpointtable{numcols}{rangename}[questions or pages]
+\end{verbatim}
+The distance between the rows of a multirow table and between the
+columns of a multicolumn table is \verb"\doublerulesep", the default
+value of which is 2.0pt. You can change that using a
+\verb"\setlength" command, as in
+\begin{center}
+ \verb"\setlength{\doublerulesep}{0.5in}"
+\end{center}
+(see section~\ref{sec:CustTable}).
+
+
+
Just as is described in section~\ref{sec:Clickable} for their regular
points and section~\ref{sec:BonusTables} for bonus points, if you put
the
@@ -6412,7 +6999,7 @@ and no other tables will be affected by that
\index{grade table!customization|(}
\index{point table!customization|(}
-There are three ways in which you can customize the appearance of
+There are four ways in which you can customize the appearance of
grading tables and point tables:
\begin{itemize}
\item You can change the words (and the fonts) that appear in the
@@ -6421,20 +7008,30 @@ grading tables and point tables:
you will write the scores.
\item You can change the value of
\verb"\baselinestretch"\indc{baselinestretch} used for the table.
+\item You can change the distance between the rows in a multirow table
+ and the distance between the columns in a multicolumn table.
\end{itemize}
For all grading and point tables:\indc{gradetablestretch}\indc{cellwidth}
+\indc{doublerulesep}%
\begin{center}
- \begin{tabular}{l@{\qquad}l}
+ \begin{tabular}{l@{\qquad}p{3in}}
\verb"\cellwidth{length}"& sets the minimum width of the blank cells to
- \verb"length"\\
+ \verb"length"\\[\medskipamount]
\verb"\gradetablestretch{number}"& uses \verb"number" as the
- \verb"\baselinestretch"
+ \verb"\baselinestretch"\\[\medskipamount]
+ \verb"\setlength{\doublerulesep}{length}"& sets the distance
+ between the columns of a multicolumn table and the distance
+ between the rows of a multirow table to \verb"length".
\end{tabular}
\end{center}
-For vertical non-bonus tables (i.e., tables created by
-\verb"\gradetable[v]", \verb"\pointtable[v]",
-\verb"\partialgradetable{rangename}[v]", or
-\verb"\partialpointtable{rangename}[v]"):%
+For vertical non-bonus tables:
+% (i.e., tables created by
+% \verb"\gradetable[v]", \verb"\multicolumngradetable",
+% \verb"\pointtable[v]", \verb"\multicolumnpointtable",
+% \verb"\partialgradetable{rangename}[v]",
+% \verb"\multicolumnpartialgradetable",
+% \verb"\partialpointtable{rangename}[v]", or
+% \verb"\multicolumnpartialpointtable"):%
\indc{vqword}\indc{vpgword}\indc{vpword}\indc{vsword}\indc{vtword}
\begin{center}
\begin{tabular}{l@{\qquad}l}
@@ -6446,10 +7043,11 @@ For vertical non-bonus tables (i.e., tables created by
\verb"\vtword{text}"& substitutes \verb"text" for ``Total:''
\end{tabular}
\end{center}
-For horizontal non-bonus tables (i.e., tables created by
-\verb"\gradetable[h]", \verb"\pointtable[h]",
-\verb"\partialgradetable{rangename}[h]", or
-\verb"\partialpointtable{rangename}[h]"):%
+For horizontal non-bonus tables:
+% (i.e., tables created by
+% \verb"\gradetable[h]", \verb"\pointtable[h]",
+% \verb"\partialgradetable{rangename}[h]", or
+% \verb"\partialpointtable{rangename}[h]"):%
\indc{hqword}\indc{hpgword}\indc{hpword}\indc{hsword}\indc{htword}
\begin{center}
\begin{tabular}{l@{\qquad}l}
@@ -6461,11 +7059,13 @@ For horizontal non-bonus tables (i.e., tables created by
\verb"\htword{text}"& substitutes \verb"text" for ``Total''
\end{tabular}
\end{center}
-For vertical bonus tables (i.e., tables created by
-\verb"\bonusgradetable[v]", \verb"\bonuspointtable[v]",
-\verb"\partialbonusgradetable{rangename}[v]", or
-\verb"\partialbonuspointtable{rangename}[v]"):\indc{bvqword}%
-\indc{bvpgword}\indc{bvpword}\indc{bvsword}\indc{bvtword}
+For vertical bonus tables:
+% (i.e., tables created by
+% \verb"\bonusgradetable[v]", \verb"\bonuspointtable[v]",
+% \verb"\partialbonusgradetable{rangename}[v]", or
+% \verb"\partialbonuspointtable{rangename}[v]"):
+\indc{bvqword}\indc{bvpgword}\indc{bvpword}\indc{bvsword}%
+\indc{bvtword}
\begin{center}
\begin{tabular}{l@{\qquad}l}
Command& \multicolumn{1}{c}{Effect}\\[\medskipamount]
@@ -6476,11 +7076,13 @@ For vertical bonus tables (i.e., tables created by
\verb"\bvtword{text}"& substitutes \verb"text" for ``Total:''
\end{tabular}
\end{center}
-For horizontal bonus tables (i.e., tables created by
-\verb"\bonusgradetable[h]", \\
-\verb"\bonuspointtable[h]",
-\verb"\partialbonusgradetable{rangename}[h]", or\\
-\verb"\partialbonuspointtable{rangename}[h]"):\indc{bhqword}%
+For horizontal bonus tables:
+% (i.e., tables created by
+% \verb"\bonusgradetable[h]", \\
+% \verb"\bonuspointtable[h]",
+% \verb"\partialbonusgradetable{rangename}[h]", or\\
+% \verb"\partialbonuspointtable{rangename}[h]"):
+\indc{bhqword}%
\indc{bhpgword}\indc{bhpword}\indc{bhsword}\indc{bhtword}
\begin{center}
\begin{tabular}{l@{\qquad}l}
@@ -6492,11 +7094,13 @@ For horizontal bonus tables (i.e., tables created by
\verb"\bhtword{text}"& substitutes \verb"text" for ``Total''
\end{tabular}
\end{center}
-For vertical combined tables (i.e., tables created by
-\verb"\combinedgradetable[v]",\\
-\verb"\combinedpointtable[v]",
-\verb"\partialcombinedgradetable{rangename}[v]", or\\
-\verb"\partialcombinedpointtable{rangename}[v]"):\indc{cvqword}%
+For vertical combined tables:
+% (i.e., tables created by
+% \verb"\combinedgradetable[v]",\\
+% \verb"\combinedpointtable[v]",
+% \verb"\partialcombinedgradetable{rangename}[v]", or\\
+% \verb"\partialcombinedpointtable{rangename}[v]"):
+\indc{cvqword}%
\indc{cvpgword}\indc{cvpword}\indc{cvbpword}\indc{cvsword}%
\indc{cvtword}
\begin{center}
@@ -6510,11 +7114,13 @@ For vertical combined tables (i.e., tables created by
\verb"\cvtword{text}"& substitutes \verb"text" for ``Total:''
\end{tabular}
\end{center}
-For horizontal combined tables (i.e., tables created by
-\verb"\combinedgradetable[h]", \\
-\verb"\combinedpointtable[h]",
-\verb"\partialcombinedgradetable{rangename}[h]", or\\
-\verb"\partialcombinedpointtable{rangename}[h]"):\indc{chqword}%
+For horizontal combined tables:
+% (i.e., tables created by
+% \verb"\combinedgradetable[h]", \\
+% \verb"\combinedpointtable[h]",
+% \verb"\partialcombinedgradetable{rangename}[h]", or\\
+% \verb"\partialcombinedpointtable{rangename}[h]"):
+\indc{chqword}%
\indc{chpgword}\indc{chpword}\indc{chbpword}\indc{chsword}%
\indc{chtword}
\begin{center}
@@ -6529,16 +7135,15 @@ For horizontal combined tables (i.e., tables created by
\end{tabular}
\end{center}
If you don't use any of these commands then you get the default
-values, which are defined by the commands in the following table:
+values, which are defined by the commands in the following
+table:\indc{doublerulesep}\indc{gradetablestretch}\indc{cellwidth}
\begin{center}
- \begin{tabular}{l@{\quad}l@{\quad}l}
- \multicolumn{3}{c}{\bfseries Defaults for grading and point
+ \begin{tabular}{l@{\quad}l}
+ \multicolumn{2}{c}{\bfseries Defaults for grading and point
tables}\\*[\bigskipamount]
- \verb"\hqword{Question:}"& \verb"\vqword{Question}"&
- \verb"\cellwidth{2em}"\\
- \verb"\hpgword{Page:}"& \verb"\vpgword{Page}"&
- \verb"\gradetablestretch{1.5}"\\
- \verb"\hpword{Points:}"& \verb"\vpword{Points}"\\
+ \verb"\hqword{Question:}"& \verb"\vqword{Question}"\\
+ \verb"\hpgword{Page:}"& \verb"\vpgword{Page}"\\
+ \verb"\hpword{Points:}"& \verb"\vpword{Points}"\\
\verb"\hsword{Score:}"& \verb"\vsword{Score}"\\
\verb"\htword{Total}"& \verb"\vtword{Total:}"\\[\medskipamount]
%
@@ -6553,7 +7158,10 @@ values, which are defined by the commands in the following table:
\verb"\chpword{Points:}"& \verb"\cvpword{Points}"\\
\verb"\chbpword{Bonus Points:}"& \verb"\cvbpword{Bonus Points}"\\
\verb"\chsword{Score:}"& \verb"\cvsword{Score}"\\
- \verb"\chtword{Total}"& \verb"\cvtword{Total:}"
+ \verb"\chtword{Total}"& \verb"\cvtword{Total:}"\\[\medskipamount]
+ \verb"\cellwidth{2em}"\\
+ \verb"\gradetablestretch{1.5}"\\
+ \verb"\setlength{\doublerulesep}{2.0pt}"
\end{tabular}
\end{center}
@@ -6888,7 +7496,8 @@ appear on every page, you would give the command
\indcstop{runningheader}
%--------------------------------------------------------------------
-\subsubsection{Using \texttt{\bs lhead}, \texttt{\bs chead} and \texttt{\bs rhead}}
+\subsubsection{Using \texttt{\bs lhead}, \texttt{\bs chead} and
+ \texttt{\bs rhead}}
\label{sec:lhead}
\indcstart{lhead}
\indcstart{chead}
@@ -7022,7 +7631,8 @@ section~\ref{sec:numpages}.)
\indcstop{runningfooter}
%--------------------------------------------------------------------
-\subsubsection{Using \texttt{\bs lfoot}, \texttt{\bs cfoot}, and \texttt{\bs rfoot}}
+\subsubsection{Using \texttt{\bs lfoot}, \texttt{\bs cfoot}, and
+ \texttt{\bs rfoot}}
\label{sec:lfoot}
\indcstart{lfoot}
\indcstart{cfoot}
@@ -7102,15 +7712,6 @@ command\indcsub{extraheadheight}{different on first page}
\end{center}
gives a half inch of extra head height on the first page and a
quarter inch of extra head height on all pages after the first.
-If you say
-\begin{center}
- \verb"\extraheadheight[.5in]{}"
-\end{center}
-then this will be interpreted as if it was
-\begin{center}
- \verb"\extraheadheight[.5in]{0in}"
-\end{center}
-Note that the braces \emph{must} appear.
If you give an \verb"\extraheadheight"\indc{extraheadheight} command,
it should be in the preamble, i.e., after the \verb"\documentclass"
@@ -7151,15 +7752,6 @@ command\indcsub{extrafootheight}{different on first page}
\end{center}
gives a half inch of extra foot height on the first page and a
quarter inch of extra foot height on all pages after the first.
-If you say
-\begin{center}
- \verb"\extrafootheight[.5in]{}"
-\end{center}
-then this will be interpreted as if it was
-\begin{center}
- \verb"\extrafootheight[.5in]{0in}"
-\end{center}
-Note that the braces \emph{must} appear.
If you give an \verb"\extrafootheight"\indc{extrafootheight} command,
it should be in the preamble, i.e., after the \verb"\documentclass"