Bug #470

File::openのドキュメント

Added by Yuki Sonoda over 5 years ago. Updated almost 3 years ago.

[ruby-dev:35915]
Status:Closed
Priority:Normal
Assignee:Yuki Sonoda
Category:doc
Target version:1.9.1 Release Candidate
ruby -v: Backport:

Description

=begin
現状ではFile::openの挙動をrdocから読み取ることが困難です。

  1. IO::openの解説に、サブクラスでIO#initializeをオーバーライドした場合に引数を含めて挙動が左右されることが書かれていない
  2. IO::openの解説にIO#initializeに依存した引数の仕様だけが書いてある

    各クラスのクラスメソッドnewの解説に倣うならば、IO::openの解説とは別にFile::openのエントリが存在すべきです。

    添付(redmineに)のパッチではrdocはFile::openというエントリを認識してくれませんでした。どうも、RDoc::Parser::Cは、このようなRubyインスタンスを通じてC言語関数が多態性を持つ可能性を考慮せず、1つのrbdefinemethodについて1つのエントリを作成するように思えます。
    =end

file-open.diff Magnifier (1.39 KB) Yuki Sonoda, 08/22/2008 09:57 PM


Related issues

Precedes ruby-trunk - Bug #901: RDoc does not handle multiple method description for a C ... Closed 12/25/2008 01/01/2009

History

#1 Updated by Koichi Sasada over 5 years ago

  • Assignee set to Yukihiro Matsumoto

=begin

=end

#2 Updated by Yuki Sonoda over 5 years ago

  • Assignee deleted (Yukihiro Matsumoto)
  • Target version set to 1.9.1 Release Candidate

=begin

=end

#3 Updated by Koichi Sasada over 5 years ago

  • Assignee set to Yukihiro Matsumoto

=begin

=end

#4 Updated by Yuki Sonoda over 5 years ago

  • Assignee changed from Yukihiro Matsumoto to Yuki Sonoda

=begin
call-seq二つじゃなくて、並べて書けば、とのこと。
=end

#5 Updated by Yuki Sonoda over 5 years ago

  • Due date set to 12/24/2008

=begin

=end

#6 Updated by Yuki Sonoda over 5 years ago

  • Status changed from Open to Closed

=begin
applied in r20946.
=end

Also available in: Atom PDF