2008-02-12 22:11:59 +0900
(507d);
rev 17
対応したコメント、バグ報告。投稿していただいたみなさんに感謝します。
- 2007-12-31: rock: Rubyでプログラミングを始める人などに配慮して、由来が一見してわかりづらいメソッド名に由来（putsなら「put stringより」など）を書いていただけるとありがたいです。理解しやすく覚えやすくなると思います。たとえばput{c,s}, get{c,s}, glob, succ, (s)printf, chomp, rindex, rassoc, tr, (g)sub, intern, srand, zip, p, tr, {up,down}case, ord, Enumerable#zip, Enumerable#grep, Proc#arityあたり。
- sheepman: ご提案ありがとうございます。検討しますがたぶん無理です。例えば puts が本当に「put string」なのか調べる方法が分かりません。あと単純に疑問なんですが ord の由来ってなんなんでしょうね。ググった限りでは見つかりませんでした。
- 2008-01-01: rock: やはりメソッド名の由来の公式見解って無いんですね。無ければまつもとさんが作ってくださるとよいのですが。由来が書けない場合は「覚え方」として書くとか。分かりにくい名前は他の言語から持ってきたものが多いですね。ord関数はPascalにもあります。Pascalでは、整数型や文字型、列挙型は順序型（ordinal types）と総称され、整数と対応づけられます。対応する整数を順序値（ordinal value）と呼ぶようです。文字型や列挙型の値から順序値を得る関数がordです。
- 2008-01-09: rock: 1.8.6版のKernel.#putsの説明で「末尾が改行で終っている引数や」の前に句点「。」が抜けているようです。ところで，http://doc.loveruby.net/refm/api/ は1.9.0版ですよね？ ウェブ上で1.8.6版はどこで見られるのでしょうか？
- sheepman: ウェブ上で1.8.6版は提供していません。
- 2008-02-12: rock: module Math の Abstract に「浮動小数点演算をサポートするクラス。」とありますが，クラスじゃなくてモジュールですよね？ ところで，「Math モジュールは同じ定義のメソッドと特異メソッドとの両方が定義されているので、」はやや分かりにくいです。ここは「Math モジュールにはさまざま数学関数がモジュール関数として定義されています。モジュール関数は以下のように，モジュールの特異メソッドとして呼び出す使い方と，モジュールをインクルードしてレシーバーを省略した形で呼び出す使い方の両方ができます。」で如何でしょうか。なお，このことを理解してもらうための例に使うなら，atan2 のような馴染みの薄いメソッドより，cos とか log のような誰でも直ちに意味が分かるメソッドのほうが無難かもしれませんね。
- 2008-02-12: rock: Math.#log にタイポ「引数が負のである場合に発生します」があります。
- 2008-02-12: rock: Module#ancestors のページで Module#included_modules に [SEE ALSO] すべきでしょう。
- 2008-02-12: rock: 1.9.0 版で，Integer#chr の説明に「文字列から文字コードを得るには "A"[0] とします」という誤った記述があります。
- 2008-01-31: rock: 1.8.6 版，1.9.0 版ともに，Range.new において「[EXCEPTION] ?ArgmentError:」となっていますが，?ArgmentError でなく ArgumentError だと思います。
- 2008-02-11: rock: class Time の Abstract の二段落めの「File.mtime」のリンク URL がおかしいようです。
- 2008-02-11: rock: class Regexp の Abstract に「正規表現のリテラルはスラッシュで囲んだ形式で生成します。」とありますが，「リテラルは」と「生成します」がマッチしません。「リテラルは」とくれば「記述します。」が適当だと思います。また，% 記法についても書くべきだと思います。
- 2008-02-12: rock: class ?SystemStackError の説明に「典型的には、メソッド呼び出しを無限再起させてしまった場合」とありますが，「無限再起」は「無限再帰」でしょうか。
- 2008-02-12: rock: 1.9.0 版の Regexp.compile の説明で，「正規表現のコンパイルに失敗した場合発生します。」は網掛けの中でなくその前に置くべきでしょう。
- 2008-01-30: rock: Kernel.#lambda の「スタックジャンプ時の挙動の違い」の下の段落で，「Proc,new はプロックを囲むメソッドを抜けます。」とありますが，「Proc,new」は「Proc.new」でしょうか？
- 2008-01-30: rock: 些細なタイポの報告です（1.8.6 版・1.9.0 版に共通）。library webrick/ssl に「明示的にを有効に」，?OptionParser#parse に「破壊的にをパースします」があります。?BigDecimal#ceil，Socket.unpack_sockaddr_un，?SystemCallError.new に「をを」があります。Object#initialize_copy に「Ruby インタプリンタ」があります。Kernel.#p に「デバック」があります。
- 2008-01-28: rock: Dir.#mkdir の説明の中に ?FileUtils.#makedirs について言及があると親切かと思います。?FileUtils.#makedirs を知らないでそういう働きのメソッドを探す人はまず Dir.#mkdir から調べたりすると思うので。
- sheepman: ありがとうございます。対応しました。
- 2008-01-15: rock: Rational#% toでも「符号」が「符合」になっています。
- 2008-01-15: rock: すみません。投稿ミスです。書きたかったのは「Rational#% と Rational#divmod でも「符号」が「符合」になっています。ほかにもありそう」でした。
- sheepman: 対応しました
- 2008-01-09: rock: 1.8.6版のKernel.#putsの説明で「末尾が改行で終っている引数や」の前に句点「。」が抜けているようです。ところで，http://doc.loveruby.net/refm/api/ は1.9.0版ですよね？ ウェブ上で1.8.6版はどこで見られるのでしょうか？
- sheepman: ウェブ上で1.8.6版は提供していません。
- 2008-01-05: rock: Numeric#moduloの説明で「符号」が「符合」になってます。
- sheepman: ありがとうございます。対応しました。
- 2007-12-31: rock: Rubyでプログラミングを始める人などに配慮して、由来が一見してわかりづらいメソッド名に由来（putsなら「put stringより」など）を書いていただけるとありがたいです。理解しやすく覚えやすくなると思います。たとえばput{c,s}, get{c,s}, glob, succ, (s)printf, chomp, rindex, rassoc, tr, (g)sub, intern, srand, zip, p, tr, {up,down}case, ord, Enumerable#zip, Enumerable#grep, Proc#arityあたり。
- sheepman: ご提案ありがとうございます。検討しますがたぶん無理です。例えば puts が本当に「put string」なのか調べる方法が分かりません。あと単純に疑問なんですが ord の由来ってなんなんでしょうね。ググった限りでは見つかりませんでした。
- 2008-01-01: rock: やはりメソッド名の由来の公式見解って無いんですね。無ければまつもとさんが作ってくださるとよいのですが。由来が書けない場合は「覚え方」として書くとか。分かりにくい名前は他の言語から持ってきたものが多いですね。ord関数はPascalにもあります。Pascalでは、整数型や文字型、列挙型は順序型（ordinal types）と総称され、整数と対応づけられます。対応する整数を順序値（ordinal value）と呼ぶようです。文字型や列挙型の値から順序値を得る関数がordです。
- 2007-12-31: rock: Numeric#scalar?の説明で「自身がスカラーである場合に true を返します。」とありますが、「スカラー」の意味が不明です（しかもPerlから来た人には誤解を招く）。このメソッドの働きは、「自身が実数（虚部が0の複素数）のときにtrueを返す」ではないでしょうか？（そもそもこのメソッド名自体が妥当と思えないのですが…）
- 2007-12-27: rock: 1.9でjcodeが無くなったのに1.9版にjcodeのページがあります。
- 2007-12-27: rock: Math.#rsqrt の件，マニュアルを読みちがえていたようです。岩月様ありがとうございました。ただ，Math.#rsqrt のページに「redefined by mathn」と書かれているので，元から Math モジュールにあったように読めます。
- 2007-12-27: フナミ: はじめてきました、とても読みやすくなって、うれしいです。サイト内の検索機能は予定されていますか？Googleにインデックスされればいいような気もしますが、窓があるとちょっと便利です。
- 2007-12-26: 岩月: Math.rsqrt()はrequire 'mathn'すると使えるようになります。
- 2007-12-26: 岩月: Enumerable#mapなどがキーワードに含まれないのはchmファイル生成時のミスでした。すみません。修正分を用意しました。→ReleasedProducts
- 2007-12-26: rock: Math.#rsqrt が何をするメソッドなのか書いてありません（読めばわかりますが）。あと（mathn を require しないで） 1.8.6 で試すと Math.rsqrt(4) が undefined method になるのですが？
- 2007-12-26: mamamoto: リリースされたものを試してみたのですが、ruby-refm-1.9.0.chmでキーワードからmapと入力してもEnumerable#mapが引っかかりません。別名を持つメソッドの片方が引っかかってないみたいです。
- 2007-02-14: gonts: こんにちは。いまの検索だと、用語集の単語にヒットした場合にいちいち用語全体から探さなきゃいけない（各単語にリンクしてないから）のが不満でした。あと初心者用のチュートリアルはつくんですか？あったらうれしいな・・・書きっぱなしですが、以上です。
- 2007-02-06: eklerni:
丁寧な返事ありがとうございます、納得しました。個人的には青木さんの書く
new言語仕様に一番期待しています。いまのものは網羅度が不十分・書きっぱなしな
印象を受ける（構成の統一感がない）ので。では失礼します。
初めまして。いままでのマニュアルではデッドリンクの多さが気になっていました。それで考えたのですが、
BitClustにデッドリンク調査機能はつけられないでしょうか。（遅い？）
新版でHTML Helpとかはおそらく定期的に自動生成されるのでしょうが、その際などに
マニュアル内の外部リンクのリンク先をチェックして、
%W[ページが見つかりません ページを表示できません 取り消されたアクション このページは移転しました
商品が見つかりませんでした Forbidden no? longer? available Object? not? found! Error Oops! ERROR]
などが表示先に含まれていたらメンテナの方に自動で報告が行く（パッチ投稿みたいなノリで）というようなシステムです。
メンテナの方はその情報をもとに修正したり、問題ないので報告対象から除外したりするわけです。
フィルターから除外するＵＲＬを決めておいたり、フィルター文字列をメンテナ個々人で追加設定できたり、
色々バリエーションは考えられますが・・・、検討よろしくお願いします。
あと２点ほど。Sienaさんへの回答の内容にたいする質問ですが
>メソッドの要約が見られる、短い一覧があったほうがよいでしょう
これは実装の予定はあるのでしょうか？一行にメソッド+一言説明が並んでいるような
コンパクトな一覧があると視認性も良いと思います。一言説明の抽出方法が謎ですが。
あと、Rubyに標準で添付・配布されているライブラリの呼び方はいろいろあるようですが、
なんて呼ぶのが適当なのでしょうか？（新版ではどの呼称が採用されるか）
'標準添付ライブラリ'が個人的には好きなんですが
最後になりましたが、プロジェクトの成功をお祈りしています。長文失礼しました。
- 2006-11-09: Siena,: クラスのページの冒頭に、ライブラリのページの冒頭にあるようなメソッド一覧があると便利に思います。現リファレンスで不便に感じているところなので、ぜひ。
system revision 1.162