The default-on CRAN checker does not understand @rdname

[eddelbuettel]

tinyrox rocks. Getting my first package baked with it, and it is of course 'tiny' but out here: tl.

When I use my default wrapper from littler which runs tinyrox::document() then for this package with its (essentially sole) Rd block and a bunch of @rdname pointing to it, it false claims 'undocumented' which aint't true:

tinyrox

edd@paul:~/git/tl(master)$ tt.r -d inst/tinytest/
test_basics.R.................   25 tests OK 50ms
test_formats.R................   19 tests OK 4ms
All ok, 44 results (54ms)
edd@paul:~/git/tl(master)$ trox.r 
Checking CRAN compliance...
Parsing R files...
Found 11 documentation block(s).
Generating Rd files...
Generated 1 Rd file(s).
Generating NAMESPACE...
Updated NAMESPACE.
Warning messages:
1: CRAN: Exported functions without examples: debug, info, warn, error, critical, set_level, get_level, set_name, get_name, set_format 
2: Undocumented parameters in set_format: utc, show_date, show_thread_id, precision 
edd@paul:~/git/tl(master)$ 

R CMD check (subset via rcmdcheck::rcmdcheck() via rcc.r)

[...]
✔  checking R code for possible problems (422ms)
✔  checking Rd files ...
✔  checking Rd metadata ...
✔  checking Rd cross-references ...
✔  checking for missing documentation entries ...
✔  checking for code/documentation mismatches ...
✔  checking Rd \usage sections ...
✔  checking Rd contents ...
✔  checking for unstated dependencies in examples ...
✔  checking line endings in shell scripts
[...]
── R CMD check results ───────────────────────────────────── tl 0.0.1 ────
Duration: 5.6s

0 errors ✔ | 0 warnings ✔ | 0 notes ✔
edd@paul:~/git/tl(master)$ 

[TroyHernandez]

Confirmed and fixed in #15.

The undocumented-parameter check was per-block, but @rdname groups merge into one page, so a parameter documented on a sibling block (your set_format, where the params live on the primary block) was falsely flagged even though R CMD check was clean. It now checks each function's formals against the group-wide union of documented params (with @inheritParams resolved), mirroring the merge in generate_rd_grouped().

The warning is also now gated on cran_check rather than silent, so cran_check = FALSE suppresses it as you'd expect. Thanks for the clean repro.