2009年7月30日

[ruby-list:46242] 「Rubyリファレンスマニュアル刷新計画」2009-07分のスナップショットリリース

「Rubyリファレンスマニュアル刷新計画」メンバーの okkez です。
# ruby-list に出すのを忘れてました orz

月一回の予定でリリースする予定のスナップショットリリースが出来上がったので
お知らせします。

○ ダウンロード

* パッケージ版(1.8.7/1.9.1):
http://www.ruby-lang.org/ja/man/archive/ruby-refm-1.9.1-dynamic-20090729.tar.bz2
(3.8MB)
http://www.ruby-lang.org/ja/man/archive/ruby-refm-1.9.1-dynamic-20090729.tar.gz
(5.6MB)
http://www.ruby-lang.org/ja/man/archive/ruby-refm-1.9.1-dynamic-20090729.zip
(15.4MB)
* chm版(1.8.7/1.9.1):
http://www.ruby-lang.org/ja/man/archive/ruby-refm-1.8.7-20090729.chm
(予定)
http://www.ruby-lang.org/ja/man/archive/ruby-refm-1.9.1-20090729.chm
(予定)
* ミラー
http://doc.okkez.net/archives/200907/
* Webからの閲覧:
http://doc.loveruby.net/refm/api/
http://doc.okkez.net/

また ftp://ftp.ruby-lang.org/pub/ruby/doc/
http://www.ruby-lang.org/ja/downloads/
に書かれている各ミラーサイトからもダウンロードできるようになる予定です。

パッケージ版にはコンパイル済みのデータベースと、コマンドライン用の
リファレンス検索ツール「refe」の最新版が同梱されています。またWEBrick
を利用した簡易Webサーバが含まれており、ネットワークがない環境でもWeb
ブラウザでリファレンスが見られるようになっています。
詳しい使い方は、アーカイブに含まれるドキュメントを参照してください。

○ 前回リリース以降の変更点

* 多くのライブラリのリファレンスが更新されました

○ 新リファレンスの特徴

* 組み込みライブラリのほぼ全てのメソッドに対し、内容の見直しを行いました。
ruby 1.8.7 にほぼ完全に対応しています (1.9.1には一部対応)。
* 各メソッドに対し、引数と返り値についての説明(型や使い方)が付加されました。
* 使用するRubyのバージョンに合わせたリファレンスを表示できるように
なりました。
* 書式のフォーマットがより厳密に規定されたので、よりプログラムで処理
し易いデータを提供できるようになりました。

○ その他、細かな変更点

* 組み込みのグローバル定数/変数/関数は Kernel 以下に移動されました。
* 「Ruby FAQ」のコーナーはリファレンスとは趣旨が異なるため分離されました。

○ 間違いを見つけたら…

もしリファレンスに間違いを見つけたら、まずは最新版で直っていないか確認
してみてください。( http://doc.loveruby.net/refm/api/ )
直っていなければ、
* Wikiのコメント欄 ( http://doc.loveruby.net/wiki/PublicComments.html )
* ITS ( http://redmine.ruby-lang.org/projects/show/rurema )
* 本プロジェクトのメーリングリスト ( http://doc.loveruby.net/wiki/MailingList.html )
等でご連絡いただけると有難いです。

○ 今後の予定

* 優先順位と作業範囲を明確にして 2009-12 にリリースする
* Ruby 1.9.1 への完全対応
* Ruby 1.8.7 への完全対応
* 添付ライブラリへの完全対応
* 「Ruby言語仕様」「Rubyの文法」のリライト
* 管理システムの改善 (静的HTMLやinfo形式でのリファレンス提供等)

…などなど、本プロジェクトはまだまだたくさんの方の助力を必要としています。
Rubyの仕様に詳しい方、Rubyの仕様に詳しくなりたい方、文章の腕を磨きたい方、
ぜひ我々と一緒にリファレンスマニュアルを書いてみませんか?

http://doc.loveruby.net/wiki/FrontPage.html

たくさんの方のご参加をお待ちしています。

--
okkez <okkez000@xxxxx>
fingerprint = F05D 1C37 1AD0 76B5 A451 D01D 7F98 8974 DEC7 1A04

投稿者 xml-rpc : 2009年7月30日 00:38
役に立ちました?:
過去のフィードバック 平均:(0) 総合:(0) 投票回数:(0)
本記事へのTrackback: http://hoop.euqset.org/blog/mt-tb2006.cgi/87113
トラックバック
コメント
コメントする




画像の中に見える文字を入力してください。