1

roxygen2用来记录我的 R 包texreg。在包中,我定义了一个通用 S4 函数extract以及许多增强其他 R 包功能的方法。在文档中,我使用@family extract标签创建交叉引用,这些交叉引用出现在每个方法相应帮助页面底部的“另请参阅”下。这是自动创建的 PDF 手册的示例屏幕截图:

在此处输入图像描述

如您所见,文档中有过多的框,有些甚至触及页面边框。这本身并不会让我太困扰(尽管显然它看起来并不专业)。但它发生在手册的大部分 204 页上,这导致了一个巨大的日志文件。这样做的结果是 travis-ci 不再在 GitHub 上成功构建包。它以以下日志结束:

...

Overfull \hbox (25.84094pt too wide) in paragraph at lines 3987--4093
[][]\T1/zi4/m/n/10 extract,clm-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 
extract,clmm-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 extract,clogit-met
hod[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 extract,coeftest-method[][][]\T1/p
tm/m/n/10 ,
 []

Overfull \hbox (55.84094pt too wide) in paragraph at lines 3987--4093
[][]\T1/zi4/m/n/10 extract,coxph-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/1
0 extract,coxph.penal-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 extract,c
oxreg-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 extract,dynlm-method[][][
]\T1/ptm/m/n/10 ,
 []

Overfull \hbox (10.84094pt too wide) in paragraph at lines 3987--4093
[][]\T1/zi4/m/n/10 extract,ergm-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10
 extract,ets-method[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 extract,fGARCH-met
hod[][][]\T1/ptm/m/n/10 , [][]\T1/zi4/m/n/10 extract,feglm-method[][][]\T1/ptm/
m/n/10 ,
 []

Overfull \hbox (15.84094pt too wide) in paragraph at lines 3987--4093
[][]\T1/zi4/m/n/10 extract,feis-method[][][]\T1/ptm/m/

The job exceeded the maximum log length, and has been terminated.

这是不幸的,因为它不仅看起来很丑,而且还阻止了包的自动化测试。@family除了不按预期使用的明显选择(从而限制用户对包功能的概述)之外,我该如何解决这个问题?

4

0 回答 0