Gecko [ beriskala.com ]

Name	Size	Permission	Date
images	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
irb	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
pty	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
syntax	[ DIR ]	drwxr-xr-x	2026-05-01 04:23
ChangeLog	2.29 MB	-rw-r--r--	2025-03-26 07:50
ChangeLog-0.06_to_0.52	46.51 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-0.50_to_0.60	18.81 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-0.60_to_1.1	129.14 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-1.8.0	728.09 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-1.9.3	2.86 MB	-rw-r--r--	2025-03-26 07:50
ChangeLog-2.0.0	830.16 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-2.1.0	603.56 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-2.2.0	401.16 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-2.3.0	400.76 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-2.4.0	327.98 KB	-rw-r--r--	2025-03-26 07:50
ChangeLog-YARV	144.68 KB	-rw-r--r--	2025-03-26 07:50
NEWS-1.8.7	14.22 KB	-rw-r--r--	2025-03-26 07:50
NEWS-1.9.1	15.54 KB	-rw-r--r--	2025-03-26 07:50
NEWS-1.9.2	12.07 KB	-rw-r--r--	2025-03-26 07:50
NEWS-1.9.3	9.76 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.0.0	18.01 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.1.0	11.97 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.2.0	11.47 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.3.0	12.63 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.4.0	11.31 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.5.0	16.7 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.6.0	17.87 KB	-rw-r--r--	2025-03-26 07:50
NEWS-2.7.0	24.5 KB	-rw-r--r--	2025-03-26 07:50
NEWS-3.0.0.md	24.11 KB	-rw-r--r--	2025-03-26 07:50
README.md	6.91 KB	-rw-r--r--	2025-03-26 07:50
bsearch.rdoc	4.24 KB	-rw-r--r--	2025-03-26 07:50
bug_triaging.rdoc	4.04 KB	-rw-r--r--	2025-03-26 07:50
case_mapping.rdoc	3.08 KB	-rw-r--r--	2025-03-26 07:50
contributing.rdoc	15.79 KB	-rw-r--r--	2025-03-26 07:50
dig_methods.rdoc	2.57 KB	-rw-r--r--	2025-03-26 07:50
documentation_guide.rdoc	10.7 KB	-rw-r--r--	2025-03-26 07:50
dtrace_probes.rdoc	7.42 KB	-rw-r--r--	2025-03-26 07:50
extension.ja.rdoc	72.4 KB	-rw-r--r--	2025-03-26 07:50
extension.rdoc	72.15 KB	-rw-r--r--	2025-03-26 07:50
fiber.md	6.74 KB	-rw-r--r--	2025-03-26 07:50
forwardable.rd.ja	2.34 KB	-rw-r--r--	2025-03-26 07:50
globals.rdoc	4.33 KB	-rw-r--r--	2025-03-26 07:50
hacking.md	1.88 KB	-rw-r--r--	2025-03-26 07:50
implicit_conversion.rdoc	5.5 KB	-rw-r--r--	2025-03-26 07:50
keywords.rdoc	4.63 KB	-rw-r--r--	2025-03-26 07:50
maintainers.rdoc	10.65 KB	-rw-r--r--	2025-03-26 07:50
make_cheatsheet.md	2.55 KB	-rw-r--r--	2025-03-26 07:50
marshal.rdoc	11.51 KB	-rw-r--r--	2025-03-26 07:50
memory_view.md	6.51 KB	-rw-r--r--	2025-03-26 07:50
ractor.md	26.16 KB	-rw-r--r--	2025-03-26 07:50
regexp.rdoc	30 KB	-rw-r--r--	2025-03-26 07:50
ruby-exercise.stp	1.08 KB	-rw-r--r--	2025-04-28 20:58
security.rdoc	5.72 KB	-rw-r--r--	2025-03-26 07:50
signals.rdoc	3.33 KB	-rw-r--r--	2025-03-26 07:50
standard_library.rdoc	5.77 KB	-rw-r--r--	2025-03-26 07:50
syntax.rdoc	1.21 KB	-rw-r--r--	2025-03-26 07:50
yarvarch.en	106 B	-rw-r--r--	2025-03-26 07:50
yarvarch.ja	16.41 KB	-rw-r--r--	2025-03-26 07:50

Rename

# How to use "configure" and "make" commands for Ruby

This is for developers of Ruby.
If you are a user of Ruby, please see README.md.

## In-place build

```
$ ./autogen.sh
$ ./configure --prefix=$PWD/local
$ make
$ make install
$ ./local/bin/ruby -e 'puts "Hello"'
Hello
```

## Out-of-place build

```
$ ./autogen.sh
$ mkdir ../ruby-build
$ cd ../ruby-build
$ ../ruby-src/configure --prefix=$PWD/local
$ make
$ make install
$ ./local/bin/ruby -e 'puts "Hello"'
Hello
```

## How to run the whole test suite

```
$ make check
```

It runs (about) three test suites:

* `make test` (a test suite for the interpreter core)
* `make test-all` (for all builtin classes and libraries)
* `make test-spec` (a conformance test suite for Ruby implementations)
* `make test-bundler` (a test suite for the bundler examples)

## How to run the test suite with log

```
$ make test OPTS=-v

$ make test-all TESTS=-v

$ make test-spec MSPECOPT=-Vfs
```

## How to run a part of the test suite

### Runs a directory
```
$ make test-all TESTS=test/rubygems
$ make test-all TESTS=rubygems
```

### Runs a file
```
$ make test-all TESTS=test/ruby/test_foo.rb
$ make test-all TESTS=ruby/foo
```

### Runs a test whose name includes test_bar
```
$ make test-all TESTS="test/ruby/test_foo.rb -n /test_bar/"
```

### Runs a file or directory with GNU make
```
$ make test/ruby/test_foo.rb
$ make test/ruby/test_foo.rb TESTOPTS="-n /test_bar/"
```

### Runs a ruby-spec directory
```
$ make test-spec MSPECOPT=spec/ruby/core/foo
```

### Runs a ruby-spec file
```
$ make test-spec MSPECOPT=spec/ruby/core/foo/bar_spec.rb
```

### Runs a ruby-spec file or directory with GNU make
```
$ make spec/ruby/core/foo/bar_spec.rb
```

### Runs a bundler spec file
```
$ make test-bundler BUNDLER_SPECS=commands/exec_spec.rb:58
```

## How to measure coverage of C and Ruby code

You need to be able to use gcc (gcov) and lcov visualizer.

```
$ ./autogen.sh
$ ./configure --enable-gcov
$ make
$ make update-coverage
$ rm -f test-coverage.dat
$ make test-all COVERAGE=true
$ make lcov
$ open lcov-out/index.html
```

If you need only C code coverage, you can remove `COVERAGE=true` from the above process.
You can also use `gcov` command directly to get per-file coverage.

If you need only Ruby code coverage, you can remove `--enable-gcov`.
Note that `test-coverage.dat` accumulates all runs of `make test-all`.
Make sure that you remove the file if you want to measure one test run.

You can see the coverage result of CI: https://rubyci.org/coverage

## How to benchmark

see https://github.com/ruby/ruby/tree/master/benchmark#make-benchmark