Ersatz für rdoc-Nutzung

Question

Nach dieser Beitrag, RDoc::die Nutzung ist derzeit nicht verfügbar in ruby 1.9.Gibt es guten Ersatz zur Verfügung?

Ich wäre daran interessiert zu hören, was bei der standard-Installation, als auch, was das von den Edelsteinen.

Answer 1

Ich mag OptionParser (die Sache, die der Artikel erwähnt, dass RDoc::usage ist nützlich zu ergänzen).

Es sieht aus wie jede 1.9 bugs gepatcht haben.

Answer 2

In feature request 2713, die rdoc-Betreuer hat erklärt, dass er nicht noch rdoc/Verwendung oder einer ähnlichen Funktion zurück zu rdoc, sagen, dass OptionParser sollte stattdessen verwendet werden.

Answer 3

Wir verwenden OptionParser für alle neuen Skripts,hatte aber über 100+ verwendet, RDoc.Statt rewrite jedes schrieb ich diese Methode (BB ist unsere Unternehmens-namespace.ändern zu, was auch immer Sie möchten ).Es funktioniert Super.Die syntax ist etwas anders, aber den Hilfe-text, so wir sind nicht dagegen.Hoffe, es hilft!

Dann habe ich sed, um herauszufinden, alle Skripte und ändern Sie Sie.

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