Wrote documentation, added citations

diff --git a/mlastyle.dtx b/mlastyle.dtx
index d70be821ebcb279f81b6b69bb529b8e8f60ecb3c..bec1cf2678255de2b4a2d58ed2be70c276e7d68c 100644 (file)
--- a/mlastyle.dtx
+++ b/mlastyle.dtx
@@ -22,18 +22,20 @@
 %
 %<*driver>
 \documentclass[draft]{ltxdoc}
-\iftrue
+\iffalse
+  \usepackage[mla]{mlastyle}
+  \bibliographystyle{mlastyle}
+  \addtolength{\marginparwidth}{1in}
+  \addtolength{\textwidth}{-1in}
+  \addtolength{\headwidth}{-1in}
+\else
   \usepackage[compat]{mlastyle}
+  \bibliographystyle{plain}
   \addtolength{\headsep}{-5pt}
   %\addtolength{\headheight}{-12pt}
   \addtolength{\topmargin}{-17pt}
   \addtolength{\textheight}{22pt}
   \IfFileExists{ulem.sty}{\usepackage[normalem]{ulem}}{\let\uline\emph}
-\else
-  \usepackage[mla]{mlastyle}
-  \addtolength{\marginparwidth}{1in}
-  \addtolength{\textwidth}{-1in}
-  \addtolength{\headwidth}{-1in}
 \fi
 \IfFileExists{times.sty}%
 {\newcommand{\examp}[2][]{{\let\emph\uline\fontfamily{ptm}\selectfont##2}##1}}%
@@ -257,12 +259,19 @@
 % \surname{Pope}
 %
 % \maketitle
+%
 % \tableofcontents
 %
 % \section{Introduction}
 %
-% MLA style, consisting of a set of documentation conventions, has
-% gained widespread acceptance in the humanities.  \LaTeX{} is a
+% ^^AMLA style, consisting of a set of documentation conventions, has
+% ^^Agained widespread acceptance in the humanities.
+% According to The {\em MLA Handbook for Writers of Research
+% Papers}\citeC{handbook}, MLA style is a set of ``commonly agreed-on
+% rules for documenting quotations, facts, opinions and paraphrases'' that
+% ``is preferred by a substantial majority of scholarly journals in
+% language and literature{\makeatletter\ifmlastyle@style
+% .''\citeM[xvi]{handbook}\else.''\fi} \LaTeX{} is a
 % document preparation system enjoying popularity in the scientific field.
 % It should come as no surprise that complete, up-to-date implementations
 % of MLA style for \LaTeX{} are in short supply.  The \LaTeX{} package
@@ -340,9 +349,10 @@
 % \package{mlastyle}.
 %
 % \subsubsection{Italics vs.\ Underlining} \index{underlining|usage}
-% \index{italics|usage}
-% MLA format dictates that emphasis should be indicated by underlining the
-% text.  Thus, the \package{ulem} package, which underlines all emphasized
+% \index{italics|usage}\label{sec:italics}
+% The {\em MLA Handbook\/}\citeC{handbook} dictates that emphasis should
+% be indicated by underlining the text\citeM[94]{handbook}.  Thus, the
+% \package{ulem} package, which underlines all emphasized
 % text, is loaded by default in \Lopt{mla} and \Lopt{format} modes.  To
 % disable this, use the \OptionIndex{italics}\Lopt{italics} option.
 % Conversely, if underlining is desired in \Lopt{style} or \Lopt{compat}
@@ -400,12 +410,13 @@
 % Three additional citation commands are provided, all of which take the
 % same arguments as |\cite|.  To omit the author information from the
 % citation, use \DescribeMacro{\citepage}|\citepage|.  Indirect
-% citations---those of the format \examp{(qtd. in Brown 6)}---can be
+% citations---those of the format \examp{(qtd. in Pope
+% \pageref{sec:italics})}---can be
 % created with \DescribeMacro{\citeindirect}|\citeindirect|.  Finally, the
 % parentheses are omitted by \DescribeMacro{\citeN}|\citeN|.  This was
 % intended for use in cross references, but it can also help in citing
 % multiple works.  The result of
-% |(\citeN[42]{knuth}|\texttt{; }|\citeN[69]{lamport})|
+% |(\citeN[42]{texbook}|\texttt{; }|\citeN[69]{latex})|
 % would be something like \examp[.]{(Knuth 42; Lamport 69)}
 %
 % \subsubsection{Using {\rm \BibTeX}} \label{sec:bibtex}
@@ -442,7 +453,7 @@
 % \emph{\LaTeX\/})} instead of \examp[.]{(Lamport, \emph{\LaTeX: A Document
 % Preparation System\/})}
 %
-% \StopEventually{\PrintChanges\PrintIndex}
+% \StopEventually{\PrintChanges\bibliography{mlastyle}\PrintIndex}
 %
 % \section{Implementation}
 %    \begin{macrocode}