Di ricambio per rdoc utilizzo

Question

Secondo questo post, RDoc::utilizzo non è attualmente disponibile nel ruby 1.9.Ci sono buoni sostituti disponibili?

Sarei interessato a sentire quello che è disponibile presso l'installazione standard così come ciò che è disponibile dalle gemme.

Answer 1

Mi piace OptionParser (la cosa che l'articolo dice che RDoc::usage è utile per completare).

Sembra che qualsiasi 1.9 bug sono stati patchati.

Answer 2

In richiesta di funzionalità 2713, il rdoc manutentore ha dichiarato di non aggiungere rdoc/utilizzo o simili funzionalità di rdoc, dicendo che OptionParser devono essere utilizzati al posto.

Answer 3

Usiamo OptionParser per tutti i nuovi script,ma ha avuto circa 100+ che usato RDoc.Invece di riscrivere ogni uno ho scritto questo metodo (BB è la nostra azienda spazio dei nomi.il cambiamento che volete ).Funziona alla grande.La sintassi è leggermente diversa, ma il suo aiuto testo, in modo da non mente.Speranza che aiuta!

Ho quindi utilizzato sed trovare tutti gli script e li cambia.

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