perldoc

How do I use Unicode characters in Pod and perldoc?

由 三世轮回 提交于 2020-01-10 12:10:32
问题 I need to use utf-8 characters in my perl-documentation. If I use: perldoc MyMod.pm I see strange characters. If I use: pod2text MyMod.pm everything is fine. I use Ubuntu/Debian. $ locale LANG=de_DE.UTF-8 LC_CTYPE="de_DE.UTF-8" LC_NUMERIC="de_DE.UTF-8" LC_TIME="de_DE.UTF-8" LC_COLLATE="de_DE.UTF-8" LC_MONETARY="de_DE.UTF-8" LC_MESSAGES="de_DE.UTF-8" LC_PAPER="de_DE.UTF-8" LC_NAME="de_DE.UTF-8" LC_ADDRESS="de_DE.UTF-8" LC_TELEPHONE="de_DE.UTF-8" LC_MEASUREMENT="de_DE.UTF-8" LC_IDENTIFICATION=

Where in the documentation does it say that while tests readdir for definedness?

由 久未见 提交于 2019-12-23 11:48:03
问题 See also: How is "0" result from readdir not false in a while condition?. ( Not a duplicate; just closely related. ) Where in the documentation does it say that while tests readdir for definedness? For instance, this code #!/usr/bin/perl use strict; use warnings; opendir my $dir, "/tmp" or die "$!"; while (my $file = readdir($dir)) { print "$file\n"; } closedir $dir; when run through B::Deparse yields: use warnings; use strict 'refs'; die "$!" unless opendir my $dir, '/tmp'; while (defined(my

Where in the documentation does it say that while tests readdir for definedness?

由 萝らか妹 提交于 2019-12-23 11:47:47
问题 See also: How is "0" result from readdir not false in a while condition?. ( Not a duplicate; just closely related. ) Where in the documentation does it say that while tests readdir for definedness? For instance, this code #!/usr/bin/perl use strict; use warnings; opendir my $dir, "/tmp" or die "$!"; while (my $file = readdir($dir)) { print "$file\n"; } closedir $dir; when run through B::Deparse yields: use warnings; use strict 'refs'; die "$!" unless opendir my $dir, '/tmp'; while (defined(my

cpanm does not register all installed modules in perllocal.pod

由 假如想象 提交于 2019-12-13 03:36:39
问题 According to CPAN Frequently Asked Questions: Each time a module is installed on your system, it appends information to a file called perllocal.pod I have installed several CPAN modules using cpanm , the problem is that some modules do not get registered in perllocal.pod . For example, I have installed String::Escape, String::ShellQuote, and String::Util using cpanm . If I type $ perldoc -u perllocal | grep String:: I get output: =head2 Tue Apr 21 16:47:34 2015: C<Module> L<String::Escape

Is there really no better way to document perl code than POD?

由 房东的猫 提交于 2019-12-06 18:09:41
问题 I'm a Perl programmer for a long time, but I always have problems with documentation in POD. When I use POD comments in the code, the code is difficult to read. When I use POD comments at the end of file, there is the danger that the documentation is not in sync with the code. I miss a documentation style similar to Java. /** * @description * ... */ I look for an easier and more intuitive documentation style. Is there such a thing? 回答1: A quick search found Doxygen Filter which purports to

Is there really no better way to document perl code than POD?

由 跟風遠走 提交于 2019-12-05 00:59:21
I'm a Perl programmer for a long time, but I always have problems with documentation in POD. When I use POD comments in the code, the code is difficult to read. When I use POD comments at the end of file, there is the danger that the documentation is not in sync with the code. I miss a documentation style similar to Java. /** * @description * ... */ I look for an easier and more intuitive documentation style. Is there such a thing? A quick search found Doxygen Filter which purports to allow you to use Doxygen style comments (which are very close to Javadoc) to document Perl code. Well, POD's
订阅 perldoc