mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
[DOC] Fold too long lines
This commit is contained in:
parent
83983bacbc
commit
b43ad6b802
1 changed files with 18 additions and 8 deletions
|
@ -1,12 +1,16 @@
|
||||||
# Ruby Hacking Guide
|
# Ruby Hacking Guide
|
||||||
|
|
||||||
This document gives some helpful instructions which should make your experience as a Ruby core developer easier.
|
This document gives some helpful instructions which should make your
|
||||||
|
experience as a Ruby core developer easier.
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
### Make
|
### Make
|
||||||
|
|
||||||
It's common to want to compile things as quickly as possible. Ensuring `make` has the right `--jobs` flag will ensure all processors are utilized when building software projects. To do this effectively, you can set `MAKEFLAGS` in your shell configuration/profile:
|
It's common to want to compile things as quickly as possible. Ensuring
|
||||||
|
`make` has the right `--jobs` flag will ensure all processors are
|
||||||
|
utilized when building software projects To do this effectively, you
|
||||||
|
can set `MAKEFLAGS` in your shell configuration/profile:
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
# On macOS with Fish shell:
|
# On macOS with Fish shell:
|
||||||
|
@ -36,7 +40,8 @@ make install
|
||||||
|
|
||||||
### Without Documentation
|
### Without Documentation
|
||||||
|
|
||||||
If you are frequently building Ruby, this will reduce the time it takes to `make install`.
|
If you are frequently building Ruby, this will reduce the time it
|
||||||
|
takes to `make install`.
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
../configure --disable-install-doc
|
../configure --disable-install-doc
|
||||||
|
@ -46,13 +51,15 @@ If you are frequently building Ruby, this will reduce the time it takes to `make
|
||||||
|
|
||||||
### Run Local Test Script
|
### Run Local Test Script
|
||||||
|
|
||||||
You can create a file in the Ruby source root called `test.rb`. You can build `miniruby` and execute this script:
|
You can create a file in the Ruby source root called `test.rb`. You
|
||||||
|
can build `miniruby` and execute this script:
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
make run
|
make run
|
||||||
```
|
```
|
||||||
|
|
||||||
If you want more of the standard library, you can use `runruby` instead of `run`.
|
If you want more of the standard library, you can use `runruby`
|
||||||
|
instead of `run`.
|
||||||
|
|
||||||
## Running Tests
|
## Running Tests
|
||||||
|
|
||||||
|
@ -64,7 +71,8 @@ make check
|
||||||
|
|
||||||
### Run Bootstrap Tests
|
### Run Bootstrap Tests
|
||||||
|
|
||||||
There are a set of tests in `bootstraptest/` which cover most basic features of the core Ruby language.
|
There are a set of tests in `bootstraptest/` which cover most basic
|
||||||
|
features of the core Ruby language.
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
make test
|
make test
|
||||||
|
@ -72,7 +80,8 @@ make test
|
||||||
|
|
||||||
### Run Extensive Tests
|
### Run Extensive Tests
|
||||||
|
|
||||||
There are extensive tests in `test/` which cover a wide range of features of the Ruby core language.
|
There are extensive tests in `test/` which cover a wide range of
|
||||||
|
features of the Ruby core language.
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
make test-all
|
make test-all
|
||||||
|
@ -86,7 +95,8 @@ make test-all TESTS=../test/fiber/test_io.rb
|
||||||
|
|
||||||
### Run RubySpec Tests
|
### Run RubySpec Tests
|
||||||
|
|
||||||
RubySpec is a project to write a complete, executable specification for the Ruby programming language.
|
RubySpec is a project to write a complete, executable specification
|
||||||
|
for the Ruby programming language.
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
make test-spec
|
make test-spec
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue