Debian Codegraph @

texmf-dist/source/latex/revtex4/revtex4.dtx

raw
1 % \iffalse
2 % ****** Start of file revtex4.dtx ****** %
3 %
4 % This file is part of the APS files in the REVTeX 4 distribution.
5 % For version number, search on the string "%FileInfo"
6 %
7 % First revision by David Carlisle,
8 % later versions by Arthur Ogawa.
9 %
10 % Copyright (c) 2000 The American Physical Society.
11 % http://publish.aps.org/revtex4/
12 % mailto:[email protected]
13 %
14 %
15 % See the REVTeX 4 README file for restrictions and more information.
16 % \fi
17 % \iffalse
18 %<*driver>
19 \ProvidesFile{revtex4.dtx}
20 %</driver>
21 %<class-pre|aps|rmp>\NeedsTeXFormat{LaTeX2e}[1996/12/01]
22 %<class-pre>\ProvidesClass{revtex4}
23 %<aps>\ProvidesFile{aps.rtx}
24 %<rmp>\ProvidesFile{rmp.rtx}
25 %<10pt>\ProvidesFile{10pt.rtx}
26 %<11pt>\ProvidesFile{11pt.rtx}
27 %<12pt>\ProvidesFile{12pt.rtx}
28 %<revsymb&!class-pre>\ProvidesPackage{revsymb}
29 %<driver>\ProvidesFile{revtex.drv}
30 %<*!class-pst>
31 [2020/09/30 v4.0a (http://publish.aps.org/revtex4/ for documentation)]%FileInfo
32 %</!class-pst>
33 %<*driver>
34 \listfiles
35 \documentclass{ltxdoc}
36 \RequirePackage{ltxdocext}%
37 \let\url\undefined
38 \RequirePackage[colorlinks=true,linkcolor=blue]{hyperref}%
39 \expandafter\ifx\csname package@font\endcsname\relax\else
40 \expandafter\expandafter
41 \expandafter\RequirePackage
42 \expandafter\expandafter
43 \expandafter{\csname package@font\endcsname}%
44 \fi
45 \CodelineIndex\EnableCrossrefs
46 \begin{document}
47 \gdef\lquote{`}\gdef\rquote{'}%
48 %{\tracingall\showlists}
49 \DocInput{revtex4.dtx}
50 \end{document}
51 %</driver>
52 % \fi
53 %
54 % \GetFileInfo{revtex4.dtx}
55 %
56 % \title{The \classname{revtex4} document class of the American Physical Society}
57 % \author{Arthur Ogawa%
58 % \thanks{First revision by David Carlisle}%
59 % }%
60 % \date{Version \fileversion, dated \filedate}%
61 % \newcommand\revtex{REV\TeX}
62 %
63 % \maketitle
64 %
65 % This file embodies the implementation of the APS \revtex\ 4 document class
66 % for electronic submissions to journals.
67 %
68 % The distribution point for this work is
69 % \url{http://publish.aps.org/revtex4/},
70 % which contains fully unpacked, prebuilt runtime files and documentation.
71 %
72 % \tableofcontents
73 %
74 % \section{Using \protect\revtex}
75 %
76 % The file \file{README} has retrieval and installation information.
77 %
78 % User documentation is presented separately in \file{revguide.tex}.
79 %
80 % The file \file{template.aps} is a boilerplate file.
81 %
82 % \StopEventually{}
83 %
84 % \changes{v4.a}{1998/01/16}
85 % {Initial version}
86 % \changes{v4.0beta 2}{1999/06/20}
87 % {First modifications by Arthur Ogawa (mailto:[email protected])}
88 % \changes{v4.0beta 3}{1999/11/13}
89 % {New ltxgrid-based code, other bug fixes}
90 % \changes{v4.0beta 4}{2000/05/10}
91 % {More features and bug fixes: compatability with longtable and array packages.
92 % Now certainly incompatible with multicol.}
93 % \changes{v4.0beta 5}{2000/11/14}
94 % {Bug fixes and minor new features: title block affiliations can have ancillary data, just like authors;
95 % clearpage processing revamped, with floats staying in order; widetext ornaments.}
96 % \changes{v4.0beta 6}{2001/02/13}
97 % {Last bug fixes before release.}
98 %
99 % \section{Overview}%
100 % \revtex\ is a \LaTeXe\ document class, aomewhat like a hybrid of
101 % the standard \LaTeX\ \classname{book} and \classname{article} classes.
102 %
103 % Certain packages are (should be) loaded by this class in any case:
104 % \classname{amssymb}, \classname{amsmath}, \classname{bm}, \classname{natbib}.
105 %
106 % Certain packages are automatically loaded by this class
107 % when a corresponding class option has been invoked:
108 %
109 % \begin{tabular}{ll}
110 % \textbf{\revtex\ option}&\textbf{package}\\
111 % \classoption{amsfonts}&\classname{amsfonts}\\
112 % \classoption{amssymb}&\classname{amssymb}\\
113 % \classoption{aps}&\classname{overcite}\\
114 % \end{tabular}
115 %
116 % Certain other packages are to be loaded by the
117 % document through explicit use of \cmd\usepackage.
118 % Some mentioned in the user documentation are
119 % \classname{graphicx}, \classname{longtable},
120 % and \classname{bm}.
121 %
122 % Certain commonly used packages are known to be incompatible with
123 % \revtex, among them \classname{multicol} and \classname{cite}.
124 % If such a package is found to be loaded, \revtex\ issues an error message
125 % and halts the job.
126 % Halting might be considered severe punishment for loading an incompatible
127 % package, but if we were to proceed, an even weirder error might be encountered
128 % further down the road.
129 %
130 % This document class implements the substyle: a set of mutually
131 % exclusive class options that, in this case, allow the
132 % document class to address multiple societies.
133 % It also implements a sub-substyle, giving the
134 % journal of the given society.
135 % The only society currently implemented is \classoption{aps},
136 % however, code is in place for another society, the \classoption{osa}.
137 %
138 % FIXME: should always load the \classname{graphicx} package.
139 %
140 % QUERY: since \classname{amsfonts} and \classname{amssymb} extend
141 % syntax, why not load them in any case?
142 %
143 % QUERY: if you say \cmd\documentclass|[prb,osa]{revtex4}|, then
144 % the value of \cmd\@society\ will be wrong, or? Fixed.
145 %
146 % Certain events occur at \cmd\AtEndOfClass\ time:
147 % \begin{enumerate}
148 % \item
149 % Optionally read in packages
150 % \classname{amsfonts}, \classname{amssymb}.
151 % \item
152 % Read in society substyle \file{.rtx} file.
153 % \item
154 % Read in type size \file{.rtx} file.
155 % \item
156 % Read in the job's style file, the \file{.rty} file.
157 % \item
158 % Define things based on \cmd\secnumarabic@sw.
159 % \item
160 % Install procedures to execute at the very end of the class's
161 % \cmd\AtBeginDocument\ processing, such as
162 % \begin{enumerate}
163 % \item
164 % closing out the page grid
165 % \item
166 % putting out the LastPage label.
167 % \item
168 % issuing a \cmd\bibliographystyle\ command, based on the value set
169 % by the society substyle.
170 % \item
171 % setting default values for parameters used in the document.
172 %FIXME: differentiate between class's parameters that can wait until
173 % they are used in the document, and parameters that are used at \cmd\AtBeginDocument\ time.
174 % \end{enumerate}
175 % \item
176 % Install procedures to execute the very last at \cmd\AtEndDocument\ time,
177 % such as the \cmd\clearpage\ processing.
178 % \end{enumerate}
179 %
180 % Certain events are optionally scheduled for \cmd\AtBeginDocument\ time:
181 % \begin{enumerate}
182 % \item
183 % Setting default values for the Booleans and for other procedures used in formatting.
184 % \item
185 % In response to class options options, adjusting parameters and procedures used in formatting.
186 % \item
187 % Implementing the \classoption{eqsecnum} option, if required.
188 % \item
189 % Setting the state engine for data commands.
190 % \item
191 % Memorizing procedures for later use.
192 % \item
193 % Setting type size and area, for use by later calculations.
194 % \end{enumerate}
195 %
196 % Certain events are scheduled for \cmd\class@enddocumenthook\ time:
197 % \begin{enumerate}
198 % \item
199 % Print out the migrated floats or the end notes, if needed.
200 % \item
201 % Close out the page grid.
202 % \item
203 % Label the last page of the document
204 % \item
205 % (\classname{natbib}) prepare to read in the \file{.aux} file.
206 % \end{enumerate}
207 %
208 %
209 % \section{The installer file}
210 % We include here a reference copy of the installer file, \file{revtex4.ins}.
211 % It is not intended that one actually generate that file using \file{docstrip}
212 % via the revtex4 installer file, because that would involve overwriting the
213 % file that \TeX\ is typesetting. Instead, the installer file is provided
214 % pre-generated.
215 %
216 % For the most part, the installer is simple: it generates \file{revtex4.cls} and
217 % a collection of \file{.rtx} files from \file{revtex4.dtx}.
218 %
219 % However, the process of generating \file{revtex4.cls} involves the incorporation
220 % of portions of two of the \file{ltx} series of files, \file{ltxutil.dtx},
221 % and \file{ltxgrid.dtx}. The former is a collection of macro definitions that
222 % serve as the lowest level of extensions to \LaTeX, the latter implements
223 % an alternative output routine and page gridding mechanism that provides for
224 % multicolumn page layouts, but without the sorry limitations of the
225 % \LaTeX\ required package, \classname{multicol}, and is also compatible with
226 % the \classname{longtable} package (which \classname{multicol} is not).
227 % \begin{macrocode}
228 %<*ins>
229 % This file requires docstrip version 2.4 or higher available from
230 % ftp://ctan.tug.org/tex-archive/macros/latex/unpacked/docstrip.tex
231 \input docstrip
232 \preamble
233
234 This file is part of the APS files in the REVTeX 4 distribution.
235 For the version number, search on the string %FileInfo
236
237 Copyright (c) 2000 The American Physical Society.
238 http://publish.aps.org/revtex4/
239 mailto:[email protected]
240
241 Maintained by Arthur Ogawa (mailto:[email protected])
242 under contract to the American Physical Society.
243
244 See the REVTeX 4 README file for restrictions and more information.
245
246 \endpreamble
247 \keepsilent
248 \askforoverwritefalse
249 \generate{%
250 \file{revtex4.cls}{%
251 \from{revtex4.dtx}{class-pre}%
252 \from{ltxutil.dtx}{ltxutil-krn}%
253 \from{ltxgrid.dtx}{ltxgrid-krn}%
254 \from{textcase.dtx}{package}%
255 \from{revtex4.dtx}{class-pst}%
256 }%
257 \file{aps.rtx}{\from{revtex4.dtx}{aps}}%
258 \file{rmp.rtx}{\from{revtex4.dtx}{rmp}}%
259 \file{10pt.rtx}{\from{revtex4.dtx}{10pt}}%
260 \file{11pt.rtx}{\from{revtex4.dtx}{11pt}}%
261 \file{12pt.rtx}{\from{revtex4.dtx}{12pt}}%
262 \file{revsymb.sty}{\from{revtex4.dtx}{revsymb}}%
263 }%
264 \endbatchfile
265 %</ins>
266 % \end{macrocode}
267 %
268 %
269 % \section{Writing journal-specifc extensions to \revtex}
270 %
271 % With this version of \revtex, we introduce a somewhat different
272 % scheme for adapting \revtex\ to the needs of a specific journal.
273 %
274 % To create a journal substyle, you create new class options in
275 % \revtex\ for the society, say \classoption{osa}, and any of that society's journals,
276 % one of which is, say, \classoption{josaa},
277 % using the code for the APS as a guide.
278 % In particular, each of your new options should separately define \cmd\@society\
279 % and \cmd\@journal. That for the former will be the same for
280 % all options relating to a particular society.
281 %
282 % Then, for the society, you create a corresponding \file{.rtx}
283 % file, in our case \file{osa.rtx}.
284 % Within that file, you override procedures and parameter assignments as you see fit.
285 % Ideally they will be generally applicable to all of that society's
286 % journals (see the file \file{aps.rtx} for a realization of this scheme).
287 % Also within that file, you include a
288 % section of code for each journal, that for josaa looks like:
289 % \begin{verbatim}
290 % \@ifx{\@journal\journal@josaa}{%
291 % <code specific to the josaa>
292 % }{}%
293 % \end{verbatim}
294 %
295 % Thus far, the scheme is similar to that used in \revtex\ 3.1.
296 % However, the new scheme does differ from the old in that
297 % the \file{.rtx} file should define no syntactical extensions
298 % to \revtex.
299 %
300 % \section{The \classname{revtex4} Document Class}
301 %
302 % \begin{macrocode}
303 %<*class-pre>
304 \def\class@name{revtex4}%
305 % \end{macrocode}
306 %
307 % Print a banner in the log:
308 % \begin{macrocode}
309 \GenericInfo{}{\space
310 Copyright (c) 2001 The American Physical Society.^^J
311 mailto:[email protected]^^J
312 Licensed under the LPPL:^^Jhttp://www.ctan.org/tex-archive/macros/latex/base/lppl.txt^^J
313 Arthur Ogawa <[email protected]>^^J
314 Based on work by David Carlisle <[email protected]>%
315 \@gobble
316 }%
317 % \end{macrocode}
318 %
319 % \subsection{Compatability Processing}
320 %
321 % If the document has \cmd\documentstyle|{revtex4}|,
322 % then, instead of attempting to run in compatability mode,
323 % just complain and exit.
324 % \changes{v4.0beta 3}{1999/11/13}
325 % {Lose compatability mode.}
326 % \begin{macrocode}
327 \if@compatibility
328 \edef\reserved@a{\errhelp{%
329 Change your \string\documentstyle\space statement to
330 \string\documentclass\space and rerun.
331 }}\reserved@a
332 \errmessage{You cannot run \class@name\space in compatability mode}%
333 \expandafter\@@end
334 \fi
335 % \end{macrocode}
336 %
337 %
338 % \section{Extensions to the \LaTeX\ Kernel}
339 % I am introducing
340 % some portions of the \classname{ltxkrnext} package
341 % (\url{ftp://ftp.teleport.com/users/ogawa/macros/latex/contrib/supported/ltxkrnext/}).
342 %
343 % First, de-fang unwanted commands and turn \cmd\ProvidesPackage\ into an informative message.
344 % \begin{macrocode}
345 \let\DeclareOption@latex\DeclareOption
346 \let\DeclareOption\@gobbletwo
347 \let\ProcessOptions@latex\ProcessOptions
348 \let\ProcessOptions\@empty
349 \let\ProvidesPackage@latex\ProvidesPackage
350 \def\ProvidesPackage#1[#2]{%
351 \class@info{Incorporating package #1 [#2].}%
352 }%
353 %</class-pre>
354 % \end{macrocode}
355 % Now load the utility and page grid packages.
356 % The \classname{ltxutil} and \classname{ltxgrid} packages are distributed with
357 % \revtex.
358 % \begin{macrocode}
359 %\RequirePackage{ltxutil}%
360 %\RequirePackage{ltxgrid}%
361 % \end{macrocode}
362 %
363 % The \classname{textcase} package is available from
364 % \url{CTAN:/macros/latex/contrib/supported/carlisle/textcase.dtx} and is
365 % used at the suggestion, and by permission, of David~P. Carlisle.
366 % \begin{quotation}
367 % \cmd\ProvidesFile{textcase.dtx}
368 % [1998/11/12 v0.06 Text only upper/lower case changing (DPC)]
369 % \end{quotation}
370 %
371 % David, in turn, suggests that Donald Arseneau be credited for some of the ideas in
372 % the \classname{textcase} package, so let it hereby be so understood.
373 %
374 % Note that David's package has a bug, which is fixed as follows:
375 % Change:
376 %\begin{verbatim}
377 % \def\NoCaseChange##1{\noexpand\NoCaseChange{\noexpand##1}}
378 %\end{verbatim}
379 % To:
380 %\begin{verbatim}
381 % \def\NoCaseChange##1{\noexpand\NoCaseChange{\noexpand##1}}%
382 %\end{verbatim}
383 %
384 % \begin{macrocode}
385 %\RequirePackage{textcase}%
386 % \end{macrocode}
387 %
388 % Next, restore those cammands we de-fanged:
389 % \begin{macrocode}
390 %<*class-pst>
391 \let\ProvidesPackage\ProvidesPackage@latex
392 \let\ProcessOptions\ProcessOptions@latex
393 \let\DeclareOption\DeclareOption@latex
394 % \end{macrocode}
395 % And let the \classname{textcase} commands override those of \LaTeX:
396 % \begin{macrocode}
397 \expandafter
398 \let\csname MakeUppercase \expandafter\endcsname
399 \csname MakeTextUppercase \endcsname
400 \expandafter
401 \let\csname MakeLowercase \expandafter\endcsname
402 \csname MakeTextLowercase \endcsname
403 % \end{macrocode}
404 %
405 % Try to patch \classname{longtable}.
406 % \begin{macrocode}
407 \appdef\class@documenthook{%
408 \switch@longtable
409 }%
410 % \end{macrocode}
411 %
412 % Try to provide a more robust version of \cmd\boldmath.
413 % If Team \LaTeX\ ever gets around to fixing this problem, we will bow out.
414 % (This relates to bug \#394.)
415 % \begin{macrocode}
416 \appdef\class@documenthook{%
417 \expandafter\@ifnotrelax\csname boldmath \endcsname{}{%
418 \expandafter\let\csname boldmath \endcsname\boldmath
419 \expandafter\def\expandafter\boldmath\expandafter{\expandafter\protect\csname boldmath \endcsname}%
420 }%
421 }%
422 % \end{macrocode}
423 %
424 %
425 %
426 % \section{Options}\label{sec:options}%
427 %
428 % \subsection{Define Booleans Used in Options}%
429 % The following Booleans are used within the document class to
430 % allow the document or the substyle to make selections
431 % of formatting.
432 % Because an explicit document class option always overrides a substyle,
433 % any substyle wishing to assign a value to a flag must first test the flag to
434 % confirm that it is still undefined.
435 % This further means that the default value of the flag must be
436 % assigned late, at the end of \cmd\AtBeginDocument\ time, and that
437 % the flag may be queried no earlier than that time.
438 %
439 % \begin{macro}{\class@inithook}
440 % The hook \cmd\class@inithook\ is installed into \cmd\class@documenthook,
441 % and thereafter serves as the focal point for all code that
442 % gives default values to the class's parameters.
443 %
444 % A typical code might be:
445 % \begin{verbatim}
446 %\appdef\class@inithook{%
447 % \@ifxundefined\twocolumn@sw{\@booleanfalse\twocolumn@sw}{}%
448 %}%
449 % \end{verbatim}
450 % which ensures that the switch \cmd\twocolumn@sw\ is never left undefined.
451 %
452 % \begin{macrocode}
453 \appdef\class@documenthook{%
454 \class@inithook
455 }%
456 \def\class@inithook{}%
457 %
458 % \end{macrocode}
459 % \end{macro}
460 %
461 % \begin{macro}{\twocolumn@sw}
462 % The boolean \cmd\twocolumn@sw\ signifies that we are to use a two-column grid.
463 %
464 % \begin{macrocode}
465 \appdef\class@inithook{%
466 \@ifxundefined\twocolumn@sw{\@booleanfalse\twocolumn@sw}{}%
467 }%
468 % \end{macrocode}
469 % \end{macro}
470 %
471 % \begin{macro}{\footinbib@sw}
472 % The boolean \cmd\footinbib@sw\ signifies that
473 % footnotes are to be set in the bibliography, as endnotes.
474 % \begin{macrocode}
475 \appdef\class@inithook{%
476 \@ifxundefined\footinbib@sw{\@booleanfalse\footinbib@sw}{}%
477 }%
478 % \end{macrocode}
479 % \end{macro}
480 %
481 % \begin{macro}{\preprintsty@sw}
482 % The boolean \cmd\preprintsty@sw\ signifies that
483 % the document is to be formatted in preprint style.
484 % \begin{macrocode}
485 \appdef\class@inithook{%
486 \@ifxundefined\preprintsty@sw{\@booleanfalse\preprintsty@sw}{}%
487 }%
488 % \end{macrocode}
489 % \end{macro}
490 %
491 % \begin{macro}{\preprint@sw}
492 % The boolean \cmd\preprint@sw\ signifies that
493 % the preprints (cf. \cmd\preprint) are to be formatted (usually on the title page).
494 % The default is to do so; the option \classoption{nopreprintnumbers}
495 % declares not to.
496 % \begin{macrocode}
497 \appdef\class@inithook{%
498 \@ifxundefined\preprint@sw{\@booleanfalse\preprint@sw}{}%
499 \preprintsty@sw{\@booleantrue\preprint@sw}{}%
500 }%
501 % \end{macrocode}
502 % \end{macro}
503 %
504 % \begin{macro}{\galley@sw}
505 % The boolean \cmd\galley@sw\ signifies that
506 % the document is to be formatted in galley style.
507 %
508 % Asserting both \cmd\galley@sw\ and \cmd\preprintsty@sw\
509 % may produce strange formatting results, but it is not illegal.
510 % However, it \emph{is} illegal to assert galley and any
511 % twocolumn option.
512 % \begin{macrocode}
513 \appdef\class@inithook{%
514 \@ifxundefined\galley@sw{\@booleanfalse\galley@sw}{}%
515 }%
516 % \end{macrocode}
517 % \end{macro}
518 %
519 % \begin{macro}{\groupauthors@sw}
520 % The flag \cmd\groupauthors@sw\ signifies that authors are to be grouped.
521 % This affects the meaning of \cmd\@author@present\ and \cmd\@tempaffil.
522 %
523 % FIXME: apparently \cmd\@tempaffil\ and its aliases are never used.
524 % \end{macro}
525 %
526 % \begin{macro}{\runinaddress@sw}
527 % The flag \cmd\runinaddress@sw\ signifies that author addresses are to be
528 % run in.
529 % \end{macro}
530 %
531 % \begin{macro}{\@affils@sw}
532 % If \cmd\@affils@sw\ is false, an address is never recognised as ``new''
533 % and is therefore always entered into the affiliation list,
534 % stopping groups of authors at the same address being amalgamated
535 % into the same list:
536 % the address will be printed the same number of times it is entered.
537 % \end{macro}
538 %
539 % \begin{macro}{\showPACS@sw}
540 % \begin{macro}{\showKEYS@sw}
541 % If \cmd\showPACS@sw\ is true, print the PACS information in the title block,
542 % otherwise not.
543 % Similarly for \cmd\showKEYS@sw\ and the keywords.
544 % \begin{macrocode}
545 \appdef\class@inithook{%
546 \@ifxundefined\showPACS@sw{\@booleanfalse\showPACS@sw}{}%
547 \@ifxundefined\showKEYS@sw{\@booleanfalse\showKEYS@sw}{}%
548 }%
549 % \end{macrocode}
550 % \end{macro}
551 % \end{macro}
552 %
553 % \begin{macro}{\floats@sw}
554 % The Boolean \cmd\floats@sw\ signifies that floats are to be floated;
555 % if false, that floats are to be deferred to the end of the document.
556 % By default, the former.
557 % Note that the state of this Boolean is to be changed by
558 % the document class in response to user-selected options.
559 %
560 % This boolean and the assignment of its default value is done by
561 % the \classname{ltxutil} package.
562 % \end{macro}
563 %
564 % \begin{macro}{\floatp@sw}
565 % The Boolean \cmd\floatp@sw\ signifies that endfloats are to be set one per page;
566 % if false, that endfloats are to be set with multiple floats per page permitted.
567 % By default, the latter.
568 % Note that the state of this Boolean is to be changed by
569 % the document class in response to user-selected options.
570 % The default is established here.
571 % \end{macro}
572 %
573 % \begin{macro}{\twoside@sw}
574 % The flag \cmd\twoside@sw\ signifies that the document is to be
575 % formatted for duplex printing.
576 % At \cmd\AtBeginDocument\ time, we must align the value
577 % of the kernel \cmd\newif\ switch \cmd\if@twoside\
578 % to that of \cmd\twoside@sw.
579 % \begin{macrocode}
580 \appdef\class@inithook{%
581 \@ifxundefined\twoside@sw{\@booleanfalse\twoside@sw}{}%
582 \twoside@sw{\@twosidetrue}{\@twosidefalse}%
583 }%
584 % \end{macrocode}
585 % \end{macro}
586 %
587 % \begin{macro}{\draft@sw}
588 % The flag \cmd\draft@sw\ signifies that the document is to be
589 % formatted in draft mode.
590 % Certain packages may pay attention to the
591 % class option \classoption{draft} that sets this Boolean.
592 % \begin{macrocode}
593 \appdef\class@inithook{%
594 \@ifxundefined\draft@sw{\@booleanfalse\draft@sw}{}%
595 \draft@sw{\overfullrule 5\p@}{\overfullrule\z@}%
596 }%
597 % \end{macrocode}
598 % \end{macro}
599 %
600 % \begin{macro}{\tightenlines@sw}
601 % The boolean \cmd\tightenlines@sw\ signifies that
602 % the leading is to be made standard amount.
603 % If false, it means that the leading is to be set extra open.
604 % Has no effect on 10pt size option.
605 % \begin{macrocode}
606 \appdef\class@inithook{%
607 \@ifxundefined\tightenlines@sw{\@booleanfalse\tightenlines@sw}{}%
608 }%
609 % \end{macrocode}
610 % \end{macro}
611 %
612 % \begin{macro}{\lengthcheck@sw}
613 % The flag \cmd\lengthcheck@sw\ signifies that
614 % the length checking is in effect.
615 % It is up to the individual journal substyle
616 % to alter its formatting accordingly.
617 % \begin{macrocode}
618 \appdef\class@inithook{%
619 \@ifxundefined\lengthcheck@sw{\@booleanfalse\lengthcheck@sw}{}%
620 }%
621 % \end{macrocode}
622 % \end{macro}
623 %
624 % \begin{macro}{\eqsecnum@sw}
625 % The flag \cmd\eqsecnum@sw\ signifies that equations are to be
626 % numbered with the section, e.g., ``Eq. (2.13)''.
627 % This flag is neither set nor queried.
628 % \begin{macrocode}
629 \appdef\class@inithook{%
630 \@ifxundefined\eqsecnum@sw{\@booleanfalse\eqsecnum@sw}{}%
631 \eqsecnum@sw{%
632 \@addtoreset{equation}{section}%
633 \def\theequation@prefix{\arabic{section}.}%
634 }{}%
635 }%
636 % \end{macrocode}
637 % \end{macro}
638 %
639 % \begin{macro}{\byrevtex@sw}
640 % The flag \cmd\byrevtex@sw\ signifies that the document should
641 % bear an imprint to the effect that it was formatted by this document class.
642 % \begin{macrocode}
643 \appdef\class@inithook{%
644 \@ifxundefined\byrevtex@sw{\@booleanfalse\byrevtex@sw}{}%
645 }%
646 % \end{macrocode}
647 % \end{macro}
648 %
649 %
650 % \subsection{Declare Options}%
651 %
652 % \subsubsection{Checkin: for Editorial Use}%
653 % A document class option declaring that the document is being processed by the
654 % editorial staff.
655 %
656 % This option should:
657 % \begin{itemize}
658 % \item
659 % put date in footer along with folio
660 % \item
661 % Have the effect of selecting the \classoption{preprint} class option.
662 % \item
663 % Have the effect of selecting the \classoption{showpacs} class option.
664 % \item
665 % specify that when a float is placed h or H, it will be allowed to break over pages.
666 % (Note: be sure that if the enclosed \env{tabular} has an optional argument, you change it to [v], or remove it entirely.)
667 % \end{itemize}
668 % \changes{v4.0beta 3}{1999/11/13}
669 % {New option ``checkin''}
670 % \begin{macrocode}
671 \DeclareOption{checkin}{%
672 \@booleantrue\dateinRH@sw
673 \@booleantrue\preprintsty@sw
674 \def\@pointsize{12}%
675 \@booleantrue\showPACS@sw
676 \@booleantrue\showKEYS@sw
677 \def\fp@proc@h{\allow@breaking@tables}%
678 \def\fp@proc@H{\allow@breaking@tables}%
679 }%
680 \@booleanfalse\dateinRH@sw
681 \def\checkindate{\dateinRH@sw{{\tiny(\today)}}{}}%
682 \def\allow@breaking@tables{%
683 \def\array@default{v}% tabular can break over pages
684 \@booleanfalse\floats@sw % table can break over pages
685 }%
686 % \end{macrocode}
687 %
688 % \subsubsection{Preprint Style}%
689 % \changes{v4.d}{1998/01/31}
690 % {Rearrange the ordering so numerical ones come first. AO: David, what does this mean?}
691 %
692 % \changes{v4.g}{1998/06/10}
693 % {comma not space between email and homepage}
694 %
695 % \changes{v4.0beta 2}{1999/06/20}
696 % {Move this ``complex'' option to the front, where it can be overridden by ``simple'' options.}
697 % \begin{macrocode}
698 \DeclareOption{preprint}{%
699 \@booleantrue\preprintsty@sw
700 \def\@pointsize{12}%
701 }%
702 \DeclareOption{manuscript}{%
703 \class@warn{Document class option manuscript is obsolete; use preprint instead}%
704 \ExecuteOptions{preprint}%
705 }%
706 % \end{macrocode}
707 %
708 % \subsubsection{Showing PACS and keywords}%
709 % \changes{v4.0beta 2}{1999/06/20}
710 % {New option}
711 % \changes{v4.0beta 5}{2000/09/20}
712 % {New option showkeys}
713 % \begin{macrocode}
714 \DeclareOption{showpacs}{%
715 \@booleantrue\showPACS@sw
716 }%
717 \DeclareOption{noshowpacs}{%
718 \@booleanfalse\showPACS@sw
719 }%
720 \DeclareOption{showkeys}{%
721 \@booleantrue\showKEYS@sw
722 }%
723 \DeclareOption{noshowkeys}{%
724 \@booleanfalse\showKEYS@sw
725 }%
726 % \end{macrocode}
727 %
728 % \subsubsection{Balance the last page when in two-column page grid}%
729 % If we are in a two-column page grid, we may wish to balance the columns
730 % of the last page. This will be done automatically if the
731 % \classoption{twocolumn} document class option is chosen.
732 % This action will be turned off by the \classoption{nobalancelastpage}.
733 % A complementary class option, \classoption{balancelastpage} is also provided.
734 % \begin{macrocode}
735 \DeclareOption{balancelastpage}{%
736 \@booleantrue\balancelastpage@sw
737 }%
738 \DeclareOption{nobalancelastpage}{%
739 \@booleanfalse\balancelastpage@sw
740 }%
741 \appdef\class@inithook{%
742 \@ifxundefined\balancelastpage@sw{%
743 \@booleantrue\balancelastpage@sw
744 }{}%
745 }%
746 % \end{macrocode}
747 %
748 % \subsubsection{Showing preprint numbers}%
749 % \changes{v4.0beta 4}{2000/04/10}
750 % {New option}
751 % \begin{macrocode}
752 \DeclareOption{nopreprintnumbers}{\@booleanfalse\preprint@sw}%
753 \DeclareOption{preprintnumbers}{\@booleantrue\preprint@sw}%
754 % \end{macrocode}
755 %
756 % \subsubsection{Hypertext Option}%
757 %
758 % \changes{v4.e}{1998/01/31}
759 % {protect against hyperref revtex kludges which are not needed now}
760 % \changes{v4.0beta 2}{1999/06/20}
761 % {Move this ``complex'' option to the front, where it can be overridden by ``simple'' options.}
762 % \changes{v4.0rc4}{2001/07/23}
763 % {hyperref is no longer loaded via class option: use a usepackage statement instead}
764 % \begin{macrocode}
765 \DeclareOption{hyperref}{%
766 %\AtEndOfClass{%
767 % \begingroup
768 % \edef\@tempa{%
769 % \let
770 % \noexpand\@clsextension
771 % \noexpand\@empty
772 % \noexpand\RequirePackage{hyperref}%
773 % \def\noexpand
774 % \@clsextension{\@clsextension}%
775 % }%
776 % \expandafter
777 % \endgroup
778 % \@tempa
779 %}%
780 % \end{macrocode}
781 %
782 % If you have a hyper-foo enabled browser you may prefer this format
783 % which does not print the URL for the home page, but just makes the
784 % name a link, but by default print it so it works on paper.
785 % \changes{v4.e}{1998/01/31}
786 % {print homepage}
787 %
788 % \begin{macrocode}
789 % \def\@pointsize{10}%
790 \class@warn{Class option "hyperref" is no longer supported.^^JEmploy \string\usepackage{hyperref} instead}%
791 }%
792 % \end{macrocode}
793 %
794 % \subsubsection{Type Size}%
795 % Use \cmd\@pointsize|=10| rather than \cmd\@ptsize|=0| to allow easy extensions
796 % to 9pt or whatever.
797 % Note: the three alternatives are mutually exclusive. Furthermore
798 % if \cmd\@pointsize\ is still undefined at \cmd\AtEndOfClass\ time,
799 % then the substyle can conclude that the user accepts the default.
800 % \begin{macrocode}
801 \DeclareOption{10pt}{\def\@pointsize{10}}
802 \DeclareOption{11pt}{\def\@pointsize{11}}
803 \DeclareOption{12pt}{\def\@pointsize{12}}
804 % \end{macrocode}
805 %
806 % \subsubsection{Media Size}%
807 % \changes{v4.0beta 2}{1999/06/20}
808 % {Restore all media size class option of \protect\file{classes.dtx}}
809 % \begin{macrocode}
810 \DeclareOption{a4paper}
811 {\setlength\paperheight {297mm}%
812 \setlength\paperwidth {210mm}}
813 \DeclareOption{a5paper}
814 {\setlength\paperheight {210mm}%
815 \setlength\paperwidth {148mm}}
816 \DeclareOption{b5paper}
817 {\setlength\paperheight {250mm}%
818 \setlength\paperwidth {176mm}}
819 \DeclareOption{letterpaper}
820 {\setlength\paperheight {11in}%
821 \setlength\paperwidth {8.5in}}
822 \DeclareOption{legalpaper}
823 {\setlength\paperheight {14in}%
824 \setlength\paperwidth {8.5in}}
825 \DeclareOption{executivepaper}
826 {\setlength\paperheight {10.5in}%
827 \setlength\paperwidth {7.25in}}
828 \DeclareOption{landscape}
829 {\setlength\@tempdima {\paperheight}%
830 \setlength\paperheight {\paperwidth}%
831 \setlength\paperwidth {\@tempdima}}
832 % \end{macrocode}
833 %
834 % \subsubsection{Bibnotes}%
835 % Frontmatter footnotes result from frontmatter commands like
836 % \cmd\email, \cmd\homepage, \cmd\altaffiliation, and \cmd\thanks.
837 % The default for \cmd\frontmatter@footnote@produce\ is
838 % \cmd\frontmatter@footnote@produce@footnote, which formats the frontmatter footnotes
839 % at the foot of the title page. The \classoption{bibnotes} class option
840 % defers them to the bibliography.
841 % \begin{macrocode}
842 \DeclareOption{bibnotes}{\@booleantrue\bibnotes@sw}%
843 \DeclareOption{nobibnotes}{\@booleanfalse\bibnotes@sw}%
844 \appdef\class@enddocumenthook{\auto@bib}%
845 \appdef\class@inithook{%
846 \@ifxundefined\bibnotes@sw{\@booleanfalse\bibnotes@sw}{}%
847 \bibnotes@sw{%
848 \let\frontmatter@footnote@produce\frontmatter@footnote@produce@endnote
849 }{%
850 \let\frontmatter@footnote@produce\frontmatter@footnote@produce@footnote
851 }%
852 }%
853 % \end{macrocode}
854 %
855 % \subsubsection{Footinbib}%
856 % \begin{macrocode}
857 \DeclareOption{footinbib}{\@booleantrue\footinbib@sw}
858 \DeclareOption{nofootinbib}{\@booleanfalse\footinbib@sw}
859 % \end{macrocode}
860 %
861 % \subsubsection{altaffilletter}%
862 %
863 % \begin{macrocode}
864 \DeclareOption{altaffilletter}{\@booleantrue\altaffilletter@sw}%
865 \DeclareOption{altaffilsymbol}{\@booleanfalse\altaffilletter@sw}%
866 \appdef\class@inithook{%
867 \@ifxundefined\altaffilletter@sw{\@booleanfalse\altaffilletter@sw}{}%
868 }%
869 % \end{macrocode}
870 %
871 % \subsubsection{superbib}%
872 % The document may invoke superscript bibliography style.
873 % If not, the journal substyle may make a selection.
874 % If neither, the class itself selects a default.
875 % This is really a quite deep nesting of defaults.
876 % \begin{macrocode}
877 \DeclareOption{superbib}{%
878 \def\place@bibnumber{\place@bibnumber@sup}%
879 }%
880 % \end{macrocode}
881 %
882 % \subsubsection{citeautoscript}%
883 % This class option allows you to automatically accomodate a change from non-superscripted, numbered references
884 % to superscripted, bunmbered references.
885 %
886 % Note: you should always mark up your document with the assumption that references are \emph{not} going to be superscripted.
887 % Otherwise this option has no hope of working properly.
888 %
889 % \begin{macrocode}
890 \DeclareOption{citeautoscript}{%
891 \@booleantrue\citeautoscript@sw
892 }%
893 \@booleanfalse\citeautoscript@sw
894 % \end{macrocode}
895 %
896 % \subsubsection{Simplex/Duplex Pages}%
897 % \changes{v4.e}{1998/01/31}
898 % {4.d had twoside option setting twoside switch to false}
899 % The complementary options \classoption{twoside} and \classoption{oneside}
900 % assert formatting for duplex or simplex printing, respectively.
901 % At the same time, we arrange for the selection of the page grid
902 % with respect to the marginal column:
903 % Because \cmd\if@reversemargin\ remains default (false),
904 % if duplex printing, this column will always be on the (right),
905 % if simplex printing, it will always be on the (outside).
906 % QUERY: correct choice?
907 % \begin{macrocode}
908 \DeclareOption{twoside}{\@booleantrue\twoside@sw \@mparswitchfalse}
909 \DeclareOption{oneside}{\@booleanfalse\twoside@sw\@mparswitchtrue}
910 % \end{macrocode}
911 %
912 % \subsubsection{Two-Column Page Grid}%
913 %
914 % \begin{macro}{\twocolumn@sw}
915 % The flag \cmd\twocolumn@sw\ signifies that the document is to be
916 % formatted in the two-column page grid.
917 %
918 % If no options relating to page grid are invoked by
919 % \cmd\AtBeginDcoument\ time, we set default values.
920 % Up to that point, the class can check if \cmd\twocolumn@sw\
921 % is \cmd\undefined\ to see if any related options have been invoked.
922 %
923 % At \cmd\AtBeginDocument\ time, we must align the value
924 % of the kernel \cmd\newif\ switch \cmd\if@twocolumn\
925 % to that of \cmd\twocolumn@sw.
926 %
927 % We install into \cmd\class@enddocumenthook\
928 % all tasks that we know must be completed at \cmd\AtEndDocument\ time.
929 % The first thing it does is end the current paragraph.
930 % The last is
931 % to return us to one-column page grid.
932 % (This task is installed as late as possible,
933 % i.e., after items like \cmd\printtables.)
934 % \begin{macrocode}
935 \AtEndOfClass{%
936 \def\clear@document{%
937 \close@column
938 }%
939 \appdef\class@inithook{%
940 \@ifxundefined\close@column{%
941 \let\close@column\close@column@default
942 }{}%
943 }%
944 }%
945 % \end{macrocode}
946 % \end{macro}
947 %
948 % The \classoption{twocolumn} class option employs the standard mechanism for
949 % changing the column grid: the \classname{ltxgrid} package.
950 % \begin{macrocode}
951 \DeclareOption{twocolumn}{%
952 \@booleantrue\twocolumn@sw
953 }%
954 % \end{macrocode}
955 %
956 % \classoption{onecolumn} specifies one-column page grid.
957 % \begin{macrocode}
958 \DeclareOption{onecolumn}{%
959 \@booleanfalse\twocolumn@sw
960 }%
961 % \end{macrocode}
962 %
963 % \classoption{galley} emulates setting the galleys of
964 % a two-column journal.
965 % FIXME: this option should effectively set \cmd\preprintsty@sw\ false.
966 % NOTE: it makes no sense to assert both galley and twocolumn.
967 %
968 % \begin{macrocode}
969 \DeclareOption{galley}{%
970 \ExecuteOptions{onecolumn}%
971 \@booleantrue\galley@sw
972 \appdef\set@pica@hook{%
973 \advance\textwidth-\columnsep
974 \textwidth.5\textwidth
975 }%
976 }%
977 % \end{macrocode}
978 %
979 %
980 % \subsubsection{raggedbottom or flushbottom}%
981 % The class options \classoption{raggedbottom} and \classoption{flushbottom} determine whether the columns (page)
982 % are ragged bottom or flush bottom.
983 % Note that we do not select a default here; that is done by the journal substyle.
984 % \begin{macrocode}
985 \DeclareOption{raggedbottom}{\@booleantrue\raggedcolumn@sw}
986 \DeclareOption{flushbottom}{\@booleanfalse\raggedcolumn@sw}
987 % \end{macrocode}
988 %
989 % \subsubsection{tightenlines}%
990 % This class option specifies that standard leading
991 % is to be used to set the type.
992 % If lacking, the leading will be loose.
993 %
994 % \begin{macrocode}
995 \DeclareOption{tightenlines}{\@booleantrue\tightenlines@sw}
996 % \end{macrocode}
997 %
998 % \subsubsection{lengthcheck}%
999 % This class option specifies that the formatted document
1000 % should approach as closely as possible the
1001 % formatting of an actual journal article
1002 % to facilitate the author's performance of a length check.
1003 %
1004 % \begin{macrocode}
1005 \DeclareOption{lengthcheck}{%
1006 \@booleantrue\lengthcheck@sw
1007 \@booleantrue\twoside@sw
1008 \@booleantrue\twocolumn@sw
1009 }%
1010 % \end{macrocode}
1011 %
1012 % \subsubsection{Draft and Final}%
1013 % \begin{macrocode}
1014 \DeclareOption{draft}{%
1015 \@booleantrue\draft@sw
1016 }%
1017 \DeclareOption{final}{%
1018 \@booleanfalse\draft@sw
1019 }%
1020 % \end{macrocode}
1021 %
1022 % \subsubsection{eqsecnum}%
1023 % The \classoption{eqsecnum} class option signifies that equations are
1024 % to be numbered within sections.
1025 % \begin{macrocode}
1026 \DeclareOption{eqsecnum}{\@booleantrue\eqsecnum@sw}
1027 % \end{macrocode}
1028 %
1029 % \subsubsection{secnumarabic}%
1030 % The \classoption{secnumarabic} class option signifies that sectioning commands are
1031 % to be numbered arabic.
1032 % \begin{macrocode}
1033 \DeclareOption{secnumarabic}{\@booleantrue\secnumarabic@sw}
1034 % \end{macrocode}
1035 % The code that polls the Boolean \cmd\secnumarabic@sw\ appears
1036 % in Section~\ref{sec:secnumarabic}.
1037 %
1038 % FIXME: model fleqn after amsfonts. I no longer understand why I said this.
1039 % \begin{macrocode}
1040 \DeclareOption{fleqn}{\input{fleqn.clo}}
1041 % \end{macrocode}
1042 %
1043 % \subsubsection{floats/endfloats}%
1044 % These options control, via the Boolean \cmd\floats@sw,
1045 % whether floats are to be migrated to the end of the document.
1046 % \begin{macrocode}
1047 \DeclareOption{floats}{\@booleantrue\floats@sw\@booleanfalse\floatp@sw}
1048 \DeclareOption{endfloats}{\@booleanfalse\floats@sw\@booleanfalse\floatp@sw}
1049 \DeclareOption{endfloats*}{\@booleanfalse\floats@sw\@booleantrue\floatp@sw}
1050 \appdef\class@inithook{%
1051 \@ifxundefined\floats@sw{\@booleantrue\floats@sw}{}%
1052 \@ifxundefined\floatp@sw{\@booleantrue\floatp@sw}{}%
1053 }%
1054 % \end{macrocode}
1055 %
1056 % \subsubsection{titlepage/notitlepage}%
1057 % These options control, via \cmd\titlepage@sw,
1058 % whether the title block is to be set on a separate page.
1059 % \begin{macro}{\titlepage@sw}
1060 % The flag \cmd\titlepage@sw\ signifies that a forced
1061 % page break is to follow the title page: the article
1062 % title appears on a page by itself.
1063 %
1064 % The Boolean \cmd\titlepage@sw\ is in an odd situation:
1065 % its value is set by one or more substyles, contingent
1066 % upon the value of another Boolean.
1067 % Therefore that code must be invoked at \cmd\AtBeginDocument\ time.
1068 % Therefore we must assign the default value at the very end
1069 % of \cmd\AtBeginDocument\ processing: we use \cmd\defaults@hook.
1070 % Luckily, this Boolean does not need to be queried at
1071 % \cmd\AtBeginDocument\ time, or we'd be in dire straights.
1072 % \begin{macrocode}
1073 \DeclareOption{titlepage}{\@booleantrue\titlepage@sw}
1074 \DeclareOption{notitlepage}{\@booleanfalse\titlepage@sw}
1075 \appdef\defaults@hook{%
1076 \@ifxundefined\titlepage@sw{\@booleanfalse\titlepage@sw}{}%
1077 }%
1078 % \end{macrocode}
1079 % \end{macro}
1080 %
1081 % \subsubsection{Substyle and Sub-substyle}%
1082 %
1083 % If the society has already been assigned,
1084 % notify user that \cmd\@society\ is being overridden.
1085 %
1086 % \begin{macrocode}
1087 \def\change@society#1{%
1088 \def\@tempa{#1}%
1089 \@ifxundefined\@society{}{%
1090 \@ifx{\@tempa\@society}{}{%
1091 \class@warn{Conflicting society \@tempa<>\@society.}%
1092 }%
1093 }%
1094 \let\@society\@tempa
1095 }%
1096 % \end{macrocode}
1097 % Here are the class options relating to the APS
1098 % \begin{macrocode}
1099 \DeclareOption{aps}{\change@society{aps}\def\@journal{}}%
1100 \DeclareOption{pra}{\change@society{aps}\def\@journal{pra}}%
1101 \DeclareOption{prb}{\change@society{aps}\def\@journal{prb}}%
1102 \DeclareOption{prc}{\change@society{aps}\def\@journal{prc}}%
1103 \DeclareOption{prd}{\change@society{aps}\def\@journal{prd}}%
1104 \DeclareOption{pre}{\change@society{aps}\def\@journal{pre}}%
1105 \DeclareOption{prl}{\change@society{aps}\def\@journal{prl}}%
1106 \DeclareOption{prstab}{\change@society{aps}\def\@journal{prstab}}%
1107 \DeclareOption{rmp}{\change@society{aps}\def\@journal{rmp}}%
1108 % \end{macrocode}
1109 % Here are the class options relating to the Optical Society of America
1110 % \begin{macrocode}
1111 \DeclareOption{osa}{\change@society{osa}\def\@journal{}}%
1112 \DeclareOption{osameet}{\change@society{osa}\def\@journal{osameet}}%
1113 \DeclareOption{opex}{\change@society{osa}\def\@journal{opex}}%
1114 \DeclareOption{tops}{\change@society{osa}\def\@journal{tops}}%
1115 \DeclareOption{josa}{\change@society{osa}\def\@journal{josa}}%
1116 % \end{macrocode}
1117 %
1118 % NOTE: \file{revguide.tex} does not mention any \cmd\@journal\ options
1119 % besides \classoption{prb}.
1120 %
1121 % \begin{macro}{amsfonts}
1122 % The class option \classoption{amsfonts} has the
1123 % same effect as if the document preamble contained
1124 % a \cmd\usepackage\verb${amsfonts}$ statement.
1125 % \begin{macrocode}
1126 \DeclareOption{amsfonts}{%
1127 \def\class@amsfonts{\RequirePackage{amsfonts}}%
1128 }%
1129 \DeclareOption{noamsfonts}{%
1130 \let\class@amsfonts\@empty
1131 }%
1132 \AtEndOfClass{%
1133 \@ifxundefined\class@amsfonts{}{\class@amsfonts}%
1134 }%
1135 % \end{macrocode}
1136 % \end{macro}
1137 %
1138 % \begin{macro}{amssymb}
1139 % The class option \classoption{amssymb} has the
1140 % same effect as if the document preamble contained
1141 % a \cmd\usepackage\verb${amssymb}$ statement.
1142 % \begin{macrocode}
1143 \DeclareOption{amssymb}{%
1144 \def\class@amssymb{\RequirePackage{amssymb}}%
1145 }%
1146 \DeclareOption{noamssymb}{%
1147 \let\class@amssymb\@empty
1148 }%
1149 \AtEndOfClass{%
1150 \@ifxundefined\class@amssymb{}{\class@amssymb}%
1151 }%
1152 % \end{macrocode}
1153 % \end{macro}
1154 %
1155 % \begin{macro}{amsmath}
1156 % The class option \classoption{amsmath} has the
1157 % same effect as if the document preamble contained
1158 % a \cmd\usepackage\verb${amsmath}$ statement.
1159 %
1160 % We require version 1.2 (datestamped 1997/03/20) or later.
1161 % The \expandafter\cmd\csname [email protected]\endcsname, will
1162 %
1163 % \LaTeX\ note:
1164 % Certain \LaTeX\ procedures have an arbitrary and pointless restriction that they may be used only within the preamble.
1165 % We get around this by preserving the procedures in private \cmd\csname s.
1166 %
1167 % FIXME note: it is difficult to ensure that an error summary will be printed on the console at the very end,
1168 % but \classname{ltxgrid} allows accomplishing this via an interrupt, put down at \cmd\AtEndDocument\ time.
1169 %
1170 % \begin{macrocode}
1171 \DeclareOption{amsmath}{%
1172 \def\class@amsmath{\RequirePackage{amsmath}[\ver@amsmath@prefer]}%
1173 }%
1174 \DeclareOption{noamsmath}{%
1175 \let\class@amsmath\@empty
1176 }%
1177 \AtEndOfClass{%
1178 \preserve@LaTeX
1179 \@ifxundefined\class@amsmath{}{\class@amsmath}%
1180 \appdef\class@enddocumenthook{\test@amsmath@ver}%
1181 }%
1182 \appdef\preserve@LaTeX{%
1183 \let\@ifl@aded@LaTeX\@ifl@aded
1184 \let\@ifpackageloaded@LaTeX\@ifpackageloaded
1185 \let\@pkgextension@LaTeX\@pkgextension
1186 \let\@ifpackagelater@LaTeX\@ifpackagelater
1187 \let\@ifl@ter@LaTeX\@ifl@ter
1188 \let\@ifl@t@r@LaTeX\@ifl@t@r
1189 \let\@parse@version@LaTeX\@parse@version
1190 }%
1191 \appdef\restore@LaTeX{%
1192 \let\@ifl@aded\@ifl@aded@LaTeX
1193 \let\@ifpackageloaded\@ifpackageloaded@LaTeX
1194 \let\@pkgextension\@pkgextension@LaTeX
1195 \let\@ifpackagelater\@ifpackagelater@LaTeX
1196 \let\@ifl@ter\@ifl@ter@LaTeX
1197 \let\@ifl@t@r\@ifl@t@r@LaTeX
1198 \let\@parse@version\@parse@version@LaTeX
1199 }%
1200 \def\test@amsmath@ver{%
1201 \begingroup
1202 \restore@LaTeX
1203 \@ifpackageloaded{amsmath}{%
1204 \@ifpackagelater{amsmath}{\ver@amsmath@prefer}{}{%
1205 \class@warn{%
1206 You have loaded amsmath, version "\csname [email protected]\endcsname",\MessageBreak
1207 but this class requires version "\ver@amsmath@prefer", or later.\MessageBreak
1208 Please update your LaTeX installation.
1209 }%
1210 }%
1211 }{%
1212 }%
1213 \endgroup
1214 }%
1215 \def\ver@amsmath@prefer{2000/01/15 v2.05 AMS math features}%
1216 % \end{macrocode}
1217 % \end{macro}
1218 %
1219 % \subsubsection{Presenting Authors and Their Affiliations}%
1220 % \changes{v4.0beta 2}{1999/06/20}
1221 % {These options are now mutually exclusive. But is this correct?}
1222 %
1223 % The \classoption{runinaddress} option is the only one that sets \cmd\runinaddress@sw\ to true.
1224 %
1225 % The \classoption{unsortedaddress} option is the only one that sets \cmd\@affils@sw\ to false.
1226 %
1227 % If we take the \classoption{groupedaddress} option as the default, then we can look upon
1228 % the \classoption{superscriptaddress} option as simply turning \cmd\groupauthors@sw\ to false.
1229 %
1230 % \classoption{groupedaddress}, the default, groups authors above a common address.
1231 % In order to assert the default and still provide for proper precedence
1232 % for document-supplied options, we carry out our action at \cmd\AtBeginDocument\ time,
1233 % and only if none of the related class options were invoked.
1234 % \begin{macrocode}
1235 \DeclareOption{groupedaddress}{\clo@groupedaddress}%
1236 \def\clo@groupedaddress{%
1237 \@booleantrue\groupauthors@sw
1238 \@booleantrue\@affils@sw
1239 \@booleanfalse\runinaddress@sw
1240 }%
1241 \appdef\class@inithook{%
1242 \@ifxundefined\groupauthors@sw{\clo@groupedaddress}{}%
1243 }%
1244 % \end{macrocode}
1245 %
1246 % \classoption{unsortedaddress} is similar to \classoption{groupedaddress},
1247 % but turns off \cmd\@affils@sw,
1248 % with the result that each address that is entered will be printed.
1249 % \begin{macrocode}
1250 \DeclareOption{unsortedaddress}{\clo@unsortedaddress}%
1251 \def\clo@unsortedaddress{%
1252 \@booleantrue\groupauthors@sw
1253 \@booleanfalse\@affils@sw
1254 \@booleanfalse\runinaddress@sw
1255 }%
1256 % \end{macrocode}
1257 %
1258 % \classoption{runinaddress} is similar to \classoption{groupedaddress},
1259 % with the addition of the Boolean \cmd\runinaddress@sw,
1260 % which causes the authors associated with a particular address group
1261 % to be formatted in a paragraph instead of on separate lines.
1262 % \begin{macrocode}
1263 \DeclareOption{runinaddress}{\clo@runinaddress}%
1264 \def\clo@runinaddress{%
1265 \@booleantrue\groupauthors@sw
1266 \@booleantrue\@affils@sw
1267 \@booleantrue\runinaddress@sw
1268 }%
1269 % \end{macrocode}
1270 %
1271 % \classoption{superscriptaddress} presents author affiliations
1272 % as superscripts. Authors with like affiliations share the same
1273 % superscript.
1274 %
1275 % FIXME: if \cmd\groupauthors@sw\ is false, would not \cmd\@affils@sw\ be a don't care?
1276 % \begin{macrocode}
1277 \DeclareOption{superscriptaddress}{\clo@superscriptaddress}%
1278 \def\clo@superscriptaddress{%
1279 \@booleanfalse\groupauthors@sw
1280 \@booleantrue\@affils@sw
1281 \@booleanfalse\runinaddress@sw
1282 }%
1283 % \end{macrocode}
1284 %
1285 %
1286 % \subsubsection{Typeset by \revtex}%
1287 %
1288 % The class option \classoption{byrevtex} signifies that you want the
1289 % ``Typeset by \revtex'' byline to appear on your formatted output.
1290 % By default, no such byline appears.
1291 % \begin{macrocode}
1292 \DeclareOption{byrevtex}{\@booleantrue\byrevtex@sw}%
1293 % \end{macrocode}
1294 %
1295 %
1296 % \subsection{Attempt to fix float placement failure}%
1297 %
1298 % \revtex\ uses the \classname{ltxgrid} package, which provides the ability to attempt repairs when
1299 % \LaTeX's float placement mechanism is about to fail, but that facility is turned off by default.
1300 % Users should invoke the \classoption{floatfix} document class option to enable this \LaTeX\ extension.
1301 % If not, a helpful message is printed in the log, indicating how to work around the difficulty.
1302 % \begin{macrocode}
1303 \DeclareOption{floatfix}{\@booleantrue\force@deferlist@sw}%
1304 \DeclareOption{nofloatfix}{\@booleanfalse\force@deferlist@sw}%
1305 \appdef\class@inithook{%
1306 \@ifxundefined\force@deferlist@sw{\@booleanfalse\force@deferlist@sw}{}%
1307 }%
1308 % \end{macrocode}
1309 %
1310 % \begin{macro}{\@fltovf}
1311 % \begin{macro}{\@fltstk}
1312 % The \LaTeX\ kernel error message \cmd\@fltovf\ may now be a bit more helpful to the user;
1313 % likewise for the \cmd\@fltstk\ message of \classname{ltxgrid}.
1314 % \begin{macrocode}
1315 \gdef\@fltovf{%
1316 \@latex@error{%
1317 Too many unprocessed floats%
1318 \force@deferlist@sw{}{; try class option [floatfix]}%
1319 }\@ehb
1320 }%
1321 \def\@fltstk{%
1322 \@latex@warning{%
1323 A float is stuck (cannot be placed)%
1324 \force@deferlist@sw{}{; try class option [floatfix]}%
1325 }%
1326 }%
1327 % \end{macrocode}
1328 % \end{macro}
1329 % \end{macro}
1330 %
1331 % \begin{macro}{\ltxgrid@info@sw}
1332 % \begin{macro}{\outputdebug@sw}
1333 % The two options \classoption{ltxgridinfo} and \classoption{outputdebug} turn on informative diagnostics within the
1334 % package \classname{ltxgrid}. Only people who really want to see this output will select these class options.
1335 % Consult documentation for the \classname{ltxgrid} package to see what output the related switches enable.
1336 % \begin{macrocode}
1337 \DeclareOption{ltxgridinfo}{\@booleantrue\ltxgrid@info@sw}%
1338 \DeclareOption{outputdebug}{\@booleantrue\outputdebug@sw}%
1339 % \end{macrocode}
1340 % \end{macro}
1341 % \end{macro}
1342 %
1343 % \subsection{Option to relax page height}%
1344 %
1345 % The \classname{ltxgrid} package can set text pages to their natural height or force them to the full
1346 % text height; the latter is the default.
1347 % If setting the pages with a variable length,
1348 % the running foot will move up or down with the natural length of the text column.
1349 % While I recommend against doing so, this option will turn that switch to the latter setting.
1350 % \begin{macrocode}
1351 \DeclareOption{raggedfooter}{\@booleanfalse\textheight@sw}%
1352 \DeclareOption{noraggedfooter}{\@booleantrue\textheight@sw}%
1353 % \end{macrocode}
1354 %
1355 % \subsection{Selecting procedure for processing abstract}%
1356 %
1357 % There are two different procedures for processing an abstract; the options
1358 % \classoption{newabstract} and \classoption{oldabstract} determine which one the user
1359 % prefers. At present, the default is to use the old, but this may change.
1360 % \begin{macrocode}
1361 \DeclareOption{newabstract}{\@booleanfalse\oldabstract@sw}%
1362 \DeclareOption{oldabstract}{\@booleantrue \oldabstract@sw}%
1363 \appdef\class@inithook{%
1364 \@ifxundefined\oldabstract@sw{\@booleanfalse\oldabstract@sw}{}%
1365 \oldabstract@sw{%
1366 \let@environment{abstract}{abstract-old}%
1367 }{}%
1368 }%
1369 % \end{macrocode}
1370 %
1371 %
1372 %
1373 %
1374 % \subsection{Default Option}%
1375 %
1376 % The default handling for a document class option is to
1377 % treat it as the name of a society and
1378 % hunt for a corresponding \file{.rtx} file to read in.
1379 % This behavior is much like the \LaTeX2.09 handling, where
1380 % one looked for a \file{.sty} file, except that
1381 % in this case, we must catch the case where multiple
1382 % unknown options are declared.
1383 %
1384 % \begin{macrocode}
1385 \DeclareOption*{%
1386 \IfFileExists{\CurrentOption\substyle@ext}{%
1387 \expandafter\change@society\expandafter{\CurrentOption}%
1388 }{%
1389 \OptionNotUsed
1390 }%
1391 }%
1392 \def\substyle@ext{.rtx}%
1393 \AtEndOfClass{%
1394 \@ifxundefined\@society{%
1395 \class@warn{No Society specified, using generic APS style}%
1396 \def\@society{aps}\def\@journal{}%
1397 }{}%
1398 \expandafter\input\expandafter{\@society\substyle@ext}%
1399 }%
1400 % \end{macrocode}
1401 %
1402 % \subsection{Class-Asserted Options}%
1403 % \changes{v4.0beta 2}{1999/06/20}
1404 % {%
1405 % Removed invocation of nonexistent class option \protect\classoption{groupauthors}
1406 % and all other class options that should only be invoked by the document.
1407 % (Otherwise precedence of class options does not work.)
1408 % }
1409 % Here we establish the default document class options.
1410 % Those of the document itself will override these.
1411 % \begin{macrocode}
1412 \ExecuteOptions{10pt}
1413 % \end{macrocode}
1414 %
1415 % \subsection{Execute Options}%
1416 % The document class options are processed in the order
1417 % they are declared in this document class file.
1418 %
1419 % Precedence is established in the following way:
1420 %
1421 % First, the single \file{.rtx} file is read in.
1422 % It may set values to any of the Booleans that represent class options,
1423 % and it may elect to do so only if that Boolean is undefined, signifying
1424 % that its corresponding document class options were absent from
1425 % the document's option list.
1426 % In this way correct precedence of class options is maintained.
1427 %
1428 % Second, the type size option is acted upon. Type size code
1429 % should not require altering the values of any of the Booleans carrying
1430 % class options.
1431 %
1432 % Next, at \cmd\AtEndOfClass\ time, certain packages are read in.
1433 %
1434 % Finally, at \cmd\AtBeginDocument\ time, the state of the Booleans determines
1435 % how the formatting will go.
1436 %
1437 % \begin{macrocode}
1438 \ProcessOptions\relax
1439 % \end{macrocode}
1440 %
1441 %
1442 % \section{Procedures Dependent Upon Options}
1443 %
1444 % Here we introduce \classname{classes.dtx} definitions for
1445 % the page styles that people will expect to be able to use.
1446 % \begin{macro}{\ps@headings}
1447 % \begin{macro}{\ps@myheadings}
1448 % \begin{macrocode}
1449 \def\ps@headings{%
1450 \let\@oddfoot\@empty\let\@evenfoot\@empty
1451 \def\@evenhead{\thepage\hfil\slshape\leftmark}%
1452 \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
1453 \let\@mkboth\markboth
1454 \def\sectionmark##1{%
1455 \markboth {\MakeUppercase{%
1456 \ifnum \c@secnumdepth >\z@
1457 \thesection\quad
1458 \fi
1459 ##1}}{}}%
1460 \def\subsectionmark##1{%
1461 \markright {%
1462 \ifnum \c@secnumdepth >\@ne
1463 \thesubsection\quad
1464 \fi
1465 ##1}}}%
1466 \def\ps@myheadings{%
1467 \let\@oddfoot\@empty\let\@evenfoot\@empty
1468 \def\@evenhead{\thepage\hfil\slshape\leftmark}%
1469 \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
1470 \let\@mkboth\@gobbletwo
1471 \let\sectionmark\@gobble
1472 \let\subsectionmark\@gobble
1473 }%
1474 % \end{macrocode}
1475 % \end{macro}
1476 % \end{macro}
1477 %
1478 % \begin{macro}{\ps@article@twoside}
1479 % \begin{macro}{\ps@article@oneside}
1480 % \begin{macro}{\ps@preprint}
1481 % \changes{v4.e}{1998/01/31}
1482 % {Move after process options, so the following test works}
1483 % \changes{v4.0beta 2}{1999/06/20}
1484 % {Defer decision until \cs{AtBeginDocument} time}
1485 % \changes{v4.0beta 3}{1999/11/13}
1486 % {Insert procedure \cs{checkindate}}
1487 % \changes{v4.0rc1}{2001/06/17}
1488 % {Running headers always as if two-sided}
1489 % \begin{macrocode}
1490 \def\ps@article{%
1491 \@provide\@evenhead{\let\\\heading@cr\thepage\quad\checkindate\hfil{\leftmark}}%
1492 \@provide\@oddhead{\let\\\heading@cr{\rightmark}\hfil\checkindate\quad\thepage}%
1493 \@provide\@oddfoot{}%
1494 \@provide\@evenfoot{}%
1495 \let\@mkboth\markboth
1496 \let\sectionmark\@gobble
1497 \let\subsectionmark\@gobble
1498 }%
1499 \def\ps@article@final{%
1500 \@provide\@evenhead{\let\\\heading@cr\thepage\quad\checkindate\hfil{\leftmark}}%
1501 \@provide\@oddhead{\let\\\heading@cr{\rightmark}\hfil\checkindate\quad\thepage}%
1502 \@provide\@oddfoot{}%
1503 \@provide\@evenfoot{}%
1504 \let\@mkboth\markboth
1505 \def\sectionmark##1{%
1506 \markboth{%
1507 \MakeTextUppercase{%
1508 \@ifnum{\c@secnumdepth >\z@}{\thesection\hskip 1em\relax}{}%
1509 ##1%
1510 }%
1511 }{}%
1512 }%
1513 \def\subsectionmark##1{%
1514 \markright {%
1515 \@ifnum{\c@secnumdepth >\@ne}{\thesubsection\hskip 1em\relax}{}%
1516 ##1%
1517 }%
1518 }%
1519 }%
1520 \appdef\class@inithook{%
1521 %\twoside@sw{%
1522 %}{%
1523 %}%
1524 }%
1525 % \end{macrocode}
1526 %
1527 % \begin{macrocode}
1528 \def\heading@cr{\unskip\space\ignorespaces}%
1529 % \end{macrocode}
1530 %
1531 % \changes{v4.0beta 3}{1999/11/13}
1532 % {Do not put by REVTeX in every page foot}
1533 % \changes{v4.0beta 3}{1999/11/13}
1534 % {Insert procedure \cs{checkindate}}
1535 % \begin{macrocode}
1536 \def\ps@preprint{%
1537 \@provide\@oddfoot{\hfil\thepage\quad\checkindate\hfil}%
1538 \@provide\@evenfoot{\hfil\thepage\quad\checkindate\hfil}%
1539 \@provide\@oddhead{}%
1540 \@provide\@evenhead{}%
1541 \let\@mkboth\@gobbletwo
1542 \let\sectionmark\@gobble
1543 \let\subsectionmark\@gobble
1544 }%
1545 % \end{macrocode}
1546 %
1547 % \begin{macrocode}
1548 \let\@oddhead\@undefined
1549 \let\@evenhead\@undefined
1550 \let\@oddfoot\@undefined
1551 \let\@evenfoot\@undefined
1552 \AtEndOfClass{%
1553 \appdef\class@documenthook{%
1554 \@provide\@oddhead{}%
1555 \@provide\@evenhead{}%
1556 \@provide\@oddfoot{}%
1557 \@provide\@evenfoot{}%
1558 }%
1559 }%
1560 % \end{macrocode}
1561 % \end{macro}
1562 % \end{macro}
1563 % \end{macro}
1564 %
1565 % \begin{macro}{\lastpage@putlabel}
1566 % Support the default meaning of \cmd\@endpage.
1567 % \changes{v4.d}{1998/01/31}
1568 % {Move after process options, so \cs{clearpage} not in scope of
1569 % twocolumn}
1570 % Name of this macro (and the \cmd\label\ key) taken from
1571 % \url{CTAN:/macros/latex/contrib/other/lastpage}%
1572 % with code optimised slightly.
1573 % \begin{macrocode}
1574 \def\lastpage@putlabel{%
1575 \if@filesw
1576 \begingroup
1577 \advance\c@page\m@ne
1578 \immediate\write\@auxout{\string\newlabel{LastPage}{{}{\thepage}}}%
1579 \endgroup
1580 \fi
1581 }%
1582 % \end{macrocode}
1583 % Install a late hook into \cmd\class@enddocumenthook\ that
1584 % labels the last page of the document.
1585 % This is done just before the \file{.aux} file
1586 % is closed, and does not require a \cmd\shipout, because it writes
1587 % directly to the \file{.aux} file.
1588 % Note that we invoke \cmd\clearpage: this means that no more typesetting
1589 % should be done past this point.
1590 % CHECKME: are there any more things installed via
1591 % \cmd\AtEndOfClass\allowbreak\cmd\class@enddocumenthook?
1592 % \begin{macrocode}
1593 \AtEndOfClass{%
1594 \appdef\clear@document{%
1595 \clearpage
1596 \lastpage@putlabel
1597 }%
1598 }%
1599 % \end{macrocode}
1600 % \end{macro}
1601 %
1602 %
1603 % \section{Required Packages}
1604 % \url{CTAN:macros/latex/contrib/other/misc/url.sty}%
1605 % \begin{macrocode}
1606 \RequirePackage{url}%
1607 % \end{macrocode}
1608 %
1609 % \section{Incompatible Packages}
1610 % Known to be incompatible are \classname{multicol} and \classname{cite}.
1611 % The former is incompatible with \classname{ltxgrid}, which replaces it.
1612 % The latter is incompatible with \classname{natbib}, which replaces its functionality.
1613 % \begin{macrocode}
1614 \appdef\class@inithook{%
1615 \incompatible@package{cite}%
1616 \incompatible@package{multicol}%
1617 }%
1618 % \end{macrocode}
1619 %
1620 % \section{Society- and Journal-Specific Code}
1621 %
1622 % \begin{macro}{\@journal}
1623 % Journal test helper, used as
1624 % \begin{verbatim}
1625 %\@ifx{\@journal\journal@pra}{%
1626 % <journal-specific setup>
1627 %\fi
1628 % \end{verbatim}
1629 % Journal code might like to further specify (if as yet undefined) or distinguish on
1630 % the following Booleans.
1631 %
1632 % Note: the journal substyle code should only alter the value of one of these Booleans if
1633 % the Boolean is \cmd\undefined. This convention is what makes the document's
1634 % options take precedence over the values set by the journal.
1635 %
1636 % FIXME: make this table an exhaustive listing of all the parameters set by
1637 % the class options.
1638 %
1639 % \begin{tabular}{ll}
1640 % \cmd\@pointsize &(10|11|12), depending on the type size\\
1641 % \cmd\footinbib@sw &true if footnotes are to be formatted in the bibliography\\
1642 % \cmd\preprintsty@sw &true for preprint and hyperpreprint\\
1643 % \cmd\eqsecnum@sw &true means that equations are numbered within sections\\
1644 % \cmd\secnumarabic@sw &true means the sections are to be numbered arabic\\
1645 % \cmd\groupauthors@sw &true means authors listed separately for each address\\
1646 % \cmd\preprint@sw &true means to produce the preprint numbers as part of the title block\\
1647 % \cmd\showPACS@sw &true means to produce the PACS as part of the title block\\
1648 % \cmd\showKEYS@sw &true means to produce the keywords as part of the title block\\
1649 % \cmd\@affils@sw &true means each affiliation is printed, for each author\\
1650 % \cmd\runinaddress@sw &true means author addresses are printed run-in\\
1651 % \cmd\draft@sw &true implies that PACS will be printed\\
1652 % \cmd\tightenlines@sw &true if preprint single spaced\\
1653 % \cmd\lengthcheck@sw &true if length checking is in effect\\
1654 % \cmd\byrevtex@sw &true means to announce ``typeset by \revtex''\\
1655 % \cmd\titlepage@sw &true for title is to be set on a separate page\\
1656 % \cmd\twocolumn@sw &true if two-column page grid\\
1657 % \cmd\twocolumn@sw &true if we are to automatically balance the columns of the last page\\
1658 % \cmd\twoside@sw &true means to format pages for duplex printing\\
1659 % \cmd\floats@sw &false means floats are migrated to end of document\\
1660 % \cmd\floatp@sw &true means endfloats are set one to a page\\
1661 % \cmd\class@amsfonts &if \cmd\@empty, means that \classname{amsfonts} will \emph{not} be loaded\\
1662 % \cmd\class@amssymb &if \cmd\@empty, means that \classname{amssymb} will \emph{not} be loaded\\
1663 % \cmd\frontmatter@footnote &if \cmd\undefined, means that the default (\cmd\footnote) will be used\\
1664 % \cmd\place@bibnumber &if \cmd\undefined, means that the default (inline) will be used\\
1665 % \end{tabular}
1666 %
1667 % Note: if \cmd\twocolumn@sw\ and \cmd\preprintsty@sw\ are both false,
1668 % then `galley' style is in effect. The \classoption{galley} option invokes
1669 % \classoption{onecolumn}, but does not affect the \cmd\preprintsty@sw.
1670 %
1671 % Note: \cmd\paperwidth\ and \cmd\paperheight\ are not integrated into this scheme,
1672 % and should be selected by the document alone.
1673 % \end{macro}
1674 %
1675 %
1676 % \section{Front Matter}
1677 %
1678 % \subsection{The title command}%
1679 %
1680 % \begin{macro}{\title}
1681 % \begin{macro}{\do@title}
1682 % The author uses \cmd\title\ to specify the title. As in the AMS
1683 % classes, \cmd\title\ has an optional argument specifying a short form
1684 % for use in running heads.
1685 %
1686 % Once the \cmd\title\ is given, you can specify any combination of
1687 % \cmd\thanks, \cmd\email, \cmd\homepage, and \cmd\altaffiliation\ commands,
1688 % applying to the title of the document.
1689 % \begin{macrocode}
1690 \renewcommand\title[2][]{%
1691 \def\@title{#2}%
1692 \def\@shorttitle{#1}%
1693 \let\@AF@join\@title@join
1694 }%
1695 % \end{macrocode}
1696 % \end{macro}
1697 % \end{macro}
1698 %
1699 % \begin{macro}{\@title}
1700 % \begin{macro}{\@shorttitle}
1701 % The arguments to \cmd\title\ are saved in these internal
1702 % macros, which are set up to produce a warning if \cmd\title\ has not
1703 % been used before \cmd\maketitle.
1704 % \begin{macrocode}
1705 \appdef\class@inithook{%
1706 \def\@title{\class@warn{No title}}%
1707 \let\@shorttitle\@empty
1708 \let\@title@aux\@title@aux@cleared
1709 }%
1710 % \end{macrocode}
1711 % \end{macro}
1712 % \end{macro}
1713 %
1714 % \begin{macro}{\@title@join}
1715 % \begin{macro}{\@title@join@}
1716 % \begin{macro}{\@title@aux@cleared}
1717 %
1718 % \begin{macrocode}
1719 \def\@title@join{\expandafter\@title@join@\@title@aux}%
1720 \def\@title@join@#1#2{%
1721 \def\@title@aux{{\@join{\@separator}{#1}{#2}}}%
1722 }%
1723 \def\@title@aux@cleared{{}}%
1724 % \end{macrocode}
1725 % \end{macro}
1726 % \end{macro}
1727 % \end{macro}
1728 %
1729 %
1730 % \subsection{The author, affiliation, and related commands}%
1731 %
1732 % \begin{macro}{\c@affil}
1733 % A counter to store the affiliation numbers used for the
1734 % superscript marks. This command defines \cmd\theaffil.
1735 % \begin{macrocode}
1736 \newcounter{affil}
1737 % \end{macrocode}
1738 % \end{macro}
1739 %
1740 % \subsubsection{Commands for author or collaboration}%
1741 %
1742 % \begin{macro}{\author}
1743 % Each author is given in a \emph{separate} \cmd\author\ command.
1744 % This is similar to the AMS classes, but the AMS also try to support
1745 % the \classname{article} class's \cmd\and\ command for putting multiple
1746 % authors in one \cmd\author\ command.
1747 % \revtex, however, does not support the \cmd\and\ command.
1748 %
1749 % When the \cmd\author\ command is encountered, the previous author, author group, affiliation, and affiliation group are at an end.
1750 % This procedure moves the previous author to the author group (\cmd\move@AU),
1751 % moves the previous affiliation to the affiliation group (\cmd\move@AF),
1752 % and terminates the previous author/affiliation group (\cmd\move@AUAF) as the case may require.
1753 % \begin{macrocode}
1754 \renewcommand\author{% implicit #1
1755 \@author@def{}% implicit #2
1756 }%
1757 % \end{macrocode}
1758 % \end{macro}
1759 %
1760 % \begin{macro}{\collaboration}
1761 % \begin{macro}{\@collaboration@}
1762 % Specify the collaboration (given after a group of authors).
1763 %
1764 % This procedure does exactly what \cmd\author\ does, and sets
1765 % a flag signifying that the \cmd\collaboration\ command was given.
1766 %
1767 % Note: earlier versions attempted to ignore the collaboration command if it was considered inappropriate.
1768 % We must not do this, however, because it throws the state machine out of kilter.
1769 % \begin{macrocode}
1770 \def\collaboration{% implicit #1
1771 \groupauthors@sw{%
1772 \class@warn{%
1773 \string\collaboration\space is only allowed with superscriptaddress option.
1774 Use superscriptaddress in place of groupedaddress, unsortedaddress, or runinaddress%
1775 }%
1776 }{}%
1777 \@author@def{\@booleantrue\collaboration@sw}% implicit #2
1778 }%
1779 % \end{macrocode}
1780 % \end{macro}
1781 % \end{macro}
1782 %
1783 % \begin{macro}{\@author@init}
1784 % \begin{macro}{\@author@cleared}
1785 % \begin{macro}{\@authorclear@sw}
1786 % \begin{macro}{\@author@def}
1787 % \begin{macro}{\@author@join@}
1788 % \begin{macro}{\@author@join}
1789 % \changes{v4.0beta 2}{1999/06/20}
1790 % {Change handling of \cs{@author} to prevent parsing problems.
1791 % (Helps in error recovery when syntax errors exist)}
1792 %
1793 % Here are all the access procedures for the author data structure.
1794 %
1795 % We define a flag value for \cmd\@author (private),
1796 % a procedure for setting \cmd\@author\ to the flag value (\cmd\@author@init),
1797 % a Boolean to test against the flag value (\cmd\@authorclear@sw),
1798 % and a procedure to add new ancillary data to the author.
1799 % \begin{macrocode}
1800 \def\@author@cleared{{}{}}%
1801 \def\@author@init{%
1802 \let\@author\@author@cleared
1803 }%
1804 \def\@authorclear@sw{\@ifx{\@author\@author@cleared}}%
1805 \appdef\class@inithook{%
1806 \@author@init
1807 }%
1808 \def\@author@def#1#2{%
1809 \move@AU\move@AF\move@AUAF
1810 \let\@AF@join\@author@join
1811 #1%
1812 \def\@author{{#2}{}}%
1813 }%
1814 \def\@author@join@#1#2#3{%
1815 \def\@author{{#1}{\@join{\@separator}{#2}{#3}}}%
1816 }%
1817 \def\@author@join{\expandafter\@author@join@\@author}%
1818 \def\@author@gobble#1#2{}%
1819 % \end{macrocode}
1820 % \end{macro}
1821 % \end{macro}
1822 % \end{macro}
1823 % \end{macro}
1824 % \end{macro}
1825 % \end{macro}
1826 %
1827 % \begin{macro}{\move@AU}
1828 % Move the most recent author to the list of current authors.
1829 % If we recently did a \cmd\@author@init, this is a no-op.
1830 % If we recently encountered a \cmd\collaboration,
1831 % we preface the author with the \cmd\CO@opr \ intercollated operator,
1832 % otherwise we apply \cmd\AU@opr.
1833 % \begin{macrocode}
1834 \def\move@AU{%
1835 \@authorclear@sw{}{%
1836 \collaboration@sw{%
1837 \expandafter\appdef
1838 \expandafter\AU@grp
1839 \expandafter{%
1840 \expandafter \CO@opr
1841 \@author
1842 }%
1843 }{%
1844 \expandafter\appdef
1845 \expandafter\AU@grp
1846 \expandafter{%
1847 \expandafter \AU@opr
1848 \@author
1849 }%
1850 }%
1851 }%
1852 \@author@init
1853 \@booleanfalse\collaboration@sw
1854 }%
1855 % \end{macrocode}
1856 % \end{macro}
1857 %
1858 % \begin{macro}{\@author@finish}
1859 % We define a procedure to terminate author/affiliation parsing just before the title block is formatted.
1860 % We detect the case where an author group is not followed by an affiliation group.
1861 % \changes{v4.0beta 6}{2001/02/13}
1862 % {Actually append AU@grp to @AAClist.}
1863 %
1864 % We first finish off any author- or affiliation groups in progress.
1865 % Next, we detect the case where there is an author group in progress, but no affiliation group.
1866 % If so, we emit a diagnositic message and act as if a \cmd\noaffiliation\ command had been given.
1867 % In any case, we finish off any author/affiliation pair that may remain.
1868 % Formatting of the title block may now proceed.
1869 % \begin{macrocode}
1870 \def\@author@finish{%
1871 \move@AU\move@AF
1872 \@ifx{\AU@grp\@empty}{}{%
1873 \@ifx{\AF@grp\@empty}{%
1874 \begingroup
1875 \let\href\@secondoftwo
1876 \let\AU@opr\@firstoftwo
1877 \let\CO@opr\@firstoftwo
1878 \class@warn{Assuming \string\noaffiliation\space for \AU@grp}%
1879 \endgroup
1880 \begingroup\@affiliation{\blankaffiliation}%\endgroup in \@affiliation
1881 \move@AF
1882 %
1883 % \appdef \@AAC@list{\AF@opr}%
1884 % \appdef@eval\@AAC@list{\AF@grp}%
1885 % \appdef@e \@AAC@list{\AU@grp}%
1886 % \let\AU@grp\@empty
1887 % \let\AF@grp\@empty
1888 }{}%
1889 }%
1890 \move@AUAF
1891 }%
1892 % \end{macrocode}
1893 % \end{macro}
1894 %
1895 % \begin{macro}{\@join}
1896 % The procedure \cmd\@join\ inserts
1897 % a separator between two tokens, or, if the first token is
1898 % nil, elides both that token and the separator.
1899 % \begin{macrocode}
1900 \def\@join#1#2#3{%
1901 \@if@empty{#2}{#3}{#2#1#3}%
1902 }%
1903 \def\@separator{;\space}%
1904 % \end{macrocode}
1905 % \end{macro}
1906 %
1907 % \begin{macro}{\surname}
1908 % \begin{macro}{\firstname}
1909 % No-op to allow better post-processing of the file.
1910 % \begin{macrocode}
1911 \let\surname\@firstofone
1912 \let\firstname\@firstofone
1913 % \end{macrocode}
1914 % \end{macro}
1915 % \end{macro}
1916 %
1917 % \begin{macro}{\AU@grp}
1918 % The control sequence name \cmd\AU@grp\ accretes
1919 % consecutive \cmd\author\ entries (with \cmd\AU@opr\ as the intercollated operator)
1920 % and \cmd\collaboration\ entries (with \cmd\CO@opr\ as the intercollated operator).
1921 % Ultimately, its contents are appended to the author/affiliation list \cmd\@AAC@list.
1922 % It must be initialized to \cmd\@empty.
1923 %
1924 % Note on \cmd\AU@opr\ and \cmd\CO@opr: it is essential to treat these two operators to the greatest extent possible on an equal footing.
1925 % Therefore we invariably assign values to the pair of them within the same procedure.
1926 %
1927 % \begin{macrocode}
1928 \let\AU@grp\@empty
1929 % \end{macrocode}
1930 % \end{macro}
1931 %
1932 % \begin{macro}{\and}
1933 % The original \LaTeX\ idea of using one \cmd\author\ command to capture
1934 % all authors and their address just doesn't work with multiple authors
1935 % possibly sharing addresses, so in this class disable \cmd\and.
1936 % \begin{macrocode}
1937 \renewcommand\and{\class@err{\protect\and\space is not supported}}
1938 % \end{macrocode}
1939 % \end{macro}
1940 %
1941 %
1942 % \subsubsection{Commands for affiliation}%
1943 %
1944 % \begin{macro}{\affiliation}
1945 % After each group of authors with the same address,
1946 % give that address in \cmd\affiliation.
1947 % If later in the list you have an author
1948 % with the address of an earlier author, repeat the \cmd\affiliation\
1949 % command: the system will detect the similarity and (if using the \classoption{superscriptaddress} option) only print the
1950 % affiliation once, reusing the superscript marker.
1951 %
1952 % When the \cmd\affiliation\ command is encountered, the current author and author group (if any) are at an end.
1953 % Also, the current affiliation is at an end.
1954 %
1955 % FIXME: changes to catcode required elsewhere now?
1956 % \begin{macrocode}
1957 \def\cat@comma@active{\catcode`\,\active}%
1958 {\cat@comma@active\gdef,{\active@comma}}%
1959 \def\active@comma{,\penalty-300\relax}%
1960 \newcommand\affiliation{%
1961 \move@AU\move@AF
1962 \begingroup
1963 \cat@comma@active
1964 \@affiliation
1965 }%
1966 \def\@affiliation#1{%
1967 \endgroup
1968 \let\@AF@join\@affil@join
1969 \@affil@def{#1}%
1970 }%
1971 % \end{macrocode}
1972 % \end{macro}
1973 %
1974 % \begin{macro}{\noaffiliation}
1975 % User-level command signifying that the current group of authors has \emph{no} affiliation.
1976 %
1977 % This is implemented by acting as if the \cmd\affiliation\ command has been given, and using a
1978 % flag value of \cmd\blankaffiliation, which \cmd\@affil@group\ can recognize as a no-op.
1979 % \begin{macrocode}
1980 \newcommand\noaffiliation{%
1981 \move@AU\move@AF
1982 % \edef\AF@grp{\AF@grp}%
1983 \begingroup\@affiliation{\blankaffiliation}%
1984 % \move@AF
1985 }%
1986 \def\blankaffiliation{}%
1987 % \end{macrocode}
1988 % \end{macro}
1989 %
1990 % \begin{macro}{\@affil@cleared}
1991 % \begin{macro}{\@affil@init}
1992 % \begin{macro}{\@affilclear@sw}
1993 % \begin{macro}{\@affil@def}
1994 % \begin{macro}{\@affil@join@}
1995 % \begin{macro}{\@affil@join}
1996 %
1997 % Here are all the access procedures for the affiliation data structure.
1998 % Note the similarity to those of the \cmd\@author\ data structure.
1999 %
2000 % We define a flag value for \cmd\@affil\ (private),
2001 % a procedure for setting \cmd\@affil\ to the flag value (\cmd\@affil@init),
2002 % a Boolean to test against the flag value (\cmd\@affilclear@sw),
2003 % and a procedure to add new ancillary data to the affiliation.
2004 % \begin{macrocode}
2005 \def\@affil@cleared{{}{}}%
2006 \def\@affil@init{%
2007 \let\@affil\@affil@cleared
2008 }%
2009 \def\@affilclear@sw{\@ifx{\@affil\@affil@cleared}}%
2010 \appdef\class@inithook{%
2011 \@affil@init
2012 }%
2013 \def\@affil@def#1{\def\@affil{{#1}{}}}%
2014 \def\@affil@join@#1#2#3{%
2015 \def\@affil{{#1}{\@join{\@separator}{#2}{#3}}}%
2016 }%
2017 \def\@affil@join{\expandafter\@affil@join@\@affil}%
2018 % \end{macrocode}
2019 % \end{macro}
2020 % \end{macro}
2021 % \end{macro}
2022 % \end{macro}
2023 % \end{macro}
2024 % \end{macro}
2025 %
2026 % \begin{macro}{\move@AF}
2027 % Move the most recent affiliation to the affiliation group.
2028 % If we recently did a \cmd\@affil@init, this is a no-op.
2029 % \begin{macrocode}
2030 \def\move@AF{%
2031 \@affilclear@sw{}{%
2032 % \end{macrocode}
2033 % Set the \cmd\temp@sw\ to false, then execute the affiliation list (\cmd\@AFF@list)
2034 % with the intercollated operator set to \cmd\@affil@match\
2035 % and with \cmd\@tempa\ holding the first component of \cmd\@affil, the current affiliation, which is to be matched.
2036 % If the current affiliation has been seen before, \cmd\temp@sw\ will be set to true,
2037 % \cmd\@tempc\ will be set to the existing affiliation number,
2038 % and \cmd\@tempd\ will be set to the affiliation's ancillary data.
2039 % The Boolean \cmd\@affils@sw\ being false prevents this test from ever returning a positive result.
2040 %
2041 % This procedure uses \cmd\@tempa\ and sets \cmd\@tempc, \cmd\@tempd, and \cmd\temp@sw.
2042 % \begin{macrocode}
2043 \@booleanfalse\temp@sw
2044 \let\@tempd\@empty
2045 \@affils@sw{%
2046 \expandafter\@firstoftwodef\expandafter\@tempa\@affil
2047 \def\AFF@opr{\@affil@match\@tempa}%
2048 \@AFF@list
2049 }{}\temp@sw
2050 % \end{macrocode}
2051 % True clause: This affiliation has been seen before.
2052 % If ancillary data for the affiliation have been given but are not identical to those seen before, give a warning.
2053 % \begin{macrocode}
2054 {%
2055 \expandafter\@secondoftwodef\expandafter\@tempb\@affil
2056 \@ifx{\@tempb\@empty}{}{%
2057 \@ifx{\@tempb\@tempd}{}{%
2058 \class@warn{%
2059 Ancillary information for \@tempa\space must not be different!
2060 Please put it on the first instance%
2061 }%
2062 }%
2063 }%
2064 \appdef@eval\AF@grp\@tempc
2065 }%
2066 % \end{macrocode}
2067 % False clause: This is a new address:
2068 % increment the counter to get a unique ID for the new affiliation
2069 % and append the new number, address, and footnote to the list \cmd\@AFF@list.
2070 % \begin{macrocode}
2071 {%
2072 \@if@empty{\expandafter\@firstoftwo\@affil}{%
2073 \edef\@tempc{\z@}%
2074 }{%
2075 \stepcounter{affil}%
2076 \edef\@tempc{\theaffil}%
2077 }%
2078 \appdef \@AFF@list{\AFF@opr}%
2079 \appdef@eval\@AFF@list\@tempc
2080 \appdef@e \@AFF@list{\@affil}%
2081 \appdef@eval\AF@grp\@tempc
2082 }%
2083 % \end{macrocode}
2084 % Append the ID of the affiliation to the affiliation group of the current author group.
2085 % \begin{macrocode}
2086 \@affil@init
2087 }%
2088 }%
2089 \def\@firstoftwodef#1#2#3{%
2090 \def#1{#2}%
2091 }%
2092 \def\@secondoftwodef#1#2#3{%
2093 \def#1{#3}%
2094 }%
2095 % \end{macrocode}
2096 % \end{macro}
2097 %
2098 % \begin{macro}{\move@AUAF}
2099 % \changes{v4.h}{1998/06/25}
2100 % {Changes to support groups of affiliations}
2101 % Append \cmd\AF@grp\ and \cmd\AU@grp\ to \cmd\@AAC@list\ %
2102 % and merge any new \cmd\AF@grp\ to \cmd\@AFG@list.
2103 % \begin{macrocode}
2104 \def\move@AUAF{%
2105 % \end{macrocode}
2106 % Entire procedure is predicated on something non-trivial to move.
2107 %
2108 % If both author and affiliation are nil, bail out.
2109 %
2110 % No, try that again:
2111 %
2112 % If we have seen any affiliations, then it is time to move the current
2113 % affiliation group and author group to \cmd\@AAC@list.
2114 % If not, we are picking up authors into an author group, and we
2115 % should bail out.
2116 % \begin{macrocode}
2117 %\@ifx{\AU@grp\@empty}{\@ifx{\AF@grp\@empty}{\true@sw}{\false@sw}}{\false@sw}%
2118 \@ifx{\AF@grp\@empty}%
2119 {}{%
2120 % \end{macrocode}
2121 % First, append current affiliation group (expansion of \cmd\AF@grp)
2122 % to the author/affiliation list (\cmd\@AAC@list),
2123 % using \cmd\AF@opr\ as the intercollated operator;
2124 % also append the current authors (\cmd\AU@grp).
2125 % \begin{macrocode}
2126 \appdef \@AAC@list{\AF@opr}%
2127 \appdef@eval\@AAC@list{\AF@grp}%
2128 \appdef@e \@AAC@list{\AU@grp}%
2129 % \end{macrocode}
2130 % Next, append the current affiliation group to \cmd\@AFG@list,
2131 % (if it is not already there)
2132 % using \cmd\AFS@opr\ as the intercollated operator.
2133 %
2134 % Note that \cmd\@AFG@list\ is a list of \emph{unique} affiliation groups.
2135 % \begin{macrocode}
2136 \@ifx{\@empty\AU@grp}{}{%
2137 \@ifx{\@empty\AF@grp}{}{%
2138 \@booleanfalse\temp@sw
2139 \def\AFS@opr{\x@match\AF@grp}%
2140 \@AFG@list
2141 \temp@sw{}{%
2142 \appdef \@AFG@list{\AFS@opr}%
2143 \appdef@eval\@AFG@list{\AF@grp}%
2144 }%
2145 }%
2146 }%
2147 % \end{macrocode}
2148 % Finally, null out the macros holding the author group and affiliation group, respectively.
2149 % \begin{macrocode}
2150 \let\AU@grp\@empty
2151 \let\AF@grp\@empty
2152 }%
2153 }%
2154 % \end{macrocode}
2155 % \end{macro}
2156 %
2157 % \begin{macro}{\@AAC@list}
2158 % The \cmd\@AAC@list\ macro accretes
2159 % authors (using \cmd\AU@opr\ as the intercollated operator),
2160 % collaborations (using \cmd\CO@opr\ as the intercollated operator),
2161 % and
2162 % affiliations (using \cmd\AF@opr\ as the intercollated operator).
2163 % \begin{macrocode}
2164 \appdef\class@inithook{%
2165 \let\@AAC@list\@empty
2166 }%
2167 % \end{macrocode}
2168 % \end{macro}
2169 %
2170 % \begin{macro}{\@AFG@list}
2171 % The macro \cmd\@AFG@list\ accretes \cmd\AF@grp,
2172 % with \cmd\AFS@opr\ as the intercollated operator.
2173 %
2174 % This token list is employed when and only when \classoption{groupedaddress} is in effect.
2175 %
2176 % It must be empty at the beginning of the document.
2177 % \begin{macrocode}
2178 \appdef\class@inithook{%
2179 \let\@AFG@list\@empty
2180 }%
2181 % \end{macrocode}
2182 % \end{macro}
2183 %
2184 % \begin{macro}{\@AFF@list}
2185 % The macro \cmd\@AFF@list\ accretes the list of affiliations
2186 % with \cmd\AFF@opr\ as the intercollated operator.
2187 % It must be empty at the beginning of the document.
2188 %
2189 % Each \cmd\affiliation\ command in the document contributes
2190 % to this list, as long as the argument of that instance of the command
2191 % is ``new''.
2192 %
2193 % Each entry in this list consists of the \cmd\AFF@opr\ intercollated operator
2194 % followed by three brace-delimited tokens, representing, in order:
2195 % \begin{enumerate}
2196 % \item
2197 % the affiliation's unique ID, a number increasing monotonically for
2198 % each new entry,
2199 % \item
2200 % the optional argument of the \cmd\affiliation\ command,
2201 % the footnote to the affiliation, and
2202 % \item
2203 % the text of the affiliation.
2204 % \end{enumerate}
2205 %
2206 % At various junctures in the code, the control sequence name
2207 % \cmd\AFF@opr\ assumes the meaning of
2208 % \cmd\@affil@footnote\ (FIXME: never used),
2209 % \cmd\@affil@group, \cmd\affil@script,
2210 % or is defined to expand to \cmd\@affil@match\cmd\@tempa.
2211 % and the list \cmd\@AFF@list\ is expanded.
2212 % \begin{macrocode}
2213 \appdef\class@inithook{%
2214 \let\@AFF@list\@empty
2215 }%
2216 % \end{macrocode}
2217 % \end{macro}
2218 %
2219 % \begin{macro}{\AF@grp}
2220 % The macro \cmd\AF@grp\ accretes affiliation IDs into an affiliation group.
2221 % It must be empty at the beginning of the document.
2222 % \begin{macrocode}
2223 \let\AF@grp\@empty
2224 % \end{macrocode}
2225 % \end{macro}
2226 %
2227 % \begin{macro}{\@affil@match}
2228 % The definition for the \cmd\AFF@opr, the intercollated operator for \cmd\@AFF@list,
2229 % when adding a new affiliation: seeks a match with any earlier affiliation.
2230 % When the affiliation list is executed, this procedure tests each entry against
2231 % the `new' affiliation (which has been stored in \cmd\@tempa).
2232 %
2233 % Uses \cmd\temp@sw, \cmd\@tempc, and \cmd\@tempd\ to communicate back:
2234 % if it returns \cmd\temp@sw\ true, a match was found,
2235 % then \cmd\@tempc\ will be the footnote number of the matching entry
2236 % and \cmd\@tempd\ will be the auxiliary information of the matching entry.
2237 % \begin{macrocode}
2238 \def\@affil@match#1#2#3#4{%
2239 \temp@sw{}{%
2240 \def\@tempifx{#3}%
2241 \@ifx{\@tempifx#1}{%
2242 \@booleantrue\temp@sw
2243 \def\@tempc{#2}%
2244 \def\@tempd{#4}%
2245 }{%
2246 }%
2247 }%
2248 }%
2249 % \end{macrocode}
2250 % \end{macro}
2251 %
2252 % \begin{macro}{\@tempaffil@script}
2253 % Give a superscript marker to the address,
2254 % and junk the text argument (|#2|).
2255 % \begin{macrocode}
2256 %\def\@tempaffil@script#1#2{%
2257 % ,\,#1%
2258 %}%
2259 % \end{macrocode}
2260 % \end{macro}
2261 %
2262 % \begin{macro}{\@tempaffil@group}
2263 %
2264 % Execute if we are grouping authors above `main addresses' (\classoption{groupedaddress}).
2265 % Put temp address in a footnote, with explanatory text.
2266 % Note: this procedure uses \cmd\@tempb\ and \cmd\@tempc\
2267 % to communicate to \cmd\AFF@opr.
2268 % \begin{macrocode}
2269 %\def\@tempaffil@group#1#2{%
2270 % \def\@tempc{#1}%
2271 % \def\@tempb{#2}%
2272 % \begingroup
2273 % \let\AFF@opr \@affil@footnote
2274 % \@AFF@list
2275 % \endgroup
2276 %}%
2277 % \end{macrocode}
2278 % \end{macro}
2279 %
2280 % \begin{macro}{\@affil@footnote}
2281 % The alias of \cmd\AFF@opr\ when \cmd\@AFF@list\
2282 % is executed by \cmd\@tempaffil@group.
2283 % If we find a match of the affiliation number to \cmd\@tempc,
2284 % then footnotes are formatted with the relevant content and \cmd\@tempb.
2285 % \begin{macrocode}
2286 %\def\@affil@footnote#1#2#3{%
2287 % \def\@tempifx{#1}%
2288 % \@ifx{\@tempifx\@tempc}{%
2289 % \comma@space
2290 % \expandafter\frontmatter@footnote\expandafter{\@tempb#2}%
2291 % \frontmatter@footnote{#3}%
2292 % }{%
2293 % }%
2294 %}%
2295 % \end{macrocode}
2296 % \end{macro}
2297 %
2298 % \begin{macro}{\@AF@join}
2299 % The \cmd\csname\ \cmd\@AF@join\ is a procedure used within
2300 % \cmd\email, \cmd\homepage, \cmd\thanks, and \cmd\altaffiliation.
2301 % When such a command appears after an \cmd\author, \cmd\collaboration, or \cmd\affiliation
2302 % command, the \cmd\@AF@join\ procedure appends the argument given to the appropriate
2303 % macro.
2304 % Its default is to give an error message, since these commands are legal only within
2305 % the particular context mentioned.
2306 % \begin{macrocode}
2307 \appdef\class@inithook{%
2308 \let\@AF@join\@AF@join@error
2309 }%
2310 \def\@AF@join@error#1{%
2311 \class@warn{%
2312 \string\email, \string\homepage, \string\thanks, or \string\altaffiliation\space
2313 appears in wrong context.
2314 }%
2315 }%
2316 % \end{macrocode}
2317 % \end{macro}
2318 %
2319 %
2320 % \subsubsection{Commands for auxiliary information}%
2321 %
2322 % \begin{macro}{\email}
2323 % Just tacks the email address on to the current author or affiliation.
2324 % \begin{macrocode}
2325 \def\sanitize@url{%
2326 \@makeother\%%
2327 \@makeother\~%
2328 \@makeother\_%
2329 }%
2330 \newcommand*\email[1][Electronic address: ]{\begingroup\sanitize@url\@email{#1}}%
2331 \def\@email#1#2{%
2332 \endgroup
2333 \@AF@join{#1\href{mailto:#2}{#2}}%
2334 }%
2335 % \end{macrocode}
2336 % \end{macro}
2337 %
2338 % \begin{macro}{\homepage}
2339 % Just tacks the URL on to the current author or affiliation.
2340 % Note: group opened in \cmd\homepage\ is closed in \cmd\@homepage.
2341 % \begin{macrocode}
2342 \newcommand*\homepage[1][URL:~]{\begingroup\sanitize@url\@homepage{#1}}%
2343 \def\@homepage#1#2{%
2344 \endgroup
2345 \@AF@join{#1\url{#2}}%
2346 }%
2347 % \end{macrocode}
2348 % \end{macro}
2349 %
2350 % \begin{macro}{\url}
2351 % \begin{macro}{\href}
2352 % \begin{macrocode}
2353 \appdef\class@documenthook{%
2354 \providecommand\url{\texttt}%
2355 \providecommand\href[2]{\url{#2}}%
2356 }%
2357 % \end{macrocode}
2358 % \end{macro}
2359 % \end{macro}
2360 %
2361 % \begin{macro}{\thanks}
2362 %
2363 % The operative version of \cmd\thanks\ appends an item to \cmd\@author, or \cmd\@affil's auxiliary data.
2364 % \begin{macrocode}
2365 \def\thanks{% implicit #1
2366 \@AF@join
2367 }%
2368 % \end{macrocode}
2369 % \end{macro}
2370 %
2371 % \begin{macro}{\altaffiliation}
2372 % \changes{v4.d}{1998/01/31}
2373 % {change name from \cs{tempaffiliation}}
2374 % \changes{v4.l}{1998/09/01}
2375 % {add optional argument handling back}
2376 % Implemented more or less like \cmd\thanks\ but shares the affiliation
2377 % counter.
2378 % Optional argument may be used to give explanatory text eg
2379 % `currently staying at'
2380 % This will be placed before the address, if used in a footnote.
2381 % \begin{macrocode}
2382 \newcommand*\altaffiliation[2][]{%
2383 \@AF@join{#1#2}%
2384 }%
2385 % \end{macrocode}
2386 % \end{macro}
2387 %
2388 %
2389 % \subsubsection{Procedures for author, collaboration, and affiliation}%
2390 %
2391 % Macros that list off, say, authors, and which require punctuation, like ``A, B, and C'', will use
2392 % \cmd\set@listcomma@list, \cmd\set@listcomma@count, \cmd\@listand, and \cmd\@listcomma.
2393 % These macros use the \cmd\@tempcnta\ register to keep track of how many items remain to be listed off.
2394 %
2395 % At present, \cmd\@author@present\ will decrement that counter.
2396 %
2397 % \begin{macro}{\set@listcomma@list}
2398 % \begin{macro}{\set@listcomma@count}
2399 % \changes{v4.l}{1998/09/01}
2400 % {macro added}
2401 % Pop the author count for this collaboration.
2402 %
2403 % Note: by side effect, it assigns \cmd\@listcomma:
2404 % for a list of length two, suppress comma addition.
2405 % \begin{macrocode}
2406 \def\set@listcomma@list#1{%
2407 \expandafter\@reset@ac\expandafter#1#1{0}\@reset@ac{%
2408 \let\@listcomma\relax
2409 }{%
2410 \let\@listcomma\@listcomma@comma
2411 }%
2412 }%
2413 \def\set@listcomma@count#1{%
2414 \@ifnum{#1=\tw@}{%
2415 \let\@listcomma\relax
2416 }{%
2417 \let\@listcomma\@listcomma@comma
2418 }%
2419 }%
2420 % \end{macrocode}
2421 % Does the actual pop operation, then generates a Boolean which selects one of the two assignments for \cmd\@listcomma.
2422 %
2423 % Note: this procedure sets \cmd\@tempcnta\ to reflect the number of items to list off.
2424 % \begin{macrocode}
2425 \def\@reset@ac#1#2#3\@reset@ac{%
2426 \def#1{#3}%
2427 \@tempcnta#2\relax
2428 \@ifnum{#2=\tw@}%
2429 }%
2430 % \end{macrocode}
2431 % \end{macro}
2432 % \end{macro}
2433 %
2434 % \begin{macro}{\listand}
2435 % Might need extending with penalties etc.
2436 %
2437 % Note: this procedure expects \cmd\@tempcnta\ to reflect the current number of items remaining to list off.
2438 % \begin{macrocode}
2439 \def\@listand{\@ifnum{\@tempcnta=\tw@}{\andname\space}{}}%
2440 % \end{macrocode}
2441 % \end{macro}
2442 %
2443 % \begin{macro}{\@listcomma}
2444 % This definition, with \cmd\@ne\ puts a comma before and.
2445 %
2446 % David Carlisle says: In UK English (at least) would have \cmd\tw@\ here,
2447 % which would then implement the convention of indicating conjunction with comma or ``and'', but not both.
2448 %
2449 % Note: this procedure expects \cmd\@tempcnta\ to reflect the current number of items remaining to list off.
2450 % \begin{macrocode}
2451 \def\@listcomma@comma{\@ifnum{\@tempcnta>\@ne}{,}{}}%
2452 \def\@listcomma@comma@UK{\@ifnum{\@tempcnta>\tw@}{,}{}}%
2453 % \end{macrocode}
2454 % \end{macro}
2455 %
2456 % \begin{macro}{\@collaboration@err}
2457 % This command will be executed if are in a \classoption{groupedaddress} situation and
2458 % the document contained a \cmd\collaboration\ command.
2459 %
2460 % There already has been issued a warning message explaining that \cmd\collaboration\ is wrong in this case,
2461 % so here we simply gobble.
2462 % \begin{macrocode}
2463 \def\@collaboration@err#1#2{%
2464 %\class@warn{An illegal \string\collaboration\ command has been entered!}%
2465 }%
2466 % \end{macrocode}
2467 % \end{macro}
2468 %
2469 % \begin{macro}{\doauthor}
2470 % Main control over how authors are typeset.
2471 %
2472 % |#1| is loaded by \cmd\author
2473 %
2474 % |#2| is loaded by \cmd\email, \cmd\homepage, \cmd\altaffiliation, or \cmd\thanks
2475 %
2476 % |#3| is the superscript affiliation, if at all used.
2477 %
2478 % First, the author name is formatted, followed by a comma,
2479 % then come any marks relating to affiliation (if present),
2480 % then come the homepage URL and email address, if any, with
2481 % appropriate punctuation.
2482 % \begin{macrocode}
2483 \def\doauthor#1#2#3{%
2484 \ignorespaces#1\unskip\@listcomma
2485 \def\@tempifx{#3}%
2486 \@ifx{\@tempifx\@empty}{%
2487 \def\@tempifx{#2}%
2488 \@ifx{\@tempifx\@empty}{}{\frontmatter@footnote{#2}}%
2489 }{%
2490 #3%
2491 \def\@tempifx{#2}%
2492 \@ifx{\@tempifx\@empty}{}{\comma@space\frontmatter@footnote{#2}}%
2493 }%
2494 \space \@listand
2495 }%
2496 % \end{macrocode}
2497 % \end{macro}
2498 %
2499 % \begin{macro}{\AF@opr}
2500 % DPC: The number(s) associated to the affiliation address(es).
2501 % \end{macro}
2502 %
2503 % \begin{macro}{\@thanks}
2504 % \changes{v4.d}{1998/01/31}
2505 % {\cs{comma@space} added}
2506 % Society-specific options may change this. \cmd\comma@space\ is a separator
2507 % between adjacent footnotes.
2508 % \begin{macrocode}
2509 \def\@thanks{\comma@space\footnote}
2510 % \end{macrocode}
2511 % \end{macro}
2512 %
2513 % \begin{macro}{\x@match}
2514 % Procedure \cmd\x@match\ is used as an alias \cmd\AFS@opr,
2515 % probing the list of affiliation groups
2516 % and setting a Boolean if a match is found to \#1 (usually the current affiliation group).
2517 %
2518 % Procedure \cmd\y@match\ is used as an alias to \cmd\@TBN@opr,
2519 % probing the list of unique title block footnotes for a match to the footnote text:
2520 % when the first match is found it sets a Boolean,
2521 % defining \cmd\@tempb\ to the number of that footnote.
2522 % \begin{macrocode}
2523 \def\x@match#1#2{%
2524 \temp@sw{}{%
2525 \def\@tempifx{#2}%
2526 \@ifx{\@tempifx#1}{%
2527 \@booleantrue\temp@sw
2528 }{%
2529 }%
2530 }%
2531 }%
2532 \def\y@match#1#2#3{%
2533 \temp@sw{}{%
2534 \def\@tempifx{#3}%
2535 \@ifx{\@tempifx#1}{%
2536 \@booleantrue\temp@sw
2537 \def\@tempb{#2}%
2538 }{%
2539 }%
2540 }%
2541 }%
2542 % \end{macrocode}
2543 % \end{macro}
2544 %
2545 % \begin{macro}{\frontmatter@footnote}
2546 % Used when typesetting a title block footnote.
2547 % (Item 290: merge duplicates.)
2548 %
2549 % Maintains a list of frontmatter footnotes along with associated device.
2550 % Uniquifies each footnote by traversing the list and looking for a match to the footnote text.
2551 % If found, define \cmd\@tempb\ to the corresponding footnote device, and typeset it with \cmd\@footnotemark.
2552 % If never found, manually increment footnote counter,
2553 % determine the corresponding footnote device, and
2554 % add footnote text and device to the list of frontmatter footnotes.
2555 %
2556 % The list \cmd\@FMN@list\ is processed later in the title block production.
2557 %
2558 % Note that this method of making footnotes runs afoul of \classname{hyperref}'s patches of the \LaTeX\ kernel.
2559 % Therefore, we avoid trouble by refraining from using \cmd\@footnotemark\ and by creating our own hypertext links.
2560 % \begin{macrocode}
2561 \def\frontmatter@footnote#1{%
2562 \begingroup
2563 \@booleanfalse\temp@sw
2564 \def\@tempa{#1}%
2565 \let\@tempb\@empty
2566 \def\@TBN@opr{\y@match\@tempa}%
2567 \@FMN@list
2568 \temp@sw{%
2569 \expandafter\frontmatter@footnotemark
2570 \expandafter{\@tempb}%
2571 }{%
2572 \stepcounter\@mpfn
2573 \protected@xdef\@tempb{\the\csname c@\@mpfn\endcsname}%
2574 \expandafter\frontmatter@footnotemark
2575 \expandafter{\@tempb}%
2576 \expandafter\g@addto@macro
2577 \expandafter\@FMN@list
2578 \expandafter{%
2579 \expandafter \@TBN@opr
2580 \expandafter {\@tempb}{#1}%
2581 }%
2582 }%
2583 \endgroup
2584 }%
2585 \appdef\class@inithook{%
2586 \global\let\@FMN@list\@empty
2587 }%
2588 \def\frontmatter@footnotemark#1{%
2589 \leavevmode
2590 \ifhmode\edef\@x@sf{\the\spacefactor}\nobreak\fi
2591 \begingroup
2592 \hyper@linkstart {link}{frontmatter@#1}%
2593 \csname c@\@mpfn\endcsname#1\relax
2594 \def\@thefnmark{\thempfn}%
2595 \@makefnmark
2596 \hyper@linkend
2597 \endgroup
2598 \ifhmode\spacefactor\@x@sf\fi
2599 \relax
2600 }%
2601 % \end{macrocode}
2602 % \end{macro}
2603 %
2604 %
2605 %
2606 % \subsection{The keywords command}%
2607 % \begin{macro}{\keywords}
2608 % \begin{macro}{\@keywords}
2609 % Usual game, save text in a macro for processing by \cmd\maketitle.
2610 % \begin{macrocode}
2611 \def\keywords#1{%
2612 \aftermaketitle@chk{\keywords}%
2613 \gdef\@keywords{#1}%
2614 }%
2615 \def\@keywords{}%
2616 % \end{macrocode}
2617 % \end{macro}
2618 % \end{macro}
2619 %
2620 % \subsection{The \cs{date} command and related commands}%
2621 % \begin{macro}{\date}
2622 % \begin{macro}{\received}
2623 % \begin{macro}{\revised}
2624 % \begin{macro}{\accepted}
2625 % \begin{macro}{\published}
2626 % \begin{macro}{\@date}
2627 % \begin{macro}{\@received}
2628 % \begin{macro}{\@revised}
2629 % \begin{macro}{\@accepted}
2630 % \begin{macro}{\@published}
2631 % Use the \cmd\date\ command to specify the document date,
2632 % the \cmd\received\ command to specify the date received,
2633 % \cmd\revised\ for date revised,
2634 % \cmd\accepted\ for date accepted, and
2635 % \cmd\published\ for date published.
2636 % Normally only \cmd\date\ to be used by author,
2637 % the remainder used only by editors.
2638 %
2639 % DPC: As for \cmd\keywords, but this time don't flag a warning if there is no
2640 % revision date specified.
2641 %
2642 % In each case the user-level command defines the value of a
2643 % macro which buffers the data entered by the user.
2644 % For instance, \cmd\received\ causes \cmd\@received\ to
2645 % acquire a value.
2646 % The optional argument allows the user to override the
2647 % text that will be typeset along with the date;
2648 % the default value of that text is itself
2649 % a localized macro.
2650 % \begin{macrocode}
2651 \renewcommand*\date[2][\Dated@name]{\def\@date{#1#2}}%
2652 \def\@date{}%
2653 \newcommand*\received[2][\Received@name]{\def\@received{#1#2}}%
2654 \def\@received{}%
2655 \newcommand*\revised[2][\Revised@name]{\def\@revised{#1#2}}%
2656 \def\@revised{}%
2657 \newcommand*\accepted[2][\Accepted@name]{\def\@accepted{#1#2}}%
2658 \def\@accepted{}%
2659 \newcommand*\published[2][\Published@name]{\def\@published{#1#2}}%
2660 \def\@published{}%
2661 % \end{macrocode}
2662 %
2663 % \end{macro}
2664 % \end{macro}
2665 % \end{macro}
2666 % \end{macro}
2667 % \end{macro}
2668 % \end{macro}
2669 % \end{macro}
2670 % \end{macro}
2671 % \end{macro}
2672 % \end{macro}
2673 %
2674 % \subsection{The pacs command}%
2675 % PACS, the Physics and Astronomy Classification Scheme.
2676 % \begin{macro}{\pacs}
2677 % \begin{macro}{\@pacs}
2678 % As for \cmd\keywords\
2679 % \begin{macrocode}
2680 \def\pacs#1{%
2681 \aftermaketitle@chk{\pacs}%
2682 \gdef\@pacs{#1}%
2683 }%
2684 \def\@pacs{}%{\class@warn{No PACS numbers}}%
2685 % \end{macrocode}
2686 % \end{macro}
2687 % \end{macro}
2688 %
2689 % \subsection{The \cs{preprint} command}
2690 %
2691 % \changes{v4.g}{1998/06/10}
2692 % {multiple preprint commands}
2693 % \begin{macrocode}
2694 \def\preprint#1{\gappdef\@preprint{\preprint{#1}}}%
2695 \let\@preprint\@empty
2696 % \end{macrocode}
2697 %
2698 % \subsection{draft}
2699 % DPC: Name clash with draft option. \LaTeX\ doesn't care, but it confuses me.
2700 %
2701 % This command is a 3.1 relic, now removed.
2702 % \begin{macrocode}
2703 %\newcommand\draft{\@booleantrue\draft@sw}%
2704 % \end{macrocode}
2705 %
2706 % \subsection{The \env{abstract} environment}%
2707 %
2708 % \changes{v4.0beta 2}{1999/06/20}
2709 % {Gathered all code for the abstract environment together
2710 % and abstracted out the formatting details for journals to override.}
2711 %
2712 % \begin{macro}{\absbox}
2713 %
2714 % \begin{macrocode}
2715 \newbox\absbox
2716 % \end{macrocode}
2717 % \end{macro}
2718 %
2719 % \begin{environment}{abstract}
2720 % Abstract, as in AMS classes, must be specified \emph{before}
2721 % \cmd\maketitle. It just saves everything up in \cmd\absbox.
2722 % \changes{v4.d}{1998/01/31}
2723 % {If empty \cs{abstractname} omit spacing}
2724 % \begin{macrocode}
2725 % \changes{v4.e}{1998/01/31}
2726 % {hookify}
2727 % Note that the specifics of how the abstract is to be
2728 % formatted are set by \cmd\frontmatter@abstractwidth,
2729 % \cmd\frontmatter@abstractheading, and \cmd\frontmatter@abstractfont.
2730 %
2731 % Here we wish to set the abstract into type but save it away in a box, much like
2732 % the \cmd\minipage\ command does.
2733 %
2734 % Note that the \cmd\endabstract\ portion of the environment
2735 % begins with code that mostly duplicates \cmd\endminipage, but without the \cmd\@iiiparbox.
2736 % At the end, we simply transfer the contents of the \cmd\minipage\
2737 % into a box of our own.
2738 %
2739 % However, we also have to end the gratuitous
2740 % paragraph begun by \cmd\minipage.
2741 % We ensure that no trace of that paragraph is left,
2742 % by absorbing the \cmd\parindent\ box.
2743 % Doing so destroys the paragraph entirely, except
2744 % for the \cmd\parskip\ glue, and that morsel is pruned, because we are at the top
2745 % of a page.
2746 %
2747 % This mechanism is vulnerable, however, because anything placed into the horizontal list
2748 % after the \cmd\parindent\ box will confound it.
2749 % And that is exactly what happens under Mik\TeX:
2750 % There seems to be an extension to the \TeX\ standard operating here which inserts a \cmd\special \ at the beginning of every paragraph.
2751 % (The mechnism is \emph{not} based on \cmd\everypar.)
2752 %
2753 % To accomodate this state of affairs,
2754 % we have a new mechanism that offers an even more complete rewrite of \env{minipage}.
2755 %
2756 % The user can elect to use this new mechanism via the \classoption{newabstract};
2757 % likewise the old mechanism via the \classoption{oldabstract}.
2758 %
2759 % \begin{macrocode}
2760 \newenvironment{abstract}{%
2761 \aftermaketitle@chk{\begin{abstract}}%
2762 \global\setbox\absbox\vbox\bgroup
2763 \color@begingroup
2764 \columnwidth\textwidth
2765 \hsize\columnwidth
2766 \@parboxrestore
2767 \def\@mpfn{mpfootnote}\def\thempfn{\thempfootnote}\c@mpfootnote\z@
2768 \let\@footnotetext\frontmatter@footnotetext
2769 \minipagefootnote@init
2770 \let\@listdepth\@mplistdepth \@mplistdepth\z@
2771 \@minipagerestore
2772 \@setminipage
2773 \frontmatter@abstractheading
2774 \frontmatter@abstractfont
2775 \let\footnote\mini@note
2776 }{%
2777 \par
2778 \unskip
2779 \minipagefootnote@here
2780 \@minipagefalse %% added 24 May 89
2781 \color@endgroup
2782 \egroup
2783 }%
2784 % \end{macrocode}
2785 % \end{environment}
2786 %
2787 % \begin{macro}{\frontmatter@footnotetext}
2788 % We reimplement \cmd\@mpfootnotetext\ under a new name (so as not to be overridden by the \classname{hyperref} package)
2789 % and extend it to accomodate hyperrefs.
2790 %
2791 % Note that this procedure is very like \classname{ltxutil}'s \cmd\mp@footnotetext, except that it
2792 % uses \texttt{p@mpfootnote} instead of \texttt{p@mpfootnote}, and
2793 % \cmd\frontmatter@makefntext\ instead of \cmd\@makefntext.
2794 %
2795 % \begin{macrocode}
2796 \long\def\frontmatter@footnotetext#1{%
2797 \minipagefootnote@pick
2798 \reset@font\footnotesize
2799 \interlinepenalty \interfootnotelinepenalty
2800 \splittopskip \footnotesep
2801 \splitmaxdepth \dp \strutbox
2802 \set@footnotewidth
2803 \@parboxrestore
2804 \protected@edef\@currentlabel{\csname p@mpfootnote\endcsname\@thefnmark}%
2805 \color@begingroup
2806 \frontmatter@makefntext{%
2807 \rule\z@\footnotesep\ignorespaces#1\@finalstrut\strutbox
2808 }%
2809 \color@endgroup
2810 \minipagefootnote@drop
2811 }%
2812 % \end{macrocode}
2813 % \end{macro}
2814 %
2815 % \begin{macro}{\frontmatter@abstractheading}
2816 % The default abstract head; journals will override this procedure.
2817 % \begin{macrocode}
2818 \def\frontmatter@abstractheading{%
2819 \begingroup
2820 \centering\large
2821 \abstractname
2822 \par
2823 \endgroup
2824 }%
2825 % \end{macrocode}
2826 % \end{macro}
2827 %
2828 % \begin{macro}{\frontmatter@abstractfont}
2829 % The default type specification for the body of the abstract.
2830 % Journals will override this setting.
2831 % \begin{macrocode}
2832 \def\frontmatter@abstractfont{}%
2833 % \end{macrocode}
2834 % \end{macro}
2835 %
2836 % \begin{macro}{\frontmatter@abstractwidth}
2837 % The default setting is the full text width;
2838 % journals can override this setting.
2839 % \begin{macrocode}
2840 \def\frontmatter@abstractwidth{\textwidth}
2841 % \end{macrocode}
2842 % \end{macro}
2843 %
2844 % \begin{macro}{\frontmatter@abstract@produce}
2845 % This procedure determines how the abstract is incorporated
2846 % into the title block. We split this out in anticipation
2847 % of the need to lift the limitation that the abstract not break over pages.
2848 %
2849 % If we are in preprint style, we provide an easy pagebreak point immediately above the abstract.
2850 % This means that the abstract will either fit entirely on the same page as the title block,
2851 % or it will start a page of its own (which may itself break onto a subsequent page if necessary).
2852 % \begin{macrocode}
2853 \def\frontmatter@abstract@produce{%
2854 \par
2855 % \tracingall
2856 \preprintsty@sw{%
2857 \do@output@MVL{%
2858 \vskip\frontmatter@preabstractspace
2859 \vskip200\p@\@plus1fil
2860 \penalty-200\relax
2861 \vskip-200\p@\@plus-1fil
2862 }%
2863 }{%
2864 \addvspace{\frontmatter@preabstractspace}%
2865 }%
2866 % \leavevmode
2867 \begingroup
2868 \dimen@\baselineskip
2869 \setbox\z@\vtop{\unvcopy\absbox}%
2870 \advance\dimen@-\ht\z@\advance\dimen@-\prevdepth
2871 \@ifdim{\dimen@>\z@}{\vskip\dimen@}{}%
2872 \endgroup
2873 \unvbox\absbox
2874 \@ifx{\@empty\mini@notes}{}{\mini@notes\par}%
2875 % \par
2876 \addvspace\frontmatter@postabstractspace
2877 % \showlists
2878 % \tracingplain
2879 }%
2880 % \end{macrocode}
2881 % \end{macro}
2882 %
2883 % \begin{macro}{\frontmatter@preabstractspace}
2884 % \begin{macro}{\frontmatter@postabstractspace}
2885 % Space above and space below abstract in title block
2886 % \begin{macrocode}
2887 \def\frontmatter@preabstractspace{.5\baselineskip}
2888 \def\frontmatter@postabstractspace{.5\baselineskip}
2889 % \end{macrocode}
2890 % \end{macro}
2891 % \end{macro}
2892 %
2893 %
2894 %
2895 % \subsection{Formatting the title block}%
2896 %
2897 % \begin{environment}{titlepage}
2898 % This is \LaTeXe's \classname{article} class version,
2899 % with modifications.
2900 % \changes{v4.0beta 3}{1999/11/13}
2901 % {grid changes with ltxgrid}
2902 % \begin{macrocode}
2903 \newenvironment{titlepage}{%
2904 \twocolumn@sw{\onecolumngrid}{\newpage}%
2905 \thispagestyle{titlepage}%
2906 \setcounter{page}\@ne
2907 }{%
2908 \twocolumn@sw{\twocolumngrid}{\newpage}%
2909 \twoside@sw{}{%
2910 \setcounter{page}\@ne
2911 }%
2912 }%
2913 % \end{macrocode}
2914 % \end{environment}
2915 %
2916 % \begin{macro}{\maketitle}
2917 % \changes{v4.d}{1998/01/31}
2918 % {hookify}
2919 % Put it all together to format the title block.
2920 % \begin{macrocode}
2921 \def\maketitle{%
2922 \@author@finish
2923 \title@column\titleblock@produce
2924 \suppressfloats[t]%
2925 % \end{macrocode}
2926 % Now save some memory.
2927 % \begin{macrocode}
2928 \let\and\relax
2929 \let\affiliation\@gobble
2930 % \let\address\affiliation
2931 \let\author\@gobble
2932 \let\@AAC@list\@empty
2933 \let\@AFF@list\@empty
2934 \let\@AFG@list\@empty
2935 % \let\keywords\@gobble
2936 % \let\@keywords\@empty
2937 \let\@AF@join\@AF@join@error
2938 \let\email\@gobble
2939 \let\@address\@empty
2940 \let\maketitle\relax
2941 \let\thanks\@gobble
2942 \titlepage@sw{%
2943 \vfil
2944 \clearpage
2945 }{}%
2946 }%
2947 % \end{macrocode}
2948 % \end{macro}
2949 %
2950 % \begin{macro}{\titleblock@produce}
2951 % This procedure produces the title block.
2952 %
2953 % It effectively executes inside a group
2954 % and always returns us to vertical mode.
2955 %
2956 % Note: we assume that it is OK to set the footnote counter to zero at this point.
2957 % Is this a safe assumption?
2958 % \begin{macrocode}
2959 \def\titleblock@produce{%
2960 \begingroup
2961 % \end{macrocode}
2962 % Special footnote version [of footnotes] for \cmd\thanks,
2963 % copied from \classname{article} class \cmd\maketitle.
2964 % \changes{v4.0beta 2}{1999/06/20}
2965 % {Set \cs{footnote} to \LaTeX\ standard version for this scope.}
2966 % \begin{macrocode}
2967 \let\footnote\footnote@latex
2968 \let\@makefnmark\@makefnmark@latex
2969 \let\@footnotemark\@footnotemark@latex
2970 \let\thefootnote\frontmatter@thefootnote
2971 % \let\@makefntext\frontmatter@makefntext
2972 \global\c@footnote\z@
2973 \let\@makefnmark\frontmatter@makefnmark
2974 \frontmatter@setup
2975 \thispagestyle{titlepage}\label{FirstPage}%
2976 % \end{macrocode}
2977 % Produce the title:
2978 % \begin{macrocode}
2979 \frontmatter@title@produce
2980 % \end{macrocode}
2981 % Produce the author list:
2982 % \begin{macrocode}
2983 \groupauthors@sw{%
2984 \frontmatter@author@produce@group
2985 }{%
2986 \frontmatter@author@produce@script
2987 }%
2988 % \end{macrocode}
2989 % Produce the dates:
2990 % \begin{macrocode}
2991 \frontmatter@RRAPformat{%
2992 \expandafter\produce@RRAP\expandafter{\@date}%
2993 \expandafter\produce@RRAP\expandafter{\@received}%
2994 \expandafter\produce@RRAP\expandafter{\@revised}%
2995 \expandafter\produce@RRAP\expandafter{\@accepted}%
2996 \expandafter\produce@RRAP\expandafter{\@published}%
2997 }%
2998 % \end{macrocode}
2999 % Produce the abstract, PACS, and keywords, and end any paragraph.
3000 % \begin{macrocode}
3001 \frontmatter@abstract@produce
3002 \@pacs@produce\@pacs
3003 \@keywords@produce\@keywords
3004 \par
3005 \frontmatter@finalspace
3006 \endgroup
3007 }%
3008 % \end{macrocode}
3009 % \end{macro}
3010 %
3011 % \begin{macro}{\frontmatter@title@produce}
3012 % The default formatting procedure for the article title.
3013 % This procedure should take care of the vertical space below the title.
3014 %
3015 % Journals may override this procedure, but it is more likely that they will
3016 % use the hooks \cmd\frontmatter@title@above, \cmd\frontmatter@title@format, and \cmd\frontmatter@title@below.
3017 %
3018 % At this point, we patch into \cmd\let@mark\ so that the common markup idiom \cmd\\ is taken care of.
3019 % \begin{macrocode}
3020 \def\frontmatter@title@produce{%
3021 \begingroup
3022 \frontmatter@title@above
3023 \frontmatter@title@format
3024 \@title
3025 \@ifx{\@title@aux\@title@aux@cleared}{}{%
3026 \expandafter\frontmatter@footnote\expandafter{\@title@aux}%
3027 }%
3028 \par
3029 % \@ifx{\@shorttitle\@empty}{%
3030 % \markboth{\@title}{\@title}%
3031 % }{%
3032 % \markboth{\@shorttitle}{\@shorttitle}%
3033 %% \class@warn{Unused short title ignored}%
3034 % }%
3035 \frontmatter@title@below
3036 \endgroup
3037 }%
3038 \appdef\let@mark{\let\\\relax}%
3039 % \end{macrocode}
3040 % \end{macro}
3041 %
3042 % \begin{macro}{\frontmatter@title@above}
3043 % \begin{macro}{\frontmatter@title@format}
3044 % \begin{macro}{\frontmatter@title@below}
3045 % The default values for formatting specifications for the article title.
3046 %
3047 % The procedure \cmd\frontmatter@title@above\ should take care of the vertical space above the title;
3048 % \cmd\frontmatter@title@below\ below.
3049 % The procedure \cmd\frontmatter@title@format\ should invoke any font switches, etc.
3050 % that may apply to the title.
3051 %
3052 % Journals will override this procedure.
3053 % \begin{macrocode}
3054 \def\frontmatter@title@above{}%
3055 \def\frontmatter@title@format{}%
3056 \def\frontmatter@title@below{\addvspace{\baselineskip}}%
3057 % \end{macrocode}
3058 % \end{macro}
3059 % \end{macro}
3060 % \end{macro}
3061 %
3062 % \subsubsection{Authors and affiliations in superscriptaddress style}
3063 %
3064 % \begin{macro}{\frontmatter@author@produce@script}
3065 % \cmd\frontmatter@author@produce@script\ is an alias for \cmd\frontmatter@author@produce,
3066 % the procedure that formats the author/affiliation list.
3067 %
3068 % In this case, the authors affiliations are being superscripted
3069 % (class option \classoption{superscriptaddress}).
3070 %
3071 % This procedure must ensure that any paragraph that it starts gets ended finally.
3072 % \begin{macrocode}
3073 \def\frontmatter@author@produce@script{%
3074 \begingroup
3075 \let\@author@present\@author@present@script
3076 % \end{macrocode}
3077 % \changes{v4.l}{1998/09/01}
3078 % {Changes to add collaboration processing, which now
3079 % means doing comma/and processing on each sublist}
3080 % When the author/affiliation list \cmd\@AAC@list\ is executed,
3081 % \cmd\@tempcnt\ counts each author,
3082 % and
3083 % \cmd\@tempa\ stores a list of author indices for the current collaboration.
3084 %
3085 % Note: this procedure uses \cmd\AU@temp\ to hold a list of author counts for each collaboration.
3086 % Note: also uses \cmd\@tempcnta\ to communicate between procedures.
3087 % This usage ot \cmd\@tempcnta\ is OK, because the expansion of \cmd\@AAC@list\ will trigger only the execution of
3088 % our own procedures.
3089 % \begin{macrocode}
3090 \let\AU@temp\@empty
3091 \@tempcnta\z@
3092 % \end{macrocode}
3093 %
3094 % We wish to know how many authors are in each collaboration, for the purposes of \cmd\listcomma\ and \cmd\listand.
3095 %
3096 % Here we assign values for the intercollated operators appearing within \cmd\@AAC@list,
3097 % then execute that macro, registering the authors in each collaboration.
3098 % Afterwards, clean up by emulating an empty collaboration.
3099 %
3100 % The result, stored in \cmd\AU@temp, is a list of brace-delmited tokens, each a number
3101 % representing the number of authors in that collaboration.
3102 % \begin{macrocode}
3103 \let\AF@opr \@gobble
3104 \def\AU@opr{\@author@count\@tempcnta}%
3105 \def\CO@opr{\@collaboration@count\AU@temp\@tempcnta}%
3106 \@AAC@list
3107 \expandafter\CO@opr\@author@cleared
3108 % \end{macrocode}
3109 % Next, present the authors and their affiliations.
3110 %
3111 % We assign values for the intercollated operators appearing within \cmd\@AAC@list.
3112 % Next, assign \cmd\@listcomma\ based on the number of authors in the first collaboration.
3113 % Then expand \cmd\@AAC@list.
3114 %
3115 % Upon completion, there will be two space tokens following the last author because of \cmd\listand\ processing;
3116 % remove them, then end the last paragraph.
3117 %
3118 % FIXME: this juncture would be a good time to effectively eliminate the unused affiliations in \cmd\@AFF@list.
3119 % \begin{macrocode}
3120 \begingroup
3121 \frontmatter@authorformat
3122 \let\AF@opr \@affilID@def
3123 \let\AU@opr \@author@present
3124 \def\CO@opr{\@collaboration@present\AU@temp}%
3125 \set@listcomma@list\AU@temp
3126 \@AAC@list
3127 \unskip\unskip
3128 \par
3129 \endgroup
3130 % \end{macrocode}
3131 % We now list out the affiliations in the order they appeared.
3132 % \begin{macrocode}
3133 \begingroup
3134 \frontmatter@above@affiliation@script
3135 % \let\@AFU@list\@empty
3136 % \let\AFS@opr \affils@present@script
3137 % \@AFG@list
3138 % \let\AF@opr \affil@present@script
3139 % \@AFU@list
3140 \let\AFF@opr \@affil@script
3141 % \say\@AFF@list
3142 \@AFF@list
3143 \frontmatter@footnote@produce
3144 \par
3145 \endgroup
3146 \endgroup
3147 }%
3148 % \end{macrocode}
3149 % \end{macro}
3150 %
3151 % \begin{macro}{\@author@count}
3152 % This version of \cmd\AU@opr\ counts the number of authors it processes.
3153 % \begin{macrocode}
3154 \def\@author@count#1{\advance#1\@ne\@author@gobble}%
3155 % \end{macrocode}
3156 % \end{macro}
3157 %
3158 % \begin{macro}{\@collaboration@present}
3159 % Format a collaboration.
3160 % Note that we immediately end the paragraph thus begun, because we only support
3161 % \classoption{superscriptaddress}-style processing.
3162 %
3163 % Note also that the execution of the production procedures takes place inside of a group;
3164 % for reasons of protective programming.
3165 %
3166 % Bug note: originally, the number of authors in each collaboration was stored in \cmd\@tempa,
3167 % but this exposed us to procedures in our production that modified the meaning of \cmd\@tempa.
3168 %
3169 % The last action done in this procedure is to assign \cmd\@listcomma\ based on the number of authors in the next collaboration.
3170 % \begin{macrocode}
3171 \def\@collaboration@present#1#2#3{%
3172 \par
3173 \begingroup
3174 \frontmatter@collaboration@above
3175 \@author@present{(\ignorespaces#2\unskip)}{#3}%
3176 \par
3177 \endgroup
3178 \set@listcomma@list#1%
3179 }%
3180 \def\frontmatter@collaboration@above{}%
3181 % \end{macrocode}
3182 % \end{macro}
3183 %
3184 % \begin{macro}{\@collaboration@count}
3185 % Simply register each author in this collaboration.
3186 % Note: \#1 is a \cmd\csname\ to hold the value, \#2 is the \cmd\count\ register holding the count of interest.
3187 % \begin{macrocode}
3188 \def\@collaboration@count#1#2{%
3189 \appdef@eval#1{\the#2}#2\z@
3190 \@author@gobble
3191 }%
3192 % \end{macrocode}
3193 % \end{macro}
3194 %
3195 % \begin{macro}{\@affilID@def}
3196 %
3197 % The \cmd\@affilID@def\ procedure, an alias of \cmd\AF@opr\ used during \cmd\frontmatter@author@produce@script\ processing,
3198 % memorizes the affiliation in \cmd\@affilID@temp.
3199 % \begin{macrocode}
3200 \def\@affilID@def{\def\@affilID@temp}%
3201 % \end{macrocode}
3202 % \end{macro}
3203 %
3204 % \begin{macro}{\@affilID@temp}
3205 %
3206 % The macro \cmd\@affilID@temp\ is used to communicate between
3207 % \cmd\doauthor\ and instances of \cmd\AF@opr\ within the author list.
3208 % \begin{macrocode}
3209 \let\@affilID@temp\@empty
3210 % \end{macrocode}
3211 % \end{macro}
3212 %
3213 % \begin{macro}{\affils@present@script}
3214 % An alias of \cmd\AFS@opr, this procedure is applied to \cmd\@AFG@list\ and builds
3215 % \cmd\@AFU@list, a list of unique affiliations found within affiliation groups.
3216 %
3217 % \begin{macrocode}
3218 %\def\affils@present@script#1{%
3219 % \get@affil#1{}%
3220 %}%
3221 %\def\get@affil#1{%
3222 % \def\@tempa{#1}%
3223 % \@ifx{\@empty\@tempa}{}{%
3224 % \@booleanfalse\temp@sw
3225 % \def\AF@opr{\x@match\@tempa}%
3226 % \@AFU@list
3227 % \temp@sw{}{%
3228 % \appdef\@AFU@list{\AF@opr{#1}}%
3229 % }%
3230 % \get@affil
3231 % }%
3232 %}%
3233 % \end{macrocode}
3234 % \end{macro}
3235 %
3236 % \begin{macro}{\affil@present@script}
3237 % An alias of \cmd\AF@opr, this procedure is applied to \cmd\@AFU@list\ when formatting the affiliations
3238 % under \classoption{superscriptaddress}.
3239 % It in turn applies \cmd\affil@script\ to \cmd\@AFF@list, thereby formatting the affiliation
3240 % associated with this affiliation index.
3241 %
3242 % Note: it traverses the \cmd\@AFF@list\ for each entry in the \cmd\@AFU@list, thereby making this
3243 % portion of code execute in $N^{2}$ time.
3244 % \begin{macrocode}
3245 %\def\affil@present@script#1{%
3246 % \def\@tempa{#1}%
3247 % \begingroup
3248 % \frontmatter@affiliationfont
3249 % \let\AFF@opr \affil@script
3250 % \@AFF@list
3251 % \endgroup
3252 %}%
3253 % \end{macrocode}
3254 % \end{macro}
3255 %
3256 % \begin{macro}{\affil@script}
3257 % Alias of \cmd\AFF@opr, this procedure is applied to \cmd\@AFF@list\ when formatting the affiliations
3258 % under \classoption{superscriptaddress}.
3259 % It rejects all entries not matching the affiliation index held in \cmd\@tempa.
3260 % \begin{macrocode}
3261 \def\affil@script#1#2#3{%
3262 \def\@tempifx{#1}\@ifx{\@tempifx\@tempa}{%
3263 \@if@empty{#2}{}{%
3264 \par
3265 \begingroup
3266 \textsuperscript{\normalfont#1}%
3267 #2%
3268 \@if@empty{#3}{}{\frontmatter@footnote{#3}}%
3269 \par
3270 \endgroup
3271 }%
3272 }{}%
3273 }%
3274 % \end{macrocode}
3275 % \end{macro}
3276 %
3277 % \begin{macro}{\@affil@script}
3278 % Alias of \cmd\AFF@opr:
3279 % The affiliations are being formatted in the case
3280 % where affiliations are being superscripted:
3281 % make a list out of the affiliations with the numbers printed.
3282 % Society-specific code can change the formatting
3283 % by overriding the definition of \cmd\frontmatter@affiliationfont.
3284 %
3285 % FIXME: dead code.
3286 % \begin{macrocode}
3287 \def\@affil@script#1#2#3{%
3288 \@ifnum{#1=\z@}{}{%
3289 \par
3290 \begingroup
3291 \frontmatter@affiliationfont
3292 % \textsuperscript{\normalfont#1}%
3293 \textsuperscript{#1}%
3294 #2%
3295 \@if@empty{#3}{}{\frontmatter@footnote{#3}}%
3296 \par
3297 \endgroup
3298 }%
3299 }%
3300 % \end{macrocode}
3301 % \end{macro}
3302 %
3303 % \begin{macro}{\@author@present@script}
3304 % \changes{v4.h}{1998/06/25}
3305 % {Changes to support groups of affiliations}
3306 % This version of \cmd\AU@opr\ applies to the \classoption{superscriptaddress} class option.
3307 % Need to add commas between groups
3308 % of address numbers, which are passed in the macro \cmd\@affilID@temp\ in the form
3309 % |{3}{4}{7}| if this set of authors is related to addresses, 3, 4 and 7.
3310 % \begin{macrocode}
3311 \def\@author@present@script#1#2{%
3312 \begingroup
3313 % \parskip\@author@parskip\relax
3314 \gdef\comma@space{\textsuperscript{,\,}}%
3315 % \@ifx{\@affilID@temp\@empty}{%
3316 % \doauthor{#1}{#2}{}%
3317 % }{%
3318 % \expandafter\set@count@\@affilID@temp{}{}\@@nil
3319 % \@ifnum{\count@=\z@}{%
3320 % \doauthor{#1}{#2}{}%
3321 % }{%
3322 % \doauthor{#1}{#2}{%
3323 % \textsuperscript{\expandafter\@affilcomma\@affilID@temp\relax\relax}%
3324 % }%
3325 % }%
3326 % }%
3327 \doauthor{#1}{#2}{%
3328 \let\@tempa\@empty
3329 \expandafter\@affil@present@script\@affilID@temp\relax
3330 }%
3331 \endgroup
3332 \advance\@tempcnta\m@ne
3333 }%
3334 %\def\set@count@#1#2\@@nil{%
3335 % \count@#1\relax
3336 %}%
3337 \def\@affilcomma#1#2{%
3338 \@ifx{\z@#1}{%
3339 \@ifx{\relax#2}{}{%
3340 \@affilcomma{#2}%
3341 }%
3342 }{%
3343 #1%
3344 \@ifx{\relax#2}{}{%
3345 \@ifx{\z@#2}{%
3346 \@affilcomma
3347 }{%
3348 ,\,\@affilcomma{#2}%
3349 }%
3350 }%
3351 }%
3352 }%
3353 \def\@affil@present@script#1{%
3354 \@ifx{\relax#1}{%
3355 \@ifx{\@tempa\@empty}{}{%
3356 \textsuperscript{\expandafter\@affilcomma\@tempa\relax\relax}%
3357 }%
3358 }{%
3359 \@ifx{\z@#1}{}{\appdef\@tempa{{#1}}}%
3360 \@affil@present@script
3361 }%
3362 }%
3363 \@provide\@author@parskip{\z@skip}%
3364 % \end{macrocode}
3365 % \end{macro}
3366 %
3367 %
3368 % \subsubsection{Authors and affiliations in groupedaddress style}
3369 %
3370 % \begin{macro}{\frontmatter@author@produce@group}
3371 % \cmd\frontmatter@author@produce@group\ is an alias for \cmd\frontmatter@author@produce,
3372 % the procedure that formats the author/affiliation list when \classoption{groupedaddress} is in effect.
3373 %
3374 % In this case, the authors are being grouped above their shared addresses.
3375 % How it works: the \cmd\@AFG@list, a list of all unique affiliation groups, is expanded.
3376 % For each such group, all authors belonging to that group are formatted above the affiliation group.
3377 % Collaborations are silently passed over.
3378 %
3379 % This procedure must ensure that any paragraph that it starts gets ended finally.
3380 % \begin{macrocode}
3381 \def\frontmatter@author@produce@group{%
3382 \begingroup
3383 \let\@author@present\@author@present@group
3384 \frontmatter@authorformat
3385 \let\AFS@opr \affils@present@group
3386 \let\@listcomma\relax
3387 \@AFG@list
3388 \frontmatter@footnote@produce
3389 \par
3390 \endgroup
3391 \frontmatter@authorbelow
3392 }%
3393 \@provide\frontmatter@authorbelow{}%
3394 % \end{macrocode}
3395 % \end{macro}
3396 %
3397 % \begin{macro}{\affils@present@group}
3398 % Alias of \cmd\AFS@opr, this procedure is used on every element of
3399 % \cmd\@AFG@list, the list of unique affiliation groups,
3400 % when formatting the author/affiliation block:
3401 % It presents all authors sharing this affiliation group.
3402 %
3403 % This procedure is called via the procedure
3404 % \cmd\frontmatter@author@produce@group, an alias for \cmd\frontmatter@author@produce,
3405 %
3406 % Its use pertains to the class options
3407 % \classoption{groupedaddress}, \classoption{unsortedaddress}, and \classoption{runinaddress}
3408 % (that is, \cmd\groupauthors@sw\ is true).
3409 %
3410 % For each invocation, the entire \cmd\@AAC@list\ is run through (twice),
3411 % making this process execute in $N^{2}$ time. (Is this really true?)
3412 % \begin{macrocode}
3413 \def\affils@present@group#1{%
3414 % \end{macrocode}
3415 % Count (using \cmd\@tempcnta) the authors in the author list whose affiliation is |#1|.
3416 %
3417 % Note that \cmd\AF@temp\ is used as a storage register for the argument
3418 % of the procedure, for purposes of comparison using \cmd\ifx.
3419 %
3420 % Note: here we use \cmd\@tempcnta\ to communicate accumulate the number of authors in the current affiliation set.
3421 %
3422 % QUERY: does the value of \cmd\AF@temp\ and \cmd\AF@opr\ need to persist?
3423 %
3424 % QUERY: what value does \cmd\AU@opr\ have at this point?
3425 % ANSWER: the \cmd\@affilID@count\ and \cmd\@affilID@match\ procedures
3426 % assign meanings to \cmd\AU@opr\ and \cmd\CO@opr\ dynamically.
3427 % We initialize the two operators to \cmd\undefined\ so as to catch the
3428 % pathological cases.
3429 % \begin{macrocode}
3430 \begingroup
3431 \def\AF@temp{#1}% % 0B13
3432 \@tempcnta\z@
3433 \let\AU@opr \undefined % 0B13
3434 \let\CO@opr \undefined % 0B13
3435 \def\AF@opr{\@affilID@count\AF@temp\@tempcnta}% 0B13
3436 \@AAC@list
3437 % \end{macrocode}
3438 %
3439 % If no authors using this affiliation group, skip it.
3440 % \begin{macrocode}
3441 \@ifnum{\@tempcnta=\z@}{}{%
3442 % \end{macrocode}
3443 %
3444 % DPC: If we have a list of length two, need to locally zap a comma.
3445 % \begin{macrocode}
3446 \begingroup
3447 \frontmatter@above@affilgroup
3448 \set@listcomma@count\@tempcnta
3449 % \end{macrocode}
3450 % Run through the author list, presenting (with \cmd\@author@present)
3451 % those authors whose affiliation matched the given one.
3452 % \begin{macrocode}
3453 \let\AU@opr \undefined % 0B13
3454 \let\CO@opr \undefined % 0B13
3455 \def\AF@opr{\@affilID@match\AF@temp}%
3456 \@AAC@list
3457 \endgroup
3458 % \end{macrocode}
3459 % Now that the authors have all been presented, present the affiliations, grouped.
3460 %
3461 % Note: \cmd\@tempcnta\ is used to count the number of affiliations for this set of authors.
3462 % \begin{macrocode}
3463 \begingroup
3464 \par
3465 \frontmatter@above@affiliation
3466 \frontmatter@affiliationfont
3467 \let\\\frontmatter@addressnewline
3468 \@tempcnta\z@
3469 \@tfor\AF@temp:=#1\do{%
3470 \expandafter\@ifx\expandafter{\z@\AF@temp}{}{%
3471 \advance\@tempcnta\@ne
3472 }%
3473 }%
3474 \@ifnum{\@tempcnta=\tw@}{%
3475 \let\@listcomma\relax
3476 }{}%
3477 \def\after@address{\@listcomma\ \@listand}%
3478 \runinaddress@sw{%
3479 }{%
3480 \tightenlines@sw{%
3481 }{%
3482 \parskip\z@ %space between affilations in grouped mode
3483 }%
3484 \appdef\after@address\par
3485 }%
3486 \let\AFF@opr \@affil@group
3487 \do@affil@fromgroup\@AFF@list#1\relax
3488 \endgroup
3489 % \end{macrocode}
3490 % End of branch handling authors.
3491 % \begin{macrocode}
3492 }%
3493 % \end{macrocode}
3494 %
3495 % \begin{macrocode}
3496 \par
3497 \endgroup
3498 %\smallskip
3499 }%
3500 % \end{macrocode}
3501 % \end{macro}
3502 %
3503 % \begin{macro}{\@affilID@count}
3504 % \begin{macro}{\@affilID@match}
3505 %
3506 % The control sequence name \cmd\AF@opr\ is placed in the
3507 % author/affiliation list (\cmd\@AAC@list) for each (new) affiliation, with that affiliation as its argument.
3508 %
3509 % The control sequence name \cmd\AF@opr\ is an alias of a procedure
3510 % to count the number of authors at a given affiliation (\cmd\@affilID@count)
3511 % or to present the given authors (\cmd\@affilID@match).
3512 % These two procedures are executed when formatting under the \classoption{groupedaddress} class option.
3513 % \begin{macrocode}
3514 \def\@affilID@count#1#2#3{%
3515 \def\@tempifx{#3}%
3516 \@ifx{\@tempifx#1}{%
3517 \def\AU@opr{\@author@count#2}%
3518 }{%
3519 \let\AU@opr \@author@gobble
3520 }%
3521 \let\CO@opr \@collaboration@err
3522 }%
3523 \def\@affilID@match#1#2{%
3524 \def\@tempifx{#2}%
3525 \@ifx{\@tempifx#1}{%
3526 \let\AU@opr \@author@present
3527 }{%
3528 \let\AU@opr \@author@gobble
3529 }%
3530 \let\CO@opr \@collaboration@err
3531 }%
3532 % \end{macrocode}
3533 % \end{macro}
3534 % \end{macro}
3535 %
3536 % \begin{macro}{\do@affil@fromgroup}
3537 % Executes iteratively:
3538 % selects the next address ID to print,
3539 % and then re-execute the list of addresses to print the text of that address.
3540 %
3541 % Note: an argument of \cmd\relax\ breaks out of this iteration,
3542 % while an argument of \cmd\z@\ (\cmd\noaffiliation) is a no-op.
3543 %
3544 % Note: we have createed an $N^{2}$ computing process.
3545 % FIXME: can use hashing instead, you know.
3546 % \begin{macrocode}
3547 \def\do@affil@fromgroup#1#2{%
3548 \@ifx{\relax#2}{}{%
3549 \count@#2\relax
3550 \@ifnum{\count@=\z@}{}{#1}%
3551 \do@affil@fromgroup#1%
3552 }%
3553 }%
3554 % \end{macrocode}
3555 % \end{macro}
3556 %
3557 % \begin{macro}{\@affil@group}
3558 % The alias of \cmd\AFF@opr\ when the list \cmd\@AFF@list\
3559 % is executed by \cmd\do@affil@fromgroup (\classoption{groupedaddress}):
3560 % Print the address if its number matches \cmd\count@\ (value set by \cmd\do@affil@fromgroup).
3561 %
3562 % Note that we detect a \cmd\noaffiliation\ here by the second parameter's being the token \cmd\blankaffiliation.
3563 % \begin{macrocode}
3564 \def\@affil@group#1#2#3{%
3565 \@ifnum{\count@=#1\relax}{%
3566 \@ifx{#2\blankaffiliation}{}{%
3567 #2%
3568 \@if@empty{#3}{}{%
3569 \frontmatter@footnote{#3}%
3570 }%
3571 \after@address
3572 }%
3573 \advance\@tempcnta\m@ne
3574 }{}%
3575 }%
3576 % \end{macrocode}
3577 % \end{macro}
3578 %
3579 % \begin{macro}{\@author@present@group}
3580 % \changes{v4.d}{1998/01/31}
3581 % {\cs{comma@space}}
3582 % This version of \cmd\AU@opr\ applies to the \classoption{groupedaddress} class option.
3583 % Traverse the list calling the \cmd\doauthor\ hook on each author.
3584 % \begin{macrocode}
3585 \def\@author@present@group#1#2{%
3586 \gdef\comma@space{\gdef\comma@space{\textsuperscript{,\,}}}%
3587 \doauthor{#1}{#2}{}%
3588 \advance\@tempcnta\m@ne
3589 }%
3590 % \end{macrocode}
3591 % \end{macro}
3592 %
3593 %
3594 % \begin{macro}{\@pacs@produce}
3595 % PACS, keywords and dates.
3596 % \changes{v4.d}{1998/01/31}
3597 % {PACS boxed to width of abstract}
3598 % \changes{v4.0beta 2}{1999/06/20}
3599 % {Separate option now controls production}
3600 % \changes{v4.0beta 5}{2000/09/20}
3601 % {Warn if no production}
3602 % \begin{macrocode}
3603 \def\@pacs@produce#1{%
3604 \showPACS@sw{%
3605 \begingroup
3606 \frontmatter@PACS@format
3607 \@pacs@name#1\par
3608 \endgroup
3609 }{%
3610 \@if@empty{#1}{}{%
3611 \class@warn{\PACS@warn}%
3612 }%
3613 }%
3614 }%
3615 \def\PACS@warn{If you want your PACS to appear in your output, use document class option showpacs}%
3616 % \end{macrocode}
3617 % \end{macro}
3618 %
3619 % \begin{macro}{\@keywords@produce}
3620 % \changes{v4.0beta 5}{2000/09/20}
3621 % {Keywords on same footing as PACS}
3622 % \begin{macrocode}
3623 \def\@keywords@produce#1{%
3624 \showKEYS@sw{%
3625 \begingroup
3626 \frontmatter@keys@format
3627 \@keys@name#1\par
3628 \endgroup
3629 }{%
3630 \@if@empty{#1}{}{%
3631 \class@warn{If you want your keywords to appear in your output, use document class option showkeys}%
3632 }%
3633 }%
3634 }%
3635 % \end{macrocode}
3636 % \end{macro}
3637 %
3638 % \begin{macro}{\frontmatter@footnote@produce@footnote}
3639 % \begin{macro}{\frontmatter@footnote@produce@endnote}
3640 % Produce any footnotes to appear at the bottom of the title page.
3641 %
3642 % If frontmatter footnotes have been redirected to the bibliography, this will be a no-op.
3643 % ref.: \cmd\present@bibnote.
3644 % \begin{macrocode}
3645 \def\frontmatter@footnote@produce@footnote{%
3646 \let\@TBN@opr\present@FM@footnote
3647 \@FMN@list
3648 \global\let\@FMN@list\@empty
3649 }%
3650 \def\present@FM@footnote#1#2{%
3651 \begingroup
3652 \csname c@\@mpfn\endcsname#1\relax
3653 \def\@thefnmark{\thempfn}%
3654 \frontmatter@footnotetext{#2}%
3655 \endgroup
3656 }%
3657 \def\frontmatter@footnote@produce@endnote{%
3658 }%
3659 % \end{macrocode}
3660 % \end{macro}
3661 % \end{macro}
3662 %
3663 % \begin{macro}{\frontmatter@thefootnote}
3664 % The in the title block, the footnote symbol (used for alternate affiliation and sundry)
3665 % is a \cmd\@fnsymbol\ or a lowercase letter, as selected by a boolean.
3666 % \begin{macrocode}
3667 \def\frontmatter@thefootnote{%
3668 \altaffilletter@sw{\@alph}{\@fnsymbol}\c@footnote
3669 }%
3670 % \end{macrocode}
3671 % \end{macro}
3672 %
3673 % \begin{macro}{\frontmatter@makefnmark}
3674 % The default procedure for setting the footnote mark within the frontmatter.
3675 % Journals will override this procedure.
3676 % \begin{macrocode}
3677 \def\frontmatter@makefnmark{%
3678 \@textsuperscript{%
3679 \normalfont\@thefnmark
3680 }%
3681 }%
3682 % \end{macrocode}
3683 % \end{macro}
3684 %
3685 % \begin{macro}{\frontmatter@makefntext}
3686 % This procedure is used when setting footnotes within the title block.
3687 % \begin{macrocode}
3688 \long\def\frontmatter@makefntext#1{%
3689 \parindent 1em
3690 \noindent
3691 \Hy@raisedlink{\hyper@anchorstart{frontmatter@\the\c@footnote}\hyper@anchorend}%
3692 \@makefnmark
3693 #1%
3694 }%
3695 % \end{macrocode}
3696 % \end{macro}
3697 %
3698 % \begin{macro}{\frontmatter@setup}
3699 % The default type specification for the title page.
3700 % Journals will override this definition.
3701 % \begin{macrocode}
3702 \def\frontmatter@setup{}%
3703 % \end{macrocode}
3704 % \end{macro}
3705 %
3706 % \begin{macro}{\frontmatter@RRAPformat}
3707 % \begin{macro}{\punct@RRAP}
3708 % \begin{macro}{\produce@RRAP}
3709 % The procedure \cmd\frontmatter@RRAPformat\ is the formatting procedure
3710 % for the ``Received, Revised, etc.'' block on the title page.
3711 % The macro \cmd\punct@RRAP\ produces the punctuation between the entries.
3712 % Journals will override these two definitions.
3713 %
3714 % The procedure \cmd\produce@RRAP\ is fairly general, and should be used by most
3715 % journal substyles.
3716 %
3717 % The procedure \cmd\frontmatter@RRAP@format\ will be overridden by the journal.
3718 % \begin{macrocode}
3719 \def\frontmatter@RRAPformat#1{%
3720 \removelastskip
3721 \begingroup
3722 \frontmatter@RRAP@format
3723 #1\par
3724 \endgroup
3725 }%
3726 \def\punct@RRAP{; }%
3727 \def\produce@RRAP#1{%
3728 \@if@empty{#1}{}{%
3729 \@ifvmode{\leavevmode}{\unskip\punct@RRAP\ignorespaces}%
3730 #1%
3731 }%
3732 }%
3733 % \end{macrocode}
3734 % \end{macro}
3735 % \end{macro}
3736 % \end{macro}
3737 %
3738 % \begin{macro}{\frontmatter@authorformat}
3739 % The default type specification for the author list.
3740 % Journals will override this definition.
3741 % \begin{macrocode}
3742 \def\frontmatter@authorformat{}%
3743 % \end{macrocode}
3744 % \end{macro}
3745 %
3746 % \begin{macro}{\frontmatter@above@affilgroup}
3747 % The default amount of space above an affiliation group
3748 % (in a \cmd\affils@present@group\ production).
3749 % Journals will override this definition.
3750 % \begin{macrocode}
3751 \def\frontmatter@above@affilgroup{}%
3752 % \end{macrocode}
3753 % \end{macro}
3754 %
3755 % \begin{macro}{\frontmatter@above@affiliation}
3756 % \begin{macro}{\frontmatter@above@affiliation@script}
3757 % The \cmd\frontmatter@above@affiliation\ is the amount of space above affiliations in the \classoption{groupedaddress}
3758 % style, and \cmd\frontmatter@above@affiliation@script\ is that for \classoption{superscriptaddress}.
3759 % Journals will override this definition.
3760 % \begin{macrocode}
3761 \def\frontmatter@above@affiliation{}%
3762 \def\frontmatter@above@affiliation@script{}%
3763 % \end{macrocode}
3764 % \end{macro}
3765 % \end{macro}
3766 %
3767 % \begin{macro}{\frontmatter@affiliationfont}
3768 % The default type specification for the affiliation.
3769 % Journals will override this definition.
3770 % \begin{macrocode}
3771 \def\frontmatter@affiliationfont{}%
3772 % \end{macrocode}
3773 % \end{macro}
3774 %
3775 % \begin{macro}{\frontmatter@RRAP@format}
3776 % The default type specification for the dates.
3777 % Journals will override this definition.
3778 % \begin{macrocode}
3779 \def\frontmatter@RRAP@format{}%
3780 % \end{macrocode}
3781 % \end{macro}
3782 %
3783 % \begin{macro}{\frontmatter@PACS@format}
3784 % Specify the formatting of the title page PACS statement.
3785 %
3786 % Journals will override.
3787 % \begin{macrocode}
3788 \def\frontmatter@PACS@format{}%
3789 % \end{macrocode}
3790 % \end{macro}
3791 %
3792 % \begin{macro}{\frontmatter@keys@format}
3793 % Specify the formatting of the title page keywords statement.
3794 %
3795 % Journals will override.
3796 % \begin{macrocode}
3797 \def\frontmatter@keys@format{}%
3798 % \end{macrocode}
3799 % \end{macro}
3800 %
3801 % \begin{macro}{\frontmatter@finalspace}
3802 %
3803 % \begin{macrocode}
3804 \def\frontmatter@finalspace{\addvspace{18\p@}}
3805 % \end{macrocode}
3806 % \end{macro}
3807 %
3808 % \begin{macro}{\frontmatter@addressnewline}
3809 % \changes{v4.h}{1998/06/25}
3810 % {new hook}
3811 % The definition of \cmd\\\ for address handling. Default puts all the `lines'
3812 % on a run-in line, separated by comma and space.
3813 % DPC: was \newline space between lines of addresss.
3814 % \begin{macrocode}
3815 \def\frontmatter@addressnewline{%
3816 \@ifhmode{\skip@\lastskip\unskip\unpenalty\break\hskip\skip@}{}%
3817 % was: \vskip-.5ex
3818 }%
3819 % \end{macrocode}
3820 % \end{macro}
3821 %
3822 %
3823 % \begin{macro}{\frontmatter@preabstractspace}
3824 % \begin{macro}{\frontmatter@postabstractspace}
3825 % Space above and space below abstract in title block
3826 % \begin{macrocode}
3827 \def\frontmatter@preabstractspace{5.5\p@}
3828 \def\frontmatter@postabstractspace{6.5\p@}
3829 % \end{macrocode}
3830 % \end{macro}
3831 % \end{macro}
3832 %
3833 % \begin{macro}{\aftermaketitle@chk}
3834 % Error-checking code.
3835 % \begin{macrocode}
3836 \def\aftermaketitle@chk#1{%
3837 \@ifx{\maketitle\relax}{%
3838 \class@err{\protect#1 must be used before \protect\maketitle}%
3839 }{}%
3840 }%
3841 % \end{macrocode}
3842 % \end{macro}
3843 %
3844 % \begin{macro}{\ps@titlepage}
3845 % Default page style for title page.
3846 % Journals will override this procedure.
3847 % \begin{macrocode}
3848 \def\ps@titlepage{\ps@empty}%
3849 % \end{macrocode}
3850 % \end{macro}
3851 %
3852 %FIXME: there is a limitation to the default meaning of
3853 % \cmd\@startpage, the label ``FirstPage'' is only
3854 % defined if the document has a \cmd\maketitle\ command.
3855 %
3856 % \begin{macrocode}
3857 \def\volumeyear#1{\gdef\@volumeyear{#1}}%
3858 \def\@volumeyear{}%
3859 \def\volumenumber#1{\gdef\@volumenumber{#1}}%
3860 \def\@volumenumber{}%
3861 \def\issuenumber#1{\gdef\@issuenumber{#1}}%
3862 \def\@issuenumber{}%
3863 \def\eid#1{\gdef\@eid{#1}}%
3864 \def\@eid{}%
3865 %
3866 \def\startpage#1{\gdef\@startpage{#1}\c@page#1\relax}%
3867 \def\@startpage{\pageref{FirstPage}}%
3868 \def\endpage#1{\gdef\@endpage{#1}}%
3869 \def\@endpage{\pageref{LastPage}}%
3870 % \end{macrocode}
3871 %
3872 %
3873 % \subsection{Printing out the ``list-of'' elements}%
3874 %
3875 % FIXME: The \cmd\appendix@toc\ procedure should change the meaning
3876 % of \cmd\l@section\ so that the \cmd\section s can be appropriately formatted,
3877 % reflecting their status as appendices.
3878 %
3879 % \begin{macrocode}
3880 \def\print@toc#1{%
3881 \begingroup
3882 % \c@secnumdepth-\maxdimen
3883 \expandafter\section
3884 \expandafter*%
3885 \expandafter{%
3886 \csname#1name\endcsname
3887 }%
3888 \let\appendix\appendix@toc
3889 \@starttoc{#1}%
3890 \endgroup
3891 }%
3892 \def\appendix@toc{}%
3893 % \end{macrocode}
3894 %
3895 %
3896 % \section{Body}
3897 %
3898 % \subsection{counters}
3899 % The following definitions are probably identical to those in
3900 % \file{classes.dtx}%
3901 % \begin{macrocode}
3902 \def\labelenumi{\theenumi.}
3903 \def\theenumi{\arabic{enumi}}
3904 % \end{macrocode}
3905 %
3906 % \begin{macrocode}
3907 \def\labelenumii{(\theenumii)}
3908 \def\theenumii{\alph{enumii}}
3909 \def\p@enumii{\theenumi}
3910 % \end{macrocode}
3911 %
3912 % \begin{macrocode}
3913 \def\labelenumiii{\theenumiii.}
3914 \def\theenumiii{\roman{enumiii}}
3915 \def\p@enumiii{\theenumi(\theenumii)}
3916 % \end{macrocode}
3917 %
3918 % \begin{macrocode}
3919 \def\labelenumiv{\theenumiv.}
3920 \def\theenumiv{\Alph{enumiv}}
3921 \def\p@enumiv{\p@enumiii\theenumiii}
3922 % \end{macrocode}
3923 %
3924 % \begin{macrocode}
3925 \def\labelitemi{\textbullet}
3926 \def\labelitemii{\normalfont\bfseries\textendash}
3927 \def\labelitemiii{\textasteriskcentered}
3928 \def\labelitemiv{\textperiodcentered}
3929 % \end{macrocode}
3930 %
3931 % \begin{macrocode}
3932 \pagenumbering{arabic}
3933 % \end{macrocode}
3934 %
3935 % \subsection{float parameters}
3936 %
3937 % from the old aps.sty. (DPC: same as article I think)
3938 % AO: here, \LaTeX's standard classes fail very poorly
3939 % (the price of backward compatability): the values for
3940 % \cmd\floatpagefraction\ and \cmd\dblfloatpagefraction\
3941 % need to be raised to avoid creating extremely short
3942 % float pages.
3943 % \begin{macrocode}
3944 \setcounter{topnumber}{2}
3945 \def\topfraction{.9}
3946 \setcounter{bottomnumber}{1}
3947 \def\bottomfraction{.9}
3948 \setcounter{totalnumber}{3}
3949 \def\textfraction{.1}
3950 \def\floatpagefraction{.9}
3951 \setcounter{dbltopnumber}{2}
3952 \def\dbltopfraction{.9}
3953 \def\dblfloatpagefraction{.9}
3954 % \end{macrocode}
3955 %
3956 % \subsection{List Environments}
3957 %
3958 % \begin{macrocode}
3959 \newenvironment{verse}{%
3960 \let\\=\@centercr
3961 \list{}{%
3962 \itemsep\z@ \itemindent -1.5em\listparindent \itemindent
3963 \rightmargin\leftmargin\advance\leftmargin 1.5em}\item[]%
3964 }{%
3965 \endlist
3966 }%
3967 % \end{macrocode}
3968 %
3969 % \begin{macrocode}
3970 \newenvironment{quotation}{%
3971 \list{}{%
3972 \listparindent 1.5em
3973 \itemindent\listparindent
3974 \rightmargin\leftmargin \parsep \z@ \@plus\p@}\item[]%
3975 }{%
3976 \endlist
3977 }%
3978 % \end{macrocode}
3979 %
3980 % \begin{macrocode}
3981 \newenvironment{quote}{%
3982 \list{}{%
3983 \rightmargin\leftmargin}\item[]%
3984 }{%
3985 \endlist
3986 }%
3987 % \end{macrocode}
3988 %
3989 % \begin{macrocode}
3990 \def\descriptionlabel#1{%
3991 \hspace\labelsep \normalfont\bfseries #1%
3992 }%
3993 % \end{macrocode}
3994 %
3995 % \begin{macrocode}
3996 \newenvironment{description}{%
3997 \list{}{%
3998 \labelwidth\z@ \itemindent-\leftmargin
3999 \let\makelabel\descriptionlabel
4000 }%
4001 }{%
4002 \endlist
4003 }%
4004 % \end{macrocode}
4005 %
4006 % \subsection{Sectioning Commands}
4007 %
4008 % \subsubsection{Counters and Their Productions}%
4009 % \begin{macrocode}
4010 \newcounter{part}
4011 \newcounter{section}
4012 \newcounter{subsection}[section]
4013 \newcounter{subsubsection}[subsection]
4014 \newcounter{paragraph}[subsubsection]
4015 \newcounter{subparagraph}[paragraph]
4016 % \end{macrocode}
4017 %
4018 % \begin{macrocode}
4019 \def\thepart {\Roman{part}} %
4020 \def\thesection {\Roman{section}}
4021 \def\p@section {}
4022 \def\thesubsection {\Alph{subsection}}
4023 \def\p@subsection {\thesection\,}
4024 \def\thesubsubsection {\arabic{subsubsection}}
4025 \def\p@subsubsection {\thesection\,\thesubsection\,}
4026 \def\theparagraph {\alph{paragraph}}
4027 \def\p@paragraph {\thesection\,\thesubsection\,\thesubsubsection\,}
4028 \def\thesubparagraph {\arabic{subparagraph}}
4029 \def\p@subparagraph {\thesection\,\thesubsection\,\thesubsubsection\,\theparagraph\,}
4030 % \end{macrocode}
4031 %
4032 % \subsubsection{The Acknowledgments Environment}%
4033 % This user-level markup produces a head introducing
4034 % the acknowledgments, and acts as a wrapper for the text.
4035 % In this implementation, it is an unnumbered section,
4036 % but appears within the toc.
4037 %
4038 % For compatiability's sake, we implement it under the alternative
4039 % spelling \env{acknowledgements}.
4040 % \changes{v4.0beta 3}{1999/11/13}
4041 % {also spelled ``acknowledgements''.}
4042 % \changes{v4.0beta 4}{2000/05/18}
4043 % {But alternative spelling is deprecated.}
4044 % \begin{macrocode}
4045 \newenvironment{acknowledgments}{%
4046 \acknowledgments@sw{%
4047 \section*{\acknowledgmentsname}%
4048 }{%
4049 \par
4050 \phantomsection
4051 \addcontentsline{toc}{section}{\protect\numberline{}\acknowledgmentsname}%
4052 }%
4053 }{%
4054 \par
4055 }%
4056 \@booleantrue\acknowledgments@sw
4057 \newenvironment{acknowledgements}{%
4058 \replace@environment{acknowledgements}{acknowledgments}%
4059 }{%
4060 \endacknowledgments
4061 }%
4062 % \end{macrocode}
4063 %
4064 % \subsubsection{Part Opener}%
4065 % section setup copied verbatim from revtex3 aps/osa.
4066 % Does not explicitly depend on pointsize options.
4067 % \begin{macrocode}
4068 \def\part{\par
4069 \addvspace{4ex}%
4070 \@afterindentfalse
4071 \secdef\@part\@spart}%
4072 % \end{macrocode}
4073 %
4074 % \begin{macrocode}
4075 \def\@part[#1]#2{%
4076 \@ifnum{\c@secnumdepth >\m@ne}{%
4077 \refstepcounter{part}%
4078 \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}%
4079 }{%
4080 \addcontentsline{toc}{part}{#1}%
4081 }%
4082 \begingroup
4083 \parindent \z@ \raggedright
4084 \interlinepenalty\@M
4085 \@ifnum{\c@secnumdepth >\m@ne}{%
4086 \Large \bf \partname~\thepart%
4087 \par\nobreak
4088 }{}%
4089 \huge \bf
4090 #2%
4091 \markboth{}{}\par
4092 \endgroup
4093 \nobreak
4094 \vskip 3ex
4095 \@afterheading
4096 }%
4097 % \end{macrocode}
4098 %
4099 % \begin{macrocode}
4100 \def\@spart#1{{\parindent \z@ \raggedright
4101 \interlinepenalty\@M
4102 \huge \bf
4103 #1\par}
4104 \nobreak
4105 \vskip 3ex
4106 \@afterheading}
4107 % \end{macrocode}
4108 %
4109 % \subsubsection{Stacked Heads}%
4110 % Here are the class default definitions for sectioning commands.
4111 % A society or a journal substyle will likely override these definitions.
4112 %
4113 % In doing so, you can customize the formatting for a particular level by defining,
4114 % e.g., \cmd\@hangfrom@section\ or \cmd\@subsectioncntformat.
4115 % \begin{macrocode}
4116 \def\section{%
4117 \@startsection
4118 {section}%
4119 {1}%
4120 {\z@}%
4121 {0.8cm \@plus1ex \@minus .2ex}%
4122 {0.5cm}%
4123 {\normalfont\small\bfseries}%
4124 }%
4125 % \end{macrocode}
4126 %
4127 % \begin{macrocode}
4128 \def\subsection{%
4129 \@startsection
4130 {subsection}%
4131 {2}%
4132 {\z@}%
4133 {.8cm \@plus1ex \@minus .2ex}%
4134 {.5cm}%
4135 {\normalfont\small\bfseries}%
4136 }%
4137 % \end{macrocode}
4138 %
4139 % \begin{macrocode}
4140 \def\subsubsection{%
4141 \@startsection
4142 {subsubsection}%
4143 {3}%
4144 {\z@}%
4145 {.8cm \@plus1ex \@minus .2ex}%
4146 {.5cm}%
4147 {\normalfont\small\itshape}%
4148 }%
4149 % \end{macrocode}
4150 %
4151 % \subsubsection{Runin Heads}%
4152 % \begin{macrocode}
4153 \def\paragraph{%
4154 \@startsection
4155 {paragraph}%
4156 {4}%
4157 {\parindent}%
4158 {\z@}%
4159 {-1em}%
4160 {\normalfont\normalsize\itshape}%
4161 }%
4162 % \end{macrocode}
4163 %
4164 % \begin{macrocode}
4165 \def\subparagraph{%
4166 \@startsection
4167 {subparagraph}%
4168 {5}%
4169 {\parindent}%
4170 {3.25ex \@plus1ex \@minus .2ex}%
4171 {-1em}%
4172 {\normalfont\normalsize\bfseries}%
4173 }%
4174 % \end{macrocode}
4175 %
4176 %
4177 % \subsection{Math}
4178 %
4179 % \begin{macro}{\theequation}
4180 % We change the production of the equation counter so that
4181 % we can accomodate the \classoption{eqsecnum} option.
4182 % \begin{macrocode}
4183 \def\theequation{%
4184 \theequation@prefix\arabic{equation}%
4185 }%
4186 \def\theequation@prefix{}%
4187 % \end{macrocode}
4188 % \end{macro}
4189 %
4190 %
4191 % \subsection{Type Size-Dependent Settings}
4192 %
4193 % Note that many parameters, as well as the meaning of
4194 % \cmd\normalsize, are deferred until
4195 % \cmd\AtEndOfClass\ time.
4196 % Therefore, code elsewhere in this class \emph{should not}
4197 % assume these things' values have been set!
4198 % \begin{macrocode}
4199 \AtEndOfClass{%
4200 \expandafter\input\expandafter{\@pointsize pt\substyle@ext}%
4201 }%
4202 % \end{macrocode}
4203 %
4204 %
4205 % \subsection{All Point Sizes}
4206 % \begin{macrocode}
4207 \setcounter{secnumdepth}{4}
4208 % \end{macrocode}
4209 %
4210 % \begin{macrocode}
4211 \lineskip 1pt
4212 \normallineskip 1pt
4213 \def\baselinestretch{1}%
4214 % \end{macrocode}
4215 %
4216 % \begin{macrocode}
4217 \@lowpenalty 51
4218 \@medpenalty 151
4219 \@highpenalty 301
4220 % \end{macrocode}
4221 %
4222 % \begin{macrocode}
4223 \@beginparpenalty -\@lowpenalty
4224 \@endparpenalty -\@lowpenalty
4225 \@itempenalty -\@lowpenalty
4226 % \end{macrocode}
4227 %
4228 % \begin{macrocode}
4229 \arraycolsep 3pt
4230 \tabcolsep 2pt
4231 \arrayrulewidth .4pt
4232 \doublerulesep 2pt
4233 % \end{macrocode}
4234 %
4235 % \begin{macrocode}
4236 \skip\@mpfootins = 0pt
4237 % \end{macrocode}
4238 %
4239 % \begin{macrocode}
4240 \fboxsep = 3.0pt
4241 \fboxrule = 0.4pt
4242 % \end{macrocode}
4243 %
4244 % \subsection{Figures}
4245 % \changes{v4.0beta 2}{1999/06/20}
4246 % {Processing delayed to \cs{AtBeginDocument} time}
4247 %
4248 % \begin{environment}{figure}
4249 % We define the \env{figure} environment.
4250 % Later, we will horse around with its meaning
4251 % in order to accomodate \cmd\floats@sw.
4252 % \begin{macrocode}
4253 \newenvironment{figure}
4254 {\@float{figure}}
4255 {\end@float}
4256 \newenvironment{figure*}
4257 {\@dblfloat{figure}}
4258 {\end@dblfloat}
4259 % \end{macrocode}
4260 % \end{environment}
4261 %
4262 % \begin{macro}{\@makecaption}
4263 % If caption is one line long, to be centered; if lines turn, then set justified.
4264 % \begin{macrocode}
4265 \newlength\abovecaptionskip
4266 \newlength\belowcaptionskip
4267 \setlength\abovecaptionskip{10\p@}
4268 \setlength\belowcaptionskip{2\p@}
4269 % \end{macrocode}
4270 %
4271 % \changes{v4.0beta 2}{1999/06/20}
4272 % {One-line caption sets flush left.}
4273 % \changes{v4.0beta 3}{1999/11/13}
4274 % {Prevent an inner footnote from performing twice}
4275 % \begin{macrocode}
4276 \long\def\@makecaption#1#2{%
4277 \par
4278 % \nobreak
4279 \vskip\abovecaptionskip
4280 \begingroup
4281 \small\rmfamily
4282 \sbox\@tempboxa{%
4283 \let\\\heading@cr
4284 #1: #2%
4285 }%
4286 \@ifdim{\wd\@tempboxa >\hsize}{%
4287 \begingroup
4288 \samepage
4289 \flushing
4290 \let\footnote\@footnotemark@gobble
4291 #1: #2\par
4292 \endgroup
4293 }{%
4294 \global \@minipagefalse
4295 \hb@xt@\hsize{\hfil\unhbox\@tempboxa\hfil}%
4296 }%
4297 \endgroup
4298 \vskip\belowcaptionskip
4299 }%
4300 \def\@footnotemark@gobble{%
4301 \@footnotemark
4302 \@ifnextchar[{\@gobble@opt@i}{\@gobble}%
4303 }%
4304 \def\@gobble@opt@i[#1]#2{}%
4305 \def\@mpmakefntext#1{%
4306 \flushing
4307 \parindent=1em
4308 \noindent
4309 \hb@xt@1em{\hss\@makefnmark}%
4310 #1%
4311 }%
4312 % \end{macrocode}
4313 % \end{macro}
4314 %
4315 % \begin{macro}{\thefigure}
4316 % The figure counter and float placement defaults.
4317 % \begin{macrocode}
4318 \newcounter{figure}
4319 \renewcommand \thefigure {\@arabic\c@figure}
4320 % \end{macrocode}
4321 % Note that we give the `!' modifier by default.
4322 % This is an effort to avoid the syndrome wherein
4323 % a deferred float finds itself unqualified for
4324 % placement, thereby getting carried until \cmd\clearpage.
4325 % \begin{macrocode}
4326 \def\fps@figure{tbp}
4327 \def\ftype@figure{1}
4328 \def\ext@figure{lof}
4329 \def\fnum@figure{\figurename~\thefigure}
4330 % \end{macrocode}
4331 % \end{macro}
4332 %
4333 % \subsubsection{Deferring \env{figure} Floats}%
4334 %
4335 % We install a hook at \cmd\AtBeginDocument\ time which determines if
4336 % figures will float or will be deferred until
4337 % \cmd\printfigures\ time.
4338 % \begin{macrocode}
4339 \appdef\class@documenthook{%
4340 \do@if@floats{figure}{.fgx}%
4341 }%
4342 \appdef\class@enddocumenthook{%
4343 \printfigures\relax
4344 }%
4345 % \end{macrocode}
4346 %
4347 % \begin{macro}{\printfigures}
4348 % The user-level command \cmd\printfigures\ determines
4349 % where the figures are to appear in a document in which
4350 % \cmd\floats@sw\ is false.
4351 % If the user invokes the \classoption{endfloats} class option and fails to
4352 % insert a \cmd\printfigures\ command,
4353 % the figures will be printed at the end of the document.
4354 % If the command is given, but floats are not being deferred,
4355 % it amounts to a no-op.
4356 % \changes{v4.0beta 2}{1999/06/20}
4357 % {call \cs{print@floats}}
4358 % \changes{v4.0beta 3}{1999/11/13}
4359 % {*-form mandates pagebreak}
4360 % \begin{macrocode}
4361 \newcommand\printfigures{%
4362 \@ifstar{\true@sw}{\floatp@sw{\true@sw}{\false@sw}}%
4363 {%
4364 \print@float{figure}{\oneapage}%
4365 }{%
4366 \print@float{figure}{}%
4367 }%
4368 }%
4369 % \end{macrocode}
4370 % \end{macro}
4371 %
4372 %
4373 % \begin{macro}{\@xfloat@prep}
4374 % We patch into the procedure \cmd\@xfloat@prep.
4375 % This patch applies to all floats (not \env{figure} alone)
4376 % and makes the type center.
4377 % \begin{macrocode}
4378 \appdef\@xfloat@prep{%
4379 \appdef\@parboxrestore{\centering}%
4380 \let\@makefnmark\@makefnmark@latex
4381 \let\@footnotemark\@footnotemark@latex
4382 }%
4383 % \end{macrocode}
4384 % \end{macro}
4385 %
4386 %
4387 % \subsection{Tables}
4388 % \changes{v4.0beta 2}{1999/06/20}
4389 % {Processing delayed to \cs{AtBeginDocument} time}
4390 %
4391 % DPC: More or less taken from \file{revtex2} \file{aps.sty},
4392 % but using dcolumn for decimal alignment.
4393 % \begin{environment}{table}
4394 % We define the \env{table} environment.
4395 % Later, we will horse around with its meaning
4396 % in order to accomodate \cmd\floats@sw.
4397 % \begin{macrocode}
4398 \newenvironment{table}
4399 {\@float{table}}
4400 {\end@float}
4401 \newenvironment{table*}
4402 {\@dblfloat{table}}
4403 {\end@dblfloat}
4404 % \end{macrocode}
4405 % \end{environment}
4406 %
4407 % \begin{macro}{\thetable}
4408 % Table counter and default float placement declarations.
4409 % \begin{macrocode}
4410 \newcounter{table}
4411 \renewcommand\thetable{\@Roman\c@table}
4412 % \end{macrocode}
4413 % Note that we give the `!' modifier by default.
4414 % This is an effort to avoid the syndrome wherein
4415 % a deferred float finds itself unqualified for
4416 % placement, thereby getting carried until \cmd\clearpage.
4417 % \begin{macrocode}
4418 \def\fps@table{tbp}
4419 \def\ftype@table{2}
4420 \def\ext@table{lot}
4421 \def\fnum@table{\tablename~\thetable}
4422 % \end{macrocode}
4423 % \end{macro}
4424 %
4425 % \begin{macro}{\table@hook}
4426 % \begin{macro}{\squeezetable}
4427 % Assign a meaning to the hook installed into float processing.
4428 %
4429 % By default floats are \cmd\small. The \cmd\squeezetable\ declaration
4430 % makes them smaller (\cmd\scriptsize). In general you can locally
4431 % redefine \cmd\table@hook\ to be whatever you like.
4432 % (DPC: |\Huge\color{magenta}|\ldots?)
4433 % \begin{macrocode}
4434 \def\table@hook{\small}%
4435 \def\squeezetable{\def\table@hook{\scriptsize}}%
4436 \appdef\@floatboxreset{\table@hook}%
4437 % \end{macrocode}
4438 % \end{macro}
4439 % \end{macro}
4440 %
4441 % \subsubsection{Deferring \env{table} Floats}%
4442 %
4443 % We install a hook at
4444 % \cmd\AtBeginDocument\ time which determines if
4445 % tables will float or will be deferred until
4446 % \cmd\printtables\ time.
4447 %
4448 % We also deal with the possibility of \env{longtable} environments.
4449 %
4450 % \begin{macrocode}
4451 \appdef\class@documenthook{%
4452 \floats@sw{}{%
4453 \let@environment{longtable@float}{longtable}%
4454 \let@environment{longtable}{longtable@write}%
4455 \let@environment{longtable*@float}{longtable*}%
4456 \let@environment{longtable*}{longtable*@write}%
4457 \let@environment{turnpage@float}{turnpage}%
4458 \let@environment{turnpage}{turnpage@write}%
4459 }%
4460 \do@if@floats{table}{.tbx}%
4461 }%
4462 \appdef\class@enddocumenthook{%
4463 \printtables\relax
4464 }%
4465 \newenvironment{longtable@write}{%
4466 \write@@float{longtable}{table}%
4467 }{%
4468 \endwrite@float
4469 }%
4470 \newenvironment{longtable*@write}{%
4471 \write@@float{longtable*}{table}%
4472 }{%
4473 \endwrite@float
4474 }%
4475 \newenvironment{turnpage@write}{%
4476 \immediate\write\tablewrite{\string\begin{turnpage}}%
4477 }{%
4478 \immediate\write\tablewrite{\string\end{turnpage}}%
4479 }%
4480 % \end{macrocode}
4481 %
4482 % \begin{macro}{\printtables}
4483 % The user-level command \cmd\printtables\ determines
4484 % where the tables are to appear in a document in which
4485 % \cmd\floats@sw\ is false.
4486 % If the user invokes the \classoption{nofloats} and fails to
4487 % insert a \cmd\printtables\ command,
4488 % the tables will be printed at the end of the document.
4489 % If the command is given, but floats are not being deferred,
4490 % it amounts to a no-op.
4491 % \changes{v4.0beta 2}{1999/06/20}
4492 % {only execute if appropriate}
4493 % \changes{v4.0beta 3}{1999/11/13}
4494 % {*-form mandates pagebreak}
4495 % \changes{v4.0beta 4}{2000/05/17}
4496 % {make longtable trigger the head, too}
4497 % \begin{macrocode}
4498 \newcommand\printtables{%
4499 \begingroup
4500 \let@environment{longtable}{longtable@float}%
4501 \let@environment{longtable*}{longtable*@float}%
4502 \let@environment{turnpage}{turnpage@anchored}%
4503 \prepdef\longtable{\trigger@float@par}%
4504 \expandafter\prepdef\csname longtable*\endcsname{\trigger@float@par}%
4505 \expandafter\prepdef\csname table@floats\endcsname{%
4506 \onecolumngrid@push
4507 }%
4508 \expandafter\appdef\csname endtable@floats\endcsname{%
4509 \onecolumngrid@pop
4510 }%
4511 \@ifstar{\true@sw}{\floatp@sw{\true@sw}{\false@sw}}%
4512 {%
4513 \print@float{table}{\oneapage}%
4514 }{%
4515 \print@float{table}{}%
4516 }%
4517 \endgroup
4518 }%
4519 \newenvironment{turnpage@anchored}{%
4520 \onecolumngrid@push
4521 \setbox\z@\vbox to\textwidth\bgroup
4522 \columnwidth\textheight
4523 }{%
4524 \vfil
4525 \egroup
4526 \rotatebox{90}{\box\z@}%
4527 \onecolumngrid@pop
4528 }%
4529 % \end{macrocode}
4530 % \end{macro}
4531 %
4532 %
4533 %
4534 % \section{Tabular}
4535 % Every tabular has a double (Scotch) rule above and below.
4536 % The column specifier ``d'' is implemented using the \classname{dcolumn}
4537 % package, if available.
4538 % FIXME: always load dcolumn!
4539 % \begin{macro}{\tabular@hook}
4540 % \begin{macro}{\endtabular@hook}
4541 % \begin{environment}{ruledtabular}
4542 % \begin{macrocode}
4543 \def\endtabular@hook{}%
4544 %\RequirePackage{dcolumn}%
4545 \appdef\class@documenthook{%
4546 \@ifpackageloaded{dcolumn}{%
4547 \newcolumntype{d}{D{.}{.}{-1}}%
4548 }{}%
4549 }%
4550 \def\toprule{\hline\hline}%
4551 \def\colrule{\hline}%
4552 \def\botrule{\hline\hline}%
4553 \newenvironment{ruledtabular}{%
4554 \def\array@default{v}%
4555 \appdef\tabular@hook{\def\@halignto{to\hsize}}%
4556 \let\tableft@skip@default\tableft@skip
4557 \let\tableft@skip\tableft@skip@float
4558 \let\tabmid@skip@default\tabmid@skip
4559 \let\tabmid@skip\tabmid@skip@float
4560 \let\tabright@skip@default\tabright@skip
4561 \let\tabright@skip\tabright@skip@float
4562 \let\array@row@pre@default\array@row@pre
4563 \let\array@row@pre\array@row@pre@float
4564 \let\array@row@pst@default\array@row@pst
4565 \let\array@row@pst\array@row@pst@float
4566 \appdef\array@row@rst{%
4567 \let\array@row@pre\array@row@pre@default
4568 \let\array@row@pst\array@row@pst@default
4569 \let\tableft@skip\tableft@skip@default
4570 \let\tabmid@skip\tabmid@skip@default
4571 \let\tabright@skip\tabright@skip@default
4572 \appdef\tabular@hook{\let\@halignto\@empty}%
4573 }%
4574 }{%
4575 }%
4576 % \end{macrocode}
4577 % \end{environment}
4578 % \end{macro}
4579 % \end{macro}
4580 %
4581 % \section{Footnote Text}
4582 %
4583 % \changes{v4.g}{1998/06/10}
4584 % {single space footnotes}
4585 % \changes{v4.0beta 2}{1999/06/20}
4586 % {%
4587 % Frank Mittelbach, has stated in \protect\classname{multicol}:
4588 % ``The kernel command \cs{@footnotetext} should not be modified.''
4589 % Thus, I have removed David Carlisle's redefinition of that command.
4590 % Note, however, that later versions of \protect\classname{multicol} do not require
4591 % this workaround. Belt and suspenders.
4592 % }%
4593 %
4594 % \begin{macro}{\@makefntext}
4595 % \begin{macrocode}
4596 \def\@makefntext#1{%
4597 \def\baselinestretch{1}%
4598 \reset@font\footnotesize
4599 \parindent 1em%
4600 \noindent
4601 \hb@[email protected]{%
4602 \Hy@raisedlink{\hyper@anchorstart{footnote@\the\c@footnote}\hyper@anchorend}%
4603 \hss\@makefnmark
4604 }%
4605 #1\par
4606 }%
4607 % \end{macrocode}
4608 % \end{macro}
4609 %
4610 %
4611 % \subsection{Citations, Bibliography, Endnotes}
4612 %
4613 % \subsubsection{Bibliography}
4614 %
4615 % Load Patrick Daly's \classname{natbib} package,
4616 % \url{ftp://ctan.tug.org/macros/latex/contrib/supported/natbib}
4617 %
4618 % Note that \classname{natbib} assumes that it loads
4619 % over a document class, such as the \classname{article} class,
4620 % that has already defined \env{thebibliography} and \cmd\@listi.
4621 %
4622 % Note also that \classname{natbib} also installs a command
4623 % \cmd\NAT@set@cites\ into \cmd\AtBeginDocument\ which presumes
4624 % that the proper \cmd\bibpunct\ command has been issued.
4625 %
4626 % We have a problem with \classname{natbib} in that it does not
4627 % accomodate late binding of its package options. This means
4628 % that those options must be known at the time the package
4629 % loads. Therefore, we select \classoption{sort\&compress}
4630 % now, and thereby foreclose on alternative uses of \classname{natbib}.
4631 %
4632 % Certain societies may prefer an alternative; they are out of luck.
4633 % If you find yourself in this position, please let the author
4634 % of \classname{natbib} know that his package should be modified to
4635 % accomodate late binding of package options.
4636 %
4637 % To remedy the situation, note that the macro \cmd\NAT@sort\ controls
4638 % whether citations are left alone (\cmd\NAT@sort=0), sorted (\cmd\NAT@sort=1), or sorted and compressed (\cmd\NAT@sort=2).
4639 % Since we give \classname{natbib} the \classoption{sort\&compress} option,
4640 % if you prefer \classoption{sort}, you need only define \cmd\NAT@sort\ to be 1.
4641 % However, if you prefer the effect of having neither \classoption{sort} nor \classoption{sort\&compress},
4642 % you must define \cmd\NAT@sort\ to be 0 and you must also define
4643 % \cmd\NAT@sort@cites:
4644 %\begin{verbatim}
4645 %\renewcommand\NAT@sort@cites[1]{\edef\NAT@cite@list{#1}}%
4646 %\end{verbatim}
4647 %
4648 % For other \classname{natbib} customizations, you may proceed as if you were going to use
4649 % the \file{natbib.cfg} file: anything that you can modify by this means is fair game.
4650 % Once \revtex\ is finished loading, you can assert any definitions for \classname{natbib} that you wish.
4651 %
4652 % \begin{macrocode}
4653 \newenvironment{thebibliography}{}{}%
4654 \let\@listi\@empty
4655 \RequirePackage[sort&compress]{natbib}[1999/05/28 7.0]%
4656 \let\NAT@thebibliography\thebibliography
4657 \let\NAT@endthebibliography\endthebibliography
4658 \let\bibliographystyle@latex\bibliographystyle
4659 % \end{macrocode}
4660 %
4661 % \begin{macro}{\NAT@citesuper}
4662 % We redefine \classname{natbib}'s procedure \cmd\NAT@citesuper,
4663 % which is executed when setting a superscript citation.
4664 % The \cmd\hspace\ is removed: in any case, it
4665 % should really be \cmd\hspace*, to prevent an unwanted pagebreak.
4666 % \begin{macrocode}
4667 \renewcommand\NAT@citesuper[3]{%
4668 \ifNAT@swa
4669 \leavevmode
4670 \unskip
4671 % \hspace{1\p@}%
4672 \textsuperscript{#1}%
4673 \if*#3*\else\ (#3)\fi
4674 \else
4675 #1%
4676 \fi
4677 \endgroup
4678 }%
4679 % \end{macrocode}
4680 % \end{macro}
4681 %
4682 % \begin{macro}{\@makefnmark@cite}
4683 % We define a procedure that will set a footnote mark the same way that
4684 % a citation is set. If footnotes are put in the bibliography with
4685 % \cmd\footinbib@sw, then the corresponding mark should look the same
4686 % as the result of a \cmd\cite. This is how we do it.
4687 % \begin{macrocode}
4688 \def\@makefnmark@cite{\begingroup\NAT@swatrue\@cite{{\@thefnmark}}{}{}}%
4689 % \end{macrocode}
4690 % \end{macro}
4691 %
4692 % \begin{macro}{\bibliographystyle}
4693 % We arrange for the selection of bibliography style
4694 % to occur either due to the document's explicit
4695 % \cmd\bibliographystyle\ statement or
4696 % via the journal substyle.
4697 %
4698 % Note that \revtex\ is now incompatible with
4699 % any package that patches \cmd\bibliographystyle,
4700 % except for those (like \classname{natbib}) that load before here.
4701 % \begin{macrocode}
4702 \let\bibliographystyle@latex\bibliographystyle
4703 \def\bibliographystyle{\def\@bibstyle}%
4704 % \end{macrocode}
4705 % \end{macro}
4706 %
4707 % \begin{macro}{\bibsection}
4708 % \begin{macro}{\NAT@bibsetnum}
4709 % \begin{macro}{\NAT@bibsetup}
4710 % \begin{macro}{\bibpreamble}
4711 % \begin{macro}{\newblock}
4712 % \begin{macro}{\bibnumfmt}
4713 % We define the sectioning command to use when starting the bibliography
4714 % and gently coax \classname{natbib} into using
4715 % the formatting procedures that \emph{we} want it to use.
4716 %
4717 % This way of setting up \env{thebibliography}
4718 % automatically sets the label width based on
4719 % the largest number used within the bibliography.
4720 % This scheme will not work properly using the
4721 % author/year style of bib entry, though.
4722 %
4723 % We define \cmd\bibnumfmt\ to be \cmd\place@bibnumber, which is a macro
4724 % managed by \revtex. If the document defines \cmd\bibnumfmt, then that
4725 % definition will be used instead, which is what the \classname{natbib}
4726 % package gives as its programming interface.
4727 %
4728 % And if the substyle does not give a meaning to \cmd\place@bibnumber,
4729 % we give it that of the original \cmd\bibnumfmt.
4730 % \begin{macrocode}
4731 \def\bibsection{%
4732 \@ifx@empty\refname{%
4733 \par
4734 }{%
4735 \let\@hangfroms@section\@hang@froms
4736 \section*{\refname}%
4737 \@nobreaktrue
4738 }%
4739 }%
4740 \let\NATx@bibsetnum\NAT@bibsetnum
4741 \def\NAT@bibsetnum#1{%
4742 \setlength{\topsep}{\z@}%
4743 \NATx@bibsetnum{\ref{LastBibItem}}%
4744 }%
4745 \let\NATx@bibsetup\NAT@bibsetup
4746 \def\NAT@bibsetup{%
4747 \setlength{\labelwidth}{\z@}%
4748 \setlength{\labelsep}{\z@}%
4749 \setlength{\itemindent}{\z@}%
4750 \setlength{\listparindent}{\z@}%
4751 \setlength{\topsep}{\z@}%
4752 \setlength{\parsep}{\z@}%
4753 \NATx@bibsetup
4754 }%
4755 \let\bibpreamble\@empty
4756 \def\newblock{\ }%
4757 \let\NATx@bibnumfmt\bibnumfmt
4758 \def\bibnumfmt{\place@bibnumber}%
4759 \AtEndOfClass{%
4760 \appdef\class@documenthook{%
4761 \@ifxundefined\place@bibnumber{%
4762 \let\place@bibnumber\NATx@bibnumfmt
4763 }{}%
4764 }%
4765 }%
4766 % \end{macrocode}
4767 % \end{macro}
4768 % \end{macro}
4769 % \end{macro}
4770 % \end{macro}
4771 % \end{macro}
4772 % \end{macro}
4773 %
4774 % \begin{macro}{\NAT@onlinecite}
4775 % We anticipate using numerical citations.
4776 % If superscript citations are used, we nonetheless need a way to
4777 % use numerical citations as required by the author.
4778 % These should be accessible via the \cmd\citet\ command.
4779 %
4780 % Therefore we remember how to do a numerical citation
4781 % even when the superscript citation has been selected.
4782 %
4783 % Can you say ``inelegant hack''? I knew you could!
4784 % \begin{macrocode}
4785 \let\NAT@citeyear\citeyear
4786 \def\NAT@onlinecite#1{%
4787 \begingroup
4788 \let\@cite\NAT@citenum
4789 \let\NAT@mbox\mbox
4790 \let\citeyear\NAT@citeyear
4791 \def\NAT@space{ }%
4792 \cite{#1}%
4793 \endgroup
4794 }%
4795 % \end{macrocode}
4796 % \end{macro}
4797 %
4798 % \begin{macro}{+}
4799 % \begin{macro}{\textcite}
4800 % We extend \classname{natbib}'s syntax with two commands to set a citation
4801 % on the baseline (as opposed to superscripted) and as text (rather than parenthetical), respectively.
4802 % A journal substyle that makes citations be superscripted or parenthetical as the case may be, should ensure
4803 % that the author has continued access to these two styles.
4804 %
4805 % \begin{macrocode}
4806 \appdef\class@inithook{%
4807 \@ifxundefined\@onlinecite{\def\@onlinecite{\citealp}}{}%
4808 \@ifxundefined\@textcite{\def\@textcite{\citet}}{}%
4809 }%
4810 \DeclareRobustCommand\onlinecite{\@onlinecite}%
4811 \DeclareRobustCommand\textcite{\@textcite}%
4812 % \end{macrocode}
4813 % \end{macro}
4814 % \end{macro}
4815 %
4816 % \begin{environment}{thebibliography}%
4817 % \begin{macro}{\present@bibnote}%
4818 % We put a tail patch into \cmd\thebibliogrphy\ and
4819 % a headpatch into \cmd\endthebibliography.
4820 %
4821 % We also apply a fix to the \cmd\list\ procedure
4822 % so that, at least within the bibliography,
4823 % items are not formatted via \cmd\parshape,
4824 % which caused problems during column balancing.
4825 % (Other list-like environments may also require fixing,
4826 % but we will save that for another day.)
4827 %
4828 % Here we provide a default treatment for frontmatter notes
4829 % deferred to the bibliography; a journal substyle
4830 % might want to override the definition of \cmd\present@bibnote.
4831 % \begin{macrocode}
4832 \renewenvironment{thebibliography}[1]{%
4833 \NAT@thebibliography{#1}%
4834 \@clubpenalty\clubpenalty
4835 \let\@TBN@opr\present@bibnote
4836 \@FMN@list
4837 }{%
4838 \@endnotesinbib
4839 \edef\@currentlabel{\arabic{NAT@ctr}}%
4840 \label{LastBibItem}%
4841 \NAT@endthebibliography
4842 \global\let\auto@bib\@empty
4843 }%
4844 \def\present@bibnote#1#2{%
4845 \item[%
4846 \textsuperscript{%
4847 \normalfont
4848 \Hy@raisedlink{\hyper@anchorstart{frontmatter@#1}\hyper@anchorend}%
4849 \begingroup
4850 \c@footnote#1\relax
4851 \frontmatter@thefootnote
4852 \endgroup
4853 }%
4854 ]#2\par
4855 }%
4856 % \end{macrocode}
4857 % \end{macro}
4858 % \end{environment}
4859 %
4860 % \begin{macro}{\place@bibnumber@sup}
4861 % \begin{macro}{\place@bibnumber@inl}
4862 % For producing the \cmd\bibitem\ device,
4863 % we define two procedures to select from.
4864 %
4865 % Note that we could have used \classname{natbib}'s \cmd\ifNAT@super\
4866 % switch, but it does not allow for altering the meaning of \cmd\bibnumfmt.
4867 % \begin{macrocode}
4868 \def\place@bibnumber@sup#1{\textsuperscript{#1}}%
4869 \def\place@bibnumber@inl#1{[#1]}%
4870 % \end{macrocode}
4871 % \end{macro}
4872 % \end{macro}
4873 %
4874 %% \begin{macro}{\@cite}
4875 %% \begin{macro}{\nocite}
4876 % \begin{macro}{write@bibliographystyle}
4877 % We wish to delay committing the \cmd\bibliographystyle\ until as late as possible.
4878 % The journal substyle will define a default bibliography style, and
4879 % the document's explicit \cmd\bibliographystyle\ command, if any, will override that default.
4880 %% For the sake of Bib\TeX, we must execute the \cmd\bibliographystyle\ command
4881 %% (putting a \cmd\bibstyle\ command into the auxiliary file)
4882 %% somewhere before the first \cmd\cite\ command (or any other like command),
4883 %% which puts a \cmd\citation\ command into the auxiliary file.
4884 %%
4885 %% Therefore, we headpatch the two procedures in \classname{natbib} that can result in
4886 %% the appearance in the auxiliary file of a \cmd\citation\ command.
4887 %% These two procedures are \cmd\@cite\ and \cmd\nocite.
4888 %%
4889 %% Not!
4890 %
4891 % The \cmd\bibstyle\ command may appear quite late in the \filename{.aux} file.
4892 % We now delay the automatic writing of the \cmd\bibstyle\ command to the end of the job.
4893 %
4894 % The procedure \cmd\write@bibliographystyle\ tests whether a \cmd\bibliographystyle\ command has
4895 % already been given.
4896 % If not, it effectively executes the needed \cmd\bibliographystyle\ command, then neutralizes itself
4897 % (we only need to do this once per job).
4898 %
4899 % \begin{macrocode}
4900 %\AtBeginDocument{%
4901 % \let\natbib@@cite\@cite
4902 % \def\@cite{\write@bibliographystyle\natbib@@cite}%
4903 % \let\natbib@nocite\nocite
4904 % \def\nocite{\write@bibliographystyle\natbib@nocite}%
4905 %}%
4906 \def\write@bibliographystyle{%
4907 \@ifxundefined\@bibstyle{}{%
4908 \expandafter\bibliographystyle@latex\expandafter{\@bibstyle}%
4909 }%
4910 \global\let\write@bibliographystyle\relax
4911 }%
4912 \AtEndDocument{\write@bibliographystyle}%
4913 % \end{macrocode}
4914 % \end{macro}
4915 %% \end{macro}
4916 %% \end{macro}
4917 %
4918 % \begin{macro}{\super@cite}
4919 % \begin{macro}{\super@cite@}
4920 % The \cmd\super@cite\ procedure takes the place of \cmd\@citex\ and implements the feature of the
4921 % \classoption{citeautoscript} class option.
4922 % This means that the document should be marked up as if citations were \emph{not} superscripted,
4923 % and then if you select a journal substyle that has superscripted citations, \revtex\ will do its best
4924 % to alter the formatting of the \cmd\cite s to accomodate superscript style.
4925 %
4926 % Note that the commands \cmd\onlinecite\ and \cmd\textcite\ are not affected by this procedure.
4927 %
4928 % Here's a subtle one: when is the argument of \cmd\super@cite@@\ not the same as the token \cmd\@let@token?
4929 % Answer: when the latter is \cmd\@sptoken! This case has to be handled separately.
4930 %
4931 % \begin{macrocode}
4932 \def\super@cite[#1][#2]#3{%
4933 \leavevmode
4934 \skip@\lastskip
4935 \unskip
4936 \begingroup
4937 \def\@tempa{[#1][#2]{#3}}%
4938 \super@cite@
4939 }%
4940 \def\super@cite@{%
4941 \futurelet\@let@token\super@cite@@
4942 }%
4943 \long\def\super@cite@@#1{%
4944 \@ifx{\@let@token\@sptoken}{%
4945 \aftergroup\@sptoken\false@sw
4946 }{%
4947 \@ifx{\@let@token.}{\true@sw}{%
4948 \@ifx{\@let@token,}{\true@sw}{%
4949 \@ifx{\@let@token'}{\true@sw}{%
4950 \@ifx{\@let@token)}{\true@sw}{%
4951 \false@sw
4952 }%
4953 }%
4954 }%
4955 }%
4956 }%
4957 {%
4958 #1%
4959 \super@cite@
4960 }{%
4961 \expandafter\@citex@NAT\@tempa\endgroup
4962 #1%
4963 }%
4964 }%
4965 \AtBeginDocument{%
4966 \citeautoscript@sw{%
4967 \@ifx{\place@bibnumber\place@bibnumber@sup}{%
4968 \let\@citex@NAT\@citex\let\@citex\super@cite
4969 }{}%
4970 }{}%
4971 }%
4972 % \end{macrocode}
4973 % \end{macro}
4974 % \end{macro}
4975 %
4976 %
4977 % Resolve an incompatability between \classname{natbib} and \classname{listings}.
4978 % The latter package tests \cmd\chapter (which has now been \cmd\let\ to \cmd\relax\ as a side effect \classname{natbib}'s use of \LaTeX's \cmd\@ifundefined).
4979 %
4980 % We couch our fix in such terms that will not be disruptive if \cmd\chapter\ is actually defined at this point.
4981 % \begin{macrocode}
4982 \@ifx{\chapter\relax}{\let\chapter\@undefined}{}%
4983 % \end{macrocode}
4984 %
4985 %
4986 % \subsubsection{\cs{endnote}s and \cs{rtx@bibnote}s}
4987 % FIXME: check hyperref compatibility!
4988 %
4989 % \begin{macro}{\mini@note}
4990 % \begin{macro}{\save@note}
4991 % \begin{macrocode}
4992 \def\mini@note{\save@note\mini@notes}%Implicit #1
4993 \def\save@note#1#2{%
4994 \stepcounter{footnote}%
4995 \protected@xdef\@thefnmark{\the\c@footnote}%
4996 \@footnotemark
4997 \expandafter\g@addto@macro
4998 \expandafter#1%
4999 \expandafter{%
5000 \expandafter \@@footnotetext
5001 \expandafter {\@thefnmark}{#2}%
5002 }%
5003 }%
5004 \long\def\@@footnotetext#1{\def\@thefnmark{#1}\@footnotetext}%
5005 \let\mini@notes\@empty
5006 % \end{macrocode}
5007 % \end{macro}
5008 % \end{macro}
5009 %
5010 % \begin{macro}{\endnote}
5011 % A version of footnote that appears at the end of the document.
5012 % Actually it just appears where \cmd\printendnotes\ appears.
5013 % \begin{macrocode}
5014 \def\endnote{%
5015 \begingroup
5016 \aftergroup\@footnotemark
5017 \aftergroup\@endnotetext
5018 \@ifnextchar[{%
5019 \@xendnote
5020 }{%
5021 \stepcounter{footnote}%
5022 \protected@xdef\@tempa{\thefootnote}%
5023 \expandafter\@xendnote\expandafter[\@tempa]%
5024 }%
5025 }%
5026 % \end{macrocode}
5027 % \end{macro}
5028 %
5029 % \begin{macro}{\@xendnote}
5030 % \begin{macrocode}
5031 \def\@xendnote[#1]{%
5032 \begingroup
5033 \c@footnote#1\relax
5034 \unrestored@protected@xdef\@thefnmark{endnote\thefootnote}%
5035 \endgroup
5036 \endgroup
5037 }%
5038 \def\@endnotemark{%
5039 \expandafter\cite\expandafter{\@thefnmark}%
5040 }%
5041 % \end{macrocode}
5042 % \end{macro}
5043 %
5044 % \begin{macro}{\endnote@ext}
5045 % \begin{macrocode}
5046 \def\endnote@ext{.end}%
5047 % \end{macrocode}
5048 % \end{macro}
5049 %
5050 % \begin{macro}{\@endnotetext}
5051 % The commands \cmd\label, \cmd\index, and \cmd\glossary,
5052 % which are robustified for \cmd\markright\ and \cmd\addcontentsline,
5053 % are likewise robustified here.
5054 %
5055 % Note the similarity to \cmd\protected@write.
5056 % \begin{macrocode}
5057 \long\def\@endnotetext#1{%
5058 \@ifxundefined\@endnoteout{%
5059 \newwrite\@endnoteout
5060 \gdef\endnote@stream{\jobname\endnote@ext}%
5061 \immediate\openout\@endnoteout\endnote@stream\relax
5062 }{}%
5063 \begingroup
5064 \let\label\relax \let\index\relax \let\glossary\relax
5065 \let\cite \relax \let\ref \relax \let\pageref \relax
5066 \let\( \relax \let\) \relax \let\\ \relax
5067 % \let\protect\noexpand
5068 \let \protect \@unexpandable@protect
5069 \newlinechar`\^^M%
5070 % \newlinechar`\ %
5071 \immediate\write\@endnoteout{\string\@doendnote{\@thefnmark}{#1}}%
5072 \endgroup
5073 }%
5074 % \end{macrocode}
5075 % \end{macro}
5076 %
5077 % \begin{macro}{\endnotetext}
5078 % \begin{macrocode}
5079 \def\endnotetext{%
5080 \@ifnextchar[{%
5081 \@xendnotenext
5082 }{%
5083 \protected@xdef\@thefnmark{\thefootnote}%
5084 \@endnotetext
5085 }%
5086 }%
5087 % \end{macrocode}
5088 % \end{macro}
5089 %
5090 % \begin{macro}{\@xendnotenext}
5091 % \begin{macrocode}
5092 \def\@xendnotenext[#1]{%
5093 \begingroup
5094 \c@footnote#1\relax
5095 \unrestored@protected@xdef\@thefnmark{\thefootnote}%
5096 \endgroup
5097 \@endnotetext
5098 }%
5099 % \end{macrocode}
5100 % \end{macro}
5101 %
5102 % \begin{macro}{\printendnotes}
5103 % \begin{macrocode}
5104 \def\printendnotes{%
5105 \@ifx{\@endnoteout\@undefined}{}{%
5106 \begingroup
5107 \c@secnumdepth-\maxdimen
5108 \section{%
5109 \notesname
5110 }%
5111 \immediate\closeout\@endnoteout
5112 \global\let\@endnoteout\@undefined
5113 \begin{enumerate}%
5114 \makeatletter
5115 \input{\endnote@stream}%
5116 \end{enumerate}%
5117 \endgroup
5118 }%
5119 }%
5120 \appdef\class@enddocumenthook{%
5121 \printendnotes
5122 }%
5123 % \end{macrocode}
5124 % \end{macro}
5125 %
5126 % \begin{macro}{\firstnote@num}
5127 % \begin{macro}{\set@firstnote}
5128 %
5129 % In \revtex, we have permanently altered the way
5130 % that the footnote counter gets reset at the beginning
5131 % of the document.
5132 %
5133 % If footnotes appear in the bibliography, we initialise
5134 % the footnote counter to number of cites (found last time)
5135 % via \cmd\set@firstnote.
5136 %
5137 % \begin{macrocode}
5138 \mathchardef\firstnote@num\z@
5139 \appdef\class@documenthook{%
5140 \global\c@footnote\firstnote@num
5141 \appdef\maketitle{\global\c@footnote\firstnote@num}%
5142 }%
5143 \def\set@firstnote#1{%
5144 \@ifnum{\firstnote@num=#1\relax}{}{%
5145 \class@warn@end{Endnote numbers changed: rerun LaTeX}%
5146 }%
5147 \immediate\write\@mainaux{%
5148 \global\chardef\string\firstnote@num#1\relax
5149 }%
5150 }%
5151 % \end{macrocode}
5152 % \end{macro}
5153 % \end{macro}
5154 %
5155 % \begin{macro}{\@endnotesinbib}
5156 % \begin{macro}{\@endnotesinbibliography}
5157 % We define a function \cmd\@endnotesinbib,
5158 % and a variant \cmd\@endnotesinbibliography.
5159 % The former is invoked at the start of
5160 % the end processing for \enve{thebibliography};
5161 % the latter is a synonym.
5162 %
5163 % The procedure typesets the footnotes that are to
5164 % appear in the bibliography; the default is to
5165 % simply arrange for the footnote counter to be
5166 % reset at the start of the document.
5167 %
5168 % The switchover to setting footnotes in the bibliography
5169 % is done via \cmd\AtBeginDocument\ code that
5170 % changes the meaning of \cmd\footnote\ and
5171 % that substitutes the synonym for
5172 % \cmd\@endnotesinbib.
5173 %
5174 % Note that this code make the assumption that
5175 % the counter used in \env{thebibliography} is \cmd\c@NAT@ctr.
5176 %
5177 % \begin{macrocode}
5178 \def\@endnotesinbib{%
5179 \set@firstnote\z@
5180 }%
5181 \def\@endnotesinbibliography{%
5182 \expandafter\set@firstnote\expandafter{\the\c@NAT@ctr}%
5183 \@ifx{\@endnoteout\@undefined}{}{%
5184 \immediate\closeout\@endnoteout
5185 \global\let\@endnoteout\@undefined
5186 \makeatletter
5187 \input{\endnote@stream}%
5188 }%
5189 }%
5190 \appdef\class@documenthook{%
5191 \let\@makefnmark@latex\@makefnmark
5192 \let\@footnotemark@latex\@footnotemark
5193 \footinbib@sw{%
5194 \let\footnote\endnote
5195 \let\@footnotemark\@endnotemark
5196 \let\@makefnmark\@makefnmark@cite
5197 \let\@endnotesinbib\@endnotesinbibliography
5198 \appdef\class@enddocumenthook{\auto@bib}%
5199 \let\printendnotes\relax
5200 }{}%
5201 }%
5202 % \end{macrocode}
5203 % \end{macro}
5204 % \end{macro}
5205 %
5206 % \begin{macro}{\auto@bib}
5207 % Under some circumstances, we must typeset the bibliography automatically.
5208 % For instance, the document specifies footnotes in the bibliography, but contains
5209 % no bibliography.
5210 %
5211 % Note that this facility is not able to work more than once per document.
5212 % If multiple bibliographys are required (e.g., per article), it will be the responsibility of the journal style
5213 % to restore \cmd\auto@bib\ to its original meaning so it can be re-invoked.
5214 % \begin{macrocode}
5215 \def\auto@bib{%
5216 \@ifx@empty\@FMN@list{%
5217 \@ifxundefined\@endnoteout{%
5218 \false@sw
5219 }{%
5220 \true@sw
5221 }%
5222 }{%
5223 \true@sw
5224 }{%
5225 \begin{thebibliography}{}\end{thebibliography}%
5226 }%
5227 }%
5228 % \end{macrocode}
5229 % \end{macro}
5230 %
5231 % \begin{macro}{\@doendnote}
5232 % \begin{macrocode}
5233 \def\@doendnote#1#2{\bibitem{#1}#2}
5234 % \end{macrocode}
5235 % \end{macro}
5236 %
5237 %
5238 %
5239 % \section{Initial setup}
5240 % \changes{v4.0beta 2}{1999/06/20}
5241 % {Defer assignment until \cs{AtBeginDocument} time.}
5242 % Note that this code is executed at \cmd\AtBeginDocument\ time
5243 % in order to handle a particular timing problem.
5244 % Please do not move this code any earlier!
5245 % \begin{macrocode}
5246 \appdef\class@documenthook{%
5247 % \end{macrocode}
5248 % We assert our own page style only if nobody else has done so.
5249 % Users wishing to customize their documents will be able to invoke a \cmd\pagestyle\
5250 % command anywhere in the preamble.
5251 % \begin{macrocode}
5252 \@ifxundefined\@evenhead{%
5253 \@ifxundefined\@oddhead{%
5254 \@ifxundefined\@oddfoot{%
5255 \@ifxundefined\@evenfoot{%
5256 \preprintsty@sw{%
5257 \ps@preprint
5258 }{%
5259 \ps@article
5260 }%
5261 }{}%
5262 }{}%
5263 }{}%
5264 }{}%
5265 \pagenumbering{arabic}%
5266 \normalsize
5267 \tabbingsep \labelsep
5268 \leftmargin\leftmargini
5269 \labelwidth\leftmargin\advance\labelwidth-\labelsep
5270 \let\@listi\@listI
5271 \@listi
5272 % \end{macrocode}
5273 %
5274 % \begin{macrocode}
5275 %\twoside@sw{}{%
5276 % \raggedbottom
5277 %}%
5278 % \end{macrocode}
5279 % We make sure that the ``environment'' component mark is set.
5280 % \begin{macrocode}
5281 \def\curr@envir{document}%
5282 \mark@envir{\curr@envir}%
5283 % \end{macrocode}
5284 %
5285 % \changes{v4.0beta 3}{1999/11/13}
5286 % {Grid changes with ltxgrid}
5287 % \changes{v4.0beta 4}{2000/04/10}
5288 % {Also alter how lists get indented.}
5289 % When setting the column grid, we have to alter the procedure
5290 % for formatting lists. Because \cmd\twocolumngrid\ requires
5291 % rebalancing columns at some points, lists must \emph{not}
5292 % involve the use of \cmd\moveleft, \cmd\moveright, or \cmd\parshape.
5293 % The alternative procedure only involves the manipulation of
5294 % \cmd\leftskip\ and \cmd\rightskip.
5295 %
5296 % FIXME: Always sloppy??
5297 % \begin{macrocode}
5298 \twocolumn@sw{%
5299 \open@column@mlt\tw@
5300 \set@colht
5301 \@floatplacement
5302 \@dblfloatplacement
5303 \sloppy
5304 \@booleanfalse\raggedcolumn@sw
5305 \let\set@listindent\set@listindent@
5306 }{%
5307 \open@column@one\@ne
5308 \set@colht
5309 \@floatplacement
5310 \@dblfloatplacement
5311 \sloppy
5312 % \raggedbottom
5313 \let\set@listindent\set@listindent@parshape
5314 }%
5315 }%
5316 % \end{macrocode}
5317 %
5318 %
5319 % \section{\cs{appendix}}
5320 %
5321 % \begin{macrocode}
5322 %\newif\ifappendixon
5323 % \end{macrocode}
5324 % Note that, within appendices,
5325 % equations are numbered within sections (appendices).
5326 % \begin{macrocode}
5327 \def\appendix{%
5328 \par
5329 %\appendixontrue
5330 \setcounter{section}\z@
5331 \setcounter{subsection}\z@
5332 \setcounter{subsubsection}\z@
5333 \def\thesubsection{\arabic{subsection}}%
5334 \def\thesubsubsection{\alph{subsubsection}}%
5335 \@addtoreset{equation}{section}%
5336 \def\theequation@prefix{\thesection}%
5337 \addtocontents{toc}{\protect\appendix}%
5338 \@ifstar{%
5339 \def\thesection{\unskip}%
5340 \def\theequation@prefix{A.}%
5341 }{%
5342 \def\thesection{\Alph{section}}%
5343 }%
5344 }%
5345 % \end{macrocode}
5346 %
5347 % \section{Changing the page grid}
5348 % \changes{v4.0beta 2}{1999/06/20}
5349 % {Define three separate environments,
5350 % defer assignment to \cs{AtBeginDocument} time.
5351 % }
5352 %
5353 % \subsection{Avoiding Grid Changes}%
5354 %
5355 % In preprint styles, ``wide text'' is a no-op, and the title page
5356 % processing involves no grid change.
5357 %
5358 % \begin{macro}{\title@column@default}%
5359 % \begin{macro}{\close@column@default}%
5360 %
5361 % \begin{macrocode}
5362 \def\title@column@default#1{%
5363 \minipagefootnote@init
5364 #1%
5365 \minipagefootnote@foot
5366 }%
5367 \def\close@column@default{%
5368 \newpage
5369 }%
5370 % \end{macrocode}
5371 % \end{macro}
5372 % \end{macro}
5373 %
5374 %
5375 % \subsection{Galley Style: Margin Changes}%
5376 % A variant of preprint processing. Emulate journal appearance somewhat.
5377 %
5378 % \begin{environment}{widetext@galley}
5379 % DPC: We're in galley style so do a lob sided display environment.
5380 %
5381 % QUERY: How can we be sure that we are in galley style?
5382 % ANSWER: as noted elsewhere, require both \cmd\twocolumn@sw\ and \cmd\preprintsty@sw\ to be false.
5383 % \begin{macrocode}
5384 \def\galley@outdent{\rightmargin-\columnwidth\advance\rightmargin-\columnsep}%
5385 \let\widetext@outdent\@empty
5386 \newenvironment{widetext@galley}{%
5387 \list{}{%
5388 \topsep \z@skip
5389 \listparindent \parindent
5390 \itemindent \parindent
5391 \leftmargin \z@
5392 \parsep \z@\@plus\p@
5393 \widetext@outdent
5394 \relax
5395 }%
5396 \item\relax
5397 }{
5398 \endlist
5399 }%
5400 % \end{macrocode}
5401 % \end{environment}
5402 %
5403 %
5404 % \subsection{Grid Changing Via \classname{ltxgrid}}%
5405 %
5406 % In case \classoption{twocolumngrid} has been invoked,
5407 % switch column grid using the column grid-changing commands.
5408 % Supply stub definitions of those commands here.
5409 % \changes{v4.0beta 3}{1999/11/13}
5410 % {grid changes with ltxgrid}
5411 %
5412 % \begin{macro}{\title@column@grid}%
5413 % \begin{macro}{\close@column@grid}%
5414 % The title block always starts at the top of a new page.
5415 % \changes{v4.0beta 3}{1999/11/13}
5416 % {grid changes with ltxgrid}
5417 %
5418 % Note that, for the procedure \cmd\close@column@grid,
5419 % we balance columns by switching to the one-column page grid,
5420 % then we return to a two-column page grid in anticipation of the
5421 % upcoming \cmd\clearpage.
5422 % \begin{macrocode}
5423 \def\title@column@grid#1{%
5424 \minipagefootnote@init
5425 \onecolumngrid
5426 \begingroup
5427 \let\@footnotetext\frontmatter@footnotetext
5428 \let\set@footnotewidth\set@footnotewidth@ii
5429 #1%
5430 \endgroup
5431 \twocolumngrid
5432 \minipagefootnote@foot
5433 }%
5434 \def\close@column@grid{%
5435 \balancelastpage@sw{%
5436 \onecolumngrid
5437 % \twocolumngrid
5438 }{}%
5439 }%
5440 % \end{macrocode}
5441 % \end{macro}
5442 % \end{macro}
5443 %
5444 % \begin{environment}{widetext@grid}
5445 % \changes{v4.0beta 3}{1999/11/13}
5446 % {grid changes via ltxgrid procedures}
5447 % \changes{v4.0beta 5}{2000/11/21}
5448 % {adornments above and below.}
5449 % We slip into the one-column page grid
5450 % within the scope of this environment.
5451 %
5452 % Note that we set adornments above and below the \env{widettext}.
5453 % These are set as leaders, so they will disappear at a page break.
5454 % \begin{macrocode}
5455 \newenvironment{widetext@grid}{%
5456 \par\ignorespaces
5457 \setbox\widetext@top\vbox{%
5458 \vskip15\p@
5459 \hb@xt@\hsize{%
5460 \leaders\hrule\hfil
5461 \vrule\@height6\p@
5462 }%
5463 \vskip6\p@
5464 }%
5465 \setbox\widetext@bot\hb@xt@\hsize{%
5466 \vrule\@depth6\p@
5467 \leaders\hrule\hfil
5468 }%
5469 \onecolumngrid
5470 \dimen@\ht\widetext@top\advance\dimen@\dp\widetext@top
5471 \cleaders\box\widetext@top\vskip\dimen@
5472 \let\set@footnotewidth\set@footnotewidth@ii
5473 }{%
5474 \par
5475 \setbox\widetext@bot\vbox{%
5476 \hb@xt@\hsize{\hfil\box\widetext@bot}%
5477 \vskip14\p@
5478 }%
5479 \dimen@\ht\widetext@bot\advance\dimen@\dp\widetext@bot
5480 \cleaders\box\widetext@bot\vskip\dimen@
5481 \twocolumngrid\global\@ignoretrue
5482 \@endpetrue
5483 }%
5484 \newbox\widetext@top
5485 \newbox\widetext@bot
5486 % \end{macrocode}
5487 % \end{environment}
5488 %
5489 %
5490 % Decide, finally, how the page grid is to be manipulated.
5491 % \begin{macrocode}
5492 \appdef\class@documenthook{%
5493 \twocolumn@sw{%
5494 \let@environment{widetext}{widetext@grid}%
5495 \let\title@column\title@column@grid
5496 \let\close@column\close@column@grid
5497 }{%
5498 \let@environment{widetext}{widetext@galley}%
5499 \preprintsty@sw{%
5500 % \end{macrocode}
5501 % Change the page grid not at all.
5502 % \begin{macrocode}
5503 }{%
5504 % \end{macrocode}
5505 % If we are galley style, change the page margin only.
5506 % \begin{macrocode}
5507 \galley@sw{%
5508 \let\widetext@outdent\galley@outdent
5509 }{%
5510 }%
5511 }%
5512 }%
5513 }%
5514 % \end{macrocode}
5515 %
5516 % \begin{macro}{\title@column}
5517 % Provide a default meaning for \cmd\title@column\
5518 % in case it was never defined.
5519 % \begin{macrocode}
5520 \appdef\class@inithook{%
5521 \@ifxundefined\title@column{%
5522 \let\title@column\title@column@default
5523 }{}%
5524 }%
5525 % \end{macrocode}
5526 % \end{macro}
5527 %
5528 %
5529 % \section{Old font commands}
5530 %
5531 % \begin{macrocode}
5532 \DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm}
5533 \DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf}
5534 \DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt}
5535 \DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf}
5536 \DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit}
5537 \DeclareOldFontCommand{\sl}{\normalfont\slshape}{\@nomath\sl}
5538 \DeclareOldFontCommand{\sc}{\normalfont\scshape}{\@nomath\sc}
5539 \DeclareRobustCommand*\cal{\@fontswitch\relax\mathcal}
5540 \DeclareRobustCommand*\mit{\@fontswitch\relax\mathnormal}
5541 % \end{macrocode}
5542 %
5543 % \section{English-Language Texts}
5544 % As this class is just for English language journals, we
5545 % could hardwire these texts,
5546 % but to make it easier to use this as a
5547 % basis for the code for similar journal styles, separate out all the
5548 % fixed text strings into babel-style macros of the form
5549 % |\|\ldots|name|
5550 %
5551 % Note: for babel compatability, use version 1999/05/05 v3.6x or later.
5552 %
5553 % Some of these might need changing in the society-specific code.
5554 %
5555 % \begin{macro}{\today}
5556 % Procedure \cmd\today\ is used in the article class, but not in
5557 % this document class.
5558 % \begin{macrocode}
5559 \def\today{\ifcase\month\or
5560 January\or February\or March\or April\or May\or June\or
5561 July\or August\or September\or October\or November\or December\fi
5562 \space\number\day, \number\year}
5563 % \end{macrocode}
5564 % \end{macro}
5565 %
5566 % \begin{macro}{\notesname}
5567 % Text entity \cmd\notesname\ is used in \cmd\printendnotes.
5568 % \begin{macrocode}
5569 \def\notesname{Notes}
5570 % \end{macrocode}
5571 % \end{macro}
5572 %
5573 % \begin{macro}{\partname}
5574 % Text entity \cmd\partname\ is used in \cmd\@part.
5575 % \begin{macrocode}
5576 \def\partname{Part}
5577 % \end{macrocode}
5578 % \end{macro}
5579 %
5580 % \begin{macro}{\tocname}
5581 % Text entity \cmd\tocname\ is used in \cmd\tableofcontents,
5582 % as defined in the standard \LaTeX\ book class.
5583 % \begin{macrocode}
5584 \def\tocname{Contents}
5585 % \end{macrocode}
5586 % \end{macro}
5587 %
5588 % \begin{macro}{\lofname}
5589 % Text entity \cmd\lofname\ is used in \cmd\listoffigures,
5590 % as defined in the standard \LaTeX\ book class.
5591 % \begin{macrocode}
5592 \def\lofname{List of Figures}
5593 % \end{macrocode}
5594 % \end{macro}
5595 %
5596 % \begin{macro}{\lotname}
5597 % Text entity \cmd\lotname\ is used in \cmd\listoftables,
5598 % as defined in the standard \LaTeX\ book class.
5599 % \begin{macrocode}
5600 \def\lotname{List of Tables}
5601 % \end{macrocode}
5602 % \end{macro}
5603 %
5604 % \begin{macro}{\refname}
5605 % Text entity \cmd\refname\ is used in \env{thebibliography}.
5606 % \begin{macrocode}
5607 \def\refname{References}
5608 % \end{macrocode}
5609 % \end{macro}
5610 %
5611 % \begin{macro}{\indexname}
5612 % Text entity \cmd\indexname\ is used in \env{theindex},
5613 % as defined in the standard \LaTeX\ book class.
5614 % \begin{macrocode}
5615 \def\indexname{Index}
5616 % \end{macrocode}
5617 % \end{macro}
5618 %
5619 % \begin{macro}{\figurename}
5620 % \changes{v4.0beta 2}{1999/06/20}
5621 % {Added localization of \cs{figuresname}}
5622 % Text entity \cmd\figurename\ is used in \env{figure},
5623 % \cmd\figuresname\ in \cmd\printfigures.
5624 % \begin{macrocode}
5625 \def\figurename{FIG.}
5626 \def\figuresname{Figures}%
5627 % \end{macrocode}
5628 % \end{macro}
5629 %
5630 % \begin{macro}{\tablename}
5631 % \changes{v4.0beta 2}{1999/06/20}
5632 % {Added localization of \cs{tablesname}}
5633 % Text entity \cmd\tablename\ is used in \env{table},
5634 % \cmd\tablesname\ in \cmd\printtables.
5635 % \begin{macrocode}
5636 \def\tablename{TABLE}
5637 \def\tablesname{Tables}%
5638 % \end{macrocode}
5639 % \end{macro}
5640 %
5641 % \begin{macro}{\abstractname}
5642 % Text entity \cmd\abstractname\ is used in \env{abstract}.
5643 % \begin{macrocode}
5644 \def\abstractname{Abstract}
5645 % \end{macrocode}
5646 % \end{macro}
5647 %
5648 % \begin{macro}{\appendixesname}
5649 % \begin{macro}{\appendixname}
5650 % Text entity \cmd\appendixesname\ is used in TOC.
5651 % \begin{macrocode}
5652 \def\appendixesname{Appendixes}%
5653 \def\appendixname{Appendix}%
5654 % \end{macrocode}
5655 % \end{macro}
5656 % \end{macro}
5657 %
5658 % \begin{macro}{\acknowledgmentsname}
5659 % Text entity \cmd\acknowledgmentsname\ is used in \env{acknowledgments}.
5660 % \begin{macrocode}
5661 \def\acknowledgmentsname{Acknowledgments}
5662 % \end{macrocode}
5663 % \end{macro}
5664 %
5665 % \begin{macro}{\journalname}
5666 % This should be set by the society journal options, eg `pra'.
5667 % \begin{macrocode}
5668 \def\journalname{??}
5669 % \end{macrocode}
5670 % \end{macro}
5671 %
5672 % \begin{macro}{\copyrightname}
5673 % Default layout does not assign copyright, but a journal that wants
5674 % to might use this.
5675 % \begin{macrocode}
5676 \def\copyrightname{??}
5677 % \end{macrocode}
5678 % \end{macro}
5679 %
5680 % \begin{macro}{\andname}
5681 % The text string ``and'' for use in author lists.
5682 % \begin{macrocode}
5683 \def\andname{and}
5684 % \end{macrocode}
5685 % \end{macro}
5686 %
5687 % \begin{macro}{\@pacs@name}
5688 % \begin{macro}{\@keys@name}
5689 % The text string prepended to PACS numbers, resp. to keywords.
5690 % \begin{macrocode}
5691 \def\@pacs@name{PACS numbers: }%
5692 \def\@keys@name{Keywords: }%
5693 % \end{macrocode}
5694 % \end{macro}
5695 % \end{macro}
5696 %
5697 % \begin{macro}{\ppname}
5698 % The text string ``pp'' for use in page ranges.
5699 % \begin{macrocode}
5700 \def\ppname{pp}
5701 % \end{macrocode}
5702 % \end{macro}
5703 %
5704 % \begin{macro}{\numbername}
5705 % The text string ``number'' for use in article reference.
5706 % \begin{macrocode}
5707 \def\numbername{number}
5708 % \end{macrocode}
5709 % \end{macro}
5710 %
5711 % \begin{macro}{\volumename}
5712 % The text string ``volume'' for use in article reference.
5713 % \begin{macrocode}
5714 \def\volumename{volume}
5715 % \end{macrocode}
5716 % \end{macro}
5717 %
5718 % \begin{macro}{\Dated@name}
5719 % \begin{macro}{\Received@name}
5720 % \begin{macro}{\Revised@name}
5721 % \begin{macro}{\Accepted@name}
5722 % \begin{macro}{\Published@name}
5723 % These texts are used in the \cmd\date, et al. commands.
5724 % \begin{macrocode}
5725 \def\Dated@name{Dated: }%
5726 \def\Received@name{Received }%
5727 \def\Revised@name{Revised }%
5728 \def\Accepted@name{Accepted }%
5729 \def\Published@name{Published }%
5730 % \end{macrocode}
5731 % \end{macro}
5732 % \end{macro}
5733 % \end{macro}
5734 % \end{macro}
5735 % \end{macro}
5736 %
5737 % \section{Legacy Commands}
5738 % We deffine some commands left over from version 3.1, or give default meanings.
5739 % Some definitions can be overridden
5740 % in the document preamble or in included packages.
5741 %
5742 % Note on the namespace: command names like \cmd\REV@\emph{name} are used here,
5743 % because it is not clear that any of this code is generally useful.
5744 % \begin{macrocode}
5745 \def\address{\replace@command\address\affiliation}%
5746 \def\altaddress{\replace@command\altaddress\altaffiliation}%
5747 \newenvironment{references}{%
5748 \class@warn@end{The references environment is not supported; use thebibliography instead.}
5749 \gdef\references{\thebibliography{}}\references
5750 }{%
5751 \endthebibliography
5752 }%
5753 \def\draft{%
5754 \class@warn@end{Command \string\draft\space is obsolete;^^JInvoke option draft instead.}%
5755 \@booleantrue\draft@sw
5756 }%
5757 \def\tighten{%
5758 \class@warn@end{Command \string\tighten\space is obsolete;^^JInvoke option tightenlines instead.}%
5759 \@booleantrue\tightenlines@sw
5760 }%
5761 \def\tableline{%
5762 \noalign{%
5763 \class@warn@end{Command \string\tableline\space is obsolete;^^JUse \string\colrule\space instead.}%
5764 \global\let\tableline\colrule
5765 }%
5766 \tableline
5767 }%
5768 \def\case{\replace@command\case\frac}%
5769 \def\slantfrac{\replace@command\slantfrac\frac}%
5770 \def\tablenote{\replace@command\tablenote\footnote}%
5771 \def\tablenotemark{\replace@command\tablenotemark\footnotemark}%
5772 \def\tablenotetext{\replace@command\tablenotetext\footnotetext}%
5773 % Lose the following definition:
5774 \DeclareRobustCommand\REV@text[1]{%
5775 \relax
5776 \ifmmode
5777 \mathchoice
5778 {\hbox{{\everymath{\displaystyle }#1}}}%
5779 {\hbox{{\everymath{\textstyle }#1}}}%
5780 {\hbox{{\everymath{\scriptstyle }\let\f@size\sf@size\selectfont#1}}}%
5781 {\hbox{{\everymath{\scriptscriptstyle}\let\f@size\ssf@size\selectfont#1}}}%
5782 \glb@settings
5783 \else
5784 \mbox{#1}%
5785 \fi
5786 }%
5787 % Lose the following definition:
5788 \DeclareRobustCommand\REV@bbox[1]{%
5789 \relax
5790 \ifmmode
5791 \mathchoice
5792 {\hbox{{\everymath{\displaystyle }\boldmath$#1$}}}%
5793 {\hbox{{\everymath{\textstyle }\boldmath$#1$}}}%
5794 {\hbox{{\everymath{\scriptstyle }\boldmath$#1$}}}%
5795 {\hbox{{\everymath{\scriptscriptstyle}\boldmath$#1$}}}%
5796 \glb@settings
5797 \else
5798 \mbox{#1}%
5799 \fi
5800 }%
5801 \DeclareRobustCommand\REV@bm[1]{%
5802 \class@warn@end{To use \string\bm, please load the bm package!}%
5803 \global\let\bm\relax
5804 }%
5805 \def\FL{\obsolete@command\FL}%
5806 \def\FR{\obsolete@command\FR}%
5807 \def\narrowtext{\obsolete@command\narrowtext}%
5808 \def\mediumtext{\obsolete@command\mediumtext}%
5809 \newenvironment{quasitable}{%
5810 \let@environment{tabular}{longtable}%
5811 }{%
5812 }%
5813 % \end{macrocode}
5814 %
5815 % \begin{macro}{\text}
5816 % \begin{macro}{\bm}
5817 % \begin{macro}{\bibinfo}
5818 % \begin{macro}{\eprint}
5819 % \begin{macro}{\url}
5820 %
5821 % If not otherwise defined, give default meanings to certain commands.
5822 % \changes{v4.0beta 4}{2000/04/10}
5823 % {eprint takes an aoptional argument, syntactical only in this case.}
5824 % \begin{macrocode}
5825 \appdef\class@inithook{%
5826 \@ifxundefined\text{\let\text\REV@text}{}%
5827 \@ifxundefined\bm{\let\bm\REV@bm}{}%
5828 \providecommand\bibinfo[2]{#2}%
5829 \providecommand\eprint[2][]{#2}%
5830 \providecommand\url[1]{#1}%
5831 }%
5832 % \end{macrocode}
5833 % \end{macro}
5834 % \end{macro}
5835 % \end{macro}
5836 % \end{macro}
5837 % \end{macro}
5838 %
5839 % \begin{macro}{\bbox}
5840 %
5841 % \begin{macrocode}
5842 \def\bbox#1{%
5843 \class@warn@end{\string\bbox\space is obsolete,^^Jload the bm package and use \string\bm\space instead.}%
5844 \global\let\bbox\relax
5845 }%
5846 % \end{macrocode}
5847 % \end{macro}
5848 %
5849 % \begin{macro}{\mathletters}
5850 %
5851 % \begin{macrocode}
5852 \newenvironment{mathletters}{%
5853 \class@warn@end{Environment {mathletters} is obsolete;^^Jload the amsmath package and use {subequations}!}%
5854 \global\let\mathletters\@empty
5855 }{%
5856 }%
5857 % \end{macrocode}
5858 % \end{macro}
5859 %
5860 % \begin{macro}{\eqnum}
5861 %
5862 % \begin{macrocode}
5863 \def\eqnum#1{%
5864 \class@warn@end{\string\eqnum\space is obsolete, load the amsmath package and use \string\tag!}%
5865 \global\let\eqnum\@gobble
5866 }%
5867 % \end{macrocode}
5868 % \end{macro}
5869 %
5870 % We read in the symbol definitions.
5871 % \begin{macrocode}
5872 \RequirePackage{revsymb}%
5873 \appdef\class@inithook{\revsymb@inithook}%
5874 % \end{macrocode}
5875 %
5876 % \section{Endgame for the Document Class}
5877 %
5878 % This section contains definitions related to the
5879 % end-of-class processing:
5880 % we want to control exactly what happens next.
5881 %
5882 % We provide for a ``job macro package'' that can override
5883 % definitions made by the class or any other packages it loads.
5884 % We act on the value of \cmd\secnumarabic@sw;
5885 % this code is a model for dealing with the job macro package.
5886 % We also install a the very last procedures into
5887 % \cmd\AtEndOfClass, ones that need to tail on to
5888 % any processing performed either by the
5889 % class, by any of its included packages, or
5890 % by the job macro package and any packages it may have loaded.
5891 %
5892 % \subsection{Job Macro Package}
5893 % You can create a ``job macro package'' for your document
5894 % that will be read in automatically every time
5895 % your document is processed.
5896 % Thus, if your job is a file called \file{myarticle.tex},
5897 % then the file \file{myarticle.rty} will be read in
5898 % just the same as if you had placed a
5899 % \cmd\usepackage|{myarticle.rty}| statement
5900 % immediately following your \cmd\documentclass\ statement.
5901 %
5902 % Within your \file{.rty} file,
5903 % you can define and use control sequence names that use the |@| character
5904 % and you can override any of the definitions or assignments made
5905 % by the \revtex\ document class or the selected journal substyle.
5906 % That is, you have the power to really mess things up badly.
5907 %
5908 % If you choose to have a job macro package, you are well
5909 % advised to read the \LaTeX\ guide to document classes,
5910 % \filename{clsguide.tex} or read up on the subject
5911 % in a book line the \LaTeX\ Companion.
5912 %
5913 % The file \filename{template.rty} contains a template for
5914 % creating your own job macro package.
5915 %
5916 % \begin{macrocode}
5917 \AtEndOfClass{%
5918 \InputIfFileExists{\jobname.rty}{}{}%
5919 }%
5920 % \end{macrocode}
5921 %
5922 % \subsection{\cs{secnumarabic@sw}}\label{sec:secnumarabic}
5923 % \begin{macro}{\secnumarabic@sw}
5924 % The flag \cmd\secnumarabic@sw\ signifies that sectioning commands are
5925 % to be numbered arabic.
5926 % The effect of this command should override any settings
5927 % made by the journal substyle or by the job macro package.
5928 % However, it should be lower in precedence to definitions
5929 % appearing in the document preamble.
5930 % Therefore, we install its code into \cmd\AtEndOfClass,
5931 % but do it \emph{after} the corresponding code
5932 % for the journal substyle and the job macro package.
5933 %
5934 % Note: \cmd\thesection\ must \emph{not} be redefined,
5935 % say, at \cmd\AtBeginDocument\ time by some delayed code.
5936 % \begin{macrocode}
5937 \AtEndOfClass{%
5938 \@ifxundefined\secnumarabic@sw{\@booleanfalse\secnumarabic@sw}{}%
5939 \secnumarabic@sw{%
5940 \def\p@section {}%
5941 \def\thesection {\arabic{section}}%
5942 \def\p@subsection {}%
5943 \def\thesubsection {\thesection.\arabic{subsection}}%
5944 \def\p@subsubsection {}%
5945 \def\thesubsubsection {\thesubsection.\arabic{subsubsection}}%
5946 }{}%
5947 }%
5948 % \end{macrocode}
5949 % \end{macro}
5950 %
5951 % \subsection{Hook for default values of Booleans}
5952 % This portion of the code for this class file
5953 % \emph{must} appear at the very end.
5954 % \begin{macro}{\defaults@hook}
5955 % The procedure \cmd\defaults@hook\ should hereby
5956 % be the very last to be installed into \cmd\AtBeginDocument.
5957 % We provide it with a default in case it has not been
5958 % used up til now.
5959 %
5960 % CHECKME: is any other hook installed later than \cmd\defaults@hook?
5961 % \begin{macrocode}
5962 \AtEndOfClass{%
5963 \appdef\class@documenthook{%
5964 \defaults@hook
5965 }%
5966 }%
5967 \@ifxundefined\defaults@hook{\let\defaults@hook\@empty}{}%
5968 % \end{macrocode}
5969 % \end{macro}
5970 %
5971 % End of the class file.
5972 % \begin{macrocode}
5973 %</class-pst>
5974 % \end{macrocode}
5975 %
5976 %
5977 % \section{Symbols: the \texttt{revsymb} module}
5978 % We immediately define a utility command: this module's warning.
5979 % \begin{macrocode}
5980 %<*revsymb>
5981 \def\REVSYMB@warn#1{\PackageWarningNoLine{revsymb}{#1}}%
5982 % \end{macrocode}
5983 %
5984 % \begin{macro}{\lambdabar}
5985 % \begin{macrocode}
5986 \DeclareRobustCommand\lambdabar{%
5987 \bgroup
5988 \def\@tempa{%
5989 \hbox{%
5990 \raise.73\ht\z@
5991 \hb@xt@\z@{%
5992 \kern.25\wd\z@
5993 \vrule \@width.5\wd\z@\@height.1\p@\@depth.1\p@
5994 \hss
5995 }%
5996 \box\z@
5997 }%
5998 }%
5999 \mathchoice
6000 {\setbox\z@\hbox{$\displaystyle \lambda$}\@tempa}%
6001 {\setbox\z@\hbox{$\textstyle \lambda$}\@tempa}%
6002 {\setbox\z@\hbox{$\scriptstyle \lambda$}\@tempa}%
6003 {\setbox\z@\hbox{$\scriptscriptstyle\lambda$}\@tempa}%
6004 \egroup
6005 }%
6006 % \end{macrocode}
6007 % \end{macro}
6008 %
6009 % \begin{macro}{\openone}
6010 % DPC: Really should use a font that includes this glyph.
6011 % Unfortunately not in AMS ones, but is in bbold, cmbb.
6012 % (I think, must check),
6013 % \changes{v4.d}{1998/01/31}
6014 % {use font-dependent spacing}
6015 % FIXME: check for bbold.
6016 % \begin{macrocode}
6017 \DeclareRobustCommand\openone{\leavevmode\hbox{\small1\normalsize\kern-.33em1}}%
6018 % \end{macrocode}
6019 % \end{macro}
6020 %
6021 % \begin{macro}{\corresponds}
6022 % \begin{macro}{\overdots}
6023 % \begin{macro}{\overcirc}
6024 % J\"org Knappen suggests the replacements:
6025 % replace \cmd\corresponds\ with \cmd\triangleq, source \classname{amssymb};
6026 % replace \cmd\overcirc\ with \cmd\mathring, source \classname{latex2e};
6027 % replace \cmd\overdots\ with \cmd\dddot, source \classname{amsmath}.
6028 %
6029 % Any use of any of these commands will result in a warning message at the end
6030 % of the log file. If the corresponding package is not loaded, a
6031 % definition will quietly be provided.
6032 % \begin{macrocode}
6033 \DeclareRobustCommand\corresponds{\replace@command\corresponds\triangleq}%
6034 \DeclareRobustCommand\overcirc{\replace@command\overcirc\mathring}%
6035 \DeclareRobustCommand\overdots{\replace@command\overdots\dddot}%
6036 \DeclareRobustCommand\REV@triangleq{%
6037 {\lower.2ex\hbox{=}}{\kern-.75em^\triangle}%
6038 }%
6039 \DeclareRobustCommand\REV@dddot[1]{%
6040 \@ontopof{#1}{\cdots}{1.0}\mathord{\box2}%
6041 }%
6042 % \end{macrocode}
6043 % \end{macro}
6044 % \end{macro}
6045 % \end{macro}
6046 %
6047 % \begin{macro}{\succsim}
6048 % \begin{macro}{\precsim}
6049 % \begin{macro}{\lesssim}
6050 % \begin{macro}{\gtrsim}
6051 % \begin{macro}{\alt}
6052 % \begin{macro}{\agt}
6053 % These version 3.1 commands are always supplied,
6054 % but the definitions in \classname{amssymb} are preferred.
6055 % \begin{macrocode}
6056 \DeclareRobustCommand\altsuccsim{\succ\kern-.9em_\sim\kern.3em}%
6057 \DeclareRobustCommand\altprecsim{\prec\kern-1em_\sim\kern.3em}%
6058 \let\REV@succsim\altsuccsim
6059 \let\REV@precsim\altprecsim
6060 \DeclareRobustCommand\REV@lesssim{\mathrel{\mathpalette\vereq{<}}}%
6061 \DeclareRobustCommand\REV@gtrsim{\mathrel{\mathpalette\vereq{>}}}%
6062 \DeclareRobustCommand\alt{\lesssim}
6063 \DeclareRobustCommand\agt{\gtrsim}
6064 \def\vereq#1#2{%
6065 \lower3\p@\vbox{%
6066 \baselineskip1.5\p@
6067 \lineskip1.5\p@
6068 \ialign{$\m@th#1\hfill##\hfil$\crcr#2\crcr\sim\crcr}%
6069 }%
6070 }%
6071 % \end{macrocode}
6072 % \end{macro}
6073 % \end{macro}
6074 % \end{macro}
6075 % \end{macro}
6076 % \end{macro}
6077 % \end{macro}
6078 %
6079 % \begin{macro}{\tensor}
6080 % \begin{macro}{\overstar}
6081 % \begin{macro}{\loarrow}
6082 % \begin{macro}{\roarrow}
6083 % \changes{v4.0beta 2}{1999/06/20}
6084 % {AO: remove duplicates}
6085 % \begin{macrocode}
6086 \DeclareRobustCommand\tensor[1]{\@ontopof{#1}{\leftrightarrow}{1.15}\mathord{\box2}}
6087 \DeclareRobustCommand\overstar[1]{\@ontopof{#1}{\ast}{1.15}\mathord{\box2}}
6088 \DeclareRobustCommand\loarrow[1]{\@ontopof{#1}{\leftarrow}{1.15}\mathord{\box2}}
6089 \DeclareRobustCommand\roarrow[1]{\@ontopof{#1}{\rightarrow}{1.15}\mathord{\box2}}
6090 % \end{macrocode}
6091 % \end{macro}
6092 % \end{macro}
6093 % \end{macro}
6094 % \end{macro}
6095 %
6096 % \begin{macro}{\@ontopof}
6097 % \begin{macrocode}
6098 \def\@ontopof#1#2#3{%
6099 {%
6100 \mathchoice
6101 {\@@ontopof{#1}{#2}{#3}\displaystyle \scriptstyle }%
6102 {\@@ontopof{#1}{#2}{#3}\textstyle \scriptstyle }%
6103 {\@@ontopof{#1}{#2}{#3}\scriptstyle \scriptscriptstyle}%
6104 {\@@ontopof{#1}{#2}{#3}\scriptscriptstyle\scriptscriptstyle}%
6105 }%
6106 }%
6107 % \end{macrocode}
6108 % \end{macro}
6109 %
6110 % \begin{macro}{\@@ontopof}
6111 % Same as \revtex3, more or less.
6112 % \begin{macrocode}
6113 \def\@@ontopof#1#2#3#4#5{%
6114 \setbox\z@\hbox{$#4#1$}%
6115 \setbox\f@ur\hbox{$#5#2$}%
6116 \setbox\tw@\null\ht\tw@\ht\z@ \dp\tw@\dp\z@
6117 \@ifdim{\wd\z@>\wd\f@ur}{%
6118 \setbox\f@ur\hb@xt@\wd\z@{\hss\box\f@ur\hss}%
6119 \mathord{\rlap{\raise#3\ht\z@\box\f@ur}\box\z@}%
6120 }{%
6121 \setbox\f@ur\hb@[email protected]\wd\f@ur{\hss\box\f@ur\hss}%
6122 \setbox\z@\hb@xt@\wd\f@ur{\hss$#4\relax#1$\hss}%
6123 \mathord{\rlap{\copy\z@}\raise#3\ht\z@\box\f@ur}%
6124 }%
6125 }%
6126 % \end{macrocode}
6127 % \end{macro}
6128 %
6129 % \begin{macro}{\frak}
6130 % Deal with legacy \cmd\frak:
6131 % if \classname{amsfonts} not loaded, defined in such a way as to ask for that package.
6132 % Also, says to use \cmd\mathfrak\ instead.
6133 % \begin{macrocode}
6134 \DeclareRobustCommand\frak{%
6135 \REVSYMB@warn{%
6136 Command \string\frak\space unsupported:^^J%
6137 please use \string\mathfrak\space instead.%
6138 }%
6139 \global\let\frak\mathfrak
6140 \frak
6141 }%
6142 \DeclareRobustCommand\REV@mathfrak{%
6143 \REVSYMB@warn{%
6144 Command \string\mathfrak\space undefined:^^J%
6145 please specify the amsfonts or amssymb option!%
6146 }%
6147 \global\let\mathfrak\@firstofone
6148 \mathfrak
6149 }%
6150 % \end{macrocode}
6151 % \end{macro}
6152 %
6153 % \begin{macro}{\Bbb}
6154 % Deal with legacy \cmd\Bbb:
6155 % if \classname{amsfonts} not loaded, defined in such a way as to ask for that package.
6156 % Also, says to use \cmd\mathbb\ instead.
6157 % \begin{macrocode}
6158 \DeclareRobustCommand\Bbb{%
6159 \REVSYMB@warn{%
6160 Command \string\Bbb\space unsupported:^^J%
6161 please use \string\mathbb\space instead.%
6162 }%
6163 \global\let\Bbb\mathbb
6164 \Bbb
6165 }%
6166 \DeclareRobustCommand\REV@mathfrak{%
6167 \REVSYMB@warn{%
6168 Command \string\mathbb\space undefined:^^J%
6169 please specify the amsfonts or amssymb option!%
6170 }%
6171 \global\let\mathbb\@firstofone
6172 \mathbb
6173 }%
6174 % \end{macrocode}
6175 % \end{macro}
6176 %
6177 % \begin{macro}{\Bigglb}
6178 % Deal with legacy bold delimiters.
6179 % Each of the following takes an implicit argument consisting of
6180 % the delimiter to be made big and bold.
6181 % FIXME: \cmd\DeclareBoldMathCommand\ is not the right tool!
6182 % \begin{macrocode}
6183 \def\Bigglb{\REV@boldopen \Bigg}%
6184 \def\Biglb {\REV@boldopen \Big }%
6185 \def\bigglb{\REV@boldopen \bigg}%
6186 \def\biglb {\REV@boldopen \big }%
6187 \def\Biggrb{\REV@boldclose\Bigg}%
6188 \def\Bigrb {\REV@boldclose\Big }%
6189 \def\biggrb{\REV@boldclose\bigg}%
6190 \def\bigrb {\REV@boldclose\big }%
6191 \def\REV@pmb#1{%
6192 \hbox{%
6193 \setbox\z@=\hbox{#1}%
6194 \kern-.02em\copy\z@\kern-\wd\z@
6195 \kern .04em\copy\z@\kern-\wd\z@
6196 \kern-.02em
6197 \raise.04em\copy\z@
6198 }%
6199 }%
6200 \def\REV@boldopen #1#2{\mathopen {\REV@pmb{$#1#2$}}}%
6201 \def\REV@boldclose#1#2{\mathclose{\REV@pmb{$#1#2$}}}%
6202 % \end{macrocode}
6203 % \end{macro}
6204 %
6205 % \begin{macro}{\AtBeginDocument}
6206 % Package dependencies are taken care of
6207 % \cmd\AtBeginDocument\ time.
6208 % \begin{macrocode}
6209 \def\revsymb@inithook{%
6210 \@ifxundefined\dddot{\let\dddot\REV@dddot}{}%
6211 \@ifxundefined\triangleq{\let\triangleq\REV@triangleq}{}%
6212 \@ifxundefined\succsim{\let\succsim\altsuccsim}{}%
6213 \@ifxundefined\precsim{\let\precsim\altprecsim}{}%
6214 \@ifxundefined\lesssim{\let\lesssim\REV@lesssim}{}%
6215 \@ifxundefined\gtrsim {\let\gtrsim \REV@gtrsim }{}%
6216 \@ifxundefined\mathfrak{\let\mathfrak\REV@mathfrak}{}%
6217 \@ifxundefined\mathbb{\let\mathbb\REV@mathbb}{}%
6218 }%
6219 % \end{macrocode}
6220 % \end{macro}
6221 %
6222 % \begin{macrocode}
6223 %</revsymb>
6224 % \end{macrocode}
6225 %
6226 % \section{The \classoption{10pt} class option: the \texttt{10pt} module}
6227 % \changes{v4.0beta 2}{1999/06/20}
6228 % {AO: all code for \protect\classoption{10pt} is in this module.}
6229 % The file \file{10pt.rtx} is read in by the \classname{revtex4} document class
6230 % if \cmd\@pointsize\ has the value 10.
6231 %
6232 % \begin{macrocode}
6233 %<*10pt>
6234 % \end{macrocode}
6235 %
6236 % \begin{macrocode}
6237 \def\normalsize{%
6238 \@setfontsize\normalsize\@xpt{11.5}%
6239 \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
6240 \belowdisplayskip \abovedisplayskip
6241 \abovedisplayshortskip \abovedisplayskip
6242 \belowdisplayshortskip \abovedisplayskip
6243 \let\@listi\@listI
6244 }%
6245 % \end{macrocode}
6246 %
6247 % \begin{macrocode}
6248 \def\small{%
6249 \@setfontsize\small\@ixpt{10.5}%
6250 \abovedisplayskip 8.5\p@ \@plus3\p@ \@minus4\p@
6251 \belowdisplayskip \abovedisplayskip
6252 \abovedisplayshortskip \z@ \@plus2\p@
6253 \belowdisplayshortskip 4\p@ \@plus2\p@ \@minus2\p@
6254 \def\@listi{%
6255 \leftmargin\leftmargini
6256 \topsep 4\p@ \@plus2\p@ \@minus2\p@
6257 \parsep 2\p@ \@plus\p@ \@minus\p@
6258 \itemsep \parsep
6259 }%
6260 }%
6261 % \end{macrocode}
6262 %
6263 % \begin{macrocode}
6264 \def\footnotesize{%
6265 \@setfontsize\footnotesize\@viiipt{9.5pt}%
6266 \abovedisplayskip 6\p@ \@plus2\p@ \@minus4\p@
6267 \belowdisplayskip \abovedisplayskip
6268 \abovedisplayshortskip \z@ \@plus\p@
6269 \belowdisplayshortskip 3\p@ \@plus\p@ \@minus2\p@
6270 \def\@listi{%
6271 \leftmargin\leftmargini
6272 \topsep 3\p@ \@plus\p@ \@minus\p@
6273 \parsep 2\p@ \@plus\p@ \@minus\p@
6274 \itemsep \parsep
6275 }%
6276 }%
6277 % \end{macrocode}
6278 %
6279 % \begin{macrocode}
6280 \def\scriptsize{%
6281 \@setfontsize\scriptsize\@viipt\@viiipt
6282 }%
6283 \def\tiny{%
6284 \@setfontsize\tiny\@vpt\@vipt
6285 }%
6286 \def\large{%
6287 \@setfontsize\large\@xiipt{14pt}%
6288 }%
6289 \def\Large{%
6290 \@setfontsize\Large\@xivpt{18pt}%
6291 }%
6292 \def\LARGE{%
6293 \@setfontsize\LARGE\@xviipt{22pt}%
6294 }%
6295 \def\huge{%
6296 \@setfontsize\huge\@xxpt{25pt}%
6297 }%
6298 \def\Huge{%
6299 \@setfontsize\Huge\@xxvpt{30pt}%
6300 }%
6301 % \end{macrocode}
6302 %
6303 % \begin{macrocode}
6304 %\appdef\class@documenthook{%
6305 \@ifxundefined\twoside@sw{\@booleanfalse\twoside@sw}{}%
6306 \twoside@sw{%
6307 % \oddsidemargin -.1in
6308 % \evensidemargin -.4in
6309 \oddsidemargin -20pt
6310 \evensidemargin -20pt
6311 \marginparwidth 107pt
6312 }{%
6313 \oddsidemargin -.25in
6314 \evensidemargin -.25in
6315 \marginparwidth 30pt
6316 }%
6317 %}%
6318 % \end{macrocode}
6319 %
6320 % \begin{macrocode}
6321 \marginparsep 6pt
6322 % \end{macrocode}
6323 %
6324 % \begin{macrocode}
6325 \topmargin -61pt
6326 % \end{macrocode}
6327 %
6328 % \begin{macrocode}
6329 \headheight 25pt
6330 \headsep 16pt
6331 % \end{macrocode}
6332 %
6333 % \begin{macrocode}
6334 \topskip 10pt
6335 % \end{macrocode}
6336 %
6337 % \begin{macrocode}
6338 \footskip 30pt
6339 % \end{macrocode}
6340 %
6341 % Was: 57\cmd\baselineskip + \cmd\topskip
6342 % \begin{macrocode}
6343 %\appdef\set@pica@hook{%
6344 \textheight = 56pc
6345 %}%
6346 % \end{macrocode}
6347 %
6348 % \begin{macrocode}
6349 \textwidth42.5pc
6350 % \end{macrocode}
6351 %
6352 % \begin{macrocode}
6353 \columnsep 1.5pc
6354 \columnseprule 0pt
6355 % \end{macrocode}
6356 %
6357 % \begin{macrocode}
6358 \footnotesep 1pt
6359 \skip\footins 39pt plus 4pt minus 2pt
6360 \def\footnoterule{\kern-19pt\hrule width.5in\kern18.6pt\relax}%
6361 % \end{macrocode}
6362 %
6363 % \begin{macrocode}
6364 \floatsep 12pt plus 2pt minus 2pt
6365 \textfloatsep 20pt plus 2pt minus 4pt
6366 \intextsep 12pt plus 2pt minus 2pt
6367 % \end{macrocode}
6368 %
6369 % \begin{macrocode}
6370 \dblfloatsep 12pt plus 2pt minus 2pt
6371 \dbltextfloatsep 20pt plus 2pt minus 4pt
6372 % \end{macrocode}
6373 %
6374 % \begin{macrocode}
6375 \@fptop 0pt plus 1fil
6376 \@fpsep 8pt plus 2fil
6377 \@fpbot 0pt plus 1fil
6378 \@dblfptop 0pt plus 1fil
6379 \@dblfpsep 8pt plus 2fil
6380 \@dblfpbot 0pt plus 1fil
6381 % \end{macrocode}
6382 %
6383 % \begin{macrocode}
6384 \marginparpush 5pt
6385 % \end{macrocode}
6386 %
6387 % \begin{macrocode}
6388 \parskip 0pt plus 1pt
6389 \parindent 10pt
6390 \emergencystretch8\p@
6391 % \end{macrocode}
6392 %
6393 % \begin{macrocode}
6394 \partopsep 2pt plus 1pt minus 1pt
6395 % \end{macrocode}
6396 %
6397 % \begin{macrocode}
6398 \leftmargini 25pt
6399 \leftmarginii 22pt
6400 \leftmarginiii 18.7pt
6401 \leftmarginiv 17pt
6402 \leftmarginv 10pt
6403 \leftmarginvi 10pt
6404 % \end{macrocode}
6405 %
6406 % \begin{macrocode}
6407 \def\@listI{%
6408 \leftmargin\leftmargini
6409 \parsep 4\p@ plus2\p@ minus\p@
6410 \topsep 8\p@ plus2\p@ minus4\p@
6411 \itemsep 4\p@ plus2\p@ minus\p@
6412 }%
6413 % \end{macrocode}
6414 %
6415 % \begin{macrocode}
6416 \labelsep 4pt
6417 % \end{macrocode}
6418 %
6419 % \begin{macrocode}
6420 \def\@listii{%
6421 \leftmargin\leftmarginii
6422 \labelwidth\leftmarginii
6423 \advance\labelwidth-\labelsep
6424 \topsep 4\p@ plus2\p@ minus\p@
6425 \parsep 2\p@ plus\p@ minus\p@
6426 \itemsep \parsep
6427 }%
6428 % \end{macrocode}
6429 %
6430 % \begin{macrocode}
6431 \def\@listiii{%
6432 \leftmargin\leftmarginiii
6433 \labelwidth\leftmarginiii
6434 \advance\labelwidth-\labelsep
6435 \topsep 2\p@ plus\p@ minus\p@
6436 \parsep \z@
6437 \partopsep \p@ plus\z@ minus\p@
6438 \itemsep \topsep
6439 }%
6440 % \end{macrocode}
6441 %
6442 % \begin{macrocode}
6443 \def\@listiv{%
6444 \leftmargin\leftmarginiv
6445 \labelwidth\leftmarginiv
6446 \advance\labelwidth-\labelsep
6447 }%
6448 % \end{macrocode}
6449 %
6450 % \begin{macrocode}
6451 \def\@listv{%
6452 \leftmargin\leftmarginv
6453 \labelwidth\leftmarginv
6454 \advance\labelwidth-\labelsep
6455 }%
6456 % \end{macrocode}
6457 %
6458 % \begin{macrocode}
6459 \def\@listvi{%
6460 \leftmargin\leftmarginvi
6461 \labelwidth\leftmarginvi
6462 \advance\labelwidth-\labelsep
6463 }%
6464 % \end{macrocode}
6465 %
6466 % \begin{macrocode}
6467 %</10pt>
6468 % \end{macrocode}
6469 %
6470 % \section{The \classoption{11pt} class option: the \texttt{11pt} module}
6471 % \changes{v4.0beta 2}{1999/06/20}
6472 % {AO: all code for \protect\classoption{11pt} is in this module.}
6473 % The file \file{11pt.rtx} is read in by the \classname{revtex4} document class
6474 % if \cmd\@pointsize\ has the value 11.
6475 %
6476 % \begin{macrocode}
6477 %<*11pt>
6478 % \end{macrocode}
6479 %
6480 % \begin{macrocode}
6481 \def\normalsize{%
6482 \@setfontsize\normalsize\@xipt{13.6}%
6483 \abovedisplayskip 11\p@ \@plus3\p@ \@minus6\p@
6484 \belowdisplayskip \abovedisplayskip
6485 \abovedisplayshortskip \abovedisplayskip
6486 \belowdisplayshortskip \abovedisplayskip
6487 \let\@listi\@listI
6488 }%
6489 % \end{macrocode}
6490 %
6491 % \begin{macrocode}
6492 \def\small{%
6493 \@setfontsize\small\@xpt\@xiipt
6494 \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
6495 \abovedisplayshortskip \z@ \@plus3\p@
6496 \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@
6497 \def\@listi{\leftmargin\leftmargini
6498 \topsep 6\p@ \@plus2\p@ \@minus2\p@
6499 \parsep 3\p@ \@plus2\p@ \@minus\p@
6500 \itemsep \parsep
6501 }%
6502 \belowdisplayskip \abovedisplayskip
6503 }%
6504 % \end{macrocode}
6505 %
6506 % \begin{macrocode}
6507 \def\footnotesize{%
6508 \@setfontsize\footnotesize\@ixpt{11}%
6509 \abovedisplayskip 8\p@ \@plus2\p@ \@minus4\p@
6510 \abovedisplayshortskip \z@ \@plus\p@
6511 \belowdisplayshortskip 4\p@ \@plus2\p@ \@minus2\p@
6512 \def\@listi{\leftmargin\leftmargini
6513 \topsep 4\p@ \@plus2\p@ \@minus2\p@
6514 \parsep 2\p@ \@plus\p@ \@minus\p@
6515 \itemsep \parsep
6516 }%
6517 \belowdisplayskip \abovedisplayskip
6518 }%
6519 % \end{macrocode}
6520 %
6521 % \begin{macrocode}
6522 \def\scriptsize{%
6523 \@setfontsize\scriptsize\@viiipt{9.5}%
6524 }%
6525 \def\tiny{%
6526 \@setfontsize\tiny\@vipt\@viipt
6527 }%
6528 \def\large{%
6529 \@setfontsize\large\@xiipt{14}%
6530 }%
6531 \def\Large{%
6532 \@setfontsize\Large\@xivpt{18}%
6533 }%
6534 \def\LARGE{%
6535 \@setfontsize\LARGE\@xviipt{22}%
6536 }%
6537 \def\huge{%
6538 \@setfontsize\huge\@xxpt{25pt}%
6539 }%
6540 \def\Huge{%
6541 \@setfontsize\Huge\@xxvpt{30pt}%
6542 }%
6543 % \end{macrocode}
6544 %
6545 % \begin{macrocode}
6546 %</11pt>
6547 % \end{macrocode}
6548 %
6549 % \section{The \classoption{12pt} class option: the \texttt{12pt} module}
6550 % \changes{v4.0beta 2}{1999/06/20}
6551 % {AO: all code for \protect\classoption{12pt} is in this module.}
6552 % The file \file{12pt.rtx} is read in by the \classname{revtex4} document class
6553 % if \cmd\@pointsize\ has the value 12.
6554 %
6555 % \begin{macrocode}
6556 %<*12pt>
6557 % \end{macrocode}
6558 %
6559 % \begin{macrocode}
6560 \def\normalsize{%
6561 \@setfontsize\normalsize\@xiipt{14pt}%
6562 \abovedisplayskip 12\p@ \@plus3\p@ \@minus7\p@
6563 \belowdisplayskip \abovedisplayskip
6564 \abovedisplayshortskip \z@ plus3\p@
6565 \belowdisplayshortskip 6.5\p@ \@plus3.5\p@ \@minus3\p@
6566 \let\@listi\@listI
6567 }%
6568 % \end{macrocode}
6569 %
6570 % \begin{macrocode}
6571 \def\small{%
6572 \@setfontsize\small\@xipt{14.5pt}%
6573 \abovedisplayskip 8\p@ \@plus3\p@ \@minus6\p@
6574 \belowdisplayskip \abovedisplayskip
6575 \abovedisplayshortskip \z@ \@plus3\p@
6576 \belowdisplayshortskip 6.5\p@ \@plus3.5\p@ \@minus3\p@
6577 \def\@listi{%
6578 \leftmargin\leftmargini
6579 \topsep 9\p@ \@plus3\p@ \@minus5\p@
6580 \parsep 4.5\p@ \@plus2\p@ \@minus\p@
6581 \itemsep \parsep
6582 }%
6583 }%
6584 % \end{macrocode}
6585 %
6586 % Same baselineskip as \cmd\small\ ?
6587 % \begin{macrocode}
6588 \def\footnotesize{%
6589 \@setfontsize\footnotesize\@xpt{14.5pt}%
6590 \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
6591 \belowdisplayskip \abovedisplayskip
6592 \abovedisplayshortskip \z@ \@plus3\p@
6593 \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@
6594 \def\@listi{%
6595 \leftmargin\leftmargini
6596 \topsep 6\p@ \@plus2\p@ \@minus2\p@
6597 \parsep 3\p@ \@plus2\p@ \@minus\p@
6598 \itemsep \parsep
6599 }%
6600 }%
6601 % \end{macrocode}
6602 %
6603 % \begin{macrocode}
6604 \def\scriptsize{%
6605 \@setfontsize\scriptsize\@viiipt{9.5pt}%
6606 }%
6607 \def\tiny{%
6608 \@setfontsize\tiny\@vipt{7pt}%
6609 }%
6610 \def\large{%
6611 \@setfontsize\large\@xivpt{18pt}%
6612 }%
6613 \def\Large{%
6614 \@setfontsize\Large\@xviipt{22pt}%
6615 }%
6616 \def\LARGE{%
6617 \@setfontsize\LARGE\@xxpt{25pt}%
6618 }%
6619 \def\huge{%
6620 \@setfontsize\huge\@xxvpt{30pt}%
6621 }%
6622 \let\Huge=\huge
6623 % \end{macrocode}
6624 %
6625 % \begin{macrocode}
6626 %</12pt>
6627 % \end{macrocode}
6628 %
6629 % \section{Page parameters}%
6630 % This code is common to both \classoption{11pt} and \classoption{12pt}.
6631 %
6632 % \begin{macrocode}
6633 %<*11pt|12pt>
6634 % \end{macrocode}
6635 %
6636 % \begin{macrocode}
6637 %\appdef\class@documenthook{%
6638 \@ifxundefined\twoside@sw{\@booleanfalse\twoside@sw}{}%
6639 \twoside@sw{%
6640 \oddsidemargin 0pt
6641 \evensidemargin 0pt
6642 \marginparwidth 60pt
6643 }{%
6644 \oddsidemargin 0pt
6645 \evensidemargin 0pt
6646 \marginparwidth 44pt
6647 }%
6648 %}%
6649 % \end{macrocode}
6650 %
6651 % \begin{macrocode}
6652 \marginparsep 10pt
6653 % \end{macrocode}
6654 %
6655 % \begin{macrocode}
6656 \topmargin -37pt
6657 % \end{macrocode}
6658 %
6659 % \begin{macrocode}
6660 \headheight 12pt
6661 \headsep 25pt
6662 % \end{macrocode}
6663 %
6664 % \begin{macrocode}
6665 \topskip 10pt
6666 % \end{macrocode}
6667 %
6668 % \begin{macrocode}
6669 \footskip 30pt
6670 % \end{macrocode}
6671 %
6672 % \begin{macrocode}
6673 %\appdef\set@pica@hook{%
6674 \@ifxundefined\tightenlines@sw{\@booleanfalse\tightenlines@sw}{}%
6675 \textheight=665.5\p@
6676 \tightenlines@sw{%
6677 \def\baselinestretch{1}%
6678 }{%
6679 \def\baselinestretch{1.5}%
6680 }%
6681 %}%
6682 % \end{macrocode}
6683 %
6684 % \begin{macrocode}
6685 \textwidth 468pt
6686 % \end{macrocode}
6687 %
6688 % \begin{macrocode}
6689 \columnsep 10pt
6690 \columnseprule 0pt
6691 % \end{macrocode}
6692 %
6693 % \begin{macrocode}
6694 \footnotesep 1pt
6695 \skip\footins 25.25pt plus 4pt minus 2pt
6696 \def\footnoterule{\kern-5.25pt\hrule width.5in\kern4.85pt\relax}
6697 % \end{macrocode}
6698 %
6699 % \begin{macrocode}
6700 \floatsep 14pt plus 2pt minus 4pt
6701 \textfloatsep 20pt plus 2pt minus 4pt
6702 \intextsep 14pt plus 4pt minus 4pt
6703 % \end{macrocode}
6704 %
6705 % \begin{macrocode}
6706 \dblfloatsep 14pt plus 2pt minus 4pt
6707 \dbltextfloatsep 20pt plus 2pt minus 4pt
6708 % \end{macrocode}
6709 %
6710 % \begin{macrocode}
6711 \@fptop 0pt plus 1fil
6712 \@fpsep 10pt plus 2fil
6713 \@fpbot 0pt plus 1fil
6714 \@dblfptop 0pt plus 1fil
6715 \@dblfpsep 10pt plus 2fil%
6716 \@dblfpbot 0pt plus 1fil
6717 % \end{macrocode}
6718 %
6719 % \begin{macrocode}
6720 \marginparpush 7pt
6721 % \end{macrocode}
6722 %
6723 % \begin{macrocode}
6724 \parskip 0pt plus 1pt
6725 \parindent 15pt
6726 \emergencystretch8\p@
6727 \partopsep 3pt plus 2pt minus 2pt
6728 % \end{macrocode}
6729 %
6730 % \begin{macrocode}
6731 \leftmargini 30pt
6732 \leftmarginii 26pt
6733 \leftmarginiii 22pt
6734 \leftmarginiv 20pt
6735 \leftmarginv 12pt
6736 \leftmarginvi 12pt
6737 % \end{macrocode}
6738 %
6739 % \begin{macrocode}
6740 \def\@listI{\leftmargin\leftmargini \parsep 5\p@ plus2.5\p@ minus\p@
6741 \topsep 10\p@ plus4\p@ minus6\p@
6742 \itemsep 5\p@ plus2.5\p@ minus\p@
6743 }%
6744 % \end{macrocode}
6745 %
6746 % \begin{macrocode}
6747 \labelsep 6pt
6748 % \end{macrocode}
6749 %
6750 % \begin{macrocode}
6751 \def\@listii{\leftmargin\leftmarginii
6752 \labelwidth\leftmarginii\advance\labelwidth-\labelsep
6753 \topsep 5\p@ plus2.5\p@ minus\p@
6754 \parsep 2.5\p@ plus\p@ minus\p@
6755 \itemsep \parsep
6756 }%
6757 % \end{macrocode}
6758 %
6759 % \begin{macrocode}
6760 \def\@listiii{\leftmargin\leftmarginiii
6761 \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
6762 \topsep 2.5\p@ plus\p@ minus\p@
6763 \parsep \z@ \partopsep \p@ plus\z@ minus\p@
6764 \itemsep \topsep
6765 }%
6766 % \end{macrocode}
6767 %
6768 % \begin{macrocode}
6769 \def\@listiv{\leftmargin\leftmarginiv
6770 \labelwidth\leftmarginiv\advance\labelwidth-\labelsep
6771 }%
6772 % \end{macrocode}
6773 %
6774 % \begin{macrocode}
6775 \def\@listv{\leftmargin\leftmarginv
6776 \labelwidth\leftmarginv\advance\labelwidth-\labelsep
6777 }%
6778 % \end{macrocode}
6779 %
6780 % \begin{macrocode}
6781 \def\@listvi{\leftmargin\leftmarginvi
6782 \labelwidth\leftmarginvi\advance\labelwidth-\labelsep
6783 }%
6784 % \end{macrocode}
6785 %
6786 % \begin{macrocode}
6787 %</11pt|12pt>
6788 % \end{macrocode}
6789 %
6790 % \section{The \classoption{aps} class option: the \texttt{aps} module}
6791 % \changes{v4.0beta 2}{1999/06/20}
6792 % {AO: made aps.rtx part of revtex4.dtx}
6793 % The file \file{aps.rtx} is read in by the \classname{revtex4} document class
6794 % if \cmd\@society\ has the value \classoption{aps}.
6795 %
6796 % Here, code specific to APS journals is separated out from the \revtex\ document class.
6797 % (Other societies can customize \revtex\ by supplying their own \file{.rtx} file.)
6798 %
6799 % We first give some text entities (amounting to journal abbreviations),
6800 % then some APS-specific initialisations,
6801 % then code for particular APS journals.
6802 % In the latter case, the choice is
6803 % keyed off the macro \cmd\@journal.
6804 %
6805 % Note on \cmd\AtEndOfClass:
6806 % this file, like all journal substyles, is read in at \cmd\AtEndOfClass\ time,
6807 % so you should not use this command in this file.
6808 % Mote for \LaTeX\ developers: It would be an improvement in \LaTeX\ to
6809 % \cmd\let\cmd\AtEndOfClass\ to something like \cmd\@firstofone.
6810 % This change would be effected in \cmd\@onefilewithoptions.
6811 %
6812 % \begin{macrocode}
6813 %<*aps>
6814 % \end{macrocode}
6815 %
6816 % \subsection{Defend Against Forseeable Errors}%
6817 % Protect this file from being read in by anything but \revtex.
6818 % \begin{macrocode}
6819 \ifx\undefined\substyle@ext
6820 \def\@tempa{%
6821 \endinput
6822 \GenericWarning{I must be read in by REVTeX! (Bailing out)}%
6823 }%
6824 \expandafter\else
6825 \def\@tempa{}%
6826 \expandafter\fi\@tempa
6827 % \end{macrocode}
6828 %
6829 % \subsection{Abbreviations}%
6830 % The following macros constitute typing shortcuts for
6831 % certain journal names.
6832 % \begin{macrocode}
6833 \def\ao{Appl.\ Opt.\ }
6834 \def\ap{Appl.\ Phys.\ }
6835 \def\apl{Appl.\ Phys.\ Lett.\ }
6836 \def\apj{Astrophys.\ J.\ }
6837 \def\bell{Bell Syst.\ Tech.\ J.\ }
6838 \def\jqe{IEEE J.\ Quantum Electron.\ }
6839 \def\assp{IEEE Trans.\ Acoust.\ Speech Signal Process.\ }
6840 \def\aprop{IEEE Trans.\ Antennas Propag.\ }
6841 \def\mtt{IEEE Trans.\ Microwave Theory Tech.\ }
6842 \def\iovs{Invest.\ Ophthalmol.\ Vis.\ Sci.\ }
6843 \def\jcp{J.\ Chem.\ Phys.\ }
6844 \def\jmo{J.\ Mod.\ Opt.\ }
6845 \def\josa{J.\ Opt.\ Soc.\ Am.\ }
6846 \def\josaa{J.\ Opt.\ Soc.\ Am.\ A }
6847 \def\josab{J.\ Opt.\ Soc.\ Am.\ B }
6848 \def\jpp{J.\ Phys.\ (Paris) }
6849 \def\nat{Nature (London) }
6850 \def\oc{Opt.\ Commun.\ }
6851 \def\ol{Opt.\ Lett.\ }
6852 \def\pl{Phys.\ Lett.\ }
6853 \def\pra{Phys.\ Rev.\ A }
6854 \def\prb{Phys.\ Rev.\ B }
6855 \def\prc{Phys.\ Rev.\ C }
6856 \def\prd{Phys.\ Rev.\ D }
6857 \def\pre{Phys.\ Rev.\ E }
6858 \def\prl{Phys.\ Rev.\ Lett.\ }
6859 \def\rmp{Rev.\ Mod.\ Phys.\ }
6860 \def\pspie{Proc.\ Soc.\ Photo-Opt.\ Instrum.\ Eng.\ }
6861 \def\sjqe{Sov.\ J.\ Quantum Electron.\ }
6862 \def\vr{Vision Res.\ }
6863 % \end{macrocode}
6864 %
6865 % \subsection{APS Setup}%
6866 % Here we define the default procedures for APS journals.
6867 % Individual APS journals may override these definitions.
6868 %
6869 % \subsubsection{Title block}%
6870 %
6871 % The specifics of the title block.
6872 % Apply to all APS journals; individual journals may override these settings.
6873 %
6874 % \begin{macro}{\@fnsymbol}
6875 % The \LaTeX\ kernel definition of \cmd\@fnsymbol\ is overridden.
6876 % \begin{macrocode}
6877 \def\@fnsymbol#1{%
6878 \ensuremath{%
6879 \ifcase#1\or
6880 *\or \dagger \or
6881 \ddagger \or \mathsection \or
6882 \mathparagraph\or
6883 **\or \dagger\dagger \or
6884 \ddagger\ddagger \or \mathsection \mathsection \or
6885 \mathparagraph\mathparagraph\or
6886 *{*}*\ignorespaces \or \dagger\dagger\dagger \or
6887 \ddagger\ddagger\ddagger\or \mathsection \mathsection \mathsection \or
6888 \mathparagraph\mathparagraph\mathparagraph\or
6889 \else
6890 \@ctrerr
6891 \fi
6892 }%
6893 }%
6894 % \end{macrocode}
6895 % \end{macro}
6896 %
6897 % \begin{macro}{\titlepage}
6898 % \begin{macrocode}
6899 \renewenvironment{titlepage}{%
6900 \let\wastwocol@sw\twocolumn@sw
6901 \onecolumngrid
6902 \newpage
6903 \thispagestyle{titlepage}%
6904 \c@page\z@% article sets this to one not zero???
6905 }{%
6906 \wastwocol@sw{\twocolumngrid}{\newpage}%
6907 }%
6908 % \end{macrocode}
6909 % \end{macro}
6910 %
6911 % \begin{macro}{\frontmatter@abstractheading}
6912 % APS Journals all set the abstract head the same way, with no head.
6913 % However, if the user has specified the \classoption{preprint} class option,
6914 % then the abstract will have a head.
6915 % \begin{macrocode}
6916 \def\frontmatter@abstractheading{%
6917 \preprintsty@sw{%
6918 \begingroup
6919 \centering\large
6920 \abstractname
6921 \par
6922 \endgroup
6923 }{}%
6924 }%
6925 % \end{macrocode}
6926 % \end{macro}
6927 %
6928 % \begin{macro}{\frontmatter@abstractwidth}
6929 % All APS journals set the abstract to the same width.
6930 % \begin{macrocode}
6931 \def\frontmatter@abstractwidth{400\p@}%
6932 % \end{macrocode}
6933 % \end{macro}
6934 %
6935 % \begin{macro}{\frontmatter@abstractfont}
6936 % All APS journals set the abstract body the same way.
6937 % \changes{v4.0beta 3}{1999/11/13}
6938 % {Bug 123: add parskip to the abstract.}
6939 % \begin{macrocode}
6940 \def\frontmatter@abstractfont{%
6941 \small
6942 \parindent1em\relax
6943 \adjust@abstractwidth
6944 }%
6945 \def\adjust@abstractwidth{%
6946 \dimen@\textwidth\advance\dimen@-\frontmatter@abstractwidth
6947 \divide\dimen@\tw@
6948 \galley@sw{%
6949 \advance\rightskip\tw@\dimen@
6950 }{%
6951 \advance\leftskip\dimen@
6952 \advance\rightskip\dimen@
6953 }%
6954 }%
6955 % \end{macrocode}
6956 % \end{macro}
6957 %
6958 % All APS journal preprints use separate titlepage and full-width abstract.
6959 %
6960 % Note that we defer polling the \cmd\preprintsty@sw\ Boolean until
6961 % \cmd\AtBeginDocument\ time, because the document preamble
6962 % may legitimately change the state of that variable.
6963 % \begin{macrocode}
6964 \appdef\class@documenthook{%
6965 \preprintsty@sw{%
6966 \@ifxundefined\titlepage@sw{\@booleantrue\titlepage@sw}{}%
6967 % \tightenlines@sw{%
6968 % \def\baselinestretch{1}%
6969 % }{%
6970 % \def\baselinestretch{1.5}%
6971 % }%
6972 \def\frontmatter@abstractwidth{\textwidth}%
6973 \def\frontmatter@affiliationfont{\it}%
6974 \let\section\section@preprintsty
6975 % \let\@hangfrom@section\@hangfrom@section@preprintsty
6976 \let\subsection\subsection@preprintsty
6977 \let\subsubsection\subsubsection@preprintsty
6978 }{}%
6979 }%
6980 % \end{macrocode}
6981 %
6982 % \begin{macro}{\frontmatter@authorformat}
6983 % All APS journals set the author list the same.
6984 % The leading is 11.5 points, and
6985 % there is 11.5 points of extra space above the first author line
6986 % (which amounts to the same thing as 11.5 points extra below the title)
6987 % for a total of 23 points base-to-base.
6988 %
6989 % \begin{macrocode}
6990 \def\frontmatter@authorformat{%
6991 \skip@\@flushglue
6992 \@flushglue\z@ plus.3\hsize\relax
6993 \centering
6994 \advance\baselineskip\p@
6995 \parskip11.5\p@\relax
6996 \@flushglue\skip@
6997 %\preprintsty@sw{}{%
6998 % \addvspace{0\p@}%
6999 %}%
7000 }%
7001 % \end{macrocode}
7002 % \end{macro}
7003 %
7004 % \begin{macro}{\frontmatter@above@affilgroup}
7005 % The default amount of space above affiliation.
7006 % APS Journals have 24 points b-b above an affiliation group.
7007 % \begin{macrocode}
7008 \def\frontmatter@above@affilgroup{%
7009 %\preprintsty@sw{}{%
7010 % \addvspace{11\p@}%
7011 %}%
7012 }%
7013 % \end{macrocode}
7014 % \end{macro}
7015 %
7016 % \begin{macro}{\frontmatter@above@affiliation}
7017 % \begin{macro}{\frontmatter@above@affiliation@script}
7018 % The default amount of space above affiliation.
7019 % APS Journals have no extra space between author group down to common affiliation.
7020 % \begin{macrocode}
7021 \def\frontmatter@above@affiliation@script{%
7022 \skip@\@flushglue
7023 \@flushglue\z@ plus.3\hsize\relax
7024 \centering
7025 \@flushglue\skip@
7026 \addvspace{3.5\p@}%
7027 }%
7028 \def\frontmatter@above@affiliation{%
7029 \preprintsty@sw{}{%
7030 % \addvspace{12\p@}%
7031 }%
7032 }%
7033 % \end{macrocode}
7034 % \end{macro}
7035 % \end{macro}
7036 %
7037 % \begin{macro}{\frontmatter@affiliationfont}
7038 % All APS journals set the affiliation the same.
7039 % \begin{macrocode}
7040 \def\frontmatter@affiliationfont{%
7041 \small\it
7042 }%
7043 % \end{macrocode}
7044 % \end{macro}
7045 %
7046 % \begin{macro}{\frontmatter@collaboration@above}
7047 % PRL: 1.5 points extra: 13 points base-to-base above.
7048 % \begin{macrocode}
7049 \def\frontmatter@collaboration@above{%
7050 \preprintsty@sw{%
7051 }{%
7052 \parskip1.5\p@\relax
7053 }%
7054 }%
7055 % \end{macrocode}
7056 % \end{macro}
7057 %
7058 % Set up the default APS style for title block authors and affiliations.
7059 % \begin{macrocode}
7060 \@ifxundefined\groupauthors@sw{%
7061 \clo@groupedaddress
7062 }{}%
7063 % \end{macrocode}
7064 %
7065 % \begin{macro}{\frontmatter@setup}
7066 % All APS journals set the title page using the same font and size.
7067 % However, justification varies for the title block elements, so
7068 % we assert none here.
7069 % \begin{macrocode}
7070 \def\frontmatter@setup{%
7071 \normalfont
7072 }%
7073 % \end{macrocode}
7074 % \end{macro}
7075 %
7076 % \begin{macro}{\frontmatter@title@above}
7077 % \begin{macro}{\frontmatter@title@format}
7078 % \begin{macro}{\frontmatter@title@below}
7079 % All APS journals set the article title the same.
7080 %
7081 % Note: Spacing from title to author is 23 points base-to-base.
7082 % \begin{macrocode}
7083 \def\frontmatter@title@above{\addvspace{6\p@}}%
7084 \def\frontmatter@title@format{\large\bfseries\centering\parskip\z@skip}%
7085 \def\frontmatter@title@below{}%
7086 % \end{macrocode}
7087 % \end{macro}
7088 % \end{macro}
7089 % \end{macro}
7090 %
7091 % \begin{macro}{\frontmatter@makefnmark}
7092 % All APS journals share this procedure for setting the titlepage footnote text.
7093 % \begin{macrocode}
7094 \def\@author@parskip{3\p@}%
7095 \def\frontmatter@makefnmark{%
7096 \@textsuperscript{%
7097 \normalfont\@thefnmark
7098 }%
7099 }%
7100 \def\frontmatter@authorbelow{%
7101 \addvspace{3\p@}%
7102 }%
7103 % \end{macrocode}
7104 % \end{macro}
7105 %
7106 % \begin{macro}{\frontmatter@RRAP@format}
7107 % All APS journals use the same format for the ``Received, Revised, etc.'' block on the title page.
7108 %
7109 % Change note: 11.5 points b-b from author/affiliation down to date.
7110 % \begin{macrocode}
7111 \def\frontmatter@RRAP@format{%
7112 \small
7113 \centering
7114 % \preprintsty@sw{}{\parskip.5ex\relax}%
7115 \everypar{\hbox\bgroup(\@gobble@leavemode@uppercase}%
7116 \def\par{\@ifvmode{}{\unskip)\egroup\@@par}}%
7117 }%
7118 \def\punct@RRAP{;\egroup\ \hbox\bgroup}%
7119 \def\@gobble@leavemode@uppercase#1#2{\expandafter\MakeTextUppercase}%
7120 % \end{macrocode}
7121 % \end{macro}
7122 %
7123 % \begin{macro}{\frontmatter@PACS@format}
7124 %
7125 % \begin{macrocode}
7126 \def\frontmatter@PACS@format{%
7127 \addvspace{11\p@}%
7128 \footnotesize
7129 \adjust@abstractwidth
7130 \parindent\z@
7131 \parskip\z@skip
7132 \samepage
7133 }%
7134 % \end{macrocode}
7135 % \end{macro}
7136 %
7137 % \begin{macro}{\frontmatter@keys@format}
7138 %
7139 % \begin{macrocode}
7140 \def\frontmatter@keys@format{%
7141 \footnotesize
7142 \adjust@abstractwidth
7143 \parindent\z@
7144 \samepage
7145 }%
7146 % \end{macrocode}
7147 % \end{macro}
7148 %
7149 % \begin{macro}{\ps@titlepage}
7150 % \changes{v4.g}{1998/06/10}
7151 % {multiple preprint commands}
7152 % \changes{v4.0beta 2}{1999/06/20}
7153 % {Stack \cs{preprint} args flush right at right margin.}
7154 % Title page style. Currently empty except for preprint header,
7155 % which consists of all the \cmd\preprint\ arguments,
7156 % stacked flush right at the right margin.
7157 % \changes{v4.0beta 3}{1999/11/13}
7158 % {Insert procedure \cs{checkindate}}
7159 % \begin{macrocode}
7160 \def\ps@titlepage{%
7161 \def\@oddhead{%
7162 \hfill
7163 \produce@preprints\@preprint
7164 }%
7165 \let\@evenhead\@oddhead
7166 \def\@oddfoot{%
7167 \hb@xt@\z@{\byrevtex\hss}%
7168 \hfil
7169 \preprintsty@sw{\thepage}{}%
7170 \quad\checkindate
7171 \hfil
7172 }%
7173 \let\@evenfoot\@oddfoot
7174 }%
7175 \def\byrevtex{\byrevtex@sw{Typeset by REV\TeX}{}}%
7176 % \end{macrocode}
7177 % \end{macro}
7178 %
7179 % \begin{macro}{\produce@preprints}
7180 % \changes{v4.0beta 3}{1999/11/13}
7181 % {Bug 115. If three or more preprints specified, set on single line, with commas.}
7182 % \begin{macrocode}
7183 \def\produce@preprints#1{%
7184 \preprint@sw{%
7185 \vtop to \z@{%
7186 \def\baselinestretch{1}%
7187 \small
7188 \let\preprint\preprint@count
7189 \count@\z@#1\@ifnum{\count@>\tw@}{%
7190 \hbox{%
7191 \let\preprint\preprint@hlist
7192 #1\setbox\z@\lastbox
7193 }%
7194 }{%
7195 \let\preprint\preprint@cr
7196 \halign{\hfil##\cr#1\crcr}%
7197 \par
7198 \vss
7199 }%
7200 }%
7201 }{}%
7202 }%
7203 \def\preprint@cr#1{#1\cr}%
7204 \def\preprint@count#1{\advance\count@\@ne}%
7205 \def\preprint@hlist#1{#1\hbox{, }}%
7206 % \end{macrocode}
7207 % \end{macro}
7208 %
7209 % \subsubsection{Stacked Heads}%
7210 % All APS journals put a period (.), followed by quad space, after the section number.
7211 % Also, no hanging section number.
7212 % \begin{macrocode}
7213 \def\@seccntformat#1{\csname the#1\endcsname.\quad}%
7214 \def\@hang@from#1#2#3{#1#2#3}%
7215 % \end{macrocode}
7216 %
7217 % Note that in the following, we wish to set the section head uppercase, so we use
7218 % David Carlisle's \cmd\MakeTextUppercase. However, because this procedure effectively
7219 % parses its argument (looking for things to \emph{not} translate), it has to be invoked
7220 % in such a way that the argument of the \cmd\section\ command is passed to it as its
7221 % own argument.
7222 %
7223 % To accomplish this, we use the \cmd\@hangfrom@\ hook, which was developed for this
7224 % purpose.
7225 %
7226 % \begin{macrocode}
7227 \def\section{%
7228 \@startsection
7229 {section}%
7230 {1}%
7231 {\z@}%
7232 {0.8cm \@plus1ex \@minus .2ex}%
7233 {0.5cm}%
7234 {%
7235 \normalfont\small\bfseries
7236 \centering
7237 }%
7238 }%
7239 \def\@hangfrom@section#1#2#3{\@hangfrom{#1#2}\MakeTextUppercase{#3}}%
7240 % \end{macrocode}
7241 %
7242 % \begin{macrocode}
7243 \def\subsection{%
7244 \@startsection
7245 {subsection}%
7246 {2}%
7247 {\z@}%
7248 {.8cm \@plus1ex \@minus .2ex}%
7249 {.5cm}%
7250 {%
7251 \normalfont\small\bfseries
7252 \centering
7253 }%
7254 }%
7255 % \end{macrocode}
7256 %
7257 % \begin{macrocode}
7258 \def\subsubsection{%
7259 \@startsection
7260 {subsubsection}%
7261 {3}%
7262 {\z@}%
7263 {.8cm \@plus1ex \@minus .2ex}%
7264 {.5cm}%
7265 {%
7266 \normalfont\small\itshape
7267 \centering
7268 }%
7269 }%
7270 % \end{macrocode}
7271 %
7272 % \subsubsection{Runin Heads}%
7273 % \begin{macrocode}
7274 \def\paragraph{%
7275 \@startsection
7276 {paragraph}%
7277 {4}%
7278 {\parindent}%
7279 {\z@}%
7280 {-1em}%
7281 {\normalfont\normalsize\itshape}%
7282 }%
7283 % \end{macrocode}
7284 %
7285 % \begin{macrocode}
7286 \def\subparagraph{%
7287 \@startsection
7288 {subparagraph}%
7289 {5}%
7290 {\parindent}%
7291 {3.25ex \@plus1ex \@minus .2ex}%
7292 {-1em}%
7293 {\normalfont\normalsize\bfseries}%
7294 }%
7295 % \end{macrocode}
7296 %
7297 %
7298 %
7299 % \begin{macro}{\section@preprintsty}
7300 % \begin{macro}{\subsection@preprintsty}
7301 % \begin{macro}{\subsubsection@preprintsty}
7302 % Here are the formatting procedures specific to the preprint style;
7303 % the only difference is that the heads are flush left instead of centered.
7304 %
7305 % \begin{macrocode}
7306 \def\section@preprintsty{%
7307 \@startsection
7308 {section}%
7309 {1}%
7310 {\z@}%
7311 {0.8cm \@plus1ex \@minus .2ex}%
7312 {0.5cm}%
7313 {%
7314 \normalfont\small\bfseries
7315 % \centering
7316 }%
7317 }%
7318 %\def\@hangfrom@section@preprintsty#1#2#3{\@hangfrom{#1#2}\MakeTextUppercase{#3}}%
7319 % \end{macrocode}
7320 % \begin{macrocode}
7321 \def\subsection@preprintsty{%
7322 \@startsection
7323 {subsection}%
7324 {2}%
7325 {\z@}%
7326 {.8cm \@plus1ex \@minus .2ex}%
7327 {.5cm}%
7328 {%
7329 \normalfont\small\bfseries
7330 % \centering
7331 }%
7332 }%
7333 % \end{macrocode}
7334 % \begin{macrocode}
7335 \def\subsubsection@preprintsty{%
7336 \@startsection
7337 {subsubsection}%
7338 {3}%
7339 {\z@}%
7340 {.8cm \@plus1ex \@minus .2ex}%
7341 {.5cm}%
7342 {%
7343 \normalfont\small\itshape
7344 % \centering
7345 }%
7346 }%
7347 % \end{macrocode}
7348 % \end{macro}
7349 % \end{macro}
7350 % \end{macro}
7351 %
7352 % Effectively invoke the \classoption{bibnote} class option,
7353 % if \cmd\frontmatter@footnote@produce\ has not yet been set.
7354 % \begin{macrocode}
7355 \@ifxundefined\frontmatter@footnote@produce{%
7356 \let\frontmatter@footnote@produce\frontmatter@footnote@produce@endnote
7357 }{}%
7358 % \end{macrocode}
7359 %
7360 %
7361 % \subsubsection{Table of Contents}%
7362 % The toc will itself make an entry in the toc,
7363 % but we temporarily turn off toc formatting for the duration.
7364 % \begin{macrocode}
7365 \def\@pnumwidth{1.55em}
7366 \def\@tocrmarg {2.55em}
7367 \def\@dotsep{4.5pt}
7368 \setcounter{tocdepth}{3}
7369 % \end{macrocode}
7370 %
7371 % \begin{macrocode}
7372 \def\tableofcontents{%
7373 \addtocontents{toc}{\string\tocdepth@munge}%
7374 \print@toc{toc}%
7375 \addtocontents{toc}{\string\tocdepth@restore}%
7376 }%
7377 % \end{macrocode}
7378 %
7379 % \begin{macrocode}
7380 \def\tocdepth@munge{%
7381 \let\l@section@saved\l@section
7382 \let\l@section\@gobble@tw@
7383 }%
7384 \def\@gobble@tw@#1#2{}%
7385 % \end{macrocode}
7386 %
7387 % \begin{macrocode}
7388 \def\tocdepth@restore{%
7389 \let\l@section\l@section@saved
7390 }%
7391 % \end{macrocode}
7392 %
7393 % \begin{macrocode}
7394 \def\l@part#1#2{\addpenalty{\@secpenalty}%
7395 \begingroup
7396 \set@tocdim@pagenum{#2}%
7397 % \@tempdima 3em %
7398 \parindent \z@
7399 \rightskip\tocleft@pagenum plus 1fil\relax
7400 \skip@\parfillskip\parfillskip\z@
7401 \addvspace{2.25em plus\p@}%
7402 \large \bf %
7403 \leavevmode\ignorespaces#1\unskip\nobreak\hskip\skip@
7404 \hb@xt@\rightskip{\hfil\unhbox\z@}\hskip-\rightskip\hskip\z@skip
7405 \par
7406 \nobreak %
7407 \endgroup
7408 }%
7409 % \end{macrocode}
7410 %
7411 % \begin{macro}{\l@section}
7412 % Determine which TOC elements are automatically indented.
7413 % \begin{macrocode}
7414 \def\tocleft@{\z@}%
7415 \def\tocdim@min{5\p@}%
7416 \def\l@section{%
7417 \l@@sections{}{section}% Implicit #3#4
7418 }%
7419 \def\l@f@section{%
7420 \addpenalty{\@secpenalty}%
7421 \addvspace{1.0em plus\p@}%
7422 \bf
7423 }%
7424 \def\l@subsection{%
7425 \l@@sections{section}{subsection}% Implicit #3#4
7426 }%
7427 \def\l@subsubsection{%
7428 \l@@sections{subsection}{subsubsection}% Implicit #3#4
7429 }%
7430 \def\l@paragraph#1#2{}%
7431 \def\l@subparagraph#1#2{}%
7432 % \end{macrocode}
7433 % \end{macro}
7434 %
7435 % Activate the auto TOC processing.
7436 % \begin{macrocode}
7437 \let\toc@pre\toc@pre@auto
7438 \let\toc@post\toc@post@auto
7439 % \end{macrocode}
7440 %
7441 % \begin{macrocode}
7442 \def\listoffigures{\print@toc{lof}}%
7443 \def\l@figure{\@dottedtocline{1}{1.5em}{2.3em}}
7444 % \end{macrocode}
7445 %
7446 % \begin{macrocode}
7447 \def\listoftables{\print@toc{lot}}%
7448 \let\l@table\l@figure
7449 % \end{macrocode}
7450 %
7451 % \subsubsection{Default column bottom}%
7452 % All APS journal styles have flush bottoms.
7453 %
7454 % Note that we defer polling the \cmd\raggedcolumn@sw\ Boolean until
7455 % \cmd\AtBeginDocument\ time, because the document preamble
7456 % may legitimately change the state of that variable.
7457 % \begin{macrocode}
7458 \appdef\class@documenthook{%
7459 \@ifxundefined\raggedcolumn@sw{\@booleantrue\raggedcolumn@sw}{}%
7460 \raggedcolumn@sw{\raggedbottom}{\flushbottom}%
7461 }%
7462 % \end{macrocode}
7463 %
7464 %
7465 % \subsubsection{Table alignment style}%
7466 %
7467 % \begin{macro}{\tableft@skip@float}
7468 % \begin{macro}{\tabmid@skip@float}
7469 % \begin{macro}{\tabright@skip@float}
7470 % \begin{macro}{\array@row@pre@float}
7471 % \begin{macro}{\array@row@pst@float}
7472 % All APS publications have the same table specification:
7473 % Scotch rules above and below, centered in column.
7474 % \begin{macrocode}
7475 \def\tableft@skip@float{\z@ plus\hsize}%
7476 \def\tabmid@skip@float{\@flushglue}%
7477 \def\tabright@skip@float{\z@ plus\hsize}%
7478 \def\array@row@pre@float{\hline\hline\noalign{\vskip\doublerulesep}}%
7479 \def\array@row@pst@float{\noalign{\vskip\doublerulesep}\hline\hline}%
7480 % \end{macrocode}
7481 % \end{macro}
7482 % \end{macro}
7483 % \end{macro}
7484 % \end{macro}
7485 % \end{macro}
7486 %
7487 %
7488 % \subsubsection{Footnote formatting}%
7489 % We customize the formatting of footnotes for all APS journals.
7490 % \begin{macro}{\@makefntext}
7491 % \begin{macrocode}
7492 \def\@makefntext#1{%
7493 \def\baselinestretch{1}%
7494 \reset@font
7495 \footnotesize
7496 \leftskip1em
7497 \parindent1em
7498 \noindent\nobreak\hskip-\leftskip
7499 \hb@xt@\leftskip{%
7500 \Hy@raisedlink{\hyper@anchorstart{footnote@\the\c@footnote}\hyper@anchorend}%
7501 \hss\@makefnmark\
7502 }%
7503 #1%
7504 \par
7505 }%
7506 % \end{macrocode}
7507 % \end{macro}
7508 %
7509 %
7510 % \subsubsection{Appendix}%
7511 % \begin{macro}{\appendix}
7512 % \begin{macro}{\@hangfrom@appendix}
7513 % \begin{macro}{\@hangfroms@appendix}
7514 % \begin{macro}{\@appendixcntformat}
7515 % \changes{v4.0beta 3}{1999/11/13}
7516 % {Bug 129: section* within appendix was producing appendixname}
7517 % \begin{macrocode}
7518 \prepdef\appendix{%
7519 \par
7520 \let\@hangfrom@section\@hangfrom@appendix
7521 \let\@hangfroms@section\@hangfroms@appendix
7522 \let\@sectioncntformat\@appendixcntformat
7523 }%
7524 \def\@hangfrom@appendix#1#2#3{%
7525 #1%
7526 \@if@empty{#2}{%
7527 #3%
7528 }{%
7529 #2\@if@empty{#3}{}{:\ #3}%
7530 }%
7531 }%
7532 \def\@hangfroms@appendix#1#2{%
7533 #1#2%
7534 }%
7535 \def\@appendixcntformat#1{\appendixname\ \csname the#1\endcsname}%
7536 % \end{macrocode}
7537 % \end{macro}
7538 % \end{macro}
7539 % \end{macro}
7540 % \end{macro}
7541 %
7542 % \subsubsection{Bibliography}%
7543 %
7544 % Customize \revtex\ for the journal substyle;
7545 % this task requires three components:
7546 % the \BibTeX\ \file{apsrev.bst} style file,
7547 % customizing code for \file{natbib}, and
7548 % customizations of the \env{thebibliography} environment.
7549 %
7550 % \begin{macro}{\@bibstyle}
7551 % Define the argument of the \cmd\bibliographystyle\ command
7552 % (if the document does not do so).
7553 % The user must have installed a \file{.bst} file of the corresponding name.
7554 % This file will then be used by \BibTeX\ when compiling the document's \file{.bbl} file.
7555 %
7556 % The default bibliography style for the APS journal substyles, \file{apsrev.bst},
7557 % was originally called \file{revtex.bst}, but
7558 % that name is much too generic and should be given to a \file{.bst} file that
7559 % that applies generally to any \revtex\ jounal substyle, an impossibility.
7560 %
7561 % To generate \file{apsrev.bst}, use \classname{custom-bib} version 4.0b2 or later.
7562 % Run the \file{.bst} generator, \file{makebst.tex}, and
7563 % accept all defaults, with the following exceptions:
7564 %
7565 % \begin{enumerate}
7566 % \item
7567 % ORDERING OF REFERENCES: c: seq-no (references in order of Citation);
7568 % \item
7569 % AUTHOR NAMES: i: nm-init,ed-au (Initials + surname);
7570 % \item
7571 % NUMBER OF AUTHORS: l: max 12, min 12 (there will be three prompts total);
7572 % \item
7573 % TYPEFACE FOR AUTHORS IN LIST OF REFERENCES: u: nmft,nmft-def (User defined author font);
7574 % \item
7575 % FONT FOR FIRST NAMES: u: fnm-def (First names in user defined font);
7576 % \item
7577 % EDITOR NAMES IN INCOLLECTION ETC: a: nmfted (Editors incollection like authors);
7578 % \item
7579 % DATE FORMAT: p: yr-par (Date in parentheses);
7580 % \item
7581 % SUPPRESS MONTH: x: xmth (Date is year only);
7582 % \item
7583 % TITLE OF ARTICLE: i: tit-it (Title italic)
7584 % \item
7585 % ARTICLE TITLE PRESENT: x: jtit-x (No article title);
7586 % \item
7587 % JOURNAL NAME FONT: r: jttl-rm (Journal title normal);
7588 % \item
7589 % TECHNICAL REPORT TITLE: b: trtit-b (Tech. report title like books);
7590 % \item
7591 % JOURNAL VOLUME: b: vol-bf (Volume bold);
7592 % \item
7593 % VOLUME PUNCTUATION: c: volp-com (Volume with comma);
7594 % \item
7595 % PAGE NUMBERS: f: jpg-1 (Only start page number);
7596 % \item
7597 % JOURNAL NAME PUNCTUATION: x: jnm-x (Space after journal);
7598 % \item
7599 % PUBLISHER IN PARENTHESES: d: pub-date (Publisher and date in parentheses);
7600 % \item
7601 % PUBLISHER POSITION: p: pre-pub (Publisher before chapter, pages);
7602 % \item
7603 % ISBN NUMBER: isbn: (Include ISBN for books, booklets)
7604 % \item
7605 % ISSN NUMBER: issn: (Include ISSN for periodicals)
7606 % \item
7607 % EDITOR IN COLLECTIONS: b: edby (Booktitle, edited by \dots);
7608 % \item
7609 % PUNCTUATION BETWEEN SECTIONS (BLOCKS): c: blk-com (Comma between blocks);
7610 % \item
7611 % ABBREVIATE WORD `PAGES': a: pp (`Page' abbreviated);
7612 % \item
7613 % ABBREVIATE WORD `EDITORS': a: ed (`Editor' abbreviated);
7614 % \item
7615 % OTHER ABBREVIATIONS: a: abr (Abbreviations);
7616 % \item
7617 % ABBREVIATION FOR `EDITION': a: ednx (`Edition' abbreviated as `ed');
7618 % \item
7619 % EDITION NUMBERS: n: ord (Numerical editions);
7620 % \item
7621 % STORED JOURNAL NAMES: a: jabr (Abbreviated journal names);
7622 % \item
7623 % FONT OF `ET AL': i: etal-it (Italic et al);
7624 % \item
7625 % ADDITIONAL REVTeX DATA FIELDS: r: revdata, eprint, url, url-blk (Include REVTeX data fields collaboration, eid, eprint, numpages, url)
7626 % \item
7627 % NEW FONT SELECTION SCHEME: n: nfss (NFSS);
7628 % \item
7629 % ADDITIONAL REVTeX DATA FIELDS: y: revdata (additional data fields);
7630 % \item
7631 % REFERENCE COMPONENT TAGS: y: reference component tags;
7632 % \item
7633 % URL ADDRESS: n: URL as note;
7634 % \end{enumerate}
7635 %
7636 % A file \file{apsrev.dbj} file equivalent to the following should result:
7637 % \begin{verbatim}
7638 % \input docstrip
7639 % \preamble
7640 % ----------------------------------------
7641 % *** REVTeX-compatible apsrev.bst ***
7642 % \endpreamble
7643 % \postamble
7644 % End of customized bst file
7645 % \endpostamble
7646 % \keepsilent
7647 % \askforoverwritefalse
7648 % \def\MBopts{\from{merlin.mbs}{%
7649 % seq-no%: Citation order (unsorted, like unsrt.bst)
7650 % ,nm-init,ed-au%: Initials + surname (J. F. Smith)
7651 % ,nmlm%: Limited authors (et al replaces missing names)
7652 % ,x10%: Maximum of 10 authors
7653 % ,m10%: Minimum of 10 authors
7654 % ,nmft,nmft-def%: User defined author font (\bibnamefont)
7655 % ,fnm-def%: First names in user defined font (\bibfnamefont)
7656 % ,nmfted%: Editors incollection like authors font
7657 % ,yr-par%: Date in parentheses as (May 1993)
7658 % ,xmth%: Date is year only
7659 % ,tit-it%: Title italic (\em)
7660 % ,jtit-x%: No article title
7661 % ,jttl-rm%: Journal name normal font
7662 % ,trtit-b%: Tech. report title like books
7663 % ,vol-bf%: Volume bold as {\bf vol}(num)
7664 % ,volp-com%: Volume with comma as vol(num), ppp
7665 % ,jpg-1%: Only start page number
7666 % ,jnm-x%: Space after journal name
7667 % ,pub-date%: Publisher and date in parentheses (Oxford, 1994)
7668 % ,pre-pub%: Publisher before chapter, pages
7669 % ,isbn%: Include ISBN for books, booklets, etc.
7670 % ,issn%: Include ISSN for periodicals
7671 % ,edby%: In booktitle, edited by .. (where .. is names)
7672 % ,blk-com%: Comma between blocks
7673 % ,pp%: `Page' abbreviated as p. or pp.
7674 % ,ed%: `Editor' abbreviated as ed. or eds.
7675 % ,abr%: Abbreviations of such words
7676 % ,ednx%: `Edition' abbreviated as `ed'
7677 % ,ord%: Numerical editions as 1st, 2nd, 3rd, etc
7678 % ,jabr%: Abbreviated journal names
7679 % ,etal-it%: Italic et al
7680 % ,revdata,eprint,url,url-blk%: Include REVTeX data fields collaboration, eid, eprint, numpages, url
7681 % ,url,url-nt%: URL as note
7682 % ,bibinfo%: Reference component tags like \bibinfo in the content of \bibitem
7683 % ,nfss%: NFSS use \textbf, \emph, not \bf, \em
7684 % }}
7685 % \generate{\file{\jobname.bst}{\MBopts}}
7686 % \endbatchfile
7687 % \end{verbatim}
7688 %
7689 % To get a banner in the \file{.blg} file, patch by hand into \file{apsrev.bst}:
7690 % \begin{verbatim}
7691 % FUNCTION {banner.log} {"REVTeX-compatible apsrev.bst 9812" warning$}
7692 % \end{verbatim}
7693 % and invoke \texttt{banner.log} from within \texttt{begin.bib}
7694 %
7695 % We ensure that the journal substyle has the first word
7696 % in the matter by installing the (default) APS code
7697 % later on (see Section~\ref{sec:aps-defaults}).
7698 % \end{macro}
7699 %
7700 % \begin{macro}{\bibpunct}
7701 % The following commands effectively establish the style in which \cmd\cite\ commands are
7702 % formatted.
7703 % You can think of them as the second needed component for the bibliography.
7704 %
7705 % Set up for numerical citations.
7706 %
7707 % The journal substyles can override these choices.
7708 %
7709 % Note that setting \cmd\NAT@sort\ at this late hour is not totally effective.
7710 % You have to give \classname{natbib} the relevant options at load time.
7711 % \begin{macrocode}
7712 \bibpunct{[}{]}{,}{n}{}{,}%
7713 % \end{macrocode}
7714 % \end{macro}
7715 %
7716 % \begin{macro}{\bibsection}
7717 % We define the sectioning command to use when starting the bibliography.
7718 %
7719 % \changes{v4.0rc1}{2001/06/18}
7720 % {grid changes with push and pop}
7721 % \begin{macrocode}
7722 \def\bibsection{%
7723 \par
7724 % \twocolumn@sw{\onecolumngrid}{}%
7725 \onecolumngrid@push
7726 \begingroup
7727 \baselineskip26\p@
7728 % \def\@currentHref{section.bib}%
7729 \bib@device{\textwidth}{245.5\p@}%
7730 \endgroup
7731 \nobreak\@nobreaktrue
7732 \addvspace{19\p@}%
7733 \par
7734 % \twocolumn@sw{\twocolumngrid}{}%
7735 \onecolumngrid@pop
7736 }%
7737 % \end{macrocode}
7738 % \end{macro}
7739 %
7740 % \begin{macro}{\bib@device}
7741 % \begin{macro}{\bibpreamble}
7742 % \begin{macro}{\bibsep}
7743 % \begin{macro}{\newblock}
7744 % We define the sectioning command to use when starting the bibliography.
7745 % \begin{macrocode}
7746 \def\bib@device#1#2{%
7747 \hb@xt@#1{%
7748 \hfil
7749 \phantomsection
7750 \addcontentsline {toc}{section}{\protect\numberline{}\refname}%
7751 % \hyper@anchorstart {\@currentHref }%
7752 \hb@xt@#2{%
7753 \skip@\z@\@plus-1fil\relax
7754 \leaders\hrule height.25 \p@ depth.25 \p@ \hskip\z@\@plus1fil
7755 \hskip\skip@
7756 \hskip\z@\@plus0.125fil\leaders\hrule height.375\p@ depth.375\p@ \hskip\z@\@plus0.75fil \hskip\z@\@plus0.125fil
7757 \hskip\skip@
7758 \hskip\z@\@plus0.25 fil\leaders\hrule height.5 \p@ depth.5 \p@ \hskip\z@\@plus0.5 fil \hskip\z@\@plus0.25 fil
7759 \hskip\skip@
7760 \hskip\z@\@plus0.375fil\leaders\hrule height.625\p@ depth.625\p@ \hskip\z@\@plus0.25fil \hskip\z@\@plus0.375fil
7761 % \hskip\skip@
7762 % \hfil
7763 }%
7764 %\hyper@anchorend
7765 \hfil
7766 }%
7767 }%
7768 \let\bibpreamble\@empty
7769 \bibsep\z@\relax
7770 \def\newblock{\ }%
7771 % \end{macrocode}
7772 % \end{macro}
7773 % \end{macro}
7774 % \end{macro}
7775 % \end{macro}
7776 %
7777 % \begin{macro}{\bibfont}
7778 % We define the font switch that applies to the body of the bibliography.
7779 %
7780 % \begin{macrocode}
7781 \def\bibfont{%
7782 \small
7783 }%
7784 % \end{macrocode}
7785 % \end{macro}
7786 %
7787 %
7788 % \subsubsection{Index}%
7789 % FIXME: the following call to \cmd\twocolumn\ appears wrong if we were in two-column grid.
7790 % \changes{v4.0beta 3}{1999/11/13}
7791 % {grid changes with ltxgrid}
7792 % \changes{v4.0rc1}{2001/06/18}
7793 % {grid changes with push and pop}
7794 % \begin{macrocode}
7795 \newenvironment{theindex}{%
7796 %\let\wastwocol@sw\twocolumn@sw
7797 \columnseprule \z@
7798 \columnsep 35\p@
7799 \c@secnumdepth-\maxdimen
7800 \onecolumngrid@push
7801 \section{\indexname}%
7802 \thispagestyle{plain}%
7803 \parindent\z@
7804 \parskip\z@ plus.3\p@\relax
7805 \let\item\@idxitem
7806 %\wastwocol@sw{\twocolumngrid}{}%
7807 \onecolumngrid@pop
7808 }{%
7809 %\onecolumngrid@pop
7810 }%
7811 %
7812 \def\@idxitem{\par\hangindent 40\p@}
7813 %
7814 \def\subitem{\par\hangindent 40\p@ \hspace*{20\p@}}
7815 %
7816 \def\subsubitem{\par\hangindent 40\p@ \hspace*{30\p@}}
7817 %
7818 \def\indexspace{\par \vskip 10\p@ plus5\p@ minus3\p@\relax}
7819 % \end{macrocode}
7820 %
7821 %
7822 % \subsection{Journal-Specific Code}%
7823 %
7824 % For APS journals, we supply code specific to PRA, PRB, PRC, PRD, PRE, PRL, and RMP.
7825 % At present, they are identical,
7826 % with the exception of PRB's code for superscript citations.
7827 %
7828 % \begin{macrocode}
7829 \def\journal@pra{pra}%
7830 \def\journal@prb{prb}%
7831 \def\journal@prc{prc}%
7832 \def\journal@prd{prd}%
7833 \def\journal@pre{pre}%
7834 \def\journal@prl{prl}%
7835 \def\journal@prstab{prstab}%
7836 \def\journal@rmp{rmp}%
7837 % \end{macrocode}
7838 %
7839 % Note: the convention in this document class is that
7840 % the substyle must not override any explicit class options
7841 % declared by the document.
7842 % This means that the various Booleans of Section~\ref{sec:options}
7843 % may be assigned here only if they are still undefined at this point.
7844 %
7845 % For most all of the APS journals, the journal-dependent
7846 % code is relatively meager and is therefore embedded in this file.
7847 % However, the RMP code is sufficiently extensive that
7848 % splitting it out into a separate file is more convenient.
7849 %
7850 % \subsubsection{\classoption{pra}}%
7851 % \begin{macrocode}
7852 \@ifx{\@journal\journal@pra}{%
7853 % \end{macrocode}
7854 %
7855 % End of \classoption{pra} code.
7856 % \begin{macrocode}
7857 }{}%
7858 % \end{macrocode}
7859 %
7860 % \subsubsection{\classoption{prb}}%
7861 % \begin{macrocode}
7862 \@ifx{\@journal\journal@prb}{%
7863 % \end{macrocode}
7864 % PRB requires superscript citations.
7865 % We use Patrick Daly's \classname{natbib} package,
7866 % and hyperref and other packages are already set up to cope with this.
7867 %
7868 % \begin{macro}{\bibpunct}
7869 % By default, PRB selects the \classoption{bibnotes} option.
7870 % We also set up for numerical citations.
7871 % \begin{macrocode}
7872 \@ifxundefined\bibnotes@sw{\@booleantrue\bibnotes@sw}{}%
7873 \bibpunct{}{}{,}{s}{}{\textsuperscript{,}}%
7874 \def\@onlinecite#1{\begingroup\let\@cite\NAT@citenum\citealp{#1}\endgroup}%
7875 % \end{macrocode}
7876 % \end{macro}
7877 %
7878 % Invoke \classoption{superbib} option if the document
7879 % has made no selection of its own.
7880 % \begin{macrocode}
7881 \appdef\class@documenthook{%
7882 \@ifxundefined\place@bibnumber{%
7883 \let\place@bibnumber\place@bibnumber@sup
7884 }{}%
7885 }%
7886 % \end{macrocode}
7887 %
7888 % End of \classoption{prb} code.
7889 % \begin{macrocode}
7890 }{}%
7891 % \end{macrocode}
7892 %
7893 % \subsubsection{\classoption{prc}}%
7894 % \begin{macrocode}
7895 \@ifx{\@journal\journal@prc}{%
7896 % \end{macrocode}
7897 %
7898 % End of \classoption{prc} code.
7899 % \begin{macrocode}
7900 }{}%
7901 % \end{macrocode}
7902 %
7903 % \subsubsection{\classoption{prd}}%
7904 % \begin{macrocode}
7905 \@ifx{\@journal\journal@prd}{%
7906 % \end{macrocode}
7907 %
7908 % End of \classoption{prd} code.
7909 % \begin{macrocode}
7910 }{}%
7911 % \end{macrocode}
7912 %
7913 % \subsubsection{\classoption{pre}}%
7914 % \begin{macrocode}
7915 \@ifx{\@journal\journal@pre}{%
7916 % \end{macrocode}
7917 %
7918 % End of \classoption{prd} code.
7919 % \begin{macrocode}
7920 }{}%
7921 % \end{macrocode}
7922 %
7923 % \subsubsection{\classoption{prl}}%
7924 % \begin{macrocode}
7925 \@ifx{\@journal\journal@prl}{%
7926 % \end{macrocode}
7927 % In PRL, the default is the \classoption{bibnotes} option,
7928 % and the Acknowledgments section has no head.
7929 %
7930 % However, the References head is a device that may be described as a lozenge centered on the baseline,
7931 % 71 points wide by 2 points thick, with the ends tapering to a half point in thickness.
7932 % Space above 26 points base to base, below 31 base to base.
7933 % \begin{macrocode}
7934 \@ifxundefined\bibnotes@sw{\@booleantrue\bibnotes@sw}{}%
7935 \@booleanfalse\acknowledgments@sw
7936 %\let\acknowledgmentsname\@empty
7937 \def\bibsection{%
7938 \par
7939 \begingroup
7940 \baselineskip26\p@
7941 \bib@device{\hsize}{72\p@}%
7942 \endgroup
7943 \nobreak\@nobreaktrue
7944 \addvspace{19\p@}%
7945 }%
7946 % \end{macrocode}
7947 % Implement length checking.
7948 % Use the \classname{times} and \classname{mathtime} packages,
7949 % plus whatever other processing is required
7950 % to make the formatted output be true
7951 % to the metrics of the journal.
7952 %
7953 % Wait. Do not use mathtime after all. APS has their own way of doing math pi, involving
7954 % Adobe Mathematical Pi and other fonts.
7955 % \begin{macrocode}
7956 %\appdef\class@documenthook{%
7957 \@ifxundefined\lengthcheck@sw{\@booleanfalse\lengthcheck@sw}{}%
7958 \lengthcheck@sw{%
7959 \RequirePackage{times}%
7960 % \RequirePackage{mathtime}%
7961 }{%
7962 }%
7963 %}%
7964 % \end{macrocode}
7965 % A PRL does not have numbered sections.
7966 % \begin{macrocode}
7967 \c@secnumdepth=-\maxdimen
7968 % \end{macrocode}
7969 % Note: we defer this code until after type size file is read in.
7970 % \begin{macrocode}
7971 \appdef\set@typesize@hook{%
7972 \@ifnum{\@pointsize=10\relax}{%
7973 \lengthcheck@sw{%
7974 \def\large{%
7975 \@setfontsize\large{12.5}{14\p@}%
7976 }%
7977 \def\normalsize{%
7978 \@setfontsize\normalsize{10.5}\@xiipt
7979 \abovedisplayskip 6\p@ \@plus6\p@ \@minus5\p@
7980 \belowdisplayskip \abovedisplayskip
7981 \abovedisplayshortskip \abovedisplayskip
7982 \belowdisplayshortskip \abovedisplayskip
7983 \let\@listi\@listI
7984 }%
7985 \def\small{%
7986 \@setfontsize\small{9.5}\@xipt
7987 \abovedisplayskip 5\p@ \@plus5\p@ \@minus4\p@
7988 \belowdisplayskip \abovedisplayskip
7989 \abovedisplayshortskip \abovedisplayskip
7990 \belowdisplayshortskip \abovedisplayskip
7991 \let\@listi\@listI
7992 }%
7993 \DeclareMathSizes{12.5}{12.5}{9}{6}%
7994 \DeclareMathSizes{10.5}{10.5}{7.5}{5}%
7995 \DeclareMathSizes{9.5}{9.5}{7.0}{5}%
7996 }{%
7997 \def\normalsize{%
7998 \@setfontsize\normalsize\@xpt\@xiipt
7999 \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
8000 \belowdisplayskip \abovedisplayskip
8001 \abovedisplayshortskip \abovedisplayskip
8002 \belowdisplayshortskip \abovedisplayskip
8003 \let\@listi\@listI
8004 }%
8005 }%
8006 }{}%
8007 }%
8008 %\appdef\set@pica@hook{%
8009 \@ifnum{\@pointsize=10\relax}{%
8010 \textheight = 694.0\p@
8011 % \textheight = 55\baselineskip
8012 % \advance\textheight by \topskip
8013 }{}%
8014 %}%
8015 % \end{macrocode}
8016 %
8017 % End of \classoption{prl} code.
8018 % \begin{macrocode}
8019 }{}%
8020 % \end{macrocode}
8021 %
8022 % \subsubsection{\classoption{prstab}}%
8023 % \begin{macrocode}
8024 \@ifx{\@journal\journal@prstab}{%
8025 % \end{macrocode}
8026 %
8027 % End of \classoption{prstab} code.
8028 % \begin{macrocode}
8029 }{}%
8030 % \end{macrocode}
8031 %
8032 % \subsubsection{\classoption{rmp}}%
8033 % Read in the code from a file.
8034 % \begin{macrocode}
8035 \@ifx{\@journal\journal@rmp}{\input{\@journal\substyle@ext}}{}%
8036 % \end{macrocode}
8037 %
8038 %
8039 % \subsection{Establish APS Defaults}\label{sec:aps-defaults}
8040 %
8041 % \begin{macro}{\footinbib@sw}
8042 % All APS journals except RMP invoke the \classoption{footinbib} option.
8043 % We rely on the RMP-specific code to give a value to this switch.
8044 % \begin{macrocode}
8045 \@ifxundefined\footinbib@sw{\@booleantrue\footinbib@sw}{}%
8046 % \end{macrocode}
8047 % \end{macro}
8048 %
8049 % \begin{macro}{\place@bibnumber}
8050 % \begin{macro}{\@bibstyle}
8051 % We install code that will select the presentation for \cmd\bibitem s
8052 % and govern the \BibTeX\ processing.
8053 % If the user has not selected any related option and if
8054 % the journal substyle also has not, then the \classoption{aps}
8055 % option choses these defaults.
8056 % \begin{macrocode}
8057 \appdef\class@documenthook{%
8058 \@ifxundefined\place@bibnumber{%
8059 \let\place@bibnumber\place@bibnumber@inl
8060 }{}%
8061 \@ifxundefined\@bibstyle{%
8062 \def\@bibstyle{apsrev}%
8063 }{}%
8064 }%
8065 % \end{macrocode}
8066 % \end{macro}
8067 % \end{macro}
8068 %
8069 %
8070 % \begin{macrocode}
8071 %</aps>
8072 % \end{macrocode}
8073 %
8074 %
8075 % \section{The \classoption{rmp} journal substyle: the \texttt{rmp} module}
8076 %
8077 % The file \file{rmp.rtx} is read in by the \classname{revtex4} document class
8078 % if \cmd\@society\ has the value \classoption{aps}
8079 % and \cmd\@journal\ has the value \classoption{rmp}.
8080 %
8081 % It is read at the end of the \filename{aps.rtx}, so all definitions
8082 % and assignments in that file are operative unless overridden here.
8083 %
8084 %
8085 % \begin{macrocode}
8086 %<*rmp>
8087 % \end{macrocode}
8088 %
8089 % Protect this file from being read in by anything but \revtex.
8090 % \begin{macrocode}
8091 \ifx\undefined\substyle@ext
8092 \def\@tempa{%
8093 \endinput
8094 \GenericWarning{I must be read in by REVTeX! (Bailing out)}%
8095 }%
8096 \expandafter\else
8097 \def\@tempa{}%
8098 \expandafter\fi\@tempa
8099 % \end{macrocode}
8100 %
8101 % Protect this file from being read in as a society instead of a journal.
8102 % In such a case, \cmd\@journal\ will be \cmd\@empty.
8103 % \begin{macrocode}
8104 \@ifx@empty\@journal{%
8105 \class@warn{I have to read in the aps substyle first!}%
8106 \endinput
8107 \def\@society{aps}\def\@journal{rmp}%
8108 \expandafter\input\expandafter{\@society\substyle@ext}%
8109 }{}%
8110 % \end{macrocode}
8111 %
8112 % \subsection{Frontmatter}%
8113 %
8114 % \begin{macro}{\frontmatter@setup}
8115 %
8116 % \begin{macrocode}
8117 \def\frontmatter@setup{%
8118 \normalfont\sffamily\raggedright
8119 }%
8120 % \end{macrocode}
8121 % \end{macro}
8122 %
8123 % \begin{macro}{\PACS@warn}
8124 % Per Mark Doyle, RMP never displays the PACS, so they don't want the `use showpacs' warning spit out.
8125 % \begin{macrocode}
8126 \def\PACS@warn{RMP documents do not display PACS. Your \string\pacs\space will be ignored}%
8127 % \end{macrocode}
8128 % \end{macro}
8129 %
8130 % \begin{macro}{\frontmatter@title@above}
8131 % \begin{macro}{\frontmatter@title@format}
8132 % \begin{macro}{\frontmatter@title@below}
8133 %
8134 % \begin{macrocode}
8135 \def\frontmatter@title@above{}%
8136 \def\frontmatter@title@format{\Large\bfseries\raggedright}% HelveticaNeue-Medium(Italic) 14pt.
8137 \def\frontmatter@title@below{\addvspace{12\p@}}% 24pt b-b down to first author
8138 % \end{macrocode}
8139 % \end{macro}
8140 % \end{macro}
8141 % \end{macro}
8142 %
8143 % \begin{macro}{\frontmatter@authorformat}
8144 % Set the rag to a milder value, because we want to do true ragged right
8145 % typesetting, as opposed to the \LaTeX\ default, which gives very poor results.
8146 %
8147 % Note: author font is 9.8bp. 19.2bp/14.3bp above/below.
8148 % \begin{macrocode}
8149 \def\frontmatter@authorformat{%
8150 \preprintsty@sw{\vskip0.5pc\relax}{}%
8151 \@tempskipa\@flushglue
8152 \@flushglue\z@ plus50\p@\relax
8153 \raggedright\advance\leftskip.5in\relax
8154 \@flushglue\@tempskipa
8155 \parskip\z@skip
8156 }%
8157 % \end{macrocode}
8158 % \end{macro}
8159 %
8160 % \begin{macro}{\frontmatter@affiliationfont}
8161 % The hook \cmd\frontmatter@affiliationfont\ controls the formatting of affiliations and affiliation groups.
8162 % The hook \cmd\frontmatter@above@affilgroup\ is invoked just before proceeding with author/affiliation processing.
8163 % The \cmd\frontmatter@above@affiliation\ is the amount of space above affiliations in the \classoption{groupedaddress} style,
8164 % and \cmd\frontmatter@above@affiliation@script\ is that for \classoption{superscriptaddress}.
8165 %
8166 % Note: affiliation font is 9.03/10.4bp, 14.3bp/19.2bp b-b above/below
8167 % \begin{macrocode}
8168 \def\frontmatter@affiliationfont{% Helvetica 9/10.2
8169 \small\slshape\selectfont\baselineskip10.5\p@\relax
8170 \@tempskipa\@flushglue
8171 \@flushglue\z@ plus50\p@\relax
8172 \raggedright\advance\leftskip.5in\relax
8173 \@flushglue\@tempskipa
8174 }%
8175 \def\frontmatter@above@affilgroup{\addvspace{7.2\p@}}% additional leading above an author
8176 \def\frontmatter@above@affiliation{\addvspace{5.3\p@}}%
8177 \def\frontmatter@above@affiliation@script{}%
8178 % \end{macrocode}
8179 % \end{macro}
8180 %
8181 % Set up the default RMP style for title block authors and affiliations.
8182 % This command should effectively override the effect of the
8183 % corresponding command in the parent substyle.
8184 % \begin{macrocode}
8185 \@ifxundefined\groupauthors@sw{%
8186 \clo@groupedaddress
8187 }{}%
8188 % \end{macrocode}
8189 %
8190 % \begin{macro}{\frontmatter@RRAP@format}
8191 % Note: in RMP, if we are not in preprint mode, the date will not be produced.
8192 %
8193 % Note: Helvetica C/lc, 8.98bp, space above: 16.3bp b-b.
8194 % \begin{macrocode}
8195 \def\frontmatter@RRAP@format{%
8196 \addvspace{7.3\p@}%
8197 \small
8198 \raggedright\advance\leftskip.5in\relax
8199 % \parskip.5ex\relax
8200 % \everypar{\hbox\bgroup(\@gobble@leavemode@uppercase}%
8201 % \def\par{\@ifvmode{}{\unskip)\egroup\@@par}}%
8202 % \preprintsty@sw{}{\let\@date\@empty}%
8203 }%
8204 %\def\@gobble@leavemode@uppercase#1#2{\expandafter\MakeTextUppercase}%
8205 \def\produce@RRAP#1{%
8206 \@if@empty{#1}{}{%
8207 \@ifvmode{\leavevmode}{}%
8208 \unskip(\ignorespaces#1\unskip)\quad
8209 }%
8210 }%
8211 % \end{macrocode}
8212 % \end{macro}
8213 %
8214 % \begin{macro}{\frontmatter@abstractheading}
8215 % Space above 21.8bp b-b.
8216 % \begin{macrocode}
8217 \def\frontmatter@abstractheading{%
8218 \preprintsty@sw{%
8219 \begingroup
8220 \centering\large
8221 \abstractname
8222 \par
8223 \endgroup
8224 \vspace{.5pc}%
8225 }{}%
8226 }%
8227 % \end{macrocode}
8228 % \end{macro}
8229 %
8230 % \begin{macro}{\frontmatter@abstractfont}
8231 % TimesTen 8.93bp/9.6bp X 360bp, indented 36bp, with 21.9/37.6bp b-b above/below
8232 % \begin{macrocode}
8233 \def\frontmatter@abstractfont{%
8234 \footnotesize
8235 \hsize360\p@
8236 \leftskip=0.5in
8237 \advance\hsize\leftskip
8238 %\rightskip=\leftskip
8239 \parindent\z@
8240 %\hsize5.5in
8241 }%
8242 % \end{macrocode}
8243 % \end{macro}
8244 %
8245 % \begin{macro}{\frontmatter@preabstractspace}
8246 % \begin{macro}{\frontmatter@postabstractspace}
8247 % Space above and space below abstract in title block.
8248 % Should be 22/36 points base-to-base.
8249 % \begin{macrocode}
8250 \def\frontmatter@preabstractspace{7.7\p@}%
8251 \def\frontmatter@postabstractspace{24.6\p@}%
8252 % \end{macrocode}
8253 % \end{macro}
8254 % \end{macro}
8255 %
8256 % FIXME: Not done: PACS.
8257 % FIXME: TOC: Head is same as \section: HelveticaNeue 8.98. 32/22bp b-b above/below,
8258 % Body: TimesTen 8/10.5.
8259 %
8260 % \subsection{General Text}%
8261 %
8262 % If not in preprint mode, set the type size to 10/12 point. Note: s/b 11.6bp leading
8263 % \begin{macrocode}
8264 \appdef\set@typesize@hook{%
8265 \@ifxundefined\preprintsty@sw{}{%
8266 \preprintsty@sw{}{%
8267 \def\normalsize{%
8268 \@setsize\normalsize{12pt}\xpt\@xpt
8269 \abovedisplayskip 10\p@ plus2\p@ minus5\p@
8270 \belowdisplayskip \abovedisplayskip
8271 \abovedisplayshortskip \abovedisplayskip
8272 \belowdisplayshortskip \abovedisplayskip
8273 \let\@listi\@listI
8274 }%
8275 }%
8276 }%
8277 }%
8278 % \end{macrocode}
8279 %
8280 % Footnote mods:
8281 % \begin{macrocode}
8282 \footnotesep 9.25pt
8283 \skip\footins 36pt plus 4pt minus 2pt
8284 \def\footnoterule{\kern-13pt\hrule width.5in\kern15.6pt\relax}%
8285 % \end{macrocode}
8286 %
8287 %
8288 % \subsection{Sectioning}
8289 %
8290 % \begin{macrocode}
8291 \def\thepart{\Roman{part}} %
8292 \def\thesection{\Roman{section}}
8293 \def\p@section{}
8294 \def\thesubsection{\Alph{subsection}}
8295 \def\p@subsection{\thesection.}
8296 \def\thesubsubsection{\arabic{subsubsection}}
8297 \def\p@subsubsection{\thesection.\thesubsection.}
8298 \def\theparagraph{\alph{paragraph}}
8299 \def\p@paragraph{\thesection.\thesubsection.\thesubsubsection.}
8300 \def\thesubparagraph{\arabic{subparagraph}}
8301 \def\p@subparagraph{\thesection.\thesubsection.\thesubsubsection.\theparagraph.}
8302 % \end{macrocode}
8303 %
8304 % In RMP, put a period (.), followed by nut space, after the section number.
8305 % Also, hang the section number (the \LaTeX\ default).
8306 % \begin{macrocode}
8307 \def\@seccntformat#1{\csname the#1\endcsname.\hskip0.5em\relax}%
8308 % \end{macrocode}
8309 %
8310 % Note that we wish to set the section head uppercase, so we use
8311 % David Carlisle's \cmd\MakeTextUppercase. However, because this procedure effectively
8312 % parses its argument (looking for things to \emph{not} translate), it has to be invoked
8313 % in such a way that the argument of the \cmd\section\ command is passed to it as its
8314 % own argument.
8315 %
8316 % To accomplish this, we use the \cmd\@hangfrom@\ hook, which was developed for this
8317 % purpose.
8318 % \begin{macrocode}
8319 \def\section{%
8320 \@startsection{section}{1}{\z@}{0.8cm plus1ex minus.2ex}{0.4cm}%
8321 {%
8322 \small\sffamily\bfseries\selectfont
8323 \raggedright
8324 \parindent\z@
8325 }%
8326 }%
8327 \def\@hangfrom@section#1#2#3{\@hangfrom{#1#2}\MakeTextUppercase{#3}}%
8328 \def\subsection{%
8329 \@startsection{subsection}{2}{\z@}{0.8cm plus1ex minus.2ex}{0.4cm}%
8330 {%
8331 \small\sffamily\bfseries
8332 \raggedright
8333 \parindent\z@
8334 }%
8335 }%
8336 \def\subsubsection{%
8337 \@startsection{subsubsection}{3}{\z@}{.8cm plus1ex minus.2ex}{0.4cm}%
8338 {%
8339 \small\sffamily\selectfont
8340 \raggedright
8341 \parindent\z@
8342 }%
8343 }%
8344 \def\paragraph{%
8345 \@startsection{paragraph}{4}{\z@}{.8cm plus1ex minus.2ex}{-1em}%
8346 {%
8347 \small\slshape\selectfont
8348 \raggedright
8349 \parindent\z@
8350 }%
8351 }%
8352 \def\subparagraph{%
8353 \@startsection{subparagraph}{4}{\parindent}{3.25ex plus1ex minus.2ex}{-1em}%
8354 {\normalsize\bfseries\selectfont}%
8355 }%
8356 %
8357 \setcounter{tocdepth}{4}% FIXME: has no effect
8358 % \end{macrocode}
8359 %
8360 % \begin{macro}{\appendix}
8361 % \begin{macro}{\@hangfrom@appendix}
8362 % \begin{macro}{\@hangfroms@appendix}
8363 % \begin{macro}{\@appendixcntformat}
8364 % \begin{macrocode}
8365 \appdef\appendix{%
8366 \let\@hangfrom@section\@hangfrom@appendix
8367 \let\@hangfroms@section\@hangfroms@appendix
8368 \let\@sectioncntformat\@appendixcntformat
8369 }%
8370 \def\@hangfrom@appendix#1#2#3{%
8371 #1%
8372 \@if@empty{#2}{%
8373 #3%
8374 }{%
8375 #2\@if@empty{#3}{}{:\ #3}%
8376 }%
8377 }%
8378 \def\@hangfroms@appendix#1#2{%
8379 #1\appendixname\@if@empty{#2}{}{:\ #2}%
8380 }%
8381 \def\@appendixcntformat#1{\appendixname\ \csname the#1\endcsname}%
8382 % \end{macrocode}
8383 % \end{macro}
8384 % \end{macro}
8385 % \end{macro}
8386 % \end{macro}
8387 %
8388 %
8389 % \subsection{Figure and Table Caption Formatting}
8390 % \begin{macro}{\@makecaption}
8391 %
8392 % \begin{macrocode}
8393 \setlength\belowcaptionskip{2\p@}
8394 \long\def\@makecaption#1#2{%
8395 \vskip\abovecaptionskip
8396 \vbox{%
8397 \flushing
8398 \small\rmfamily
8399 % \hsize\@capwidth
8400 \noindent
8401 #1\nobreak\hskip.5em plus.2em\ignorespaces#2\par
8402 }%
8403 \vskip\belowcaptionskip
8404 }%
8405 % \end{macrocode}
8406 % \end{macro}
8407 %
8408 % \subsection{Citations and Bibliography}%
8409 %
8410 % Customize \revtex\ for the journal substyle;
8411 % this task requires three components:
8412 % a \BibTeX\ \file{.bst} style file,
8413 % customizing code for \file{natbib}, and
8414 % customizations of the \env{thebibliography} environment.
8415 %
8416 % \begin{macro}{\@bibstyle}
8417 % Define the argument of the \cmd\bibliographystyle\ command
8418 % (if the document does not do so).
8419 %
8420 % The user must have installed a \file{.bst} file of the corresponding name.
8421 % This file will then be used by \BibTeX\ when compiling the document's \file{.bbl} file.
8422 %
8423 % To generate \file{apsrmp.bst}, use \classname{custom-bib} version 3.89d1 or later.
8424 % Run the \file{.bst} generator, \file{makebst.tex}, with the following options:
8425 %
8426 % \begin{enumerate}
8427 % \item
8428 % STYLE OF CITATIONS: a: ay( Author-year with some non-standard interface)
8429 % \item
8430 % AUTHOR-YEAR SUPPORT SYSTEM: nat: (Natbib for use with natbib v5.3 or later)
8431 % \item
8432 % ORDERING OF REFERENCES: *: (Alphabetical);
8433 % \item
8434 % ORDER ON VON PART: x: vonx (Sort without von part---de la Maire after Mahone)
8435 % \item
8436 % AUTHOR NAMES: a: nm-rev1 (Only first name reversed, initials---AGU style: Smith, J. F., H. K. Jones)
8437 % \item
8438 % POSITION OF JUNIOR: jnrlst (Junior comes last as Smith, John, Jr.)
8439 % \item
8440 % NUMBER OF AUTHORS: l: max 12, min 12 (three prompts in all);
8441 % \item
8442 % TYPEFACE FOR AUTHORS IN LIST OF REFERENCES: u: nmft, nmft-def (User defined author font---\cmd\bibnamefont)
8443 % \item
8444 % FONT FOR FIRST NAMES: u: fnm-def (First names in user defined font---\cmd\bibfnamefont)
8445 % \item
8446 % EDITOR NAMES IN INCOLLECTION ETC: a: nmfted (Editors incollection like authors font)
8447 % \item
8448 % FONT FOR `AND' IN LIST: r: nmand-rm (`And' in normal font---JONES and JAMES)
8449 % \item
8450 % FONT OF CITATION LABELS IN TEXT: u: lab, lab-def (User-defined citation font---\cmd\citenamefont)
8451 % \item
8452 % LABEL WHEN AUTHORS MISSING: keyxyr (Year blank when KEY replaces missing author---for natbib 7.0)
8453 % \item
8454 % DATE POSITION: b: dt-beg (Date after authors)
8455 % \item
8456 % SUPPRESS MONTH: xmth (Date is year only)
8457 % \item
8458 % DATE FORMAT: yr-com (Date preceded by comma as `, 1993')
8459 % \item
8460 % TRUNCATE YEAR: note-yr (Year text full as 1990--1993 or `in press')
8461 % \item
8462 % ARTICLE TITLE PRESENT: x: jtit-x (No article title);
8463 % \item
8464 % JOURNAL TITLE FONT: r: jttl-rm (Journal title normal);
8465 % \item
8466 % TECHNICAL REPORT TITLE: b: trtit-b (Tech. report title like books);
8467 % \item
8468 % JOURNAL VOLUME: b: vol-bf (Volume bold);
8469 % \item
8470 % VOLUME PUNCTUATION: c: volp-com (Volume with comma);
8471 % \item
8472 % PAGE NUMBERS: f: jpg-1 (Only start page number);
8473 % \item
8474 % POSITION OF PAGES: e: pp-last (Pages at end, but before any notes)
8475 % \item
8476 % NUMBER AND SERIES FOR COLLECTIONS: num-xser (Allows number without series and suppresses word ``number'')
8477 % \item
8478 % JOURNAL NAME PUNCTUATION: x: jnm-x (Space after journal);
8479 % \item
8480 % PUBLISHER IN PARENTHESES: p: pub-par (Publisher in parentheses)
8481 % \item
8482 % PUBLISHER POSITION: p: pre-pub (Publisher before chapter, pages);
8483 % \item
8484 % ISBN NUMBER: *: isbn (Include ISBN);
8485 % \item
8486 % ISSN NUMBER: *: isbn (Include ISSN for periodicals);
8487 % \item
8488 % `EDITOR' AFTER NAMES: a: edpar (`Name (editor),' in parentheses, after name, comma after)
8489 % \item
8490 % EDITOR IN COLLECTIONS: b: edby (In booktitle, edited by\dots---where \dots is names)
8491 % \item
8492 % PUNCTUATION BETWEEN SECTIONS (BLOCKS): c: blk-com (Comma between blocks);
8493 % \item
8494 % `IN' WITH JOURNAL NAMES: i: injnl (Add `in' before journal name in style for incollection)
8495 % \item
8496 % ABBREVIATE WORD `PAGES': a: pp (`Page' abbreviated);
8497 % \item
8498 % ABBREVIATE WORD `EDITORS': a: ed (`Editor' abbreviated);
8499 % \item
8500 % ABBREVIATION FOR `EDITION': a: ednx (`Edition' abbreviated as `ed');
8501 % \item
8502 % EDITION NUMBERS: xedn (Editions as in database saving much processing memory)
8503 % \item
8504 % STORED JOURNAL NAMES: a: jabr (Abbreviated journal names);
8505 % \item
8506 % FONT OF `ET AL': i: etal-it (Italic et al);
8507 % \item
8508 % ADDITIONAL REVTeX DATA FIELDS: r: revdata, eprint, url, url-blk (Include REVTeX data fields)
8509 % \item
8510 % NEW FONT SELECTION SCHEME: n: nfss (NFSS);
8511 % \item
8512 % ADDITIONAL REVTeX DATA FIELDS: y: revdata (additional data fields);
8513 % \item
8514 % REFERENCE COMPONENT TAGS: r: bibinfo (reference component tags);
8515 % \end{enumerate}
8516 %
8517 % A file \file{apsrmp.dbj} file equivalent to the following should result:
8518 % \begin{verbatim}
8519 % \input docstrip
8520 % \preamble
8521 % ----------------------------------------
8522 % *** REVTeX-compatible apsrmp.bst ***
8523 % \endpreamble
8524 % \postamble
8525 % End of customized bst file
8526 % \endpostamble
8527 % \keepsilent
8528 % \askforoverwritefalse
8529 % \def\MBopts{\from{merlin.mbs}{%
8530 % ay%: Author-year with some non-standard interface
8531 % ,nat%: Natbib for use with natbib v5.3 or later
8532 % ,vonx%: Sort without von part (de la Maire after Mahone)
8533 % ,nm-rev1%: Only first name reversed, initials (AGU style: Smith, J. F., H. K. Jones)
8534 % ,jnrlst%: Junior comes last as Smith, John, Jr.
8535 % ,nmlm%: Limited authors (et al replaces missing names)
8536 % ,x10%: Maximum of 10 authors
8537 % ,m10%: Minimum of 10 authors
8538 % ,nmft,nmft-def%: User defined author font (\bibnamefont)
8539 % ,fnm-def%: First names in user defined font (\bibfnamefont)
8540 % ,nmfted%: Editors incollection like authors font
8541 % ,nmand-rm%: `And' in normal font (JONES and JAMES)
8542 % ,lab,lab-def%: User defined citation font (\citenamefont)
8543 % ,keyxyr%: Year blank when KEY replaces missing author (for natbib 7.0)
8544 % ,dt-beg%: Date after authors
8545 % ,xmth%: Date is year only
8546 % ,yr-com%: Date preceded by comma as `, 1993'
8547 % ,note-yr%: Year text full as 1990--1993 or `in press'
8548 % ,jtit-x%: No article title
8549 % ,jttl-rm%: Journal name normal font
8550 % ,trtit-b%: Tech. report title like books
8551 % ,vol-bf%: Volume bold as {\bf vol}(num)
8552 % ,volp-com%: Volume with comma as vol(num), ppp
8553 % ,jpg-1%: Only start page number
8554 % ,pp-last%: Pages at end but before any notes
8555 % ,num-xser%: Allows number without series and suppresses word "number"
8556 % ,jnm-x%: Space after journal name
8557 % ,pub-par%: Publisher in parentheses
8558 % ,pre-pub%: Publisher before chapter, pages
8559 % ,isbn%: Include ISBN for books, booklets, etc.
8560 % ,issn%: Include ISSN for periodicals
8561 % ,edpar%: `Name (editor),' in parentheses, after name, comma after
8562 % ,edby%: In booktitle, edited by .. (where .. is names)
8563 % ,blk-com%: Comma between blocks
8564 % ,injnl%: Add `in' before journal name in style for incollection
8565 % ,pp%: `Page' abbreviated as p. or pp.
8566 % ,ed%: `Editor' abbreviated as ed. or eds.
8567 % ,xedn%: Editions as in database saving much processing memory
8568 % ,jabr%: Abbreviated journal names
8569 % ,etal-it%: Italic et al
8570 % ,revdata,eprint,url,url-blk%: Include REVTeX data fields collaboration, eid, eprint, numpages, url
8571 % ,bibinfo%: Reference component tags like \bibinfo in the content of \bibitem
8572 % ,nfss%: NFSS use \textbf, \emph, not \bf, \em
8573 % }}
8574 % \generate{\file{\jobname.bst}{\MBopts}}
8575 % \endbatchfile
8576 % \end{verbatim}
8577 %
8578 % \begin{macrocode}
8579 \appdef\class@documenthook{%
8580 \@ifxundefined\@bibstyle{%
8581 \def\@bibstyle{apsrmp}%
8582 }{}%
8583 }%
8584 % \end{macrocode}
8585 % \end{macro}
8586 %
8587 % \begin{macro}{\bibpunct}
8588 % The following commands effectively etablish the style in which \cmd\cite\ commands are
8589 % formatted.
8590 % You can think of them as the second needed component for the bibliography.
8591 %
8592 % Set up for author-year citations:
8593 % when \cmd\NAT@set@cites\ executes (at \envb{document} time), the \cmd\@biblabel\ will
8594 % be set to \cmd\NAT@biblabel.
8595 %
8596 % Per Karie Friedman ([email protected]), multiple citations are separated by semicolons, e.g.,
8597 % (Jones, 1999; Abbott and Smith, 2000; Wortley, 2001a),
8598 % and
8599 % multiple citations by the same author by commas, e.g.,
8600 % Abela et al. (1995, 1997a, 1997b).
8601 % The third argument of \cmd\bibpunct\ handles the former.
8602 %
8603 % The fifth argument puts a comma after the author when the year is not in parens:
8604 % (Lee et al., 1996).
8605 %
8606 % \begin{macrocode}
8607 \bibpunct{(}{)}{;}{a}{,}{,}%
8608 % \end{macrocode}
8609 % \end{macro}
8610 %
8611 % \begin{macro}{\cite}
8612 % Per Mark Doyle, \cmd\cite\ is mapped to \cmd\citep\ in RMP.
8613 %
8614 % \begin{macrocode}
8615 \let\cite\citep
8616 % \end{macrocode}
8617 % \end{macro}
8618 %
8619 % \begin{macro}{\bibsection}
8620 % \begin{macro}{\bibpreamble}
8621 % \begin{macro}{\newblock}
8622 % \begin{macro}{\bibhang}
8623 % \begin{macro}{\bibsep}
8624 % We define the sectioning command to use when starting the bibliography.
8625 %
8626 % \begin{macrocode}
8627 \def\bibsection{%
8628 \let\@hangfroms@section\@hang@froms
8629 \section*{\refname}%
8630 \@nobreaktrue
8631 }%
8632 \let\bibpreamble\@empty
8633 \def\newblock{\ }%
8634 \bibhang10\p@
8635 \bibsep\z@
8636 % \end{macrocode}
8637 % \end{macro}
8638 % \end{macro}
8639 % \end{macro}
8640 % \end{macro}
8641 % \end{macro}
8642 %
8643 % \begin{macro}{\footinbib@sw}
8644 % Footnotes in bibliography are inconsistent with author-year
8645 % references, and are particularly nast under \classname{natbib}:
8646 % the packcage will automatically change to numbered references if
8647 % any \cmd\bibitem\ commands lack the optional argument.
8648 % Therefore, we must uninvoke it now, even if invoked by the document.
8649 % \begin{macrocode}
8650 \@ifxundefined\footinbib@sw{}{%
8651 \footinbib@sw{%
8652 \class@warn{%
8653 Footnotes in bibliography are incompatible with RMP.^^J%
8654 Undoing the footinbib option.
8655 }%
8656 }{}%
8657 }%
8658 \@booleanfalse\footinbib@sw
8659 % \end{macrocode}
8660 % \end{macro}
8661 %
8662 % \begin{macro}{\eprint}
8663 % RMP requires the \cmd\eprint\ field in the bib entry to be set off with the word ``eprint''.
8664 % \begin{macrocode}
8665 \def\eprint#1{eprint #1}%
8666 % \end{macrocode}
8667 % \end{macro}
8668 %
8669 % \subsection{Table of Contents}
8670 %
8671 % We set up for auto-sizing of certain TOC elements.
8672 %
8673 % To do this, we override certain definitions for
8674 % the default TOC font (\cmd\toc@@font) and spacing (\@dotsep),
8675 % and define
8676 % formatting for the needed elements (\cmd\l@\dots).
8677 % Finally, we activate the autosizing by
8678 % assigning \cmd\toc@pre\ and \cmd\toc@post.
8679 %
8680 % \begin{macro}{\toc@@font}
8681 % Set the formatting characteristics of the auto-indenting part
8682 % of the TOC.
8683 % \begin{macrocode}
8684 \def\toc@@font{%
8685 \footnotesize\rmfamily
8686 \def\\{\space\ignorespaces}%
8687 }%
8688 \def\@dotsep{5.5pt}%
8689 % \end{macrocode}
8690 % \end{macro}
8691 %
8692 % \begin{macro}{\l@section}
8693 % Determine which TOC elements are automatically indented.
8694 % \begin{macrocode}
8695 \def\tocleft@{\z@}%
8696 \def\tocdim@min{5\p@}%
8697 \def\l@section{%
8698 \l@@sections{}{section}% Implicit #3#4
8699 }%
8700 \def\l@subsection{%
8701 \l@@sections{section}{subsection}% Implicit #3#4
8702 }%
8703 \def\l@subsubsection{%
8704 \l@@sections{subsection}{subsubsection}% Implicit #3#4
8705 }%
8706 %\def\l@subsubsection#1#2{}%
8707 \def\l@paragraph#1#2{}%
8708 \def\l@subparagraph#1#2{}%
8709 % \end{macrocode}
8710 % \end{macro}
8711 %
8712 % Activate the TOC processing.
8713 % \begin{macrocode}
8714 \let\toc@pre\toc@pre@auto
8715 \let\toc@post\toc@post@auto
8716 % \end{macrocode}
8717 %
8718 %
8719 % \begin{macrocode}
8720 %</rmp>
8721 % \end{macrocode}
8722 %
8723 %
8724 % \Finale
8725 % %Here ends the programmer's documentation.
8726 % \endinput
8727 %
8728 \endinput