[R-pkg-devel] Workaround for code/documentation mismatch
Martin Maechler
m@ech|er @end|ng |rom @t@t@m@th@ethz@ch
Wed Aug 11 08:52:27 CEST 2021
> Hello,
>
> I've written two functions to emulate do while/until loops seen in other
> languages, but I'm having trouble documenting its usage. The function is
> typically used like:
>
> do ({
> expr1
> expr2
> ...
> }) %while% (cond)
I understand that you did *not* ask .. but really
why don't you want to use R's own
builtin, fast, well documented, present everywhere *and* simpler syntax
while(cond) {
expr1
expr2
...
}
???
and also
repeat {
expr1
expr2
....
if(cond) break
}
instead of your %until% below?
> so I want to document it something like:
>
> do(expr) %while% (cond)
> do(expr) %until% (cond)
>
> to look like the documentation for 'while' and 'if', but R CMD check
> produces a "Code/documentation mismatch" warning, complaining that the
> documentation should look like:
>
> expr %while% cond
> expr %until% cond
>
> So, my question is, is there a way to bypass the
> * checking for code/documentation mismatches
> portion of R CMD check, at least for one file? Some way to acknowledge that
> the code and documentation will mismatch, but that's okay.
>
>
> Thank you!
More information about the R-package-devel
mailing list