path: root/Master/texmf-dist/doc/latex/harvard/harvard.tex

% Copyright 1994 Peter Williams.
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
% 
% The Current Maintainers of this work are Peter Williams and Thorsten Schnier.
%
% This work consists of all files listed in manifest.txt.
%
% Licence and copyright notice added on behalf of Peter Williams and Thorsten Schnier
% by Clea F. Rees 2009/01/30.
\begin{filecontents}{bibtexlogo.sty}
\def\lowBibTeX{{\reset@font\rmfamily B\kern-.05em%
    \raise.0ex\hbox{\scshape i\kern-.025em b}\kern-.08em%
    T\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}}
\def\BibTeX{\protect\lowBibTeX}
\end{filecontents}
\documentclass[a4paper]{article}
\usepackage{harvard}
\usepackage{bibtexlogo}

\newcommand{\comname}[1]{{\bf $\backslash$#1}}
\newcommand{\keyword}[1]{{\bf #1}}
\newcommand{\varname}[1]{{\em #1}}
\newcommand{\harvard}{{\sf harvard}}
\newcommand{\Harvard}{{\sf Harvard}}

\title{The \Harvard\ Family of Bibliography Styles}
\author{Peter Williams \\ (pwil3058@bigpond.net.au) \and
Thorsten Schnier \\ (thorsten@archsci.arch.su.edu.au)}

\hyphenation{cite-as-noun poss-ess-ive-cite cit-at-ion-mode cite-year
cite-name bib-lio-gr-aphy-sty-le cit-at-ion-sty-le har-vard-par-en-this
har-vard-year-par-en-this har-vard-item bib-item har-vard-and use-pack-age}

\begin{document}
\bibliographystyle{agsm}
\maketitle
\tableofcontents

\section{Introduction}

This document describes the \harvard\ family of bibliographic styles which
are provided in addition to those described in \citeasnoun{latex} and \citeasnoun{btxdoc}.
This style is primarily intended for use with the \BibTeX\ bibliographic
database management system.
However, provision is also made for hand coding of bibliographies.

\section{Citations}

\subsection{Complete Citations}

There are two primary forms of citation in the \harvard\ style dependent
upon whether the reference is used as a noun or parenthetically.
Additionally, where there are more than two authors, all authors are listed in
the first citation and in subsequent citations just the first author's name
followed by `et al.' is used.
The following example from \citeasnoun{agsm}\ illustrates these points.
\begin{quote}
The major improvement concerns the structure of the interview
(Ulrich~\& Trumbo~1965, p.~112) \ldots .
Later reports (Carlson, Thayer, Mayfield~\& Peterson 1971) record greatly 
increased interviewer reliability for structured interviews.
Wright (1969, p.~408) comments that `undoubtedly interviewer skill is
directly related to the validity, quantity and quality of the interview output',
and this would suggest some sort of interviewer training is called for.
Rowe (1960), for example, found that trained interviewers are better able to
evaluate applicants with some measure of reliability.
In addition Wexley, Sanders~\& Yukl (1973) showed that by extensive interviewer
training all significant contrast effects could be eliminated.
The results of the 1971 study (Carlson et al. 1971) are still relevant, but
efforts to~\ldots.
\end{quote}

To facilitate using a citation as a noun a new command
\comname{citeasnoun} has been created which has the same syntax as the
\comname{cite} command except that multiple citations are {\em not}
permitted.
The effect of this command is that
\begin{verbatim}
As \citeasnoun{btxdoc} and \citeasnoun[Annex~B]{latex} describe \ldots
\end{verbatim}
produces
\begin{quote}
As \citeasnoun{btxdoc} and \citeasnoun[Annex~B]{latex} describe \ldots
\end{quote}
whereas
\begin{verbatim}
The \BibTeX\ \cite{btxdoc} and \LaTeX\ \cite[Annex~B]{latex} manuals \ldots
\end{verbatim}
produces
\begin{quote}
The \BibTeX\ \cite{btxdoc} and \LaTeX\ \cite[Annex~B]{latex} manuals \ldots
\end{quote}
A second new command \comname{possessivecite} is provided for those
instances where it is desired to use the citation as a possessive noun phrase.
This is a variation on the \comname{citeasnoun} command and
multiple citations are not permitted.
As an example of its use
\begin{verbatim}
\possessivecite{latex} description of this feature is \ldots
\end{verbatim}
produces
\begin{quote}
\possessivecite{latex} description of this feature is \ldots
\end{quote}
A third new command \comname{citeaffixed} allows text to be affixed
inside the beginning of the parenthesis of a parenthetical citation.
This command is like the the \comname{cite} command except that it
takes a second argument -- the text to be affixed after the opening 
parenthesis.
For example
\begin{verbatim}
\BibTeX\ manuals \citeaffixed{latex,btxdoc}{e.g.} describe \ldots
\end{verbatim}
produces
\begin{quote}
\BibTeX\ manuals \citeaffixed{latex,btxdoc}{e.g.} describe \ldots
\end{quote}

\subsection{Citation Modes}

By default,
where appropriate, citations are abbreviated automatically after the first
reference when bibliographies are produced by \BibTeX.
Provision is also made for this feature to be accessed during manual coding.
This feature may be overridden by using the \comname{citationmode}
command which takes \keyword{full}, \keyword{abbr} or \keyword{default} as its single
argument.
The command \comname{citationmode\{full\}} makes the system use
full citations, \comname{citationmode\{abbr\}} makes the system use
abbreviated citations and \comname{citationmode\{default\}} causes
the default behaviour of using full citations for the first instance and
abbreviated citations thereafter.

Alternatively, the citation mode may be selected as an
\keyword{full}, \keyword{abbr} or \keyword{default}
option to the
\comname{usepackage} command that invokes the \harvard\ package.
Use of the \keyword{default} option is redundant in that, if no citation
mode option is used, that mode will be selected automatically.

\subsection{Partial Citations}

In addition to the primary forms of citation, the citation commands
\comname{citeyear} and \comname{citename} are provided as building blocks
for more complex citations that authors may (from time to time) require.
\comname{citeyear} behaves like the
\comname{cite} command except that only the year portion of the
citation label is used.
For example,
\begin{verbatim}
\citeyear{btxdoc,latex}
\end{verbatim}
produces \citeyear{btxdoc,latex}.
The parenthesis around the year list may be omitted by modifying the command
name with a single asterisk (e.g. \verb+\citeyear*{btxdoc}+).
\comname{citename} behaves like the
\comname{citeasnoun} command except that only the author name(s)
portion of the citation label is used.
For example,
\begin{verbatim}
\citename{btxdoc}
\end{verbatim}
produces
\begin{quote}
\citename{btxdoc}.
\end{quote}
The use of these commands does not trigger the use of abbreviated citations for
subsequent \comname{citeasnoun} and \comname{cite}
references.

\subsection{Exceptions for Individual Citations}

Occasions arise where an author wishes to override the default behaviour for
an individual citation (e.g. she may wish the citation to use the full list
of authors where the default would use the abbreviated form).
All commands that introduce authors' names into a document (i.e.
\comname{cite}, \comname{citeasnoun}, \comname{citeaffixed},
\comname{possesivcite} and \comname{citename}) may be modified with the
addition of a single asterisk in order to force them to use the full
list of authors names and by a double asterisk to force them to use the
abbreviated form.

\section{Styles}
\subsection{Bibliography Styles}
There are six bibliography styles currently available within the
\harvard\ family, \keyword{agsm} (used in this document) which is based on 
\citeasnoun[pp.~95--98]{agsm}, \keyword{dcu}
which is based upon the conventions in use in the Design Computing Unit,
Department of Architectural and Design Science, University of Sydney,
\keyword{jmr} for the Journal of Management Research,
\keyword{jphysicsB} for the Journal of Physics B,
\keyword{kluwer} which aspires to conform to the requirements of Kluwer Academic
Publishers and \keyword{nederlands} which conforms to Dutch conventions.
They are invoked by the \comname{bibliographystyle} as described in
\citeasnoun[p.~74]{latex} and effect the layout of the entries in the bibliography.

Provided there is no name clash with other \harvard\ options the
bibliography style may be selected by passing it as an option to the
\comname{usepackage} command that invokes the \harvard\ package.

\subsection{Citation Styles}
There are two citation styles currently available within the \harvard\ 
family, \keyword{agsm} (used in this document) and \keyword{dcu} which for the previous
example would produce:
\begin{quote}\citationstyle{dcu}
The \BibTeX\ \cite{btxdoc} and \LaTeX\ \cite[Annex~B]{latex} manuals \ldots
\end{quote}
and for multiple citations such as
\begin{verbatim}
  The original documentation \cite{btxdoc,latex} say \ldots
\end{verbatim}
the \keyword{agsm} citation style produces
\begin{quote}\citationstyle{agsm}
The original documentation \cite{btxdoc,latex} say \ldots
\end{quote}
and the \keyword{dcu} citation style produces
\begin{quote}\citationstyle{dcu}
The original documentation \cite{btxdoc,latex} say \ldots
\end{quote}
The default citation style is \keyword{agsm} and both styles have no effect on the
appearance of the \comname{citeasnoun} citation format.

These styles are invoked by the \comname{citationstyle} command,
for example:
\begin{verbatim}
  \citationstyle{agsm}.
\end{verbatim}
Because these styles affect the format of parenthetical citations, this command 
should appear before any \comname{cite} commands.
Additionally the
citation style may be selected by passing an option to the
\comname{usepackage} command that invokes the \harvard\ package.
In order to avoid name clashes with the \keyword{agsm} and \keyword{dcu}
bibliography styles the options \keyword{agsmcite} and \keyword{dcucite} are
used with the \comname{usepackage} command in order to select \keyword{agsm}
and \keyword{dcu} citation modes respectively.

\subsection{Parenthesis Style}
The type of parenthesis used in citations may be set using the
\comname{harvardparenthesis}
command which takes one argument.
The argument to this command must be one of
\keyword{round}, \keyword{curly}, \keyword{angle}, \keyword{square} or
\keyword{none}.
The default value is \keyword{round}.
If it is a requirement that different parenthesis types are required for
parenthetical cites that for the year portion for a \comname{citeasnoun}
citation then the command \comname{harvardyearparenthesis} may be
used to set the year parenthesis seperately.
This command must be issued after any \comname{harvardparenthesis} command
as that command sets both parenthetical and year parenthesis.
If the bibliographic style chosen is \keyword{agsm} or \keyword{dcu} then the parenthesis
style chosen using \comname{harvardyearparenthesis} is used with the
year portion of the entries in the bibliographic listing.
The options \keyword{round}, \keyword{curly}, \keyword{angle}, \keyword{square}
and \keyword{none} may also be used with the the \comname{usepackage} command
that invokes the \harvard\ package.

Authors of style files for use with the \harvard\ family who wish to make
use of this feature should use the strings \verb+" \harvardleft "+ and
\verb+" \harvardright "+ instead of the respective parenthesis characters where
they wish them to be effected by the selection made with
\comname{harvardparenthesis}.

\subsection{Conjunction Style}
In the previous examples for the \keyword{agsm} bibliographic
style a ``\&'' character is used to signify conjunction between a pair of names
or between the last two names of a list of names.
Similarly the word ``and'' is used for the \keyword{dcu} style.
With these two styles this convention may be overwritten by using
\comname{renewcommand} to redefine the command
\comname{harvardand}.
This should be done after the \comname{citationstyle} command
(if used) as this
command resets it to the default for the style selected.

\section{World Wide Web (WWW) References}

The \keyword{agsm}, \keyword{dcu}, \keyword{jmr}, \keyword{jphysicsB} and
\keyword{kluwer} bibliographic styles support a new bibliographic entry
field \keyword{URL} for specifying the \keyword{URL} of documents that are
available via the World Wide Web.
An example of this is the reference to \possessivecite{latex2htmldoc}
documentation for his \LaTeX 2{\sc html} package in the file
\verb+harvard.bib+ that is enclosed with the source for this document.
When processed by \LaTeX 2{\sc html} documents using the \harvard\ bibliographic
package will have hypertext links created from the citation within the text
to the reference list.
If an entry in the reference list has an \keyword{URL} field then a
hypertext link to the document will be created using the data in that field.

\section{Doing It By Hand}
Hand coding is accomplished much the same as described in \citeasnoun[p.~73]{latex}
except that the new command \comname{harvarditem} is used in place
of \comname{bibitem}.
The syntax of this command is
\begin{quote}
\comname{harvarditem} [\varname{abbr-citation}]\{\varname{full-citation}\}\{\varname{citation-year}\}\{\varname{cite-key}\}
\end{quote}
where
\begin{description}
\item[\varname{abbr-citation}] is the (optional) abbreviated citation
(minus the year) to be used in the text
subsequent to the first mention of a particular reference,
\item[\varname{full-citation}] is the full citation (minus the year)
to be used in the text
on the first mention of a particular reference,
\item[\varname{citation-year}] the year portion of the citation including any
suffices required to disambiguate citations, and
\item[\varname{cite-key}] is the key used in the \comname{cite} and
\comname{citeasnoun} commands.
\end{description}

\section{Acknowledgement}
The motivation for this style came from Fay Sudweeks of the Design Computing
Unit who also originated the formats for the \keyword{dcu} style and proofread
their implementation.

The \keyword{nederlands} bibliographic style was implemented by Werenfried Spit
(spit@vm.ci.uv.es).

The idea for \comname{citeyear} came from Renate Schmidt
(Renate.Schmidt@mpi-sb.mpg.de).

The solution to the mysterious \comname{enddocument} problem came
from Berwin A. Turlach (berwin@core.ucl.ac.be) as did the identification
of a subtle problem with sorting entries in the reference list.
\bibliography{harvard}
\end{document}