r - 手册和小插图有什么区别？

Question

我一直在阅读 R 的 Affy 手册，它指的是其他小插曲。这两个术语之间的区别是否仅与内容数量有关，还是更多？

Answer 1

引用手册
包的引用手册是一个单独的文档，以包描述开头，包含 .Rd 中的所有内容。包的帮助文件。通常，这意味着它具有包中(导出)函数的帮助文件、任何记录的数据集和包级文档(如果包含)。它是从 .Rd 自动生成的来源。
每个包都有说明书。即使没有导出函数和文档的包仍然会有一个手册(构建时)，其中包含描述文件中的文本。
小插曲
插图是自由格式的文档。通常，包作者使用它们来演示他们的包的使用。它们是可选的，有些包有几个(在我写这篇文章时 dplyr has 8 vignettes)，而很多包没有。

正如评论中提到的，R 扩展手册是所有与包相关的内容的权威来源。 Here is Josh's link to the Vignettes Section , 和 2.15 Processing documentation files描述了如何构建引用手册。