[ruby-list:21210] Re: opttest.rb of optparse-0.6

Toshです。

In message "[ruby-list:21200] Re: opttest.rb of optparse-0.6"
    on 00/03/06, [e-mail] <[e-mail]> writes:
>  α版日本語ドキュメントを書いてます。
>
>http://member.nifty.ne.jp/nokada/archvie/optparse.rd.ja.gz <- ソース
>http://member.nifty.ne.jp/nokada/optparse.html.ja          <- HTML版

# RDの方のURLにtypoがありました。
# <URL:http://http://member.nifty.ne.jp/nokada/archive/optparse.rd.ja.gz>

>  オブジェクトの関連図とか、途中でめげてる部分も多々ありますが、
>批評／添削などなどしていただけるとありがたいです。m(__)m

ざっと見てみました。
クラスリファレンスとしては求められている物はほぼ全て揃っていると思い
ます。あとは、簡単な例を題材としたチュートリアルさえあればかなりわかり
やすくなると思います。

チュートリアルは
  : とっても簡単な例を使う。
      opttestはちょっと盛りだくさんすぎるのではないかと思います。
      OptionParser#onと#on_head, #on_tail, あとはとても簡単な
      #acceptの例があって、くらいで。
  : 手順をStep by Stepで明示。
      (1) OptionParser.new
      (2) OptionParser#on, ... で初期化
      (3) OptionParser#parse で解析
    みたいなのを例の前に書いておく。

とかが欲しいです。あまり長くなっちゃうとあれですから、リファレンスと
分けた方がいいかも？
同じ事を実現するparseargの例もあるとOptionParserのアピールになるかも
しれません。

それと、リファレンスの方も全てのメソッドにそれぞれ簡単な例が付いていたり
するとわかりやすいのです。が、さすがにそこまでいくとむっちゃ大変そう。

以上です。多少なりともご参考になれば。

---
Tosh
Toshiro Kuwabara