بديلا عن استخدام rdoc

Question

ووفقا ل هذا المنصب ، RDoc :: استخدام غير متوفر حاليا في روبي 1.9. هل هناك أي بدائل الحميدة؟

وسأكون مهتما لسماع ما هو متاح من مستوى تثبيت وكذلك ما هو متاح من الأحجار الكريمة.

Answer 1

OptionParser (ولل الشيء الذي يذكر المقال أن RDoc::usage من المفيد أن تكمل).

ويبدو مثل أي 1.9 البق <لأ href = "http://redmine.ruby-lang.org/search/index/ruby-19؟q=optparse+1.9&issues=1&changesets=1&wiki_pages=1&all_words=1&titles_only=1&submit = إرسال "يختلط =" نوفولو noreferrer "> تم مصححة .

Answer 2

في ميزة طلب 2713 ، و قد ذكر معيل rdoc أنه فاز 'ر إضافة rdoc / الاستخدام أو أي ميزة مشابهة إلى rdoc، قائلا ان OptionParser ينبغي أن تستخدم بدلا من ذلك.

Answer 3

ونحن نستخدم OptionParser لجميع نصوص جديدة، ولكن كان حوالي 100+ التي كانت RDoc. بدلا من كتابة كل واحد كتبت هذه الطريقة (BB هو مساحة الشركة. تغيير ذلك إلى ما تريد). يعمل كبيرة. بناء الجملة يختلف قليلا، ولكن النص مساعدتها لذلك نحن لا مانع. نأمل أن يساعد!

وبعد ذلك استخدم الحوار الاقتصادي الاستراتيجي للعثور على جميع النصوص وتغييرها.

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