4


1

この投稿によると、RDoc

usageは現在ruby 1.9では利用できません。 良い代替品はありますか?

私は標準インストールから何が入手できるのか、そしてgemから入手できるのは何か聞きたいです。

3 Answer


4


私はhttp://www.ruby-doc.org/stdlib/libdoc/optparse/rdoc/classes/OptionParser.html[OptionParser]が好きです(記事で `+ RDoc

usage +`が補完するのに役立つと言及していること) 。

http://redmine.ruby-lang.org/search/index/ruby-19?q=optparse 1.9という1.9のバグのように見えます


2


http://redmine.ruby-lang.org/issues/show/2713[feature request 2713]で、rdocメンテナはrdoc / usageまたは同様の機能をrdocに追加しないことを述べ、OptionParserはそうするべきだと言って代わりに使用してください。


1


すべての新しいスクリプトにOptionParserを使用しますが、RDocを使用するのは約100でした。 私はこの方法を書いたそれぞれを書き直す代わりに(BBは私たちの会社の名前空間です)。 あなたが好きなものにそれを変更します)。 それは素晴らしい仕事です。 構文は少し異なりますが、ヘルプテキストなので構いません。 それが役に立てば幸い!

それから、sedを使用してすべてのスクリプトを見つけてそれらを変更しました。

grep -rl "RDoc :: usage" * | xargs sed -i "/ rdoc \ / usage / s / RDoc / BB /" grep -rl "BB :: usage" * | xargs sed -i "/ rdoc \ / usage / s / rdoc / lib \ / bb /"

-

モジュールBB def BB :: usage(exit_code)

File :: open($ 0、 'r')readlines.each_with_index行、IDX |次に、idx == 0の場合(line =〜/ ^#/)がline.gsub(/ ^#\?/、 '')の場合、#RDocを追加すると余分な行が追加されるので終了します(exit_code)end end end end