codoc
位于 tools
包(package)。 说明
查找实际和记录的 ‘structure’ 之间的不一致之处R包中的对象。codoc
比较函数参数的名称以及可选的相应位置和默认值。codocClasses
和codocData
分别比较 S4 类的槽名称和数据集的变量名称。
用法
codoc(package, dir, lib.loc = NULL,
use.values = NULL, verbose = getOption("verbose"))
codocClasses(package, lib.loc = NULL)
codocData(package, lib.loc = NULL)
参数
package |
命名已安装包的字符串。 |
dir |
指定包根源目录路径的字符串。这必须包含子目录‘男人' 和R文档来源(Rd 格式)和‘R' 和R代码。仅在以下情况下使用 |
lib.loc |
目录名称的字符向量R Library ,或 |
use.values |
if |
verbose |
一个合乎逻辑的。如果是 |
细节
的目的codoc
是检查函数对象的记录用法是否与其定义中的形式参数一致R代码。这并不总是简单的,特别是因为泛型函数的方法的使用信息通常使用泛型的名称而不是方法。
使用以下算法。如果使用了已安装的软件包,则会加载该软件包(除非它是base
包),在可能分离已加载的包版本之后。否则,如果使用源,则R包的代码文件是在新环境中收集和获取的。然后,“尽可能多”地提取和解析 Rd 文件的使用部分,以提供形式记录。对于代码环境中的解释函数,根据参数的值在代码和文档之间比较形式use.values
.
如果包具有命名空间,则会检查导出和未导出的对象以及注册的 S3 方法。 (万一出现差异,顺序是导出包中的对象、注册的 S3 方法,最后是命名空间中的对象,并且仅检查第一个找到的对象。)
目前,R 文档格式没有针对类和数据集的基本 ‘structure’ 的高级标记(类似于函数概要的使用部分)。通过适当编辑 prompt
创建的 ‘templates’ 获得的文档对象中数据帧的变量名称由 codocData
识别并使用,前提是文档对象用于单个数据帧(即只有一个别名)。 codocClasses
类似地处理通过编辑 promptClass
创建的 shell 获得的文档对象中的类的槽名称。
帮助文件名为“软件包名称-已失效.Rd’对于适当的软件包名称检查更宽松,因为它们可能有未记录的参数。
值
codoc
返回类 "codoc"
的对象。目前,这是一个列表,对于包中发现不一致的每个 Rd 对象,包含一个带有不匹配列表的元素(这些元素又是带有元素 code
和 docs
的列表,给出相应的参数从函数的代码和记录的用法中获得)。
codocClasses
和 codocData
分别返回类 "codocClasses"
和 "codocData"
的对象,其结构类似于类 "codoc"
。
有 print
方法可以很好地显示此类对象中包含的信息。
注意
默认为use.values
已更改为FALSE
到NULL
, 为了R1.9.0 及更高版本。
也可以看看
相关用法
- R compactPDF 压缩 PDF 文件
- R checkVignettes 检查包装插图
- R checkMD5sums 检查并创建 MD5 校验和文件
- R checkFF 检查外部函数调用
- R checkTnF 检查 R 包或 T/F 代码
- R charsets 字符集之间的转换表
- R checkRdaFiles 报告已保存图像的详细信息或重新保存它们
- R checkRd 检查 Rd 对象
- R checkPoFiles 检查翻译文件中格式字符串不一致的情况
- R check_packages_in_dir 检查源码包及其反向依赖
- R update_PACKAGES 更新现有的 PACKAGES 文件
- R print.via.format 打印实用程序
- R prepare_Rd 准备用于渲染的解析 Rd 对象
- R startDynamicHelp 启动动态 HTML 帮助系统
- R getVignetteInfo 获取有关已安装 Vignettes 的信息
- R matchConcordance 源行和目标行之间的一致性
- R Rd2HTML 路转换器
- R HTMLheader 为 R 帮助生成标准 HTML 标头
- R undoc 查找未记录的对象
- R vignetteInfo 有关晕影的基本信息
- R HTMLlinks 从包文档收集 HTML 链接
- R xgettext 从包中的 R 文件中提取可翻译消息
- R toTitleCase 将标题转换为标题大小写
- R package_native_routine_registration_skeleton 编写用于将本机例程注册添加到包的框架
- R parse_Rd 解析 Rd 文件
注:本文由纯净天空筛选整理自R-devel大神的英文原创作品 Check Code/Documentation Consistency。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。