Documentation: potential contribution on R_system_version()

[TimTaylor]

The 'documentation for R_system_version(x, strict = TRUE) is combined with that of numeric_version(x, strict = TRUE) and in the Details section states:

Numeric versions are sequences of one or more non-negative integers, usually (e.g., in package ‘DESCRIPTION’ files) represented as character strings with the elements of the sequence concatenated and separated by single ‘⁠.⁠’ or ‘⁠-⁠’ characters. R package versions consist of at least two such integers, an R system version of exactly three (major, minor and patch level).

I think this is slightly incorrect/ambiguous as you cannot use hypens with R_system_version

R.version.string
#> [1] "R Under development (unstable) (2024-04-20 r86457)"

v1 <- "1.1.1"
numeric_version(v1)
#> [1] '1.1.1'
package_version(v1)
#> [1] '1.1.1'
R_system_version(v1)  
#> [1] '1.1.1'

v2 <- "1-1-1"
numeric_version(v2)
#> [1] '1.1.1'
package_version(v2)
#> [1] '1.1.1'
R_system_version(v2)  
#> Error: invalid version specification '1-1-1'

^{Created on 2024-04-20 with reprex v2.1.0}

If agreed erroneous, a contributor could report on Bugzilla and provide an accompanying patch to the documentation.