Accommodated embedded bibliography

[latex-mlastyle.git] / mlastyle.dtx

diff --git a/mlastyle.dtx b/mlastyle.dtx
index 94ea8092c0d1dfce0d80da8d3dded9a630922ad2..8d84354c840a64f95aed4d52dfef72ff26517574 100644 (file)
--- a/mlastyle.dtx
+++ b/mlastyle.dtx
@@ -21,6 +21,25 @@
 %<package>   [2003/11/09 v0.9 MLA format and documentation style]
 %
 %<*driver>
+\begin{filecontents}{mlastyle.bib}
+@BOOK{handbook,
+  AUTHOR = "Joseph Gibaldi",
+  TITLE = "MLA Handbook for Writers of Research Papers",
+  TITLE = "MLA Handbook",
+  EDITION = "Sixth",
+  ADDRESS = "New York",
+  PUBLISHER = "MLA",
+  YEAR = "2003"}
+
+@BOOK{latex,
+  AUTHOR = "Leslie Lamport",
+  TITLE = "\LaTeX: A Document Preparation System",
+  KEY = "\LaTeX",
+  EDITION = "Second",
+  ADDRESS = "Reading",
+  PUBLISHER = "Addison-Wesley",
+  YEAR = "1994"}
+\end{filecontents}
 \documentclass[draft]{ltxdoc}
 \iffalse
   \usepackage[mla]{mlastyle}
@@ -123,6 +142,7 @@
 % \DoNotIndex{\def}
 % \DoNotIndex{\do}
 % \DoNotIndex{\edef}
+% \DoNotIndex{\egroup}
 % \DoNotIndex{\else}
 % \DoNotIndex{\end}
 % \DoNotIndex{\endcsname}
@@ -264,9 +284,9 @@
 %
 % \section{Introduction}
 %
-% ^^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
+% ^^A MLA style, consisting of a set of documentation conventions, has
+% ^^A gained 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
@@ -288,7 +308,7 @@
 %\instructor{Professor Smith}
 %\course{English 101}
 %\date{1~Jan.\ 1970}
-%\title{The Inherent Sadism of Compulsory English Classes}
+%\title{The Sadism Inherent in Compulsory English Classes}
 %
 %\begin{document}
 %\maketitle
@@ -386,7 +406,6 @@
 %\newblock Reading: Addison-Wesley, 1994.
 %
 %\end{thebibliography}\end{verbatim}
-%
 % In this example, |Lamport| is the author's last name (for use in
 % citations) and |latex| is the marker used to reference it (see
 % section~\ref{sec:parenthetical}).
@@ -446,13 +465,18 @@
 %  ADDRESS = "Reading",
 %  PUBLISHER = "Addison-Wesley",
 %  YEAR = "1994"}\end{verbatim}
+%
 % In \package{mlastyle}, The |KEY| field serves the additional purpose of
 % specifying an abbreviated title.  This is unnecessary in the above
 % example.  If an additional book by Leslie Lamport was included, however,
-% the |KEY| field would allow |\cite{lamport}| to yield \examp{(Lamport,
+% the |KEY| field would allow |\cite{latex}| to yield \examp{(Lamport,
 % \emph{\LaTeX\/})} instead of \examp[.]{(Lamport, \emph{\LaTeX: A Document
 % Preparation System\/})}
 %
+% Note that only entries referenced by a citation are included in the list
+% of works cited; to force the inclusion of an entry or all entries, use
+% |\nocite|\marg{marker} and |\nocite{*}|, respectively.
+%
 % \StopEventually{\PrintChanges\bibliography{mlastyle}\PrintIndex}
 %
 % \section{Implementation}
@@ -604,6 +628,7 @@
 % \end{macro}
 % \begin{macro}{\section}
 % \begin{macro}{\subsection}
+% \begin{macro}{\subsubsection}
 % Sections are formatted by centering the section name and beginning a new
 % page.  Subsections simply center the section name.
 %    \begin{macrocode}
@@ -618,6 +643,7 @@
 % ^^A\def\verbatim@font{\mlastyle@qspread\mlastyle@vfont}
 % \end{macro}
 % \end{macro}
+% \end{macro}
 % \subsubsection{Environments}
 % ^^A%\newenvironment{blocks}{\begin{quote} \linespread{1} \selectfont}{\end{quote} \linespread{2} \small \selectfont}
 % ^^A%\newenvironment{blockm}{\begin{quotation} \linespread{1} \selectfont}{\end{quotation} \linespread{2} \selectfont}
@@ -812,6 +838,7 @@
 %    \end{macrocode}
 % \end{macro}
 % \subsubsection{MLA Style}
+% \begin{macro}{\@cite}
 % \begin{macro}{\citeM}
 % If the \Lopt{mla} or \Lopt{style} options are used, the following is
 % executed.
@@ -834,6 +861,7 @@
   \let\citeC\mlastyle@relax
 %    \end{macrocode}
 % \end{macro}
+% \end{macro}
 % \iffalse
 % Place commas in-between citations in the same |\citeyear|, |\citeyearNP|,
 % |\citeN|, or |\shortciteN| command.