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

2014/04/12

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
    とくに使い方はありません。

やったー！

カテゴリ: Perl