Perl Old Documentation

[1] POD(パールオールドドキュメンテーション)とは
簡易なマークアップ言語。
$cat hoge.pod
=pod
=head1 タイトル
こんな感じです。あちこちに空行が必要なようです。
=cut

[2] manページやHTMLページに変換
上のPOD形式の hoge.pod を
　　$ sudo apt install perl-doc
　　$ pod2man hoge.pod > hoge-man
　　$ pod2html hoge.pod > hoge.html
で、manドキュメントやHTMLページに変換できる。

[3] manページとしてみるには
　　$ man -l hoge-man
で、manドキュメントとして見れる。
恒久的には、
　　$ mkdir ~/man/man1
　　$ mv hoge-man ~/man/man1/hoge-man.1
　　$ man --manpath=~/man hoge-man
とすることで、以降は
　　$man hoge-man
だけで見ることができるようになる。あまり使い勝手は良くないかも？