如果不可能,那么处理从UTF-8编码的POD派生的手册页的最佳实践是什么?
为了在POD中使用Unicode,要做的第一件事是使用指令
=encoding UTF-8
(如here所述)。
pod2text
和pod2html
工具可以正常工作,并产生完美的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/