2012-01-15 30 views
6

Herhangi bir R nesnesine, reklamlardan benzersiz bir attr hiçbir şey yapmayan bir fonksiyona sahibim. Baz demo:Router ile belge belirleme işlevleri

Bu iyi Rd dosyası oluştururken hariç bir cazibe gibi çalışır
#' Setter function 
#' @param x an R object 
#' @param value a character value to set 
#' @export 
`foo<-` <- function(x, value){ 
    attr(x, 'foo') <- value 
    return(x) 
} 

, ilgili kısmı:

\usage{ 
    foo(var, value) <- value 
} 

Ve R CMD check çalışırken o foo(var) <- value olması gerektiği gibi tabii ki bir uyarı tetikler.

Herhangi bir ipucu gerçekten minnettar olurdu!


Güncelleme: teşekkürler o var gibi görünüyor richierocks için fix

+0

Roxygen veya roxygen2 kullanıyor musunuz? – hadley

+0

@hadley: roxygen2, sadece daha fazla dikkat çekmek için roxy etiketi ekledi. – daroczig

+0

Hangi süreyi kullanıyorsunuz? Roxygen2, 2.2 – hadley

cevap

7

Sen roxygen etiketi Burada @usage

benim paketlerin birinden bir örnek kullanabilirsiniz:

#' @rdname pattern 
#' @usage pattern(x) <- value 
#' @param value New value 
#' @export pattern<- 
"pattern<-" <- function(x, value=c("^", "($|(_\\d+(_\\d+)*)$)")){ 
    attr(x, "pattern") <- value 
    x 
} 

Bu, benim istediğim dokümantasyonla sonuçlanır:

Usage 

    pattern(x) <- value 

Arguments 
x surveydata object 

value New value 
+0

Bir çekicilik gibi çalışır, teşekkürler @ @ Kullanıcıya dikkatimi çekmek için '@ use' - Ben sadece bu yararlı etiketi hakkında hiçbir uyarı alamadım. – daroczig

+1

Bunun nedeni, '@ use' kullanmanız gerekmemesidir - her seferinde roxygen2'deki bir hatadır ve bir hata raporu vermelisiniz. – hadley

+0

Teşekkürler @hadley, [uygun sayı] hakkında bir yorum ekledim (https://github.com/klutometis/roxygen/issues/38#issuecomment-3516591). – daroczig