"better" documentation

stackedstones.R

@@ -3,17 +3,19 @@
 ## 20181019 Benno Pütz
 ##          puetz@psych.mpg.de
 
-require(RColorBrewer)
+require(RColorBrewer)   # for "nicer" colors
 
 #' Stacked stone plot
 #'
-#' Kris you may add some description here
+#' For a count matrix, order the entries by columns and plot corresponding circles
+#' stacked atop each other. The circle areas are propotional to the counts, the largest
+#' circle at the bottom.
 #'
 #' @param data data matix or data.fame
 #' @param grid whether to place the cicles on a grid (TRUE) or stack them closely (FALSE)
-#' @param ... passed on to othe circle plotting function \link{\code{circ}}
+#' @param ... passed on to other circle plotting function \link{\code{circ}}
 #'
-#' @return matrix corrresponding to the plot
+#' @return matrix corresponding to the plot (largest value per column in first row)
 #' @export
 #'
 #' @examples