Issue #7417 has been updated by sho-h (Sho Hashimoto).


> > Object#_dump、Object#marshal_load、Object#marshal_dump のいずれも存在しない
> Object クラスには他にも to_ ではじまる変換メソッド群の説明もあるのでその点は問題には感じませんでした。
> marshal_load/marshal_dump は現状のままで説明を to_a 等にならって修正すればいいんじゃないでしょうか。

そんな記述があったんですね。

うーん、個人的には「デフォルトでは定義されていません。」と記述があるようなメソッド群はすべてない方がいいと思います。「必要に応じてサブクラスで定義すべきものです。」とあっても、どのサブクラスか不明です。つまり、「おぉ、勉強になった」と思う人でどのクラスの話かわからなくても大丈夫な方への記述になってしまうと思っています。そんな人はそもそも知らなくていいのではないでしょうか。少なくとも暗黙の変換については各メソッドの @param で記述されるべきと思います。

また、わざわざるりま側から、rdoc との乖離を進めてもいい事はないと思います。rdoc についても同じようにするのであれば別なのですが...

しかし、それは別のチケットにすべき話かもしれませんね。現状から見たらデメリットはないので修正しようかと思います。
----------------------------------------
Bug #7417: Object#_dump の @see
https://bugs.ruby-lang.org/issues/7417#change-33634

Author: pypypy567 (py _)
Status: Open
Priority: Normal
Assignee: 
Category: 
Target version: 
reporter: 
ruby_version: 


Object#_dump の記事中に _load へのリンクがないです。
Class にあるはずと気付くまでちょっと悩みました。



-- 
http://bugs.ruby-lang.org/

--
ML: ruby-reference-manual@m...
Info: http://QuickML.com/