man page - grotty error: character above first line discarded
man page - grotty error: character above first line discarded
在使用 Sphinx 作为手册页为 Chapel 构建 Chapel 语言文档时，遇到以下错误：
grotty:<standard input> (path/to/man3/chapel.3) :1756: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :1760: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :1764: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :4794: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :4798: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :4802: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :5505: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :5509: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :5513: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7137: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7141: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7145: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7892: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7896: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7900: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :12168: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :12172: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :12176: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :14254: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :14258: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :14262: character above first line discarded
我似乎无法具体确定导致此错误的原因。 Here is a link 到我用 sphinx 生成的手册页。如果我能找出导致错误的原因，我想我将能够修改源以某种方式防止它。
原来这是由于 grotty 程序中的一个错误，它不接受超过页面长度的垂直线。我在 2012 年的一份 debian 错误报告中发现了这一点：https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673436
我能够通过在我的手册页文件前面加上以下内容来防止错误发生：
.if n .pl 2000v
这有效地使 grotty 认为分页符实际上非常大（2000 个单位），因此它永远不会抱怨超过默认长度的垂直线。
希望有一天这对某人有所帮助。
在使用 Sphinx 作为手册页为 Chapel 构建 Chapel 语言文档时，遇到以下错误：
grotty:<standard input> (path/to/man3/chapel.3) :1756: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :1760: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :1764: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :4794: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :4798: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :4802: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :5505: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :5509: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :5513: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7137: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7141: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7145: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7892: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7896: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :7900: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :12168: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :12172: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :12176: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :14254: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :14258: character above first line discarded
grotty:<standard input> (path/to/man3/chapel.3) :14262: character above first line discarded
我似乎无法具体确定导致此错误的原因。 Here is a link 到我用 sphinx 生成的手册页。如果我能找出导致错误的原因，我想我将能够修改源以某种方式防止它。
原来这是由于 grotty 程序中的一个错误，它不接受超过页面长度的垂直线。我在 2012 年的一份 debian 错误报告中发现了这一点：https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673436
我能够通过在我的手册页文件前面加上以下内容来防止错误发生：
.if n .pl 2000v
这有效地使 grotty 认为分页符实际上非常大（2000 个单位），因此它永远不会抱怨超过默认长度的垂直线。
希望有一天这对某人有所帮助。