ruby-changes:69176
From: Maxime <ko1@a...>
Date: Thu, 21 Oct 2021 08:19:11 +0900 (JST)
Subject: [ruby-changes:69176] 51e46eac5f (master): Rename Ruby README to README_ruby.md
https://git.ruby-lang.org/ruby.git/commit/?id=51e46eac5f From 51e46eac5f225227460bd203104886d77828cd34 Mon Sep 17 00:00:00 2001 From: Maxime Chevalier-Boisvert <maxime.chevalierboisvert@s...> Date: Tue, 20 Apr 2021 11:36:01 -0400 Subject: Rename Ruby README to README_ruby.md --- README.md | 187 --------------------------------------------------------- README_ruby.md | 187 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 187 insertions(+), 187 deletions(-) delete mode 100644 README.md create mode 100644 README_ruby.md diff --git a/README.md b/README.md deleted file mode 100644 index 8d23de8b7a..0000000000 --- a/README.md +++ /dev/null @@ -1,187 +0,0 @@ https://github.com/ruby/ruby/blob/trunk/#L0 -[](https://github.com/ruby/ruby/actions?query=workflow%3A"macOS") -[](https://github.com/ruby/ruby/actions?query=workflow%3A"MinGW") -[](https://github.com/ruby/ruby/actions?query=workflow%3A"MJIT") -[](https://github.com/ruby/ruby/actions?query=workflow%3A"Ubuntu") -[](https://github.com/ruby/ruby/actions?query=workflow%3A"Windows") -[](https://ci.appveyor.com/project/ruby/ruby/branch/master) -[](https://app.travis-ci.com/ruby/ruby) -[](https://cirrus-ci.com/github/ruby/ruby/master) - -# What's 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. - -## 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://github.com/ruby/ruby/blob/master/doc/contributing.rdoc#label-Platform+Maintainers - - -## How to get Ruby - -For a complete list of ways to install Ruby, including using third-party tools -like rvm, see: - -https://www.ruby-lang.org/en/downloads/ - -### Git - -The mirror of the Ruby source tree can be checked out with the following command: - - $ git clone https://github.com/ruby/ruby.git - -There are some other branches under development. Try the following command -to see the list of branches: - - $ git ls-remote https://github.com/ruby/ruby.git - -You may also want to use https://git.ruby-lang.org/ruby.git (actual master of Ruby source) -if you are a committer. - -### Subversion - -Stable branches for older Ruby versions can be checked out with also the -following command: - - $ svn co https://svn.ruby-lang.org/repos/ruby/branches/ruby_2_6/ ruby - -Try the following command to see the list of branches: - - $ svn ls https://svn.ruby-lang.org/repos/ruby/branches/ - - -## Ruby home page - -https://www.ruby-lang.org/ - -## Mailing list - -There is a mailing list to discuss Ruby. To subscribe to this list, please -send the following phrase: - - subscribe - -in the mail body (not subject) to the address [ruby-talk-request@r...]. - -[ruby-talk-request@r...]: mailto:ruby-talk-request@r...?subject=Join%20Ruby%20Mailing%20List&body=subscribe - -## Requirements to build from repository - -1. GNU or BSD make -2. C99 compiler -3. autoconf 2.67 or higher -4. automake 1.15 or higher -5. bison 2.3 or higher -6. Ruby 2.2 or higher - -When building from a released version, only a C99 compiler and GNU or BSD make -is required. - -## How to compile and install - -1. If you want to use Microsoft Visual C++ to compile Ruby, read - [win32/README.win32](win32/README.win32) instead of this document. - -2. Run `./autogen.sh` to generate configure, when you build the source checked - out from the Git repository. - -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 `include/ruby/defines.h` if you need. Usually this step will not be needed. - -5. Optional: Remove comment mark(`#`) before the module names from `ext/Setup`. - - This step is only necessary if you want to link modules statically. - - If you don't want to compile dynamic extensions (probably on architectures - which do 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`. - - * On Mac, set RUBY\_CODESIGN environment variable with a signing identity. - It uses the identity to sign `ruby` binary. See also codesign(1). - -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 the following directories and install files into - them. - - * `${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` - - - 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](COPYING). - -## Feedback - -Questions about the Ruby language can be asked on the [Ruby-Talk] mailing list -or on websites like https://stackoverflow.com. - -Bugs should be reported at https://bugs.ruby-lang.org. Read [HowToReport] for more information. - -[Ruby-Talk]: https://www.ruby-lang.org/en/community/mailing-lists -[HowToReport]: https://bugs.ruby-lang.org/projects/ruby/wiki/HowToReport - -## Contributing - -See the file [CONTRIBUTING.md](CONTRIBUTING.md) - -## The Author - -Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in 1995. - -<matz@r...> diff --git a/README_ruby.md b/README_ruby.md new file mode 100644 index 0000000000..8d23de8b7a --- /dev/null +++ b/README_ruby.md @@ -0,0 +1,187 @@ https://github.com/ruby/ruby/blob/trunk/README_ruby.md#L1 +[](https://github.com/ruby/ruby/actions?query=workflow%3A"macOS") +[](https://github.com/ruby/ruby/actions?query=workflow%3A"MinGW") +[](https://github.com/ruby/ruby/actions?query=workflow%3A"MJIT") +[](https://github.com/ruby/ruby/actions?query=workflow%3A"Ubuntu") +[](https://github.com/ruby/ruby/actions?query=workflow%3A"Windows") +[](https://ci.appveyor.com/project/ruby/ruby/branch/master) +[](https://app.travis-ci.com/ruby/ruby) +[](https://cirrus-ci.com/github/ruby/ruby/master) + +# What's 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. + +## 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 Objec (... truncated) -- ML: ruby-changes@q... Info: http://www.atdot.net/~ko1/quickml/