ruby--ruby/README.ja.md

184 lines
9.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[![Actions Status: MinGW](https://github.com/ruby/ruby/workflows/MinGW/badge.svg)](https://github.com/ruby/ruby/actions?query=workflow%3A"MinGW")
[![Actions Status: MJIT](https://github.com/ruby/ruby/workflows/MJIT/badge.svg)](https://github.com/ruby/ruby/actions?query=workflow%3A"MJIT")
[![Actions Status: Ubuntu](https://github.com/ruby/ruby/workflows/Ubuntu/badge.svg)](https://github.com/ruby/ruby/actions?query=workflow%3A"Ubuntu")
[![Actions Status: Windows](https://github.com/ruby/ruby/workflows/Windows/badge.svg)](https://github.com/ruby/ruby/actions?query=workflow%3A"Windows")
[![AppVeyor status](https://ci.appveyor.com/api/projects/status/0sy8rrxut4o0k960/branch/master?svg=true)](https://ci.appveyor.com/project/ruby/ruby/branch/master)
[![Travis Status](https://app.travis-ci.com/ruby/ruby.svg?branch=master)](https://app.travis-ci.com/ruby/ruby)
[![Cirrus Status](https://api.cirrus-ci.com/github/ruby/ruby.svg)](https://cirrus-ci.com/github/ruby/ruby/master)
# Rubyとは
Rubyはシンプルかつ強力なオブジェクト指向スクリプト言語です Rubyは純粋なオブジェクト指向言語として設計されているので
オブジェクト指向プログラミングを手軽に行う事が出来ます.もちろん普通の手続き型のプログラミングも可能です.
Rubyはテキスト処理関係の能力などに優れPerlと同じくらい強力ですさらにシンプルな文法と
例外処理やイテレータなどの機構によって,より分かりやすいプログラミングが出来ます.
## Rubyの特長
* シンプルな文法
* 普通のオブジェクト指向機能(クラス,メソッドコールなど)
* 特殊なオブジェクト指向機能(Mixin特異メソッドなど)
* 演算子オーバーロード
* 例外処理機能
* イテレータとクロージャ
* ガーベージコレクタ
* ダイナミックローディング (アーキテクチャによる)
* 移植性が高い多くのUnix-like/POSIX互換プラットフォーム上で動くだけでなくWindows macOS
Haikuなどの上でも動く cf.
https://github.com/ruby/ruby/blob/master/doc/contributing.rdoc#platform-maintainers
## 入手法
サードパーティーツールを使った方法を含むRubyのインストール方法の一覧は
https://www.ruby-lang.org/ja/downloads/
を参照してください.
### Git
ミラーをGitHubに公開しています 以下のコマンドでリポジトリを取得できます.
$ git clone https://github.com/ruby/ruby.git
他のブランチの一覧は次のコマンドで見られます.
$ git ls-remote https://github.com/ruby/ruby.git
Rubyリポジトリの本来のmasterは https://git.ruby-lang.org/ruby.git にあります.
コミッタはこちらを使います.
### Subversion
古いRubyのバージョンのソースコードは次のコマンドでも取得できます
$ svn co https://svn.ruby-lang.org/repos/ruby/branches/ruby_2_6/ ruby
他のブランチの一覧は次のコマンドで見られます.
$ svn ls https://svn.ruby-lang.org/repos/ruby/branches/
## ホームページ
RubyのホームページのURLは
https://www.ruby-lang.org/
です.
## メーリングリスト
Rubyのメーリングリストがあります参加希望の方は [ruby-list-request@ruby-lang.org] まで本文に
subscribe
と書いて送って下さい.
Ruby開発者向けメーリングリストもありますこちらではrubyのバグ将来の仕様拡張など実装上の問題について議論されています
参加希望の方は [ruby-dev-request@ruby-lang.org] までruby-listと同様の方法でメールしてください
Ruby拡張モジュールについて話し合うruby-extメーリングリストと数学関係の話題について話し合うruby-mathメーリングリストと
英語でrubyについて話し合うruby-talkメーリングリストもあります参加方法はどれも同じです
[ruby-list-request@ruby-lang.org]: mailto:ruby-list-request@ruby-lang.org?subject=Join%20Ruby%20Mailing%20List&body=subscribe
[ruby-dev-request@ruby-lang.org]: mailto:ruby-dev-request@ruby-lang.org?subject=Join%20Ruby%20Mailing%20List&body=subscribe
## コンパイル・インストール
以下の手順で行ってください.
1. (Gitリポジトリから取得したソースをビルドする場合) `./autogen.sh` を実行して新しく `configure` を生成する
2. `configure` を実行して `Makefile` などを生成する
環境によってはデフォルトのCコンパイラ用オプションが付きます `configure` オプションで `optflags=..`
`warnflags=..` 等で上書きできます.
3. (必要ならば)`include/ruby/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}/${PLATFORM}`
* `${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}/${PLATFORM}`
* `${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](COPYING.ja) ファイルを参照してください.
## フィードバック
Rubyに関する質問は [Ruby-Talk](英語)や [Ruby-List](日本語)や,
[stackoverflow] などのWebサイトに投稿してください
バグ報告は https://bugs.ruby-lang.org で受け付けています.
[Ruby-Talk]: https://www.ruby-lang.org/en/community/mailing-lists
[Ruby-List]: https://www.ruby-lang.org/ja/community/mailing-lists
[stackoverflow]: https://ja.stackoverflow.com/
## 著者
Rubyのオリジナル版は1995年にまつもとゆきひろ氏によって設計・開発されました
<mailto:matz@ruby-lang.org>