Fixed natbib bug
[latex-mlastyle.git] / mlastyle.dtx
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2003 by Tim Pope <latex@rebelongto.us>
4 % ----------------------------------------------------
5
6 % This file may be distributed and/or modified under the
7 % conditions of the LaTeX Project Public License, either version 1.2
8 % of this license or (at your option) any later version.
9 % The latest version of this license is in:
10 %
11 %    http://www.latex-project.org/lppl.txt
12 %
13 % and version 1.2 or later is part of all distributions of LaTeX 
14 % version 1999/12/01 or later.
15 %
16 % \fi
17 %
18 % \iffalse
19 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
20 %<package>\ProvidesPackage{mlastyle}
21 %<package>   [2003/11/09 v0.9 MLA format and documentation style]
22 %
23 %<*driver>
24 \begin{filecontents}{mlastyle.bib}
25 @PREAMBLE{"\def\BibTex{\rmfamily B\kern -.05em\textsc {i\kern -.025emb}\kern -.08emT\kern -.1667em\lower .7ex\hbox {E}\kern -.125emX}"}
26
27 @BOOK{handbook,
28   AUTHOR = "Joseph Gibaldi",
29   TITLE = "MLA Handbook for Writers of Research Papers",
30   KEY = "MLA Handbook",
31   EDITION = "Sixth",
32   ADDRESS = "New York",
33   PUBLISHER = "MLA",
34   YEAR = "2003"}
35
36 @BOOK{latexdps,
37   AUTHOR = "Leslie Lamport",
38   TITLE = "{\LaTeX}: A Document Preparation System",
39   KEY = "{\LaTeX}",
40   EDITION = "Second",
41   ADDRESS = "Reading",
42   PUBLISHER = "Addison-Wesley",
43   YEAR = "1994"}
44
45 @MANUAL{lshort,
46   AUTHOR  = "Tobias Oetker and Hubert Partl and Irene Hyna and Elisabeth 
47 Schlegl",
48   TITLE   = "The Not So Short Introduction to {\LaTeXe}",
49   KEY     = "Not So Short",
50   YEAR    = "2000",
51   MONTH   = dec,
52   VERSION = "4.0",
53   ACCESSDATE = "1~"#nov#"~2003",
54   URL     = "CTAN://info/lshort/"}
55
56 @MANUAL{btxdoc,
57   AUTHOR  = "Oren Patashnik",
58   TITLE   = "{\BibTex ing}",
59   YEAR    = "1988",
60   MONTH   = feb,
61   ACCESSDATE = "1~"#nov#"~2003",
62   URL     = "CTAN://biblio/bibtex/distribs/doc/btxdoc.tex"}
63 \end{filecontents}
64 \documentclass[draft]{ltxdoc}
65 \iffalse
66   \usepackage[mla]{mlastyle}
67   \bibliographystyle{mlastyle}
68   \addtolength{\marginparwidth}{1in}
69   \addtolength{\textwidth}{-1in}
70   \addtolength{\headwidth}{-1in}
71 \else
72   \IfFileExists{natbib.sty}{
73     \usepackage{natbib}
74     \citeindextrue
75     \bibpunct{[}{]}{,}{n}{}{,}%{
76     \bibliographystyle{plainnat}}
77     {\bibliographystyle{plain}}
78   \IfFileExists{url.sty}{\usepackage{url}}{}
79   \usepackage[compat]{mlastyle}
80   %\addtolength{\headsep}{-5pt}
81   %\addtolength{\headheight}{-12pt}
82   %\addtolength{\topmargin}{-17pt}
83   %\addtolength{\textheight}{22pt}
84   \IfFileExists{ulem.sty}{\usepackage[normalem]{ulem}}{\let\uline\emph}
85 \fi
86 \IfFileExists{times.sty}%
87 {\newcommand{\examp}[2][]{{\let\emph\uline\fontfamily{ptm}\selectfont##2}##1}}%
88 {\newcommand{\examp}[2][]{``##2##1''}}
89
90 {\makeatletter\gdef\NAT@MLA#1{#1}\gdef\NAT@idxtxt
91 {\expandafter\NAT@MLA\NAT@name\ \NAT@open\NAT@num\NAT@close}}
92 \EnableCrossrefs
93 \CodelineIndex
94 \RecordChanges
95 %\OnlyDescription
96 \begin{document}
97   \DocInput{mlastyle.dtx}
98 \end{document}
99 %</driver>
100 % \fi
101 %
102 % \CheckSum{0}
103 %
104 % \CharacterTable
105 %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
106 %   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
107 %   Digits        \0\1\2\3\4\5\6\7\8\9
108 %   Exclamation   \!     Double quote  \"     Hash (number) \#
109 %   Dollar        \$     Percent       \%     Ampersand     \&
110 %   Acute accent  \'     Left paren    \(     Right paren   \)
111 %   Asterisk      \*     Plus          \+     Comma         \,
112 %   Minus         \-     Point         \.     Solidus       \/
113 %   Colon         \:     Semicolon     \;     Less than     \<
114 %   Equals        \=     Greater than  \>     Question mark \?
115 %   Commercial at \@     Left bracket  \[     Backslash     \\
116 %   Right bracket \]     Circumflex    \^     Underscore    \_
117 %   Grave accent  \`     Left brace    \{     Vertical bar  \|
118 %   Right brace   \}     Tilde         \~}
119 %
120 %
121 % \changes{v0.9}{2003/11/09}{Converted to \texttt{dtx} file}
122 % \changes{v0.8}{2003/10/15}{Initial version}
123 %
124 % \GetFileInfo{mlastyle.sty}
125 %
126 % \DoNotIndex{\ }
127 % \DoNotIndex{\.}
128 % \DoNotIndex{\@afterindentfalse}
129 % \DoNotIndex{\@afterindenttrue}
130 % \DoNotIndex{\@arabic}
131 % \DoNotIndex{\@author}
132 % \DoNotIndex{\@auxout}
133 % \DoNotIndex{\@citea}
134 % \DoNotIndex{\@citeb}
135 % \DoNotIndex{\@date}
136 % \DoNotIndex{\@empty}
137 % \DoNotIndex{\@firstofone}
138 % \DoNotIndex{\@for}
139 % \DoNotIndex{\@ifundefined}
140 % \DoNotIndex{\@latex@warning}
141 % \DoNotIndex{\@listI}
142 % \DoNotIndex{\@listi}
143 % \DoNotIndex{\@listii}
144 % \DoNotIndex{\@listiii}
145 % \DoNotIndex{\@listiv}
146 % \DoNotIndex{\@listv}
147 % \DoNotIndex{\@listvi}
148 % \DoNotIndex{\@m}
149 % \DoNotIndex{\@startsection}
150 % \DoNotIndex{\@tempswafalse}
151 % \DoNotIndex{\@title}
152 % \DoNotIndex{\@undefined}
153 % \DoNotIndex{\DeclareOption}
154 % \DoNotIndex{\ExecuteOptions}
155 % \DoNotIndex{\G@refundefinedtrue}
156 % \DoNotIndex{\ProcessOptions}
157 % \DoNotIndex{\RequirePackage}
158 % \DoNotIndex{\UL@start,\UL@stop}
159 % \DoNotIndex{\addtolength}
160 % \DoNotIndex{\advance}
161 % \DoNotIndex{\baselineskip}
162 % \DoNotIndex{\bibpreamble,\bibpunct,\bibsep}
163 % \DoNotIndex{\begin}
164 % \DoNotIndex{\bfseries}
165 % \DoNotIndex{\bgroup}
166 % \DoNotIndex{\c@enumiv}
167 % \DoNotIndex{\catcode}
168 % \DoNotIndex{\centering}
169 % \DoNotIndex{\centerline}
170 % \DoNotIndex{\chapter}
171 % \DoNotIndex{\citation}
172 % \DoNotIndex{\citet,\citep}
173 % \DoNotIndex{\clearpage}
174 % \DoNotIndex{\csname}
175 % \DoNotIndex{\day}
176 % \DoNotIndex{\def}
177 % \DoNotIndex{\do}
178 % \DoNotIndex{\edef}
179 % \DoNotIndex{\egroup}
180 % \DoNotIndex{\else}
181 % \DoNotIndex{\end}
182 % \DoNotIndex{\endcsname}
183 % \DoNotIndex{\endlist}
184 % \DoNotIndex{\exhyphenpenalty}
185 % \DoNotIndex{\expandafter}
186 % \DoNotIndex{\f@baselineskip}
187 % \DoNotIndex{\fancyhf}
188 % \DoNotIndex{\fancypagestyle}
189 % \DoNotIndex{\fi}
190 % \DoNotIndex{\futurelet}
191 % \DoNotIndex{\gdef}
192 % \DoNotIndex{\global}
193 % \DoNotIndex{\hangindent}
194 % \DoNotIndex{\headrulewidth}
195 % \DoNotIndex{\if@filesw}
196 % \DoNotIndex{\if@tempswa}
197 % \DoNotIndex{\ifcase}
198 % \DoNotIndex{\ifmlastyle@bibstyle}
199 % \DoNotIndex{\ifmlastyle@format}
200 % \DoNotIndex{\ifmlastyle@pages}
201 % \DoNotIndex{\ifmlastyle@papersize}
202 % \DoNotIndex{\ifmlastyle@style}
203 % \DoNotIndex{\ifmlastyle@times}
204 % \DoNotIndex{\ifmlastyle@underline}
205 % \DoNotIndex{\ifx}
206 % \DoNotIndex{\immediate}
207 % \DoNotIndex{\item}
208 % \DoNotIndex{\itemindent}
209 % \DoNotIndex{\itemsep}
210 % \DoNotIndex{\labelsep}
211 % \DoNotIndex{\labelwidth}
212 % \DoNotIndex{\leavevmode}
213 % \DoNotIndex{\leftmargin}
214 % \DoNotIndex{\leftmargini,\leftmarginii,\leftmarginiii}
215 % \DoNotIndex{\leftmarginiv,\leftmarginv,\leftmarginvi}
216 % \DoNotIndex{\let}
217 % \DoNotIndex{\linespread}
218 % \DoNotIndex{\list}
219 % \DoNotIndex{\listparindent}
220 % \DoNotIndex{\makeenmark}
221 % \DoNotIndex{\mbox}
222 % \DoNotIndex{\ml@}
223 % \DoNotIndex{\mlastyle@bibstylefalse}
224 % \DoNotIndex{\mlastyle@bibstyletrue}
225 % \DoNotIndex{\mlastyle@cite}
226 % \DoNotIndex{\mlastyle@course}
227 % \DoNotIndex{\mlastyle@formatfalse}
228 % \DoNotIndex{\mlastyle@formattrue}
229 % \DoNotIndex{\mlastyle@instructor}
230 % \DoNotIndex{\mlastyle@intbib}
231 % \DoNotIndex{\mlastyle@pagesfalse}
232 % \DoNotIndex{\mlastyle@pagestrue}
233 % \DoNotIndex{\mlastyle@papersizefalse}
234 % \DoNotIndex{\mlastyle@papersizetrue}
235 % \DoNotIndex{\mlastyle@qspread}
236 % \DoNotIndex{\mlastyle@sl@sh}
237 % \DoNotIndex{\mlastyle@slash}
238 % \DoNotIndex{\mlastyle@slashnext}
239 % \DoNotIndex{\mlastyle@slashx}
240 % \DoNotIndex{\mlastyle@stylefalse}
241 % \DoNotIndex{\mlastyle@styletrue}
242 % \DoNotIndex{\mlastyle@surname}
243 % \DoNotIndex{\mlastyle@timesfalse}
244 % \DoNotIndex{\mlastyle@timestrue}
245 % \DoNotIndex{\mlastyle@underlinefalse}
246 % \DoNotIndex{\mlastyle@underlinetrue}
247 % \DoNotIndex{\month}
248 % \DoNotIndex{\newblock}
249 % \DoNotIndex{\newcommand}
250 % \DoNotIndex{\newdimen}
251 % \DoNotIndex{\newenvironment}
252 % \DoNotIndex{\newif}
253 % \DoNotIndex{\newpage}
254 % \DoNotIndex{\noindent}
255 % \DoNotIndex{\normalsize}
256 % \DoNotIndex{\notesname}
257 % \DoNotIndex{\number}
258 % \DoNotIndex{\or}
259 % \DoNotIndex{\p@}
260 % \DoNotIndex{\pagestyle}
261 % \DoNotIndex{\par}
262 % \DoNotIndex{\parindent}
263 % \DoNotIndex{\parsep}
264 % \DoNotIndex{\penalty}
265 % \DoNotIndex{\relax}
266 % \DoNotIndex{\renewcommand}
267 % \DoNotIndex{\renewenvironment}
268 % \DoNotIndex{\reset@font}
269 % \DoNotIndex{\rhead}
270 % \DoNotIndex{\selectfont}
271 % \DoNotIndex{\setlength}
272 % \DoNotIndex{\settowidth}
273 % \DoNotIndex{\sfcode}
274 % \DoNotIndex{\skip}
275 % \DoNotIndex{\sloppy}
276 % \DoNotIndex{\space}
277 % \DoNotIndex{\string}
278 % \DoNotIndex{\the}
279 % \DoNotIndex{\thebibliography}
280 % \DoNotIndex{\thepage}
281 % \DoNotIndex{\topsep}
282 % \DoNotIndex{\usecounter}
283 % \DoNotIndex{\unskip}
284 % \DoNotIndex{\vskip}
285 % \DoNotIndex{\write}
286 % \DoNotIndex{\year}
287 % \DoNotIndex{\z@}
288 % \DoNotIndex{\bibhang}
289 % \DoNotIndex{\evensidemargin}
290 % \DoNotIndex{\headheight}
291 % \DoNotIndex{\headsep}
292 % \DoNotIndex{\hoffset}
293 % \DoNotIndex{\marginparwidth}
294 % \DoNotIndex{\oddsidemargin}
295 % \DoNotIndex{\raggedbottom}
296 % \DoNotIndex{\raggedright}
297 % \DoNotIndex{\textheight}
298 % \DoNotIndex{\textwidth}
299 % \DoNotIndex{\topmargin}
300 % \DoNotIndex{\voffset}
301 % \DoNotIndex{\paperheight}
302 % \DoNotIndex{\paperwidth}
303 % \DoNotIndex{\pdfpageheight}
304 % \DoNotIndex{\pdfpagewidth}
305 % \DoNotIndex{\special}
306 %
307 % \hyphenation{pre-am-ble wide-spread}
308 %
309 % \newcommand{\Lopt}[1]{\textsf {#1}}
310 % \newcommand{\file}[1]{\texttt {#1}}
311 % \newcommand{\package}[1]{\textsf {#1}}
312 % ^^A\newcommand{\Lcount}[1]{\textsl {\small#1}}
313 % ^^A\newcommand{\pstyle}[1]{\textsl {#1}}
314 %
315 % \newcommand{\OptionIndex}[1]{\index{#1\actualchar\Lopt{#1} (option)\encapchar usage}\index{options:\levelchar\Lopt{#1}}}
316 %
317 % \title{The \package{mlastyle} package\thanks{This document
318 %   corresponds to \package{mlastyle}~\fileversion, dated \filedate.}}
319 % \author{Tim Pope \\ \texttt{latex@rebelongto.us}}
320 % \surname{Pope}
321 %
322 % \maketitle
323 %
324 % \tableofcontents
325 %
326 % \section{Introduction}
327 %
328 % ^^A MLA style, consisting of a set of documentation conventions, has
329 % ^^A gained widespread acceptance in the humanities.
330 % According to the {\em MLA Handbook for Writers of Research
331 % Papers}\citeC{handbook}, MLA style is a set of ``commonly agreed-on
332 % rules for documenting quotations, facts, opinions and paraphrases'' that
333 % ``is preferred by a substantial majority of scholarly journals in
334 % language and literature{\makeatletter\ifmlastyle@style
335 % .''\citeM[xvi]{handbook}\else.''\fi} \LaTeX{} is a
336 % document preparation system enjoying popularity in the scientific field.
337 % It should come as no surprise that complete, up-to-date implementations
338 % of MLA style for \LaTeX{} are in short supply.  The \LaTeX{} package
339 % \package{mlastyle} aims to fill this void.
340 %
341 % \section{Usage}
342 %
343 % A sample document follows.
344 % \begin{verbatim}
345 %\documentclass[12pt]{article}
346 %\usepackage{mlastyle}
347 %
348 %\author{John Doe}
349 %\instructor{Professor Smith}
350 %\course{English 101}
351 %\date{1~Jan.\ 1970}
352 %\title{The Sadism Inherent in Compulsory English Classes}
353 %
354 %\begin{document}
355 %\maketitle
356 %'Nuff said.
357 %\end{document}\end{verbatim}
358 % \subsection{Initialization Macros}
359 % The \index{heading|usage}mandatory heading is generated with
360 % \DescribeMacro{\maketitle}|\maketitle|.  Use the standard macros
361 % |\author|, |\title|, and |\date| to specify the relevant information.
362 % To define the instructor and name of the course, use the aptly named
363 % \DescribeMacro{\instructor}|\instructor|\marg{instructor} and
364 % \DescribeMacro{\course}|\course|\marg{course} macros.
365 %
366 % The last name for use in the header\index{header|usage} is derived from
367 % |\author|.  If this does not produce the desired result, use
368 % \DescribeMacro{\surname}|\surname|\marg{last name} to override it.
369 %
370 % MLA style recommends the DD~Mon.~YYYY format for specifying dates;
371 % \DescribeMacro{\today}|\today| has been conveniently redefined to this.
372 % However, other formats can be used as long as done so consistently
373 % throughout the document.  Also note that the date in the
374 % heading\index{heading|usage} should be the due date of the assignment;
375 % students who finish assignments early would be wise to call
376 % |\date|\marg{due date}.
377 %
378 % \subsection{Environments}
379 % Three environments have been modified from standard \LaTeX to better
380 % suit MLA format.  To typeset \index{poetry|usage}poetry and
381 % \index{drama|usage}drama, use the \DescribeEnv{verse}|verse|
382 % environment.  Quotations\index{quotations|usage} of a single paragraph
383 % or less always use the \DescribeEnv{quote}|quote| environment.  For
384 % longer passages, use the \DescribeEnv{quotation}|quotation| environment
385 % if the beginning of the passage marks the beginning of a paragraph.
386 % Otherwise, use the |quote| environment.
387 %
388 % Be sure to follow MLA guidelines when using these environments.  Short
389 % quotes should be enclosed in quotation marks and included directly in
390 % the text.
391 %
392 % \subsection{Modes of Operation}
393 % The \package{mlastyle} package has four basic modes of operations,
394 % selected with one of four mutually exclusive options.  The
395 % \OptionIndex{format}\Lopt{format}
396 % option tells \package{mlastyle} to use MLA format (i.e., 1 inch margins,
397 % double-spaced, etc.).  The \OptionIndex{style}\Lopt{style} option tells
398 % \package{mlastyle} to use MLA style (i.e., the format of parenthetical
399 % documentation, etc).  Each of these options
400 % disables the other; to use both MLA format and MLA style, specify the
401 % \OptionIndex{mla}\Lopt{mla} option, or nothing at all.
402 %
403 % To disable both MLA style and MLA format, use the
404 % \OptionIndex{compat}\Lopt{compat} option.  This differs from omitting
405 % the package entirely in that certain macros are still defined (e.g.,
406 % |\instructor|).  Also, citations are handled a bit differently than in
407 % standard \LaTeX{} (see section~\ref{sec:documentation}).
408 %
409 % In addition to the above, several other options modify the behavior of
410 % \package{mlastyle}.
411 %
412 % \subsubsection{Italics vs.\ Underlining} \index{underlining|usage}
413 % \index{italics|usage}\label{sec:italics}
414 % The {\em MLA Handbook\/}\citeC{handbook} dictates that emphasis should
415 % be indicated by underlining the text\citeM[94]{handbook}.  Thus, the
416 % \package{ulem} package, which underlines all emphasized
417 % text, is loaded by default in \Lopt{mla} and \Lopt{format} modes.  To
418 % disable this, use the \OptionIndex{italics}\Lopt{italics} option.
419 % Conversely, if underlining is desired in \Lopt{style} or \Lopt{compat}
420 % mode, the \OptionIndex{underline}\Lopt{underline} option can be used.
421 %
422 % \subsubsection{Fonts}
423 % By default, \package{mlastyle} uses \TeX's standard Computer Modern
424 % font.  Some profess\-ors\penalty500---particularly those
425 % concerned with document length---require assignments to be set in
426 % \examp[.]{Times New Roman}  This can be achieved with the
427 % \OptionIndex{times}\Lopt{times} option, which simply loads the
428 % \package{times} package.  This opposite of this option is
429 % \OptionIndex{cm}\Lopt{cm}, which reverts to Computer Modern.
430 %
431 % \index{works cited|usage}
432 % \subsection{Documenting Sources} \label{sec:documentation}
433 %
434 % The \package{mlastyle} package reimplements the
435 % \DescribeEnv{thebibliography}|thebibliography| environment to generate
436 % the list of works cited in MLA style.  Instruction in the basic use of
437 % \LaTeX's bibliography features is beyond the scope of this document;
438 % however, the following example, which should be included just before
439 % |\end{document}|, might prove to be a useful starting point:
440 %\begin{verbatim}
441 %\begin{thebibliography}{}
442 %
443 %\bibitem[Lamport]{latexdps}
444 %Lamport, Leslie.
445 %\newblock \emph{\LaTeX: A Document Preparation System}.
446 %\newblock 2nd.~ed.
447 %\newblock Reading: Addison-Wesley, 1994.
448 %
449 %\end{thebibliography}\end{verbatim}
450 % In this example, |Lamport| is the author's last name (for use in
451 % citations) and |latexdps| is the marker used to reference it (see
452 % section~\ref{sec:parenthetical}).
453 %
454 % For information on automatically generating the list of works cited with
455 % \BibTeX, see section~\ref{sec:bibtex}.
456 %
457 % \subsubsection{Parenthetical Documentation} \label{sec:parenthetical}
458 % A simple citation can by achieved with a call to
459 % \DescribeMacro{\cite}|\cite|\oarg{pages}\marg{marker}, where
460 % marker refers to the key given to either
461 % \index{BibTeX=\BibTeX|usage}\BibTeX{} or the |\bibitem| macro (|latex|
462 % in the above example).
463 % Omit \oarg{pages} if the source has no page numbers.
464 % Multiple sources can be cited using the syntax
465 % |\cite|\oarg{pages}|{|\meta{marker
466 % 1}\texttt{,}\penalty\exhyphenpenalty\meta{marker 2}\ldots|}|; however, page
467 % numbers can currently be specified only for the last referenced source.
468 % To work around this limitation, use |\citealp|, explained below.
469 %
470 % Three additional citation commands are provided, all of which take the
471 % same arguments as |\cite|.  To omit the author information from the
472 % citation, use \DescribeMacro{\citepage}|\citepage|.  Indirect
473 % citations---those of the format \examp{(qtd. in Pope
474 % \pageref{sec:italics})}---can be
475 % created with \DescribeMacro{\citeindirect}|\citeindirect|.  Finally, the
476 % parentheses are omitted by \DescribeMacro{\citealp}|\citealp|.  This was
477 % intended for use in cross references, but it can also help in citing
478 % multiple works.  The result of
479 % |(\citealp[42]{texbook}|\texttt{; }|\citealp[69]{latexdps})|
480 % would be something like \examp[.]{(Knuth 42; Lamport 69)}
481 %
482 % \subsubsection{Using {\rm \BibTeX}} \label{sec:bibtex}
483 % Coupled with \index{BibTeX=\BibTeX|usage}\BibTeX,
484 % \package{mlastyle} provides a experimental implementation of MLA
485 % documentation style.  Put\SpecialUsageIndex{\bibliographystyle}
486 % |\bibliographystyle{mlastyle}| in the document preamble to load the
487 % bibliography style.  Alternatively, the
488 % \OptionIndex{bibstyle}\Lopt{bibstyle} option can handle this
489 % automatically, loading a bibliography style of |mlastyle| in \Lopt{mla}
490 % and \Lopt{style} modes and a bibliography style of |plain| in
491 % \Lopt{format} and \Lopt{compat} modes.
492 %
493 % Use of \BibTeX{} is also beyond the scope of this document; consult
494 % Patashnik\citeC{btxdoc} for an introduction.
495 % Briefly, to use the following example, substitute
496 % |\bibliography|\marg{filename} for the |thebibliography| environment.
497 % Then create \meta{filename}\file{.bib} with the contents below.
498 % Generating the document entails running \file{latex} on the \file{.tex}
499 % file, \file{bibtex} on the resulting \file{.aux} file, then \file{latex}
500 % twice more.
501 %\begin{verbatim}
502 %@BOOK{latexdps,
503 %  AUTHOR = "Leslie Lamport",
504 %  TITLE = "{\LaTeX}: A Document Preparation System",
505 %  KEY = "{\LaTeX}",
506 %  EDITION = "Second",
507 %  ADDRESS = "Reading",
508 %  PUBLISHER = "Addison-Wesley",
509 %  YEAR = "1994"}\end{verbatim}
510 %
511 % In \package{mlastyle}, The |KEY| field serves the additional purpose of
512 % specifying an abbreviated title.  This is unnecessary in the above
513 % example.  If an additional book by Leslie Lamport was included, however,
514 % the |KEY| field would allow |\cite{latexdps}| to yield \examp{(Lamport,
515 % \emph{\LaTeX\/})} instead of \examp[.]{(Lamport, \emph{\LaTeX: A
516 % Doc\-um\-ent Pre\-pa\-ra\-tion Sys\-tem\/})}
517 %
518 % Note that only entries referenced by a citation are included in the list
519 % of works cited; to force the inclusion of an entry or all entries, use
520 % |\nocite|\marg{marker} and |\nocite{*}|, respectively.
521 %
522 % \StopEventually{\PrintChanges\bibliography{mlastyle}\PrintIndex}
523 %
524 % \section{Implementation}
525 %    \begin{macrocode}
526 %<*package>
527 %    \end{macrocode}
528 %
529 % \subsection{Options}
530 % \begin{macro}{\ifmlastyle@*}
531 % \begin{macro}{\mlastyle@*true}
532 % \begin{macro}{\mlastyle@*false}
533 % Most options are implemented by modifying a |\newif| declared for that
534 % purpose.
535 %    \begin{macrocode}
536 \newif\ifmlastyle@bibstyle
537 \DeclareOption{bibstyle}{\mlastyle@bibstyletrue}
538 \DeclareOption{nobibstyle}{\mlastyle@bibstylefalse}
539 \newif\ifmlastyle@papersize
540 \DeclareOption{papersize}{\mlastyle@papersizetrue}
541 \DeclareOption{nopapersize}{\mlastyle@papersizefalse}
542 \newif\ifmlastyle@underline
543 \DeclareOption{underline}{\mlastyle@underlinetrue}
544 \DeclareOption{italics}{\mlastyle@underlinefalse}
545 \newif\ifmlastyle@times
546 \DeclareOption{times}{\mlastyle@timestrue}
547 \DeclareOption{cm}{\mlastyle@timesfalse}
548 \newif\ifmlastyle@style
549 \DeclareOption{compat}{\mlastyle@stylefalse
550         \mlastyle@formatfalse
551         \mlastyle@underlinefalse}
552 \DeclareOption{mla}{\mlastyle@styletrue
553         \mlastyle@formattrue
554         \mlastyle@underlinetrue}
555 \newif\ifmlastyle@format
556 \DeclareOption{format}{\mlastyle@stylefalse
557         \mlastyle@formattrue
558         \mlastyle@underlinetrue}
559 \DeclareOption{style}{\mlastyle@styletrue
560         \mlastyle@formatfalse
561         \mlastyle@underlinefalse}
562 \DeclareOption{singlespacequotes}{
563   \def\mlastyle@qspread{\linespread{1}\selectfont\vskip\baselineskip}}
564 \DeclareOption{doublespacequotes}{\let\mlastyle@qspread\relax}
565 \ExecuteOptions{nobibstyle,nopapersize,mla,cm,doublespacequotes}
566 \ProcessOptions
567 %    \end{macrocode}
568 % \end{macro}
569 % \end{macro}
570 % \end{macro}
571 % If the \Lopt{papersize} option is set, add the appropriate
572 % \textsc{PostScript} special, or adjust |\pdfpagewidth| and
573 % |\pdfpageheight| if pdf\LaTeX{} is in use.
574 %    \begin{macrocode}
575 \ifmlastyle@papersize
576   \ifx\@undefined\pdfpagewidth
577     \special{papersize=\the\paperwidth,\the\paperheight}
578   \else
579     \setlength{\pdfpagewidth}{\paperwidth}
580     \setlength{\pdfpageheight}{\paperheight}
581   \fi
582 \fi % \ifmlastyle@papersize
583 %    \end{macrocode}
584 % \begin{macro}{\UL@onin}
585 % Load the \package{ulem} package if the \Lopt{underline} option is set.
586 % By default, \package{ulem} does multiple underlining for nested
587 % emphasis.  This is changed to MLA-style behavior with the redefinition
588 % of |\UL@onin|.
589 %    \begin{macrocode}
590 \ifmlastyle@underline
591   \RequirePackage{ulem}
592   \def\UL@onin#1{\egroup\UL@stop#1\UL@start}
593 \fi % \ifmlastyle@underline
594 %    \end{macrocode}
595 % \end{macro}
596 % Load the \package{times} package if the \Lopt{times} option is set.
597 %    \begin{macrocode}
598 \ifmlastyle@times
599   \RequirePackage{times}
600 \fi % \ifmlastyle@times
601 %    \end{macrocode}
602 % \subsection{Macros}
603 % \begin{macro}{\instructor}
604 % Define the instructor, along with an obsolete synonym.
605 %    \begin{macrocode}
606 \def\instructor#1{\gdef\mlastyle@instructor{#1}}
607 \let\professor\instructor
608 %    \end{macrocode}
609 % \end{macro}
610 % \begin{macro}{\course}
611 % Define the course, along with an obsolete synonym.
612 %    \begin{macrocode}
613 \def\course#1{\gdef\mlastyle@course{#1}}
614 \let\classname\course
615 %    \end{macrocode}
616 % \end{macro}
617 % \begin{macro}{\surname}
618 % Define the surname, along with an obsolete synonym.
619 %    \begin{macrocode}
620 \def\surname#1{\gdef\mlastyle@surname{#1}}
621 \def\mlastyle@surname{\def\ml@##1 ##2,##3@@{##2}%
622   \expandafter\ml@\@author, ,@@}
623 \let\lastname\surname
624 %    \end{macrocode}
625 % \end{macro}
626 % \subsection{Formatting}
627 % Formatting is done if the \Lopt{mla} or \Lopt{format} option is set.
628 %    \begin{macrocode}
629 \ifmlastyle@format
630 %    \end{macrocode}
631 % \begin{macro}{\mlastyle@i}
632 % This is the standard MLA format indent.
633 %    \begin{macrocode}
634   \newdimen\mlastyle@i \mlastyle@i=.5in
635 %    \end{macrocode}
636 % \end{macro}
637 % \subsubsection{Macros}
638 % \begin{macro}{\maketitle}
639 % |\maketitle| generates a heading in MLA format.
640 %    \begin{macrocode}
641   \renewcommand{\maketitle}{\begin{flushleft}
642     \@author\par
643     \@ifundefined{mlastyle@instructor}{}{\mlastyle@instructor}\par
644     \@ifundefined{mlastyle@course}{}{\mlastyle@course}\par
645     \@date\end{flushleft}
646     \begin{center}\@title\end{center}\par
647   }
648 %    \end{macrocode}
649 % \end{macro}
650 % \begin{macro}{\today}
651 % |\today| is redefined to DD~Mon.~YYYY format.
652 %    \begin{macrocode}
653 \def\today{\number\day~\ifcase\month\or
654   Jan.\or Feb.\or Mar.\or Apr.\or May\or June\or July\or 
655   Aug.\or Sept.\or Oct.\or Nov.\or Dec.\fi\ \number\year}
656 %    \end{macrocode}
657 % \end{macro}
658 % \begin{macro}{\slash}
659 % No penalty for |\slash|, and plain /'s permit line breaks if necessary.
660 % ^^A\let\mlastyle@sl@sh=/
661 %    \begin{macrocode}
662   \def\slash{/\penalty\z@}
663   \def\mlastyle@slash{/\futurelet\mlastyle@slashnext\mlastyle@slashx}
664   \def\mlastyle@slashx{\ifx\mlastyle@slashnext/\else
665     \penalty\exhyphenpenalty\fi}
666 %    \end{macrocode}
667 % \end{macro}
668 % \begin{macro}{\section}
669 % \begin{macro}{\subsection}
670 % \begin{macro}{\subsubsection}
671 % Sections are formatted by centering the section name and beginning a new
672 % page.  Subsections simply center the section name.
673 %    \begin{macrocode}
674   \renewcommand{\section}{\clearpage\@startsection{section}{1}{\z@
675     }{0pt}{1sp}{\centering}}
676   \renewcommand{\subsection}{\@startsection{subsection}{2}{\z@
677     }{0pt}{1sp}{\centering}}
678   \renewcommand{\subsubsection}{\@startsection{subsubsection}{3}{\z@
679     }{0pt}{1sp}{\centering}}
680 %    \end{macrocode}
681 % ^^A\let\mlastyle@vfont\verbatim@font
682 % ^^A\def\verbatim@font{\mlastyle@qspread\mlastyle@vfont}
683 % \end{macro}
684 % \end{macro}
685 % \end{macro}
686 % \subsubsection{Environments}
687 % ^^A%\newenvironment{blocks}{\begin{quote} \linespread{1} \selectfont}{\end{quote} \linespread{2} \small \selectfont}
688 % ^^A%\newenvironment{blockm}{\begin{quotation} \linespread{1} \selectfont}{\end{quotation} \linespread{2} \selectfont}
689 % \begin{environment}{verse}
690 % Indented 1 inch, with an additional .25 inch hanging indent.
691 %    \begin{macrocode}
692   \renewenvironment{verse}{\list{}{\mlastyle@qspread
693     \advance\leftmargin1.5\mlastyle@i\itemindent-.5\mlastyle@i
694     \listparindent\itemindent}\item\relax}{\endlist}
695 %    \end{macrocode}
696 % \end{environment}
697 % \begin{environment}{quotation}
698 % Indented 1 inch, with a paragraph indent of an additional .25 inches.
699 %    \begin{macrocode}
700   \renewenvironment{quotation}{\list{}{\mlastyle@qspread
701     \advance\leftmargin\mlastyle@i\itemindent.5\mlastyle@i
702     \listparindent\itemindent}\item\relax}{\endlist}
703 %    \end{macrocode}
704 % \end{environment}
705 % \begin{environment}{quote}
706 % Identical to the |quotation| environment, except the first paragraph is not
707 % indented.
708 %    \begin{macrocode}
709   \renewenvironment{quote}{\list{}{\mlastyle@qspread
710     \advance\leftmargin\mlastyle@i
711     \listparindent.5\mlastyle@i}\item\relax}{\endlist}
712 %    \end{macrocode}
713 % \end{environment}
714 % \begin{environment}{workscited}
715 % Works cited environment, for compatibility with \package{mla-paper}.
716 %    \begin{macrocode}
717   \newenvironment{workscited}%
718     {\newpage{\centerline{Works Cited}}}{\newpage}
719   \newcommand{\bibent}{\noindent \hangindent\mlastyle@i}
720 %    \end{macrocode}
721 % \end{environment}
722 % \subsubsection{Margins}
723 % Top and bottom margins are 1 inch each.  The header is flush with the
724 % right margin at .5 inches from the top of the page.
725 % ^^A\addtolength{\headheight}{-1pt}
726 % ^^A\setlength{\headheight}{1.4\headheight}% kludge
727 %    \begin{macrocode}
728   \addtolength{\voffset}{-.5in}
729   \setlength{\textheight}{\paperheight}
730   \addtolength{\textheight}{-2in}
731   \setlength{\topmargin}{0in}
732   \setlength\headheight\f@baselineskip
733   \setlength{\headsep}{.5in}
734   \addtolength{\headsep}{-\headheight}
735   \setlength{\footskip}{0.25in}
736   \raggedbottom
737 %    \end{macrocode}
738 % Left and right margins in MLA format are each 1 inch wide.
739 %    \begin{macrocode}
740   \addtolength{\hoffset}{-.5in}
741   \setlength{\textwidth}{\paperwidth}
742   \addtolength{\textwidth}{-2in}
743   \setlength{\oddsidemargin}{.5in}
744   \setlength{\evensidemargin}{.5in}
745   \setlength{\marginparwidth}{.5in}
746 %    \end{macrocode}
747 % \subsubsection{Paragraphs}
748 % Paragraphs should be left justified, with the first line indented .5
749 % inches.
750 %    \begin{macrocode}
751   \raggedright
752   \setlength\parindent\mlastyle@i
753 %    \end{macrocode}
754 % MLA format specifies that all paragraphs should be indented, even those
755 % beginning a new section.  This snippet from \package{indentfirst} changes
756 % \LaTeX{} to meet that requirement.
757 %    \begin{macrocode}
758   \let\@afterindentfalse\@afterindenttrue
759   \@afterindenttrue
760 %    \end{macrocode}
761 % Double space {\em everywhere}.
762 % ^^A\RequirePackage{doublespace}
763 %    \begin{macrocode}
764   \linespread{2.0}
765   \leftmargini\parindent
766   \def\@listi{\leftmargin\leftmargini
767   \parsep\z@\itemsep\z@\topsep -3\p@\relax}
768   \let\@listI\@listi
769   \@listi
770   \def\@listii{\leftmargin\leftmarginii
771   \parsep\z@\itemsep\z@\topsep -3\p@\relax}
772   \def\@listiii{\leftmargin\leftmarginiii
773   \parsep\z@\itemsep\z@\topsep -3\p@\relax}
774   \def\@listiv{\leftmargin\leftmarginiv
775   \parsep\z@\itemsep\z@\topsep -3\p@\relax}
776   \def\@listv{\leftmargin\leftmarginv
777   \parsep\z@\itemsep\z@\topsep -3\p@\relax}
778   \def\@listvi{\leftmargin\leftmarginvi
779   \parsep\z@\itemsep\z@\topsep -3\p@\relax}
780 %    \end{macrocode}
781 % Only one space after colons.
782 %    \begin{macrocode}
783 \ifnum\the\sfcode`\:=2000
784   \sfcode`\:=1999
785 \fi
786 %    \end{macrocode}
787 % \subsubsection{Header}
788 % The last name and page number appear on every page, including the first.
789 %    \begin{macrocode}
790   \RequirePackage{fancyhdr}
791   \fancypagestyle{plain}{\fancyhf{}}
792   \fancypagestyle{mlastyle}{
793     \fancyhf{}
794     \rhead{\mlastyle@surname{} \thepage}
795     \renewcommand{\headrulewidth}{0pt}
796     \renewcommand{\footrulewidth}{0pt}}
797   \pagestyle{mlastyle}
798 %    \end{macrocode}
799 % \subsubsection{Notes}
800 % Footnotes should be indented .5 inches; however .56 inches is used
801 % in a crude attempt to compensate for
802 % the alignment provided by the \package{footmisc} package.  Endnotes are
803 % preferred in MLA style anyway, so this should not be a problem in most
804 % circumstances.
805 %    \begin{macrocode}
806   \RequirePackage[ragged,norule]{footmisc}
807   \def\footnotelayout{\linespread{1}\footnotesize\raggedright{} }
808   \footnotemargin\mlastyle@i
809   \advance\footnotemargin .35em
810   \skip\footins=2\baselineskip
811   \footnotesep 1.2\footnotesep
812   \addtolength\footnotesep{\baselineskip}
813   \def\footnotesize{\normalsize}
814 %    \end{macrocode}
815 % ^^A\let\footnoterule\relax
816 % Endnotes are supported, but only if the \package{endnotes} package is
817 % loaded {\em before\/} this package.
818 %    \begin{macrocode}
819   \ifx\@undefined\endnote\else
820     \def\enoteheading{\newpage\section*{\notesname}}
821     \def\enoteformat{\leavevmode\makeenmark{} }
822     \def\enotesize{\normalsize}
823   \fi
824 %    \end{macrocode}
825 % \subsubsection{Bibliography}
826 % \begin{environment}{thebibliography}
827 % The definition of |\thebibliography| varies depending on the document
828 % class.
829 %    \begin{macrocode}
830 \ifx\@undefined\url{
831   \catcode`/=13
832     \gdef\url{\bgroup\catcode`/=13
833     \let/\slash\mlastyle@url}
834     \gdef\mlastyle@url#1{#1\egroup}
835 }\fi
836 \ifx\@undefined\citet
837   \@ifundefined{chapter}
838 %    \end{macrocode}
839 % Article class.
840 %    \begin{macrocode}
841   { \def\thebibliography#1{\newpage\section*{\refname}
842       \list{\@biblabel{\@arabic\c@enumiv}}%
843         {\settowidth\labelwidth{\@biblabel{#1}}}
844         \leftmargin\labelwidth
845         \advance\leftmargin\labelsep
846         \itemindent-\leftmargin
847         \def\newblock{}
848         \usecounter{enumiv}
849         \sloppy%\sfcode`\.=\@m
850       }}
851 %    \end{macrocode}
852 % Report/book class.
853 %    \begin{macrocode}
854   { \def\thebibliography#1{\chapter*{\bibname}
855       \list{\@biblabel{\@arabic\c@enumiv}}%
856         {\settowidth\labelwidth{\@biblabel{#1}}}
857         \leftmargin\labelwidth
858         \advance\leftmargin\labelsep
859         \itemindent-\leftmargin
860         \def\newblock{}
861         \usecounter{enumiv}
862         \sloppy%\sfcode`\.=\@m
863       }}
864 %    \end{macrocode}
865 % \end{environment}
866 % \subsubsection{Experimental \package{natbib} Implementation}
867 %    \begin{macrocode}
868 \else
869   \newcommand\bibpreamble{%
870     \@ifundefined{citet}{}%
871     {\bibhang\mlastyle@i\bibsep\z@}}
872 \fi
873 %    \end{macrocode}
874 %    \begin{macrocode}
875 \fi % \ifmlastyle@format
876 %    \end{macrocode}
877 % \subsection{Style}
878 % \begin{macro}{\bibstyle@mlastyle}
879 % This first block is the beginnings of an implementation for
880 % \package{natbib}.  Surely there is a better way.
881 %    \begin{macrocode}
882 \newcommand{\bibstyle@mlastyle}{%
883   \bibpunct[\mlastyle@space]{\mlastyle@brack(}{\mlastyle@brack)}%
884     {;}{a}{\mlastyle@comma}{,}
885   \gdef\mlastyle@brack##1{\ifx\NAT@date\mlastyle@notitle
886     \ifmlastyle@pages ##1\else\ifNAT@swa\ifnum
887     \NAT@ctype=0 ##1\else\unskip\fi\else\unskip\fi\fi\else ##1\fi}
888   \gdef\mlastyle@comma{\ifx\NAT@date\mlastyle@notitle\else,\fi}
889   \gdef\mlastyle@space{\ifx\NAT@date\mlastyle@notitle{}\else{} \fi}
890   \gdef\mlastyle@space{\ifx\NAT@date\mlastyle@notitle
891     \ifnum\NAT@ctype<2
892       \ifNAT@par\ifNAT@swa{} \fi\else{} \fi\fi\else{} \fi}
893     \gdef\citetext##1{(##1)}
894   \@ifundefined{chapter}
895   {\gdef\refname{Works Cited}}
896   {\gdef\bibname{Works Cited}}}
897 %    \end{macrocode}
898 % \end{macro}
899 % \begin{macro}{\mlastyle@notitle}
900 % This hack represents an empty title in the MLA bibliography style.
901 %    \begin{macrocode}
902 \def\mlastyle@notitle
903   { \ \ \ \ \unskip\unskip\unskip\unskip\unskip\unskip}
904 \RequirePackage{natbib}
905 \newif\ifmlastyle@pages
906 \renewcommand\NAT@citetp
907 {\@ifnextchar[{\mlastyle@pagestrue\NAT@@citetp}%
908   {\mlastyle@pagesfalse\NAT@@citetp[]}}
909 %    \end{macrocode}
910 %\end{macro}
911 % \begin{macro}{\cite}
912 % \begin{macro}{\citealp}
913 % ^^A\begin{macro}{\citepage}
914 % ^^A\begin{macro}{\citequote}
915 % The following macros, combined with \file{mlastyle.bst}, provide
916 % for a bibliography in MLA style.  Note that the definition of |\cite|,
917 % |\citealp|, etc.\ vary depending on the options passed to
918 % \package{mlastyle}.
919 %
920 % \begin{macro}{\mlastyle@intcite}
921 % The original |\cite| is stored
922 % in |\mlastyle@intcite|.
923 %    \begin{macrocode}
924 %\let\mlastyle@intcite\cite
925 %    \end{macrocode}
926 % \end{macro}
927 % \begin{macro}{\mlastyle@relax}
928 % This macro does nothing.  Depending on the options, either |\citeC| or
929 % |\citeM| and its ilk will utilize it.
930 %    \begin{macrocode}
931 \newcommand{\mlastyle@relax}[2][]{\unskip}
932 %    \end{macrocode}
933 % \end{macro}
934 % \subsubsection{MLA Style}
935 % \begin{macro}{\citeM}
936 % If the \Lopt{mla} or \Lopt{style} options are used, the following is
937 % executed.
938 %    \begin{macrocode}
939 \ifmlastyle@style
940 % If the \Lopt{bibstyle} option is set, specify the bibliography style.
941 %    \begin{macrocode}
942   \ifmlastyle@bibstyle
943     \bibliographystyle{mlastyle}
944   \fi
945 %    \end{macrocode}
946 % \end{macro}
947 %    \begin{macrocode}
948   \let\cite\citep
949   \newcommand\citepage[2][]{\citeyearpar[#1]{#2}}
950   \newcommand\citepageM[2][]{\unskip{} \citeyearpar[#1]{#2}}
951   \newcommand\citeindirect[2][]{\citep[qtd.\ in][#1]{#2}}
952   \newcommand\citeindirectM[2][]{\unskip{} \citep[qtd.\ in][#1]{#2}}
953   \let\citeN\citealp
954   \let\citeC\mlastyle@relax
955 %    \end{macrocode}
956 %
957 % ^^A% Define the command \workscited{bib}{style}{nocite}
958 % ^^A%\newcommand{\workscited}[3]{%
959 % ^^A%  \ifx\chapter\@undefined%
960 % ^^A%    \addcontentsline{toc}{chapter}{\bfseries\bibname}% report style
961 % ^^A%  \else
962 % ^^A%    \addcontentsline{toc}{section}{\bfseries\refname}% article style
963 % ^^A%  \fi
964 % ^^A%  \bibliography{#1}\bibliographystyle{#2}\nocite{#3}}
965 % ^^A% \fi
966 % ^^A\newcommand{\annote}[1]{\begin{list}{}{%
967 % ^^A                \setlength{\labelwidth}{0pt}
968 % ^^A                \addtolength{\leftmargin}{\parindent}
969 % ^^A                \setlength{\labelsep}{0pt}}%
970 % ^^A                \item #1 \end{list}}
971 % \subsubsection{Plain Style}
972 % \begin{macro}{\citeC}
973 % This next block is used if the \Lopt{compat} or \Lopt{format} option is
974 % set.
975 %    \begin{macrocode}
976 \else
977 %    \end{macrocode}
978 % If the \Lopt{bibstyle} option is set, specify the bibliography style.
979 %    \begin{macrocode}
980   \ifmlastyle@bibstyle
981     \bibliographystyle{plain}
982   \fi
983   \ifx\@undefined\citet
984     \newcommand{\mlastyle@cite}[2][]{\@tempswafalse\@citex[]{#2}}
985     \newcommand{\citeC}[2][]{~\@tempswafalse\@citex[]{#2}}
986   \else
987     \newcommand{\mlastyle@cite}[2][]{\citep[]{#2}}
988     \def\citeC{ \citep}
989   \fi
990   \let\cite\mlastyle@cite
991   \let\citepage\mlastyle@cite
992   \let\citeindirect\mlastyle@cite
993   \let\citeM\mlastyle@relax
994   \let\citepageM\mlastyle@relax
995   \let\citeindirectM\mlastyle@relax
996 \fi
997 %    \end{macrocode}
998 % \end{macro}
999 %
1000 % ^^A\end{macro}
1001 % ^^A\end{macro}
1002 % \end{macro}
1003 % \end{macro}
1004 %    \begin{macrocode}
1005 %</package>
1006 %    \end{macrocode}
1007 %
1008 % \Finale
1009 \endinput
1010 % vim:tw=74