docs: Document package options

Author: IndrajeetPatil

DESCRIPTION

@@ -69,6 +69,7 @@ Collate:
     'io.R'
     'nest.R'
     'nested-to-tree.R'
+    'options.R'
     'parse.R'
     'reindent.R'
     'token-define.R'

R/options.R

@@ -0,0 +1,34 @@
+#' Package options
+#'
+#' These options can be set via [options()] and queried via [getOption()].
+#' For this, add a `styler.` prefix (the package name and a dot) to the option name.
+#' Example: for an option `foo`, use `options(styler.foo = value)` to set it
+#' and `getOption("styler.foo")` to retrieve the current value.
+#' An option value of `NULL` means that the default is used.
+#'
+#' @usage NULL
+#' @format NULL
+#'
+#' @name styler_options
+#'
+#' @examplesIf FALSE
+#' getOption("styler.ignore_alignment")
+#' options(
+#'   styler.ignore_alignment = TRUE,
+#'   styler.quiet = TRUE
+#' )
+#' getOption("styler.ignore_alignment")
+#'
+#' @section Options for the styler package:
+#'
+#' - `styler.addins_style_transformer`: character. The name of the style transformer to use in the addins.
+#' - `styler.cache_name`: character. The name of the styler cache to use.
+#' - `styler.cache_root`: character. The directory where the cache files are stored.
+#' - `styler.colored_print.vertical`: logical. It decides whether or not the output should be colored with
+#'   `prettycode::highlight()`.
+#' - `styler.ignore_alignment`: logical. If `TRUE`, alignment, when detected, is ignored.
+#' - `styler.ignore_start`, `styler.ignore_stop`: character. Regular expressions to ignore lines that match them.
+#' - `styler.quiet`: logical. It decides whether or not to print an informative message about what the
+#'   function is doing. If `TRUE`, no output is printed.
+#' - `styler.test_dir_writable`: logical. If `TRUE`, the package tests whether the directory is writable.
+NULL

R/zzz.R

@@ -6,8 +6,8 @@
   op <- options()
   op.styler <- list(
     styler.addins_style_transformer = "styler::tidyverse_style()",
-    styler.cache_root = NULL,
     styler.cache_name = styler_version,
+    styler.cache_root = NULL,
     styler.colored_print.vertical = TRUE,
     styler.ignore_alignment = FALSE,
     styler.ignore_start = .default_ignore_start,

_pkgdown.yaml

@@ -11,6 +11,7 @@ reference:
       - style_pkg
       - style_dir
       - styler_addins
+      - styler_options
   - title: "Fine-tune styling"
     desc: "Customize style guides"
   - contents: