Project

General

Profile

Actions

Bug #470

closed

File::openのドキュメント

Added by yugui (Yuki Sonoda) about 13 years ago. Updated over 10 years ago.

Status:
Closed
Priority:
Normal
ruby -v:
Backport:
[ruby-dev:35915]

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つのrb_define_methodについて1つのエントリを作成するように思えます。
=end


Files

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

Related issues

Precedes Ruby master - Bug #901: RDoc does not handle multiple method description for a C function properlyCloseddrbrain (Eric Hodel)12/25/200801/01/2009Actions
Actions

Also available in: Atom PDF