Issue #4637 has been reported by Sho Hashimoto.

----------------------------------------
Bug #4637: Marshal.#dump の引数

http://redmine.ruby-lang.org/issues/4637

Author: Sho Hashimoto
Status: Open
Priority: Low
Assignee: Sho Hashimoto
Category: doc
Target version: 
reporter: 
ruby_version: 


細かい事ですが、Marshal.#dump の引数を r4530 現在の dump(obj, port = '', limit = -1) とした場合、以下の問題があるのではないかと思いました。

* port の説明「IO かそのサブクラスのインスタンスを指定します。」と一致しない

* 第 2 引数を文字列にできるのではないかという勘違いの種になる気がする。実際にやると TypeError。(ただし、省略すると確かに内部では空文字列を port に渡してるので間違っている訳ではない)

* 実は port を省略して第 2 引数を limit にできる事が伝わらない

という事で、るりま的には以下のように修正するのが良いように思います。

  --- Marshal	(revision 4530)
  +++ Marshal	(working copy)
  @@ -10,7 +10,8 @@
   
   == Module Functions
   
  ---- dump(obj, port = '', limit = -1) -> IO | String
  +--- dump(obj, port, limit = -1) -> IO
  +--- dump(obj, limit = -1) -> String
   
   obj を指定された出力先に再帰的に出力します。
   



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

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