memorandum — #Perl にも #RDoc みたいなのほしいPOD まあ慣れたけど、RDoc よりもドキュメントとソースコードの乖離が起こりやすいなと昔から思っていて、今もそう思っている。 なぜなら、ソースコードとPOD部分の関係が疎だから。 RDoc とか YARD みたいにそもそもコードの package 宣言や sub 宣言を解釈してドキュメントにしてくれた方が漏れがないし、RDoc 等の拡張構文を使えたら便利だと思う。 POD はリストの書き方など面倒。 …で、そういうのないかなと思って見てたら、YARD 自体にプラグインがあって、Perl コードも解析してちょうどやりたいと考えていることができそうなことはわかった。 https://github.com/pvande/yard-perl-plugin でもベータらしい。 RDoc には POD を解析できるやつはあるみたいだった。 CPAN にはそういうのはなさそうだった。 違う名前で
