mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
* README -> README.md: [DOC] Format README with Markdown [Bug #9255]
* README.ja -> README.ja.md: ditto git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@44684 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
parent
06d2e8aaf7
commit
87855a00a8
5 changed files with 335 additions and 358 deletions
|
@ -1,3 +1,8 @@
|
||||||
|
Thu Jan 23 13:56:16 2014 Zachary Scott <e@zzak.io>
|
||||||
|
|
||||||
|
* README -> README.md: [DOC] Format README with Markdown [Bug #9255]
|
||||||
|
* README.ja -> README.ja.md: ditto
|
||||||
|
|
||||||
Wed Jan 22 15:59:39 2014 Nobuyoshi Nakada <nobu@ruby-lang.org>
|
Wed Jan 22 15:59:39 2014 Nobuyoshi Nakada <nobu@ruby-lang.org>
|
||||||
|
|
||||||
* ext/thread/thread.c (Init_thread): ConditionVariable and Queue
|
* ext/thread/thread.c (Init_thread): ConditionVariable and Queue
|
||||||
|
|
166
README
166
README
|
@ -1,166 +0,0 @@
|
||||||
= What's Ruby
|
|
||||||
|
|
||||||
Ruby is the interpreted scripting language for quick and
|
|
||||||
easy object-oriented programming. It has many features to
|
|
||||||
process text files and to do system management tasks (as in
|
|
||||||
Perl). It is simple, straight-forward, and extensible.
|
|
||||||
|
|
||||||
|
|
||||||
== Features of Ruby
|
|
||||||
|
|
||||||
* Simple Syntax
|
|
||||||
* *Normal* Object-Oriented features(ex. class, method calls)
|
|
||||||
* *Advanced* Object-Oriented features(ex. Mix-in, Singleton-method)
|
|
||||||
* Operator Overloading
|
|
||||||
* Exception Handling
|
|
||||||
* Iterators and Closures
|
|
||||||
* Garbage Collection
|
|
||||||
* Dynamic Loading of Object files(on some architecture)
|
|
||||||
* Highly Portable (works on many Unix-like/POSIX compatible platforms
|
|
||||||
as well as Windows, Mac OS X, BeOS etc.)
|
|
||||||
cf. http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/SupportedPlatforms
|
|
||||||
|
|
||||||
|
|
||||||
== How to get Ruby
|
|
||||||
|
|
||||||
For a complete list of ways to install Ruby, including using third party
|
|
||||||
tools like rvm, see:
|
|
||||||
|
|
||||||
http://www.ruby-lang.org/en/downloads/
|
|
||||||
|
|
||||||
The Ruby distribution files can be found in the following FTP site:
|
|
||||||
|
|
||||||
ftp://ftp.ruby-lang.org/pub/ruby/
|
|
||||||
|
|
||||||
The trunk of the Ruby source tree can be checked out with the
|
|
||||||
following command:
|
|
||||||
|
|
||||||
$ svn co http://svn.ruby-lang.org/repos/ruby/trunk/ ruby
|
|
||||||
|
|
||||||
Or if you are using git then use the following command:
|
|
||||||
|
|
||||||
$ git clone git://github.com/ruby/ruby.git
|
|
||||||
|
|
||||||
There are some other branches under development. Try the following
|
|
||||||
command and see the list of branches:
|
|
||||||
|
|
||||||
$ svn ls http://svn.ruby-lang.org/repos/ruby/branches/
|
|
||||||
|
|
||||||
Or if you are using git then use the following command:
|
|
||||||
|
|
||||||
$ git ls-remote git://github.com/ruby/ruby.git
|
|
||||||
|
|
||||||
== Ruby home-page
|
|
||||||
|
|
||||||
The URL of the Ruby home-page is:
|
|
||||||
|
|
||||||
http://www.ruby-lang.org/
|
|
||||||
|
|
||||||
|
|
||||||
== Mailing list
|
|
||||||
|
|
||||||
There is a mailing list to talk about Ruby.
|
|
||||||
To subscribe this list, please send the following phrase
|
|
||||||
|
|
||||||
subscribe YourFirstName YourFamilyName
|
|
||||||
e.g.
|
|
||||||
subscribe Joseph Smith
|
|
||||||
|
|
||||||
in the mail body (not subject) to the address <mailto:ruby-talk-ctl@ruby-lang.org>.
|
|
||||||
|
|
||||||
|
|
||||||
== How to compile and install
|
|
||||||
|
|
||||||
This is what you need to do to compile and install Ruby:
|
|
||||||
|
|
||||||
0. If you want to use Microsoft Visual C++ to compile ruby,
|
|
||||||
read win32/README.win32 instead of this document.
|
|
||||||
|
|
||||||
1. If +./configure+ does not exist or is older than configure.in,
|
|
||||||
run autoconf to (re)generate configure.
|
|
||||||
|
|
||||||
2. Run +./configure+, which will generate config.h and Makefile.
|
|
||||||
|
|
||||||
Some C compiler flags may be added by default depending on your
|
|
||||||
environment. Specify <tt>optflags=..</tt> and <tt>warnflags=..</tt> as
|
|
||||||
necessary to override them.
|
|
||||||
|
|
||||||
3. Edit +defines.h+ if you need. Usually this step will not be needed.
|
|
||||||
|
|
||||||
4. Remove comment mark(<tt>#</tt>) before the module names from +ext/Setup+
|
|
||||||
(or add module names if not present), if you want to link modules
|
|
||||||
statically.
|
|
||||||
|
|
||||||
If you don't want to compile non static extension modules
|
|
||||||
(probably on architectures which does not allow dynamic loading),
|
|
||||||
remove comment mark from the line "<tt>#option nodynamic</tt>" in
|
|
||||||
+ext/Setup+.
|
|
||||||
|
|
||||||
Usually this step will not be needed.
|
|
||||||
|
|
||||||
5. Run +make+.
|
|
||||||
|
|
||||||
6. Optionally, run '<tt>make check</tt>' to check whether the compiled Ruby
|
|
||||||
interpreter works well. If you see the message "<tt>check succeeded</tt>",
|
|
||||||
your ruby works as it should (hopefully).
|
|
||||||
|
|
||||||
7. Run '<tt>make install</tt>'
|
|
||||||
|
|
||||||
This command will create following directories and install files
|
|
||||||
onto them.
|
|
||||||
|
|
||||||
* <tt>${DESTDIR}${prefix}/bin</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/site_ruby</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/vendor_ruby</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/gems/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/share/man/man1</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/share/ri/${MAJOR}.${MINOR}.${TEENY}/system</tt>
|
|
||||||
|
|
||||||
If Ruby's API version is '_x.y.z_', the <tt>${MAJOR}</tt> is '_x_', the
|
|
||||||
<tt>${MINOR}</tt> is '_y_', and the <tt>${TEENY}</tt> is '_z_'.
|
|
||||||
|
|
||||||
*NOTE*: teeny of the API version may be different from one of
|
|
||||||
Ruby's program version
|
|
||||||
|
|
||||||
You may have to be a super user to install ruby.
|
|
||||||
|
|
||||||
If you fail to compile ruby, please send the detailed error report with
|
|
||||||
the error log and machine/OS type, to help others.
|
|
||||||
|
|
||||||
Some extension libraries may not get compiled because of lack of
|
|
||||||
necessary external libraries and/or headers, then you will need to run
|
|
||||||
'<tt>make distclean-ext</tt>' to remove old configuration after
|
|
||||||
installing them in such case.
|
|
||||||
|
|
||||||
== Copying
|
|
||||||
|
|
||||||
See the file +COPYING+.
|
|
||||||
|
|
||||||
== Feedback
|
|
||||||
|
|
||||||
Questions about the Ruby language can be asked on the Ruby-Talk mailing list
|
|
||||||
(http://www.ruby-lang.org/en/community/mailing-lists) or on websites like
|
|
||||||
(http://stackoverflow.com).
|
|
||||||
|
|
||||||
Bug reports should be filed at http://bugs.ruby-lang.org
|
|
||||||
|
|
||||||
== The Author
|
|
||||||
|
|
||||||
Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in 1995.
|
|
||||||
|
|
||||||
<mailto:matz@ruby-lang.org>
|
|
||||||
|
|
||||||
--
|
|
||||||
Local variables:
|
|
||||||
mode: rdoc
|
|
||||||
end:
|
|
192
README.ja
192
README.ja
|
@ -1,192 +0,0 @@
|
||||||
= Rubyとは
|
|
||||||
|
|
||||||
Rubyはシンプルかつ強力なオブジェクト指向スクリプト言語です.
|
|
||||||
Rubyは最初から純粋なオブジェクト指向言語として設計されていま
|
|
||||||
すから,オブジェクト指向プログラミングを手軽に行う事が出来ま
|
|
||||||
す.もちろん通常の手続き型のプログラミングも可能です.
|
|
||||||
|
|
||||||
Rubyはテキスト処理関係の能力などに優れ,Perlと同じくらい強力
|
|
||||||
です.さらにシンプルな文法と,例外処理やイテレータなどの機構
|
|
||||||
によって,より分かりやすいプログラミングが出来ます.
|
|
||||||
|
|
||||||
|
|
||||||
== Rubyの特長
|
|
||||||
|
|
||||||
* シンプルな文法
|
|
||||||
* 普通のオブジェクト指向機能(クラス,メソッドコールなど)
|
|
||||||
* 特殊なオブジェクト指向機能(Mixin, 特異メソッドなど)
|
|
||||||
* 演算子オーバーロード
|
|
||||||
* 例外処理機能
|
|
||||||
* イテレータとクロージャ
|
|
||||||
* ガーベージコレクタ
|
|
||||||
* ダイナミックローディング (アーキテクチャによる)
|
|
||||||
* 移植性が高い.多くのUnix-like/POSIX互換プラットフォーム上で
|
|
||||||
動くだけでなく,Windows, Mac OS X,BeOSなどの上でも動く
|
|
||||||
cf. http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/SupportedPlatformsJa
|
|
||||||
|
|
||||||
== 入手法
|
|
||||||
|
|
||||||
=== FTPで
|
|
||||||
|
|
||||||
以下の場所においてあります.
|
|
||||||
|
|
||||||
ftp://ftp.ruby-lang.org/pub/ruby/
|
|
||||||
|
|
||||||
=== Subversionで
|
|
||||||
|
|
||||||
開発先端のソースコードは次のコマンドで取得できます.
|
|
||||||
|
|
||||||
$ svn co http://svn.ruby-lang.org/repos/ruby/trunk/ ruby
|
|
||||||
|
|
||||||
他に開発中のブランチの一覧は次のコマンドで見られます.
|
|
||||||
|
|
||||||
$ svn ls http://svn.ruby-lang.org/repos/ruby/branches/
|
|
||||||
|
|
||||||
=== Gitで
|
|
||||||
|
|
||||||
SubversionのミラーをGitHubに公開しています.
|
|
||||||
以下のコマンドでリポジトリを取得できます.
|
|
||||||
|
|
||||||
$ git clone git://github.com/ruby/ruby.git
|
|
||||||
|
|
||||||
== ホームページ
|
|
||||||
|
|
||||||
RubyのホームページのURLは
|
|
||||||
|
|
||||||
http://www.ruby-lang.org/
|
|
||||||
|
|
||||||
です.
|
|
||||||
|
|
||||||
|
|
||||||
== メーリングリスト
|
|
||||||
|
|
||||||
Rubyのメーリングリストがあります。参加希望の方は
|
|
||||||
|
|
||||||
mailto:ruby-list-ctl@ruby-lang.org
|
|
||||||
|
|
||||||
まで本文に
|
|
||||||
|
|
||||||
subscribe YourFirstName YourFamilyName
|
|
||||||
|
|
||||||
と書いて送って下さい。
|
|
||||||
|
|
||||||
Ruby開発者向けメーリングリストもあります。こちらではrubyのバ
|
|
||||||
グ、将来の仕様拡張など実装上の問題について議論されています。
|
|
||||||
参加希望の方は
|
|
||||||
|
|
||||||
mailto:ruby-dev-ctl@ruby-lang.org
|
|
||||||
|
|
||||||
までruby-listと同様の方法でメールしてください。
|
|
||||||
|
|
||||||
Ruby拡張モジュールについて話し合うruby-extメーリングリストと
|
|
||||||
数学関係の話題について話し合うruby-mathメーリングリストと
|
|
||||||
英語で話し合うruby-talkメーリングリストもあります。参加方法
|
|
||||||
はどれも同じです。
|
|
||||||
|
|
||||||
|
|
||||||
== コンパイル・インストール
|
|
||||||
|
|
||||||
以下の手順で行ってください.
|
|
||||||
|
|
||||||
1. もし +configure+ ファイルが見つからない、もしくは
|
|
||||||
+configure.in+ より古いようなら、 +autoconf+ を実行して
|
|
||||||
新しく +configure+ を生成する
|
|
||||||
|
|
||||||
2. +configure+ を実行して +Makefile+ などを生成する
|
|
||||||
|
|
||||||
環境によってはデフォルトのCコンパイラ用オプションが付き
|
|
||||||
ます. +configure+ オプションで <tt>optflags=..</tt> <tt>warnflags=..</tt> 等
|
|
||||||
で上書きできます.
|
|
||||||
|
|
||||||
3. (必要ならば)+defines.h+ を編集する
|
|
||||||
|
|
||||||
多分,必要無いと思います.
|
|
||||||
|
|
||||||
4. (必要ならば)+ext/Setup+ に静的にリンクする拡張モジュールを
|
|
||||||
指定する
|
|
||||||
|
|
||||||
+ext/Setup+ に記述したモジュールは静的にリンクされます.
|
|
||||||
|
|
||||||
ダイナミックローディングをサポートしていないアーキテク
|
|
||||||
チャでは +Setup+ の1行目の「<tt>option nodynamic</tt>」という行のコ
|
|
||||||
メントを外す必要があります.また,このアーキテクチャで
|
|
||||||
拡張モジュールを利用するためには,あらかじめ静的にリン
|
|
||||||
クしておく必要があります.
|
|
||||||
|
|
||||||
5. +make+ を実行してコンパイルする
|
|
||||||
|
|
||||||
6. <tt>make check</tt>でテストを行う.
|
|
||||||
|
|
||||||
「<tt>check succeeded</tt>」と表示されれば成功です.ただしテスト
|
|
||||||
に成功しても完璧だと保証されている訳ではありません.
|
|
||||||
|
|
||||||
7. <tt>make install</tt>
|
|
||||||
|
|
||||||
以下のディレクトリを作って,そこにファイルをインストー
|
|
||||||
ルします.
|
|
||||||
|
|
||||||
* <tt>${DESTDIR}${prefix}/bin</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/site_ruby</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/vendor_ruby</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/lib/ruby/gems/${MAJOR}.${MINOR}.${TEENY}</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/share/man/man1</tt>
|
|
||||||
* <tt>${DESTDIR}${prefix}/share/ri/${MAJOR}.${MINOR}.${TEENY}/system</tt>
|
|
||||||
|
|
||||||
RubyのAPIバージョンが'_x.y.z_'であれば,<tt>${MAJOR}</tt>は
|
|
||||||
'_x_'で,<tt>${MINOR}</tt>は'_y_',<tt>${TEENY}</tt>は'_z_'です.
|
|
||||||
|
|
||||||
<b>注意</b>: APIバージョンの +teeny+ は,Rubyプログラムのバージョ
|
|
||||||
ンとは異なることがあります.
|
|
||||||
|
|
||||||
+root+ で作業する必要があるかもしれません.
|
|
||||||
|
|
||||||
もし,コンパイル時にエラーが発生した場合にはエラーのログとマ
|
|
||||||
シン,OSの種類を含むできるだけ詳しいレポートを作者に送ってく
|
|
||||||
ださると他の方のためにもなります.
|
|
||||||
|
|
||||||
|
|
||||||
== 移植
|
|
||||||
|
|
||||||
UNIXであれば +configure+ がほとんどの差異を吸収してくれるはずで
|
|
||||||
すが,思わぬ見落としがあった場合(あるに違いない),作者にその
|
|
||||||
ことをレポートすれば,解決できるかも知れません.
|
|
||||||
|
|
||||||
アーキテクチャにもっとも依存するのはGC部です.RubyのGCは対象
|
|
||||||
のアーキテクチャが<tt>setjmp()</tt>または<tt>getcontext()</tt>によって全てのレ
|
|
||||||
ジスタを +jmp_buf+ や +ucontext_t+ に格納することと, +jmp_buf+ や
|
|
||||||
+ucontext_t+ とスタックが32bitアラインメントされていることを仮定
|
|
||||||
しています.特に前者が成立しない場合の対応は非常に困難でしょう.
|
|
||||||
後者の解決は比較的簡単で, +gc.c+ でスタックをマークしている
|
|
||||||
部分にアラインメントのバイト数だけずらしてマークするコードを
|
|
||||||
追加するだけで済みます.<tt>defined(\_\_mc68000\_\_)</tt>で括られてい
|
|
||||||
る部分を参考にしてください.
|
|
||||||
|
|
||||||
レジスタウィンドウを持つCPUでは,レジスタウィンドウをスタッ
|
|
||||||
クにフラッシュするアセンブラコードを追加する必要があるかも知
|
|
||||||
れません.
|
|
||||||
|
|
||||||
|
|
||||||
== 配布条件
|
|
||||||
|
|
||||||
+COPYING.ja+ ファイルを参照してください。
|
|
||||||
|
|
||||||
|
|
||||||
== 著者
|
|
||||||
|
|
||||||
コメント,バグレポートその他は mailto:matz@ruby-lang.org まで.
|
|
||||||
-------------------------------------------------------
|
|
||||||
created at: Thu Aug 3 11:57:36 JST 1995
|
|
||||||
--
|
|
||||||
Local variables:
|
|
||||||
mode: rdoc
|
|
||||||
end:
|
|
164
README.ja.md
Normal file
164
README.ja.md
Normal file
|
@ -0,0 +1,164 @@
|
||||||
|
# Rubyとは
|
||||||
|
|
||||||
|
Rubyはシンプルかつ強力なオブジェクト指向スクリプト言語です. Rubyは最初から純粋なオブジェクト指向言語として設計されていま
|
||||||
|
すから,オブジェクト指向プログラミングを手軽に行う事が出来ま す.もちろん通常の手続き型のプログラミングも可能です.
|
||||||
|
|
||||||
|
Rubyはテキスト処理関係の能力などに優れ,Perlと同じくらい強力 です.さらにシンプルな文法と,例外処理やイテレータなどの機構
|
||||||
|
によって,より分かりやすいプログラミングが出来ます.
|
||||||
|
|
||||||
|
## Rubyの特長
|
||||||
|
|
||||||
|
* シンプルな文法
|
||||||
|
* 普通のオブジェクト指向機能(クラス,メソッドコールなど)
|
||||||
|
* 特殊なオブジェクト指向機能(Mixin, 特異メソッドなど)
|
||||||
|
* 演算子オーバーロード
|
||||||
|
* 例外処理機能
|
||||||
|
* イテレータとクロージャ
|
||||||
|
* ガーベージコレクタ
|
||||||
|
* ダイナミックローディング (アーキテクチャによる)
|
||||||
|
* 移植性が高い.多くのUnix-like/POSIX互換プラットフォーム上で 動くだけでなく,Windows, Mac OS
|
||||||
|
X,BeOSなどの上でも動く cf.
|
||||||
|
http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/SupportedPlatformsJa
|
||||||
|
|
||||||
|
|
||||||
|
## 入手法
|
||||||
|
|
||||||
|
### FTPで
|
||||||
|
|
||||||
|
以下の場所においてあります.
|
||||||
|
|
||||||
|
ftp://ftp.ruby-lang.org/pub/ruby/
|
||||||
|
|
||||||
|
### Subversionで
|
||||||
|
|
||||||
|
開発先端のソースコードは次のコマンドで取得できます.
|
||||||
|
|
||||||
|
$ svn co http://svn.ruby-lang.org/repos/ruby/trunk/ ruby
|
||||||
|
|
||||||
|
他に開発中のブランチの一覧は次のコマンドで見られます.
|
||||||
|
|
||||||
|
$ svn ls http://svn.ruby-lang.org/repos/ruby/branches/
|
||||||
|
|
||||||
|
### Gitで
|
||||||
|
|
||||||
|
SubversionのミラーをGitHubに公開しています. 以下のコマンドでリポジトリを取得できます.
|
||||||
|
|
||||||
|
$ git clone git://github.com/ruby/ruby.git
|
||||||
|
|
||||||
|
## ホームページ
|
||||||
|
|
||||||
|
RubyのホームページのURLは
|
||||||
|
|
||||||
|
http://www.ruby-lang.org/
|
||||||
|
|
||||||
|
です.
|
||||||
|
|
||||||
|
## メーリングリスト
|
||||||
|
|
||||||
|
Rubyのメーリングリストがあります。参加希望の方は
|
||||||
|
|
||||||
|
mailto:ruby-list-ctl@ruby-lang.org
|
||||||
|
|
||||||
|
まで本文に
|
||||||
|
|
||||||
|
subscribe YourFirstName YourFamilyName
|
||||||
|
|
||||||
|
と書いて送って下さい。
|
||||||
|
|
||||||
|
Ruby開発者向けメーリングリストもあります。こちらではrubyのバ グ、将来の仕様拡張など実装上の問題について議論されています。 参加希望の方は
|
||||||
|
|
||||||
|
mailto:ruby-dev-ctl@ruby-lang.org
|
||||||
|
|
||||||
|
までruby-listと同様の方法でメールしてください。
|
||||||
|
|
||||||
|
Ruby拡張モジュールについて話し合うruby-extメーリングリストと 数学関係の話題について話し合うruby-mathメーリングリストと
|
||||||
|
英語で話し合うruby-talkメーリングリストもあります。参加方法 はどれも同じです。
|
||||||
|
|
||||||
|
## コンパイル・インストール
|
||||||
|
|
||||||
|
以下の手順で行ってください.
|
||||||
|
|
||||||
|
1. もし `configure` ファイルが見つからない、もしくは `configure.in` より古いようなら、 `autoconf` を実行して
|
||||||
|
新しく `configure` を生成する
|
||||||
|
|
||||||
|
2. `configure` を実行して `Makefile` などを生成する
|
||||||
|
|
||||||
|
環境によってはデフォルトのCコンパイラ用オプションが付き ます. `configure` オプションで `optflags=..`
|
||||||
|
`warnflags=..` 等 で上書きできます.
|
||||||
|
|
||||||
|
3. (必要ならば)`defines.h` を編集する
|
||||||
|
|
||||||
|
多分,必要無いと思います.
|
||||||
|
|
||||||
|
4. (必要ならば)`ext/Setup` に静的にリンクする拡張モジュールを 指定する
|
||||||
|
|
||||||
|
`ext/Setup` に記述したモジュールは静的にリンクされます.
|
||||||
|
|
||||||
|
ダイナミックローディングをサポートしていないアーキテク チャでは `Setup` の1行目の「`option nodynamic`」という行のコ
|
||||||
|
メントを外す必要があります.また,このアーキテクチャで 拡張モジュールを利用するためには,あらかじめ静的にリン クしておく必要があります.
|
||||||
|
|
||||||
|
5. `make` を実行してコンパイルする
|
||||||
|
|
||||||
|
6. `make check`でテストを行う.
|
||||||
|
|
||||||
|
「`check succeeded`」と表示されれば成功です.ただしテスト に成功しても完璧だと保証されている訳ではありません.
|
||||||
|
|
||||||
|
7. `make install`
|
||||||
|
|
||||||
|
以下のディレクトリを作って,そこにファイルをインストー ルします.
|
||||||
|
|
||||||
|
* `${DESTDIR}${prefix}/bin`
|
||||||
|
* `${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}/${PLATFOR
|
||||||
|
M}`
|
||||||
|
* `${DESTDIR}${prefix}/lib`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/site_ruby`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}/${P
|
||||||
|
LATFORM}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/vendor_ruby`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}/$
|
||||||
|
{PLATFORM}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/gems/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/share/man/man1`
|
||||||
|
* `${DESTDIR}${prefix}/share/ri/${MAJOR}.${MINOR}.${TEENY}/system`
|
||||||
|
|
||||||
|
|
||||||
|
RubyのAPIバージョンが'*x.y.z*'であれば,`${MAJOR}`は
|
||||||
|
'*x*'で,`${MINOR}`は'*y*',`${TEENY}`は'*z*'です.
|
||||||
|
|
||||||
|
**注意**: APIバージョンの `teeny` は,Rubyプログラムのバージョ ンとは異なることがあります.
|
||||||
|
|
||||||
|
`root` で作業する必要があるかもしれません.
|
||||||
|
|
||||||
|
|
||||||
|
もし,コンパイル時にエラーが発生した場合にはエラーのログとマ シン,OSの種類を含むできるだけ詳しいレポートを作者に送ってく
|
||||||
|
ださると他の方のためにもなります.
|
||||||
|
|
||||||
|
## 移植
|
||||||
|
|
||||||
|
UNIXであれば `configure` がほとんどの差異を吸収してくれるはずで すが,思わぬ見落としがあった場合(あるに違いない),作者にその
|
||||||
|
ことをレポートすれば,解決できるかも知れません.
|
||||||
|
|
||||||
|
アーキテクチャにもっとも依存するのはGC部です.RubyのGCは対象
|
||||||
|
のアーキテクチャが`setjmp()`または`getcontext()`によって全てのレ ジスタを `jmp_buf` や `ucontext_t`
|
||||||
|
に格納することと, `jmp_buf` や `ucontext_t` とスタックが32bitアラインメントされていることを仮定
|
||||||
|
しています.特に前者が成立しない場合の対応は非常に困難でしょう. 後者の解決は比較的簡単で, `gc.c` でスタックをマークしている
|
||||||
|
部分にアラインメントのバイト数だけずらしてマークするコードを 追加するだけで済みます.`defined(_\*mc68000*\_)`で括られてい
|
||||||
|
る部分を参考にしてください.
|
||||||
|
|
||||||
|
レジスタウィンドウを持つCPUでは,レジスタウィンドウをスタッ クにフラッシュするアセンブラコードを追加する必要があるかも知 れません.
|
||||||
|
|
||||||
|
## 配布条件
|
||||||
|
|
||||||
|
`COPYING.ja` ファイルを参照してください。
|
||||||
|
|
||||||
|
## 著者
|
||||||
|
|
||||||
|
コメント,バグレポートその他は mailto:matz@ruby-lang.org まで.
|
||||||
|
---
|
||||||
|
created at: Thu Aug 3 11:57:36 JST 1995 -- Local variables: mode: rdoc end:
|
166
README.md
Normal file
166
README.md
Normal file
|
@ -0,0 +1,166 @@
|
||||||
|
# What's Ruby
|
||||||
|
|
||||||
|
Ruby is the interpreted scripting language for quick and easy object-oriented
|
||||||
|
programming. It has many features to process text files and to do system
|
||||||
|
management tasks (as in Perl). It is simple, straight-forward, and
|
||||||
|
extensible.
|
||||||
|
|
||||||
|
## Features of Ruby
|
||||||
|
|
||||||
|
* Simple Syntax
|
||||||
|
* **Normal** Object-Oriented features(ex. class, method calls)
|
||||||
|
* **Advanced** Object-Oriented features(ex. Mix-in, Singleton-method)
|
||||||
|
* Operator Overloading
|
||||||
|
* Exception Handling
|
||||||
|
* Iterators and Closures
|
||||||
|
* Garbage Collection
|
||||||
|
* Dynamic Loading of Object files(on some architecture)
|
||||||
|
* Highly Portable (works on many Unix-like/POSIX compatible platforms as
|
||||||
|
well as Windows, Mac OS X, BeOS etc.) cf.
|
||||||
|
http://bugs.ruby-lang.org/projects/ruby-trunk/wiki/SupportedPlatforms
|
||||||
|
|
||||||
|
|
||||||
|
## How to get Ruby
|
||||||
|
|
||||||
|
For a complete list of ways to install Ruby, including using third party tools
|
||||||
|
like rvm, see:
|
||||||
|
|
||||||
|
http://www.ruby-lang.org/en/downloads/
|
||||||
|
|
||||||
|
The Ruby distribution files can be found in the following FTP site:
|
||||||
|
|
||||||
|
ftp://ftp.ruby-lang.org/pub/ruby/
|
||||||
|
|
||||||
|
The trunk of the Ruby source tree can be checked out with the following
|
||||||
|
command:
|
||||||
|
|
||||||
|
$ svn co http://svn.ruby-lang.org/repos/ruby/trunk/ ruby
|
||||||
|
|
||||||
|
Or if you are using git then use the following command:
|
||||||
|
|
||||||
|
$ git clone git://github.com/ruby/ruby.git
|
||||||
|
|
||||||
|
There are some other branches under development. Try the following command
|
||||||
|
and see the list of branches:
|
||||||
|
|
||||||
|
$ svn ls http://svn.ruby-lang.org/repos/ruby/branches/
|
||||||
|
|
||||||
|
Or if you are using git then use the following command:
|
||||||
|
|
||||||
|
$ git ls-remote git://github.com/ruby/ruby.git
|
||||||
|
|
||||||
|
## Ruby home-page
|
||||||
|
|
||||||
|
The URL of the Ruby home-page is:
|
||||||
|
|
||||||
|
http://www.ruby-lang.org/
|
||||||
|
|
||||||
|
## Mailing list
|
||||||
|
|
||||||
|
There is a mailing list to talk about Ruby. To subscribe this list, please
|
||||||
|
send the following phrase
|
||||||
|
|
||||||
|
subscribe YourFirstName YourFamilyName
|
||||||
|
|
||||||
|
e.g.
|
||||||
|
subscribe Joseph Smith
|
||||||
|
|
||||||
|
in the mail body (not subject) to the address
|
||||||
|
<mailto:ruby-talk-ctl@ruby-lang.org>.
|
||||||
|
|
||||||
|
## How to compile and install
|
||||||
|
|
||||||
|
This is what you need to do to compile and install Ruby:
|
||||||
|
|
||||||
|
1. If you want to use Microsoft Visual C++ to compile ruby, read
|
||||||
|
win32/README.win32 instead of this document.
|
||||||
|
|
||||||
|
2. If `./configure` does not exist or is older than configure.in, run
|
||||||
|
autoconf to (re)generate configure.
|
||||||
|
|
||||||
|
3. Run `./configure`, which will generate config.h and Makefile.
|
||||||
|
|
||||||
|
Some C compiler flags may be added by default depending on your
|
||||||
|
environment. Specify `optflags=..` and `warnflags=..` as necessary to
|
||||||
|
override them.
|
||||||
|
|
||||||
|
4. Edit `defines.h` if you need. Usually this step will not be needed.
|
||||||
|
|
||||||
|
5. Remove comment mark(`#`) before the module names from `ext/Setup` (or add
|
||||||
|
module names if not present), if you want to link modules statically.
|
||||||
|
|
||||||
|
If you don't want to compile non static extension modules (probably on
|
||||||
|
architectures which does not allow dynamic loading), remove comment mark
|
||||||
|
from the line "`#option nodynamic`" in `ext/Setup`.
|
||||||
|
|
||||||
|
Usually this step will not be needed.
|
||||||
|
|
||||||
|
6. Run `make`.
|
||||||
|
|
||||||
|
7. Optionally, run '`make check`' to check whether the compiled Ruby
|
||||||
|
interpreter works well. If you see the message "`check succeeded`", your
|
||||||
|
ruby works as it should (hopefully).
|
||||||
|
|
||||||
|
8. Run '`make install`'
|
||||||
|
|
||||||
|
This command will create following directories and install files onto
|
||||||
|
them.
|
||||||
|
|
||||||
|
* `${DESTDIR}${prefix}/bin`
|
||||||
|
* `${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}/${PLATFOR
|
||||||
|
M}`
|
||||||
|
* `${DESTDIR}${prefix}/lib`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/site_ruby`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}/${P
|
||||||
|
LATFORM}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/vendor_ruby`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}/$
|
||||||
|
{PLATFORM}`
|
||||||
|
* `${DESTDIR}${prefix}/lib/ruby/gems/${MAJOR}.${MINOR}.${TEENY}`
|
||||||
|
* `${DESTDIR}${prefix}/share/man/man1`
|
||||||
|
* `${DESTDIR}${prefix}/share/ri/${MAJOR}.${MINOR}.${TEENY}/system`
|
||||||
|
|
||||||
|
|
||||||
|
If Ruby's API version is '*x.y.z*', the `${MAJOR}` is '*x*', the
|
||||||
|
`${MINOR}` is '*y*', and the `${TEENY}` is '*z*'.
|
||||||
|
|
||||||
|
**NOTE**: teeny of the API version may be different from one of Ruby's
|
||||||
|
program version
|
||||||
|
|
||||||
|
You may have to be a super user to install ruby.
|
||||||
|
|
||||||
|
|
||||||
|
If you fail to compile ruby, please send the detailed error report with the
|
||||||
|
error log and machine/OS type, to help others.
|
||||||
|
|
||||||
|
Some extension libraries may not get compiled because of lack of necessary
|
||||||
|
external libraries and/or headers, then you will need to run '`make
|
||||||
|
distclean-ext`' to remove old configuration after installing them in such
|
||||||
|
case.
|
||||||
|
|
||||||
|
## Copying
|
||||||
|
|
||||||
|
See the file `COPYING`.
|
||||||
|
|
||||||
|
## Feedback
|
||||||
|
|
||||||
|
Questions about the Ruby language can be asked on the Ruby-Talk mailing list
|
||||||
|
(http://www.ruby-lang.org/en/community/mailing-lists) or on websites like
|
||||||
|
(http://stackoverflow.com).
|
||||||
|
|
||||||
|
Bug reports should be filed at http://bugs.ruby-lang.org
|
||||||
|
|
||||||
|
## The Author
|
||||||
|
|
||||||
|
Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in
|
||||||
|
1995.
|
||||||
|
|
||||||
|
<mailto:matz@ruby-lang.org>
|
||||||
|
|
||||||
|
-- Local variables: mode: rdoc end:
|
Loading…
Add table
Reference in a new issue