1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Added tarball instruction to building_ruby.md

Browse Source
This commit is contained in:
Hiroshi SHIBATA 2023-02-07 14:21:18 +09:00
parent c84184d50b
commit 5ee39ea67f
No known key found for this signature in database
GPG Key ID: F9CF13417264FAC2
1 changed files with 27 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/contributing/building_ruby.md
View File

@ -5,14 +5,17 @@
1. Install the prerequisite dependencies for building the CRuby interpreter: 1. Install the prerequisite dependencies for building the CRuby interpreter:
* C compiler * C compiler
* OpenSSL 1.1.x or 3.0.x / LibreSSL
* libyaml 0.1.7 or later
* zlib
If you want to build from the git repository, you will also need:
* autoconf - 2.67 or later * autoconf - 2.67 or later
* bison - 3.0 or later * bison - 3.0 or later
* gperf - 3.0.3 or later * gperf - 3.0.3 or later
* ruby - 2.2 or later * ruby - 2.2 or later
* We can upgrade this version to system ruby version of the latest Ubuntu LTS. * We can upgrade this version to system ruby version of the latest Ubuntu LTS.
* OpenSSL 1.1.x or 3.0.x / LibreSSL
* libyaml 0.1.7 or later
* zlib
2. Install optional, recommended dependencies: 2. Install optional, recommended dependencies:
@ -33,19 +36,33 @@
## Quick start guide ## Quick start guide
1. Checkout the CRuby source code: 1. Download ruby source code:
1. Build from the tarball:
Download the latest tarball from [ruby-lang.org](https://www.ruby-lang.org/en/downloads/) and
extract it. Example for Ruby 3.0.2:
``` shell
tar -xzf ruby-3.0.2.tar.gz
cd ruby-3.0.2
```
2. Build from the git repository:
Checkout the CRuby source code:
``` shell ``` shell
git clone https://github.com/ruby/ruby.git git clone https://github.com/ruby/ruby.git
``` ```
2. Generate the configure file: Generate the configure file:
``` shell ``` shell
./autogen.sh ./autogen.sh
``` ```
3. Create a `build` directory outside of the source directory: 2. Create a `build` directory outside of the source directory:
``` shell ``` shell
mkdir build && cd build mkdir build && cd build
@ -53,13 +70,13 @@
While it's not necessary to build in a separate directory, it's good practice to do so. While it's not necessary to build in a separate directory, it's good practice to do so.
4. We'll install Ruby in `~/.rubies/ruby-master`, so create the directory: 3. We'll install Ruby in `~/.rubies/ruby-master`, so create the directory:
``` shell ``` shell
mkdir ~/.rubies mkdir ~/.rubies
``` ```
5. Run configure: 4. Run configure:
``` shell ``` shell
../configure --prefix="${HOME}/.rubies/ruby-master" ../configure --prefix="${HOME}/.rubies/ruby-master"
@ -67,13 +84,13 @@
- If you are frequently building Ruby, add the `--disable-install-doc` flag to not build documentation which will speed up the build process. - If you are frequently building Ruby, add the `--disable-install-doc` flag to not build documentation which will speed up the build process.
6. Build Ruby: 5. Build Ruby:
``` shell ``` shell
make install make install
``` ```
7. [Run tests](testing_ruby.md) to confirm your build succeeded. 6. [Run tests](testing_ruby.md) to confirm your build succeeded.
### Unexplainable Build Errors ### Unexplainable Build Errors