替代rdoc用法

Question

根据this post的说法，RDoc::usage目前在Ruby1.9中不可用。有没有好的替代品？

我很有兴趣知道标准安装中有什么可用，以及gems中有什么可用。

Answer 1

我喜欢OptionParser (文章中提到的RDoc::usage是有用的补充)。

它看起来像任何1.9个bug的have been patched。

Answer 2

在feature request 2713中，rdoc维护者表示，他不会将rdoc/usage或任何类似的功能添加回rdoc，而是应该使用OptionParser。

Answer 3

我们对所有的新脚本都使用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/"

-

module BB
    def BB::usage( exit_code )

        File::open( $0, 'r').readlines.each_with_index do | line, idx |
            next if idx == 0
            if( line =~ /^#/ )
                puts line.gsub(/^#\ ?/,'')
            else
                puts #RDoc adds extra line so we do too
                exit( exit_code )
            end
        end
    end
end