How to not run an example using roxygen2?

后端 未结 4 1798

I\'m writing a geocoding function right now that relies on having a Bing Maps Key. Obviously I\'d rather not publish mine, and the examples fail without one.

How do

4条回答
  •  执笔经年
    2020-12-08 13:12

    Ari, I also use roxygen2 (version 4.1.0). The following is the end of my roxygen2 mark-up in my function (gctemplate) definition till the beginning of the real part.

    #' @examples
    #' ## List all G-causalities in a VAR system of 5 variables that will be searched in the pattern of 1 
    #' ## causer (like-independent) variable and 2 like-dependents conditional on 5-(1+2)=2 of the remaining 
    #' ## variable(s) in the system. Variables are assigned to numbers 1 to nvars. 
    #' ## "1 2 5 3 4" in the resulting line of gctemplate is to indicate the 
    #' ## (conditonal, partial, etc.) G-causality from variable 1 to variables 2 and 5 
    #' ## conditonal on variables 3 and 4.
    #' # gctemplate(5,1,2)
    #' ## The number of all G-causalities to be searched in the above pattern.
    #' #dim(gctemplate(5,1,2))[[1]]
    #' @importFrom combinat combn
    #' @export
    gctemplate <- function(nvars, ncausers, ndependents){
    ...
    

    I know GSee's dontrun method.
    In my technique, the numerical example and the text explaining the numerical example are both comments. I use indentation to make difference between these two; Notice there are 1 sharp and 2 sharps respectively after "#'". I always use the above "#' ## / #' #" technique in my packages. The user is left to copy-paste operation whenever s/he wanna test the function. This technique is - according to me - more parallel with the classical comment bombardment of the software coding philosophy.

提交回复
热议问题