我使用devtools
來構建R程序包,並且有一些功能不能被終端用戶看到。但是,由於這些功能涉及通過.Call
調用C代碼,因此我必須將@useDynLib
編寫在用於自動生成.Rd文件的函數之上。這樣,當我構建軟件包時,即使我沒有包含這些函數的@export
,它們仍然出現在幫助文檔中...有沒有辦法通過抑制這些函數,即使它們已被記錄在案?謝謝!不顯示功能幫助文檔通過roxygen2構建R程序包
10
A
回答
19
根據Hadley的評論,使用@keywords internal
將使該功能對最終用戶不可見。詳細信息可在devtools
的維基頁面找到here。
8
在接受的答案中鏈接的維基不再討論@keywords internal
(截至2016年4月)。在情況下,它是有幫助的人,看一個例子:
# multiplyBy3
#' This is an example of an internal function called \code{multiplyBy3()}
#'
#' Sometimes you want internal functions as part of an R Package built with
#' RStudio and roxygen2, but you don't want .Rd files created for them
#' or to have them be visible in the help document following the build process
#'
#' @keywords internal
#'
#' @param base_num The number to multiply by three
#'
#' @import jsonlite
#'
#' @return Returns a numeric vector
#'
multiplyBy3 <- function(base_number) {
stopifnot(is.numeric(base_number))
return(base_number * 3)
}
鍵位:不包括@export
和不包括@keywords internal
+0
這就是我正在尋找過去半個小時。謝謝@ arvi1000 – Veera 2016-12-04 10:03:54
相關問題
- 1. 幫助構建xml文檔
- 2. python:顯示幫助文檔
- 3. 蟒蛇「幫助」功能:打印文檔
- 4. 通用打印功能roxygen2
- 5. 「幫助」功能不顯示有關導入功能的信息
- 6. Roxygen2:重載R基本功能(COR)
- 7. 繼承R包中多個參數的Roxygen2文檔
- 8. 幫助構建Rails應用程序
- 9. R中的左連接功能幫助
- 10. R使用匹配功能的幫助
- 11. 需要一些功能的幫助R
- 12. JSDuck - 創建的文檔不顯示任何功能參數
- 13. Interactive Shutdown程序顯示幫助頁面?
- 14. 添加章節至R包的幫助/文檔
- 15. 調試C程序慢功能(通過gcc構建)
- 16. JS功能幫助 - 沒有錯誤,但不會顯示
- 17. PowerShell的幫助文檔不正確顯示
- 18. R幫助安裝存檔的軟件包'bi0ps'找不到libtiff
- 19. 需要重構此功能的幫助
- 20. 爲RestSharp構建CRUD操作的通用幫助程序
- 21. PHP需要的幫助包括功能!
- 22. 不包含JQuery拖拽幫助程序
- 23. OOP /功能幫助
- 24. Javascript功能幫助
- 25. Bash: - 幫助功能
- 26. Xpath幫助功能
- 27. Rails:Form collection_set,通過關聯表幫助顯示文本
- 28. C#文檔幫助
- 29. PyroCMS幫助文檔
- 30. 如何在R包的html幫助頁面顯示NEWS?
你只需要每包一個'useDynLib'聲明。 – hadley 2013-04-09 03:35:37
@hadley:謝謝,我已經糾正了......但仍然沒有'@ export'的函數在幫助文檔中,我希望它對最終用戶不可見。任何方法來「壓制」生產.RD文件? – alittleboy 2013-04-09 03:38:35
請勿使用roxygen註釋? – hadley 2013-04-09 04:49:49