[ruby-list:17355] Re: ruby-man-1.4.2-jp

まつもと ゆきひろです

In message "[ruby-list:17350] ruby-man-1.4.2-jp"
    on 99/10/04, Koretsugu Daigoro <[e-mail]> writes:

|リファレンスマニュアルについて気になるところ(現状との不一致等)が
|あるので、報告・確認・質問です。

ドキュメントはなかなか現状に追い付かないので、こういう指摘は
大歓迎します。

|>           ファイル名に含まれるスペースなどを正しく扱うには， $*よりも
|>           ${1+"$@"}のほうがよいかもしれませんが，cshが解釈する場合には動
|>           作しなくなります．
|
|ここで出てくる「$*」は「"$@"」の間違いでしょうか?

上記の段落全体を削除するのが適切です。そうしました。

|>    スクリプト言語の習慣にならい，文字列中や文字表現 (?#)以外の#から行末ま
|>    でをコメントと見なします．コメント行末のバックスラッシュは次の行へのコ
|>    メントの継続を意味します．
|
|継続しないようです。

ドキュメントの修正忘れです。最後の文を削除しました。

|また、(?#)とは数値リテラルの?表現(文字コードを得る)のことですよね?

そうです。

|>           ジュールの拡張子はアーキテクチャ毎に ".so"などと異なっています
|>           が，feature名の拡張子はいつも .soを用います．
|
|バイナリモジュールの拡張子には".o",".so",DLEXTが使えるようです。
|ChangeLogや$"の表現によると".so"が標準(?)みたいですが……?

使えますが、現在は ".so" に揃えていますし、そちらを使うこと
を推奨してます。昔は ".o" でした。

|--funtion.html
|>    srand([seed])
|>           randの乱数の seedを設定し，古い初期値を返します．初期値が省略さ
|>           れた時には現在の時間を種にします．
|
|省略時に現在の時間を種にするというのは正確でないようです。
|もっとも、正確なところを書いてもあまり意味がないのも確かですが。

「時間など」にしますね。

|--Array.html
|packのtemplateに洩れ(追加し忘れ?)があるようです。
|それともundocumentedな機能なのでしょうか。
|"eEDgGMUZ%"あたりがないようです。
|"%"は未サポート、"Z"は"null padded"のようですがあとはわかりません。
|"_"も使えるみたいですが……?

チェックサムの%は今後もサポートしません。それ以外は1.4では
undocumentedなつもりでいます。

|--Array.html
|>         unshift(obj)
|>                objを配列の先頭に追加します．各要素はひとつずつ後ろにずれ
|>                ます．objを返します．
|
|追加後の配列を返すようです。

最後の文を削ることで修正します。

|--File.html
|メソッドのstatが抜けているようです。
|(lstatの説明からのリンク先がありません)

あらら、追加しておきます。

|--String.html
|unpackのtemplateにArray.html同様に洩れがあるようです。

undocumentedということで。1.5では書かなくちゃな。

|--FileTest.html
|>         size?(filename)
|>                filenameのサイズを返します．filenameが存在しない時や
|>                filenameのサイズが0の時には偽を返します．
|
|nilを返すようです。

nilも偽なのです。偽(nil)とでもしましょうか。英語版はもうちょっ
と明確にした方がよさそうですね。

|--bundle.html
|etc.htmlとparsedate.htmlがリンクだけで
|本体がないのはまだできていないからでしょうか。
|それともarchive洩れでしょうか。
|(tkに関してはドキュメントがない旨が明記されているので……)

できてないんです。

|--dbm.html

|Dict→Hashですよね?

です。お恥ずかしい。

|
|--glossary.html
|>    ビルトインクラス, Built-In Class
|>           Rubyインタプリタ組み込みでインスタンスの構造が通常のオブジェク
|>           トと異なるクラス． これらのクラスやそのサブクラスのインスタンス
|>           はインスタンス変数を持てないなど，構造の違いから来る制限がある．
|>           これらのクラスを継承したクラスを定義することはお勧めしない．
|>           Rubyのビルトインクラスは以下の通りである
|
|ビルトインクラスもインスタンス変数を持てるようです。

これも直しておきます。

|Object#instance_variablesの説明も少し変えるべきかもしれません。

というか、こちらは Object#instance_variablesのバグですね。い
つも配列を返す必要があります。

|--その他
|{R,r}uby、{P,p}erl、{M,m}ix{-,}inの表記の揺れがあります。
|{R,r}ubyは使い分けがあるようですが、
|{P,p}erlはPerlに統一できそうです。
|{M,m}ix{-,}inはMix-inが正式にみえますが……。

統一しました。

|以上のことがはっきりしたらその他の細かい修正(誤字等)も含めてpatchを
|(まつもとさんに?)送るつもりです。

最新版をwebに置いておきます。見てみてください。

|英語版はよく見ていませんが、
|仕様変更に追随できていない箇所はほぼ同じみたいです。

英語版も同様に修正しました。

                                まつもと ゆきひろ /:|)