2011-12-11 117 views
0

我在哪里pod2usage缺少文字问题,我曾尝试解决它:perlpod:缺少文本问题

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

但这些东西都没有帮助水库olve或暗示我的问题

输出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默认的i686 i686的的i386,GNU/Linux的

我的编辑被赛特版本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版本:未知(不maninfo,helppod2text --help

终端信息:

TERM=xterm 
COLORTERM=1 

编辑:此bug似乎从Tk的文本::干,我想pod2html在控制台,它似乎确定,但在传统知识是缺少文本

+1

你能不能把你的地方POD,格式化的正是你想要的方式,让我们下载它?问题是空格对于POD文档很重要,所以试图将它从你的文章中删除可能会引入可能会导致副作用的东西。如果你有[Dropbox](http://dropbox.com) ,你可以把你的POD放到公共文件夹中,然后把链接发给我们 –

+0

@DavidW。看看我的帖子 – linuxrules94

+4

做一些正常的调试工作,开始删除部分Pod,直到问题不再出现,添加东西,直到它重新出现。然后,您应该知道Pod的哪一部分是重要的唱问题。从警告中,它看起来像一个畸形的L <>。 –

回答

1

我刚刚下载了你发布的pod,并且一切看起来都很好。我在我的Mac和Windows XP上使用了perldocpod2text命令。两者都产生了正确的POD,没有任何错误。

我与你的POD唯一的问题是它被标记为Unix格式,但它在每行的末尾都有CRLF。我用VIM删除了“CR”字符(它显示为^ M)。但是,这并不影响POD本身。

我也做了pod2text pod3.txt > pod_text.txt并检查了生成的文本文件。再次,一切看起来不错。

你还有问题吗?这看起来与POD本身没有问题,并且perldocpod2text都能在我的系统上产生良好的输出。如果你仍然有问题,我会说这是下降到:

  • 您的版本pod2text
  • 您的环境。你是在Linux还是Windows机器上(例如我要问某人的用户名是linuxrules49。如果你通过lessmore管道,你的$TERM环境变量是什么设置的?可能是你的终端是在失去行,因为它得到的管道要么moreless

此外,注意到你在使用它把不必要的缩进在POD编辑器?

+1

我注意到了一些警告[p 3,8.0i]:在生成'perldoc'或'pod2man'并通过'nroff'管道时不能断开行注释。我将其追溯到生成的联机帮助页文档和超长URL。这些URL长度超过90个字符,并且nroff不能将该行分成60个字符以下。这很正常。 –

+0

我的操作系统是Opensuse Linux 2.6.37.6-0.7-default i686 i686 i386,GNU/Linux – linuxrules94

+0

我的编辑器是SciTE版本1.77 – linuxrules94

2

看起来它试图验证您的mailto链接,它确实无效。如果您想使用mailto链接,请确保它们包含至少看起来像有效电子邮件地址的内容。

+0

我试着说出你的话。 – linuxrules94

1

关于“不能断行”的警示大卫W的回答,pod2usage烦恼可以通过以下操作来避免:

  1. 将URL(或其他有问题的长字符串)放在行的开始处的空白处。
  2. 在包含URL的行之前放置一个空行。

瞧!

顺便说一句,我会离开这个作为答案,而不是开始一个全新的答案评论,但我显然有insufficient rep points :(