Question

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

转换新内容
重写
使用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中它缺少文本 < / p>

Answer 1

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

Answer 2

我刚下载了你发布的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 的人。如果你通过less或more来管理这个，你的是什么$TERM环境变量设置为？可能是您的终端在通过管道传输到more或less时丢失了线路。

另外，您使用的是什么编辑器，它会在您的POD中添加不需要的缩进？

Answer 3

关于David W回答中提到的“不能破线”的警告，可以通过以下方式避免pod2usage烦恼：

将URL（或其他违规的长字符串）放在自己的行上，并在行的开头添加空格。
在包含网址的行前面加一个空行。

瞧！

insufficient rep points

perlpod：缺少文本问题

3 个答案: