From 1f8c45aa51ece7df1d7d07382b44640ab30306cb Mon Sep 17 00:00:00 2001 From: Nobuyoshi Nakada Date: Sun, 2 Jun 2024 21:27:03 +0900 Subject: [PATCH] [DOC] building_ruby: Move the caution to a footnote --- doc/contributing/building_ruby.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/contributing/building_ruby.md b/doc/contributing/building_ruby.md index 4b54bdc774..ce844b5026 100644 --- a/doc/contributing/building_ruby.md +++ b/doc/contributing/building_ruby.md @@ -145,7 +145,7 @@ about Ruby's build to help out. ### Running make scripts in parallel -In GNU make and BSD make implementations, to run a specific make script in +In GNU make[^caution-gmake-3] and BSD make implementations, to run a specific make script in parallel, pass the flag `-j`. For instance, to run tests on 8 processes, use: @@ -153,9 +153,6 @@ on 8 processes, use: make test-all -j8 ``` -**CAUTION**: GNU make 3 is missing some features for parallel execution, we -recommend to upgrade to GNU make 4 or later. - We can also set `MAKEFLAGS` to run _all_ `make` commands in parallel. Having the right `--jobs` flag will ensure all processors are utilized when @@ -176,6 +173,9 @@ export MAKEFLAGS="--jobs "(nproc) export MAKEFLAGS="--jobs $(nproc)" ``` +[^caution-gmake-3]: **CAUTION**: GNU make 3 is missing some features for parallel execution, we +recommend to upgrade to GNU make 4 or later. + ### Miniruby vs Ruby Miniruby is a version of Ruby which has no external dependencies and lacks