#' Options and environment variables used by the 'startup' package
#'
#' Below are environment variables and \R options that are used by the
#' \pkg{startup} package.
#' The \env{R_STARTUP_***} environment variables must be set before calling
#' the `startup::startup()` function, that is, either (i) prior to launching
#' \R or (ii) in the \file{.Renviron} file.
#'
#' @section Controls whether \pkg{startup} is used or not:
#'
#' \describe{
#' \item{\env{R_STARTUP_DISABLE} / \option{startup.disable}:}{
#' (logical)
#' If `TRUE`, `startup::startup()` is fully disable such that _no_
#' \file{.Renviron.d/} or \file{.Rprofile.d/} files are processed.
#' _Note_: Files \file{.Renviron} and \file{.Rprofile} are still processed
#' because these are out of control of the \pkg{startup} package.
#' (Default: `FALSE`)
#' }
#'
#' \item{\env{R_STARTUP_DRYRUN} / \option{startup.dryrun}:}{
#' (logical)
#' Controls the default value of argument `dryrun` of [startup()].
#' (Default: `FALSE`)
#' }
#' }
#'
#'
#' @section Additional customization of the startup process:
#'
#' \describe{
#' \item{\env{R_STARTUP_FILE} / \option{startup.file}:}{
#' (R script as a character string)
#' Optional \R script that is parsed and evaluated after
#' \file{.Renviron.d/} and \file{.Rprofile.d/} files,
#' and `R_STARTUP_INIT` code, have been processed, e.g.
#' `R_STARTUP_FILE="setup.R" R --quiet`.
#' (Default: not specified)
#' }
#'
#' \item{\env{R_STARTUP_INIT} / \option{startup.init}:}{
#' (R code as a character string)
#' Optional \R code that is parsed and evaluated after
#' \file{.Renviron.d/} and \file{.Rprofile.d/} files,
#' but before `R_STARTUP_FILE` code, have been processed e.g.
#' `R_STARTUP_INIT="message('Hello world')" R --quiet`.
#' The specified string must be parsable by [base::parse()].
#' (Default: not specified)
#' }
#'
#' \item{\env{R_STARTUP_RDATA} / \option{startup.rdata}:}{
#' (comma-separated values)
#' Controls whether an existing \file{./.RData} file should be processed
#' or not.
#' If `"remove"`, it will be skipped by automatically removing it.
#' If `"rename"`, it will be renamed to \file{./.RData.YYYYMMDD_hhmmss}
#' where the timestamp is the last time the file was modified.
#' If `"prompt"`, the user is prompted whether they want to load the file
#' or rename it. In non-interactive session, `"prompt"` will fallback to
#' loading the content (default). To fallback to renaming the file, use
#' `"prompt,rename"`.
#' Note that in contrast to `R` and `R CMD BATCH file.R`, `Rscript` does
#' _not_ load \file{.RData} files unless command-line option `--restore`
#' is specified.
#' (Default: not specified)
#' }
#' }
#'
#'
#' @section Controls what validation checks are performed at startup:
#'
#' \describe{
#' \item{\env{R_STARTUP_CHECK} / \option{startup.check}:}{
#' (logical)
#' Controls the default value of argument `check` of [startup()].
#' (Default: `TRUE`)
#' }
#'
#' \item{\env{R_STARTUP_CHECK_OPTIONS_IGNORE} /
#' \option{startup.check.options.ignore}:}{
#' (character vector or comma-separated character string)
#' Names of \R options that should _not_ be validated at the end of the
#' [startup()] process.
#' (Default: `"error"`)
#' }
#' }
#'
#'
#' @section Settings useful for debugging and prototyping:
#'
#' \describe{
#'
#' \item{\env{R_STARTUP_DEBUG} / \option{startup.debug}:}{
#' (logical)
#' Controls the default value of argument `debug` of [startup()].
#' (Default: `FALSE`)
#' }
#'
#' \item{\option{startup.commandArgs}:}{
#' (character vector)
#' Overrides the command-line arguments that [startup()] uses, which
#' can be useful to prototype and test alternative ways that \R might
#' be launched.
#' (Default: `base::commandArgs()`)
#' }
#'
#' \item{\env{R_STARTUP_TIME} / \option{startup.time}:}{
#' (POSIX timestamp; character string)
#' Overrides the current timestamp, which can be useful to prototype and
#' test functionalities that depend on the current time, e.g. inclusion
#' and exclusion of files based on `when=<periodicity>` tags.
#' The specified string must be parsable by [base::as.POSIXct()].
#' (Default: not specified)
#' }
#' }
#'
#'
#' @aliases
#' R_STARTUP_CHECK
#' startup.check
#' R_STARTUP_CHECK_OPTIONS_IGNORE
#' startup.check.options.ignore
#' startup.commandArgs
#' R_STARTUP_DEBUG
#' startup.debug
#' R_STARTUP_DRYRUN
#' startup.dryrun
#' R_STARTUP_DISABLE
#' startup.disable
#' R_STARTUP_FILE
#' startup.file
#' R_STARTUP_INIT
#' startup.init
#' R_STARTUP_RDATA
#' startup.rdata
#' R_STARTUP_TIME
#' startup.time
#'
#' @name startup.options
NULL
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.