如果不可能,那么处理从UTF-8编码的POD派生的手册页的最佳实践是什么?

为了在POD中使用Unicode,要做的第一件事是使用指令

=encoding UTF-8

(如here所述)。 pod2textpod2html工具可以正常工作,并产生完美的UTF-8编码输出。

但是,pod2man工具不会:
pod2man -u MyModule.pm | nroff -Tutf8 -man | less
perldoc也没有。非ASCII字符全部被整齐或X-ed输出。 perlbug上有some inconclusive discussion,它可能是pod2man还是** roff *中的错误。

由于我的模块专门处理Unicode,并且打算在CPAN上分发,因此必须启用Unicode的手册页。

我正在使用Perl 5.14.2,perldoc 3.15和* roff 1.21。

最佳答案

你真幸运! This bug似乎是fixed in Pod::Perldoc 3.16。因此,只需更新Pod::Perldoc即可解决一半问题。

但是,pod2man来自different distribution,并且是完全不同的代码库。对于UTF-8,它仍然是坏的。不幸的是,这是Perl安装程序用来生成手册页的方式。

关于perl - 如何在Perl POD派生的手册页中使用Unicode字符?,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/13065495/

10-10 04:39