1

R CMD buildRd ファイルに含まれているかどうかにかかわらず、動作が異なります\PR{}。マクロの詳細については、R拡張機能の記述を参照してください。

Rd ファイルに が含まれていない場合の例\PR{}:

$ R CMD build test
* checking for file 'test/DESCRIPTION' ... OK
* preparing 'test':
* checking DESCRIPTION meta-information ... OK
* installing the package to process help pages
* saving partial Rd database
* checking for LF line-endings in source and make files and shell scripts
* checking for empty or unneeded directories
* building 'test_0.1.tar.gz'

Rd ファイルに次のものが含まれている場合の例\PR{}:

$ R CMD build test
* checking for file 'test/DESCRIPTION' ... OK
* preparing 'test':
* checking DESCRIPTION meta-information ... OK
* installing the package to process help pages
* saving partial Rd database
* building the PDF package manual      # <- this
Hmm ... looks like a package           # <- this
Converting Rd files to LaTeX           # <- this
Creating pdf output from LaTeX ...     # <- this
Saving output to 'xxx/test.pdf' ...    # <- this
Done                                   # <- this
* checking for LF line-endings in source and make files and shell scripts
* checking for empty or unneeded directories
* building 'test_0.1.tar.gz'

追加の段階 (つまりbuilding the PDF package manual、古いコンピューターでは非常に遅くなる可能性があります...) は、.build_packages (行 619-625)の..Rd2pdfへの呼び出しによるものです。しかし、何がこの段階を引き起こすのかわかりません。さらに、やなどの他のマクロに対してのみトリガーされ、トリガーされません。\PR{}\CRANpkg{}\doi{}

誰かが何が起こったのか、そしてその理由を追跡できますか? 質問は基本R関数のみです。などのヘルパーは使用しませんdevtools。

最小限のテスト パッケージ

パッケージ構造

test
test/man
test/man/one.Rd
test/R
test/R/one.R
test/DESCRIPTION
test/NAMESPACE

test/man/one.Rd

\name{one}
\alias{one}
\title{Get One}
\description{
Rd file containing or not the PR macro:
\PR{1} % comment/uncomment this line as needed
but containing other macros:
\CRANpkg{ggplot2} and \doi{10.1002/wics.147}
}
\usage{
one()
}

test/R/one.R

one <- function() 1

test/DESCRIPTION

Package: test
Version: 0.1
Title: Test
Author: Nobody
Maintainer: Nobody <no@body.org>
Description: Test.
License: GPL-3

test/NAMESPACE

export(one)

以下を使用してビルド、チェック、およびインストールします。

$ R CMD build test
$ R CMD check test_0.1.tar.gz
$ R CMD INSTALL test_0.1.tar.gz
4

2 に答える 2

0

R の Bugzillaに関する R-core からの応答:

この\PRマクロは当初、R 自身の NEWS.Rd でのみ使用されていました が、実際にstageは適用されません。

stage=installSexpr のデフォルトには、おそらく歴史的な理由があります。ビルドは後で実装されました。stage=buildPDFマニュアルでtarballを爆破するのを避けるために、非ベースパッケージでは通常好ましいことに同意します。\doiマクロのために、部分的な Rd db が含まれることがよくあります。

NEWS.Rd の処理を​​中断せずに PR マクロを変更できるかどうか、またはその方法を確認していません。マクロは、WRE では例としてのみ言及されていることに注意してください \newcommand。一般には使えないと思います。提供されたパッケージのヘルプで、「PR#」がどのバグトラッカーを参照するかは不明です。ここにバグ レポートへのプレーンな URL を単純に含める方がよい場合があります。

それでも使用したい場合\RdOpts{stage=build}は、Rd ファイルの先頭に設定できます。(バグ 18073により、これには R >= 4.1.0 が必要です。)

于 2022-02-17T10:19:33.053 に答える