GH-39754: [R] Docs are not clear on expected behaviour of date parsing functions (e.g. dmy()) on Windows vs. Linux/MacOS (#49708)

### Rationale for this change

Unclear from docs where some time formats don't work on Windows

### What changes are included in this PR?

Update docs to make behaviour clearer

### Are these changes tested?

No

### Are there any user-facing changes?

No
* GitHub Issue: #39754

Authored-by: Nic Crane <thisisnic@gmail.com>
Signed-off-by: Nic Crane <thisisnic@gmail.com>

Author: thisisnic

r/DESCRIPTION

@@ -44,7 +44,6 @@ Imports:
     utils,
     vctrs
 Roxygen: list(markdown = TRUE, r6 = FALSE, load = "source")
-RoxygenNote: 7.3.3
 Config/testthat/edition: 3
 Config/build/bootstrap: TRUE
 Suggests:
@@ -151,3 +150,4 @@ Collate:
     'schema.R'
     'udf.R'
     'util.R'
+Config/roxygen2/version: 8.0.0

r/R/dplyr-funcs-datetime.R

@@ -671,7 +671,7 @@ register_bindings_datetime_parsers <- function() {
     notes = c(
       "`quiet = FALSE` is not supported",
       "Available formats are H, I, j, M, S, U, w, W, y, Y, R, T.",
-      "On Linux and OS X additionally a, A, b, B, Om, p, r are available."
+      "On Linux and macOS additionally a, A, b, B, Om, p, r are available."
     )
   )
 
@@ -724,7 +724,7 @@ register_bindings_datetime_parsers <- function() {
     register_binding(
       paste0("lubridate::", tolower(order)),
       parser_map_factory(order),
-      notes = "`locale` argument not supported"
+      notes = "`locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats"
     )
   }
 

r/R/dplyr-funcs-doc.R

@@ -241,17 +241,17 @@
 #' * [`dmilliseconds()`][lubridate::dmilliseconds()]
 #' * [`dminutes()`][lubridate::dminutes()]
 #' * [`dmonths()`][lubridate::dmonths()]
-#' * [`dmy()`][lubridate::dmy()]: `locale` argument not supported
-#' * [`dmy_h()`][lubridate::dmy_h()]: `locale` argument not supported
-#' * [`dmy_hm()`][lubridate::dmy_hm()]: `locale` argument not supported
-#' * [`dmy_hms()`][lubridate::dmy_hms()]: `locale` argument not supported
+#' * [`dmy()`][lubridate::dmy()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`dmy_h()`][lubridate::dmy_h()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`dmy_hm()`][lubridate::dmy_hm()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`dmy_hms()`][lubridate::dmy_hms()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
 #' * [`dnanoseconds()`][lubridate::dnanoseconds()]
 #' * [`dpicoseconds()`][lubridate::dpicoseconds()]: not supported
 #' * [`dseconds()`][lubridate::dseconds()]
 #' * [`dst()`][lubridate::dst()]
 #' * [`dweeks()`][lubridate::dweeks()]
 #' * [`dyears()`][lubridate::dyears()]
-#' * [`dym()`][lubridate::dym()]: `locale` argument not supported
+#' * [`dym()`][lubridate::dym()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
 #' * [`epiweek()`][lubridate::epiweek()]
 #' * [`epiyear()`][lubridate::epiyear()]
 #' * [`fast_strptime()`][lubridate::fast_strptime()]: non-default values of `lt` and `cutoff_2000` not supported
@@ -273,17 +273,17 @@
 #' * [`make_difftime()`][lubridate::make_difftime()]: only supports `units = "secs"` (the default);
 #' providing both `num` and `...` is not supported
 #' * [`mday()`][lubridate::mday()]
-#' * [`mdy()`][lubridate::mdy()]: `locale` argument not supported
-#' * [`mdy_h()`][lubridate::mdy_h()]: `locale` argument not supported
-#' * [`mdy_hm()`][lubridate::mdy_hm()]: `locale` argument not supported
-#' * [`mdy_hms()`][lubridate::mdy_hms()]: `locale` argument not supported
+#' * [`mdy()`][lubridate::mdy()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`mdy_h()`][lubridate::mdy_h()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`mdy_hm()`][lubridate::mdy_hm()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`mdy_hms()`][lubridate::mdy_hms()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
 #' * [`minute()`][lubridate::minute()]
 #' * [`month()`][lubridate::month()]
-#' * [`my()`][lubridate::my()]: `locale` argument not supported
-#' * [`myd()`][lubridate::myd()]: `locale` argument not supported
+#' * [`my()`][lubridate::my()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`myd()`][lubridate::myd()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
 #' * [`parse_date_time()`][lubridate::parse_date_time()]: `quiet = FALSE` is not supported
 #' Available formats are H, I, j, M, S, U, w, W, y, Y, R, T.
-#' On Linux and OS X additionally a, A, b, B, Om, p, r are available.
+#' On Linux and macOS additionally a, A, b, B, Om, p, r are available.
 #' * [`pm()`][lubridate::pm()]
 #' * [`qday()`][lubridate::qday()]
 #' * [`quarter()`][lubridate::quarter()]
@@ -295,17 +295,17 @@
 #' * [`week()`][lubridate::week()]
 #' * [`with_tz()`][lubridate::with_tz()]
 #' * [`yday()`][lubridate::yday()]
-#' * [`ydm()`][lubridate::ydm()]: `locale` argument not supported
-#' * [`ydm_h()`][lubridate::ydm_h()]: `locale` argument not supported
-#' * [`ydm_hm()`][lubridate::ydm_hm()]: `locale` argument not supported
-#' * [`ydm_hms()`][lubridate::ydm_hms()]: `locale` argument not supported
+#' * [`ydm()`][lubridate::ydm()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ydm_h()`][lubridate::ydm_h()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ydm_hm()`][lubridate::ydm_hm()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ydm_hms()`][lubridate::ydm_hms()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
 #' * [`year()`][lubridate::year()]
-#' * [`ym()`][lubridate::ym()]: `locale` argument not supported
-#' * [`ymd()`][lubridate::ymd()]: `locale` argument not supported
-#' * [`ymd_h()`][lubridate::ymd_h()]: `locale` argument not supported
-#' * [`ymd_hm()`][lubridate::ymd_hm()]: `locale` argument not supported
-#' * [`ymd_hms()`][lubridate::ymd_hms()]: `locale` argument not supported
-#' * [`yq()`][lubridate::yq()]: `locale` argument not supported
+#' * [`ym()`][lubridate::ym()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ymd()`][lubridate::ymd()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ymd_h()`][lubridate::ymd_h()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ymd_hm()`][lubridate::ymd_hm()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`ymd_hms()`][lubridate::ymd_hms()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
+#' * [`yq()`][lubridate::yq()]: `locale` argument not supported; see docs for `parse_date_time()` mapping for supported formats
 #'
 #' ## methods
 #'