Add more parens (#4061)

* Add more parens

* Document

* Un-paren

Author: krlmlr

R/aes.r

@@ -214,7 +214,7 @@ is_position_aes <- function(vars) {
 #'
 #' Aesthetic mappings describe how variables in the data are mapped to visual
 #' properties (aesthetics) of geoms. [aes()] uses non-standard
-#' evaluation to capture the variable names. `aes_` and `aes_string`
+#' evaluation to capture the variable names. `aes_()` and `aes_string()`
 #' require you to explicitly quote the inputs either with `""` for
 #' `aes_string()`, or with `quote` or `~` for `aes_()`.
 #' (`aes_q()` is an alias to `aes_()`). This makes `aes_()` and

R/annotation-custom.r

@@ -17,7 +17,7 @@ NULL
 #' @param ymin,ymax y location (in data coordinates) giving vertical
 #'   location of raster
 #' @export
-#' @note `annotation_custom` expects the grob to fill the entire viewport
+#' @note `annotation_custom()` expects the grob to fill the entire viewport
 #' defined by xmin, xmax, ymin, ymax. Grobs with a different (absolute) size
 #' will be center-justified in that region.
 #' Inf values can be used to fill the full plot panel (see examples).

R/annotation-logticks.r

@@ -18,7 +18,7 @@
 #'   long tick marks. In base 10, these are the "1" (or "10") ticks.
 #' @param scaled is the data already log-scaled? This should be `TRUE`
 #'   (default) when the data is already transformed with `log10()` or when
-#'   using `scale_y_log10`. It should be `FALSE` when using
+#'   using `scale_y_log10()`. It should be `FALSE` when using
 #'   `coord_trans(y = "log10")`.
 #' @param colour Colour of the tick marks.
 #' @param size Thickness of tick marks, in mm.

R/coord-.r

@@ -1,6 +1,6 @@
 #' @section Coordinate systems:
 #'
-#' All `coord_*` functions (like `coord_trans`) return a `Coord*`
+#' All `coord_*()` functions (like `coord_trans()`) return a `Coord*`
 #' object (like `CoordTrans`).
 #'
 #' Each of the `Coord*` objects is a [ggproto()] object,

R/coord-map.r

@@ -3,7 +3,7 @@
 #' `coord_map()` projects a portion of the earth, which is approximately
 #' spherical, onto a flat 2D plane using any projection defined by the
 #' `mapproj` package. Map projections do not, in general, preserve straight
-#' lines, so this requires considerable computation. `coord_quickmap` is a
+#' lines, so this requires considerable computation. `coord_quickmap()` is a
 #' quick approximation that does preserve straight lines. It works best for
 #' smaller areas closer to the equator.
 #'

R/facet-.r

@@ -31,7 +31,7 @@ NULL
 #'   turn and is expected to supply a `PANEL` column mapping each row to a
 #'   panel defined in the layout. Additionally this method can also add or
 #'   subtract data points as needed e.g. in the case of adding margins to
-#'   `facet_grid`.
+#'   `facet_grid()`.
 #'
 #'   - `draw_panels`: This is where the panels are assembled into a
 #'   `gtable` object. The method receives, among others, a list of grobs
@@ -494,8 +494,8 @@ max_width <- function(grobs, value_only = FALSE) {
 #' Find panels in a gtable
 #'
 #' These functions help detect the placement of panels in a gtable, if they are
-#' named with "panel" in the beginning. `find_panel` returns the extend of
-#' the panel area, while `panel_cols` and `panel_rows` returns the
+#' named with "panel" in the beginning. `find_panel()` returns the extend of
+#' the panel area, while `panel_cols()` and `panel_rows()` returns the
 #' columns and rows that contains panels respectively.
 #'
 #' @param table A gtable

R/facet-wrap.r

@@ -393,7 +393,7 @@ FacetWrap <- ggproto("FacetWrap", Facet,
 #'
 #' Cleans up the input to be an integer greater than or equal to one, or
 #' `NULL`. Intended to be used on the `nrow` and `ncol`
-#' arguments of `facet_wrap`.
+#' arguments of `facet_wrap()`.
 #' @param n Hopefully an integer greater than or equal to one, or `NULL`,
 #' though other inputs are handled.
 #' @return An integer greater than or equal to one, or `NULL`.

R/fortify.r

@@ -1,7 +1,7 @@
 #' Fortify a model with data.
 #'
 #' Rather than using this function, I now recommend using the \pkg{broom}
-#' package, which implements a much wider range of methods. `fortify`
+#' package, which implements a much wider range of methods. `fortify()`
 #' may be deprecated in the future.
 #'
 #' @seealso [fortify.lm()]

R/geom-.r

@@ -3,7 +3,7 @@ NULL
 
 #' @section Geoms:
 #'
-#' All `geom_*` functions (like `geom_point`) return a layer that
+#' All `geom_*()` functions (like `geom_point()`) return a layer that
 #' contains a `Geom*` object (like `GeomPoint`). The `Geom*`
 #' object is responsible for rendering the data in the plot.
 #'

R/geom-bin2d.r

@@ -11,7 +11,7 @@
 #' @inheritParams layer
 #' @inheritParams geom_point
 #' @param geom,stat Use to override the default connection between
-#'   `geom_bin2d` and `stat_bin2d`.
+#'   `geom_bin2d()` and `stat_bin2d()`.
 #' @seealso [stat_binhex()] for hexagonal binning
 #' @examples
 #' d <- ggplot(diamonds, aes(x, y)) + xlim(4, 10) + ylim(4, 10)