Changed TITLE to KEY in handbook

[latex-mlastyle.git] / mlastyle.dtx

diff --git a/mlastyle.dtx b/mlastyle.dtx
index d6566af6307128bfa527d2948651cabd3362ce72..573dab48c84453d810dcd5f5cb3a5f8b4a5e4f04 100644 (file)
--- a/mlastyle.dtx
+++ b/mlastyle.dtx
@@ -21,6 +21,35 @@
 %<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",
+  KEY = "MLA Handbook",
+  EDITION = "Sixth",
+  ADDRESS = "New York",
+  PUBLISHER = "MLA",
+  YEAR = "2003"}
+
+@BOOK{latexdps,
+  AUTHOR = "Leslie Lamport",
+  TITLE = "\LaTeX: A Document Preparation System",
+  KEY = "\LaTeX",
+  EDITION = "Second",
+  ADDRESS = "Reading",
+  PUBLISHER = "Addison-Wesley",
+  YEAR = "1994"}
+
+@MANUAL{lshort,
+  author  = {Tobias Oetker and Hubert Partl and Irene Hyna and Elisabeth 
+Schlegl},
+  title   = {The Not So Short Introduction to {\LaTeXe}},
+  year    = 2000,
+  month   = "11~"#dec,
+  version = {4.0},
+  url     = {CTAN://info/lshort/}
+}
+\end{filecontents}
 \documentclass[draft]{ltxdoc}
 \iffalse
   \usepackage[mla]{mlastyle}
@@ -106,6 +135,7 @@
 % \DoNotIndex{\G@refundefinedtrue}
 % \DoNotIndex{\ProcessOptions}
 % \DoNotIndex{\RequirePackage}
+% \DoNotIndex{\UL@start,\UL@stop}
 % \DoNotIndex{\addtolength}
 % \DoNotIndex{\advance}
 % \DoNotIndex{\baselineskip}
@@ -289,7 +319,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
@@ -380,14 +410,13 @@
 %\begin{verbatim}
 %\begin{thebibliography}{}
 %
-%\bibitem[Lamport]{latex}
+%\bibitem[Lamport]{latexdps}
 %Lamport, Leslie.
 %\newblock {\em \LaTeX: A Document Preparation System}.
 %\newblock 2nd.~ed.
 %\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}).
@@ -417,7 +446,7 @@
 % 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]{texbook}|\texttt{; }|\citeN[69]{latex})|
+% |(\citeN[42]{texbook}|\texttt{; }|\citeN[69]{latexdps})|
 % would be something like \examp[.]{(Knuth 42; Lamport 69)}
 %
 % \subsubsection{Using {\rm \BibTeX}} \label{sec:bibtex}
@@ -439,7 +468,7 @@
 % file, \file{bibtex} on the resulting \file{.aux} file, then \file{latex}
 % twice more.
 %\begin{verbatim}
-%@BOOK{latex,
+%@BOOK{latexdps,
 %  AUTHOR = "Leslie Lamport",
 %  TITLE = "\LaTeX: A Document Preparation System",
 %  KEY = "\LaTeX",
@@ -447,12 +476,17 @@
 %  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,
-% \emph{\LaTeX\/})} instead of \examp[.]{(Lamport, \emph{\LaTeX: A Document
-% Preparation System\/})}
+% the |KEY| field would allow |\cite{latexdps}| to yield \examp{(Lamport,
+% \emph{\LaTeX\/})} instead of \examp[.]{(Lamport, \emph{\LaTeX: A
+% Doc\-um\-ent Pre\-pa\-ra\-tion Sys\-tem\/})}
+%
+% 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}
 %
@@ -764,27 +798,29 @@
 %    \begin{macrocode}
   { \def\thebibliography#1{\newpage\section*{\refname}
       \list{\@biblabel{\@arabic\c@enumiv}}%
-      {\settowidth\labelwidth{\@biblabel{#1}}}
-      \leftmargin\labelwidth
-      \advance\leftmargin\labelsep
-      \itemindent-\leftmargin
-      \def\newblock{}
-      \usecounter{enumiv}
-      \sloppy%\sfcode`\.=1000\relax
-      \catcode`/=13\let/=\mlastyle@slash}}
+        {\settowidth\labelwidth{\@biblabel{#1}}}
+        \leftmargin\labelwidth
+        \advance\leftmargin\labelsep
+        \itemindent-\leftmargin
+        \def\newblock{}
+        \usecounter{enumiv}
+        %\catcode`\/=13\global\let/=\mlastyle@slash
+        \sloppy%\sfcode`\.=\@m
+      }}
 %    \end{macrocode}
 % Report/book class.
 %    \begin{macrocode}
   { \def\thebibliography#1{\chapter*{\bibname}
       \list{\@biblabel{\@arabic\c@enumiv}}%
-      {\settowidth\labelwidth{\@biblabel{#1}}}
-      \leftmargin\labelwidth
-      \advance\leftmargin\labelsep
-      \itemindent-\leftmargin
-      \def\newblock{}
-      \usecounter{enumiv}
-      \sloppy%\sfcode`\.=1000\relax
-      \catcode`/=13\let/=\mlastyle@slash}}
+        {\settowidth\labelwidth{\@biblabel{#1}}}
+        \leftmargin\labelwidth
+        \advance\leftmargin\labelsep
+        \itemindent-\leftmargin
+        \def\newblock{}
+        \usecounter{enumiv}
+        %\catcode`/=13\let/=\mlastyle@slash
+        \sloppy%\sfcode`\.=\@m
+      }}
 %    \end{macrocode}
 % \end{environment}
 %    \begin{macrocode}