From: KOSAKI Motohiro <kosaki.motohiro@...>
Date: 2010-03-03T13:23:29+09:00
Subject: [ruby-dev:40547] Re: [Bug #1582] IO.new Raises Other Errors between 1.8 and 1.9

> いまいです。
> 
> From: Nobuhiro IMAI <nov_at_yo.rim.or.jp>
> Date: Sat, 27 Feb 2010 13:01:30 +0900
> 
> >> 上記URLはいちおう1.9.1用のはずなんですが、誰が修正担当なんでしょう？？
> >> あのURLを見るのが間違い？ ruby-lang.org からリンクが貼ってあるから、ほとんどの人は
> >> そこから誘導されていると思いますが
> > 
> > 私にはどう修正してよいのかまだ理解できていないのですが、リファレンスの
> > 問題ということは認識できたので、以下に記録してしておきました。
> > # 題名が不適切かもしれません。
> > 
> > http://redmine.ruby-lang.org/issues/show/2800
> > 
> >>>> これは意図的でしょうか？意図したものである場合、ドキュメントの修正をご検討くださいませ
> >>>
> >>> 1.8までのドキュメントのバグだと思います。
> >> 
> >> 動作としては現在の挙動が望ましいことには同意します。ただ、windowsのようにfcntl(GETFL)できない環境ではmode継承がされてないので挙動が変わってしまうのですがどこにも文書化されてません。これはこれで問題だと思います。
> > 
> > 引数だけでなく、記述を追加する必要もあるということですよね。
> 
> 今のところ、メソッドシグネチャで引数にデフォルト値がある場合は書いてお
> く、というルール[1]があるようなので、説明文だけ追加[2]しました。内容が
> あっているか見ていただけるとありがたいです。
> 
>  1. http://www.fdiary.net/ml/ruby-reference-manual/msg/360
>  2. http://redmine.ruby-lang.org/repositories/diff/rurema?rev=3924

確認しました。

エンドユーザは自分の環境がfcntlが利用できる環境かどうか知っているのだろうか？
と素朴な疑問がわきました。
まったく分かってなくて恐縮なのですが、リファレンスの習慣的には「xxが利用できる環境」
という表記と「Windows環境では」という表記のどちらが一般的なのでしょうか。
前者の場合、なにも問題ないと思います。