I used checkhelper::find_missing_tags() to find missing \value tags in the Rd files of gggenomes after CRAN rejected the package, because of this reason.
Some missing \value tags were reported by checkhelper and I fixed all of them. I re-checked until I saw the message:
Good! There is no missing or empty return value for exported functions
Good! There is no missing `@export` or `@noRd` in your documentation
After re-submitting to CRAN, we were rejected again, because there were still \value tags missing. I tried both the release version of checkhelper and the latest development version, both don't report the missing \value tags.
To reproduce, you can run:
git clone --depth 1 https://github.com/thackl/gggenomes -b missing-value-tags
cd gggenomes
R -s -e "mt <- checkhelper::find_missing_tags()"
and you will see
ℹ Loading gggenomes
Loading required package: ggplot2
Good! There is no missing or empty return value for exported functions
Good! There is no missing `@export` or `@noRd` in your documentation
ℹ Loading gggenomes
And indeed, the add_seqs.Rd file, does not contain a \value tag. And so do the other files, reported by CRAN. Do you have an explanation, why these cases are not reported by checkhelper?
I used
checkhelper::find_missing_tags()
to find missing\value
tags in the Rd files ofgggenomes
after CRAN rejected the package, because of this reason. Some missing\value
tags were reported bycheckhelper
and I fixed all of them. I re-checked until I saw the message:After re-submitting to CRAN, we were rejected again, because there were still
\value
tags missing. I tried both the release version ofcheckhelper
and the latest development version, both don't report the missing\value
tags. To reproduce, you can run:and you will see
However, CRAN reports the following:
And indeed, the
add_seqs.Rd
file, does not contain a\value
tag. And so do the other files, reported by CRAN. Do you have an explanation, why these cases are not reported bycheckhelper
?Sidenote: this code: https://stat.ethz.ch/pipermail/r-package-devel/2021q2/007106.html did report some, but also not all the remaining missing tags.