Debian Codegraph @

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

raw
1 \def\fileversion{v2.25} \def\filedate{2005/03/25}
2 % \iffalse % this is a METACOMMENT !
3 %% Package and Class "uiucthesis" for use with LaTeX2e.
4 %
5 %<class|package>\NeedsTeXFormat{LaTeX2e}
6 %<class>\ProvidesClass{uiucthesis}
7 %<package>\ProvidesPackage{uiucthesis}
8 %<class|package> [\filedate\ \fileversion\ UIUC Thesis (PJC)]
9 %
10 %<*driver>
11 \documentclass{ltxdoc}
12 \begin{document}
13 \title{The \textsf{uiucthesis} class
14 \thanks{This file has version number \fileversion,
15 last revised \filedate.}}
16 \author{Peter Czoschke\\[email protected]\\ (Adapted from version by David Hull)}
17 \date{\filedate}
18 \maketitle
19 \DocInput{uiucthesis.dtx}
20 \end{document}
21 %</driver>
22 % \fi
23 %
24 % \CheckSum{1143}
25 %
26 % \MakeShortVerb{\|}
27 %
28 % \def\pkg#1{\textsf{#1}}
29 % \def\env#1{\textsf{#1}}
30 %
31 % \iffalse
32 %<*example>
33 % \fi
34 % \begin{abstract}
35 % Load the \pkg{uiucthesis} class for use with \LaTeX2e
36 % to produce a document that conforms
37 % to the format described in
38 % \emph{Handbook for Graduate Students Preparing to Deposit}\cite{Handbook}.
39 % \end{abstract}
40 %
41 % \section{The User Interface}
42 %
43 % This section describes how to use the \pkg{uiucthesis} class to
44 % produce a thesis satisfying the format requirements of the
45 % Grad College at UIUC.
46 % I assume that you are familiar with \LaTeX, and highly
47 % recommend that anyone attempting to use \LaTeX\ to produce a
48 % thesis have access to a copy of the \LaTeX\ book\cite{Lamport}.
49 %
50 % \subsection{Using \pkg{uiucthesis}}
51 %
52 % To write a thesis, you load the UIUC thesis definitions
53 % by loading the \pkg{uiucthesis} class at the beginning of
54 % your \LaTeX\ document with the |\documentclass| command.
55 % For example,
56 % \begin{quote} \hrule \begin{verbatim}
57 \documentclass[draftthesis,fullpage]{uiucthesis}
58 % \end{verbatim} \hrule \end{quote}
59 % \iffalse
60 %<example>
61 % \fi
62 %
63 % \DescribeMacro{[draftthesis]}
64 % \DescribeMacro{[fancy]}
65 % \DescribeMacro{[fullpage]}
66 % The \pkg{uiucthesis} class provides a number of options.
67 % The |[draftthesis]| option causes each page to have a header
68 % proclaiming the document to be a draft copy, along with the
69 % current time and date.
70 % It also omits the copyright page and prints out any marginal notes
71 % added with the |\note| macro.
72 % The |[fancy]| style option produces slightly fancier chapter headings.
73 % The |[fullpage]| style option makes the margins as small as the
74 % format requirements allow and uses double-spacing for the text.
75 % Because wide text columns are generally
76 % considered harder on the reader
77 % this is not the default, but is provided as an option because people
78 % seem to want it.
79 % The |[fancy]| and |[fullpage]| options are incompatible---choose
80 % one or the other.
81 %
82 % \DescribeMacro{[proquest]}
83 % The |[proquest]| option is meant to be used when you are ready to deposit your thesis.
84 % For doctorates, the Grad College requires the submission of a specially
85 % formatted abstract for the ProQuest publication service. To produce this
86 % abstract, include the |[proquest]| option and reprocess your file. Everything
87 % in your \LaTeX\ document will be ignored except the contents of the \env{abstract}
88 % environment, which are printed out in the format required. Once the option is
89 % removed from the |\documentclass| command, you can reprocess your thesis as
90 % normal (the auxiliary files should be intact). To use this option, the name
91 % of your thesis advisor needs to be specified with the |\advisor| command (see
92 % below).
93 %
94 % \DescribeMacro{[edeposit]}
95 % Use the |[edeposit]| option if you are depositing your thesis electronically. The title page
96 % is different and the page numbering is slightly different since the committee
97 % approval form is not included with your thesis. If this option is used, you
98 % must specify your committee members with the |\committee| command (see below).
99 %
100 % \DescribeMacro{[offcenter]}
101 % The |[offcenter]| option adds 1/2 inch to the left margin of all pages.
102 % This can be done to allow some extra space there for binding purposes, or
103 % if you use the |[fancy]| option, to allow for more space for the chapter
104 % numbers at the left side of the page.
105 % In past versions of \pkg{uiucthesis}, the |[fancy]| option did this by default.
106 % This version uses symmetric margins by default, even with the
107 % |[fancy]| option. If you have a lot of chapters (i.e., more than 9), your chapter
108 % numbers may spill into
109 % the 1 inch margin required by the Grad College without using this option.
110 % This option should not be used with the |[fullpage]| option.
111 %
112 % \DescribeMacro{[centerchapter]}
113 % Normally, the chapter headings are all left-justified on the opening page of
114 % each chapter. These headings can all be centered by using the |[centerchapter]|
115 % option for the class. This option is not recommended for use with the |[fancy]|
116 % option.
117 %
118 % \subsection{The Title Page}
119 %
120 % The |\maketitle| command is redefined so that it creates a
121 % title page with the correct format for a thesis at UIUC.
122 %
123 % \DescribeMacro{\phdthesis}
124 % \DescribeMacro{\otherdoctorate}
125 % \DescribeMacro{\msthesis}
126 % \DescribeMacro{\othermasters}
127 % \DescribeMacro{\department}
128 % \DescribeMacro{\college}
129 % Use the |\phdthesis| or |\msthesis| to set the correct thesis type.
130 % If your thesis isn't for a ``Ph.D.'' or ``M.S.'', you can specify
131 % your degree with either\\
132 % |\otherdoctorate{|\meta{degree name}|}{|\meta{abbreviation}|}| or\\
133 % |\othermasters{|\meta{degree name}|}{|\meta{abbreviation}|}|.\\
134 % For example, specifying |\phdthesis| is equivalent to giving the command\\
135 % |\otherdoctorate{Doctor of Philosophy}{Ph.D.}|.\\
136 % The default thesis type is |\phdthesis|. Set your department with\linebreak
137 % |\department{|\meta{department}|}|. This defines the field your degree
138 % will be in, so leave out ``Department of.''
139 % The default department is ``Computer Science''.
140 % Define your college with |\college{|\meta{college}|}|.
141 % The default is college is ``Graduate College'';
142 % you shouldn't need to change it.
143 %
144 % \DescribeMacro{\schools}
145 % Use |\schools{|\meta{school list}|}| to list the previous degrees
146 % you have received and the schools that you received them from.
147 % Separate multiple degrees with |\\|.
148 %
149 % \DescribeMacro{\degreeyear}
150 % Use |\degreeyear{|\meta{year}|}| to define the year in which
151 % you will receive your degree. The default is the current year.
152 %
153 % \DescribeMacro{\advisor}
154 % \DescribeMacro{\adviser}
155 % Use |\advisor{|\meta{advisor name}|}| or |\adviser{|\meta{advisor name}|}|
156 % to specify the name of your
157 % advisor. This is needed to produce the ProQuest abstract
158 % (see the |[proquest]| option above). You only need to submit a
159 % ProQuest abstract if you are a doctoral candidate.
160 %
161 % \DescribeMacro{\committee}
162 % Use |\committee{|\meta{committee members}|}| to specify the members
163 % of your committee and their titles as you want them to appear on the
164 % title page. Separate members with |\\|. This is only needed for
165 % electronically deposited theses.
166 %
167 % \DescribeMacro{\volume}
168 % The |\volume| macro provides nominal support for very long theses that must
169 % be broken up into multiple volumes. Use |\volume{|\meta{number}|}|
170 % to specify the volume number (a single arabic numeral). All this macro
171 % does is place the word VOLUME with the number you specify on the title
172 % page. You have to take care of what appears in each volume. The easiest
173 % way to do this is to create two separate source files, one for each
174 % volume.
175 %
176 % Here's how to produce an example similar to that in \cite{Handbook}.
177 % \begin{quote} \hrule \begin{verbatim}
178 \begin{document}
179
180 \title{Coffee Consumption of Graduate Students \\
181 Trying to Finish Dissertations}
182 \author{Juan Valdez}
183 \department{Food Science}
184 \schools{B.A., University of Columbia, 1981\\
185 A.M., University of Illinois at Urbana-Champaign, 1986}
186 \phdthesis
187 \advisor{Java Jack}
188 \degreeyear{1994}
189 \maketitle
190 % \end{verbatim} \hrule \end{quote}
191 % \iffalse
192 %<example>
193 % \fi
194 %
195 % \subsection{Front Matter}
196 %
197 % \DescribeMacro{\frontmatter}
198 % Typically, a thesis might have an Abstract, a Dedication, some
199 % Acknowledgments, and a Preface before the Table of Contents.
200 % Use the |\frontmatter| command to start this preliminary section
201 % of the thesis.
202 % The |\frontmatter| command sets the page number of the next page
203 % to roman numeral iii (or ii if the |[edeposit]| option is used).
204 % (The title page is page i, and the certificate
205 % of committee approval, the ``red-bordered form,'' is page ii.)
206 %
207 % \DescribeEnv{abstract}
208 % The abstract should appear in the \env{abstract} environment. Normally,
209 % this just produces another chapter with |\chapter*{\abstractname}|,
210 % where |\abstractname| is ``Abstract'' (see User Customization below),
211 % but if the |[proquest]| option
212 % is specified, then the contents of this environment are used
213 % for the ProQuest abstract.
214 %
215 % \DescribeEnv{dedication}
216 % A dedication page can be printed with the \env{dedication} environment.
217 % This produces a separate page with the dedication centered horizontally
218 % and vertically, with the text in italics.
219 %
220 % After this front matter comes the Table of Contents,
221 % List of Tables, List of Figures, etc. Use the standard \LaTeX\
222 % commands |\tableofcontents|, |\listoftables|, |\listoffigures|, etc.,
223 % to generate them.
224 % In the \pkg{uiucthesis} format these lists are all single spaced.
225 %
226 % \DescribeEnv{symbollist}
227 % \DescribeEnv{symbollist*}
228 % Optionally, these tables can be followed by a List of Abbreviations and/or
229 % List of Symbols. Introduce these with the |\chapter| command. To aid in
230 % making these lists, the \env{symbollist} and \env{symbollist*} environments are
231 % defined in \pkg{uiucthesis}. These environments produce a two-column list
232 % as illustrated below. By default the left column is 1 inch wide but can
233 % be specified with an optional argument. In the starred environment, the left
234 % column is left-justified, otherwise it is centered. See the example below.
235 %
236 % Here's an example of what the front matter of a typical
237 % thesis looks like. First comes the Abstract and the Dedication, both of
238 % which are optional.
239 % \begin{quote} \hrule \begin{verbatim}
240 \frontmatter
241
242 %% Create an abstract that can also be used for the ProQuest abstract.
243 %% Note that ProQuest truncates their abstracts at 350 words.
244 \begin{abstract}
245 This is a comprehensive study of caffeine consumption by graduate
246 students at the University of Illinois who are in the very final
247 stages of completing their doctoral degrees. A study group of six
248 hundred doctoral students\ldots.
249 \end{abstract}
250
251 %% Create a dedication in italics with no heading, centered vertically
252 %% on the page.
253 \begin{dedication}
254 To Father and Mother.
255 \end{dedication}
256
257 %% Create an Acknowledgements page, many departments require you to
258 %% include funding support in this.
259 \chapter*{Acknowledgments}
260
261 This project would not have been possible without the support of
262 many people. Many thanks to my adviser, Lawrence T. Strongarm, who
263 read my numerous revisions and helped make some sense of the
264 confusion. Also thanks to my committee members, Reginald Bottoms,
265 Karin Vegas, and Cindy Willy, who offered guidance and support.
266 Thanks to the University of Illinois Graduate College for awarding
267 me a Dissertation Completion Fellowship, providing me with the
268 financial means to complete this project. And finally, thanks to
269 my husband, parents, and numerous friends who endured this long
270 process with me, always offering support and love.
271
272 %% The thesis format requires the Table of Contents to come
273 %% before any other major sections, all of these sections after
274 %% the Table of Contents must be listed therein (i.e., use \chapter,
275 %% not \chapter*). Common sections to have between the Table of
276 %% Contents and the main text are:
277 %%
278 %% List of Tables
279 %% List of Figures
280 %% List Symbols and/or Abbreviations
281 %% etc.
282
283 \tableofcontents
284 \listoftables
285 \listoffigures
286 % \iffalse
287 %<example>
288 % \fi
289 % \end{verbatim} \hrule \end{quote}
290 %
291 % If you want a List of Symbols or Abbreviations, you can do so as follows:
292 % \begin{quote} \hrule \begin{verbatim}
293 %% Create a List of Abbreviations. The left column
294 %% is 1 inch wide and left-justified
295 \chapter{List of Abbreviations}
296
297 \begin{symbollist*}
298 \item[CA] Caffeine Addict.
299 \item[CD] Coffee Drinker.
300 \end{symbollist*}
301
302 %% Create a List of Symbols. The left column
303 %% is 0.7 inch wide and centered
304 \chapter{List of Symbols}
305
306 \begin{symbollist}[0.7in]
307 \item[$\tau$] Time taken to drink one cup of coffee.
308 \item[$\mu$g] Micrograms (of caffeine, generally).
309 \end{symbollist}
310 % \end{verbatim} \hrule \end{quote}
311 % \iffalse
312 %<example>
313 % \fi
314 %
315 % \subsection{Main Matter}
316 %
317 % \DescribeMacro{\mainmatter}
318 % Begin the main body of your thesis with the |\mainmatter| command.
319 % It resets the page number to arabic numeral 1.
320 % You can now use any of the commands defined by the
321 % the book document class to write your thesis.
322 %
323 % In the following example, each of the chapters
324 % has been broken out into separate files that are inserted into
325 % this main file with the |\include| command. This allows the
326 % thesis to be proofed quickly while it is being revised with
327 % the |\includeonly| command. To provide an example of what the
328 % chapter headings look like, one chapter has been explicitly
329 % coded. (Try recompiling the example file with the |[fancy]|
330 % option instead of |[fullpage]| to see the effect.)
331 %
332 % \begin{quote} \hrule \begin{verbatim}
333 \mainmatter
334
335 \include{1-introduction}
336 \include{2-related}
337 \include{3-model}
338 \include{4-predictions}
339
340 \chapter{Conclusions}
341
342 We conclude that graduate students like coffee.
343 % \iffalse
344 %<example>
345 % \fi
346 % \end{verbatim} \hrule \end{quote}
347 %
348 % \subsection{Reference Matter}
349 %
350 % \DescribeMacro{\appendix}
351 % To switch from the body of your thesis to the reference material
352 % at the end, you should use the standard \LaTeX\ |\appendix| command.
353 % In \pkg{uiucthesis}, there is also a starred version of this command
354 % that eliminates the lettering of the appendices (use if you have
355 % a single appendix). Note that if you use |\appendix*| along with
356 % the |[fancy]| option, you may want to put ``Appendix:'' at
357 % the beginning of the chapter title.
358 %
359 %
360 % \begin{quote} \hrule \begin{verbatim}
361 \appendix*
362
363 \include{Appendix.tex}
364 % \end{verbatim} \hrule \end{quote}
365 % \iffalse
366 %<example>
367 % \fi
368 %
369 % \subsection{Back Matter}
370 %
371 % \DescribeMacro{\backmatter}
372 % The last few chapters in your thesis should not have chapter
373 % numbers, but should be listed in the Table of Contents.
374 % These chapters include the Bibliography, the Index,
375 % and the Vita. \LaTeX's |\backmatter| command accomplishes this.
376 %
377 % \DescribeMacro{\bibliography}
378 % Use the standard \LaTeX\ bibliography commands to
379 % create your bibliography. Most people will use Bib\TeX\ to do this.
380 % (See \cite{Lamport}). For those in the sciences, you may want to
381 % check out the \pkg{cite} package (it's pretty standard), which
382 % will produce numerical citations that are sorted and compressed.
383 % You can also use the \pkg{natbib} package. Both of these packages
384 % can do either bracketed citations or superscript citations.
385 %
386 % \DescribeMacro{\vita}
387 % The |\vita| command begins a new chapter for your vita.
388 % In fact, it does exactly the same thing as |\chapter{\vitaname}|,
389 % where |\vitaname| is ``Vita.''
390 %
391 % \begin{quote} \hrule \begin{verbatim}
392 \backmatter
393
394 \bibliography{thesisbib}
395
396 \chapter{Vita}
397
398 Juan Valdez was born\ldots.
399
400 \end{document}
401 % \end{verbatim} \hrule \end{quote}
402 %
403 % \iffalse
404 %</example>
405 % \fi
406 %
407 % \section{User Customization}
408 %
409 % \DescribeMacro{\draftheader}
410 % If you don't like the header that the the |[draftthesis]| option
411 % creates, you can redefine the |\draftheader| command so that it
412 % produces whatever text you want.
413 %
414 % \DescribeMacro{\thesisspacing}
415 % The \pkg{uiucthesis} class loads \pkg{setspace} for the
416 % line spacing commands. See the documentation in that package
417 % for more information on the commands it provides.
418 % By default, \pkg{uiucthesis} uses one and a half line spacing,
419 % or double spacing if the |[fullpage]| option is specified.
420 % If you're unhappy with that, you can override it by redefining the
421 % |\thesisspacing| command.
422 %
423 % \DescribeMacro{\nocopyrightpage}
424 % Unless the |[draftthesis]| option is used, a page with the copyright notice
425 % is printed before the title page. If you don't want this page to
426 % appear, even in the final version, put the |\nocopyrightpage| macro
427 % somewhere in the preamble.
428 %
429 % \DescribeMacro{\toclabels}
430 % Some departments require the Table of Contents, List of Tables and
431 % List of Figures to have a ``Page'' heading over the page numbers
432 % on the first page. This can be accomplished by putting the |\toclabels|
433 % command somewhere before the |\tableofcontents| command. (NOTE: if you put
434 % the |\tableofcontents| command in a separate file that you |\include| in
435 % the main file, the |\toclabels| command must also be in that file.)
436 %
437 % \DescribeMacro{\chaptertitlefont}
438 % \DescribeMacro{\sectiontitlefont}
439 % \DescribeMacro{\subsectiontitlefont}
440 % \DescribeMacro{\subsubsectiontitlefont}
441 % These macros contain the font declarations for the corresponding sectioning
442 % levels and can be redefined to suit your aesthetic desires. Use
443 % |\renewcommand| to do this in the preamble.
444 %
445 % \DescribeMacro{\chapternumberfont}
446 % The |\chapternumberfont| macro is really most applicable when the |[fancy]| option is used. It
447 % specifies the font declaration used for the chapter number set in the left
448 % margin next to the title. Otherwise it specifies the font used to print
449 % the words ``Chapter \#'' at the top of each chapter's opening page. Use
450 % |\renewcommand| to redefine this macro in the preamble.
451 %
452 % \DescribeMacro{\chaptertitleheight}
453 % |\chaptertitleheight| is the amount of space allotted for the chapter title at the top
454 % of the page. You can redefine it using |\setlength| in the preamble.
455 %
456 % \DescribeMacro{\bibname}
457 % |\bibname| is a standard \LaTeX\ macro that contains the title of the reference
458 % section at the end of your thesis; ``References'' by default. Use
459 % |\renewcommand| to redefine it in the preamble.
460 %
461 % \DescribeMacro{\vitaname}
462 % Like |\bibname| but it contains the name used for your vita at the very end.
463 % The Grad College allows ``Vita'', ``Author's Biography'', or ``Curriculum Vitae'',
464 % each of which is slightly different in format. See \cite{Handbook}.
465 %
466 % \DescribeMacro{\abstractname}
467 % Like above, but for the abstract. By default, ``Abstract''.
468 %
469 % \DescribeMacro{other "name"s}
470 % Similarly, the titles for the Table of Contents, List of Figures, and List of Tables
471 % are stored in the macros |\contentsname|, |\listfigurename|, and |\listtablename|,
472 % respectively. Their default values are the names in the previous sentence. There are
473 % also the macros |\chaptername|, |\appendixname|, |\indexname|, |\partname|,
474 % |\tablename|, and |\figurename| that contain the appellations for chapter and appendix
475 % headings (not applicable with the |[fancy]| option), the index, parts, tables, and figures.
476 % Their default values are Chapter, Appendix, Index, Part, Table, and Figure, respectively.
477 % All of these macros can
478 % be redefined in the preamble with |\renewcommand|. These macros are all part of
479 % the standard \LaTeX\ formalism, they are just included here for the reader's convenience.
480 % For example, some departments require chapter headings to be in all caps, which can
481 % be done by changing the |\chaptername| macro to be CHAPTER.
482 %
483 % \DescribeMacro{\note}
484 % This command inserts a marginal note just like |\marginpar| with two distinctions:
485 % First, the note is single-spaced in a smaller type for compactness.
486 % Second, it is only printed when
487 % the |[draftthesis]| option is used. Since marginal notes are not allowed in the final
488 % draft, the |\note| command is recommended over the |\marginpar| command.
489 %
490 % \section{Backwards Compatibility}
491 %
492 % Compatibility with previous versions of \pkg{uiucthesis} are supported. Previously it
493 % was implemented as a package rather than a class, in which case you opened the document
494 % with:
495 % \begin{quote} \hrule \begin{verbatim}
496 % \documentclass[oneside,...]{book}
497 % \usepackage[...]{uiucthesis}
498 % \end{verbatim} \hrule \end{quote}
499 % To provide backwards-compatibility, a style file is provided that has the same functionality
500 % of the class file described herein. Similarly, (really) old versions of \pkg{uiucthesis}
501 % used the \env{preliminary} and \env{thesis} environments, which are now deprecated
502 % but backwards-compatibility support is still provided.
503 %
504 % \section{Other Issues}
505 %
506 % \subsection{Paper Size and PDF Files}
507 %
508 % The default paper size for most \LaTeX\ distributions is A4, which is slightly different
509 % the 8.5 x 11 size for letter paper in the U.S\@. The Graduate College requires theses
510 % to be letter paper size. In addition, many departments want soft copies of the thesis
511 % in PDF format. Unfortunately, the program used to convert the dvi file to PDF format
512 % (|dvipdfm| on my computer, which is a Windows machine with Mik\TeX installed on it)
513 % often produces PDF files in A4 format, even if |letterpaper|
514 % is specifically specified in the your \TeX source file. If you're having this problem,
515 % either run the PDF conversion utility from the command line with the right flag ---
516 % for example, |dvipdfm -p letter| on my computer --- or change the default paper size in
517 % the config file for your PDF conversion utility, which will then fix this problem
518 % permanently. On my computer, this can be done by going to the |dvipdfm\config|
519 % subdirectory off of the main \TeX installation directory (usually |C:\texmf|). In this
520 % directory is a file called |config| that has a line for the default paper size.
521 %
522 % \subsection{Reference Lists at the Chapter Level}
523 %
524 % The \pkg{cite} package includes a style file \pkg{chapterbib.sty} that can be used
525 % to do a list of references for each chapter instead of just one big list at the
526 % end of the thesis. I've not used this style before so you're on your own if you
527 % want to do this, but I think it is rather straightforward\ldots.
528 %
529 % \StopEventually{%
530 % \begin{thebibliography}{9}
531 % \bibitem{Handbook}
532 % \emph{Handbook for Graduate Students Preparing to Deposit}.
533 % \newblock Graduate College, University of Illinois at
534 % Urbana-Champaign, 2004
535 %
536 % \bibitem{Lamport}
537 % Leslie Lamport.
538 % \newblock \emph{\LaTeX: A Document Preparation System}.
539 % \newblock Addison-Wesley, 1994.
540 % \end{thebibliography}
541 % }
542 %
543 % \section{Implementation}
544 %
545 % This section shows the implementation of the \pkg{uiucthesis} class.
546 % Unless you are interested in the details of how \pkg{uiucthesis} works,
547 % you probably don't need to read it.
548 %
549 % \iffalse
550 %<*class|package>
551 \RequirePackage{setspace}
552 % \fi
553 %
554 % \subsection{Compatibility}
555 %
556 % Provide compatibililty with older versions of \LaTeX.
557 % \begin{macro}{\@ifundefined}
558 % \begin{macrocode}
559 \expandafter\ifx\csname @ifundefined\endcsname\relax
560 \def\@ifundefined#1{%
561 \expandafter\ifx\csname#1\endcsname\relax
562 \expandafter\@firstoftwo
563 \else
564 \expandafter\@secondoftwo
565 \fi}
566 \fi
567 % \end{macrocode}
568 % \end{macro}
569 %
570 % \begin{macro}{\MakeUppercase}
571 % \begin{macrocode}
572 \@ifundefined{MakeUppercase}{\let\MakeUppercase=\uppercase}{}
573 % \end{macrocode}
574 % \end{macro}
575 %
576 % \subsection{Option Processing}
577 %
578 % \begin{macrocode}
579 \newif\if@thesisdraft \@thesisdraftfalse
580 \newif\if@thesisfancy \@thesisfancyfalse
581 \newif\if@fullpage \@fullpagefalse
582 \newif\if@largecaps \@largecapsfalse
583 \newif\if@proquest \@proquestfalse
584 \newif\if@edeposit \@edepositfalse
585 \newif\if@thesisoffcenter \@thesisoffcenterfalse
586 \newif\if@centerchapter \@centerchapterfalse
587 % \end{macrocode}
588 %
589 % \begin{macrocode}
590 \DeclareOption{draftthesis}{\@thesisdrafttrue}
591 \DeclareOption{fancy}{\@thesisfancytrue}
592 \DeclareOption{fullpage}{\@fullpagetrue}
593 \DeclareOption{proquest}{\@proquesttrue}
594 \DeclareOption{toclabels}{\AtBeginDocument{\toclabels}}
595 \DeclareOption{edeposit}{\@edeposittrue}
596 \DeclareOption{offcenter}{\@thesisoffcentertrue}
597 \DeclareOption{centerchapter}{\@centerchaptertrue}
598 % \end{macrocode}
599 %
600 % The |[largecaps]| option causes the title and author's name to
601 % be use a ``large caps'' font on the title page. Otherwise,
602 % \pkg{uiucthesis} just converts them to uppercase and uses the
603 % normal fonts. The difference is that the spacing between the
604 % characters in the large caps font is tuned for setting type in all caps.
605 %
606 % The large caps font is \emph{not a standard font}, and so it will not exist
607 % unless you have installed it.
608 %
609 % \begin{macrocode}
610 \DeclareOption{largecaps}{\@largecapstrue}
611 % \end{macrocode}
612 %
613 % Load the \pkg{book} class with the |[oneside]| and |[letterpaper]| options
614 %
615 % \begin{macrocode}
616 %<class>\DeclareOption*{\PassOptionsToClass{\CurrentOption}{book}}
617 %<class>\PassOptionsToClass{letterpaper,oneside}{book}
618 \ProcessOptions
619 %<class>\LoadClass{book}
620 % \end{macrocode}
621 %
622 % If the |[proquest]| option is used, turn off output to auxiliary files so
623 % that the thesis doesn't have to be recompiled again to get all the references
624 % correct. Also double-space the ProQuest abstract and use the full page.
625 %
626 % \begin{macrocode}
627 \if@proquest
628 \nofiles % don't overwrite the .aux files
629 \def\makeindex{}
630 \@thesisfancyfalse
631 \@fullpagetrue
632 \fi
633 % \end{macrocode}
634 %
635 % If the |[draftthesis]| option was specified, define the |\draftheader| macro.
636 %
637 % \begin{macrocode}
638 \if@thesisdraft
639 \newcount\timehh\newcount\timemm
640 \timehh=\time \divide\timehh by 60
641 \timemm=\time \count255=\timehh \multiply\count255 by -60
642 \advance\timemm by \count255
643 \def\draftheader{\slshape Draft of \today\ at
644 \ifnum\timehh<10 0\fi\number\timehh\,:\,\ifnum\timemm<10 0\fi\number\timemm}%
645 \fi
646 % \end{macrocode}
647 %
648 % Define the |\toclabels| command which prints the headings in the Table of Contents,
649 % List of Figures and List of Tables.
650 %
651 % \begin{macrocode}
652 \newcommand{\toclabels}{%
653 \addtocontents{toc}{\vspace*{-\baselineskip}\hfill Page\endgraf}%
654 \addtocontents{lof}{\vspace*{-\baselineskip}~Figure\hfill Page\endgraf}%
655 \addtocontents{lot}{\vspace*{-\baselineskip}~Table\hfill Page\endgraf}}
656 % \end{macrocode}
657 %
658 % \subsection{Title Page}
659 %
660 % \begin{macro}{\title}
661 % \begin{macro}{\author}
662 % Override the standard definitions of |\title| and |\author| to also
663 % define uppercased versions.
664 % \begin{macrocode}
665 \def\@mkuptitle#1{\gdef\@Utitle{#1}}
666 \def\title#1{\gdef\@title{#1}\MakeUppercase{\protect\@mkuptitle{#1}}}
667 \def\@mkupauthor#1{\gdef\@Uauthor{#1}}
668 \def\author#1{\gdef\@author{#1}\MakeUppercase{\protect\@mkupauthor{#1}}}
669 % \end{macrocode}
670 % \end{macro}
671 % \end{macro}
672 %
673 % \begin{macro}{\phdthesis}
674 % \begin{macro}{\msthesis}
675 % \begin{macro}{\otherdoctorate}
676 % \begin{macro}{\othermasters}
677 % \begin{macro}{\department}
678 % \begin{macro}{\college}
679 % \begin{macro}{\schools}
680 % \begin{macro}{\degreeyear}
681 % \begin{macro}{\committee}
682 % \begin{macro}{\volume}
683 % Macros to set title page elements.
684 % \begin{macrocode}
685 \def\phdthesis{\def\@degree{Doctor of Philosophy}
686 \def\degree{Ph.D.}
687 \def\@thesisname{DISSERTATION}
688 }
689 \def\msthesis{\def\@degree{Master of Science}
690 \def\degree{M.S.}
691 \def\@thesisname{THESIS}
692 }
693 \newcommand{\otherdoctorate}[2]{\def\@degree{#1}
694 \def\degree{#2}
695 \def\@thesisname{DISSERTATION}
696 }
697 \newcommand{\othermasters}[2]{\def\@degree{#1}
698 \def\degree{#2}
699 \def\@thesisname{THESIS}
700 }
701 \def\department#1{\def\@dept{#1}}
702 \def\college#1{\def\@college{#1}}
703 \def\schools#1{\def\@schools{#1}}
704 \def\degreeyear#1{\def\@degreeyear{#1}}
705 \newcommand{\committee}[1]{\gdef\@committee{#1}}
706 \newcommand*{\volume}[1]{\gdef\thesis@volume{VOLUME~#1}}
707 \newcommand*{\thesis@volume}{}
708 \if@edeposit
709 \gdef\@committee{%
710 %<class> \ClassError{uiucthesis}{A committee must be specified for e-deposit dissertations.}%
711 %<package> \PackageError{uiucthesis}{A committee must be specified for e-deposit dissertations.}%
712 {Use \protect\committee\space with members separated by \protect\\'s.}}
713 \fi
714 % \end{macrocode}
715 % \end{macro}
716 % \end{macro}
717 % \end{macro}
718 % \end{macro}
719 % \end{macro}
720 % \end{macro}
721 % \end{macro}
722 % \end{macro}
723 % \end{macro}
724 % \end{macro}
725 %
726 % \begin{macro}{\copyrightnotice}
727 % Define the copyright notice as a macro so that the user
728 % can change it if desired.
729 % \begin{macrocode}
730 \def\copyrightnotice{\copyright~\@degreeyear~by \@author. All rights reserved.}
731 % \end{macrocode}
732 % \end{macro}
733 % \begin{macro}{\nocopyrightpage}
734 % The printing of the copyright page can also be turned off with the
735 % |\nocopyrightpage| command (must come before |\maketitle|):
736 % \begin{macrocode}
737 \newif\if@thesiscrpage \@thesiscrpagetrue
738 \let\nocopyrightpage\@thesiscrpagefalse
739 \if@thesisdraft\nocopyrightpage\fi
740 % \end{macrocode}
741 % \end{macro}
742 %
743 % Set the default title page elements.
744 % \begin{macrocode}
745 \phdthesis
746 \department{Computer Science}
747 \college{Graduate College}
748 \def\@schools{}
749 \def\@degreeyear{\number\year}
750 % \end{macrocode}
751 %
752 %
753 % \begin{macro}{\maketitle}
754 % Redefine \pkg{book}'s |\maketitle| command to produce
755 % the titlepage in the correct format.
756 %
757 % \begin{macrocode}
758 \renewcommand\maketitle{
759 % \end{macrocode}
760 % Print the copyright page if we're supposed to.
761 % \begin{macrocode}
762 \if@thesiscrpage
763 \newpage
764 \thispagestyle{empty}
765 \null\vfill
766 \centerline{\copyrightnotice}%
767 \vskip 3ex % skip to visually center copyright notice
768 \vfill
769 \fi
770 % \end{macrocode}
771 % Now start a new page for the title page. It is single-spaced.
772 % \begin{macrocode}
773 \newpage
774 \thispagestyle{empty}%
775 \enlargethispage{1in}%
776 \begingroup
777 \def\baselinestretch{1}
778 % \end{macrocode}
779 % Check what size font we are using for the text and select a
780 % smaller size appropriately.
781 % \begin{macrocode}
782 \ifnum \@ptsize=2
783 \@normalsize
784 \newcommand{\thesis@small}{\small}
785 \else
786 \large
787 \newcommand{\thesis@small}{\@normalsize}
788 \fi
789 % \end{macrocode}
790 % We have to be careful to get the vertical position right. The
791 % easiest way to do this seems to be to just set |\topmargin|,
792 % |\headheight|, and |\headsep| for this page.
793 % \begin{macrocode}
794 \headheight=0pt \headsep=0pt
795 \topmargin=0in
796 % \end{macrocode}
797 % Adjust the horizontal spacing so that the title page
798 % is centered on the page even if the rest of the document isn't.
799 % I'm not sure when |\textwidth| changes take place, so instead
800 % we calculate the correct |\oddsidemargin| to center the text column.
801 % \begin{macrocode}
802 \@tempdima=\paperwidth
803 \advance\@tempdima by -\textwidth
804 \divide\@tempdima by 2
805 \advance\@tempdima by -1in
806 \oddsidemargin=\@tempdima
807 \let\evensidemargin=\oddsidemargin
808 % \end{macrocode}
809 % Create the title page. Different spacing is used depending on whether the
810 % |[edeposit]| option is specified. Include the committee and the paragraph
811 % at the bottom of the page for e-deposit theses, as required by the Grad College.
812 % \begin{macrocode}
813 \newdimen\thesis@dim
814 \if@edeposit
815 \thesis@dim=1.25in
816 \else
817 \thesis@dim=1.75in
818 \fi
819 \if@largecaps
820 \def\lc@selectfont{\fontshape{lc}\selectfont}%
821 \else
822 \def\lc@selectfont{}%
823 \fi
824 \begin{center}
825 \if@edeposit\else
826 \vbox to 1.25in{}
827 \fi
828 \vbox to \thesis@dim{%
829 {\lc@selectfont\@Utitle}
830 \if@thesisdraft
831 \\[12pt]
832 \draftheader
833 \fi
834 \vfil}%
835 \vbox to 2in{%
836 {\lc@selectfont BY}\\[12pt]
837 {\lc@selectfont\@Uauthor}\\[12pt]
838 \begin{tabular}{c}\@schools\end{tabular}\vfil}%
839 \vbox to 0.5in{\thesis@volume\vfil}
840 \vbox to 2.5in{%
841 {\lc@selectfont \@thesisname}\\[12pt]
842 Submitted in partial fulfillment of the requirements\\
843 for the degree of \@degree\ in \@dept\\
844 in the \@college\ of the\\
845 University of Illinois at Urbana-Champaign, \@degreeyear\vfil}
846 \if@edeposit
847 \vbox to 2.1in{
848 COMMITTEE ON FINAL EXAMINATION*\\[12pt]
849 \begin{tabular}{c}\@committee\end{tabular}\vfil}
850 \hspace*{-\oddsidemargin}\parbox[t]{6.5in}{\thesis@small%
851 * The Certificate of Committee Approval is not part of dissertations
852 deposited electronically through the Graduate College of the University
853 of Illinois at Urbana-Champaign. A copy of the original Certificate of
854 Committee Approval is permanently archived with the student's record.}%
855 \else
856 \vskip -2ex
857 Urbana, Illinois
858 \fi
859 \end{center}
860 \newpage
861 \endgroup
862 }
863 % \end{macrocode}
864 % \end{macro}
865 %
866 % \subsection{Front Matter}
867 %
868 % \begin{macro}{\frontmatter}
869 % Redefine |\frontmatter| so that it sets the page number to 2 or 3, depending on whether or
870 % not the |[edeposit]| option is given.
871 % \begin{macrocode}
872 \let\thesis@frontmatter=\frontmatter
873 \def\frontmatter{%
874 \thesis@frontmatter
875 \if@edeposit
876 \setcounter{page}{2}
877 \else
878 \setcounter{page}{3}
879 \fi}
880 % \end{macrocode}
881 % \end{macro}
882 %
883 % \subsection{Table of Contents}
884 %
885 % \begin{macro}{\contentsname}
886 % Use ``Table of Contents'' instead of ``Contents''.
887 % \begin{macrocode}
888 \renewcommand\contentsname{Table of Contents}
889 % \end{macrocode}
890 % \end{macro}
891 %
892 % \begin{macro}{\l@chapter}
893 % This code is a modified version of the code in the 1996/05/26 release
894 % of classes.dtx that produces leader dots between the chapter
895 % name and the page number.
896 %
897 % This macro formats the entries in the table of contents for
898 % chapters. It is very similar to |\l@part|
899 %
900 % First we make sure that if a pagebreak should occur, it occurs
901 % \emph{before} this entry. Also a little whitespace is added and a
902 % group begun to keep changes local.
903 % \begin{macrocode}
904 \renewcommand*\l@chapter[2]{%
905 \ifnum \c@tocdepth >\m@ne
906 \addpenalty{-\@highpenalty}%
907 \vskip 1.0em \@plus 0.2em \@minus 0.2em
908 % \end{macrocode}
909 %
910 % The macro |\numberline| requires that the width of the box that
911 % holds the part number is stored in \LaTeX's scratch register
912 % |\@tempdima|. Therefore we put it there. We begin a group, and
913 % change some of the paragraph parameters. These are different
914 % from the defaults for the standard report or book class.
915 % \begin{macrocode}
916 \setlength\@tempdima{1.5em}
917 \begingroup
918 \leftskip \z@ \rightskip \@tocrmarg \parfillskip -\rightskip
919 \parindent \z@
920 % \end{macrocode}
921 % Then we leave vertical mode and switch to a bold font.
922 % \begin{macrocode}
923 \leavevmode \bfseries
924 % \end{macrocode}
925 % Because we do not use |\numberline| here, we have do some fine
926 % tuning `by hand', before we can set the entry. We discourage but
927 % not disallow a pagebreak immediately after a chapter entry.
928 % We use leaders between the chapter title and the page number,
929 % unlike the standard report or book class.
930 % \begin{macrocode}
931 \advance\leftskip\@tempdima
932 \hskip -\leftskip
933 #1\nobreak
934 \leaders\hbox{$\m@th\mkern\@dotsep mu\hbox{.}\mkern\@dotsep mu$}
935 \hfil \nobreak\hbox to\@pnumwidth{\hss #2}\par
936 \penalty\@highpenalty
937 \endgroup
938 \fi}
939 % \end{macrocode}
940 % \end{macro}
941 %
942 % \begin{macro}{\tableofcontents}
943 % We want the Table of Contents to be single-spaced, so
944 % we save the original definition, and then arrange it so
945 % that the new |\tableofcontents| calls |\singlespacing| before calling
946 % the original definition. Then set the flag mentioned above.
947 % \begin{macrocode}
948 \let\thesis@tableofcontents=\tableofcontents
949 \def\tableofcontents{{\singlespacing\thesis@tableofcontents}}
950 % \end{macrocode}
951 % \end{macro}
952 %
953 % \begin{macro}{\listoftables}
954 % \begin{macro}{\listoffigures}
955 % Similarly, redefine |\listoftables| and |\listoffigures| so
956 % that they use single spacing.
957 % \begin{macrocode}
958 \let\thesis@listoftables=\listoftables
959 \def\listoftables{\newpage%
960 \addcontentsline{toc}{chapter}{\listtablename}%
961 {\singlespacing\thesis@listoftables}}
962 \let\thesis@listoffigures=\listoffigures
963 \def\listoffigures{\newpage%
964 \addcontentsline{toc}{chapter}{\listfigurename}%
965 {\singlespacing\thesis@listoffigures}}
966 % \end{macrocode}
967 % \end{macro}
968 % \end{macro}
969 %
970 % \subsection{Other Frontmatter}
971 %
972 % \begin{environment}{abstract}
973 % The \env{abstract} environment is special because its contents are also
974 % used for the ProQuest abstract, which we need the advisor's name for:
975 % \begin{macro}{\adviser}
976 % \begin{macro}{\advisor}
977 % Two versions of this macro are provided due to the ambiguity of the spelling
978 % of the word ``adviser''.
979 % \begin{macrocode}
980 \newcommand*{\advisor}[1]{\gdef\@advisor{#1}}
981 \newcommand*{\adviser}[1]{\gdef\@advisor{#1}}
982 % \end{macrocode}
983 % \end{macro}
984 % \end{macro}
985 % If the |[proquest]| option was specified, erase the definition for |\maketitle|
986 % since we don't want a title page, and print an error if the advisor's name is
987 % not specified. Then define the abstract environment to create the ProQuest abstract
988 % and then end the document.
989 % \begin{macrocode}
990 \def\abstractname{Abstract}
991 \if@proquest
992 \def\maketitle{}
993 \def\@advisor{%
994 %<class> \ClassError{uiucthesis}{An advisor must be specified for the ProQuest abstract}%
995 %<package> \PackageError{uiucthesis}{An advisor must be specified for the ProQuest abstract}%
996 {Use \protect\advisor\space to specify a name}}
997 \newenvironment{abstract}{%
998 \newpage
999 \pagestyle{empty}
1000 \setcounter{page}{1}
1001 \begin{singlespace}\begin{center}
1002 \@Utitle\\[\baselineskip]
1003 \@author, \degree\\
1004 Department of \@dept\\
1005 University of Illinois at Urbana-Champaign, \@degreeyear\\
1006 \@advisor, Adviser\\[\baselineskip]
1007 \end{center}\end{singlespace}\par\noindent\ignorespaces
1008 }{
1009 \newpage
1010 \aftergroup\enddocument
1011 \aftergroup\endinput
1012 }
1013 % \end{macrocode}
1014 % If we are doing normal processing (no |[proquest]| option), simply define
1015 % the \env{abstract} environment to start a regular chapter.
1016 % \begin{macrocode}
1017 \else
1018 \newenvironment{abstract}{\chapter*{\abstractname}}{}
1019 \fi
1020 % \end{macrocode}
1021 % \end{environment}
1022 %
1023 % \begin{environment}{dedication}
1024 % The dedication environment just starts a new page and prints the dedication
1025 % in the center in italics.
1026 % \begin{macrocode}
1027 \newenvironment{dedication}{
1028 \newpage
1029 \leavevmode\vfill
1030 \begin{center}
1031 \itshape
1032 }{
1033 \end{center}
1034 \vskip 3ex
1035 \vfill
1036 \newpage
1037 }
1038 % \end{macrocode}
1039 % \end{environment}
1040 %
1041 % \begin{environment}{symbollist}
1042 % \begin{environment}{symbollist*}
1043 % The \env{symbollist} environments can be used to create a list of symbols or
1044 % abbreviations. The starred version left-justifies the left column (good for
1045 % lists of abbreviations) whereas the unstarred version centers the contents of
1046 % the left column (good for lists of symbols).
1047 % \begin{macrocode}
1048 \newenvironment*{symbollist}[1][1in]{
1049 \begin{list}{}{\singlespacing
1050 \setlength{\leftmargin}{#1}
1051 \setlength{\labelwidth}{#1}
1052 \addtolength{\labelwidth}{-\labelsep}
1053 \setlength{\topsep}{0in}}%
1054 \def\makelabel##1{\hfil##1\hfil}%
1055 }{
1056 \end{list}}
1057 \newenvironment*{symbollist*}[1][1in]{
1058 \begin{symbollist}[#1]
1059 \def\makelabel##1{##1\hfil}}
1060 {\end{symbollist}}
1061 % \end{macrocode}
1062 % \end{environment}
1063 % \end{environment}
1064 %
1065 %
1066 % \subsection{Chapter Headings}
1067 %
1068 % Text of chapter title must match exactly with text in Table of Contents.
1069 % We support both plain chapter headings and ``fancy'' chapter headings.
1070 %
1071 % \begin{macro}{\chapternumberfont}
1072 % Define the font used for chapter numbers in fancy chapter headings.
1073 % If you're using scalable PostScript fonts, you might want to
1074 % override it, for example:
1075 % \begin{verbatim}
1076 % \renewcommand\chapternumberfont{
1077 % \fontseries{bx}\fontsize{72}{72}\selectfont}
1078 % \end{verbatim}
1079 % \begin{macrocode}
1080 \if@thesisfancy
1081 \font\cminch=cminch at 60pt
1082 \newcommand\chapternumberfont{\cminch}
1083 \else
1084 \newcommand\chapternumberfont{\huge\bfseries}
1085 \fi
1086 % \end{macrocode}
1087 % \end{macro}
1088 %
1089 % \begin{macro}{\chaptertitlefont}
1090 % Define the font used for chapter titles.
1091 % \begin{macrocode}
1092 \newcommand\chaptertitlefont{\Huge\bfseries}
1093 % \end{macrocode}
1094 % \end{macro}
1095 %
1096 % \begin{macro}{\@chapter}
1097 % This macro is called when we have a numbered chapter. When
1098 % |secnumdepth| is larger than $-1$ and, in the book
1099 % class, |\@mainmatter| is true, we display the chapter
1100 % number. We also inform the user that a new chapter is about to be
1101 % typeset by writing a message to the terminal. This definition
1102 % is the same as that in \pkg{book.cls} except that it makes different
1103 % entries in the table of contents for fancy chapter heads.
1104 % \begin{macrocode}
1105 \def\@chapter[#1]#2{%
1106 \ifnum \c@secnumdepth >\m@ne
1107 \if@mainmatter
1108 \refstepcounter{chapter}%
1109 \typeout{\@chapapp\space\thechapter.}%
1110 \if@thesisfancy
1111 \addcontentsline{toc}{chapter}%
1112 {\protect\numberline{\thechapter}#1}%
1113 \else
1114 \addcontentsline{toc}{chapter}%
1115 {\@chapapp\ \thechapter\quad #1}%
1116 \fi
1117 \else
1118 \addcontentsline{toc}{chapter}{#1}%
1119 \fi
1120 \else
1121 \addcontentsline{toc}{chapter}{#1}%
1122 \fi
1123 % \end{macrocode}
1124 % After having written an entry to the table of contents we store
1125 % the (alternative) title of this chapter with |\chaptermark| and
1126 % add some white space to the lists of figures and tables.
1127 % \begin{macrocode}
1128 \chaptermark{#1}%
1129 \addtocontents{lof}{\protect\addvspace{10\p@}}%
1130 \addtocontents{lot}{\protect\addvspace{10\p@}}%
1131 % \end{macrocode}
1132 % Then we call upon |\@makechapterhead| to format the actual
1133 % chapter title. We have to do this in a special way when we are in
1134 % twocolumn mode in order to have the chapter title use the entire
1135 % |\textwidth|. In one column mode we call |\@afterheading|, which
1136 % takes care of suppressing the indentation.
1137 % \begin{macrocode}
1138 \if@twocolumn
1139 \@topnewpage[\@makechapterhead{#2}]%
1140 \else
1141 \@makechapterhead{#2}%
1142 \@afterheading
1143 \fi}
1144 % \end{macrocode}
1145 % \end{macro}
1146 %
1147 % For fancy chapter headings, compute the correct height to use for the
1148 % chapter number. I want the chapter number to be centered on the first line
1149 % of the chapter title. If $a$ is the height of the chapter number and $b$ is
1150 % the height of the chapter title, then if we set the chapter number in a
1151 % box of height $b+(a-b)/2=(a+b)/2$ then it aligns correctly.
1152 %
1153 % We arrange for this value to be computed at the beginning of the document
1154 % in case the user loads a style file that changed the default fonts.
1155 %
1156 % In addition, we want the chapter titles to have the same vertical placement
1157 % on the page, regardless whether the chapter is numbered or not. We compute
1158 % the distance we have to skip for chapters without numbers to accomplish this
1159 % and store it in |\thesis@chapskip|.
1160 % \begin{macrocode}
1161 \newskip\thesis@chapskip
1162 \AtBeginDocument{%
1163 \newdimen\chapternumberheight
1164 \begingroup
1165 \chapternumberfont
1166 \setbox255=\hbox{A}
1167 \if@thesisfancy
1168 \global\thesis@chapskip=\ht255
1169 \else
1170 \global\thesis@chapskip=\baselineskip
1171 \fi
1172 \dimen255=\ht255
1173 \chaptertitlefont
1174 \setbox255=\hbox{A}
1175 \advance\dimen255 by \ht255
1176 \if@thesisfancy
1177 \global\advance\thesis@chapskip by -\ht255
1178 \global\divide\thesis@chapskip by 2
1179 \global\advance\thesis@chapskip by 10\p@
1180 \else
1181 \global\advance\thesis@chapskip by 20\p@
1182 \fi
1183 \divide\dimen255 by 2
1184 \global\chapternumberheight=\dimen255
1185 \endgroup}
1186 % \end{macrocode}
1187 %
1188 % \begin{macro}{\chaptertitleheight}
1189 % The amount of space allotted for the chapter titles is stored in |\chaptertitleheight|.
1190 % In this manner, the chapter text always appears at the same vertical place for each
1191 % chapter, even if the title spills over into multiple lines.
1192 % \begin{macrocode}
1193 \newlength{\chaptertitleheight}
1194 \if@thesisfancy
1195 \setlength{\chaptertitleheight}{1.5in}
1196 \else
1197 \setlength{\chaptertitleheight}{1.85in}
1198 \fi
1199 % \end{macrocode}
1200 % \end{macro}
1201 %
1202 % \begin{macro}{\@makechapterhead}
1203 % The macro |\@chapter| uses |\@makechapterhead|\meta{text} to format the
1204 % heading of the chapter. This is a modified version of the standard
1205 % |\@makechapterhead|. It sets the chapter heading in single spacing,
1206 % and it handles the fancy heading style. The whole heading is placed
1207 % in a |\vbox| so that it is confined to the spacing allotted to it
1208 % as defined in |\chaptertitleheight|.
1209 % \begin{macrocode}
1210 \def\@makechapterhead#1{%
1211 \vbox to \chaptertitleheight{
1212 \def\baselinestretch{1}\@normalsize
1213 \parindent \z@ \raggedright \normalfont
1214 \if@centerchapter
1215 \centering
1216 \fi
1217 \ifnum \c@secnumdepth >\m@ne
1218 \if@mainmatter
1219 \thesis@chapskip=\z@
1220 \if@thesisfancy
1221 \vspace*{10\p@}%
1222 \leavevmode\llap{\vbox to \chapternumberheight{\hbox{%
1223 \chapternumberfont\thechapter\,}\vss}}%
1224 \else
1225 {\chapternumberfont \@chapapp\space \thechapter}
1226 \par\nobreak
1227 \vskip 20\p@
1228 \fi
1229 \fi
1230 \fi
1231 \interlinepenalty\@M
1232 \vspace*{\thesis@chapskip}%
1233 \chaptertitlefont #1
1234 \vfil
1235 }%
1236 \par\nobreak%
1237 }
1238 % \end{macrocode}
1239 % \end{macro}
1240 %
1241 % \begin{macro}{\@makeschapterhead}
1242 % The macro |\@schapter| uses |\@makeschapterhead|\meta{text}to format
1243 % the heading of the chapter. It is similar to |\@makechapterhead|
1244 % except that it never has to print a chapter number.
1245 %
1246 % \begin{macrocode}
1247 \def\@makeschapterhead#1{%
1248 \vbox to \chaptertitleheight{
1249 \def\baselinestretch{1}\@normalsize
1250 \parindent \z@ \raggedright \normalfont
1251 \if@centerchapter
1252 \centering
1253 \fi
1254 \interlinepenalty\@M
1255 \vspace*{\thesis@chapskip}
1256 \chaptertitlefont #1
1257 \vfil
1258 }%
1259 \par\nobreak%
1260 }
1261 % \end{macrocode}
1262 % \end{macro}
1263 %
1264 % \subsection{Lower Level Headings}
1265 %
1266 % \begin{macro}{\sectiontitlefont}
1267 % \begin{macro}{\subsectiontitlefont}
1268 % \begin{macro}{\subsubsectiontitlefont}
1269 % These macros contain the font declarations for the sectioning titles.
1270 % \begin{macrocode}
1271 \newcommand{\sectiontitlefont}{\Large\bfseries}
1272 \newcommand{\subsectiontitlefont}{\large\bfseries}
1273 \newcommand{\subsubsectiontitlefont}{\normalsize\bfseries}
1274 % \end{macrocode}
1275 % \end{macro}
1276 % \end{macro}
1277 % \end{macro}
1278 %
1279 % \begin{macro}{\section}
1280 % \begin{macro}{\subsection}
1281 % \begin{macro}{\subsubsection}
1282 % We redefine the lower level headings to set their titles
1283 % ragged right.
1284 % We don't have to change sectioning commands below
1285 % \env{subsubsection} because they produce run-in headings.
1286 % \begin{macrocode}
1287 \renewcommand\section{\@startsection {section}{1}{\z@}%
1288 {-3.5ex \@plus -1ex \@minus -.2ex}%
1289 {2.3ex \@plus.2ex}%
1290 {\raggedright\normalfont\sectiontitlefont}}
1291 \renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
1292 {-3.25ex\@plus -1ex \@minus -.2ex}%
1293 {1.5ex \@plus .2ex}%
1294 {\raggedright\normalfont\subsectiontitlefont}}
1295 \renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
1296 {-3.25ex\@plus -1ex \@minus -.2ex}%
1297 {1.5ex \@plus .2ex}%
1298 {\raggedright\normalfont\subsubsectiontitlefont}}
1299 % \end{macrocode}
1300 % \end{macro}
1301 % \end{macro}
1302 % \end{macro}
1303 %
1304 % \subsection{Appendices}
1305 %
1306 % \begin{macro}{\appendix}
1307 % Redefine the |\appendix| macro so that it can take a star
1308 % if unlettered appendices are desired.
1309 % \begin{macrocode}
1310 \let\thesis@appendix\appendix
1311 \renewcommand\appendix{\thesis@appendix\@ifstar{\gdef\thechapter{}}{}}
1312 % \end{macrocode}
1313 % \end{macro}
1314 %
1315 % \subsection{Bibliography}
1316 %
1317 % \begin{macro}{\bibname}
1318 % UIUC Thesis format says that if references are cited as ``[1]'' then
1319 % one of the terms ``References,'' ``List of References,'' or
1320 % ``Literature Cited'' should be used instead of ``Bibliography.''
1321 % \begin{macrocode}
1322 \renewcommand\bibname{References}
1323 % \end{macrocode}
1324 % \end{macro}
1325 %
1326 % \begin{environment}{thebibliography}
1327 % The standard definition of \env{thebibliography} environment issues the |\chapter*|
1328 % command, which does not make the necessary entry to the TOC. Here the environment
1329 % is redefined so that the unstarred version is used instead. In addition,
1330 % the environment is also single-spaced for aesthetics. These modifications are done
1331 % at the beginning of the document since some packages (\pkg{natbib} in particular)
1332 % change the definition of \env{thebibliography} environment.
1333 % \begin{macrocode}
1334 \AtBeginDocument{\let\thesis@thebib\thebibliography
1335 \let\thesis@endbib\endthebibliography
1336 \def\thebibliography{\begingroup\singlespacing%
1337 \chapter{\bibname}%
1338 \let\chapter\@gobbletwo%
1339 \thesis@thebib}
1340 \def\endthebibliography{\thesis@endbib\endgroup}}
1341 % \end{macrocode}
1342 % \end{environment}
1343 %
1344 %
1345 % \subsection{Index}
1346 %
1347 % \begin{environment}{theindex}
1348 % The index is single spaced and a line is added to the Table of Contents.
1349 % \begin{macrocode}
1350 \let\thesis@theindex=\theindex
1351 \def\theindex{\addcontentsline{toc}{chapter}{\indexname}%
1352 \begingroup\singlespacing\thesis@theindex}
1353 \let\thesis@endtheindex=\endtheindex
1354 \def\endtheindex{\thesis@endtheindex\endgroup}
1355 % \end{macrocode}
1356 % \end{environment}
1357 %
1358 %
1359 % \subsection{Page Layout}
1360 %
1361 % First we set the vertical layout.
1362 % Adjust the height of the text column so that it takes up the full
1363 % height of an 8.5 by 11 inch page.
1364 % \begin{macrocode}
1365 \topmargin=0pt
1366 \advance \topmargin by -\headheight
1367 \advance \topmargin by -\headsep
1368 \textheight 8.9in
1369 % \end{macrocode}
1370 % Next, set the horizontal layout.
1371 %
1372 % The standard for technical papers seems to be to use
1373 % extremely wide columns of text, and then to increase the spacing between
1374 % lines to compensate for the long lines.
1375 % Unfortunately, because so many papers are typeset this way,
1376 % the format has become self-propagating.
1377 %
1378 % The |[fullpage]| option sets one-inch margins.
1379 % \begin{macrocode}
1380 \if@fullpage
1381 \setlength{\textwidth}{\paperwidth}
1382 \addtolength{\textwidth}{-2in}
1383 \@settopoint\textwidth
1384 \fi
1385 % \end{macrocode}
1386 % In the old version of \pkg{uiucthesis}, the ``fancy'' thesis style used
1387 % an asymmetric page layout,
1388 % shifting the text column slightly over to the right to leave
1389 % room for the chapter number to the left of the chapter title. This layout
1390 % is still used if the |[offcenter]| option is given, otherwise symmetric
1391 % margins are used.
1392 % \begin{macrocode}
1393 \setlength{\@tempdima}{\paperwidth}
1394 \addtolength{\@tempdima}{-\textwidth}
1395 \setlength{\oddsidemargin}{.5\@tempdima}
1396 \addtolength{\oddsidemargin}{-1in}
1397 \if@thesisoffcenter
1398 \addtolength{\oddsidemargin}{0.5in}
1399 \reversemarginpar
1400 \fi
1401 % \end{macrocode}
1402 % Set |\marginparwidth|, leaving 24pt for the right margin.
1403 % Note that you're not allowed to actually use a marginal paragraph
1404 % this close to the edge in the final version of a thesis, but it is still
1405 % handy for leaving notes to yourself in the draft (with the |\note|
1406 % command, see below).
1407 % \begin{macrocode}
1408 \setlength{\marginparwidth}{\oddsidemargin}
1409 \addtolength{\marginparwidth}{1in}
1410 \addtolength{\marginparwidth}{-\marginparsep}
1411 \addtolength{\marginparwidth}{-24pt}
1412 % \end{macrocode}
1413 % Use the same margins for even and odd pages. Use the \LaTeX macro
1414 % |\@settopoint| to truncate arithmetic errors.
1415 % \begin{macrocode}
1416 \@settopoint\oddsidemargin
1417 \@settopoint\marginparwidth
1418 \setlength{\evensidemargin}{\oddsidemargin}
1419 % \end{macrocode}
1420 %
1421 %
1422 % \subsection{Making Notes}
1423 %
1424 % \begin{macro}{\note}
1425 % You can leave yourself marginal notes using the |\note{|\meta{text}|}|
1426 % macro. If the final draft is being printed (i.e., no |[draftthesis]| option)
1427 % then these notes are not printed.
1428 % \begin{macrocode}
1429 \if@thesisdraft
1430 \newcommand{\note}[1]{\marginpar{\def\baselinestretch{1}\small\raggedright #1}}
1431 \else
1432 \newcommand{\note}[1]{}
1433 \let\thesis@marginpar\marginpar
1434 \def\marginpar{%
1435 %<class> \ClassWarning{uiucthesis}{Margin paragraphs fall outside the allowed margins\MessageBreak
1436 %<package> \PackageWarning{uiucthesis}{Margin paragraphs fall outside the allowed margins\MessageBreak
1437 for UIUC Theses, use \protect\note\space instead of \protect\marginpar.}%
1438 \thesis@marginpar}
1439 \fi
1440 % \end{macrocode}
1441 % \end{macro}
1442 %
1443 % \subsection{Page Numbering}
1444 %
1445 % Page numbers must be in one of three places, and must appear in the
1446 % same place on \emph{every page}, including chapter openings.
1447 %
1448 % To accommodate the draft heading, we redefine the plain page style.
1449 % \begin{macro}{\ps@plain}
1450 % \begin{macrocode}
1451 \def\ps@plain{%
1452 \let\@mkboth\@gobbletwo
1453 \if@thesisdraft
1454 \def\@oddhead{\draftheader\hfil}
1455 \else
1456 \let\@oddhead\@empty
1457 \fi
1458 \let\@evenhead\@oddhead
1459 \def\@oddfoot{\reset@font\hfil\thepage\hfil}%
1460 \let\@evenfoot\@oddfoot
1461 }
1462 % \end{macrocode}
1463 % \end{macro}
1464 %
1465 % \begin{macro}{\ps@headings}
1466 % The ``headings'' page style is also supported. The heading at the top
1467 % will be within the 1 inch margin that you are supposed to allow, however.
1468 % If the |[draftthesis]| option is given, there is probably not enough room
1469 % for both the chapter number and title, so just print the number in that case.
1470 % \begin{macrocode}
1471 \if@twoside
1472 \def\ps@headings{%
1473 \if@thesisdraft
1474 \def\@oddhead{\draftheader\hfil\slshape\rightmark}
1475 \def\@evenhead{\slshape\leftmark\hfil\draftheader}
1476 \else
1477 \def\@oddhead{\hfil\slshape\rightmark}
1478 \def\@evenhead{\slshape\leftmark\hfil}
1479 \fi
1480 \def\@oddfoot{\reset@font\hfil\thepage\hfil}%
1481 \let\@evenfoot\@oddfoot
1482 \let\@mkboth\markboth
1483 \if@thesisdraft
1484 \def\chaptermark##1{%
1485 \markboth {\MakeUppercase{%
1486 \ifnum \c@secnumdepth >\m@ne
1487 \if@mainmatter
1488 \@chapapp\ \thechapter%
1489 \fi
1490 \fi}}{}}
1491 \else
1492 \def\chaptermark##1{%
1493 \def\@chaphead{\MakeUppercase{%
1494 \ifnum \c@secnumdepth >\m@ne
1495 \if@mainmatter
1496 \if@thesisfancy
1497 \thechapter.~~%
1498 \else
1499 \@chapapp\ \thechapter.~~%
1500 \fi
1501 \fi
1502 \fi
1503 ##1}}%
1504 \markboth{\@chaphead}{\@chaphead}}
1505 \fi
1506 \def\sectionmark##1{%
1507 \markright {\MakeUppercase{%
1508 \ifnum \c@secnumdepth >\z@
1509 \thesection. \ %
1510 \fi
1511 ##1}}}}
1512 \else
1513 \def\ps@headings{%
1514 \if@thesisdraft
1515 \def\@oddhead{\draftheader\hfil\slshape\rightmark}
1516 \else
1517 \def\@oddhead{\hfil\slshape\rightmark\hfil}
1518 \fi
1519 \let\@evenhead\@oddhead
1520 \def\@oddfoot{\reset@font\hfil\thepage\hfil}%
1521 \let\@evenfoot\@oddfoot
1522 \let\@mkboth\markboth
1523 \if@thesisdraft
1524 \def\chaptermark##1{%
1525 \markright {\MakeUppercase{%
1526 \ifnum \c@secnumdepth >\m@ne
1527 \if@mainmatter
1528 \@chapapp\ \thechapter%
1529 \fi
1530 \fi}}}
1531 \else
1532 \def\chaptermark##1{%
1533 \markright {\MakeUppercase{%
1534 \ifnum \c@secnumdepth >\m@ne
1535 \if@mainmatter
1536 \if@thesisfancy
1537 \thechapter.~~%
1538 \else
1539 \@chapapp\ \thechapter.~~%
1540 \fi
1541 \fi
1542 \fi
1543 ##1}}}
1544 \fi
1545 }
1546 \fi
1547 % \end{macrocode}
1548 % \end{macro}
1549 %
1550 % Set the default page style to (our new definition of) plain.
1551 % \begin{macrocode}
1552 \pagestyle{plain}
1553 % \end{macrocode}
1554 %
1555 % \begin{macro}{\chapter}
1556 % Redefine |\chapter| to not do |\thispagestyle{empty}| because
1557 % even chapter openings should have page numbers in UIUC theses.
1558 % \begin{macrocode}
1559 \renewcommand\chapter{\if@openright\cleardoublepage\else\clearpage\fi
1560 \@mkboth{}{}
1561 \thispagestyle{plain}
1562 \global\@topnum\z@
1563 \@afterindentfalse
1564 \secdef\@chapter\@schapter}
1565 % \end{macrocode}
1566 % \end{macro}
1567 %
1568 %
1569 % \subsection{Vita}
1570 %
1571 % The support for |\vita| is pretty minimal.
1572 %
1573 % \begin{macro}{\vitaname}
1574 % Define |\vitaname| so the user can change it if he wants.
1575 % \begin{macrocode}
1576 \newcommand\vitaname{Vita}
1577 % \end{macrocode}
1578 % \end{macro}
1579 %
1580 % \begin{macro}{\vita}
1581 % Vita should appear in Table of Contents, but should not be numbered.
1582 % \begin{macrocode}
1583 \newcommand\vita{
1584 \chapter{\vitaname}%
1585 }
1586 % \end{macrocode}
1587 % \end{macro}
1588 %
1589 % \subsection{Body Formatting}
1590 %
1591 % \begin{macro}{\thesisspacing}
1592 % The |\thesisspacing| command is called to switch to the default
1593 % line spacing for the thesis. The thesis format requirements
1594 % require at least line and a half spacing.
1595 % The \pkg{uiucthesis} class by default uses |\onehalfspacing|,
1596 % or |\doublespacing| if the |[fullpage]| option is in effect.
1597 % \begin{macrocode}
1598 \def\thesisspacing{\if@fullpage\doublespacing\else\onehalfspacing\fi}
1599 % \end{macrocode}
1600 % \end{macro}
1601 %
1602 % At this point, we're ready to set up the actual formatting for the
1603 % front matter of the thesis. We use roman page numbers.
1604 % Also, arrange so that |\thesisspacing| gets called when the document
1605 % begins. We don't just call it here because that wouldn't give the
1606 % user a chance to override it.
1607 % \begin{macrocode}
1608 \pagenumbering{roman}
1609 \AtBeginDocument{\thesisspacing}
1610 % \end{macrocode}
1611 %
1612 % \subsection{Compatibility}
1613 %
1614 % \begin{macro}{preliminary}
1615 % The old \pkg{uiucthesis} style defined a \env{preliminary}
1616 % environment for the front matter. This isn't needed with this
1617 % style, so we redefine it to call |\frontmatter| for compatibility's sake.
1618 % \begin{macrocode}
1619 \def\preliminary{\frontmatter}
1620 \let\endpreliminary=\relax
1621 % \end{macrocode}
1622 % \end{macro}
1623 %
1624 % \begin{macro}{thesis}
1625 % Similarly, the old \pkg{uiucthesis} style defined a \env{thesis}
1626 % environment that has been superceded by the |\mainmatter| command.
1627 % We define it here for backward compatibility.
1628 % \begin{macrocode}
1629 \def\thesis{\mainmatter}
1630 \let\endthesis=\relax
1631 % \end{macrocode}
1632 % \end{macro}
1633 %
1634 % \iffalse
1635 %</class|package>
1636 % \fi
1637 % \Finale
1638 \endinput