Merge pull request #2266 from olivroy/doc

Use roxygen_md docs

Author: edzer

DESCRIPTION

@@ -53,8 +53,8 @@ Description: Support for simple features, a standardized way to
     projection conversions and datum transformations. Uses by default the 's2'
     package for spherical geometry operations on ellipsoidal (long/lat) coordinates.
 License: GPL-2 | MIT + file LICENSE
-URL: https://r-spatial.github.io/sf/, https://github.com/r-spatial/sf/
-BugReports: https://github.com/r-spatial/sf/issues/
+URL: https://r-spatial.github.io/sf/, https://github.com/r-spatial/sf
+BugReports: https://github.com/r-spatial/sf/issues
 Depends:
     methods,
     R (>= 3.3.0)
@@ -114,7 +114,8 @@ VignetteBuilder:
     knitr
 Encoding: UTF-8
 RoxygenNote: 7.2.3
-Config/testhat/edition: 3
+Roxygen: list(markdown = TRUE)
+Config/testthat/edition: 2
 SystemRequirements: GDAL (>= 2.0.1), GEOS (>= 3.4.0),
     PROJ (>= 4.8.0), sqlite3
 Collate: 

R/break_antimeridian.R

@@ -6,7 +6,7 @@
 #' on the chosen central longitude. The method may only be used with 
 #' non-projected, geographical coordinates and linestring or polygon objects.
 #' s2 is turned off internally to permit the use of a rectangular bounding 
-#' box. If the input geometries go outside [-180, 180] degrees longitude,
+#' box. If the input geometries go outside `[-180, 180]` degrees longitude,
 #' the protruding geometries will also be split using the same \code{tol=} 
 #' values; in this case empty geometries will be dropped first.
 #'

R/geom-predicates.R

@@ -81,7 +81,7 @@ st_geos_binop = function(op, x, y, par = 0.0, pattern = NA_character_,
 #' @param y object of class \code{sf}, \code{sfc} or \code{sfg}
 #' @param pattern character; define the pattern to match to, see details.
 #' @param sparse logical; should a sparse matrix be returned (TRUE) or a dense matrix?
-#' @return In case \code{pattern} is not given, \code{st_relate} returns a dense \code{character} matrix; element [i,j] has nine characters, referring to the DE9-IM relationship between x[i] and y[j], encoded as IxIy,IxBy,IxEy,BxIy,BxBy,BxEy,ExIy,ExBy,ExEy where I refers to interior, B to boundary, and E to exterior, and e.g. BxIy the dimensionality of the intersection of the the boundary of x[i] and the interior of y[j], which is one of: 0, 1, 2, or F; digits denoting dimensionality of intersection, F denoting no intersection. When \code{pattern} is given, a dense logical matrix or sparse index list returned with matches to the given pattern; see \link{st_intersection} for a description of the returned matrix or list. See also \url{https://en.wikipedia.org/wiki/DE-9IM} for further explanation.
+#' @return In case \code{pattern} is not given, \code{st_relate} returns a dense \code{character} matrix; element `[i,j]` has nine characters, referring to the DE9-IM relationship between `x[i]` and `y[j]`, encoded as IxIy,IxBy,IxEy,BxIy,BxBy,BxEy,ExIy,ExBy,ExEy where I refers to interior, B to boundary, and E to exterior, and e.g. BxIy the dimensionality of the intersection of the the boundary of `x[i]` and the interior of `y[j]`, which is one of: 0, 1, 2, or F; digits denoting dimensionality of intersection, F denoting no intersection. When \code{pattern} is given, a dense logical matrix or sparse index list returned with matches to the given pattern; see \link{st_intersection} for a description of the returned matrix or list. See also \url{https://en.wikipedia.org/wiki/DE-9IM} for further explanation.
 #' @export
 #' @examples
 #' p1 = st_point(c(0,0))

R/geom-transformers.R

@@ -976,7 +976,7 @@ st_snap.sf = function(x, y, tolerance)
 #' @param y object of class \code{sf}, \code{sfc} or \code{sfg} (optional)
 #' @param ... ignored
 #' @seealso \link{st_intersection}, \link{st_difference}, \link{st_sym_difference}
-#' @return If \code{y} is missing, \code{st_union(x)} returns a single geometry with resolved boundaries, else the geometries for all unioned pairs of x[i] and y[j].
+#' @return If \code{y} is missing, \code{st_union(x)} returns a single geometry with resolved boundaries, else the geometries for all unioned pairs of `x[i]` and `y[j]`.
 #' @details
 #' If \code{st_union} is called with a single argument, \code{x}, (with \code{y} missing) and \code{by_feature} is \code{FALSE} all geometries are unioned together and an \code{sfg} or single-geometry \code{sfc} object is returned. If \code{by_feature} is \code{TRUE} each feature geometry is unioned individually. This can for instance be used to resolve internal boundaries after polygons were combined using \code{st_combine}. If \code{y} is provided, all elements of \code{x} and \code{y} are unioned, pairwise if \code{by_feature} is TRUE, or else as the Cartesian product of both sets. 
 #'

R/plot.R

@@ -670,8 +670,8 @@ plot_sf = function(x, xlim = NULL, ylim = NULL, asp = NA, axes = FALSE, bgc = pa
 
 
 #' @param n integer; number of colors
-#' @param cutoff.tails numeric, in [0,0.5] start and end values
-#' @param alpha numeric, in [0,1], transparency
+#' @param cutoff.tails numeric, in `[0,0.5]` start and end values
+#' @param alpha numeric, in `[0,1]`, transparency
 #' @param categorical logical; do we want colors for a categorical variable? (see details)
 #' @name plot
 #' @export