RDOC 사용을 대체합니다

Question

에 따르면 이 게시물, RDOC :: 사용량은 현재 Ruby 1.9에서 사용할 수 없습니다. 좋은 교체품이 있습니까?

표준 설치에서 구할 수있는 내용과 보석에서 제공되는 내용을 듣고 싶습니다.

Answer 1

좋아요 옵션 파서 (기사에서 언급 한 것 RDoc::usage 보완하는 데 유용합니다).

1.9 버그처럼 보입니다 패치되었습니다.

Answer 2

~ 안에 기능 요청 2713, RDOC 관리자는 RDOC/사용법 또는 유사한 기능을 RDOC에 추가하지 않을 것이라고 말했습니다.

Answer 3

우리는 모든 새 스크립트에 옵션 파서를 사용하지만 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