\HeaderA{person}{Person Names and Contact Information}{person}
\aliasA{as.character.person}{person}{as.character.person}
\aliasA{as.character.personList}{person}{as.character.personList}
\aliasA{as.person}{person}{as.person}
\methaliasA{as.person.default}{person}{as.person.default}
\aliasA{as.personList}{person}{as.personList}
\methaliasA{as.personList.default}{person}{as.personList.default}
\methaliasA{as.personList.person}{person}{as.personList.person}
\aliasA{personList}{person}{personList}
\aliasA{toBibtex.person}{person}{toBibtex.person}
\aliasA{toBibtex.personList}{person}{toBibtex.personList}
\keyword{misc}{person}
\begin{Description}\relax
A class and utility methods for holding information about persons
like name and email address.
\end{Description}
\begin{Usage}
\begin{verbatim}
person(first = "", last = "", middle = "", email = "")
personList(...)
as.person(x)
as.personList(x)

## S3 method for class 'person':
as.character(x, ...)
## S3 method for class 'personList':
as.character(x, ...)

## S3 method for class 'person':
toBibtex(object, ...)
## S3 method for class 'personList':
toBibtex(object, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{first}] character string, first name
\item[\code{middle}] character string, middle name(s)
\item[\code{last}] character string, last name
\item[\code{email}] character string, email address
\item[\code{...}] for \code{personList} an arbitrary number of \code{person}
objects
\item[\code{x}] a character string or an object of class \code{person} or
\code{personList}
\item[\code{object}] an object of class \code{person} or
\code{personList}
\end{ldescription}
\end{Arguments}
\begin{Examples}
\begin{ExampleCode}
## create a person object directly
p1 <- person("Karl", "Pearson", email = "pearson@stats.heaven")
p1

## convert a string
p2 <- as.person("Ronald Aylmer Fisher")
p2

## create one object holding both
p <- personList(p1, p2)
ps <- as.character(p)
ps
as.personList(ps)

## convert to BibTeX author field
toBibtex(p)
\end{ExampleCode}
\end{Examples}