r - CRAN 发现警告 R CMD check --as-cran does not

Question

我在 Windows 7 上使用 32 位 R 3.1.2。

我最近对一个最近开发的包进行了 R CMD 检查 --as-cran 并且只收到了“新提交”的注释。此处和 R-devel 上的研究表明可以忽略这一点。我还使用了 devtools::build_win() 并且没有收到任何注释或警告，除了前面提到的那个。此外，我使用 R CMD build 和 R CMD INSTALL --build 在本地构建了包，一切正常，包括 PDF 手册。

在提交给 CRAN 后，我被告知抛出了警告:

    This fails to make its manual:

    * checking PDF version of manual ... WARNING
    LaTeX errors when creating PDF version.
    This typically indicates Rd problems.
    LaTeX errors found:
    ! Missing $ inserted.
    <inserted text>
                    $
    l.682 }{}

    ! Missing } inserted.
    <inserted text>
                    }
    l.682 }{}

    ...

    The line appears to be

    \widehat{R_1} = \frac{\sum\limits_{i=1}^n{c_i/n}}{\sum\limits_{i=1}^n{L_i/n}}

此处的其他研究表明我使用 win-builder.r-project.org/在开发版本上检查我的包，该测试的结果只抛出“新提交”警告。

我很迷茫。我无法复制 CRAN 发现的错误，在我的机器和 win-builder.r-project.org 上一切似乎都正常工作， 也。

有人可以帮我解决这个问题吗？我自由地承认我不是 LaTeX 专家，但考虑到该行不是 Windows 上的 R 3.1.2 或 win-build 上的开发版本的问题，我不知道从哪里开始。

包装信息可在此处获得:

creelSurvey

我使用inlinedocs 包来编写我的函数和注释。警告来自 .R，第 127 行:

this function

和 .Rd 第 39 行:

this .Rd

感谢您的帮助。

Answer 1

通过克隆 Github 存储库并运行，我能够使用 r-devel 在 Ubuntu 12.04 上重现此问题

R CMD build creelSurvey
R CMD check --as-cran BusRouteCreelSurvey_0.2.1.tar.gz

我能够修复它，方法是从 人/SimulateBusRoute.Rd。我不知道在 Windows 上执行此操作的最简单方法(您可以寻找 dos2unix 实用程序，或者可能想出一个 readLines 解决方案。

我不知道它如何跨平台工作，但这似乎对我有用:

fn <- "MakeAnglers.Rd"
r <- readLines(fn)
writeLines(r[nchar(r)>0],con="new.Rd")

我会 (1) 在 R Extensions manual 中寻找(可能晦涩难懂的)警告关于行尾标记，然后 (2) 向 CRAN 维护者或通过在 r-devel@r-project.org 上发帖报告。

一般来说，如果您可以在 Linux 系统上进行测试构建，您应该能够检测到这些问题；我不知道适用于 Linux 系统的 win-builder.r-project.org 的等价物，但是 http://travis-ci.org是一个很好的资源，this Github project是在 Travis 上开始使用 R 项目的好方法。 (或者您可以在 R-forge 上设置您的项目。)我认识到这可能比您现在正在寻找的项目更重要，只是包括它以供将来引用。