CRAN resubmission (#127)

* Extend description

* Add missing return statements

* Update description

* Kick version

DESCRIPTION

@@ -1,7 +1,7 @@
 Package: talkr
 Type: Package
 Title: Plotting Conversation Data
-Version: 0.1.2
+Version: 0.1.3
 Authors@R: c(
   person("Mark", "Dingemanse", email = "[email protected]", role = c("aut", "cre")),
   person("Barbara", "Vreede", email = "[email protected]", role = "aut"),
@@ -10,7 +10,11 @@ Authors@R: c(
   person("Andreas", "Liesenfeld", email = "[email protected]", role = "ctb"),
   person("Netherlands eScience Center", role = c("cph", "fnd"))
   )
-Description: Functions to plot elements of conversations.
+Description: Visualisation, analysis and quality control of conversational data.
+             Rapid and visual insights into the nature, timing and quality of
+             time-aligned annotations in conversational corpora.
+             For more details, see 
+             Dingemanse et al., (2022) <doi:10.18653/v1/2022.acl-long.385>.
 License: Apache License (>= 2)
 Encoding: UTF-8
 LazyData: true

R/geom_token.R

@@ -7,6 +7,8 @@
 #' @param data A tokenized data frame (see `tokenize()`).
 #' @inheritParams ggplot2::layer
 #' @inheritParams ggplot2::geom_point
+#' 
+#' @return A ggplot2 layer corresponding to a token
 #' @export
 geom_token <- function(data, mapping = NULL,
                           stat = "identity", position = "identity",

R/geom_turn.R

@@ -6,6 +6,8 @@
 #' @inheritParams ggplot2::layer
 #' @inheritParams ggplot2::geom_rect
 #' @param height The height of the turn-taking rectangles
+#' 
+#' @return A ggplot2 layer corresponding to a turn-taking rectangle
 #' @export
 geom_turn <- function(mapping = NULL, data = NULL,
                       stat = "identity", position = "identity",

R/report.R

@@ -11,6 +11,7 @@
 #'
 #' @param data talkr dataset
 #'
+#' @return No return, just prints a summary to the console
 #' @export
 report_stats <- function(data) {
   summary <- report(data)

R/theme_turnPlot.R

@@ -1,12 +1,13 @@
-#' theme for the turn plot
+#' T  heme for the turn plot
 #'
 #' @param base_size int
 #' @param base_family chr
 #' @param ticks bool
 #'
 #' @importFrom ggplot2 %+replace%
+#' 
+#' @return ggplot2 custom theme for turn plots
 #' @export
-#'
 theme_turnPlot <- function(base_size = 11, base_family = "serif", ticks = TRUE) {
   ggthemes::theme_tufte(
     base_size = base_size,