Documentation fixes

ANNOUNCE

@@ -12,4 +12,6 @@ It's already possible to do this with built-in functions (like split and the app
   * progress bars to keep track of long running operations
   * built-in error recovery, and informative error messages
 
+Some considerable effort has been put into making plyr fast and memory efficient, and in most cases it is faster than the built-in functions.
+
 You can find out more at http://had.co.nz/plyr/, including a 20 page introductory guide, http://had.co.nz/plyr/plyr-intro.pdf.  You can ask questions about plyr (and data-manipulation in general) on the plyr mailing list.  Sign up at http://groups.google.com/group/manipulatr

R/ply-list.r

@@ -90,7 +90,6 @@ llply <- function(.data, .fun = NULL, ..., .progress = "none", .inform = FALSE)
 # @arguments other arguments passed on to \code{.fun}
 # @arguments name of the progress bar to use, see \code{\link{create_progress_bar}}
 # @value if results are atomic with same type and dimensionality, a vector, matrix or array; otherwise, a list-array (a list with dimensions)
-# @value list of results
 #X linmod <- function(df) lm(rbi ~ year, data = transform(df, year = year - min(year)))
 #X models <- dlply(baseball, .(id), linmod)
 #X models[[1]]

man/data-baseball.rd

@@ -8,6 +8,7 @@ This data frame contains batting statistics for a subset of players collected fr
 
 Variables:
 
+\itemize{
 \item id, unique player id
 \item year, year of data
 \item stint
@@ -30,7 +31,7 @@ Variables:
 \item sh, sacrifice hits
 \item sf, sacrifice flies
 \item gidp, ground into double play
-
+}
 }
 \usage{data(baseball)}
 \format{A 21699 x 22 data frame}

man/dlply-7t.rd

@@ -15,10 +15,7 @@ For each subset of a data frame, apply function then combine results into a  lis
 \item{.progress}{name of the progress bar to use, see \code{\link{create_progress_bar}}}
 \item{.drop}{}
 }
-\value{
- \item{if results are atomic with same type and dimensionality, a vector, matrix or array; otherwise, a list-array (a list with dimensions)}
- \item{list of results}
-}
+\value{if results are atomic with same type and dimensionality, a vector, matrix or array; otherwise, a list-array (a list with dimensions)}
 \details{All plyr functions use the same split-apply-combine strategy: they split the
 input into simpler pieces, apply \code{.fun} to each piece, and then combine
 the pieces into a single data structure.  This function splits data frames

man/each-4v.rd

@@ -14,5 +14,8 @@ Combine multiple functions to a single function returning a named vector of outp
 \details{Each function should produce a single number as output}
 
 \examples{each(min, max)(1:10)
+each("min", "max")(1:10)
+each(c("min", "max"))(1:10)
+each(c(min, max))(1:10)
 each(length, mean, var)(rnorm(100))}
 \keyword{manip}