minor polishes

Author: teunbrand

R/coord-.R

@@ -8,6 +8,7 @@
 #' @details
 #' Each of the `Coord*` objects is a [ggproto()] object, descended from the
 #' top-level `Coord`, and each implements various methods and fields.
+#' The object and its parameters are chaperoned by the [Layout] class.
 #'
 #' To create a new type of Coord object, it is recommended
 #' to extend not the base `Coord` class, but one of its children like

R/facet-.R

@@ -13,6 +13,7 @@ NULL
 #' Extending facets can range from the simple modifications of current facets,
 #' to very laborious rewrites with a lot of [gtable()] manipulation.
 #' For some examples of both, please see the extension vignette.
+#' The object and its parameters are chaperoned by the [Layout] class.
 #'
 #' `Facet` subclasses, like other extendible ggproto classes, have a range
 #' of methods that can be modified. Some of these are required for all new

R/geom-.R

@@ -12,7 +12,7 @@ NULL
 #' @details
 #' Each of the `Geom*` objects is a [ggproto()] object, descended
 #' from the top-level `Geom`, and each implements various methods and
-#' fields.
+#' fields. The object and its parameters are chaperoned by the [Layer] class.
 #'
 #' Compared to `Stat` and `Position`, `Geom` is a little
 #' different because the execution of the setup and compute functions is

R/layer.R

@@ -226,7 +226,7 @@ validate_mapping <- function(mapping, call = caller_env()) {
 #'
 #' @description
 #' The Layer class is a chaperone class not available for extension. The class
-#' fullfills the following tasks. The class houses the Geom, Stat and Position
+#' fulfils the following tasks. The class houses the Geom, Stat and Position
 #' trinity and tracks their stateful parameters. Furthermore, its methods are
 #' responsible for managing the layer data and exposing it to other components
 #' of the plot at the right time.
@@ -238,7 +238,7 @@ validate_mapping <- function(mapping, call = caller_env()) {
 #' populated.
 #'
 #' The class is mostly used in `ggplot_build()`, with the notable exception
-#' of the `draw_geom()` method.
+#' of the `draw_geom()` method, which is used in `ggplot_gtable()` instead.
 #'
 #' @section Layer data diagram:
 #'

R/position-.R

@@ -9,7 +9,7 @@
 #' The way that the `position_*` functions work is slightly different from
 #' the `geom_*` and `stat_*` functions, because a `position_*`
 #' function actually "instantiates" the `Position*` object by creating a
-#' descendant, and returns that.
+#' descendant, and returns that. The object is chaperoned by the [Layer] class.
 #'
 #' To create a new type of Position object, you typically will want to override
 #' one or more of the following:

R/stat-.R

@@ -8,7 +8,7 @@
 #' @details
 #' Each of the `Stat*` objects is a [ggproto()] object, descended
 #' from the top-level `Stat`, and each implements various methods and
-#' fields.
+#' fields. The object and its parameters are chaperoned by the [Layer] class.
 #'
 #' To create a new type of Stat object, you typically will want to
 #' override one or more of the following: