[Perl]PODを日本語で書いてperldocで表示させる方法

PODを日本語で書く方法を紹介します。

PODを普通に日本語で書いて、普通にperldoc hoge.pl すると日本語が"XXX"になる上にgroffが古いみたいな警告が出てしまいます。
$ perldoc  ~/pod.pl
You have an old groff. Update to version 1.20.1 for good Unicode support.
If you don't upgrade, wide characters may come out oddly.

 at /opt/plenv/versions/5.18.2/lib/perl5/5.18.2/Pod/Perldoc.pm line 1346.
You have an old groff. Update to version 1.20.1 for good Unicode support.
If you don't upgrade, wide characters may come out oddly.

 at /opt/plenv/versions/5.18.2/lib/perl5/5.18.2/Pod/Perldoc.pm line 1346.
POD(1)                User Contributed Perl Documentation               POD(1)



NAME
       XXXXXXXXXX

SINOPSYS
       XXXXXXXXXXXXX

日本語でPODを書く方法

  • utf8で書いて保存する
  • =encoding utf8と書く
  • perldoc -t で表示する
日本語PODのサンプルコード
pod.pl
#!/usr/bin/env perl

print "Hello World\n";

=pod

=encoding utf8

=head1 NAME

はろーわーるどです。

=head1 SINOPSYS

とくに使い方はありません。

=cut
実行結果
$ perldoc -t  pod.pl
NAME
    はろーわーるどです。

SINOPSYS
    とくに使い方はありません。
やったー!
カテゴリ:

人気記事