diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 179 |
1 files changed, 57 insertions, 122 deletions
@@ -1,161 +1,96 @@ -# What's Ruby +[](https://github.com/ruby/ruby/actions?query=workflow%3A"MinGW") +[](https://github.com/ruby/ruby/actions?query=workflow%3A"Ubuntu") +[](https://github.com/ruby/ruby/actions?query=workflow%3A"Windows") +[](https://app.travis-ci.com/ruby/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. +[日本語](rdoc-ref:README.ja.md) -## Features of Ruby +# What is Ruby? + +Ruby is an interpreted object-oriented programming language often +used for web development. It also offers many scripting features +to process plain text and serialized files, or manage system tasks. +It is simple, straightforward, and extensible. -* 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 +## Features of Ruby +* Simple Syntax +* **Normal** Object-oriented Features (e.g. class, method calls) +* **Advanced** Object-oriented Features (e.g. mix-in, singleton-method) +* Operator Overloading +* Exception Handling +* Iterators and Closures +* Garbage Collection +* Dynamic Loading of Object Files (on some architectures) +* Highly Portable (works on many Unix-like/POSIX compatible platforms as + well as Windows, macOS, etc.) cf. + https://docs.ruby-lang.org/en/master/maintainers_md.html#label-Platform+Maintainers ## How to get Ruby -For a complete list of ways to install Ruby, including using third party tools +For a complete list of ways to install Ruby, including using third-party tools like rvm, see: -http://www.ruby-lang.org/en/downloads/ +https://www.ruby-lang.org/en/downloads/ -The Ruby distribution files can be found in the following FTP site: +You can download release packages and the snapshot of the repository. If you want to +download whole versions of Ruby, please visit https://www.ruby-lang.org/en/downloads/releases/. -ftp://ftp.ruby-lang.org/pub/ruby/ +### Download with Git -The trunk of the Ruby source tree can be checked out with the following -command: +The mirror of the Ruby source tree can be checked out with the following command: - $ svn co http://svn.ruby-lang.org/repos/ruby/trunk/ ruby + $ git clone https://github.com/ruby/ruby.git -Or if you are using git then use the following command: +There are some other branches under development. Try the following command +to see the list of branches: - $ git clone git://github.com/ruby/ruby.git + $ git ls-remote https://github.com/ruby/ruby.git -There are some other branches under development. Try the following command -and see the list of branches: +You may also want to use https://git.ruby-lang.org/ruby.git (actual master of Ruby source) +if you are a committer. - $ svn ls http://svn.ruby-lang.org/repos/ruby/branches/ +## How to build -Or if you are using git then use the following command: +See [Building Ruby](https://docs.ruby-lang.org/en/master/contributing/building_ruby_md.html) - $ git ls-remote git://github.com/ruby/ruby.git +## Ruby home page -## Ruby home-page +https://www.ruby-lang.org/ -The URL of the Ruby home-page is: +## Documentation -http://www.ruby-lang.org/ +- [English](https://docs.ruby-lang.org/en/master/index.html) +- [Japanese](https://docs.ruby-lang.org/ja/master/index.html) ## Mailing list -There is a mailing list to talk about Ruby. To subscribe this list, please -send the following phrase - - subscribe - -in the mail body (not subject) to the address -<mailto:ruby-talk-request@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. +There is a mailing list to discuss Ruby. To subscribe to this list, please +send the following phrase: - If you don't want to compile non static extension modules (probably on - architectures which do not allow dynamic loading), remove comment mark - from the line "`#option nodynamic`" in `ext/Setup`. + join - Usually this step will not be needed. +in the mail subject (not body) to the address [ruby-talk-request@ml.ruby-lang.org]. -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. +[ruby-talk-request@ml.ruby-lang.org]: mailto:ruby-talk-request@ml.ruby-lang.org?subject=join ## Copying -See the file `COPYING`. +See the file [COPYING](rdoc-ref: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). +Questions about the Ruby language can be asked on the [Ruby-Talk](https://www.ruby-lang.org/en/community/mailing-lists) mailing list +or on websites like https://stackoverflow.com. + +Bugs should be reported at https://bugs.ruby-lang.org. Read ["Reporting Issues"](https://docs.ruby-lang.org/en/master/contributing/reporting_issues_md.html) for more information. + +## Contributing -Bug reports should be filed at http://bugs.ruby-lang.org +See ["Contributing to Ruby"](https://docs.ruby-lang.org/en/master/contributing/contributing_md.html), which includes setup and build instructions. ## The Author -Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in -1995. +Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in 1995. -<mailto:matz@ruby-lang.org> +<matz@ruby-lang.org> |