* 仕様書

[6] [CITE@en-US[perlpod - the Plain Old Documentation format - metacpan.org]], [TIME[2025-10-27T14:41:31.000Z]] <https://metacpan.org/dist/perl/view/pod/perlpod.pod>

* [CODE[=encoding]]

[10] [[文字コードの指定]]。

- [7] [CITE@en-US[perlpod - the Plain Old Documentation format - metacpan.org]], [TIME[2025-10-27T14:42:50.000Z]] <https://metacpan.org/dist/perl/view/pod/perlpod.pod#%3Dencoding-encodingname>


[8] [CITE@en-US[Pod::Weaver::Section::Encoding - add a encoding pod tag with encoding (for your Perl module) - metacpan.org]], [TIME[2025-10-27T14:43:03.000Z]] <https://metacpan.org/pod/Pod::Weaver::Section::Encoding#OVERVIEW>

[9] >>8 は [CODE[# ENCODING:]] という独自仕様にも対応しています。使われているのかは謎。見たことがありません。

[11] [[Ruby]] が [CODE[# encoding:]] を解釈するらしいです。


[32] 
関連: 
[[Perlにおける文字コード]]

-*-*-

[12] [CODE[=encoding [[utf-8]]]] の実利用例:

- [13] [CITE[null]], [TIME[2025-10-27T14:58:12.000Z]] <https://fastapi.metacpan.org/source/MIKAGE/Unicode-Japanese-0.50/lib/Unicode/Japanese/JA.pod>
- [14] [TIME[2025-10-27T14:58:59.00Z]]
<https://raw.githubusercontent.com/obuk/Cv-Olive/refs/heads/master/lib/Cv/JA.pod>
-- [15] [CODE[[[coding:]] [[utf-8]]]] と併用
- [16] [TIME[2025-10-27T15:00:06.900Z]]
<https://raw.githubusercontent.com/nekokak/p5-dbix-skinny/refs/heads/master/lib/DBIx/Skinny/Manual/JA.pod>
- [17] [CITE@en[optex/script/optex at master · kaz-utashiro/optex · GitHub]], [TIME[2025-10-27T15:01:54.000Z]] <https://github.com/kaz-utashiro/optex/blob/master/script/optex>
-- [18] [[非ASCII文字]]なし
- [19] [TIME[2025-10-27T15:02:29.000Z]]
<https://raw.githubusercontent.com/kaz-utashiro/optex/refs/heads/master/docs/optex.deepl-JA.pod>
- [20] [TIME[2025-10-27T15:02:50.200Z]]
<https://raw.githubusercontent.com/kaz-utashiro/optex/refs/heads/master/docs/optex.deepl-KO.pod>


[21] [CITE[null]], [TIME[2025-10-27T15:07:03.000Z]] <https://fastapi.metacpan.org/source/DANKOGAI/Jcode-2.07/Jcode/Nihongo.pod>

[CODE[=encoding [[euc-jp]]]]

[22] [[metacpan]] は >>21 を binary といってエラーにして表示してくれません。
[TIME[2025-10-27T15:10:04.100Z]]

[30] [CITE[null]], [TIME[2025-11-06T14:37:44.000Z]] <https://perldoc.jp/docs/modules/encoding-2.6/encoding.pod.pod>

[CODE[euc-jp]]

[31] [CITE@ja[external/openssl/doc/man7/passphrase-encoding.pod · old_devel_licenses_commit · performance / storage / superDeimos · GitLab]], [TIME[2025-11-06T14:43:24.000Z]] <https://git.ichec.ie/performance/storage/superdeimos/-/blob/old_devel_licenses_commit/external/openssl/doc/man7/passphrase-encoding.pod>

[CODE[=encoding [[utf8]]]]

-*-*-

[23] [CITE[null]], [TIME[2025-10-27T15:09:10.000Z]] <https://fastapi.metacpan.org/source/DANKOGAI/Text-Kakasi-2.04/lib/Text/Kakasi/JP.pod>

[24] >>23 は [CODE[=encoding [[euc-jp]]]] がありませんが、 [[EUC-JP]]
です。 (日付がおそらく [CODE[=encoding]] が追加される前。)

[25] [[metacpan]] は >>23 をそのまま出力します。 (文字化けします。)

[28] [CITE[null]], [TIME[2025-10-27T15:12:59.000Z]] <https://fastapi.metacpan.org/source/MIYAGAWA/HTML-Entities-ImodePictogram-0.06/lib/HTML/Entities/ImodePictogram.ja.pod>

[29] >>28 は指定なしの [[EUC-JP]]。

[26] [CITE[null]], [TIME[2025-10-27T15:11:43.000Z]] <https://fastapi.metacpan.org/source/OYAMA/CGI-ConvertParam-0.05/doc/README_ja.pod>

[27] >>26 は冒頭に [CODE[charset [[EUC-JP]]]] とあります。 (人間向け?)

* MIME型

[SEE[ [[text/perl]] ]]


* メモ


[1] [CITE[日本語 POD が perldoc で読めない - daily dayflower]]
([TIME[2010-05-18 07:53:10 +09:00]] 版)
<http://d.hatena.ne.jp/dayflower/20081009/1223520774>

[2] [CITE[perldocで日本語で使おうとしてみた - ケーズメモ]]
([TIME[2010-05-18 07:53:43 +09:00]] 版)
<http://d.hatena.ne.jp/ksmemo/20090913/p1>

[3] [CITE[Pod::HTML2Pod - search.cpan.org]]
([TIME[2010-11-24 13:34:31 +09:00]] 版)
<http://search.cpan.org/~sburke/Pod-HTML2Pod-4.05/lib/Pod/HTML2Pod.pm>

[4] [CITE[perlpodspec - search.cpan.org]]
( ([TIME[2014-04-06 13:14:46 +09:00]] 版))
<http://search.cpan.org/dist/perl/pod/perlpodspec.pod>


[5] 関連:
[[ライセンス記述]]