From: Yukihiro Matsumoto <matz@...>
Date: 2010-10-15T10:00:59+09:00
Subject: [ruby-dev:42388] Re: [Feature: trunk] GC.stat

まつもと ゆきひろです

In message "Re: [ruby-dev:42385] Re: [Feature: trunk] GC.stat"
    on Fri, 15 Oct 2010 02:00:43 +0900, SASADA Koichi <ko1@atdot.net> writes:

|　この件、キーの名前をどうするかでちゅうぶらりんになっていました。実装の
|詳細に踏み込んだ、処理系開発者しか見ないメソッドという意味を強調するため
|に、GC.internal_statistic_information という感じで追加するのはどうでしょ
|うか。

うーん、いくらなんでもそんな名前は嫌です。GC.statでいいじゃ
ん。そこに反対したことはありません。

|　で、構造体のフィールドの名前をキーとして追加する。
|
|　rdoc には、
|
|> {:count=>1,                   # これまで GC が起こった回数
|>  :elapsed_time=>0.004,        # これまで GC にかかったユーザ時間
|
|しか載せず、もしかしたら他の情報も入っているかもしれないけれど、これは
|バージョン依存である、みたいな注釈があるような。

ドキュメントにGC.statは処理系依存で、戻り値は(最低限の共通項
以外)バージョン依存であると明記するのでどうでしょうか。