texlive[64134] Master/texmf-dist/doc/latex/exam: exam (17aug22)

[commits+karl at tug.org]

Revision: 64134
          http://tug.org/svn/texlive?view=revision&revision=64134
Author:   karl
Date:     2022-08-17 22:58:13 +0200 (Wed, 17 Aug 2022)
Log Message:
-----------
exam (17aug22)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/exam/exam.md5
    trunk/Master/texmf-dist/doc/latex/exam/examdoc.pdf
    trunk/Master/texmf-dist/doc/latex/exam/examdoc.tex

Modified: trunk/Master/texmf-dist/doc/latex/exam/exam.md5
===================================================================
--- trunk/Master/texmf-dist/doc/latex/exam/exam.md5	2022-08-16 23:49:11 UTC (rev 64133)
+++ trunk/Master/texmf-dist/doc/latex/exam/exam.md5	2022-08-17 20:58:13 UTC (rev 64134)
@@ -1,3 +1,3 @@
 b210b790c86d89aeccb508074bd001ae  exam.cls
-c9c5a6648a0a34ff32595455124eec6c  examdoc.tex
-6de4faf2e619d56b8516369800d8a04a  examdoc.pdf
+08261e0c96d341f948483d8fbf78a118  examdoc.pdf
+b44eb4ab2c875e46f5239d5c27c37d64  examdoc.tex

Modified: trunk/Master/texmf-dist/doc/latex/exam/examdoc.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/exam/examdoc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/exam/examdoc.tex	2022-08-16 23:49:11 UTC (rev 64133)
+++ trunk/Master/texmf-dist/doc/latex/exam/examdoc.tex	2022-08-17 20:58:13 UTC (rev 64134)
@@ -53,7 +53,7 @@
 \newcommand{\bs}{\texorpdfstring{\char`\\}{}}
 
 \newcommand{\docversion}{2.7}
-\newcommand{\docdate}{February 26, 2021}
+\newcommand{\docdate}{August 14, 2022}
 %\newcommand{\docdate}{Draft: \today}
 
 %--------------------------------------------------------------------
@@ -595,7 +595,8 @@
 
 Sections~\ref{sec:beginexamples} through \ref{sec:endexamples} contain
 many other examples of headers and footers, and the full explanation
-of the commands for headers and footers is in
+of the commands for headers and footers (including header and footer
+commands other than the ones we've just mentioned) is in
 sections~\ref{sec:pagestyle}--\ref{sec:QuesSpan}.
 
 \index{header|)}
@@ -7568,7 +7569,7 @@
 \begin{verbatim}
 \lhead{Math 115}
 \chead[Second Exam]{}
-\rhead[July 4, 1776]{Second Exam Continued)}
+\rhead[July 4, 1776]{Second Exam (Continued)}
 \end{verbatim}
 
 Any of the three parts of the header can have multiple lines.  To
@@ -7591,7 +7592,33 @@
 
 \index{header!three parts|)}
 
+%--------------------------------------------------------------------
+\subsubsection{Commands with optional arguments}
+\label{sec:OptArg}
+\index{optional arguments}
 
+\LaTeX{} has the property that if a command takes an optional
+argument, and if that optional argument contains a command that also
+has an optional argument, then \emph{that inner command must be
+  enclosed within curly braces}.  For example, if you want the right
+justified part of the first page header to be
+\samplehead{}{}{Name:\enspace\makebox[2in]{\hrulefill}}{} but you want
+the right justified part of the header on pages after the first to be
+empty, then you should give the command
+\begin{verbatim}
+\rhead[{Name:\enspace\makebox[2in]{\hrulefill}}]{}
+\end{verbatim}
+Note that the optional argument to the \verb"\rhead" command is
+\begin{verbatim}
+{Name:\enspace\makebox[2in]{\hrulefill}}
+\end{verbatim}
+and not
+\begin{verbatim}
+Name:\enspace\makebox[2in]{\hrulefill}
+\end{verbatim}
+This is due to the way that \LaTeX{} delimits optional arguments, and
+is nothing special about the \verb"exam" document class.
+
 %---------------------------------------------------------------------
 \subsubsection*{Leaving extra room for multiple line headers}
 
@@ -8334,11 +8361,14 @@
 \pagestyle{headandfoot}
 \lhead{\large\bfseries Mathematics 115\\ First Exam, July 4, 1776}
 \chead{}
-\rhead[\large\bfseries Name:\enspace\makebox[2in]{\hrulefill}]{}
+\rhead[{\large\bfseries Name:\enspace\makebox[2in]{\hrulefill}}]{}
 \lfoot{}
 \cfoot[]{Page \thepage}
 \rfoot{}
 \end{verbatim}
+  (For an explanation of why there seems to be an extra pair of curly
+  braces in the optional argument to the \verb"\rhead" command, see
+  section~\ref{sec:OptArg}.)
 \end{example}
 
 %--------------------------------------------------------------------