私はC++統合のためにRcppでパッケージを開発しています。関数がSEXPオブジェクトを返すようにRcppExportを使用しました。RcppとRパッケージを統合:CPPコードオブジェクトのドキュメント
問題はtravis-ciが文書化されていないコードオブジェクトがあることを警告するようです。 (これらはcpp関数です)。しかし私は、ユーザーがこれらの機能に直接アクセスすることを望まない。
この問題を解決するにはどうすればよいですか?これらの機能をどのように文書化することができますか?
私はC++統合のためにRcppでパッケージを開発しています。関数がSEXPオブジェクトを返すようにRcppExportを使用しました。RcppとRパッケージを統合:CPPコードオブジェクトのドキュメント
問題はtravis-ciが文書化されていないコードオブジェクトがあることを警告するようです。 (これらはcpp関数です)。しかし私は、ユーザーがこれらの機能に直接アクセスすることを望まない。
この問題を解決するにはどうすればよいですか?これらの機能をどのように文書化することができますか?
ここでは基本的な誤解があるようです。
あなたNAMESPACE
はワイルドカードが含まれている場合、明らかは、ヘルプ項目を必要とする文書化されているラexportPattern("^[[:alpha:]]+")
その後、各グローバルシンボルがエクスポートされあたりR規格「すべてをエクスポート」。
1つの簡単な修正では、すべてをエクスポートせず、エクスポートしたいドキュメントを作成するだけです。私たちは時々それを行い、foo_impl
のようなRcpp関数を呼び出し、R関数foo
(ドキュメントあり)をfoo_impl
と呼ぶことがあります。その場合は、foo
をエクスポートして、すべてが有効です。要するに
、あなたはRパッケージとあまりないRcppについて混乱しています。彼らが何をしているのかを感じるために、のソース(小)Rcppパッケージをダウンロードすることをお勧めします。
Rcpp C++ roxygenコメントを使用していますか? – hrbrmstr
いいえ、私はそれを使用していません。 roxygenコメントを追加するとドキュメンテーションが生成されますか? – Malith
Rcpp roxygenコメントの接頭辞は '# 'の代わりに' //' ' – coatless