ねこ丸です。
References: <003501c3a473$187fd150$434283d2@...>
"KAWAI,Takanori" <GCD00051@...> さん writes
In 「[TSperl:285] Re: スクリプトのドキュメント、どうやって書いてます?」
> といっても関数のパラメータはこうしなはれってことは書いてません
> けども。後は手本となるモジュールのPODのマネをするというのが
> 一番だと思います。
つらつらと眺めてはみたのですが、、、
なんだかやっぱりビミョーです。というのもどうにもモジュールの pod って
man を前提に書かれているような感じじゃないですか。やっぱり情報が「荒い」
気がするんですよ。ざっと理解してそれを「使う」分にはいいんだけど、いじろ
うとするにはちょっと足りないって感じしませんか?
# 見つけていない「いい例」があるのかもしれませんが。
まぁ公開前提なら先人の作法に倣った方がいいんでしょうが、今回のものは完
全クローズドなものなので、詳しく書けるように自由に使おうかなと思っていま
す。具合悪くなったらそのとき考えるってことで。
--
ねこ丸