0

我遇到了 pod2usage 缺少文本的问题，我尝试通过以下方式修复它：

  1. 转换换行符
  2. 重写它
  3. 用 podchecker 检查它

但这些都无助于解决或暗示我的问题

podchecker 的输出：

YaTC.pod pod syntax OK.

完整的吊舱：

http://pastebin.com/igH8SamN

Pod2text 输出：

剪断

Bool: Use special characters

    If Nth = 0, this is the left arrow
Data: ISO Language Code:



    * Missing data *


    <http://www.w3schools.com/tags/ref_language_codes.asp?output=print>
    <http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes>
Data: Main size:

* Missing data *


    Maximum size limit, where Nth = 0 if X axis
Data: Minimum size:

剪断

信息：

我的操作系统是 OpenSuSE 11.4 Linux 2.6.37.6-0.7-default i686 i686 i386，GNU/Linux

我的编辑器是 SciTE 版本 1.77

此外 ，POD 嵌入在 Perl 代码中，通过以下代码调用 pod2text：

    if ( !$conf{'Bool_Use_plain_text_for_help'} ) {
    my $help = $helpframe->PodText(
        -scrollbars => '',
        -file       => $0,
        -wrap       => 'word',
        -background => 'white',
        -width      => 150,
        -height     => 500
    )->pack( -side => 'top', -fill => 'both', -expand => 1 );
}
else {
    my $help = $helpframe->Text(
        -wrap       => 'word',
        -background => 'white',
        -width      => 150,
        -height     => 500
    )->pack( -side => 'top', -fill => 'both', -expand => 1 );

    $help->insert( 'end', qx{pod2text '$0'} );
}

Pod2text 版本： 未知（不在man, info,help或中pod2text --help）

终端信息：

TERM=xterm
COLORTERM=1

编辑： 这个错误似乎源于 Tk::Text，我在控制台中尝试了 pod2html，看起来还可以，但是在 Tk 中它缺少文本

4

3 回答 3

2

看起来它正在尝试验证您的mailto链接，这绝对是无效的。如果您想使用mailto链接，请确保它们包含至少看起来像有效电子邮件地址的内容。

于 2011-12-11T11:22:47.237 回答
1

我刚刚下载了您发布的 pod，一切似乎都运行良好。我在我的 Mac 和 Windows XP 机器上都使用了perldoc和命令。pod2text两者都生成了正确的 POD，没有任何错误。

我对您的 POD 的唯一问题是它被标记为 Unix 格式，但每行末尾都有 CRLF。我使用 VIM 删除了“CR”字符（它显示为 ^M）。但是，这并不影响 POD 本身。

我还做了一个pod2text pod3.txt > pod_text.txt并检查了生成的文本文件。同样，一切看起来都很好。

你还有问题吗？POD 本身似乎没有问题，并且两者都在我的系统perldoc上pod2text产生了良好的输出。如果您仍然遇到问题，我会说它归结为：

  • 您的pod2text.
  • 你的环境。你是在 Linux 还是 Windows 机器上（就像我必须问一个用户名是linuxrules49的人。如果你通过管道传递这个lessor more，你的$TERM环境变量设置是什么？可能是你的终端正在丢失线路通过管道传输到more或less。

另外，您使用什么编辑器在您的 POD 中放置不需要的缩进？

于 2011-12-12T16:53:44.327 回答
1

关于 David W 的回答中提到的“不能断线”警告，可以通过执行以下操作来避免 pod2usage 烦恼：

  1. 将 URL（或其他有问题的长字符串）放在单独的行中，并在行首使用空格。
  2. 在包含 URL 的行之前放置一个空行。

瞧！

顺便说一句，我会把这个作为评论留在答案中，而不是开始一个全新的答案，但我显然没有足够的代表点:(

于 2013-09-07T00:25:34.853 回答