286. Re: スクリプトのドキュメント、どうやって書いてます?


番号順一覧Top スレッド順一覧Top
作者: ねこ丸
日時: 2003/11/10(00:11)
 ねこ丸です。

References: <003501c3a473$187fd150$434283d2@...>
"KAWAI,Takanori" <GCD00051@...> さん writes
In 「[TSperl:285] Re: スクリプトのドキュメント、どうやって書いてます?」

> といっても関数のパラメータはこうしなはれってことは書いてません
> けども。後は手本となるモジュールのPODのマネをするというのが
> 一番だと思います。

  つらつらと眺めてはみたのですが、、、
  なんだかやっぱりビミョーです。というのもどうにもモジュールの pod って 
man を前提に書かれているような感じじゃないですか。やっぱり情報が「荒い」
気がするんですよ。ざっと理解してそれを「使う」分にはいいんだけど、いじろ
うとするにはちょっと足りないって感じしませんか?

# 見つけていない「いい例」があるのかもしれませんが。

  まぁ公開前提なら先人の作法に倣った方がいいんでしょうが、今回のものは完
全クローズドなものなので、詳しく書けるように自由に使おうかなと思っていま
す。具合悪くなったらそのとき考えるってことで。

--
    ねこ丸
前の発言: 285. Re: スクリプトのドキュメント、どうやって書いてます? [KAWAI,Takanori] 2003/11/6(23:33)
後の発言: 287. 一つ POD を訳してみました [ねこ丸] 2003/11/11(15:58)
親発言: 285. Re: スクリプトのドキュメント、どうやって書いてます? [KAWAI,Takanori] 2003/11/6(23:33)
子発言: 287. 一つ POD を訳してみました [ねこ丸] 2003/11/11(15:58)