diff options
author | Karl Berry <karl@freefriends.org> | 2022-10-10 20:22:56 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-10-10 20:22:56 +0000 |
commit | 1a12075ba4cc3ca26d4c82b08bcb87b2e2aa62cc (patch) | |
tree | 382db7df13f634f4acf716cc4338db26e63286da /Master/texmf-dist/doc/latex/exam-n | |
parent | 793d2c31e077f91a0573b85c8a499a45dd4a2e0e (diff) |
exam-n (10oct22)
git-svn-id: svn://tug.org/texlive/trunk@64674 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/exam-n')
27 files changed, 1470 insertions, 1026 deletions
diff --git a/Master/texmf-dist/doc/latex/exam-n/A1.clo b/Master/texmf-dist/doc/latex/exam-n/A1.clo deleted file mode 100644 index d40b8c26a96..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/A1.clo +++ /dev/null @@ -1,82 +0,0 @@ -\ProvidesFile{A1.clo}[2016/12/19 1.1.4] -\typeout{A1 exam options, 1.1.4} -%%%% Source: Mercurial revision e8a612cb25f4, 2016-12-19 16:49 +0000, tag exam-n-1.1.4 + 0 -%%%% File: A1.clo -%%%% Copyright 2005--2016, Norman Gray -%% -%% This work may be distributed and/or modified under the -%% conditions of the LaTeX Project Public License, either version 1.3 -%% of this license or (at your option) any later version. -%% The latest version of this license is in -%% http://www.latex-project.org/lppl.txt -%% and version 1.3 or later is part of all distributions of LaTeX -%% version 2005/12/01 or later. -%% -%% This work has the LPPL maintenance status `maintained'. -%% -%% The Current Maintainer of this work is Norman Gray <http://nxg.me.uk> -%% -%% This work consists of the files exam-n.dtx and exam-n.ins, -%% the derived file exam-n.cls, -%% and the associated *.clo files. - -% Nothing here beyond the constants sheet -\constantssheet{ -\begin{center} -\def\e{{\rm e}}\def\deg{^\circ} -\def\dmin{^{\rm m}} -\def\dsec{^{\rm s}} -\def\ez{\epsilon_{\rm 0}} % permittivity of free space -\def\er{\epsilon_{\rm r}} % relative permittivity -\def\ep{\epsilon} % permittivity -\def\muz{\mu_{\rm 0}} % permeability of free space -\def\mur{\mu_{\rm r}} % relative permeability -\def\me{m_{\rm e}} % mass of the electron -\def\mprot{m_{\rm p}} % mass of the proton -\def\az{\a_{\rm 0}} % Bohr radius -\def\mub{\mu_{\rm B}} % Bohr magneton -% -\def\tothe#1{$^{#1}$} % raise to the power #1 -\def\metre{\,{\rm m}} -\def\kg{\,{\rm kg}} -\def\sec{\,{\rm s}} -\def\mm{\,{\rm mm}} -\def\mol{\,{\rm mol}} -\def\kelvin{\,{\rm K}} -\def\joule{\,{\rm J}} -\def\farad{\,{\rm F}} -\def\ampere{\,{\rm A}} -\def\ev{\,{\rm eV}} -\def\hz{\,{\rm Hz}} -\def\volt{\,{\rm V}} -\def\watt{\,{\rm W}} -\def\newton{\,{\rm N}} -\def\unit#1{\,{\rm #1}} -% -{\Large\textbf{Values of astrophysical constants}}\\[\bigskipamount] -\begin{tabular}{lll} \hline\\[-1.5ex] % slightly hacky extra space after hline - speed of light & $c$ & $2.998\times 10^8 \metre\sec^{-1}$\\ - gravitational constant & $G$ & $6.673\times10^{-11}\newton\metre^2\kg^{-2}$\\ - Planck constant & $h$ & $6.626\times10^{-34}\joule\sec$\\ - Boltzmann constant & $k_{\rm B}$ & $1.381\times10^{-23} \joule\kelvin^{-1}$\\ - Stefan-Boltzmann constant & $\sigma$ & $5.671\times10^{-8}\watt\metre^{-2}\kelvin^{-4}$\\ - Rydberg constant & $R_\infty$ &$1.097\times10^{7}\metre^{-1}$\\ - Avogadro constant & $N_{\rm A}$ & $6.022\times 10^{23}\unit{mol}^{-1}$\\ - gas constant & $R$ & $8.315 \joule\mol^{-1}\kelvin^{-1}$\\ - proton mass & $\mprot$ & $1.673\times10^{-27} \kg$\\ - electron mass & $\me$ & $9.109\times10^{-31} \kg$\\ - elementary charge & $e$ & $1.602\times 10^{-19}\unit{C}$\\ - electronvolt & ${\rm eV}$ & $1.602\times 10^{-19}\unit{J}$\\[3pt] - astronomical unit & au & $1.496\times10^{11} \metre$\\ - parsec & pc & $3.086\times10^{16}\metre$\\ - light year & ly & $9.461\times10^{15} \metre$\\[3pt] - solar mass & $M_\odot$ & $1.989\times10^{30} \kg$\\ - solar radius & $R_\odot$ & $6.960\times10^8 \metre$\\ - solar luminosity & $L_\odot$ & $3.826\times10^{26}\watt$\\ - Earth mass & $M_\oplus$ & $5.976\times10^{24} \kg$\\ - Earth radius & $R_\oplus$ & $6.378\times10^6 \metre$\\ - obliquity of the ecliptic & $\epsilon$ & $23^\circ\,26'$\\[\medskipamount] -\hline -\end{tabular} -\end{center} -} diff --git a/Master/texmf-dist/doc/latex/exam-n/README b/Master/texmf-dist/doc/latex/exam-n/README deleted file mode 100644 index a128c336efe..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/README +++ /dev/null @@ -1,69 +0,0 @@ - -exam-n: LaTeX class file for exams, version 1.1.4, 2016 December 19. -==================================== - -[ Mercurial revision e8a612cb25f4, 2016-12-19 16:49 +0000, tag exam-n-1.1.4 + 0 ] - - -Overview --------- - -The class is designed to be localised to a particular institution's -exam layout, by a suitably skilled LaTeX hacker. There are three -possible ways of doing this, in increasing order of sophistication: - - 1. Make suitable adjustments to individual exam `.tex` files; or - - 2. Rename the distributed `exam-n.dtx` file to something more locally - suitable, and edit it with suitable changes (search for - `%%%CONFIGURE` for hints on where to adjust); or - - 3. Fork the Mercurial repository at - [bitbucket](https://bitbucket.org/nxg/exam-n), change the - value of the `EXAM-N` variable in the `Makefile`, and then - edit the `exam-n.dtx` file. See the comments at the top of the - `Makefile`. - -In case 2, you _must_ change the name of the `.dtx` file, and in case -3, you must change the `EXAM-N` variable, to avoid terrible confusion -(you probably also want to avoid the names of the other exam style -files at CTAN, since they just might have found their way into your -TEXINPUTS path). - -For general details, talk to Norman Gray <norman@astro.gla.ac.uk>. - -This is free software, and you are encouraged to use and adapt it as -you see fit. Norman can give advice. If, however, you need more -substantial help with the customisations of option 3 above, or need -continuing support, then we can surely arrange something more -elaborate. - -With the version 1.1 release, the interface should now be regarded -as rather stable. However version 1.1 was the first to be released -outside Glasgow University, so there may be some changes to the -interface which will emerge with broader use, as well as some bug -fixes. The interface _may_, therefore, yet change. If you use -this class to produce exams, it would be wise to include a copy of -the class file locally, rather than relying on a central version. If -you need an earlier version of the class, let me know. - - -Documentation ------------- - - * Documentation for question authors is in `notes-for-authors.pdf`. - * The full version of the documentation, for 'exam conveners' (or - equivalent) is in `exam-n.pdf`. This and the author - documentation are built as part of the distribution. - * Basic documentation for a LaTeX localiser is in this file (see - above), with extra remarks at the top of the `Makefile`. - -There are brief release notes in exam-n.html. - - -Distribution and copyright --------------------------- - -Copyright 2005--2016, Norman Gray <http://nxg.me.uk> -Distributed under the terms of The LaTeX Project Public License (LPPL); -see the file lppl.txt for details. diff --git a/Master/texmf-dist/doc/latex/exam-n/README.ctan b/Master/texmf-dist/doc/latex/exam-n/README.md index 872ae0b92ad..872ae0b92ad 100644 --- a/Master/texmf-dist/doc/latex/exam-n/README.ctan +++ b/Master/texmf-dist/doc/latex/exam-n/README.md diff --git a/Master/texmf-dist/doc/latex/exam-n/exam-n-example.tex b/Master/texmf-dist/doc/latex/exam-n/exam-n-example.tex index b7287c67a58..154827d5e14 100644 --- a/Master/texmf-dist/doc/latex/exam-n/exam-n-example.tex +++ b/Master/texmf-dist/doc/latex/exam-n/exam-n-example.tex @@ -6,10 +6,13 @@ %% %% exam-n.dtx (with options: `example') %% exam-n: format exam questions -%% Release version 1.1.4, 2016 December 19. +%% Release version exam-n-1.4.0, 2022 October 10. +%% See https://purl.org/nxg/dist/exam-n +%% and https://heptapod.host/nxg/exam-n +%% and https://www.ctan.org/pkg/exam-n %% %%%% File: exam-n.dtx -%%%% Copyright 2005--2016, Norman Gray +%%%% Copyright 2005--2022, Norman Gray %% %% This work may be distributed and/or modified under the %% conditions of the LaTeX Project Public License, either version 1.3 @@ -21,13 +24,13 @@ %% %% This work has the LPPL maintenance status `maintained'. %% -%% The Current Maintainer of this work is Norman Gray <http://nxg.me.uk> +%% The Current Maintainer of this work is Norman Gray <https://nxg.me.uk> %% %% This work consists of the files exam-n.dtx and exam-n.ins, %% the derived file exam-n.cls, %% and the associated *.clo files. -%%%% Source: Mercurial revision e8a612cb25f4, 2016-12-19 16:49 +0000, tag exam-n-1.1.4 + 0 +%%%% Source: a91e9cff7cac, 2022-10-10T13:33:17+01:00 %% @@ -87,12 +90,11 @@ $\Delta=6\pi M^2/h^2$, stating clearly any assumptions that you make.\partmarks{6} The solar-mass star HD83443 has a 0.35 Jupiter-mass planet that -follows a circular orbit of period 2.986 days and radius 0.038\units\au. +follows a circular orbit of period 2.986 days and radius \SI{0.038}{\astronomicalunit}. Calculate the rate of precession, in arcseconds per year, of the pericentre line of the planet's orbit.\partmarks{4} -[Schwartzschild radius of the Sun${}= 3.0\times10^3\units{m}$, -$1\units\au=1.5\times10^{11}\units m$]. +[Schwartzschild radius of the Sun: \SI{3e3}m; $\SI1\astronomicalunit = \SI{1.5e11}m$] \begin{solution} In the first type of calculation, we do a calculation in the LIF, in @@ -128,6 +130,13 @@ have a clue. \end{document} %%%END example +\@ifl@t@r\fmtversion{2020/10/01} + {\typeout{Format is \fmtversion -- OK!}} + {\ClassError{exam-n} + {You need a more recent version of LaTeX} + {This class now requires a + LaTeX version at least 2020/10/01; version + \fmtversion\ is too old}} \endinput %% %% End of file `exam-n-example.tex'. diff --git a/Master/texmf-dist/doc/latex/exam-n/exam-n.html b/Master/texmf-dist/doc/latex/exam-n/exam-n.html index 717d683aa95..f0b75478971 100644 --- a/Master/texmf-dist/doc/latex/exam-n/exam-n.html +++ b/Master/texmf-dist/doc/latex/exam-n/exam-n.html @@ -1,10 +1,242 @@ +<?xml version="1.0" encoding="utf-8"?> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>exam-n class</title> -<link href="http://nxg.me.uk" rev="author"/> -<link type="text/css" rel="stylesheet" - href="style.css"/> -<style type='text/css'> +<link href="https://nxg.me.uk" rev="author"/> + + +<style class="distonly" type="text/css">body { + color: #333; + background: white; + margin-left: +30%; + width: 50%; /* body is 50% of screen width */ + margin-right: auto; /* ie, 20% */ + padding: 0.5em; /* this will make a difference if I decide to + have the background a different colour */ + /* I can't decide on font: Optima's always nice, but Gill looks + agreeably intense. Helvetica's a decent fallback. */ + font-family: "Helvetica Neue", Helvetica, "Gill Sans", gill, sans-serif; + /* font-family: Optima, "Gill Sans", gill, Helvetica, sans-serif; */ + /* font-family: "Gill Sans", gill, Helvetica, sans-serif; */ + /* I seem to have used 11pt at some point in the past, but this + is far too big -- did I ever have a reason for that, or is it + just due to browser changes? */ + font-size: 10pt; + line-height: 150%; +} + +div.topsidebar { + float: right; + width: 50%; /* ...of the body width (ie, 50% x 50% of screen) */ + font-size: smaller; + margin-left: 1em; + padding-left: 1em; + border-left: solid thin #AAA; +} + +/* On wider screens, move the sidebar out to the right hand side */ +/* This uses CSS3 media queries: http://www.w3.org/TR/css3-mediaqueries/ */ +@media screen and (min-width: 700pt) and (max-width: 850pt) { + body { + margin-left: 210pt; + width: 350pt; /* 50% of 700pt */ + margin-right: auto; + } + div.topsidebar { + position: absolute; + /* I feel this size should be 595pt (350 + 210 + 0.05*700), + but that's clearly not right -- I don't think I understand what the -5% + in the h1 spec below is actually 5% of! */ + left: 570pt; + width: auto; + margin-left: 0pt; + padding-left: 0pt; + border: none; + } +} +/* On still-wider screens, expand the left-margin, keeping the sidebar attached to the right-hand edge. + When the screen is 850pt wide (expanding from the @media case above), + the left margin will be 210pt, the width 350pt, and the right margin therefore 290pt.*/ +@media screen and (min-width: 850pt) { + body { + margin-right: 290pt; /* 290 = 850-(210+350) */ + width: 350pt; + margin-left: auto; /* ...takes up the slack */ + } + div.topsidebar { + position: absolute; + width: 290pt; /* same 290pt as above */ + left: auto; + right: 0%; + padding-left: 0pt; + border: none; + } +} + + +code, pre { + font-family: Monaco, fixed; + font-size: 9pt; +} + +a { text-decoration: none; } +a:link { color: #66C; } +a:visited { color: #669; } +a[href]:hover { background: #EEE; } + +div.abstract { + font-style: oblique; + text-align: left; +} +div.abstract em { font-style: normal; } +div.abstract code { + font-style: normal; + font-size: 80%; +} + +/* a span/div style for attracting attention */ +.attention { + color: #822; +} + +h1, h2, h3, h4, h5, h6 { + color: #822; + font-weight: 100; /* few fonts have ultra-light weights */ + line-height: 100%; /* no need to spread out titles */ +} +h1 { + margin-left: -40%; + margin-right: -5%; + padding: 0.5em; + border: solid thin #666; + text-align: right; +} +h2 { + margin-left: -40%; + margin-right: -5%; + padding: 0.2em; + border-top: solid thin #666; + clear: both; +} + +h2.appendices { + margin-top: 10ex; + border-top: double medium #666; +} +h3 { + margin-left: -30%; + float: left; + width: 25%; + display: block; + text-align: right; + vertical-align: bottom; + padding-top: 0pt; + padding-right: 0.5em; + margin-top: 0pt; + line-height: 100%; +} + +/* +h4 { + color: #C66; +} +*/ + +pre, table { background: #dde; } + +pre { + padding: 1em; + line-height: 130%; +} + +table { + font-size: smaller; +} +td { + padding: 0.5ex; +} + +Q:before { content: "“"; } +Q:after { content: "”"; } + +img.smallimage { + float: right; + margin: 24pt; + margin-right: -30%; +} + +div.signature { + margin-left: -40%; + margin-right: -5%; + margin-top: 4ex; + text-align: right; + border: solid thin #666; + padding: 0.3em; + clear: both; +} + +/* ============================================================ + * Some other curiosities of my one-time formatting for web pages + */ +.doc-history { + font-size: xx-small; + background: #eee; + line-height: 100%; +} + +div.subtoc, div.subsubtoc { display: none; } + +/* ============================================================ + * Special formatting for ToC + */ + +/* + If there's significant amount of text in front of the first subsection, + then the following are good to put in the per-document stylesheet: + width: 25%; + float: right; +*/ +div#toc { + color: #888; + padding: 0; + font-size: smaller; + text-align: right; +} +div#toc a:link { color: #888; } +div#toc > ul { + padding: 0pt; + margin: 0pt; + list-style: none; +} +div#toc li { + padding: 0pt; + display: inline-block; +} +div#toc li:before { + content: "§ "; + margin-left: 1em; +} +/* the following elements aren't currently generated by structure.lx */ +div#toc li ul { + padding-left: 1em; + margin-left: 0; + font-style: italic; + display: inline; +} +div#toc li ul:before { + content: "( "; +} +div#toc li ul:after { + content: " ) "; +} +div#toc li li { + padding-left: 0pt; +} +div#toc li li:after { + content: "; "; +} +</style> +<style type="text/css"> dd ul { padding: 0pt; margin: 0pt; } </style> </head> @@ -14,26 +246,24 @@ dd ul { padding: 0pt; margin: 0pt; } <p>Format exam papers</p> -<p>Version 1.1.4, 2016 December 19.</p> +<p class="distonly">This is version exam-n-1.4.0, 2022 October 10.</p> + + <ul> -<li>Download: <a href='exam-n-1.1.4.tar.gz'>tarball</a> -or <a href='exam-n-1.1.4.zip'>zip file</a></li> -<li>You may want to look at a <a href='sample_exam.pdf'>sample -exam</a>. See the <code>sample/</code> directory in the distribution -for the source of this. That demonstrates the final version of the -paper, as opposed to the ‘draft’ and ‘compose’ versions; there’s also -a version with this layout but -<a href='sample_exam_solution.pdf'>showing the solutions</a>.</li> + +<li class="distonly">See the sample exam in the distribution.</li> <li>If you're a question author, you probably don't want to read the full documentation. Stick to the shorter -<a href='notes-for-authors.pdf'>notes for authors</a>.</li> -<li>See the <a href='exam-n.pdf' >documentation</a> for fuller +<a href="notes-for-authors.pdf">notes for authors</a>.</li> +<li>See the <a href="exam-n.pdf">documentation</a> for fuller discussion.</li> <li>The package's 'home page' is -<a href='http://purl.org/nxg/dist/exam-n'><code>http://purl.org/nxg/dist/exam-n</code></a>, -and the repository is available at -<a href='https://bitbucket.org/nxg/exam-n'>bitbucket</a>.</li> +<a href="https://purl.org/nxg/dist/exam-n"><code>https://purl.org/nxg/dist/exam-n</code></a>, +and the repository is available to +<a href="https://heptapod.host/nxg/exam-n">browse</a> +or clone.</li> +<li>And it's on CTAN at <a href="https://www.ctan.org/pkg/exam-n">/pkg/exam-n</a>.</li> </ul> <h2>Overview</h2> @@ -41,13 +271,13 @@ and the repository is available at <h3>Other exam styles</h3> <p>There are already multiple ‘exam’ LaTeX styles on CTAN, including -the (original?) <a href='http://dante.ctan.org/tex-archive/macros/latex/contrib/exam/'>exam class</a>, -the extensive <a href='http://www.math.uakron.edu/~dpstory/webeq.html' >AcroTeX</a> bundle, +the (original?) <a href="http://dante.ctan.org/tex-archive/macros/latex/contrib/exam/">exam class</a>, +the extensive <a href="http://www.math.uakron.edu/~dpstory/webeq.html">AcroTeX</a> bundle, the -<a href='http://dante.ctan.org/tex-archive/macros/latex/contrib/examdesign/'>examdesign</a> and -<a href='http://dante.ctan.org/tex-archive/macros/latex/contrib/exams/'>exams</a> +<a href="http://dante.ctan.org/tex-archive/macros/latex/contrib/examdesign/">examdesign</a> and +<a href="http://dante.ctan.org/tex-archive/macros/latex/contrib/exams/">exams</a> classes, and -<a href='http://www.tex.ac.uk/cgi-bin/CTANcataloguesearch.pl?CATSTRING=exam'>a variety of other packages</a> +<a href="http://www.tex.ac.uk/cgi-bin/CTANcataloguesearch.pl?CATSTRING=exam">a variety of other packages</a> which mention exams in some way. Some of these are more focused on generating quizzes (even doing things like randomising answers) @@ -82,6 +312,45 @@ checks to avoid mistakes. The result has, in effect, been validated by practice.</p> +<h2>To install</h2> +<p>Unpack the distribution tarball or zip +file, and move the directory <code>move-to-texmf</code> (or its +contents) to some +location on the LaTeX search path. You're probably looking for a +directory called <code>texmf-local</code>, or something like that.</p> + +<p>‘Move…to a suitable place’ is admittedly very vague. Here are some +pointers, however:</p> +<ul> +<li>This can be the same location as your exam source files. This +will work, but you'll have to do this for each directory.</li> +<li>See the good generic advice in +<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf">the +TeX FAQ</a>.</li> +<li>Your LaTeX environment might have some hints on ‘installing new +style files’, or you can search online with some search string like +that.</li> +<li>If you're on a unix-like OS, then the command <code>kpsewhich +guexam.cls</code> will show you which class file LaTeX will use (so if +it produces no result, that's telling you that LaTeX won't find the +files); also <code>kpsepath tex</code> will display, in an admittedly +very oblique form, the list of places where TeX will search.</li> +<li>If you're using MikTeX, then the documentation on the +‘<a href="https://miktex.org/howto/miktex-console">MikTeX console</a>’ +includes a section on ‘Registering a user-managed TEXMF root +directory’. This rather obliquely says that you can ‘register a +user-managed TEXMF root directory’. What that means is that (i) +you should go to a folder such as +<code>...\Users\<em>yourname</em>\AppData\MikTeX</code>, (ii) create a +sequence of folders so that you end up with +<code>...\MikTeX\texmf\tex\latex\exam-n</code>, and (iii) put the +distributed <code>.sty</code> and <code>.clo</code> files in the +latter folder. The directory <code>...\MikTex\texmf</code> is your +‘user-managed TEXMF root directory’, and you should add it to MikTeX's +search path using the instructions above.</li> +</ul> + + <h2>Releases</h2> <p>With the version 1.1 release, the interface should now be regarded @@ -99,65 +368,113 @@ renamed to avoid a conflict with a pre-existing LaTeX class with the same name; and in the second it was renamed to make it more generically useful to other institutions.</p> -<dl> - -<!-- @RELEASENOTES@ --> -<dt><span class='attention'>1.1.4, 2016 December 19</span></dt> -<dd><ul> -<li>Documentation: add notes about use of pdfpages.</li> -<li>Added <code>[largefont]</code> option. -<strong>Note</strong>: -option <code>[hugefont]</code> has replaced <code>[bigfont]</code>; -the latter is now deprecated, and may be removed in v1.2.</li> -<li>Use of the <code>\part</code> macro is now supported within -solutions (it produced the wrong numbers before), and there is a new -<code>\StylePartNumber</code> customisation macro.</li> -</ul></dd> - -<dt>1.1.3</dt> -<dd><ul> -<li>Version 1.1.3 was never released</li> -</ul></dd> - -<dt>1.1.2, 2015 November 26</dt> -<dd><ul> -<li>Handled trailing floats at end of document (generated by packages -such as <code>rotating</code>.</li> -<li><code>\label</code> within question environment now refers to the -question number.</li> -<li>Work around a problem when a paragraph starts with <code>{\bf ...}</code> -rather than (post-1995) <code>\textbf{...}</code>.</li> -<li><code>\begin{questiondata}</code> now starts a new paragraph.</li> -<li>Some documentation adjustments.</li> -</ul></dd> - -<dt>1.1.1, 2014 November 27</dt> -<dd><ul> -<li>Adjust <code>\partmarks*</code> behaviour; now behaves differently -within display maths (addresses -<a href='https://bitbucket.org/nxg/exam-n/issue/1/'>issue 1</a>).</li> -<li>Various documentation and release fixes.</li> -</ul></dd> - -<dt>1.1, 2014 May 3</dt> -<dd>Converted to a generic class, <code>exam-n</code>, ready for wider -distribution. -Available on <a href='https://bitbucket.org/nxg/exam-n/'>bitbucket</a> -and at CTAN.</dd> - - -<dt>...</dt> -<dd><a href='release-notes.html'>Earlier release notes</a> are available</dd> - -</dl> +<h:dl xmlns:h="http://www.w3.org/1999/xhtml"> +<h:dt><h:span class="attention">1.4.0, 2022 October 10</h:span></h:dt><h:dd> + <ul> + <li>The [siunitx] option is now on by default, and the + <code>\units</code> macro produces a one-time-per-document + warning that it will be removed in the next version.</li> + <li>Having two <code>\partmarks</code> commands in an + environment is now detected as an error (it was documented as an + error, but not checked, so the extra <code>\partmarks</code> + commands were simply ignored).</li> + </ul> + </h:dd> + +<h:dt>1.4.0-b1, 2022 August 7</h:dt><h:dd> + <ul> + <li>The class file now depends on a version of LaTeX which is at least + the 2020/10/01 release. This is so that we can use the current LaTeX + hooks mechanism.</li> + <li>Rework <code>\partmarks</code>: the <code>\partmarks</code> + indicator can now go <em>inside</em> most environments, including + list, quotes, unnumbered equations, and the various amsmath displays. In these + cases, the indicator will automatically appear at the end of the + environment. The starred variant of the command still exists, but + should rarely be necessary.</li> + </ul> + </h:dd> + +<h:dt>1.3.5-b1, 2022 July 11</h:dt><h:dd><ul> +<li>Fix erroneous broken line before <code>\partmarks</code>, in +compose mode, when a paragraph fills the last line.</li> +<li>Fix support for STIX2 fonts in XeLaTeX and LuaLaTeX (it was +working inaccurately before).</li> +<li>Add an optional argument for <code>\part</code> to override part numbering.</li> +<li>Use the <code>xcolor</code> package for colour management, instead +of the core <code>color</code> package (the <code>xcolor</code> +package is well-known and stable, and this means that we are +compatible with TikZ).</li> +<li><code>\partmarks</code> in solutions no longer gobble trailing space +(doing so is probably right in questions, and is still the case, but +<code>\partmarks</code> in solutions tend to be more interspersed with +text).</li> +<li><code>\label</code> within a <code>\part</code> now refers to the +part number (as opposed to the question number).</li> +<li>Avoid a ‘You can't use `\unskip' in vertical mode’ error, +in certain circumstances.</li> +<li>Add the <code>[siunitx]</code> option, indicating that we should +load the <a href="https://www.ctan.org/pkg/siunitx">siunitx</a> package (default no). +This is now preferred to the <code>\units</code> macro, and the latter will be +removed in a forthcoming release.</li> +<li>Renamed <code>A1.clo</code> to clearer <code>myclass.clo</code></li> +<li>Repository moved from bitbucket to +<a href="https://heptapod.host/nxg/exam-n">https://heptapod.host/nxg/exam-n</a>, +when bitbucket dropped support for Mercurial. +This means, incidentally, that links to specific issues at bitbucket +are now broken.</li> +<li>Bold-italic maths should now work correctly with STIX.</li> +<li>Long <code>\partmarks</code> comments now appear as footnotes.</li> +<li>Solutions are now set <code>\normalsize</code>.</li> +<li>Bugfix: move definition of <code>\defaultpartmarkscategory</code> +so it can be invoked within a <code>.clo</code> file straightforwardly.</li> +<li>Define the <code>[uprightpi]</code> option to set <code>\pi</code> +as an upright character, as appropriate for a constant (this is +implemented fully only for the <code>[mtpro2]</code> and +<code>[stix2]</code> options)..</li> +<li>Note that the <code>\units</code> macro is likely to be deprecated +in a forthcoming version, and replaced by a recommendation to use the +standard <code>[siunitx]</code> package.</li> +</ul></h:dd> + +<h:dt>1.3, 2018 November 21</h:dt><h:dd><ul> +<li>Add a ‘category’ optional argument to <code>\partmarks</code>, and +add <code>\defaultpartmarkscategory</code>.</li> +</ul> +</h:dd> + +<h:dt>1.2.1, 2018 July 2</h:dt><h:dd><ul> +<li>Bugfix: ignore any content which appears after +<code>\end{document}</code>, in <code>\includequestion</code> (author) +files (fixes issue 6).</li> +<li>The environments <code>{figure*}</code> and <code>{table*}</code> now produce an error.</li> +<li>The macro <code>\vec</code> now produces correct greek bold maths.</li> +<li>Docmentation: notes on unit formatting.</li> +</ul> +</h:dd> + +<h:dt>1.2, 2017 December 1</h:dt><h:dd><ul> +<li>Use serif STIX2 fonts for sans and monospace cases, when using +Lua- or XeLaTeX (the style doesn't use/encourage any sans-serif text, +so this shouldn't matter).</li> +<li>Fix font sizes in solutions.</li> +<li>Adjustments to font-handling, which appear to have fixed LuaLaTeX differences.</li> +<li>Add the <code>stix2</code> option, to use the +<a href="http://www.stixfonts.org/">STIX2 font set</a>.</li> +<li>Make it possible to use <code>\rubric</code> and <code>\baserubric</code> within a <code>.clo</code> file. +This was advertised as being possible, but it seems it had never been tested!</li> +</ul></h:dd> +</h:dl> + + + +<p class="distonly"><a href="release-notes-dist.html">Earlier release notes</a> are available</p> <div class="signature"> -<a href='http://nxg.me.uk'>Norman Gray</a><br/> -2016 December 19 +<a href="https://nxg.me.uk">Norman Gray</a><br/> +2022 October 10 </div> </body> </html> - - diff --git a/Master/texmf-dist/doc/latex/exam-n/exam-n.pdf b/Master/texmf-dist/doc/latex/exam-n/exam-n.pdf Binary files differindex 66e4392de81..1505f61f4bc 100644 --- a/Master/texmf-dist/doc/latex/exam-n/exam-n.pdf +++ b/Master/texmf-dist/doc/latex/exam-n/exam-n.pdf diff --git a/Master/texmf-dist/doc/latex/exam-n/examndefs.sty b/Master/texmf-dist/doc/latex/exam-n/examndefs.sty new file mode 100644 index 00000000000..5ad56f1e261 --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/examndefs.sty @@ -0,0 +1,121 @@ +% Generated file : DO NOT EDIT +\@ifundefined{@psfontsfalse}{\newif\if@psfonts \@psfontsfalse}{} +\@ifundefined{examn@uprightpifalse}{\newif\ifexamn@uprightpi \examn@uprightpifalse}{} +\@ifundefined{examn@mtselect}{\newcount\examn@mtselect \examn@mtselect=0}{} +\if@psfonts + \ifcase\examn@mtselect + % mathptm fonts + % This is a very clumsy version, but it appears to be our only option + \def\vec#1{\mathchoice{\mbox{\boldmath $\displaystyle #1$}} + {\mbox{\boldmath $ #1$}} + {\mbox{\boldmath $\scriptstyle #1$}} + {\mbox{\boldmath $\scriptscriptstyle #1$}}} + \ifexamn@uprightpi + \ClassWarning{exam-n}{Can't do uprightpi in [mathptm] -- sorry} + \let\italicpi\pi + \examn@uprightpifalse + \fi + \or % mathtime (should this be the same for mathtime as for mtpro2? + \let\vec\mathbf + \ifexamn@uprightpi + \ClassWarning{exam-n}{Can't do uprightpi in [mathtime] -- sorry} + \let\italicpi\pi + \examn@uprightpifalse + \fi + \or % mtpro2 + \let\vec\mathbold + % \uppi is predefined in mtpro2 + \ifexamn@uprightpi + \let\italicpi\pi + \let\pi\uppi + \fi + \else + % STIX2: the unicode-math package provides a \symbf for bold math symbols, + \ifnum\examn@engine<2 % pdflatex + \let\vec\mathbf + % pdftex (or original tex) + % The following should, I think, create an upright pi, but doesn't + \def\uppi{\mathrm{\pi}} + \let\italicpi\pi %for consistency + \let\symup\mathrm %not fully the right thing, but avoid errors below + \else % xelatex or lualatex + % This is where the dependence on a recent LaTeX enters. + \let\vec\symbf + \typeout{stix2: upright=\ifexamn@uprightpi true\else false\fi} + \AddToHook{begindocument/end}{\gdef\uppi{\symup{𝜋}}} + \ifexamn@uprightpi + \AddToHook{begindocument/end}{\gdef\italicpi{\symit{𝜋}}\global\let\pi\uppi} + \fi + \fi + \fi +\else + % CM fonts: \mathbf doesn't work with greek in CM + \let\vec\mathbf + \ifexamn@uprightpi + % upright greek is hard to do portably, so give up + % See eg https://tex.stackexchange.com/questions/145926/ for discussion + \ClassWarning{exam-n}{Can't do uprightpi in [cmfonts] -- sorry} + \let\italicpi\pi + \let\uppi\pi %but avoid errors + \examn@uprightpifalse + \fi +\fi +\newcommand\BSc{B.Sc.{}} +\newcommand\MSci{M.Sci.{}} +\newcommand\MSc{M.Sc.{}} +\newcommand\MA{M.A.{}} +\newcommand\MEng{M.Eng.{}} +\newcommand\BEng{B.Eng.{}} +\ifnum\examn@mtselect>2 + % ie, STIX2, and thus using the unicode-math package (see above) + \def\e{\symup{e}} + \newcommand{\dd}{\symup{d}} + \newcommand{\ddd}{\,\symup{d}} +\else + \def\e{\mathrm{e}} + \newcommand{\dd}{\mathrm{d}} + \newcommand{\ddd}{\,\mathrm{d}} +\fi + +\def\Diffl{\@ifstar\@Difflflat\@Diffl} +\def\Partial{\@ifstar\@Partialflat\@Partial} +\def\@Partial{\@ifnextchar[{\@@Diffl\partial}{\@@Diffl\partial[]}} +\def\@Partialflat{\@ifnextchar[{\@@Difflflat\partial}{\@@Difflflat\partial[]}} +\def\@Diffl{\@ifnextchar[{\@@Diffl\dd}{\@@Diffl\dd[]}} +\def\@Difflflat{\@ifnextchar[{\@@Difflflat\dd}{\@@Difflflat\dd[]}} +\def\@@Diffl#1[#2]#3#4{% + \def\@tempa{#2}% + \ifx\@tempa\empty + \frac{#1#3}{#1#4}% + \else + \frac{{#1}^{#2}#3}{#1{#4}^{#2}}% + \fi} +\def\@@Difflflat#1[#2]#3#4{% + \def\@tempa{#2}% + \ifx\@tempa\empty + #1#3\mskip-0.8mu/\mskip-1.2mu #1#4% + \else + {#1}^{#2}#3\mskip-0.8mu /\mskip-1.2mu #1{#4}^{#2}% + \fi} +\def\units{\examn@unitswarning + \begingroup + \catcode`\.=\active + \@ifstar{\let\un@tsspace\relax \un@ts}% + {\let\un@tsspace\thinspace\un@ts}} +\begingroup + \catcode`\.=\active + \gdef\un@ts#1{\let~\thinspace\let.\thinspace + \ifmmode + \un@tsspace\mathrm{#1}% + \else + \nobreak$\un@tsspace\mathrm{#1}$% + \fi + \endgroup} +\endgroup +\newif\ifexamn@warnunits \examn@warnunitstrue +\def\examn@unitswarning{\ifexamn@warnunits + \ClassWarning{exam-n}{The units macro will be removed in the next + version; the [siunitx] option is now on by default, so you can use + the macros in the siunits package}% + \global\examn@warnunitsfalse +\fi} diff --git a/Master/texmf-dist/doc/latex/exam-n/myclass.clo b/Master/texmf-dist/doc/latex/exam-n/myclass.clo new file mode 100644 index 00000000000..9fd69120ccf --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/myclass.clo @@ -0,0 +1,42 @@ +\ProvidesFile{myclass.clo}[2022/10/10 exam-n-1.4.0] +\typeout{myclass exam options, exam-n-1.4.0} +%%%% Source: a91e9cff7cac, 2022-10-10T13:33:17+01:00 +%%%% File: myclass.clo +%%%% Copyright 2005--2022, Norman Gray +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% of this license or (at your option) any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3 or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status `maintained'. +%% +%% The Current Maintainer of this work is Norman Gray <https://nxg.me.uk> +%% +%% This work consists of the files exam-n.dtx and exam-n.ins, +%% the derived file exam-n.cls, +%% and the associated *.clo files. + + +% It's possible to change the rubric and base rubric here. +%\rubric{Answer questions.} +% +%\baserubric{\emph{Do not attempt to write on both sides of the paper at once.} +% +%You may sing, if you feel you must.} + +% Nothing here beyond the constants sheet +\constantssheet{ +\begin{center} +{\Large\textbf{Values of astrophysical constants}}\\[\bigskipamount] +\begin{tabular}{lll} \hline\\[-1.5ex] % slightly hacky extra space after hline + speed of light & $c$ & $2.998\times 10^8 \,{\rm ms^{-1}}$\\ + gravitational constant & $G$ & $6.673\times10^{-11}\,{\rm Nm^2kg^{-2}}$\\ + \vdots \\ +\hline +\end{tabular} +\end{center} +} diff --git a/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.pdf b/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.pdf Binary files differindex ca51908af30..8cbe643d87e 100644 --- a/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.pdf +++ b/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.pdf diff --git a/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.tex b/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.tex index de9e3a8ba70..d2798c9ed01 100644 --- a/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.tex +++ b/Master/texmf-dist/doc/latex/exam-n/notes-for-authors.tex @@ -6,33 +6,46 @@ \title{Notes for exam question authors} \author{Norman Gray} -\date{exam-n 1.1.4, 2016 December 19} +\date{Version exam-n-1.4.0, 2022 October 10} \parindent=0pt \parskip=\medskipamount \makeatletter -\def\csarg#1{\texttt\{\textit{#1}\texttt\}% +\def\cs@arg#1{\texttt\{\textit{#1}\texttt\}% \advance\@tempcnta-1 \ifnum\@tempcnta>0 - \let\next\csarg + \let\next\cs@arg \else \let\next\endgroup % begun in \cs \fi \next} +{\catcode`\|=0 \catcode`\\=12 +|gdef|cs@textbackslash#1{|texttt{\#1}}} +% \cs{foo} typeset \foo +% \cs[2]{foo}{bar}{baz} typeset \foo{bar}{baz} \newcommand\cs[2][0]{\begingroup \color{cscolour}% - $\backslash$\texttt{#2}% + \cs@textbackslash{#2}% \@tempcnta=#1 \ifnum\@tempcnta>0 - \let\next\csarg + \let\next\cs@arg \else \let\next\endgroup \fi \next} -\def\env#1{\texttt{\textcolor{cscolour}{#1}}} +\let\origvec\vec +% We'd like to say here +% \newif\ifexamn@uprightpi \examn@uprightpitrue +% but that's not supported for CM fonts +\usepackage{examndefs} + +\makeatother + +\def\env#1{\texttt{\textcolor{cscolour}{\{#1\}}}} \def\opt#1{\texttt{[#1]}} +\def\package#1{\textsf{#1}} \setcounter{secnumdepth}0 @@ -61,7 +74,7 @@ together. It follows from that that you should be hesitant about putting anythi the preamble other than \cs{usepackage} commands, and you should consult with the exams convener to ensure that such packages go into the master file, too. It's probably a safe bet that the `graphicx' -package will be included in the master file. If you want to include +package will be included in the master file. If you want to include a \cs{newcommand}, or anything like that, it can be placed inside the \env{question} environment. For other customisations, negotiate with the exams convener. @@ -76,16 +89,54 @@ not displayed in the final version (obviously), but which do appear in draft modes. You'll most typically have a \cs{partmarks} macro and a \env{solution} environment for each \cs{part}, but they don't have to match up, and you can have the entire solution at the end if you prefer. -The \cs[1]{partmarks*}n command is almost the same, but places the -mark indicator in a slightly different position which looks better -when there would otherwise be a gap at the right of the page. It can -be placed after a list, or inside but at the end of an equation. + +The \cs{partmarks} command will most typically go at the end of a +paragraph, but it may also appear inside an equation (that is, in +\verb|\[...\]|; don't use \verb|$$...$$|), inside one or other +\package{amsmath} display environments, or in a list or other +environment. If it appears inside an environment, the indicator will +appear at the \emph{end} of the environment, independent of where in +the environment the command was typed (which implies that you can't +have more than one inside an environment). + +The starred version is similar, but budges its indicator upwards +a little, and is a heuristic alternative which is useful in some +cases \emph{after} a list or display, or after a numbered equation, if the placement of the +indicator is otherwise inaesthetic +(if the style of the part-marks indicators happens to be such +that the indicator may be mistaken for an equation number, then +it would be wise to use either \cs{partmarks} or \cs{partmarks*} +after the equation, instead). If you use \cs{partmarks*} within a +display, you might be confronted by an error message, talking +about \cs{eqno} in maths mode, which is even more incomprehensible +than most \LaTeX\ messages. + Note that \cs{partmarks} ends a paragraph (\cs{partmarks*} doesn't): this is probably good style, but if you insist on mid-paragraph marks, then a following \verb|\noindent| will be useful. It's helpful to use \cs{partmarks} inside a \env{solution} to indicate the distribution of marks -- this doesn't mess up the mark-totalling calculation. +You may optionally give a question number as an argument to the +\env{question} environment: \cs[1]{begin\{question\}[n]}{markgoal}. +In \opt{compose} mode, this simply sets the question number, but in the other +modes, when the question file is included in a master file, this +checks that the given number~$n$ is what would be assigned +automatically, to help detect missing or out-of-order questions. If +the question identifier is not a number, such as `D1', then you can +provide that identifier here also, but in this case you must also set +\cs{QuestionNumberChecksOff} in the question preamble. + +The \cs{partmarks} command has an optional argument which +indicates the category of the question, thus `bookwork', `unseen', +and so on. If this is present -- for example +\cs[1]{partmarks[bookwork]}{5} -- then the category is included in the +marks indicator. +As you might hope, the \cs{partmarks*} command can take this +optional argument also: \cs[1]{partmarks*[bookwork]}{5}. +This extra text will typically be only one or two words long, but if +the text is much longer than that, it will be turned into a footnote. + One common exam or test question type is a multiple-choice question. This is indicated by a \cs{begin\{mcq\}} environment, which contains a textual question followed by a sequence of possible answers indicated by @@ -115,15 +166,17 @@ The \cs[1]{caption}{text} command works as usual; the figure and table numbering sequences continue through the solutions, if they're shown, but this isn't expected to be a problem. -If you use \cs{label} within a \env{question} environment, that label -will, as you might expect, refer to the question number. +There is neither a \env{figure*} nor a \env{table*} environment, +because this is a single-column class. +Use the no-option unstarred versions instead. + +\subsection{Hints} -Hints: Figures can be included with \cs{includegraphics} as usual, as long as -the `graphicx' package has been included at the top of the master +the \package{graphicx} package has been included at the top of the master file. If you want to include complete pages from a PDF (most typically containing a scanned handwritten model answer), then you can -do so by including the `pdfpages' package at the top of the file, and +do so by including the \package{pdfpages} package at the top of the file, and then \cs[1]{includepdf[pages=\{-\}]}{filename} inside a \env{solution} environment. The \texttt{pages=\{-\}} option means that all pages from the file are @@ -131,7 +184,10 @@ inserted; you may wish to use \texttt{scale=0.8} to shrink the PDF; the option \verb|pagecommand={\thispagestyle{fancy}}| will cause the other class apparatus, such as page numbers and headers, to be superimposed on the included pages. -See the documentation of the `pdfpages' package for more information. +See the documentation of the \package{pdfpages} package for more information. + +If you use \cs{label} within a \env{question} environment, that label +will, as you might expect, refer to the question number. Include marginal notes with \cs[1]{comment}{remark} -- these show up in drafting modes (\opt{draft} and \opt{compose}), but not in the final version. @@ -139,99 +195,27 @@ The \cs[1]{author}{name} command is just a type of comment. If you need to make more noise, then \cs[1]{shout}{remark} inserts a highlighted \emph{remark} in the flow of text (so it can be used anywhere) and includes the remark in a prominent -list of exclamations at the end of the document. +list of exclamations at the end of the document. Note that \cs{shout} +text \emph{appears in the \opt{final} version}: it is to draw +attention to problems (for example \cs[1]{shout}{solution wrong!}) +which must be resolved before the exam is presented to students. At the bottom of each page, you see a faint identification code, such as `QM/123-456'. This consists of an exam identifier, extracted from the exam preamble, plus a code which changes each time \LaTeX\ is -run. This helps you avoid collation accidents, and to distinguish +run, but which is otherwise meaningless. +This helps you avoid collation accidents, and to distinguish between slightly different versions of the printed document. \subsection{Various convenience commands} \label{s:othercommands} -\makeatletter -% Definitions edited in at build time... -% Abbreviations for degrees. -% \begin{macrocode} -\newcommand\BSc{B.Sc.{}} -\newcommand\MSci{M.Sci.{}} -\newcommand\MSc{M.Sc.{}} -\newcommand\MA{M.A.{}} -\newcommand\MEng{M.Eng.{}} -\newcommand\BEng{B.Eng.{}} -% \end{macrocode} -% -% Tweaks to differentials. -% \begin{macrocode} -\newcommand{\dd}{\mathrm{d}} -\newcommand{\ddd}{\,\mathrm{d}} % inside an integral, including thinspace - -\def\Diffl{\@ifstar\@Difflflat\@Diffl} -\def\Partial{\@ifstar\@Partialflat\@Partial} -\def\@Partial{\@ifnextchar[{\@@Diffl\partial}{\@@Diffl\partial[]}} -\def\@Partialflat{\@ifnextchar[{\@@Difflflat\partial}{\@@Difflflat\partial[]}} -\def\@Diffl{\@ifnextchar[{\@@Diffl\dd}{\@@Diffl\dd[]}} -\def\@Difflflat{\@ifnextchar[{\@@Difflflat\dd}{\@@Difflflat\dd[]}} -\def\@@Diffl#1[#2]#3#4{% - \def\@tempa{#2}% - \ifx\@tempa\empty - \frac{#1#3}{#1#4}% - \else - \frac{{#1}^{#2}#3}{#1{#4}^{#2}}% - \fi} -\def\@@Difflflat#1[#2]#3#4{% - \def\@tempa{#2}% - \ifx\@tempa\empty - #1#3\mskip-0.8mu/\mskip-1.2mu #1#4% - \else - {#1}^{#2}#3\mskip-0.8mu /\mskip-1.2mu #1{#4}^{#2}% - \fi} -% \end{macrocode} -% -% The exponential sign -% \begin{macrocode} -\def\e{{\mathrm e}} -% \end{macrocode} -% -% Physical units in |\rm|. Unstarred version includes leading -% |\thinspace|. Starred version doesn't, and is used when referring to -% the unit by itself (eg axis is |$B/\units*T$|), and is not qualifying -% a number. -% FIXME: |\mu| in |\units| can come out wrong in some fonts (mtpro2?) -% -- needs investigation. -% \begin{macrocode} -\def\units{\begingroup - \catcode`\.=\active - \@ifstar{\let\un@tsspace\relax \un@ts}% - {\let\un@tsspace\thinspace\un@ts}} -\begingroup - \catcode`\.=\active - \gdef\un@ts#1{\let~\thinspace\let.\thinspace - \ifmmode - \un@tsspace\mathrm{#1}% - \else - \nobreak$\un@tsspace\mathrm{#1}$% - \fi - \endgroup} -\endgroup -% \end{macrocode} -% -% Other miscellaneous symbols: -% The AU is nothing exciting, but may be adjusted in future -% \begin{macrocode} -\def\au{au} -% \end{macrocode} -% The symbol for Compton wavelength is a crossed lambda -- the following isn't perfect, but is OK for now. -% \begin{macrocode} -\def\lambdabar{\setbox\@tempboxa\hbox{$\lambda$}% - \hbox to 0pt{\hbox to \wd\@tempboxa{\hss$\bar{}$\hss}\hss}\box\@tempboxa} -% \end{macrocode} -\makeatother - -Macro \cs[1]{vec}{v} is redefined to give bold-font vectors, rather than -vectors with arrows, which is the (weird) \LaTeX\ default. This -should work for bold greek as well as roman. +Macro \cs[1]{vec}{v} is redefined to give bold-font vectors +rather than vectors with arrows, which is the (weird) \LaTeX\ default +-- thus $\vec v$ rather than $\origvec v$. +This is intended to work for bold greek as well as roman, +but it does so reliably only for the \opt{mtpro2} and \opt{stix2} +options. Macros \cs{dd} and \cs{ddd}: \cs{dd} is a roman d, as used for differentials; \cs{ddd} is the same with a preceding thinspace, @@ -254,6 +238,12 @@ The unstarred versions are for displayed equations, the starred ones for inline maths. There is analogous support for partial derivatives with \cs[2]{Partial}ab. +You should generally type units, and numbers with units, using the +\package{siunitx} package (use the \opt{siunitx} \cs{documentclass} option). + +However this package currently also +supports a basic \verb|\units| command, described here. This macro +is very likely to be removed in a future version of this package. Macros \cs[1]{units}{expr}, \cs[1]{units*}{expr}: These typeset physical units in an upright shape, with tilde or dot acting as a separator between units. Since this is typeset in maths mode, all @@ -261,22 +251,21 @@ other spacing is ignored. For example, \verb|$v=10\units{m.\mu s^{-1}}$| gives $v=10\units{m.\mu s^{-1}}$. The unstarred version includes some leading space; the starred version can be used when referring to the unit by itself, where it is not qualifying a number (eg labelling an -axis with units \verb|$B/\units*T$|, or $B/\units*T$). These macros -might be replaced, in the future, by a recommendation to use the -\texttt{siunitx} package. - -For some other useful symbols, see the table below: - -\def\arraystretch{1.5} -\begin{tabular}{rcp{8cm}} -\cs{e}&$\e^{i\pi}+1=0$& the exponential is typeset in an upright rather than -an italic shape, as in \verb|$\e^{i\pi} + 1 = 0$|.\\ -\cs{au}&10\units\au& astronomical units: -\verb|10\units{\au}|.\\ -\cs{lambdabar}&$\lambdabar$& the Compton wavelength, as a lambda with a -bar through it.\\ -\end{tabular} - +axis with units \verb|$B/\units*T$|, or $B/\units*T$). + +The command \cs{e} sets an upright~`e': +\verb|$\e^{i\pi} + 1 = 0$| produces $\e^{i\pi} + 1 = 0$. +Other shortcuts may be available in customisations of this class.\footnote{% +The package used to support an \cs{au} macro, for astronomical +unit, and \cs{lambdabar} for Compton wavelength, but these have +since been removed. The former is available via \package{siunitx}.} + +Note: $\pi$ is set as an italic pi character, matching the +\LaTeX\ default. Since it's (usually) used as the circular constant, +it should more properly be set upright, and you can get that using the +\opt{uprightpi} option. This option also defines a \verb|\italicpi| +command, for completeness. This option is at present +implemented only for the \opt{mtpro2} and \opt{stix2} options. \subsection{Extra: Creating complete exams} \label{s:complete} @@ -288,7 +277,7 @@ below. For more detail, see the complete documentation in \texttt{exam-n.pdf}. \goodbreak \listinginput1{template-master.tex} -The \texttt{exam-n} class currently supports a sample class option \opt{A1}. +The \texttt{exam-n} class currently supports a sample class option \opt{myclass}. This automatically includes a suitable constants sheet in the formatted paper. diff --git a/Master/texmf-dist/doc/latex/exam-n/release-notes-dist.html b/Master/texmf-dist/doc/latex/exam-n/release-notes-dist.html new file mode 100644 index 00000000000..1200c9828f3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/release-notes-dist.html @@ -0,0 +1,656 @@ +<?xml version="1.0" encoding="utf-8"?> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> +<title>exam-n class – full release notes</title> + + +<style class="distonly" type="text/css">body { + color: #333; + background: white; + margin-left: +30%; + width: 50%; /* body is 50% of screen width */ + margin-right: auto; /* ie, 20% */ + padding: 0.5em; /* this will make a difference if I decide to + have the background a different colour */ + /* I can't decide on font: Optima's always nice, but Gill looks + agreeably intense. Helvetica's a decent fallback. */ + font-family: "Helvetica Neue", Helvetica, "Gill Sans", gill, sans-serif; + /* font-family: Optima, "Gill Sans", gill, Helvetica, sans-serif; */ + /* font-family: "Gill Sans", gill, Helvetica, sans-serif; */ + /* I seem to have used 11pt at some point in the past, but this + is far too big -- did I ever have a reason for that, or is it + just due to browser changes? */ + font-size: 10pt; + line-height: 150%; +} + +div.topsidebar { + float: right; + width: 50%; /* ...of the body width (ie, 50% x 50% of screen) */ + font-size: smaller; + margin-left: 1em; + padding-left: 1em; + border-left: solid thin #AAA; +} + +/* On wider screens, move the sidebar out to the right hand side */ +/* This uses CSS3 media queries: http://www.w3.org/TR/css3-mediaqueries/ */ +@media screen and (min-width: 700pt) and (max-width: 850pt) { + body { + margin-left: 210pt; + width: 350pt; /* 50% of 700pt */ + margin-right: auto; + } + div.topsidebar { + position: absolute; + /* I feel this size should be 595pt (350 + 210 + 0.05*700), + but that's clearly not right -- I don't think I understand what the -5% + in the h1 spec below is actually 5% of! */ + left: 570pt; + width: auto; + margin-left: 0pt; + padding-left: 0pt; + border: none; + } +} +/* On still-wider screens, expand the left-margin, keeping the sidebar attached to the right-hand edge. + When the screen is 850pt wide (expanding from the @media case above), + the left margin will be 210pt, the width 350pt, and the right margin therefore 290pt.*/ +@media screen and (min-width: 850pt) { + body { + margin-right: 290pt; /* 290 = 850-(210+350) */ + width: 350pt; + margin-left: auto; /* ...takes up the slack */ + } + div.topsidebar { + position: absolute; + width: 290pt; /* same 290pt as above */ + left: auto; + right: 0%; + padding-left: 0pt; + border: none; + } +} + + +code, pre { + font-family: Monaco, fixed; + font-size: 9pt; +} + +a { text-decoration: none; } +a:link { color: #66C; } +a:visited { color: #669; } +a[href]:hover { background: #EEE; } + +div.abstract { + font-style: oblique; + text-align: left; +} +div.abstract em { font-style: normal; } +div.abstract code { + font-style: normal; + font-size: 80%; +} + +/* a span/div style for attracting attention */ +.attention { + color: #822; +} + +h1, h2, h3, h4, h5, h6 { + color: #822; + font-weight: 100; /* few fonts have ultra-light weights */ + line-height: 100%; /* no need to spread out titles */ +} +h1 { + margin-left: -40%; + margin-right: -5%; + padding: 0.5em; + border: solid thin #666; + text-align: right; +} +h2 { + margin-left: -40%; + margin-right: -5%; + padding: 0.2em; + border-top: solid thin #666; + clear: both; +} + +h2.appendices { + margin-top: 10ex; + border-top: double medium #666; +} +h3 { + margin-left: -30%; + float: left; + width: 25%; + display: block; + text-align: right; + vertical-align: bottom; + padding-top: 0pt; + padding-right: 0.5em; + margin-top: 0pt; + line-height: 100%; +} + +/* +h4 { + color: #C66; +} +*/ + +pre, table { background: #dde; } + +pre { + padding: 1em; + line-height: 130%; +} + +table { + font-size: smaller; +} +td { + padding: 0.5ex; +} + +Q:before { content: "“"; } +Q:after { content: "”"; } + +img.smallimage { + float: right; + margin: 24pt; + margin-right: -30%; +} + +div.signature { + margin-left: -40%; + margin-right: -5%; + margin-top: 4ex; + text-align: right; + border: solid thin #666; + padding: 0.3em; + clear: both; +} + +/* ============================================================ + * Some other curiosities of my one-time formatting for web pages + */ +.doc-history { + font-size: xx-small; + background: #eee; + line-height: 100%; +} + +div.subtoc, div.subsubtoc { display: none; } + +/* ============================================================ + * Special formatting for ToC + */ + +/* + If there's significant amount of text in front of the first subsection, + then the following are good to put in the per-document stylesheet: + width: 25%; + float: right; +*/ +div#toc { + color: #888; + padding: 0; + font-size: smaller; + text-align: right; +} +div#toc a:link { color: #888; } +div#toc > ul { + padding: 0pt; + margin: 0pt; + list-style: none; +} +div#toc li { + padding: 0pt; + display: inline-block; +} +div#toc li:before { + content: "§ "; + margin-left: 1em; +} +/* the following elements aren't currently generated by structure.lx */ +div#toc li ul { + padding-left: 1em; + margin-left: 0; + font-style: italic; + display: inline; +} +div#toc li ul:before { + content: "( "; +} +div#toc li ul:after { + content: " ) "; +} +div#toc li li { + padding-left: 0pt; +} +div#toc li li:after { + content: "; "; +} +</style> +<style type="text/css"> +dd ul { padding: 0pt; margin: 0pt; } +</style> +</head> + +<body> +<h1>The exam-n class – release notes</h1> + +<h:dl xmlns:h="http://www.w3.org/1999/xhtml"> + + + + +<h:dt><h:span class="attention">1.4.0, 2022 October 10</h:span></h:dt><h:dd> + <ul> + <li>The [siunitx] option is now on by default, and the + <code>\units</code> macro produces a one-time-per-document + warning that it will be removed in the next version.</li> + <li>Having two <code>\partmarks</code> commands in an + environment is now detected as an error (it was documented as an + error, but not checked, so the extra <code>\partmarks</code> + commands were simply ignored).</li> + </ul> + </h:dd> + +<h:dt>1.4.0-b1, 2022 August 7</h:dt><h:dd> + <ul> + <li>The class file now depends on a version of LaTeX which is at least + the 2020/10/01 release. This is so that we can use the current LaTeX + hooks mechanism.</li> + <li>Rework <code>\partmarks</code>: the <code>\partmarks</code> + indicator can now go <em>inside</em> most environments, including + list, quotes, unnumbered equations, and the various amsmath displays. In these + cases, the indicator will automatically appear at the end of the + environment. The starred variant of the command still exists, but + should rarely be necessary.</li> + </ul> + </h:dd> + +<h:dt>1.3.5-b1, 2022 July 11</h:dt><h:dd><ul> +<li>Fix erroneous broken line before <code>\partmarks</code>, in +compose mode, when a paragraph fills the last line.</li> +<li>Fix support for STIX2 fonts in XeLaTeX and LuaLaTeX (it was +working inaccurately before).</li> +<li>Add an optional argument for <code>\part</code> to override part numbering.</li> +<li>Use the <code>xcolor</code> package for colour management, instead +of the core <code>color</code> package (the <code>xcolor</code> +package is well-known and stable, and this means that we are +compatible with TikZ).</li> +<li><code>\partmarks</code> in solutions no longer gobble trailing space +(doing so is probably right in questions, and is still the case, but +<code>\partmarks</code> in solutions tend to be more interspersed with +text).</li> +<li><code>\label</code> within a <code>\part</code> now refers to the +part number (as opposed to the question number).</li> +<li>Avoid a ‘You can't use `\unskip' in vertical mode’ error, +in certain circumstances.</li> +<li>Add the <code>[siunitx]</code> option, indicating that we should +load the <a href="https://www.ctan.org/pkg/siunitx">siunitx</a> package (default no). +This is now preferred to the <code>\units</code> macro, and the latter will be +removed in a forthcoming release.</li> +<li>Renamed <code>A1.clo</code> to clearer <code>myclass.clo</code></li> +<li>Repository moved from bitbucket to +<a href="https://heptapod.host/nxg/exam-n">https://heptapod.host/nxg/exam-n</a>, +when bitbucket dropped support for Mercurial. +This means, incidentally, that links to specific issues at bitbucket +are now broken.</li> +<li>Bold-italic maths should now work correctly with STIX.</li> +<li>Long <code>\partmarks</code> comments now appear as footnotes.</li> +<li>Solutions are now set <code>\normalsize</code>.</li> +<li>Bugfix: move definition of <code>\defaultpartmarkscategory</code> +so it can be invoked within a <code>.clo</code> file straightforwardly.</li> +<li>Define the <code>[uprightpi]</code> option to set <code>\pi</code> +as an upright character, as appropriate for a constant (this is +implemented fully only for the <code>[mtpro2]</code> and +<code>[stix2]</code> options)..</li> +<li>Note that the <code>\units</code> macro is likely to be deprecated +in a forthcoming version, and replaced by a recommendation to use the +standard <code>[siunitx]</code> package.</li> +</ul></h:dd> + +<h:dt>1.3, 2018 November 21</h:dt><h:dd><ul> +<li>Add a ‘category’ optional argument to <code>\partmarks</code>, and +add <code>\defaultpartmarkscategory</code>.</li> +</ul> +</h:dd> + +<h:dt>1.2.1, 2018 July 2</h:dt><h:dd><ul> +<li>Bugfix: ignore any content which appears after +<code>\end{document}</code>, in <code>\includequestion</code> (author) +files (fixes issue 6).</li> +<li>The environments <code>{figure*}</code> and <code>{table*}</code> now produce an error.</li> +<li>The macro <code>\vec</code> now produces correct greek bold maths.</li> +<li>Docmentation: notes on unit formatting.</li> +</ul> +</h:dd> + +<h:dt>1.2, 2017 December 1</h:dt><h:dd><ul> +<li>Use serif STIX2 fonts for sans and monospace cases, when using +Lua- or XeLaTeX (the style doesn't use/encourage any sans-serif text, +so this shouldn't matter).</li> +<li>Fix font sizes in solutions.</li> +<li>Adjustments to font-handling, which appear to have fixed LuaLaTeX differences.</li> +<li>Add the <code>stix2</code> option, to use the +<a href="http://www.stixfonts.org/">STIX2 font set</a>.</li> +<li>Make it possible to use <code>\rubric</code> and <code>\baserubric</code> within a <code>.clo</code> file. +This was advertised as being possible, but it seems it had never been tested!</li> +</ul></h:dd> + + +<h:dt><h:span class="attention">1.1.5, 2016 December 22</h:span></h:dt><h:dd><ul> +<li>Make <code>\schoolcoursecode</code> optional exam metadata. +Rework how this is checked, and support customising this in a +<code>.clo</code> file.</li> +</ul></h:dd> + +<h:dt>1.1.4, 2016 December 19</h:dt><h:dd><ul> +<li>Documentation: add notes about use of pdfpages.</li> +<li>Added <code>[largefont]</code> option. +<strong>Note</strong>: +option <code>[hugefont]</code> has replaced <code>[bigfont]</code>; +the latter is now deprecated, and may be removed in v1.2.</li> +<li>Use of the <code>\part</code> macro is now supported within +solutions (it produced the wrong numbers before), and there is a new +<code>\StylePartNumber</code> customisation macro.</li> +</ul></h:dd> + +<h:dt>1.1.3, n/d</h:dt><h:dd><ul> +<li>Version 1.1.3 was never released</li> +</ul></h:dd> + +<h:dt>1.1.2, 2015 November 26</h:dt><h:dd><ul> +<li>Handled trailing floats at end of document (generated by packages +such as <code>rotating</code>.</li> +<li><code>\label</code> within question environment now refers to the +question number.</li> +<li>Work around a problem when a paragraph starts with <code>{\bf ...}</code> +rather than (post-1995) <code>\textbf{...}</code>.</li> +<li><code>\begin{questiondata}</code> now starts a new paragraph.</li> +<li>Some documentation adjustments.</li> +</ul></h:dd> + +<h:dt>1.1.1, 2014 November 27</h:dt><h:dd><ul> +<li>Adjust <code>\partmarks*</code> behaviour; now behaves differently +within display maths (addresses +<a href="https://bitbucket.org/nxg/exam-n/issue/1/">issue 1</a>).</li> +<li>Various documentation and release fixes.</li> +</ul></h:dd> + +<h:dt>1.1, 2014 May 3</h:dt><h:dd><p>Converted to a generic class, <code>exam-n</code>, ready for wider +distribution. +Available on <a href="https://bitbucket.org/nxg/exam-n/">bitbucket</a> +and at CTAN.</p> +</h:dd> + +<h:dt>1.0.16, 2014 February 28</h:dt><h:dd><ul> +<li>Option mtpro2 now switches to times (this fixes a pre-existing bug + exposed by the [sansserif] option).</li> +<li>The [bigfont] option now works (this fixes a pre-existing bug, to + do with <code>\subsections</code>, which was exposed by the addition + of the [bigfont] option).</li> +<li>Added the [bigfont] option</li> +<li>Fixed 'shouts' warning at start (again)</li> +<li>Forbid *section commands inside questions (and don't freak out)</li> +<li>Rename <code>\questiontrailer</code> to <code>\questionpreamble</code> (more logical)</li> +<li>Fixed mcq warnings, and 'question continued' errors.</li> +<li>Renamed <code>\multiplechoicequestions</code> to more logical + <code>\multiplechoiceanswers</code></li> +<li>Various (further) spacing changes</li> +<li>Added <code>\subsection</code></li> +<li>Release includes +1.0.16b1 (2014 January 20); +1.0.16b2 (20 January); +1.0.16b3 (22 January); +1.0.16b4 (14 February). +</li> +</ul> +</h:dd> + +<h:dt>1.0.15, 2014 January 19</h:dt><h:dd><ul> +<li>Fixed mcq and showsolutions, to suppress incorrect warning of missing answers.</li> +</ul></h:dd> + +<h:dt>1.0.14, 2014 January 10</h:dt><h:dd><ul> +<li>pdfpages content now appears in draft mode.</li> +<li>The <code>[draft]</code> option now implies [showsolutions] (so if +you want to suppress the solutions in this mode, you must now follow +<code>[draft]</code> with <code>[noshowsolutions]</code>).</li> +<li>Showing missing information: shouts and missing exam date/time are +now highlighted.</li> +<li>Fixed bug where excess <code>\QuestionNumberChecksOff</code> +caused question numbers to disappear.</li> +<li>Remove indent at start of question.</li> +</ul></h:dd> + +<h:dt>1.0.13, 2013 December 4</h:dt><h:dd><ul> +<li>Added a <code>[sansserif]</code> class option.</li> +<li>Improved spacing and linebreaking; there are now fewer bad page-breaks.</li> +<li>Added the <code>{mcq}</code> environment.</li> +<li>Changed the distribution licence from GPL to LPPL.</li> +</ul> +</h:dd> + +<h:dt>1.0.12, 2013 November 11</h:dt><h:dd><ul> +<li>Adjustments to banner text and base rubric (consulting with Morag Casey).</li> +<li>Added notes about <code>\includepdf</code> in ‘notes for authors’.</li> +<li>Adjustments to the distributed example files.</li> +</ul></h:dd> + +<h:dt>1.0.11, 2013 July 18</h:dt><h:dd> +<p>Adjustments to question data: k_B, etc, should have roman +subscripts.</p> +</h:dd> + +<h:dt>1.0.10, 2013 June 27</h:dt><h:dd> + <p>Minor documentation and distribution fixes</p> +</h:dd> + +<h:dt>1.0.9, 2013 March 22</h:dt><h:dd> + <p>Remove leftover debugging code (garhhh)</p> +</h:dd> + +<h:dt>1.0.8, 2013 March 14</h:dt><h:dd> + <p>Add the <code>mono</code> and <code>colour</code> options.</p> +</h:dd> + +<h:dt>1.0.7, 2013 March 14</h:dt><h:dd><ul> +<li>pdfpages is now disabled <em>only</em> in solutions</li> +<li>Minor layout changes (exam title adjusts size for long +titles)</li> +</ul></h:dd> + +<h:dt>1.0.6, 2013 March 13</h:dt><h:dd><ul> +<li>Avoid tables and figures in solutions incrementing the float counter.</li> +<li>Layout changes; adjustment to default base rubric; A345 rubric change</li> +<li>Some documentation changes</li> +</ul> +</h:dd> + +<h:dt>1.0.4-1, 2013 March 8</h:dt><h:dd> + <p>This is a bugfix release: it's a re-release of now-deprecated +1.0.5 minus a breaking change.</p> +<ul> +<li>Add <code>{table}</code> support, paralleling existing +<code>{figure}</code> support (ie tables don't float, but captions +work as expected).</li> +<li>Blank lines after a <code>\begin{question}</code> no longer +result in extra space.</li> +<li>Adjust spacing and layout of front page (again); various other +cosmetic changes.</li> +<li>A document identifier appears at the bottom of each page, +corroborating the exam the page is for (to avoid photocopier collation +accidents), and giving a numeric identifier which increases with time +(allowing you to identify which of two printouts is later).</li> +</ul></h:dd> + +<h:dt>1.0.4, 2013 March 6</h:dt><h:dd> + <p>Adjust base rubric; assorted distribution and detail fixes.</p> +</h:dd> + +<h:dt>1.0.3, 2013 January 25</h:dt><h:dd> + <p>Added <code>[A2]</code> class option.</p> +</h:dd> + +<h:dt>1.0.2, 2013 January 25</h:dt><h:dd><ul> +<li>The `pdfpages' package wasn't working when the `noshowsolutions' +option was present. Fixed, by special-casing, specifically disabling the +<code>\includepdf</code> command in this case.</li> +<li>Adjust display of <code>\partmarks</code> (no need for extra +space, since <code>\partmarks</code> is now fully in the margin).</li> +<li>Adjusting the front-page layout. Again.</li> +</ul></h:dd> + +<h:dt>1.0.1, 2013 January 18</h:dt><h:dd><ul> +<li><code>{figure}</code> now works, because it's explicitly +supported (<code>{figure}</code> inside solutions could cause problems +before). The contents don't float.</li> +<li>Layout adjustments.</li> +<li>Graphics now appear in draft mode.</li> +</ul> +</h:dd> + +<h:dt>1.0, 2012 December 11</h:dt><h:dd> + <p>This is the nominal version 1.0 release, and will be used for the +2012-13 Honours Astronomy exams (it might get further tweaks along the + way, but we believe this is a complete distribution set).</p> + <ul> +<li>More adjustments to notes-for-authors, now showing example LaTeX results.</li> +<li>Addition of template-question.tex</li> +<li>Adjustments to base rubric.</li> + </ul> +</h:dd> + +<h:dt>1.0b5, 2012 December 3</h:dt><h:dd><ul> +<li>Fine formatting adjustments: occasional <code>\nobreak</code> and +rationalisation of <code>\maketitle</code>.</li> +<li>Improvements to notes-for-authors.</li> +</ul></h:dd> + +<h:dt>1.0b4, 2012 November 30</h:dt><h:dd><ul> +<li>Improve generation of PDF metadata.</li> +<li>Add macro <code>\shout</code>, for highlighted `FIXME' comments.</li> +<li>Add showmarktotals option.</li> +<li>Permit <code>\partmarks</code> in solutions, without it adding to +the marks added up for the question (at the same time, forbid having a +solution within a solution).</li> +<li>Various formatting adjustments.</li> +</ul> +</h:dd> + +<h:dt>1.0b3, 2012 November 8</h:dt><h:dd><ul> +<li>Add [A345] option.</li> +<li>Make compose/draft material appear in red.</li> +<li>Some packaging changes and bugfixes.</li> +</ul></h:dd> + +<h:dt>1.0b2, 2012 November 6</h:dt><h:dd><p>Mild formatting adjustments.</p></h:dd> + +<h:dt>1.0rc1, 2012 November 2</h:dt><h:dd><ul> +<li>Significant rewrite of formatting, producing a consensus +AandA/PhysHons style, and renaming some confusingly named +commands.</li> +<li>Consequently, the AandA.clo and PhysHons.clo options have +disappeared.</li> +<li>The <code>\constantssheet</code> macro has appeared, and setting +this is now the principal function of per-class <code>.clo</code> +files. +See the new <code>A1.clo</code> and modified <code>P2.clo</code> option files.</li> +</ul> +</h:dd> + +<h:dt>0.17.1, 2012 September 21</h:dt><h:dd><p>Fix packaging infelicity</p></h:dd> + +<h:dt>0.17, 2012 September 21</h:dt><h:dd><ul> +<li>Rework <code>solutions</code> environment to make it a little more robust.</li> +<li>Add <code>\MSc</code> degree shorthand.</li> +<li>Bugfix: continuation headers now appear if a question starts on page 1.</li> +<li>Bugfix: fix wrong syntax in draft+showsolutions mode -- now works again</li> +</ul> +</h:dd> + +<h:dt>0.16, 2012 July 26</h:dt><h:dd><ul> +<li>Renamed the [showmarks] option to more rational [perquestionmarks] +(because the option doesn't control whether per-question marks are +<em>displayed</em>, but whether they're tracked at all). Slightly +improved the documentation of this at the same time.</li> +<li>Added <code>\lambdabar</code> macro</li> +<li>Fix long-standing problem with continuation lines -- these should now be robust.</li> +</ul></h:dd> +<h:dt>0.15, 2011 November 23</h:dt><h:dd> + <p>Avoid conflict with <code>ifpdf</code> package. Now + <em>depends</em> on <code>ifpdf</code>.</p> +</h:dd> + +<h:dt>0.14, 2010 August 6</h:dt><h:dd><ul> +<li>Fixed the problem where the question-continuation marks would be +messed up by the presence of floats.</li> +<li>Added P2.clo; adjust 'showing solutions' banner +to avoid collision with other headers (thanks to Morag Casey for the .clo +file and the report).</li> +<li>Changed the name of the class to 'guexam', from potentially confusing 'exam'. +Support guexam.config for forcing options (for example).</li> +</ul></h:dd> + +<h:dt>0.13-1, 2008 November 21</h:dt><h:dd> + <p>Make the gulogo style optional, so that question authors don't +have to download and install that before they can draft a question. + Also adjust the logo size.</p> +</h:dd> + +<h:dt>0.13, 2008 November 11</h:dt><h:dd><p>Add university logo, and slightly rearrange the header. +Add <code>{questiondata}</code> environment.</p></h:dd> + +<h:dt>0.12-2, 2008 April 14</h:dt><h:dd><p>...keep on truckin'. Further changes to the +<code>\partmarks*</code> spacing code, still largely unprincipled, but +looking closer to what's required.</p></h:dd> + +<h:dt>0.12-1, 2008 April 3</h:dt><h:dd><p>...and again. This time, I think I actually see what the problem +was. Macro <code>\partmarks</code> now forces a new paragraph (it was +documented to be usable at the end of a paragraph, so this is again +forced, and the documentation made more explicit), this makes what I +thought was the solution actually work. Which is nice. Redefined +<code>enumerate</code> and <code>itemize</code> environments, to +improve spacing somewhat.</p></h:dd> + +<h:dt>0.12, 2008 April 3</h:dt><h:dd><p>Further adjustments to <code>\partmarks</code>: again, it should +be more consistent without necessarily being more principled, alas.</p></h:dd> + +<h:dt>0.11, 2008 March 30</h:dt><h:dd><p>Minor fixes: Adjust display of partmarks -- should now be more +consistent; option [showsolutions] no longer defaults +[{no,}pageperquestion]; add macro <code>\e</code> to format roman +exponential.</p></h:dd> + +<h:dt>0.10, 2008 January 17</h:dt><h:dd><p>Fix <code>\vec</code> when it appears in sub- or superscript +position. Add <code>\paperident</code> command.</p></h:dd> + +<h:dt>0.9, 2007 December 10</h:dt><h:dd><p>Various formatting changes. Added optional argument to +<code>\includequestion</code> overriding question number.</p></h:dd> + +<h:dt>0.8, 2007 November 25</h:dt><h:dd><p>You can now use <code>\usepackage</code> within +<code>[compose]</code> mode.</p></h:dd> + +<h:dt>0.7, 2007 November 20</h:dt><h:dd><p>Make changes to the display of the 'University of Glasgow' banner +at the top: resolves some font problems. Other minor layout tweaks.</p></h:dd> + +<h:dt>0.6, 2007 November 18</h:dt><h:dd><p>Fixed bold maths problems: <code>\vec</code> now works with greek +letters, too. Support MTpro2 (mathtime maths fonts) with the new +<code>[mtpro2]</code> class option. The <code>{solution}</code> +environment can appear multiple times within a question. Question +numbers now appear correctly in 'final' mode.</p></h:dd> + +<h:dt>0.5, 2007 October 30</h:dt><h:dd><p>Fix collision with LaTeX internal: a <code>\comment</code> at the +start of a <code>{question}</code> now works.</p></h:dd> + +</h:dl> + + +</body> +</html> diff --git a/Master/texmf-dist/doc/latex/exam-n/release-notes.html b/Master/texmf-dist/doc/latex/exam-n/release-notes.html deleted file mode 100644 index 9f843e11f69..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/release-notes.html +++ /dev/null @@ -1,340 +0,0 @@ -<html xmlns="http://www.w3.org/1999/xhtml"> -<head> -<title>exam-n class – release notes</title> -<link href="http://nxg.me.uk" rev="author"/> -<link type="text/css" rel="stylesheet" - href="style.css"/> -<style type='text/css'> -dd ul { padding: 0pt; margin: 0pt; } -</style> -</head> - -<body> -<h1>The exam-n class – release notes</h1> - -<dl> -<!-- @CURRENT@ --> -<dt><span class='attention'>1.1.4, 2016 December 19</span></dt> -<dd><ul> -<li>Documentation: add notes about use of pdfpages.</li> -<li>Added <code>[largefont]</code> option. -<strong>Note</strong>: -option <code>[hugefont]</code> has replaced <code>[bigfont]</code>; -the latter is now deprecated, and may be removed in v1.2.</li> -<li>Use of the <code>\part</code> macro is now supported within -solutions (it produced the wrong numbers before), and there is a new -<code>\StylePartNumber</code> customisation macro.</li> -</ul></dd> - -<dt>1.1.3</dt> -<dd><ul> -<li>Version 1.1.3 was never released</li> -</ul></dd> - -<dt>1.1.2, 2015 November 26</dt> -<dd><ul> -<li>Handled trailing floats at end of document (generated by packages -such as <code>rotating</code>.</li> -<li><code>\label</code> within question environment now refers to the -question number.</li> -<li>Work around a problem when a paragraph starts with <code>{\bf ...}</code> -rather than (post-1995) <code>\textbf{...}</code>.</li> -<li><code>\begin{questiondata}</code> now starts a new paragraph.</li> -<li>Some documentation adjustments.</li> -</ul></dd> - -<dt>1.1.1, 2014 November 27</dt> -<dd><ul> -<li>Adjust <code>\partmarks*</code> behaviour; now behaves differently -within display maths (addresses -<a href='https://bitbucket.org/nxg/exam-n/issue/1/'>issue 1</a>).</li> -<li>Various documentation and release fixes.</li> -</ul></dd> - -<dt>1.1, 2014 May 3</dt> -<dd>Converted to a generic class, <code>exam-n</code>, ready for wider -distribution. -Available on <a href='https://bitbucket.org/nxg/exam-n/'>bitbucket</a> -and at CTAN.</dd> - -<!-- @ENDCURRENT@ --> - -<dt>1.0.16, 2014 February 28</dt> -<dd><ul> -<li>Option mtpro2 now switches to times (this fixes a pre-existing bug - exposed by the [sansserif] option).</li> -<li>The [bigfont] option now works (this fixes a pre-existing bug, to - do with <code>\subsections</code>, which was exposed by the addition - of the [bigfont] option).</li> -<li>Added the [bigfont] option</li> -<li>Fixed 'shouts' warning at start (again)</li> -<li>Forbid *section commands inside questions (and don't freak out)</li> -<li>Rename <code>\questiontrailer</code> to <code>\questionpreamble</code> (more logical)</li> -<li>Fixed mcq warnings, and 'question continued' errors.</li> -<li>Renamed <code>\multiplechoicequestions</code> to more logical - <code>\multiplechoiceanswers</code></li> -<li>Various (further) spacing changes</li> -<li>Added <code>\subsection</code></li> -<li>Release includes -1.0.16b1 (2014 January 20); -1.0.16b2 (20 January); -1.0.16b3 (22 January); -1.0.16b4 (14 February). -</li> -</ul> -</dd> - -<dt>1.0.15, 2014 January 19</dt> -<dd><ul> -<li>Fixed mcq and showsolutions, to suppress incorrect warning of missing answers.</li> -</ul></dd> - -<dt>1.0.14, 2014 January 10</dt> -<dd><ul> -<li>pdfpages content now appears in draft mode.</li> -<li>The <code>[draft]</code> option now implies [showsolutions] (so if -you want to suppress the solutions in this mode, you must now follow -<code>[draft]</code> with <code>[noshowsolutions]</code>).</li> -<li>Showing missing information: shouts and missing exam date/time are -now highlighted.</li> -<li>Fixed bug where excess <code>\QuestionNumberChecksOff</code> -caused question numbers to disappear.</li> -<li>Remove indent at start of question.</li> -</ul></dd> - -<dt>1.0.13, 2013 December 4</dt> -<dd><ul> -<li>Added a <code>[sansserif]</code> class option.</li> -<li>Improved spacing and linebreaking; there are now fewer bad page-breaks.</li> -<li>Added the <code>{mcq}</code> environment.</li> -<li>Changed the distribution licence from GPL to LPPL.</li> -</ul> -</dd> - -<dt>1.0.12, 2013 November 11</dt> -<dd><ul> -<li>Adjustments to banner text and base rubric (consulting with Morag Casey).</li> -<li>Added notes about <code>\includepdf</code> in <q>notes for authors</q>.</li> -<li>Adjustments to the distributed example files.</li> -</ul></dd> - -<dt>1.0.11, 2013 July 18</dt> -<dd>Adjustments to question data: k_B, etc, should have roman subscripts.</dd> - -<dt>1.0.10, 2013 June 27</dt> -<dd>Minor documentation and distribution fixes</dd> - -<dt><span>1.0.9, 2013 March 22</span></dt> -<dd>Remove leftover debugging code (garhhh)</dd> - -<dt>1.0.8, 2013 March 14</dt> -<dd>Add the <code>mono</code> and <code>colour</code> options.</dd> - -<dt>1.0.7, 2013 March 14</dt> -<dd><ul> -<li>pdfpages is now disabled <em>only</em> in solutions</li> -<li>Minor layout changes (exam title adjusts size for long -titles)</li> -</ul></dd> - -<dt>1.0.6, 2013 March 13</dt> -<dd><ul> -<li>Avoid tables and figures in solutions incrementing the float counter.</li> -<li>Layout changes; adjustment to default base rubric; A345 rubric change</li> -<li>Some documentation changes</li> -</ul> -</dd> - -<dt>1.0.4-1, 2013 March 8</dt> -<dd>This is a bugfix release: it's a re-release of now-deprecated -1.0.5 minus a breaking change.<ul> -<li>Add <code>{table}</code> support, paralleling existing -<code>{figure}</code> support (ie tables don't float, but captions -work as expected).</li> -<li>Blank lines after a <code>\begin{question}</code> no longer -result in extra space.</li> -<li>Adjust spacing and layout of front page (again); various other -cosmetic changes.</li> -<li>A document identifier appears at the bottom of each page, -corroborating the exam the page is for (to avoid photocopier collation -accidents), and giving a numeric identifier which increases with time -(allowing you to identify which of two printouts is later).</li> -</ul></dd> - -<dt>1.0.4, 2013 March 6</dt> -<dd>Adjust base rubric; assorted distribution and detail fixes.</dd> - -<dt>1.0.3, 2013 January 25</dt> -<dd>Added <code>[A2]</code> class option.</dd> - -<dt>1.0.2, 2013 January 25</dt> -<dd><ul> -<li>The `pdfpages' package wasn't working when the `noshowsolutions' -option was present. Fixed, by special-casing, specifically disabling the -<code>\includepdf</code> command in this case.</li> -<li>Adjust display of <code>\partmarks</code> (no need for extra -space, since <code>\partmarks</code> is now fully in the margin).</li> -<li>Adjusting the front-page layout. Again.</li> -</ul></dd> - -<dt>1.0.1, 2013 January 18</dt> -<dd><ul> -<li><code>{figure}</code> now works, because it's explicitly -supported (<code>{figure}</code> inside solutions could cause problems -before). The contents don't float.</li> -<li>Layout adjustments.</li> -<li>Graphics now appear in draft mode.</li> -</ul> -</dd> - -<dt>1.0, 2012 December 11</dt> -<dd>This is the nominal version 1.0 release, and will be used for the -2012-13 Honours Astronomy exams (it might get further tweaks along the -way, but we believe this is a complete distribution set).<ul> -<li>More adjustments to notes-for-authors, now showing example LaTeX results.</li> -<li>Addition of template-question.tex</li> -<li>Adjustments to base rubric.</li> -</ul></dd> - -<dt>1.0b5, 2012 December 3</dt> -<dd><ul> -<li>Fine formatting adjustments: occasional <code>\nobreak</code> and -rationalisation of <code>\maketitle</code>.</li> -<li>Improvements to notes-for-authors.</li> -</ul></dd> - -<dt>1.0b4, 2012 November 30</dt> -<dd><ul> -<li>Improve generation of PDF metadata.</li> -<li>Add macro <code>\shout</code>, for highlighted `FIXME' comments.</li> -<li>Add showmarktotals option.</li> -<li>Permit <code>\partmarks</code> in solutions, without it adding to -the marks added up for the question (at the same time, forbid having a -solution within a solution).</li> -<li>Various formatting adjustments.</li> -</ul> -</dd> - -<dt>1.0b3, 2012 November 8</dt> -<dd><ul> -<li>Add [A345] option.</li> -<li>Make compose/draft material appear in red.</li> -<li>Some packaging changes and bugfixes.</li> -</ul></dd> - -<dt>1.0b2, 2012 November 6</dt> -<dd>Mild formatting adjustments.</dd> - -<dt>1.0rc1, 2012 November 2</dt> -<dd><ul> -<li>Significant rewrite of formatting, producing a consensus -AandA/PhysHons style, and renaming some confusingly named -commands.</li> -<li>Consequently, the AandA.clo and PhysHons.clo options have -disappeared.</li> -<li>The <code>\constantssheet</code> macro has appeared, and setting -this is now the principal function of per-class <code>.clo</code> -files. -See the new <code>A1.clo</code> and modified <code>P2.clo</code> option files.</li> -</ul> -</dd> - -<dt>0.17.1, 2012 September 21</dt> -<dd>Fix packaging infelicity</dd> - -<dt>0.17, 2012 September 21</dt> -<dd><ul> -<li>Rework <code>solutions</code> environment to make it a little more robust.</li> -<li>Add <code>\MSc</code> degree shorthand.</li> -<li>Bugfix: continuation headers now appear if a question starts on page 1.</li> -<li>Bugfix: fix wrong syntax in draft+showsolutions mode -- now works again</li> -</ul> -</dd> - -<dt>0.16, 2012 July 26</dt> -<dd><ul> -<li>Renamed the [showmarks] option to more rational [perquestionmarks] -(because the option doesn't control whether per-question marks are -<em>displayed</em>, but whether they're tracked at all). Slightly -improved the documentation of this at the same time.</li> -<li>Added <code>\lambdabar</code> macro</li> -<li>Fix long-standing problem with continuation lines -- these should now be robust.</li> -</ul></dd> -<dt>0.15, 2011 November 23</dt> -<dd>Avoid conflict with <code>ifpdf</code> package. -Now <em>depends</em> on <code>ifpdf</code>.</dd> -<dt>0.14, 2010 August 6</dt> -<dd><ul> -<li>Fixed the problem where the question-continuation marks would be -messed up by the presence of floats.</li> -<li>Added P2.clo; adjust 'showing solutions' banner -to avoid collision with other headers (thanks to Morag Casey for the .clo -file and the report).</li> -<li>Changed the name of the class to 'guexam', from potentially confusing 'exam'. -Support guexam.config for forcing options (for example).</li> -</ul></dd> - -<dt>0.13-1, 2008 November 21</dt> -<dd>Make the gulogo style optional, so that question authors don't -have to download and install that before they can draft a question. -Also adjust the logo size.</dd> - -<dt>0.13, 2008 November 11</dt> -<dd>Add university logo, and slightly rearrange the header. -Add <code>{questiondata}</code> environment.</dd> - -<dt>0.12-2, 2008 April 14</dt> -<dd>...keep on truckin'. Further changes to the -<code>\partmarks*</code> spacing code, still largely unprincipled, but -looking closer to what's required.</dd> - -<dt>0.12-1, 2008 April 3</dt> -<dd>...and again. This time, I think I actually see what the problem -was. Macro <code>\partmarks</code> now forces a new paragraph (it was -documented to be usable at the end of a paragraph, so this is again -forced, and the documentation made more explicit), this makes what I -thought was the solution actually work. Which is nice. Redefined -<code>enumerate</code> and <code>itemize</code> environments, to -improve spacing somewhat.</dd> - -<dt>0.12, 2008 April 3</dt> -<dd>Further adjustments to <code>\partmarks</code>: again, it should -be more consistent without necessarily being more principled, alas.</dd> - -<dt>0.11, 2008 March 30</dt> -<dd>Minor fixes: Adjust display of partmarks -- should now be more -consistent; option [showsolutions] no longer defaults -[{no,}pageperquestion]; add macro <code>\e</code> to format roman -exponential.</dd> - -<dt>0.10, 2008 January 17</dt> -<dd>Fix <code>\vec</code> when it appears in sub- or superscript -position. Add <code>\paperident</code> command.</dd> - -<dt>0.9, 2007 December 10</dt> -<dd>Various formatting changes. Added optional argument to -<code>\includequestion</code> overriding question number.</dd> - -<dt>0.8, 2007 November 25</dt> -<dd>You can now use <code>\usepackage</code> within -<code>[compose]</code> mode.</dd> - -<dt>0.7, 2007 November 20</dt> -<dd>Make changes to the display of the 'University of Glasgow' banner -at the top: resolves some font problems. Other minor layout tweaks.</dd> - -<dt>0.6, 2007 November 18</dt> -<dd>Fixed bold maths problems: <code>\vec</code> now works with greek -letters, too. Support MTpro2 (mathtime maths fonts) with the new -<code>[mtpro2]</code> class option. The <code>{solution}</code> -environment can appear multiple times within a question. Question -numbers now appear correctly in 'final' mode.</dd> - -<dt>0.5, 2007 October 30</dt> -<dd>Fix collision with LaTeX internal: a <code>\comment</code> at the -start of a <code>{question}</code> now works.</dd> - -</dl> - -</body> -</html> diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/Makefile b/Master/texmf-dist/doc/latex/exam-n/sample/Makefile index 253245e5345..91223625a35 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/Makefile +++ b/Master/texmf-dist/doc/latex/exam-n/sample/Makefile @@ -1,16 +1,31 @@ +LATEX=pdflatex + +QUESTIONS=cosmo1.tex \ + cosmo2.tex \ + cosmo3.tex \ + dynamical1.tex \ + dynamical2.tex \ + dynamical3.tex \ + excos1.tex \ + numerical1.tex \ + numerical2.tex \ + numerical3.tex + %.pdf: %.tex ../exam-n.cls - TEXINPUTS=..: pdflatex $< - if grep 'Rerun to get cross' ${<:.tex=.log}; then TEXINPUTS=..: pdflatex $<; else :; fi + TEXINPUTS=..: $(LATEX) $< + if grep 'Rerun to get cross' ${<:.tex=.log}; then TEXINPUTS=..: $(LATEX) $<; else :; fi all: sample_exam.pdf -sample_exam.pdf: numerical1-solution.pdf +sample_exam.pdf: numerical1-solution.pdf $(QUESTIONS) -sample_exam_solution.pdf: sample_exam_solution.tex +sample_exam_solution.pdf: sample_exam_solution.tex $(QUESTIONS) sample_exam_solution.tex: sample_exam.tex rm -f $@ - sed '1s/documentclass/documentclass[showsolutions]/' sample_exam.tex >sample_exam_solution.tex + sed -e '1s/documentclass\[/documentclass[showsolutions,/' \ + -e '1s/documentclass{/documentclass[showsolutions]{/' \ + sample_exam.tex >sample_exam_solution.tex # This will depend somehow on the .dtx file in the parent directory, # but expressing that here second-guesses how that file is actually diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/cosmo1.tex b/Master/texmf-dist/doc/latex/exam-n/sample/cosmo1.tex index 27045d026a6..a9e13b790bd 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/cosmo1.tex +++ b/Master/texmf-dist/doc/latex/exam-n/sample/cosmo1.tex @@ -21,21 +21,25 @@ included as a graphic. Fully zenned up? Then let us begin\dots. \caption{\label{f:spiral}A spiral} \end{figure} -\part Show that, under the action of gravity alone, the scale size -of the Universe varies according to +\part Show that, under the action of \textsf{gravity} alone, the scale size +of the Universe (which we should note is larger than \SI1m in +diameter and more massive than \SI{10}{kg}) varies according to \begin{equation} \ddot{R}=-\frac{4\pi G \rho_0}{3R^2} +\partmarks[demonstration]{4} \end{equation} -\partmarks*{4} and that, consequently, \begin{equation*} \dot{R}^2=-\frac{8\pi G \rho_0}{3R}=-K. -\partmarks*{3} +\partmarks[another remarkably long remark]{3} \end{equation*} Express $K$ in terms of the present values of the Hubble constant $H_0$ and of the density parameter $\Omega_0$. -\partmarks{3} +\partmarks[bookwork from a very long and boring book, which goes on + and on at really quite unreasonable length, line after line, + until the reader is adequately cudgelled into intellectual + submission]{3} \begin{solution} This can be solved by \emph{remembering} the solution \partmarks{3} @@ -74,8 +78,14 @@ Finis. Hubble's law: $v=H_0 D$ \end{questiondata} \partmarks{4} +% Test uprightness of \pi +All is geometry: $\mathrm e^{\mathrm{i}\pi} = -1^{x^x}, \forall x=1$, or $E=mc^2$. +% and that \vec produces italic bold, in greek as well as roman +That includes vectors: $\vec v=\Diffl*{\vec x}t + \vec\gamma$. \begin{solution} -Explanations are superfluous; all that is, is. + \tracingmacros=2 \tracingcommands=2 +Explanations are superfluous;\partmarks1 all that is, is. + \tracingmacros=0 \tracingcommands=0 \begin{table} \begin{tabular}{r|l} First rows&are premier\\ @@ -83,11 +93,20 @@ subsequent rows&are of secondary interest \end{tabular} \caption{\label{t:dullnessII}A table o'erbrimming with otioseness} \end{table} -In addition, Table~\ref{t:dullnessII} adds nothing to the discussion, -adds nothing to our understanding of our place in the cosmos, but it +In addition, Table~\ref{t:dullnessII} adds nothing to the discussion,\partmarks{1} +and adds nothing to our understanding of our place in the cosmos, but it \emph{does} contribute slightly to the heat-death of the universe (can you work out how many deuterium nuclei decayed during the typing of -this table?). +this table?).\partmarks1 + +All is geometry\partmarks1 (in here, too): $\mathrm e^{\mathrm{i}\pi} = -1^{x^x}, \forall x=1$, +or $E=mc^2$, or +\begin{align*} +\mathrm e^{\mathrm{i}\pi} &= \cos\pi + i \sin\pi = -1^{x^x}\\ +E&= mc^2\qquad\text{inevitably}. +\end{align*} \end{solution} \end{question} \end{document} + +Here are some further ramblings & rantings. This text should be ignored. diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/cosmo2.tex b/Master/texmf-dist/doc/latex/exam-n/sample/cosmo2.tex index bb6c512b9dd..51253d590a5 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/cosmo2.tex +++ b/Master/texmf-dist/doc/latex/exam-n/sample/cosmo2.tex @@ -12,8 +12,8 @@ distance $r$, observed with radiation flux $\ge F$ is (neglecting other selection and redshift effects) \begin{equation*} N(F)=4\pi\int_0^{(\frac{L}{4\pi F})^{1/2}} n(r) r^2\ddd r. +\partmarks{5} \end{equation*} -\partmarks*{5} Use this to show that for $n=n_1=$constant at $r<r_1$ and $n=n_2=$constant at $r>r_1$, @@ -42,19 +42,19 @@ Reduce these two expressions to the result for a completely uniform density universe with $n_1=n_2=n_0$. \partmarks{3} -% An itemized list followed by partmarks* +% An itemized list containing partmarks Sketch how $n(F)$ would look in universes which are \begin{itemize} \item flat, \item open, \item and closed. +\partmarks3 \end{itemize} -\partmarks*{3} \begin{solution} A sufficiently heavy weight will reduce expressions to completely uniform sheets of paper if it is placed on top of them.\partmarks3 -In a flat universe, $n(F)$ will look like n(F).\partmarks*3 +In a flat universe, $n(F)$ will look like n(F).\partmarks3 \end{solution} \end{question} \end{document} diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/cosmo3.tex b/Master/texmf-dist/doc/latex/exam-n/sample/cosmo3.tex index b7b74c01077..aa3f78868ac 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/cosmo3.tex +++ b/Master/texmf-dist/doc/latex/exam-n/sample/cosmo3.tex @@ -32,7 +32,7 @@ equivalent to an empty, flat, Universe with a non-zero $\Lambda$. of state with $w = 0$ for $0 < t < t_0$, but which changes to $W=0$ for $t\ge t_0$ without any discontinuity in $H(t)$. Regarding this second stage as driven by a non-zero $\Lambda$ what -is the value of $\Lambda$ if $t_0 = 10^{24}$\units{\mu s}? Define the +is the value of $\Lambda$ if $t_0 = \SI{1e24}{\mu s}$? Define the dimensionless deceleration parameter, $q$, and find its value before and after $t_0$. \shout{Shout it loud: I'm a geek and I'm proud} @@ -40,7 +40,7 @@ before and after $t_0$. Note: that's \[ -t_0=10^{24}\units{\mu s}\qquad\text{with a letter mu: $\mu$}. +t_0=\SI{1e24}{\mu s}\qquad\text{with a letter mu: $\mu$}. \] \part To what extent does this idealized model resemble the currently diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/dynamical1.tex b/Master/texmf-dist/doc/latex/exam-n/sample/dynamical1.tex index e3a51a803bb..c371e9f9001 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/dynamical1.tex +++ b/Master/texmf-dist/doc/latex/exam-n/sample/dynamical1.tex @@ -23,20 +23,20 @@ $a(t)$ is the semimajor axis at time $t$) \begin{equation*} \frac{a(t)}{a_0}=\left[1-\frac{t\Delta V}{2^{1/2}\pi a_0(1-e_0)^{1/2}}\right]^2 +\partmarks{2} \end{equation*} -\partmarks*{2} and \begin{equation*} \frac{T(t)}{T_0}=\left[1-\frac{t\Delta V}{2^{1/2}\pi a_0(1-e_0)^{1/2}}\right]^3 +\partmarks{1} \end{equation*} -\partmarks*{1} and the eccentricity satisfies (with $e_0=e(0)$) \begin{equation*} e(t)=1-\frac{1-e_0}{\left[1-\frac{t\Delta V}{2^{1/2}\pi a_0(1-e_0)^{1/2}}\right]^2}. +\partmarks{2} \end{equation*} -\partmarks*{2} Show that, once the orbit is circular, its radius decays exponentially with time on timescale $m_0/2\dot{m}$ where $m_0$ @@ -62,8 +62,8 @@ passage distances for the system, show that this leads to a natural time $T$ for the system, where \begin{equation*} T\propto\frac{\bar{u}u^2}{m^2\nu\log N}. +\partmarks{5} \end{equation*} -\partmarks*{5} \begin{questiondata} You may assume that the sphere of influence radius of a star is diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam.tex b/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam.tex index 98031e60911..4ae4e18f0a7 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam.tex +++ b/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam.tex @@ -1,19 +1,39 @@ -\documentclass{exam-n} +% A suitable documentclass line is the following. +% Change this to [final] for the final version. +% This option enables showing solutions, showing comments, and a few +% other adjustments which seem useful at draft time. The [final] +% option turns all of these off. +\documentclass[stix2,uprightpi]{exam-n} + +% Include a local .clo file like this: +%\documentclass[myclass]{exam-n} +% +% Choose different font sets: +%\documentclass[stix2]{exam-n} +%\documentclass[mtpro2]{exam-n} +%\documentclass[mtpro2,sansserif]{exam-n} +% +% There are some alternatives for those who need special versions +% with large fonts: %\documentclass[largefont]{exam-n} %\documentclass[hugefont,sansserif]{exam-n} -%\documentclass[mtpro2,showsolutions]{exam-n} -%\documentclass[mtpro2,showsolutions,sansserif]{exam-n} -%\documentclass[draft,showsolutions,sansserif]{exam-n} - -% Note: this sample question dates from an earlier phase, in which -% `paper n' would contain a bundle of questions from various courses. -% That's why the \coursetitle doesn't match the broad range of -% subjects being 'examined'. % -% Several of the questions are gibberish. +% It wouldn't make sense for this file, but the files being included +% using \includequestion should start with: +%\documentclass[compose]{exam-n} % -% This collection of questions has in part turned into an informal -% regression test for the class file. +% For discussion of these various class options, and more, see the +% guexam.pdf documentation. +% +% Note: +% +% * Several of the questions are gibberish. +% * This collection of questions has in part turned into an +% informal regression test for the class file. Thus they +% shouldn't necessarily be regarded as canonically best practice. + +% Include a default category for \partmarks +%\defaultpartmarkscategory{category?} \examdate{Wednesday, 23 May 2007} \examtime{9:30 -- 10:45 (1 course)\\9:30 -- 12:00 (2 courses)} @@ -25,7 +45,7 @@ Astrophysics 3\\Theoretical Physics 3M\\Joint Physics 3} \schoolcoursecode{P304D and P304H} \universitycoursecode{PHYS3031 and PHYS4025} -\coursetitle{Quantum Mechanics} +\coursetitle{Quantum Mechanics (and other bits of physics)} \usepackage{pdfpages} diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/sample_mcq.tex b/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam_mcq.tex index 268417ff7d0..268417ff7d0 100644 --- a/Master/texmf-dist/doc/latex/exam-n/sample/sample_mcq.tex +++ b/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam_mcq.tex diff --git a/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam_solution.tex b/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam_solution.tex deleted file mode 100644 index 853bccbce91..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/sample/sample_exam_solution.tex +++ /dev/null @@ -1,65 +0,0 @@ -\documentclass[showsolutions]{exam-n} -%\documentclass[largefont]{exam-n} -%\documentclass[hugefont,sansserif]{exam-n} -%\documentclass[mtpro2,showsolutions]{exam-n} -%\documentclass[mtpro2,showsolutions,sansserif]{exam-n} -%\documentclass[draft,showsolutions,sansserif]{exam-n} - -% Note: this sample question dates from an earlier phase, in which -% `paper n' would contain a bundle of questions from various courses. -% That's why the \coursetitle doesn't match the broad range of -% subjects being 'examined'. -% -% Several of the questions are gibberish. -% -% This collection of questions has in part turned into an informal -% regression test for the class file. - -\examdate{Wednesday, 23 May 2007} -\examtime{9:30 -- 10:45 (1 course)\\9:30 -- 12:00 (2 courses)} - -\exambanner{Examination for the degrees of \BSc\, - \MSci\ and \MA\ on the honours standard } - -\degreedescriptions{Physics 3\\Chemical Physics 3\\Physics with - Astrophysics 3\\Theoretical Physics 3M\\Joint Physics 3} -\schoolcoursecode{P304D and P304H} -\universitycoursecode{PHYS3031 and PHYS4025} -\coursetitle{Quantum Mechanics} - -\usepackage{pdfpages} - -\rubric{Candidates should answer Questions 1 and 2 (10~marks each), - \linebreak\textbf{and either} Question 3 \textbf{or} Question 4 (30~marks). - \linebreak The content of this sample exam derives from real - questions, but the result is in many cases test gibberish.} -%\norubric - -\numquestions{13} - -\usepackage{graphicx} % for graphic in dynamical1 - -\begin{document} -\maketitle - -\section{I} -\includequestion{cosmo1} -\includequestion{numerical1} -\includequestion{dynamical1} - -\section{II} -\includequestion{cosmo2} -\subsection{Cosmology question number 3} -\includequestion{cosmo3} -\includequestion{excos1} % four multiple-choice questions - -\section{III} -% Override the question number, to test/demo this -\includequestion[99]{numerical2} -\includequestion{numerical3} - -\section{IV} -\includequestion{dynamical2} -\includequestion{dynamical3} - -\end{document} diff --git a/Master/texmf-dist/doc/latex/exam-n/sample_exam.pdf b/Master/texmf-dist/doc/latex/exam-n/sample_exam.pdf Binary files differdeleted file mode 100644 index db389f7e34b..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/sample_exam.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/exam-n/sample_exam_solution.pdf b/Master/texmf-dist/doc/latex/exam-n/sample_exam_solution.pdf Binary files differdeleted file mode 100644 index 994205d6e9e..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/sample_exam_solution.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/exam-n/style.css b/Master/texmf-dist/doc/latex/exam-n/style.css deleted file mode 100644 index c7be40749ab..00000000000 --- a/Master/texmf-dist/doc/latex/exam-n/style.css +++ /dev/null @@ -1,230 +0,0 @@ -body { - color: #333; - background: white; - margin-left: +30%; - width: 50%; /* body is 50% of screen width */ - margin-right: auto; /* ie, 20% */ - padding: 0.5em; /* this will make a difference if I decide to - have the background a different colour */ - /* I can't decide on font: Optima's always nice, but Gill looks - agreeably intense. Helvetica's a decent fallback. */ - font-family: "Helvetica Neue", Helvetica, "Gill Sans", gill, sans-serif; - /* font-family: Optima, "Gill Sans", gill, Helvetica, sans-serif; */ - /* font-family: "Gill Sans", gill, Helvetica, sans-serif; */ - /* I seem to have used 11pt at some point in the past, but this - is far too big -- did I ever have a reason for that, or is it - just due to browser changes? */ - font-size: 10pt; - line-height: 150%; -} - -div.topsidebar { - float: right; - width: 50%; /* ...of the body width (ie, 50% x 50% of screen) */ - font-size: smaller; - margin-left: 1em; - padding-left: 1em; - border-left: solid thin #AAA; -} - -/* On wider screens, move the sidebar out to the right hand side */ -/* This uses CSS3 media queries: http://www.w3.org/TR/css3-mediaqueries/ */ -@media screen and (min-width: 700pt) and (max-width: 850pt) { - body { - margin-left: 210pt; - width: 350pt; /* 50% of 700pt */ - margin-right: auto; - } - div.topsidebar { - position: absolute; - /* I feel this size should be 595pt (350 + 210 + 0.05*700), - but that's clearly not right -- I don't think I understand what the -5% - in the h1 spec below is actually 5% of! */ - left: 570pt; - width: auto; - margin-left: 0pt; - padding-left: 0pt; - border: none; - } -} -/* On still-wider screens, expand the left-margin, keeping the sidebar attached to the right-hand edge. - When the screen is 850pt wide (expanding from the @media case above), - the left margin will be 210pt, the width 350pt, and the right margin therefore 290pt.*/ -@media screen and (min-width: 850pt) { - body { - margin-right: 290pt; /* 290 = 850-(210+350) */ - width: 350pt; - margin-left: auto; /* ...takes up the slack */ - } - div.topsidebar { - position: absolute; - width: 290pt; /* same 290pt as above */ - left: auto; - right: 0%; - padding-left: 0pt; - border: none; - } -} - - -code, pre { - font-family: Monaco, fixed; - font-size: 9pt; -} - -a { text-decoration: none; } -a:link { color: #66C; } -a:visited { color: #669; } -a[href]:hover { background: #EEE; } - -div.abstract { - font-style: oblique; - text-align: left; -} -div.abstract em { font-style: normal; } -div.abstract code { - font-style: normal; - font-size: 80%; -} - -/* a span/div style for attracting attention */ -.attention { - color: #822; -} - -h1, h2, h3, h4, h5, h6 { - color: #822; - font-weight: 100; /* few fonts have ultra-light weights */ - line-height: 100%; /* no need to spread out titles */ -} -h1 { - margin-left: -40%; - margin-right: -5%; - padding: 0.5em; - border: solid thin #666; - text-align: right; -} -h2 { - margin-left: -40%; - margin-right: -5%; - padding: 0.2em; - border-top: solid thin #666; - clear: both; -} - -h2.appendices { - margin-top: 10ex; - border-top: double medium #666; -} -h3 { - margin-left: -30%; - float: left; - width: 25%; - display: block; - text-align: right; - vertical-align: bottom; - padding-top: 0pt; - padding-right: 0.5em; - margin-top: 0pt; - line-height: 100%; -} - -/* -h4 { - color: #C66; -} -*/ - -pre, table { background: #dde; } - -pre { - padding: 1em; - line-height: 130%; -} - -table { - font-size: smaller; -} -td { - padding: 0.5ex; -} - -Q:before { content: "“"; } -Q:after { content: "”"; } - -img.smallimage { - float: right; - margin: 24pt; - margin-right: -30%; -} - -div.signature { - margin-left: -40%; - margin-right: -5%; - margin-top: 4ex; - text-align: right; - border: solid thin #666; - padding: 0.3em; - clear: both; -} - -/* ============================================================ - * Some other curiosities of my one-time formatting for web pages - */ -.doc-history { - font-size: xx-small; - background: #eee; - line-height: 100%; -} - -div.subtoc, div.subsubtoc { display: none; } - -/* ============================================================ - * Special formatting for ToC - */ - -/* - If there's significant amount of text in front of the first subsection, - then the following are good to put in the per-document stylesheet: - width: 25%; - float: right; -*/ -div#toc { - color: #888; - padding: 0; - font-size: smaller; - text-align: right; -} -div#toc a:link { color: #888; } -div#toc > ul { - padding: 0pt; - margin: 0pt; - list-style: none; -} -div#toc li { - padding: 0pt; - display: inline-block; -} -div#toc li:before { - content: "§ "; - margin-left: 1em; -} -/* the following elements aren't currently generated by structure.lx */ -div#toc li ul { - padding-left: 1em; - margin-left: 0; - font-style: italic; - display: inline; -} -div#toc li ul:before { - content: "( "; -} -div#toc li ul:after { - content: " ) "; -} -div#toc li li { - padding-left: 0pt; -} -div#toc li li:after { - content: "; "; -} diff --git a/Master/texmf-dist/doc/latex/exam-n/template-master.pdf b/Master/texmf-dist/doc/latex/exam-n/template-master.pdf Binary files differnew file mode 100644 index 00000000000..30f7de8e5bf --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/template-master.pdf diff --git a/Master/texmf-dist/doc/latex/exam-n/template-master.tex b/Master/texmf-dist/doc/latex/exam-n/template-master.tex new file mode 100644 index 00000000000..9ac66cc13ab --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/template-master.tex @@ -0,0 +1,20 @@ +\documentclass[siunitx]{exam-n} + +\exambanner{Examination for the degree of Master of Examinations} +\universitycoursecode{EX-666} +\schoolcoursecode{Exams001} +\coursetitle{Advanced setting of exams} +\degreedescriptions{Examinations 3} + +\examdate{2012 December 25} +\examtime{12:00 -- 23:00} +\rubric{Be creative, but not vindictive} + +\numquestions{1} + +\begin{document} +\maketitle + +\includequestion{template-question} + +\end{document} diff --git a/Master/texmf-dist/doc/latex/exam-n/template-question.pdf b/Master/texmf-dist/doc/latex/exam-n/template-question.pdf Binary files differnew file mode 100644 index 00000000000..a0fad417f9b --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/template-question.pdf diff --git a/Master/texmf-dist/doc/latex/exam-n/template-question.tex b/Master/texmf-dist/doc/latex/exam-n/template-question.tex new file mode 100644 index 00000000000..6337f5970c0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/exam-n/template-question.tex @@ -0,0 +1,22 @@ +\documentclass[compose,siunitx]{exam-n} +\begin{document} +\begin{question}{20} \author{Frieda Bloggs} +\shout{Dummy question} +\part Show that, under the action of gravity alone, the scale size +of the Universe varies according to +\[ +\ddot{R}=-\frac{4\pi G \rho_0}{3R^2}. +\] +Is $\ddot{R}=\Diffl*[2]{R}{t} > \SI{10}{\astronomicalunit. s^{-2}}$? +\partmarks*{4} +\begin{solution} +This can be solved by remembering the answer. +\end{solution} + +\part Explain the nature of being. +\partmarks{16} +\begin{solution} +Om. +\end{solution} +\end{question} +\end{document} |