Further tweaks to version doc and how it is invoked in functions

R/get_dataframe.R

@@ -28,7 +28,6 @@
 #' `.tab` files so if `original = FALSE`, `.f` is set to `readr::read_tsv`.
 #'
 #' @inheritDotParams get_file
-#' @template version
 #'
 #' @return A R object that is returned by the default or user-supplied function
 #'  `.f` argument. For example, if `.f = readr::read_tsv()`, the function will

R/get_file.R

@@ -34,6 +34,7 @@
 #' @template envvars
 #' @template dots
 #' @template ds
+#' @template version
 #'
 #' @return \code{get_file} returns a raw vector (or list of raw vectors,
 #' if \code{length(file) > 1}), which can be saved locally with the `writeBin`
@@ -89,6 +90,7 @@ get_file <- function(
   key           = Sys.getenv("DATAVERSE_KEY"),
   server        = Sys.getenv("DATAVERSE_SERVER"),
   original      = TRUE,
+  version       = ":latest",
   ...
 ) {
 

man-roxygen/version.R

@@ -2,9 +2,10 @@
 #'  This can be of the form `"1.1"` or `"1"` (where in `"x.y"`, x is a major
 #'  version and y is an optional minor version), or
 #'  `":latest"` (the default, the latest published version).
-#'  In lieu of this, a dataset's version-specific identification number can be
-#'  used for the `dataset` argument. We recommend using the number format so that
+#'  We recommend using the number format so that
 #'  the function stores a cache of the data (See \code{\link{cache_dataset}}).
 #'  If the user specifies a `key` or `DATAVERSE_KEY` argument, they can access the
 #'  draft version by `":draft"` (the current draft) or `":latest"` (which will
 #'  prioritize the draft over the latest published version.
+#'  A dataset's version-specific identification number can be
+#'  used for the `dataset` argument as well to avoid the `version` argument.